BillptDownloadDocument

Descripción

Descarga el archivo PDF de un documento creado en Bill.pt utilizando el endpoint publico /documentos/download/{id}/{token}.

Caracteristicas principales:

• Sin autenticación adicional: El token de descarga esta embebido en la URL — no requiere cabeceras de autorización.
• Primera descarga / copias: La primera descarga devuelve el documento original; las siguientes incluyen marca de segunda copia según normativa fiscal portuguesa.
• Salida flexible: Devuelve el PDF como base64 (compatible con nodos de email, HTTP, etc.) o como buffer binario para nodos de almacenamiento.
• Propagación automática: Si document_id y token_download vienen del nodo anterior (BillptCreateDocument, BillptGetDocuments) no es necesario configurarlos manualmente.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Si	Credencial Bill.pt (determina entorno sandbox/producción)
document_id	text	No	ID del documento. Por defecto usa document_id o id de la entrada anterior
token_download	text	No	Token de descarga. Por defecto usa token_download de la entrada anterior
output_format	select	No	base64 (default) o buffer binario
filename	text	No	Nombre sugerido del archivo. Default: billpt_{document_id}.pdf

Donde obtener el token_download

El campo token_download forma parte de la respuesta de Bill.pt al crear o consultar un documento. Viene incluido en la salida de:

• BillptCreateDocument — en data.document.token_download
• BillptGetDocuments — en cada elemento de data.documents[].token_download
• BillptCreateInvoiceFromShopify — en data.document.token_download

Si conectas este nodo directamente después de cualquiera de ellos, el campo se propaga automáticamente.

Entrada

El nodo acepta la salida de cualquier nodo Bill.pt que devuelva document_id y token_download:

{
  "success": true,
  "document_id": 12345,
  "token_download": "a1b2c3d4e5f6...",
  "fiscal_doc_number": "FT 2025/1042"
}

Salida (base64)

{
  "success": true,
  "document_id": "12345",
  "filename": "billpt_12345.pdf",
  "content_type": "application/pdf",
  "size_bytes": 45230,
  "pdf_base64": "JVBERi0xLjQKJ...",
  "message": "PDF descargado (45230 bytes) — billpt_12345.pdf"
}

Flujo Tipico

BillptCreateInvoiceFromShopify
    → HubfiscalStoreBillpt
    → BillptDownloadDocument   ← descarga el PDF
    → SendEmail (adjunta pdf_base64)

Notas

• El endpoint de descarga no forma parte del prefijo /api/1.0/ — usa directamente https://app.bill.pt/documentos/download/{id}/{token}.
• Si el token es incorrecto o el documento no existe, Bill.pt devuelve un error HTTP 404/403 que el nodo captura y propaga como error de workflow.
• El campo size_bytes permite validar en nodos posteriores que el PDF no esta vacío antes de adjuntarlo o almacenarlo.

Nodos Relacionados

• BillptCreateDocument - Crear documento y obtener token_download
• BillptCreateInvoiceFromShopify - Crear factura desde pedido Shopify
• BillptGetDocuments - Consultar documentos y sus tokens
• HubfiscalStoreBillpt - Guardar resultado Bill.pt en Hub Fiscal