Crear registros de producción

Scope requerido: production_logs.create.

Crea uno o varios registros de producción. El cuerpo es un arreglo JSON, incluso para un solo registro.

Este es el endpoint que usa un MES, ERP o terminal de planta para enviar producción a Pulsar. machine y sku son referencias que aceptan un id o un name, así que un sistema que solo conoce nombres de línea y códigos de producto no tiene que resolver primero los IDs de Pulsar.

Un registro de producción describe un intervalo cerrado: start y end son obligatorios, end es igual o posterior a start, y ambos caen dentro de un solo turno de la máquina. Se aceptan turnos pasados, así que los registros pueden enviarse días después de la producción. Para registrar lo que pasa en el turno que una máquina está corriendo ahora, usa los endpoints de tiempo real.

Los defectos (type: "defects") se suman. Varios registros de defectos pueden cubrir el mismo rango, en una solicitud o en varias, y cada uno se registra, así que enviar el mismo lote dos veces lo registra dos veces. Envía cada lote una sola vez, y reintenta solo como se describe en Reintentos e Idempotency-Key abajo. start y end pueden ser el mismo instante para defectos encontrados en un momento puntual:

[
  {"type": "defects", "count": 3, "nominalSpeed": 60, "machine": {"name": "Press 4"},
   "sku": {"name": "GAL-1042"}, "start": "2026-10-12T14:00:00Z", "end": "2026-10-12T22:00:00Z"},
  {"type": "defects", "count": 1, "nominalSpeed": 60, "machine": {"name": "Press 4"},
   "sku": {"name": "GAL-1042"}, "start": "2026-10-12T17:42:10Z", "end": "2026-10-12T17:42:10Z"}
]

Los registros total y correct no pueden traslaparse con otro registro del mismo tipo, máquina y SKU. La respuesta lista los registros de esta solicitud. La calidad y el OEE de los turnos afectados se recalculan en segundo plano, normalmente en unos minutos.

Reintentos e Idempotency-Key. Que una llamada fallida haya registrado algo depende de cómo falló:

• Una respuesta 4xx significa que la solicitud se rechazó y no se registró nada. Corrígela y envíala otra vez.
• Un timeout, una conexión cortada o una respuesta 5xx dejan el resultado desconocido: la solicitud pudo haberse registrado aunque nunca recibiste la respuesta. Si la envías otra vez sin un Idempotency-Key, puede registrarse dos veces, así que primero revisa si se registró, por ejemplo con POST /v1/production-logs/filters.

Para reintentar de forma segura, envía un header Idempotency-Key con un valor único que generes para cada solicitud, como un UUID, y envía la misma clave y el mismo cuerpo en cada reintento de esa solicitud. La clave se guarda junto con lo que registró la solicitud, así que un reintento nunca la registra dos veces:

• Si la solicitud original se registró, el reintento no registra nada y devuelve la respuesta original, con el header Idempotent-Replayed: true.
• Si la original no se registró, ya sea porque se rechazó o porque falló, el reintento se procesa como una solicitud nueva.
• Reusar una clave con una solicitud distinta, con otro cuerpo o URL, devuelve 409.
• En el caso poco común de que la original todavía se esté procesando, el reintento devuelve 409. Vuelve a intentarlo en un momento.

Las claves son por empresa, así que todas sus API keys las comparten, y cada clave se conserva 24 horas después de la solicitud que la registró. Después de eso, una solicitud con la misma clave se procesa como nueva, así que reintenta dentro de ese plazo.

curl -X POST "https://example.com/v1/production-logs" \  -H "Content-Type: application/json" \  -d '[    {      "count": 1000,      "nominalSpeed": 60,      "start": "2024-01-01T08:00:00",      "end": "2024-01-01T16:00:00",      "machine": {},      "sku": {}    }  ]'

[  {    "id": "36f7b519-d93e-4ec8-8245-7f4b8c123456",    "type": "correct",    "sensorCount": 500,    "count": 1000,    "nominalSpeed": 60,    "countingFactor": 1,    "start": "2024-01-01T00:00:00",    "end": "2024-01-01T08:00:00",    "isReviewed": true,    "isAutomated": true,    "machineId": 12,    "createdAt": "2019-08-24T14:15:22Z",    "updatedAt": "2019-08-24T14:15:22Z",    "deletedAt": "2019-08-24T14:15:22Z",    "live": true,    "machine": {      "id": 0,      "name": "string",      "isCountEnabled": true,      "externalName": "string"    },    "company": {      "id": 0,      "name": "string",      "timezone": "string"    },    "shift": {      "id": 0,      "name": "string",      "start": "2019-08-24T14:15:22Z",      "end": "2019-08-24T14:15:22Z",      "isConsidered": true    },    "operator": {      "id": 0,      "firstName": "string",      "lastName": "string",      "email": "string"    },    "sku": {      "id": "string",      "name": "string",      "description": "string",      "unit": "string"    },    "workOrder": {      "id": "string",      "name": "string",      "description": "string",      "status": "InProgress"    },    "simpleWorkOrder": {      "id": "string",      "name": "string"    }  }]