Fiskaly Obtener Exportación

Descripción

Este modulo complementa al nodo fiskalyExportInvoices. Tiene dos modos de operación:

1. Consultar estado: Si download es false, consulta el estado actual de la exportación (PENDING, PROCESSING, COMPLETED, ERROR).
2. Descargar archivo: Si download es true, descarga el archivo de la exportación completada.

Se utiliza después de haber iniciado una exportación con fiskalyExportInvoices y haber obtenido un export_id.

El modulo es de tipo hidden (oculto en la interfaz principal).

Configuración

Parámetro	Tipo	Requerido	Descripción
credentials_id	credentials	Si	Credencial Fiskaly
taxpayer_id	text	Si	UUID del contribuyente
export_id	text	Si	ID de la exportación (obtenido del nodo Exportar Facturas)
download	boolean	No	Si true, descarga el archivo. Si false, solo consulta el estado (default: false)

Credenciales

Requiere credenciales de tipo Fiskaly con:

• api_key: API Key de Fiskaly
• api_secret: API Secret de Fiskaly

Salida

Consulta de estado:

{
  "nextModule": "siguiente_modulo",
  "data": {
    "success": true,
    "export": { "...datos de la exportacion..." },
    "export_id": "export-uuid-123",
    "status": "COMPLETED",
    "message": "Estado de exportacion: COMPLETED"
  }
}

Descarga de archivo:

{
  "nextModule": "siguiente_modulo",
  "data": {
    "success": true,
    "export_id": "export-uuid-123",
    "file": "...contenido del archivo...",
    "message": "Archivo de exportacion descargado exitosamente"
  }
}

Ejemplo de Uso

Caso básico - Verificar estado

{
  "credentials_id": "mi-fiskaly",
  "taxpayer_id": "uuid-contribuyente",
  "export_id": "export-uuid-obtenido",
  "download": false
}

API Utilizada

• Fiskaly SIGN ES API - GET /taxpayers/{taxpayer_id}/exports/{export_id} (estado)
• Fiskaly SIGN ES API - GET /taxpayers/{taxpayer_id}/exports/{export_id}/download (descarga)

Notas

• Primero consulte el estado para verificar que la exportación esta COMPLETED antes de descargar
• El campo download acepta tanto booleano como string “true”/“false”

Nodos Relacionados

• FiskalyExportInvoices - Exportar facturas
• FiskalyGetInvoices - Obtener facturas