Fiskaly Get Taxpayer

Descripcion

Este modulo permite consultar contribuyentes (taxpayers) registrados en Fiskaly. Tiene dos modos de operacion:

1. Obtener por ID: Si se proporciona taxpayer_id, obtiene los detalles completos de un contribuyente especifico incluyendo nombre, NIF/CIF, territorio y configuracion fiscal.
2. Listar todos: Si taxpayer_id esta vacio, lista todos los contribuyentes de la organizacion con soporte de 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	No	UUID del contribuyente. Si vacio, lista todos
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,
    "taxpayers": [{ "...datos del contribuyente..." }],
    "count": 5
  }
}

Obtener uno:

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

Ejemplo de Uso

Caso basico - Listar todos

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

API Utilizada

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

Notas

• No requiere taxpayer_id para listar (a diferencia de la mayoria de nodos Fiskaly)
• La paginacion se controla con limit y offset

Nodos Relacionados

• FiskalyUpsertTaxpayer - Crear/actualizar contribuyente
• FiskalyGetClients - Obtener dispositivos
• FiskalyGetSigners - Obtener firmantes
• FiskalyGetInvoices - Obtener facturas