Generar órdenes | Credonix

Descripción general

Este endpoint genera las órdenes de cobro de las fechas de cobro que indiques en entry_ids, sin esperar a que llegue cada fecha. Por cada fecha:

La orden se emite con fecha bill_date y vence grace_period_days días después, sin CFDI.
El estatus de la orden depende de sus fechas: overdue si el vencimiento es hoy o anterior, issued si la emisión es hoy o anterior, y created en otro caso.
El historial registra una ejecución manual con scheduled_date igual a bill_date, executed_date igual a hoy y la API key en executed_by.
La fecha queda con processed: true. Cuando ya no quedan fechas sin procesar, la automatización pasa a completed.

Solo se generan fechas sin procesar de esta automatización. Los id desconocidos, ya procesados o de otra automatización se omiten sin error, así que la respuesta puede traer executions vacío. El estatus de la automatización no se revisa: también puedes generar órdenes de una automatización paused o completed.

Las fechas se generan una por una. Si una falla, las anteriores quedan generadas, y la que falla queda en el historial con estatus error.

Una solicitud exitosa devuelve 201 con { automation, executions }. Acepta el header Idempotency-Key para reintentar sin generar dos veces.

Requiere el permiso Crear en Órdenes de cobro.

Endpoint

POSThttps://app.credonix.mx/api/v1/custom-schedule-automations/{automationId}/generate

Path param: automationId — el id de la automatización.

Generar una fecha futura

La automatización tenía sin procesar la fecha 2026-10-14. Al generarla, la fecha queda con processed: true y, como era la última sin procesar, la automatización pasa a completed con next_billing_date: null. executions trae la ejecución registrada, con el id de la orden en generated_invoice_id.

{
  "entry_ids": [
    "cmu21ao1600lev1dqaaxc83og"
  ]
}

curl -X POST "https://app.credonix.mx/api/v1/custom-schedule-automations/cmu21ao1600ldv1dqtv2dukvo/generate" \-H "Authorization: Bearer TU_API_KEY" \-H "Content-Type: application/json" \-d '{  "entry_ids": [    "cmu21ao1600lev1dqaaxc83og"  ]}'

Reglas de los campos

Campo	Tipo	Requerido	Notas
`entry_ids`	array de string	Sí	`id` de las fechas de cobro (`entries[].id`) que quieres generar. Al menos uno.

No se aceptan otros campos: cualquier campo desconocido responde 400 con VALIDATION_ERROR.

Forma de las respuestas

Campo	Tipo	Descripción
`automation`	objeto	La automatización actualizada, con la misma forma que Consultar calendario personalizado.
`executions`	array	Una ejecución por cada fecha generada, con la misma forma que en el historial.

Errores

Status	Código	Causa
`400`	`VALIDATION_ERROR`	Falta `entry_ids`, está vacío (`"Selecciona al menos una fecha de cobro para generar"`) o tiene un valor inválido.
`400`	`DEFAULT_LEGAL_ENTITY_NOT_FOUND`	La automatización no tiene razón social y la organización no tiene una razón social predeterminada.
`400`	`AUTOMATION_INVOICE_FAILED`	No se pudo crear la orden de cobro de una fecha. La ejecución queda en el historial con estatus `error`. La respuesta incluye `"message": "Error al crear la orden de cobro."`.
`401`	`MISSING_API_KEY`, `INVALID_API_KEY`, `API_KEY_REVOKED`	API key ausente, inválida o revocada.
`403`	`INSUFFICIENT_PERMISSIONS`	La API key no tiene el permiso Crear en Órdenes de cobro.
`404`	`NOT_FOUND`	La automatización no existe en tu organización o es de otro tipo. La respuesta incluye `"message": "La automatización no fue encontrada."`.

Historial de calendario personalizado GET

Página anterior

Crear plan de proyecto POST

Página siguiente