Fiskaly Get Invoices

Description

This module allows querying invoices registered in Fiskaly. It has two modes of operation:

1. Get by ID: If invoice_id is provided, gets the complete details of a specific invoice.
2. List with filters: If invoice_id is empty, lists the taxpayer’s invoices with optional filters by type, state, date range and pagination.

The module is of type hidden (hidden in the main interface).

Configuration

Parameter	Type	Required	Description
credentials_id	credentials	Yes	Fiskaly credential
taxpayer_id	text	Yes	UUID of the taxpayer
invoice_id	text	No	Invoice UUID. If empty, lists with filters
type	select	No	Filter by type: SIMPLIFIED, COMPLETE, CORRECTING, DRAFT
state	text	No	Filter by invoice state
date_from	text	No	Filter from date (YYYY-MM-DD)
date_to	text	No	Filter to date (YYYY-MM-DD)
limit	text	No	Maximum number of results (default: 100)
offset	text	No	Offset for pagination

Credentials

Requires Fiskaly type credentials with:

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

Output

List:

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

Get one:

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

Usage Example

Basic case - List invoices for the month

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

API Used

• Fiskaly SIGN ES API - GET /taxpayers/{taxpayer_id}/invoices (list)
• Fiskaly SIGN ES API - GET /taxpayers/{taxpayer_id}/invoices/{invoice_id} (get one)

Notes

• All filters are optional; without them, all invoices are returned
• Pagination is controlled with limit and offset
• The invoice type is filtered with the type query string parameter

Related Nodes

• FiskalyCreateInvoice - Create/update invoice
• FiskalyDeleteInvoice - Delete draft invoice
• FiskalyExportInvoices - Export invoices
• FiskalyGetTaxpayer - Get taxpayers