Saltar al contenido principal
POST
/
v1
/
imports
/
contexts
/
{contextId}
/
sources
/
{sourceId}
/
upload
Cargar archivo de transacciones
curl --request POST \
  --url https://matcher.sandbox.lerian.net/v1/imports/contexts/{contextId}/sources/{sourceId}/upload \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form file='@example-file' \
  --form format=csv
{
  "completedAt": "2025-01-15T10:35:00.000Z",
  "contextId": "550e8400-e29b-41d4-a716-446655440000",
  "createdAt": "2025-01-15T10:30:00.000Z",
  "failedRows": 5,
  "fileName": "transactions_2024.csv",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "sourceId": "550e8400-e29b-41d4-a716-446655440000",
  "startedAt": "2025-01-15T10:30:00.000Z",
  "status": "PROCESSING",
  "totalRows": 1000
}

Autorizaciones

​
Authorization
string
header
requerido

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

Encabezados

​
X-Request-Id
string

Un identificador único para rastrear la solicitud a través de los servicios.

Parámetros de ruta

​
contextId
string
requerido

El identificador único del contexto de conciliación.

​
sourceId
string
requerido

El identificador único de la fuente de conciliación.

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 procesamiento.

Detalles del trabajo de ingesta

​
completedAt
string

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

Ejemplo:

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

​
contextId
string

ID del contexto al que pertenece este trabajo

Ejemplo:

"550e8400-e29b-41d4-a716-446655440000"

​
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 en el procesamiento

Rango requerido: x >= 0
Ejemplo:

5

​
fileName
string

Nombre del archivo original

Ejemplo:

"transactions_2024.csv"

​
id
string

Identificador único para el trabajo

Ejemplo:

"550e8400-e29b-41d4-a716-446655440000"

​
sourceId
string

ID de la fuente en la que este trabajo ingresa datos

Ejemplo:

"550e8400-e29b-41d4-a716-446655440000"

​
startedAt
string

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

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