Saltar al contenido principal
POST
Cargar archivo de transacciones

Autorizaciones

Authorization
string
header
requerido

Autenticación con token Bearer (formato: "Bearer {token}")

Encabezados

X-Request-Id
string

A unique identifier for tracing the request across services.

X-Idempotency-Key
string

Clave de idempotencia opcional para reintentos seguros. También acepta Idempotency-Key como nombre de encabezado alternativo. Si se envía la misma clave nuevamente y la solicitud original ya fue procesada, se devuelve la respuesta en caché con X-Idempotency-Replayed: true.

Consulte Reintentos e idempotencia para más detalles.

Parámetros de ruta

contextId
string
requerido

The unique identifier of the reconciliation context.

sourceId
string
requerido

The unique identifier of the reconciliation source.

Cuerpo

multipart/form-data
file
file
requerido

Archivo de transacciones (CSV, JSON o XML)

format
enum<string>
requerido

Formato del archivo

Opciones disponibles:
csv,
json,
xml

Respuesta

Indica que la solicitud fue aceptada para su procesamiento.

La respuesta incluye el encabezado X-Idempotency-Replayed.

Si el valor es false, la solicitud acaba de ser procesada. Si el valor es true, la respuesta es una repetición de una solicitud procesada anteriormente.

Consulte Reintentos e idempotencia para más detalles.

Detalles del trabajo de ingestión

completedAt
string

Cuándo finalizó el trabajo en formato RFC3339 (si finalizó)

Ejemplo:

"2025-01-15T10:35:00.000Z"

contextId
string

ID de contexto al que pertenece este trabajo

Ejemplo:

"019c96a0-10a0-72d2-9fb0-2b7de8093182"

createdAt
string

Marca de tiempo de creación en formato RFC3339

Ejemplo:

"2025-01-15T10:30:00.000Z"

failedRows
integer

Número de filas que fallaron durante el procesamiento

Rango requerido: x >= 0
Ejemplo:

5

fileName
string

Nombre del archivo original

Ejemplo:

"transactions_2024.csv"

id
string

Identificador único del trabajo

Ejemplo:

"019c96a0-10ce-75fc-a273-dc799079a99c"

sourceId
string

ID de fuente en la que este trabajo ingiere datos

Ejemplo:

"019c96a0-108c-7a74-8e31-3789daffe1ed"

startedAt
string

Cuándo inició el trabajo en formato RFC3339 (nulo para trabajos en estado QUEUED)

Ejemplo:

"2025-01-15T10:30:00.000Z"

status
enum<string>

Estado actual del trabajo

Opciones disponibles:
QUEUED,
PROCESSING,
COMPLETED,
FAILED
Ejemplo:

"PROCESSING"

totalRows
integer

Número total de filas en el archivo

Rango requerido: x >= 0
Ejemplo:

1000