Fiskaly Obtener Clientes

Descripción

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

1. Obtener por ID: Si se proporciona client_id, obtiene los detalles de un dispositivo especifico.
2. Listar todos: Si client_id esta vacío, lista todos los dispositivos del contribuyente con soporte de paginación.

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).

Configuración

Parámetro	Tipo	Requerido	Descripción
credentials_id	credentials	Si	Credencial Fiskaly
taxpayer_id	text	Si	UUID del contribuyente
client_id	text	No	UUID del cliente/dispositivo. Si vacío, lista todos
limit	text	No	Cantidad maxima de resultados (default: 100)
offset	text	No	Desplazamiento para paginación

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 básico - 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 único dispositivo
• La paginación se controla con limit y offset

Nodos Relacionados

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