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

Anexa um arquivo a um lastro que já existe, identificado pela chave livre que você informou em lastro.chave ao criar os títulos (ver Adicionar Títulos).

Resolve o caso em que o documento do lastro só fica pronto depois da cessão — o contrato assinado, o canhoto digitalizado, o boleto emitido. Você cria os títulos informando uma chave da sua própria origem e, quando o arquivo existir, envia-o com a mesma chave, sem precisar conhecer o identificador interno do lastro na plataforma.

Diferença para Anexar Lastros Avulsos

Em /lastros/avulsos/nfe você envia XML de NF-e, o conteúdo é interpretado pela plataforma e o vínculo com o título acontece de forma assíncrona, casando pela chave de acesso da nota.

Aqui o lastro já existe e o arquivo é apenas anexado a ele, de forma síncrona: o conteúdo não é interpretado. Por isso aceita qualquer documento, inclusive os que não possuem chave de acesso fiscal — contrato, nota promissória, imagem de canhoto.

Path Params¶

Campo	Tipo	Descrição
`idOperacao`	Número	Identificador da operação, fornecido pela VeHub. A busca pelo lastro é limitada a esta operação.
`chave`	Texto	Chave livre do lastro — exatamente a mesma enviada em `lastro.chave` na criação dos títulos.

Request Body¶

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

Campo	Tipo	Obrigatório	Descrição
`arquivo`	Arquivo	Sim	Arquivo a ser anexado ao lastro. Um único arquivo por chamada.

Exemplo de cURL

curl -X POST "https://BASE_URL/public/v1/recebiveis/lotes/23/lastros/avulsos/chave/CONTRATO-4231"   -H "Authorization: Bearer {token}"   -H "GrupoEconomico: {grupo}"   -F "arquivo=@/caminho/para/contrato-4231.pdf"

Response Body — 200 OK

{
  "status": "sucesso",
  "mensagem": "Lastro anexado com sucesso."
}

Erros¶

Erros retornam HTTP 400 Bad Request com o envelope RetornoPadrao.

Response Body — 400 Bad Request (chave não encontrada)

{
  "status": "erro",
  "mensagem": "Nenhum lastro encontrado para a chave informada"
}

Response Body — 400 Bad Request (nenhum arquivo enviado)

{
  "status": "erro",
  "mensagem": "Nenhum lastro foi enviado"
}

Response Body — 400 Bad Request (operação inexistente)

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

Modelo de dados¶

Retorno¶

Campo	Tipo	Descrição
`status`	Texto	Status do processamento.
`mensagem`	Texto	Mensagem retornada pela API.

Observações¶

A chave precisa existir antes: o endpoint não cria lastro. Se nenhum lastro daquela operação tiver a chave informada, a resposta é 400 com Nenhum lastro encontrado para a chave informada — e nada é gravado. Crie os títulos com lastro.chave primeiro.
Escopo por operação: a busca considera apenas lastros com título na operação da rota, dentro do grupo econômico autenticado. Uma chave que existe em outra operação não é encontrada aqui.
Sem interpretação do conteúdo: o arquivo não é parseado nem validado. Nada é extraído dele — número, série, valor e datas do lastro permanecem como foram informados na criação dos títulos.
Reenvio substitui: anexar um segundo arquivo à mesma chave substitui o anterior no lastro. Não há histórico de versões do arquivo.
Espaços são aparados: a chave na URL é comparada sem os espaços em volta, do mesmo modo que na criação dos títulos.