Orígenes del cobro
Todo cobro registra de dónde vino en el campo origen (source). El origen no cambia cómo la regla trata el cobro — existe para que sepas la procedencia de cada título, filtres la cartera por fuente y diagnostiques problemas de integración. Aparece en el detalle del cobro y en la columna origem de las exportaciones.
Los orígenes posibles
| Origen | Código (API) | Cómo nace el cobro |
|---|---|---|
| Manual | manual | Creado por el operador en el formulario Nuevo Cobro del panel. |
| Hoja de cálculo | spreadsheet | Creado por la importación por CSV en la página Importaciones. |
| API | api | Creado por la API v1 desde un sistema tuyo (es el estándar para integraciones propias). |
| ERP | erp | Creado por sincronización con un ERP conectado. |
| Kobana | kobana | Espejado desde la plataforma Kobana, cuando la cuenta usa el gateway como riel de emisión y pago. |
Qué implica cada origen en la práctica
- Manual — útil para volumen bajo o casos puntuales. Controlas todos los campos en la creación, incluidos los datos de pago (boleto, Pix, enlace).
- Hoja de cálculo — el camino para migrar la cartera o para operaciones que viven en Excel. El sistema deduplica clientes y valida fila por fila; el cobro ya entra con el estado correcto (Pendiente o Vencido) según el vencimiento.
- API — la fuente de la verdad pasa a ser tu sistema. Usa el campo
external_idpara correlacionar cada cobro con el registro de origen y recibir los webhooks de vuelta con esa referencia. - ERP — similar a la API, pero alimentada por la sincronización del conector. El título nace y se actualiza a partir del ERP.
- Kobana — en el modo integrado, además de la emisión, la confirmación de pago llega en tiempo real por webhook, y la baja es automática. Es el origen con la menor fricción operativa.
Modo integrado × modo standalone
Dunning funciona en ambos modos, y el origen de los cobros lo refleja:
- Con el gateway Kobana — cobros de origen
kobana, pago confirmado al instante, regla interrumpida en tiempo real. - Standalone — cobros de origen
manual,spreadsheet,apioerp; la señal de pago viene de un PSP, un archivo CNAB o un registro manual, cada uno con su nivel de confianza (consulta Pago y baja).
Los dos modos conviven en la misma cuenta: puedes importar la cartera antigua por hoja de cálculo mientras los títulos nuevos llegan por API.
Independiente del origen, el tratamiento es el mismo
Una vez creado, el cobro sigue el mismo ciclo de vida, entra en la misma regla (la predeterminada, si no se indica ninguna), respeta las mismas ventanas legales y aparece en las mismas métricas. El origen es trazabilidad, no privilegio.