Fiskaly Upsert Client

Descripcion

Este modulo permite crear o actualizar un dispositivo (client) en Fiskaly mediante operacion PUT (upsert). En el contexto de Fiskaly, un “Client” representa un punto de venta o dispositivo desde el cual se emiten facturas. Cada dispositivo de facturacion debe estar registrado como client asociado a un contribuyente.

Si no se proporciona un client_id, se genera automaticamente un UUIDv4. Los campos opcionales incluyen numero de identificacion fiscal del cliente, codigo de pais y direccion en formato JSON.

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 propietario del dispositivo
client_id	text	No	UUID del cliente (auto-generado si vacio)
name	text	Si	Nombre identificativo del dispositivo/TPV
tax_number	text	No	NIF/CIF del cliente
country_code	text	No	Codigo ISO del pais (default: ES)
address	textarea	No	Direccion en JSON: {street, city, postal_code}

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,
    "client": { "...datos del dispositivo creado..." },
    "client_id": "550e8400-e29b-41d4-a716-446655440000",
    "message": "Cliente \"TPV Principal\" creado/actualizado exitosamente"
  }
}

Ejemplo de Uso

Caso basico

{
  "credentials_id": "mi-fiskaly",
  "taxpayer_id": "uuid-contribuyente",
  "name": "TPV Tienda Madrid",
  "tax_number": "B12345678",
  "country_code": "ES",
  "address": "{\"street\": \"Calle Mayor 1\", \"city\": \"Madrid\", \"postal_code\": \"28001\"}"
}

API Utilizada

• Fiskaly SIGN ES API - PUT /taxpayers/{taxpayer_id}/clients/{client_id}

Notas

• Utiliza PUT (upsert): si el client ya existe, se actualiza
• Si no se proporciona client_id, se genera un UUIDv4 automaticamente
• El campo address debe ser un JSON valido con las claves street, city y postal_code
• El nombre del dispositivo es obligatorio y debe ser identificativo

Nodos Relacionados

• FiskalyGetClients - Obtener dispositivos
• FiskalyUpsertTaxpayer - Crear/actualizar contribuyente
• FiskalyCreateInvoice - Crear/actualizar factura