HubfiscalExportPdf

Descripción

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

• Un solo documento: Retorna el archivo individual (PDF o HTML) con URL de descarga directa.
• Múltiples 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 exportación de Floogos (createCsv, saveToExcel) retornando { filename, filePath, urlPath }.

Configuración

Campo	Tipo	Requerido	Descripción
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 exportación: 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
}

Múltiples 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

Ejemplo de Uso

Exportar PDF de un solo documento:

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

Exportar múltiples 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 generación 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 estándar 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 código 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)