Fiskaly Get Taxpayer

Description

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

1. Get by ID: If taxpayer_id is provided, gets the complete details of a specific taxpayer including name, NIF/CIF, territory and tax configuration.
2. List all: If taxpayer_id is empty, lists all taxpayers in the organization with pagination support.

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	No	UUID of the taxpayer. 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

List:

{
  "nextModule": "siguiente_modulo",
  "data": {
    "success": true,
    "taxpayers": [{ "...datos del contribuyente..." }],
    "count": 5
  }
}

Get one:

{
  "nextModule": "siguiente_modulo",
  "data": {
    "success": true,
    "taxpayer": { "...datos completos del contribuyente..." },
    "taxpayer_id": "uuid-contribuyente"
  }
}

Usage Example

Basic case - List all

{
  "credentials_id": "mi-fiskaly",
  "limit": "50"
}

API Used

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

Notes

• Does not require taxpayer_id for listing (unlike most Fiskaly nodes)
• Pagination is controlled with limit and offset

Related Nodes

• FiskalyUpsertTaxpayer - Create/update taxpayer
• FiskalyGetClients - Get devices
• FiskalyGetSigners - Get signers
• FiskalyGetInvoices - Get invoices