Reintentar ejecución

Descripción general

Este endpoint reintenta una ejecución del historial de una automatización recurrente, por calendario personalizado o por plan de proyecto. Solo acepta ejecuciones con estatus error.

La orden de cobro se crea sin CFDI, con fecha de emisión igual a la scheduled_date de la ejecución y vencimiento a grace_period_days días de esa fecha; su estatus depende de las fechas, igual que al generar una orden. Si tiene éxito, la misma fila del historial pasa a success con su generated_invoice_id; executed_date, execution_type y executed_by conservan sus valores originales. Si la generación falla, la fila sigue en error.

Dos reintentos simultáneos de la misma ejecución generan una sola orden de cobro: el segundo responde 409 con AUTOMATION_RUN_NOT_FAILED.

Según el tipo de automatización:

Recurrente: solo se genera la orden de cobro; la automatización no cambia, ni siquiera last_execution_at.
Calendario personalizado: se cobra la entrada cuya bill_date coincide con scheduled_date, se marca como procesada y el calendario pasa a completed si no quedan entradas pendientes.
Plan de proyecto: se cobra la parte del hito de la ejecución (milestone_id), el hito se completa con completed_at igual a scheduled_date, se descuenta de remaining_amount, se actualiza last_execution_at y el plan pasa a completed si no quedan hitos pendientes.

No lleva cuerpo. Una solicitud exitosa devuelve 200 con la fila del historial actualizada. Acepta el header Idempotency-Key (ver Idempotencia).

Requiere el permiso Crear en Órdenes de cobro.

Endpoint

POSThttps://app.credonix.mx/api/v1/automation-history/{historyId}/retry

Path param: historyId — el id de la ejecución, tomado del historial de la automatización (recurrente, calendario personalizado o plan de proyecto).

Reintenta una ejecución con error

Sin cuerpo. En el ejemplo, una ejecución automática de una automatización recurrente había terminado con error. Tras el reintento, la fila queda en success con la orden de cobro generada y conserva su execution_type y su executed_by originales. La forma de la fila se describe en Historial de automatización recurrente.

Errores

`409` — la ejecución no terminó con error

{
  "code": "AUTOMATION_RUN_NOT_FAILED",
  "message": "Solo es posible reintentar ejecuciones de la automatización con estatus de error.",
  "request_id": "76802c25-f1d5-4d04-a177-8843f3ca2ad3"
}

Status	Código	Causa
`400`	`HISTORY_WITHOUT_SCHEDULED_DATE`	La ejecución no tiene fecha programada.
`400`	`DEFAULT_LEGAL_ENTITY_NOT_FOUND`	La automatización no tiene razón social y la organización no tiene una predeterminada.
`400`	`SCHEDULE_ENTRY_NOT_FOUND`	El calendario personalizado ya no tiene una entrada para la fecha programada. `message`: "No se encontró la entrada del calendario para la fecha programada."
`400`	`AUTOMATION_INVOICE_FAILED`	No se pudo crear la orden de cobro. `message` explica la causa.
`403`	`INSUFFICIENT_PERMISSIONS`	La API key no tiene el permiso Crear en Órdenes de cobro.
`404`	`NOT_FOUND`	La ejecución no existe en tu organización, o ya no existe su automatización.
`409`	`AUTOMATION_RUN_NOT_FAILED`	La ejecución no tiene estatus `error`, o un reintento simultáneo ya la tomó.
`409`	`MILESTONE_ALREADY_COMPLETED`	El hito de la ejecución ya fue completado.
`409`	`MILESTONE_NOT_LINKED`	La ejecución no tiene un hito vinculado. Marca el hito como completado con Completar hitos.

Completar hitos POST

Página anterior

Listar grupos de mensajes GET

Página siguiente