Factuarea API
Proveïdors

Llista la línia temporal d'activitat del proveïdor

Retorna la línia de temps d'auditoria d'un proveïdor combinant els seus propis esdeveniments de domini més els esdeveniments de factura de compra i contracte que el referencien. Paginada amb els query params page i per_page (50 per defecte).

GET
/suppliers/{supplier}/activities

Authorization

AuthorizationBearer <token>

A: header

Paràmetres de ruta

supplier*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": "supplier.updated",
      "description": "Se actualizaron las preferencias de pago del proveedor.",
      "metadata": {
        "previous_payment_method": "bank_transfer",
        "new_payment_method": "direct_debit"
      },
      "performed_by": {
        "type": "api_key",
        "id": "01928f12-9abc-7def-8123-456789abcdef",
        "name": "Integración ERP (producción)"
      },
      "created_at": "2026-05-15T10:34:21Z"
    }
  ]
}

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

Verificar un client contra el cens de l'AEAT

Comprova el parell nom + NIF d'un tercer (el destinatari d'una factura) contra el cens de l'AEAT (VNifV2) per anticipar rebutjos VeriFactu 1239 abans de facturar. Sense estat i informatiu: no es persisteix res al client. Fail-open — si l'AEAT no està disponible, la crida retorna 200 amb `status: unavailable`. Les claus de prova (`fact_test_`) retornen estats deterministes segons el NIF màgic sense contactar amb l'AEAT.

Elimina diversos proveïdors de forma massiva

Elimina fins a 200 proveïdors en una petició. Els proveïdors amb contractes associats es reporten a failed juntament amb els seus noms visibles; els UUIDs d'altres tenants s'ignoren.