Generar orden
Genera la siguiente orden de cobro de una automatización recurrente.
Descripción general
Este endpoint genera en ese momento la orden de cobro de la próxima fecha de cobro de la automatización (next_billing_date), aunque esa fecha sea futura. Es el equivalente a generar la orden manualmente en la aplicación.
La orden de cobro se crea sin CFDI, con fecha de emisión igual a la fecha de cobro y vencimiento a grace_period_days días de la emisión. Su estatus depende de las fechas:
overduesi el vencimiento es hoy o antes.issuedsi la emisión es hoy o antes.createdsi la emisión es futura.
Además:
- Se agrega una fila
manualal historial, conscheduled_dateigual a la fecha cobrada,executed_datede hoy yexecuted_bycon el nombre de la API key. - Se actualizan
last_execution_atynext_billing_date. Si no quedan fechas por cobrar, la automatización pasa acompleted. - No se revisa el estatus: una automatización pausada o completada también genera su orden si tiene una próxima fecha de cobro.
No lleva cuerpo. Una solicitud exitosa devuelve 201 con automation (la automatización actualizada) y executions (un arreglo con la ejecución registrada). Acepta el header Idempotency-Key para reintentar sin generar órdenes duplicadas (ver Idempotencia).
Requiere el permiso Crear en Órdenes de cobro.
Endpoint
https://app.credonix.mx/api/v1/recurring-automations/{automationId}/generatePath param: automationId — el id de la automatización recurrente.
Genera la próxima orden
Sin cuerpo. En el ejemplo, la automatización tenía como próxima fecha 2026-10-14: se generó la orden de cobro de esa fecha y next_billing_date avanzó a 2026-11-14. Consulta la orden con generated_invoice_id en Consultar orden de cobro.
Campos de la respuesta
| Campo | Tipo | Descripción |
|---|---|---|
automation | objeto | La automatización actualizada. Ver Consultar automatización recurrente. |
executions | array | Siempre una ejecución. Ver Historial de automatización recurrente. |
Errores
| Status | Código | Causa |
|---|---|---|
400 | AUTOMATION_HAS_NO_NEXT_BILLING_DATE | La automatización no tiene una próxima fecha de cobro. message: "Error al generar la orden de cobro." |
400 | DEFAULT_LEGAL_ENTITY_NOT_FOUND | La automatización no tiene razón social y la organización no tiene una predeterminada. message: "No se encontró una entidad legal predeterminada para la organización." |
400 | AUTOMATION_INVOICE_FAILED | No se pudo crear la orden de cobro. message: "Error al generar la orden de cobro." La ejecución queda en el historial con estatus error y puedes reintentarla. |
403 | INSUFFICIENT_PERMISSIONS | La API key no tiene el permiso Crear en Órdenes de cobro. |
404 | NOT_FOUND | La automatización recurrente no existe en tu organización. message: "Plan no encontrado." |