Método	URL
	`https://BASE_URL/public/v1/recebiveis/lotes/{idLote}/lastros/nfe`

Anexa arquivos XML de NF-e como lastros de títulos de um lote.

O endpoint cria uma "fotografia" da sessão de importação, persistindo o resultado individual de cada arquivo (Vinculado / Pendente de vínculo / Rejeitado). Use os idsLogIntegracao retornados aqui para consultar o detalhamento via GET /public/v1/recebiveis/lotes/{idLote}/lastros/importacao/{idLogIntegracao}.

Path Params¶

Campo	Tipo	Descrição
`idLote`	Número	Identificador do lote.

Request Body¶

A requisição deve ser enviada como multipart/form-data.

Campo	Tipo	Descrição
`arquivo`	Lista de arquivos	Um ou mais arquivos XML de NF-e.

Tamanho máximo

Esta rota não tem limite próprio de tamanho: vale o limite geral do servidor, de 100 MB por requisição. Para arquivos grandes ou muitos arquivos, prefira dividir o envio em mais de uma chamada.

Exemplo de cURL

curl -X POST "https://BASE_URL/public/v1/recebiveis/lotes/987/lastros/nfe" \
  -H "Authorization: Bearer {token}" \
  -H "GrupoEconomico: {grupo}" \
  -F "arquivo=@/caminho/para/nota-fiscal-1.xml" \
  -F "arquivo=@/caminho/para/nota-fiscal-2.xml"

Response Body — 200 OK

{
  "status": "sucesso",
  "mensagem": "Lastro anexado com sucesso.",
  "idsLogIntegracao": [44570, 44571]
}

Anexar via Base64 (JSON)¶

Método	URL
	`https://BASE_URL/public/v1/recebiveis/lotes/{idLote}/lastros/nfe/base64`

Alternativa ao envio via multipart/form-data. Anexa o mesmo tipo de lastro (XML de NF-e), porém com o conteúdo do arquivo codificado em base64 no corpo da requisição. Cada chamada aceita um único arquivo.

Path Params¶

Campo	Tipo	Descrição
`idLote`	Número	Identificador do lote.

Request Body¶

A requisição deve ser enviada como application/json.

Campo	Tipo	Obrigatório	Descrição
`nomeArquivo`	Texto	Sim	Nome do arquivo, incluindo a extensão (máximo de 255 caracteres).
`conteudoBase64`	Texto	Sim	Conteúdo do arquivo XML da NF-e codificado em base64.

Request Body

{
  "nomeArquivo": "nfe_123.xml",
  "conteudoBase64": "<base64>"
}

Exemplo de cURL

curl -X POST "https://BASE_URL/public/v1/recebiveis/lotes/987/lastros/nfe/base64" \
  -H "Authorization: Bearer {token}" \
  -H "GrupoEconomico: {grupo}" \
  -H "Content-Type: application/json" \
  -d '{
    "nomeArquivo": "nfe_123.xml",
    "conteudoBase64": "<base64>"
  }'

Response Body — 200 OK

{
  "status": "sucesso",
  "mensagem": "Lastro anexado com sucesso.",
  "idsLogIntegracao": [44572]
}

Assim como na variante multipart/form-data, o retorno traz em idsLogIntegracao o identificador do log de integração gerado para o arquivo.

Tamanho máximo¶

O corpo JSON pode ter até 30 MB — o suficiente para um arquivo de cerca de 20 MB codificado em base64. Acima disso, a requisição é recusada com 413 Payload Too Large, antes de qualquer processamento, no formato ProblemDetails:

Response Body — 413 Payload Too Large

{
  "status": 413,
  "title": "Requisição maior que o permitido.",
  "detail": "O corpo da requisição excede o tamanho máximo de 30 MB para esta rota."
}

Erros¶

Os demais erros retornam HTTP 400 Bad Request com o envelope RetornoPadrao.

Response Body — 400 Bad Request (base64 inválido)

{
  "status": "erro",
  "mensagem": "O conteúdo do arquivo 'nfe_123.xml' não é um base64 válido."
}

Response Body — 400 Bad Request (conteúdo vazio)

{
  "status": "erro",
  "mensagem": "O conteúdo do arquivo 'nfe_123.xml' está vazio."
}

Response Body — 400 Bad Request (lote inexistente)

{
  "status": "erro",
  "mensagem": "Não foi possível identificar o lote 987."
}

Modelo de dados¶

Retorno¶

Campo	Tipo	Descrição
`status`	Texto	Status do processamento.
`mensagem`	Texto	Mensagem retornada pela API.
`idsLogIntegracao`	Lista de números	Identificadores de log de integração gerados — um por arquivo enviado. Use cada id no endpoint de consulta de fotografia para acompanhar o resultado individual.

Observações¶

Sem lote: se o lastro estiver disponível antes (ou independente) de um lote existente, utilize Anexar Lastros Avulsos, que anexa o arquivo direto na operação e empresa informadas.