Fiskaly Get Clients

Descripcion

Este modulo permite consultar dispositivos (clients) registrados en Fiskaly para un contribuyente. Tiene dos modos de operacion:

1. Obtener por ID: Si se proporciona client_id, obtiene los detalles de un dispositivo especifico.
2. Listar todos: Si client_id esta vacio, lista todos los dispositivos del contribuyente con soporte de paginacion.

En la terminologia de Fiskaly, un “Client” representa un dispositivo o punto de venta (TPV) desde el cual se emiten facturas.

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
client_id	text	No	UUID del cliente/dispositivo. 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

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

O al obtener uno especifico:

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

Ejemplo de Uso

Caso basico - Listar todos los dispositivos

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

API Utilizada

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

Notas

• Si se proporciona client_id, se obtiene un unico dispositivo
• La paginacion se controla con limit y offset

Nodos Relacionados

• FiskalyUpsertClient - Crear/actualizar dispositivo
• FiskalyUpsertTaxpayer - Crear/actualizar contribuyente
• FiskalyGetTaxpayer - Obtener contribuyentes