Enviar un lote de operaciones de liquidación (NDJSON síncrono)

Acepta JSON delimitado por saltos de línea (application/x-ndjson); el tipo de medio NDJSON describe solo el formato de transporte de la solicitud, no cómo se persisten las operaciones. Cada línea es una operación, validada y creada a través del mismo pipeline que POST /v1/operations, agrupadas bajo un único batchId generado. El procesamiento es síncrono: la solicitud se recibe por completo y su número de líneas se valida antes de persistir cualquier operación. El número de líneas está limitado (un límite configurado, por defecto 50000); un lote que supera el límite se rechaza de forma atómica con 413 y no se persiste ninguna operación. Dentro de un lote aceptado, una línea inválida se rechaza con un error por línea sin abortar el lote. Opcionalmente idempotente mediante el encabezado Idempotency-Key. Los errores son problem+json según RFC 9457.

POST /v1/operations/batch

Enviar un lote de operaciones de liquidación (NDJSON síncrono)

cURL

curl --request POST \
  --url https://slc.sandbox.lerian.net/v1/operations/batch \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/x-ndjson' \
  --data '"<string>"'

202

{
  "accepted": 123,
  "batchId": "<string>",
  "errors": [
    {
      "code": "<string>",
      "externalId": "<string>",
      "line": 123,
      "message": "<string>",
      "details": {}
    }
  ],
  "errorsTruncated": true,
  "meta": {
    "requestId": "<string>",
    "timestamp": "<string>"
  },
  "rejected": 123
}

Autorizaciones

Authorization · string · header · requerido

JWT bearer token issued by the identity provider.

Encabezados

Idempotency-Key · string

Idempotency key for safe retries of the whole batch.

Cuerpo

application/x-ndjson

Newline-delimited JSON operations (application/x-ndjson); one CreateOperationRequest per line.

The body is of type string.

Respuesta

202

application/json

Batch accepted; per-line accepted/rejected counts and errors with the meta envelope.

accepted · integer<int64> · requerido

Count of accepted operations.

Ejemplo:

48

batchId · string · requerido

Generated batch id grouping every line of the submission.

Ejemplo:

"018f8a3e-4b2c-7c1a-9e5d-2f6a1b3c4d5e"

errors · object[] | null · requerido

Per-line rejection errors (capped at the first batchErrorCap entries).

Show child attributes

errorsTruncated · boolean · requerido

True when more rejections occurred than the errors array lists.

Ejemplo:

true

meta · object · requerido

Batch response envelope metadata (requestId + timestamp).

Show child attributes

rejected · integer<int64> · requerido

Count of rejected lines.

Ejemplo:

2