Emitir boleto avulso
Cria um boleto manual no ClickFin e envia a solicitação para o Banco Inter. Boletos com vencimento no mesmo dia só podem ser emitidos até 19:59. O cabeçalho Idempotency-Key é opcional. Quando omitido, a API gera uma chave interna para a tentativa (comportamento compatível com clientes que não enviam o cabeçalho), mas uma repetição da requisição não é reconhecida como a mesma emissão. Para repetir com segurança após timeout ou erro de rede, envie uma chave opaca única por boleto e reutilize-a na repetição: a mesma chave com os mesmos dados retorna o boleto já registrado (inclusive um boleto error por falha definitiva do Inter); a mesma chave com dados diferentes retorna 409 BANK_SLIP.ISSUE_IDEMPOTENCY_MISMATCH. Uma chave enviada fora do formato retorna 400 BANK_SLIP.ISSUE_FAILED.
Rejeições definitivas do Banco Inter registram o boleto com status error e retornam 201; um 429 do Inter também é definitivo (nada foi registrado) e grava error.code BANK_SLIP.PROVIDER.UNAVAILABLE. Quando o resultado do Inter é incerto (timeout, falha de rede, 5xx) ou a emissão com a mesma chave ainda está em andamento, a API responde 409 BANK_SLIP.ISSUE_RECONCILIATION_REQUIRED e não envia nova emissão ao provedor (fail-closed intencional para evitar boleto duplicado).
Um job concilia a cada 15 minutos os boletos que ficaram processing: busca a cobrança no Inter pelo seuNumero do boleto; se existir, grava o codigoSolicitacao e aplica o status atual (como o webhook); se o Inter não tiver a cobrança após 30 minutos sem alteração, o boleto passa a error com error.code BANK_SLIP.ISSUE_NOT_CONFIRMED e pode ser emitido novamente. Boletos já registrados cujo webhook não chegou também são sincronizados. Nenhuma emissão é reenviada automaticamente. Requer perfil de Administrador.
bank_slips:writeParâmetros
- Idempotency-Keyheader
Opcional. Chave opaca de 8 a 128 caracteres `[A-Za-z0-9_.:-]` para a emissão manual. Use uma nova chave para cada boleto distinto e reutilize-a ao repetir a mesma tentativa. Ausente: a API gera uma chave interna. Inválida: `400` `BANK_SLIP.ISSUE_FAILED`.
Respostas
Boleto enviado para processamento.
Erro de validação (VALIDATION_FAILED). As mensagens de details[].message são em pt-BR.
Token ausente, inválido ou sem empresa selecionada.
Falha de autorização.
Erro de regra de negócio ou integração.
Chave reutilizada com dados diferentes ou emissão em andamento/resultado incerto que requer conciliação.
Limite de requisições excedido (RATE_LIMIT.EXCEEDED). Por chave: 120 requisições por minuto (janela fixa de 60 s); o 429 da chave traz X-RateLimit-* da chave. Por IP, para tráfego com chave: 600 requisições em 10 minutos; esse 429 traz só Retry-After, sem X-RateLimit-* (os cabeçalhos descrevem apenas o limite da chave). Aguarde Retry-After segundos antes de tentar de novo.
Erro de regra de negócio ou integração.
Erro de regra de negócio ou integração.