Origens da cobrança
Toda cobrança registra de onde veio no campo origem (source). A origem não muda como a régua trata a cobrança — ela existe para você saber a procedência de cada título, filtrar a carteira por fonte e diagnosticar problemas de integração. Ela aparece no detalhe da cobrança e na coluna origem das exportações.
As origens possíveis
| Origem | Código (API) | Como a cobrança nasce |
|---|---|---|
| Manual | manual | Criada pelo operador no formulário Nova Cobrança do dashboard. |
| Planilha | spreadsheet | Criada pela importação por CSV na página Importações. |
| API | api | Criada pela API v1 por um sistema seu (é o padrão para integrações próprias). |
| ERP | erp | Criada por sincronização com um ERP conectado. |
| Kobana | kobana | Espelhada da plataforma Kobana, quando a conta usa o gateway como trilho de emissão e pagamento. |
O que cada origem implica na prática
- Manual — útil para volume baixo ou casos avulsos. Você controla todos os campos na criação, inclusive dados de pagamento (boleto, PIX, link).
- Planilha — o caminho para migrar a carteira ou para operações que vivem no Excel. O sistema deduplica clientes e valida linha a linha; a cobrança já entra com o status correto (Pendente ou Vencida) conforme o vencimento.
- API — a fonte da verdade passa a ser o seu sistema. Use o campo
external_idpara correlacionar cada cobrança com o registro de origem e receber os webhooks de volta com essa referência. - ERP — semelhante à API, mas alimentada pela sincronização do conector. O título nasce e é atualizado a partir do ERP.
- Kobana — no modo integrado, além da emissão, a confirmação de pagamento chega em tempo real por webhook, e a baixa é automática. É a origem com o menor atrito operacional.
Modo integrado × modo standalone
O Dunning funciona nos dois modos, e a origem das cobranças reflete isso:
- Com o gateway Kobana — cobranças de origem
kobana, pagamento confirmado na hora, régua interrompida em tempo real. - Standalone — cobranças de origem
manual,spreadsheet,apiouerp; o sinal de pagamento vem de PSP, arquivo CNAB ou registro manual, cada um com seu nível de confiança (veja Pagamento e baixa).
Os dois modos convivem na mesma conta: você pode importar a carteira antiga por planilha enquanto os títulos novos chegam por API.
Independente da origem, o tratamento é o mesmo
Depois de criada, a cobrança segue o mesmo ciclo de vida, entra na mesma régua (a padrão, se nenhuma for indicada), respeita as mesmas janelas legais e aparece nas mesmas métricas. A origem é rastreabilidade, não privilégio.