Fiskaly Get Invoices

Descripcion

Este modulo permite consultar facturas registradas en Fiskaly. Tiene dos modos de operacion:

1. Obtener por ID: Si se proporciona invoice_id, obtiene los detalles completos de una factura especifica.
2. Listar con filtros: Si invoice_id esta vacio, lista facturas del contribuyente con filtros opcionales por tipo, estado, rango de fechas y paginacion.

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

Configuracion

Parametro	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Credencial Fiskaly
taxpayer_id	text	Si	UUID del contribuyente
invoice_id	text	No	UUID de la factura. Si vacio, lista con filtros
type	select	No	Filtrar por tipo: SIMPLIFIED, COMPLETE, CORRECTING, DRAFT
state	text	No	Filtrar por estado de la factura
date_from	text	No	Filtrar desde fecha (YYYY-MM-DD)
date_to	text	No	Filtrar hasta fecha (YYYY-MM-DD)
limit	text	No	Cantidad maxima de resultados (default: 100)
offset	text	No	Desplazamiento para paginacion

Credenciales

Requiere credenciales de tipo Fiskaly con:

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

Salida

Listado:

{
  "nextModule": "siguiente_modulo",
  "data": {
    "success": true,
    "invoices": [{ "...datos de factura..." }],
    "count": 25
  }
}

Obtener una:

{
  "nextModule": "siguiente_modulo",
  "data": {
    "success": true,
    "invoice": { "...datos completos de la factura..." },
    "invoice_id": "uuid-factura"
  }
}

Ejemplo de Uso

Caso basico - Listar facturas del mes

{
  "credentials_id": "mi-fiskaly",
  "taxpayer_id": "uuid-contribuyente",
  "date_from": "2026-03-01",
  "date_to": "2026-03-31",
  "type": "COMPLETE",
  "limit": "50"
}

API Utilizada

• Fiskaly SIGN ES API - GET /taxpayers/{taxpayer_id}/invoices (listar)
• Fiskaly SIGN ES API - GET /taxpayers/{taxpayer_id}/invoices/{invoice_id} (obtener una)

Notas

• Todos los filtros son opcionales; sin ellos se devuelven todas las facturas
• La paginacion se controla con limit y offset
• El tipo de factura se filtra con el parametro type del query string

Nodos Relacionados

• FiskalyCreateInvoice - Crear/actualizar factura
• FiskalyDeleteInvoice - Eliminar factura borrador
• FiskalyExportInvoices - Exportar facturas
• FiskalyGetTaxpayer - Obtener contribuyentes