Factuarea API
Proveedores

Lista la línea temporal de actividad del proveedor

Devuelve la línea de tiempo de auditoría de un proveedor combinando sus propios eventos de dominio más los eventos de factura de compra y contrato que lo referencian. Paginada con los query params page y per_page (50 por defecto).

GET
/suppliers/{supplier}/activities

Authorization

AuthorizationBearer <token>

En: header

Parámetros de ruta

supplier*string

Cuerpo de la respuesta

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 cliente contra el censo de la AEAT

Comprueba el par nombre + NIF de un tercero (el destinatario de una factura) contra el censo de la AEAT (VNifV2) para anticipar rechazos VeriFactu 1239 antes de facturar. Sin estado e informativo: no se persiste nada en el cliente. Fail-open — si la AEAT no está disponible, la llamada devuelve 200 con `status: unavailable`. Las claves de prueba (`fact_test_`) devuelven estados deterministas según el NIF mágico sin contactar con la AEAT.

Elimina varios proveedores de forma masiva

Elimina hasta 200 proveedores en una petición. Los proveedores con contratos asociados se reportan en failed junto con sus nombres visibles; los UUIDs de otros tenants se ignoran.