---
title: 5.2. Reenviar Arquivo ao Fundo
url: https://docs.vehub.com.br/API/Integra%C3%A7%C3%A3o%20FIDC/5.%20Manuten%C3%A7%C3%A3o%20de%20Lotes/5.2.%20Reenviar%20Arquivo%20ao%20Fundo/
---
| Método | URL |
|--------|-----|
| ![POST](https://img.shields.io/badge/POST-green) | `https://BASE_URL/public/v1/recebiveis/lotes/{idLote}/reenviar-arquivo-fundo` |

Reenvia ao fundo o arquivo de um lote (a remessa CNAB e os lastros) depois de uma **falha definitiva de envio**. Vale para operações do canal **Envio de arquivo configurado**, em que o arquivo vai direto para o bucket ou o servidor da administradora: quando o envio falha, o lote **não é rejeitado** — ele fica em **Aguardando Envio**, com o motivo em `erros`, e a própria plataforma tenta enviar de novo algumas vezes. Esgotadas essas tentativas, o lote passa a ter `reenvioArquivoFundoDisponivel: true` em [Consultar Lote](../4.%20Consultas/4.1.%20Consultar%20Lote.md) e aceita este reenvio.

## Path Params

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

Esta rota não possui `Request Body`.

```` bash title="Exemplo de cURL"
curl -X POST "https://BASE_URL/public/v1/recebiveis/lotes/987/reenviar-arquivo-fundo" \
  -H "Authorization: Bearer {token}" \
  -H "GrupoEconomico: {grupo}"
````

```` json title="Response Body — 200 OK"
{
  "status": "sucesso",
  "mensagem": "Reenvio do arquivo ao fundo solicitado. Acompanhe pelo status e pelos erros do lote."
}
````

## Erros

Erros retornam o envelope `RetornoPadrao`.

| HTTP | Quando |
|------|--------|
| `400 Bad Request` | O lote não é do canal **Envio de arquivo configurado**, não está em **Aguardando Envio**, ou não está disponível para reenvio (`reenvioArquivoFundoDisponivel: false`). |
| `404 Not Found` | O lote não existe. |

```` json title="Response Body — 400 Bad Request (não disponível para reenvio)"
{
  "status": "erro",
  "mensagem": "O lote não está disponível para reenvio: o envio pode estar em andamento, as tentativas automáticas ainda não se esgotaram ou o reenvio já foi solicitado. Consulte 'reenvioArquivoFundoDisponivel' no lote."
}
````

```` json title="Response Body — 400 Bad Request (outro canal)"
{
  "status": "erro",
  "mensagem": "O reenvio ao fundo está disponível apenas para operações do canal 'Envio de arquivo configurado'."
}
````

# Modelo de dados

## Retorno

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

# Observações

- **Quando chamar:** só com `reenvioArquivoFundoDisponivel: true`. Um lote em **Aguardando Envio** com `erros` preenchido, mas sem essa indicação, está com uma nova tentativa automática agendada ou em andamento — aguarde.
- **Assíncrono:** a resposta `200` confirma que o reenvio foi aceito; a geração e o envio do arquivo rodam em segundo plano. Com sucesso, o lote avança para **Enviado ao Fundo**.
- **Uma vez por falha:** aceitar o pedido desliga `reenvioArquivoFundoDisponivel`. Uma segunda chamada, antes de o reenvio terminar, é recusada — assim um mesmo lote não vai duas vezes ao fundo. Se o reenvio também falhar de forma definitiva, a indicação volta a `true` e o novo motivo aparece em `erros`.
- **Falhas anteriores a esta rota:** lotes cuja falha de envio aconteceu antes da disponibilização desta rota não têm a indicação `reenvioArquivoFundoDisponivel`; para eles, solicite o reenvio ao suporte da Vertrau.
- **Mesmo nome, mesmo destino:** o nome da remessa é reservado por lote e não muda no reenvio; o arquivo substitui o que tiver ficado incompleto no destino, sem gerar uma segunda remessa.