Lo que aprendo administrando NetSuite, explicado sin rodeos.

Un Scheduled Script que procesa todo en una sola ejecución va bien con pocos registros. Cuando el volumen crece, empiezan los problemas.

Scheduled Script

• Una sola ejecución, con un límite de 10,000 unidades de gobernanza.
• Si se acaban las unidades, se detiene a medias.

Map/Reduce

• Trabaja por etapas: getInputData, map, reduce y summarize.
• Procesa un registro a la vez: un error no frena al resto.
• En summarize revisas qué falló y por qué.

Antes: el mismo pago se digitaba en NetSuite, en la banca, en un Excel y en un correo al proveedor. Cuatro lugares, cuatro oportunidades de error.

Después: un solo flujo en NetSuite

1. Seleccionas las facturas a pagar dentro de NetSuite.
2. NetSuite genera el archivo del banco con la plantilla de pago de tu banco.
3. Haces una sola carga en el banco, en lugar de una transferencia por pago.
4. El pago queda registrado contra cada factura.
5. El proveedor recibe su aviso por correo.

Un cambio “pequeño” en producción puede romper:

• Un workflow que se dispara en otro registro.
• Un script que depende de ese campo.
• Una integración que espera el formato anterior.

La regla

1. Sandbox primero: todo cambio se prueba ahí.
2. Datos reales: copiados de producción.
3. Pase fuera de horario: con forma de revertirlo.

Un sistema externo envía el pedido A-1042 y NetSuite crea la orden. La respuesta no llega por un corte de red. El sistema reintenta… y sin protección, se crea una segunda orden.

La solución es que reintentar sea seguro (idempotencia). Usa el identificador del sistema externo como External ID: NetSuite no permite dos registros del mismo tipo con el mismo External ID.

// RESTlet (SuiteScript 2.1): buscar antes de crear
const previo = query.runSuiteQL({
  query: 'SELECT id FROM transaction WHERE externalid = ?',
  params: [payload.pedidoId]
}).asMappedResults()[0];

if (previo) return { id: previo.id, duplicado: true };

const orden = record.create({ type: record.Type.SALES_ORDER });
orden.setValue({ fieldId: 'externalid', value: payload.pedidoId });

BUILTIN.DF convierte un ID en el texto que ves en pantalla: el nombre del cliente, del vendedor o de la ubicación.

SELECT
  t.tranid AS pedido,
  BUILTIN.DF(t.entity)    AS cliente,
  BUILTIN.DF(t.employee)  AS vendedor,
  BUILTIN.DF(tl.location) AS ubicacion
FROM transaction t
JOIN transactionline tl
  ON tl.transaction = t.id
WHERE t.type = 'SalesOrd'
  AND tl.mainline = 'T'
  AND t.status IN ('E', 'F')