Factuarea API
Facturas

Listar la actividad de la factura

Devuelve la línea de tiempo de actividad paginada por cursor (log de auditoría) de una sola factura: transiciones de estado, emails, recordatorios y cambios de metadatos.

GET
/invoices/{invoice}/activities

Authorization

AuthorizationBearer <token>

En: header

Parámetros de ruta

invoice*string

Cuerpo de la respuesta

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

Sube un vídeo a un producto

Adjunta un archivo de vídeo (mp4, mov, avi o webm; hasta 50 MB) al producto. Reemplaza cualquier vídeo existente.

Anular una factura

Anula una factura con un motivo documentado. Cuando VeriFactu está habilitado, el handler crea automáticamente el registro de anulación de la AEAT.