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 }`.
En: header
Cuerpo de la respuesta
application/json
application/json
application/json
application/json
application/json
{
"data": {
"total": 17,
"invoice": 5,
"quote": 2,
"delivery_note": 3,
"proforma": 4
}
}{
"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"
}
}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.
Desarchivar una serie
Devuelve una serie archivada al conjunto activo. No cambia el predeterminado actual de su tipo. Devuelve 204 si tiene éxito.