---
title: 2.3. Anexar Lastros
url: https://docs.vehub.com.br/API/Integra%C3%A7%C3%A3o%20FIDC/2.%20Cess%C3%A3o%20de%20Direitos%20Credit%C3%B3rios/2.3.%20Anexar%20Lastros/
---
| Método | URL |
|--------|-----|
| ![POST](https://img.shields.io/badge/POST-green) | `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. |

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

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

## Anexar via Base64 (JSON)

| Método | URL |
|--------|-----|
| ![POST](https://img.shields.io/badge/POST-green) | `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. |

```` json title="Request Body"
{
  "nomeArquivo": "nfe_123.xml",
  "conteudoBase64": "<base64>"
}
````

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

```` 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 (base64 inválido)"
{
  "status": "erro",
  "mensagem": "O conteúdo do arquivo 'nfe_123.xml' não é um base64 válido."
}
````

```` json title="Response Body — 400 Bad Request (conteúdo vazio)"
{
  "status": "erro",
  "mensagem": "O conteúdo do arquivo 'nfe_123.xml' está vazio."
}
````

```` json title="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](../9.%20Lastros%20Avulsos/9.1.%20Anexar%20Lastros%20Avulsos.md), que anexa o arquivo direto na operação e empresa informadas.