Pular para o conteúdo principal
POST
/
v1
/
imports
/
contexts
/
{contextId}
/
sources
/
{sourceId}
/
upload
Fazer upload de arquivo de transações
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
}

Autorizações

​
Authorization
string
header
obrigatório

Bearer token authentication (format: "Bearer {token}")

Cabeçalhos

​
X-Request-Id
string

Um identificador único para rastrear a requisição entre serviços.

Parâmetros de caminho

​
contextId
string
obrigatório

O identificador único do contexto de conciliação.

​
sourceId
string
obrigatório

O identificador único da fonte de conciliação.

Corpo

multipart/form-data
​
file
file
obrigatório

Arquivo de transações (CSV, JSON ou XML)

​
format
enum<string>
obrigatório

Formato do arquivo

Opções disponíveis:
csv,
json,
xml

Resposta

Indica que a requisição foi aceita para processamento.

Detalhes do trabalho de ingestão

​
completedAt
string

Quando o trabalho foi concluído no formato RFC3339 (se concluído)

Exemplo:

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

​
contextId
string

ID do contexto ao qual este trabalho pertence

Exemplo:

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

​
createdAt
string

Timestamp de criação no formato RFC3339

Exemplo:

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

​
failedRows
integer

Número de linhas que falharam no processamento

Intervalo obrigatório: x >= 0
Exemplo:

5

​
fileName
string

Nome do arquivo original

Exemplo:

"transactions_2024.csv"

​
id
string

Identificador único do trabalho

Exemplo:

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

​
sourceId
string

ID da fonte para a qual este trabalho ingere dados

Exemplo:

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

​
startedAt
string

Quando o trabalho iniciou no formato RFC3339 (nulo para trabalhos QUEUED)

Exemplo:

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

​
status
enum<string>

Status atual do trabalho

Opções disponíveis:
QUEUED,
PROCESSING,
COMPLETED,
FAILED
Exemplo:

"PROCESSING"

​
totalRows
integer

Número total de linhas no arquivo

Intervalo obrigatório: x >= 0
Exemplo:

1000