Historial | Credonix

Descripción general

Este endpoint devuelve el historial de una automatización por plan de proyecto: una fila por cada ejecución, con el hito cobrado, el resultado y la orden de cobro creada. Los resultados están paginados de 20 en 20 y ordenados del más reciente al más antiguo.

Los hitos cobrados con Completar hitos se registran como manual, con el hito en milestone_id.
Una ejecución con estatus error se puede reintentar con Reintentar ejecución.

Requiere el permiso Leer en Automatizaciones.

Endpoint

GEThttps://app.credonix.mx/api/v1/project-plan-automations/{automationId}/history

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

Automatización sin ejecuciones

Un plan que todavía no ha cobrado hitos responde 200 con results vacío.

Query params

Parámetro	Tipo	Descripción
`page`	integer	Página, empieza en `1`. Por defecto `1`.

Forma de cada ejecución

Cada elemento de results tiene esta forma. Este ejemplo es la ejecución que registra Completar hitos:

{
  "id": "cmu21aq9200n8v1dqzaq4wn2h",
  "automation": {
    "type": "project_plan",
    "id": "cmu21apfn00mlv1dq9t8s6fly"
  },
  "milestone_id": "cmu21apfn00mov1dq96rwtxxs",
  "scheduled_date": "2026-09-14",
  "executed_date": "2026-09-14",
  "execution_type": "manual",
  "status": "success",
  "generated_invoice_id": "cmu21aq8t00n0v1dqtubu362v",
  "executed_by": {
    "type": "api_key",
    "name": "Integración ERP"
  },
  "created_at": "2026-09-15T02:09:52.743Z",
  "updated_at": "2026-09-15T02:09:52.743Z"
}

Campo	Tipo	Descripción
`id`	string	Identificador de la ejecución. Úsalo en Reintentar ejecución.
`automation`	objeto	Automatización de la ejecución: `type` e `id`.
`milestone_id`	string \| null	Hito cobrado en la ejecución.
`scheduled_date`	string \| null	Fecha de completado del hito (`YYYY-MM-DD`).
`executed_date`	string	Fecha (`YYYY-MM-DD`) en que se ejecutó.
`execution_type`	string	`manual` o `automated`.
`status`	string	`success`, `error` o `partially_executed`.
`generated_invoice_id`	string \| null	`id` de la orden de cobro generada. Consúltala con Consultar orden de cobro.
`executed_by`	objeto	Quién la ejecutó: `{ "type": "api_key", "name": ... }` con el nombre de la API key, `{ "type": "user", "name": ... }` para un usuario de la aplicación, o `{ "type": "automation", "name": ... }` para una ejecución automática.
`created_at`	string	Fecha de creación (ISO 8601).
`updated_at`	string	Fecha de la última actualización (ISO 8601).

Errores

Status	Código	Causa
`400`	`INVALID_PAGE`	`page` no es un número entero entre 1 y 107374183.
`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 Leer en Automatizaciones.
`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."`.

Activar plan de proyecto POST

Página anterior

Completar hitos POST

Página siguiente