HubfiscalExportPdf

Descripcion

Exporta archivos de tickets (PDF y/o HTML) almacenados en la base de datos Hub Fiscal. El comportamiento se adapta segun la cantidad de documentos solicitados:

• Un solo documento: Retorna el archivo individual (PDF o HTML) con URL de descarga directa.
• Multiples documentos: Genera un archivo ZIP con todos los tickets, organizado en subcarpetas por pais (ej: PT/, ES/).

El formato de salida es compatible con otros nodos de exportacion de Floogos (createCsv, saveToExcel) retornando { filename, filePath, urlPath }.

Configuracion

Campo	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Credencial Hub Fiscal SQL Server (MSSQL)
document_ids	text	Si	ID(s) de documentos: un ID, lista separada por comas, o {{variable}} con array
format	select	No	Formato de exportacion: pdf, html, o both (ambos). Default: pdf
output_name	text	No	Nombre base para el ZIP (sin extension). Default: hubfiscal-export
timeout	text	No	Timeout en milisegundos (default: 60000)

Credenciales

Usa el mismo tipo de credencial que HubfiscalCreateDocument (proveedor hubfiscalCreateDocument).

Salida

Un solo documento

{
  "filename": "FT-2026-1-1712345678.pdf",
  "filePath": "/www/wwwroot/floogos/engine_us1/temporal/cli_123/FT-2026-1-1712345678.pdf",
  "urlPath": "https://us1.floogos.com/download/cli_123/FT-2026-1-1712345678.pdf",
  "document_id": 42,
  "format": "pdf",
  "total_documents": 1
}

Multiples documentos (ZIP)

{
  "filename": "hubfiscal-export-1712345678.zip",
  "filePath": "/www/wwwroot/floogos/engine_us1/temporal/cli_123/hubfiscal-export-1712345678.zip",
  "urlPath": "https://us1.floogos.com/download/cli_123/hubfiscal-export-1712345678.zip",
  "format": "zip",
  "total_documents": 15,
  "total_found": 15,
  "size_bytes": 245760,
  "documents_exported": [
    { "id": 42, "order_number": "PT14684", "fiscal_doc_number": "FT 2026/1", "country_iso": "PT" },
    { "id": 43, "order_number": "ES10521", "fiscal_doc_number": "FT 2026/2", "country_iso": "ES" }
  ]
}

Estructura interna del ZIP

hubfiscal-export-1712345678.zip
├── PT/
│   ├── FT-2026-1.pdf
│   ├── FT-2026-2.pdf
│   └── FT-2026-3.html
└── ES/
    ├── FT-2026-10.pdf
    └── FT-2026-11.pdf

Ejemplo de Uso

Exportar PDF de un solo documento:

{
  "credentials_id": "10",
  "document_ids": "{{hub_document_id}}",
  "format": "pdf"
}

Exportar multiples documentos como ZIP con ambos formatos:

{
  "credentials_id": "10",
  "document_ids": "1,2,3,4,5",
  "format": "both",
  "output_name": "facturas-abril-2026"
}

Encadenar con HubfiscalGetDocuments para exportar resultados filtrados:

HubfiscalGetDocuments (filtro por fecha + pais) → EditFields (extraer IDs) → HubfiscalExportPdf

Notas

• Usa la libreria archiver para generacion de ZIP con nivel de compresion zlib 6
• Los documentos sin contenido de ticket en el formato solicitado se omiten (no se incluyen en el ZIP)
• La URL de descarga usa el endpoint estandar de Floogos /download/:path_cli/:filename
• Los archivos se almacenan en el directorio temporal/cli_{client_id}/ del servidor
• La diferencia entre total_found y total_documents indica documentos sin contenido de ticket
• Los archivos ZIP organizan los tickets en subcarpetas por codigo ISO de pais
• El timeout por defecto es 60000ms (1 minuto) ya que exportaciones grandes pueden tardar mas

Nodos Relacionados

• HubfiscalGetDocuments - Consultar documentos para obtener IDs a exportar
• HubfiscalCreateDocument - Crear/registrar documento
• HubfiscalUpdateDocument - Actualizar documento (ej: adjuntar ticket)