Listar todas las series
Lista tus series de numeración de documentos con paginación por cursor.
En: header
Parámetros de consulta
Número de objetos a devolver. Entero entre 1 y 100. Por defecto 25.
251 <= value <= 100Cursor para paginación hacia delante. Usa el uuid del último objeto de la página anterior.
uuidCursor para paginación hacia atrás. Usa el uuid del primer objeto de la página actual.
uuidTipo de documento (invoice, quote, etc.). Coincidencia exacta en document_type.
Tipo de documento (invoice, quote, etc.). Lista separada por comas. Coincide cualquiera de los valores.
Cuerpo de la respuesta
application/json
application/json
application/json
application/json
application/json
application/json
{
"data": [
{
"id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a0e",
"object": "series",
"code": "F-2026",
"name": "Facturas 2026",
"document_type": "invoice",
"prefix": "F-2026-",
"number_format": "{code}-{YYYY}-{000}",
"next_number": 46,
"current_number": 45,
"initial_number": 1,
"year_reset": true,
"is_default": true,
"is_active": true,
"created_at": "2026-01-01T00:00:00Z",
"updated_at": "2026-01-20T11:30:00Z"
}
],
"has_more": true,
"next_cursor": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a0c"
}{
"error": {
"type": "authentication_error",
"code": "missing_api_key",
"message": "No se ha proporcionado una API key válida en el header Authorization.",
"param": null,
"doc_url": "https://docs.factuarea.com/guides/errors#missing_api_key",
"request_id": "req_01HKQS5N8VR7QXJ9K3T6BWPMZA"
}
}{
"error": {
"type": "authorization_error",
"code": "insufficient_scope",
"message": "Esta API key no tiene el scope requerido para esta operación.",
"param": null,
"doc_url": "https://docs.factuarea.com/guides/errors#insufficient_scope",
"request_id": "req_01HKQS5NBC3P8M1KX4V7SLNHQD"
}
}{
"error": {
"type": "invalid_request_error",
"code": "parameter_invalid",
"message": "El campo `name` es obligatorio y no puede estar vacío.",
"param": "name",
"doc_url": "https://docs.factuarea.com/guides/errors#parameter_invalid",
"request_id": "req_01HKQS5NGS8Z3T6Q1D2E7FYVSI"
}
}{
"error": {
"type": "rate_limit_error",
"code": "rate_limit_exceeded",
"message": "Has excedido el rate limit de 60 peticiones por minuto. Reintenta tras 30 segundos.",
"param": null,
"doc_url": "https://docs.factuarea.com/guides/errors#rate_limit_exceeded",
"request_id": "req_01HKQS5NKW1C6W9T4G5H0JBZVL"
}
}{
"error": {
"type": "api_error",
"code": "internal_error",
"message": "Ha ocurrido un error inesperado. Si persiste, contacta con soporte adjuntando el request_id.",
"param": null,
"doc_url": "https://docs.factuarea.com/guides/errors#internal_error",
"request_id": "req_01HKQS5NLX2D7X0U5H6J1KCAWM"
}
}Buscar una serie por código
Busca una serie por su `code` (enviado en el body JSON, sin distinción de mayúsculas). Un `code` NO es globalmente único: el mismo `code` puede reutilizarse entre distintos `document_type`s (multi-serie — p. ej. una serie `2026` para facturas y otra `2026` para presupuestos). Por tanto: pasa `document_type` para desambiguar y resolver la serie exacta `(code, document_type)`. Si omites `document_type`, el código se busca en todos los tipos de documento ordenados por `uuid` ascendente — cuando coincide exactamente una serie se devuelve, pero cuando coinciden varias (código ambiguo) la petición devuelve 422 `document_type_required_for_ambiguous_code` (NO elige una en silencio). Devuelve la serie coincidente, o 404 si no existe ninguna dentro de tu empresa.
Marca una serie como predeterminada para su tipo
Promueve una serie a predeterminada para su tipo de documento. Si otra serie era la predeterminada para el mismo tipo, se degrada de forma atómica. Devuelve 204 en caso de éxito.