SaveSeqDataAsync

Acepta los mismos elementos que SaveSeqData, pero responde de inmediato y los guarda en segundo plano. Cuando se han procesado todos los elementos, TrakIT envía los resultados a una URL que usted indica, si indica una.

Cómo iniciar sesión y leer la respuesta: Autenticación, Respuestas.

Cuál usar

	SaveSeqData	SaveSeqDataAsync
TrakIT responde	Cuando se han procesado todos los elementos.	De inmediato, antes de comprobar ningún elemento.
Resultados de los elementos	En la respuesta.	Enviados a su URL de CallBack, o no se envían.
Úselo para	Lotes pequeños, y cuando actúa según el resultado de cada elemento.	Lotes grandes que podrían superar su tiempo de espera, y actualizaciones que no necesita seguir.

Ambos aceptan como máximo 999 elementos por solicitud, y comprueban y guardan cada elemento de la misma forma.

Solicitud

POST /api/v1/SaveSeqDataAsync?CallBack=https%3A%2F%2Fintegration.example.com%2Ftrakit%2Fresults%3Fbatch%3D20261020-01
Token: your-token
Content-Type: application/json

[
  { "WOID": 48211, "Code": "GATEIN", "Value": "2026-10-20T09:30:00", "Remarks": "Gate 3" },
  { "WOID": 48212, "Code": "GATEIN", "Value": "2026-10-20T09:42:00", "Remarks": "Gate 1" }
]

Parámetro	Obligatorio	Significado
CallBack	Sí, puede estar vacío	La URL a la que TrakIT envía los resultados, codificada para URL. Debe empezar por https://. Déjelo vacío (CallBack=) si no quiere los resultados: los elementos se guardan igualmente.

Incluya CallBack en la cadena de consulta aunque esté vacío. Sin él, la solicitud no llega al punto de conexión y TrakIT responde con HTTP 404. Un valor que no empieza por https:// se acepta, pero entonces TrakIT no envía ningún resultado.

El cuerpo es la misma matriz JSON de elementos que para SaveSeqData: consulte sus campos y sus valores.

Reglas

Antes de responder, TrakIT solo comprueba la solicitud en su conjunto:

Regla	Info si no se cumple
El cuerpo es una matriz JSON de elementos.	No data supplied or json is malformed
Tiene como máximo 999 elementos.	Count of data supplied must be less than 1000

Después, cada elemento se comprueba y se guarda en segundo plano, como se describe en las reglas de SaveSeqData. Sus resultados llegan en la devolución de llamada.

Respuesta

La respuesta solo indica que TrakIT ha aceptado los elementos. Code es 1, e Info indica el número de elementos y la URL de devolución de llamada. RetInfo es null, y RowsAffected, Identity y Scalar no se utilizan. Un Code de 1 no significa que los elementos se hayan guardado.

{
  "Code": 1,
  "Info": "Processing 2 items. Will callback https://integration.example.com/trakit/results?batch=20261020-01",
  "RetInfo": null,
  "RowsAffected": 0,
  "Scalar": null,
  "Identity": 0
}

Devolución de llamada

Cuando se han procesado todos los elementos, TrakIT envía una solicitud POST a la URL de CallBack. Su cuerpo es un objeto JSON, igual que la respuesta de SaveSeqData: Code es 1 si se ha guardado al menos un elemento, RowsAffected es el número de elementos guardados y RetInfo contiene un resultado por elemento, en el orden de envío.

{
  "Code": 1,
  "Info": null,
  "RetInfo": [
    { "WOID": 48211, "Code": "GATEIN", "Result": 1, "Info": "Success" },
    { "WOID": 48212, "Code": "GATEIN", "Result": 0, "Info": "Out of sequence" }
  ],
  "RowsAffected": 1,
  "Scalar": null,
  "Identity": 0
}

• La solicitud no tiene encabezado Content-Type: lea su cuerpo como JSON, diga lo que diga el encabezado.
• No lleva ningún token ni firma. Use una URL difícil de adivinar, y trate el cuerpo como un aviso: compruebe los valores con GetSeqData si necesita estar seguro.
• El cuerpo no indica a qué solicitud responde. Para relacionarlos, ponga su propia referencia de lote en la URL de devolución de llamada, como en el ejemplo anterior, o relacione los resultados por WOID y Code.
• TrakIT la envía una sola vez. No la reintenta si no puede acceder a su servidor o si este responde con un error, y no lee su respuesta.

Si no llega ninguna devolución de llamada, compruebe los valores con GetSeqData antes de volver a enviar los elementos. Los elementos que ya están guardados vuelven como Unchanged, así que volver a enviar un lote no supone ningún riesgo.

Notas

• Un guardado tiene los mismos efectos que con SaveSeqData: los campos calculados, el estado de la orden de trabajo, las acciones y el registro de auditoría. Consulte las notas de SaveSeqData.
• Cada solicitud se procesa por separado, en segundo plano, por lo que dos solicitudes pueden procesarse al mismo tiempo. Si el orden de los cambios importa, por ejemplo en las mismas órdenes de trabajo, espere la primera devolución de llamada antes de enviar el siguiente lote.