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

Anexa arquivos XML de NF-e como lastros diretamente na operação e empresa (cedente) informadas, sem vínculo a um lote. Útil quando o lastro está disponível antes (ou independente) do fluxo de cessão em lote — por exemplo, integrações que enviam a NF-e assim que ela é emitida pelo ERP do cedente.

O casamento com o título (pela chaveNfe) é feito de forma assíncrona, da mesma maneira que em Anexar Lastros: o endpoint apenas confirma o recebimento do arquivo e cria a "fotografia" da sessão de importação. Use os idsLogIntegracao retornados aqui para consultar o detalhamento via Consultar Importação de Lastros Avulsos.

Path Params¶

Campo	Tipo	Descrição
`idOperacao`	Número	Identificador da operação, fornecido pela Vertrau.

Query Params¶

Campo	Tipo	Descrição
`idEmpresa`	Número	Identificador da empresa (cedente) dona do lastro, fornecido pela Vertrau.

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.

Exemplo de cURL

curl -X POST "https://BASE_URL/public/v1/recebiveis/lotes/23/lastros/avulsos/nfe?idEmpresa=9" \
  -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": [44580, 44581]
}

Anexar via Base64 (JSON)¶

Método	URL
	`https://BASE_URL/public/v1/recebiveis/lotes/{idOperacao}/lastros/avulsos/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
`idOperacao`	Número	Identificador da operação, fornecido pela Vertrau.

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.
`idEmpresa`	Número	Sim	Identificador da empresa (cedente) dona do lastro, fornecido pela Vertrau.

Request Body

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

Exemplo de cURL

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

Response Body — 200 OK

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

Erros¶

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 (operação inexistente)

{
  "status": "erro",
  "mensagem": "Não foi possível identificar a operação 23."
}

Response Body — 400 Bad Request (empresa inexistente)

{
  "status": "erro",
  "mensagem": "Não foi possível identificar a empresa 9."
}

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: este endpoint não exige (nem cria) um lote — o arquivo é anexado direto na operação e empresa informadas. Para anexar lastros a um lote já existente, utilize Anexar Lastros.
Casamento assíncrono: assim como no fluxo vinculado a lote, o vínculo com o título (pela chaveNfe) acontece em segundo plano, depois da resposta 200 OK. Consulte Consultar Importação de Lastros Avulsos para confirmar se o arquivo foi vinculado, ficou pendente de vínculo ou foi rejeitado.
Operação/empresa inexistente: se idOperacao ou idEmpresa não existirem (ou não pertencerem ao grupo econômico autenticado), a importação é rejeitada com 400 Bad Request antes de qualquer gravação.