Fiskaly Get Clients

Description

This module allows querying devices (clients) registered in Fiskaly for a taxpayer. It has two modes of operation:

1. Get by ID: If client_id is provided, gets the details of a specific device.
2. List all: If client_id is empty, lists all devices for the taxpayer with pagination support.

In Fiskaly terminology, a “Client” represents a device or point of sale (POS) from which invoices are issued.

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
client_id	text	No	UUID of the client/device. If empty, lists all
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

{
  "nextModule": "siguiente_modulo",
  "data": {
    "success": true,
    "clients": [{ "...datos del dispositivo..." }],
    "count": 3
  }
}

Or when getting a specific one:

{
  "nextModule": "siguiente_modulo",
  "data": {
    "success": true,
    "client": { "...datos del dispositivo..." },
    "client_id": "uuid-cliente"
  }
}

Usage Example

Basic case - List all devices

{
  "credentials_id": "mi-fiskaly",
  "taxpayer_id": "uuid-contribuyente",
  "limit": "50"
}

API Used

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

Notes

• If client_id is provided, a single device is returned
• Pagination is controlled with limit and offset

Related Nodes

• FiskalyUpsertClient - Create/update device
• FiskalyUpsertTaxpayer - Create/update taxpayer
• FiskalyGetTaxpayer - Get taxpayers