Códigos de error de Facturas recurrentes
Todos los códigos de error de la API pública que emite Facturas recurrentes, con su estado HTTP, su type y una página por código.
Códigos de error que emite Facturas recurrentes. Cada code enlaza a su propia página con la causa y la acción a tomar.
| Code | Type | HTTP | Descripción |
|---|---|---|---|
invalid_frequency_interval | invalid_request_error | 422 | El intervalo es menor que 1, así que la recurrencia nunca avanzaría a una siguiente ejecución. |
invalid_frequency_type | invalid_request_error | 422 | La frecuencia queda fuera del catálogo daily, weekly, biweekly, monthly, bimonthly, quarterly, semiannual, annual, custom. |
invalid_holiday_handling | invalid_request_error | 422 | La política de festivos queda fuera del catálogo skip, before, after, same. |
invalid_recurring_invoice_id | invalid_request_error | 400 | La referencia de recurrencia recibida no es un identificador válido, normalmente porque un valor interno sustituyó al id público. |
invalid_recurring_invoice_uuid | invalid_request_error | 400 | El identificador de recurrencia de la ruta o del payload no es un UUID válido. |
invalid_recurring_payment_terms_template | invalid_request_error | 422 | La plantilla de calendario de pago de la recurrencia, que se aplica a cada factura que genera, no es válida. |
invalid_recurring_presentation_policy | invalid_request_error | 422 | La política de presentación de la recurrencia, que define cómo se presentan las facturas que genera, tiene un valor no válido. |
recurring_already_active | invalid_request_error | 422 | La recurrencia ya está en marcha, así que no hay nada que activar. Código legacy conservado por compatibilidad: los endpoints actuales reportan esto como recurring_invoice_already_active. |
recurring_invoice_already_active | invalid_request_error | 422 | La recurrencia ya está en marcha. |
recurring_invoice_already_cancelled | invalid_request_error | 422 | La recurrencia ya estaba cancelada, y la cancelación es terminal. |
recurring_invoice_already_paused | invalid_request_error | 422 | La recurrencia ya está pausada, así que pausarla otra vez no cambia nada. |
recurring_invoice_cancelled_cannot_resume | invalid_request_error | 422 | Una recurrencia cancelada no se reanuda: la cancelación la cierra definitivamente, a diferencia de la pausa. |
recurring_invoice_cannot_run | invalid_request_error | 422 | La recurrencia no puede generar una factura ahora mismo: no está en marcha, su ciclo terminó, o le faltan datos que la factura necesita. error.message indica el motivo concreto. |
recurring_invoice_completed_cannot_resume | invalid_request_error | 422 | Una recurrencia completada no se reanuda ni se activa: ya agotó sus ocurrencias o pasó su fecha de fin, así que no le queda ninguna generación pendiente. |
recurring_invoice_has_generated_invoices | invalid_request_error | 422 | La recurrencia ya generó facturas, y esas facturas dependen de ella para su trazabilidad. |
recurring_invoice_not_found | not_found_error | 404 | El identificador no resuelve a ninguna recurrencia de la empresa autenticada. |
recurring_invoice_requires_at_least_one_line | invalid_request_error | 422 | La recurrencia no lleva líneas, así que cada factura generada saldría vacía. |
recurring_not_active | invalid_request_error | 422 | La operación necesita una recurrencia en marcha y esta está pausada, completada o cancelada. Código legacy conservado por compatibilidad con integraciones antiguas. |
recurring_presentation_activation_changed | conflict_error | 409 | La empresa cambió de activación del sistema de presentación dos veces seguidas mientras se generaba la factura recurrente. La generación se detuvo sin escribir nada. |
recurring_presentation_policy_precondition_required | invalid_request_error | 428 | El cambio de la política de presentación no indicó sobre qué versión se basa. |
recurring_presentation_policy_version_conflict | conflict_error | 409 | La política de presentación de la recurrencia cambió después de leerla. |
recurring_presentation_unavailable | invalid_request_error | 422 | Cuando se ejecutó una generación de la recurrencia, la presentación que tiene configurada no estaba disponible, así que no se pudo generar la factura. details.reason indica qué faltaba. |
Relacionado
Códigos de error por categoría
Localiza un error por la categoría que lo emite.
Tabla de referencia completa
Todos los códigos, estados HTTP, tipos y descripciones en una referencia.
Modelo de errores
Interpreta la respuesta de error y gestiona los errores por código.