Factuarea API
Sèries de documents

Llista la línia temporal d'activitat de la sèrie

Retorna la línia de temps d'auditoria d'una sèrie combinant els seus propis esdeveniments de domini (creació, arxivament/desarxivament, canvis de predeterminat, consum de numeració). Paginada amb un cursor de número de pàgina (`starting_after` és el número de la pàgina següent).

GET
/series/{series}/activities

Authorization

AuthorizationBearer <token>

A: header

Paràmetres de ruta

series*string

Cos de la resposta

application/json

application/json

application/json

application/json

application/json

application/json

{
  "has_more": true,
  "next_cursor": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a0c",
  "data": [
    {
      "object": "activity",
      "event_type": "series.created",
      "description": "Serie creada",
      "metadata": {},
      "performed_by": {
        "type": "user",
        "id": "019e5584-7a6d-736a-9f62-03f731ccae3a",
        "name": "Administrador"
      },
      "created_at": "2026-06-01T10:00:46+02:00"
    }
  ]
}

{
  "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"
  }
}

Llistar sèries actives per tipus de document

Retorna totes les sèries no arxivades del tipus de document indicat dins la teva empresa.

Arxivar una sèrie

Arxiva una sèrie perquè deixi d'aparèixer com a disponible per a nous documents. Falla amb 409 si la sèrie és la predeterminada i l'única sèrie activa del seu tipus. Retorna 204 en cas d'èxit.