Factuarea API
Facturas

Generar enlace temporal a PDF

Devuelve una URL temporal al PDF de la factura en lugar de transmitir los bytes. Cómodo para incrustar en emails o apps de mensajería. Contrato dual: 200 con la URL cuando el PDF ya está materializado; 202 con `status: pendiente` cuando la generación se ha encolado (el PDF se renderiza en la cola `pdf`) — reintenta hasta obtener el 200.

GET
/invoices/{invoice}/pdf-link

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

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

Listar pagos de factura

Lista los pagos registrados contra una factura, ordenados por fecha de pago. Devuelve un array vacío cuando aún no se ha registrado ningún pago.

Descargar el PDF de la factura

Descarga la representación en PDF de una factura. Devuelve el flujo binario del PDF (`application/pdf`).