Obtener una serie
Obtiene una serie por su `uuid`. Las series son **inmutables** por cumplimiento fiscal (AEAT VeriFactu — continuidad legal de la numeración): `PUT`, `PATCH` y `DELETE` sobre `/v1/series/{uuid}` devuelven `405 Method Not Allowed` con `error.code = "series_immutable"` y la cabecera `Allow: GET, POST`. Para "eliminar" una serie usa `POST /v1/series/{uuid}/archive`; para cambiar la numeración, crea una nueva serie y márcala como predeterminada.
En: header
Parámetros de ruta
Cuerpo de la respuesta
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"
}
}{
"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": "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"
}
}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.
Obtener estadísticas de series
KPIs agregados de tus series de numeración de documentos: número total de series, número de activas y archivadas, y desglose por tipo de documento. Devuelto como `{ "data": SeriesStats }`.