Factuarea API
Factures

Llistar l'activitat de la factura

Retorna la línia de temps d'activitat paginada per cursor (log d'auditoria) d'una sola factura: transicions d'estat, emails, recordatoris i canvis de metadades.

GET
/invoices/{invoice}/activities

Authorization

AuthorizationBearer <token>

A: header

Paràmetres de ruta

invoice*string

Cos de la resposta

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": "invoice.paid",
      "description": "La factura se marcó como cobrada por transferencia bancaria.",
      "metadata": {
        "payment_method": "bank_transfer",
        "paid_amount": "1210.00"
      },
      "performed_by": {
        "type": "user",
        "id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8c01",
        "name": "Ana García"
      },
      "created_at": "2026-03-20T10: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"
  }
}

Puja un vídeo a un producte

Adjunta un fitxer de vídeo (mp4, mov, avi o webm; fins a 50 MB) al producte. Reemplaça qualsevol vídeo existent.

Anul·lar una factura

Anul·la una factura amb un motiu documentat. Quan VeriFactu està habilitat, el handler crea automàticament el registre d'anul·lació de l'AEAT.