---
title: 9.3. Anexar Lastro Avulso por Chave
url: https://docs.vehub.com.br/API/Integra%C3%A7%C3%A3o%20FIDC/9.%20Lastros%20Avulsos/9.3.%20Anexar%20Lastro%20Avulso%20por%20Chave/
---
| Método | URL |
|--------|-----|
| ![POST](https://img.shields.io/badge/POST-green) | `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](../2.%20Cess%C3%A3o%20de%20Direitos%20Credit%C3%B3rios/2.2.%20Adicionar%20T%C3%ADtulos.md#agrupando-titulos-pelo-mesmo-lastro)).

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.

!!! info "Diferença para [Anexar Lastros Avulsos](9.1.%20Anexar%20Lastros%20Avulsos.md)"
    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. |

```` bash title="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"
````

```` json title="Response Body — 200 OK"
{
  "status": "sucesso",
  "mensagem": "Lastro anexado com sucesso."
}
````

## Erros

Erros retornam HTTP `400 Bad Request` com o envelope `RetornoPadrao`.

```` json title="Response Body — 400 Bad Request (chave não encontrada)"
{
  "status": "erro",
  "mensagem": "Nenhum lastro encontrado para a chave informada"
}
````

```` json title="Response Body — 400 Bad Request (nenhum arquivo enviado)"
{
  "status": "erro",
  "mensagem": "Nenhum lastro foi enviado"
}
````

```` json title="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.