Recupera las estadísticas de albaranes
Devuelve KPIs agregados de tus albaranes: total de documentos, importe acumulado, desglose por estado, número pendiente de firma y número convertido a factura este mes.
En: header
Cuerpo de la respuesta
application/json
application/json
application/json
application/json
application/json
{
"data": {
"total_count": 87,
"total_amount": 64210.5,
"by_status": {
"draft": {
"status": "draft",
"count": 12,
"total": 8400
},
"delivered": {
"status": "delivered",
"count": 58,
"total": 41250.5
},
"invoiced": {
"status": "invoiced",
"count": 14,
"total": 13560
},
"cancelled": {
"status": "cancelled",
"count": 3,
"total": 1000
}
},
"pending_signature": 21,
"converted_this_month": 6
}
}{
"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"
}
}Olvidar la PII de la firma del albarán
RGPD Art. 17 (derecho de supresión) — elimina los datos personales (nombre/DNI del receptor) de una entrada del registro de auditoría de firma conservando el rastro de auditoría sin PII requerido para el cumplimiento de la LSSI-CE. El `{auditId}` es la clave primaria numérica del registro de auditoría de firma. Requiere el scope `delivery_notes:gdpr_forget`.
Listar estados de albarán
Lista el catálogo cerrado de estados de albarán (`draft`, `delivered`, `invoiced`, `cancelled`) con sus etiquetas públicas y colores. Úsalo para poblar filtros o selectores de estado en lugar de codificar valores a mano. El campo `data` de la respuesta es un array de elementos `{ value, label, color }`.