Factuarea API
Factures

Generar enllaç temporal a PDF

Retorna una URL temporal al PDF de la factura en lloc de transmetre els bytes. Còmode per incrustar en emails o apps de missatgeria. Contracte dual: 200 amb la URL quan el PDF ja està materialitzat; 202 amb `status: pendiente` quan la generació s'ha encuat (el PDF es renderitza a la cua `pdf`) — reintenta fins a obtenir el 200.

GET
/invoices/{invoice}/pdf-link

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

application/json

{
  "data": {
    "url": "string",
    "filename": "string",
    "expires_at": "string"
  }
}
{
  "data": {
    "status": "pendiente",
    "document_uuid": "string",
    "pdf_path": "string",
    "pdf_url": "string"
  },
  "message": "La generación del PDF está en curso. El enlace estará disponible en unos segundos."
}

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

Llistar pagaments de factura

Llista els pagaments registrats contra una factura, ordenats per data de pagament. Retorna un array buit quan encara no s'ha registrat cap pagament.

Descarregar el PDF de la factura

Descarrega la representació en PDF d'una factura. Retorna el flux binari del PDF (`application/pdf`).