Método	URL
	`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 e aceita este reenvio.

Path Params¶

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

Esta rota não possui Request Body.

Exemplo de cURL

curl -X POST "https://BASE_URL/public/v1/recebiveis/lotes/987/reenviar-arquivo-fundo" \
  -H "Authorization: Bearer {token}" \
  -H "GrupoEconomico: {grupo}"

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.

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."
}

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.