Fiskaly Upsert Software

Descripcion

Este modulo permite registrar o actualizar la informacion de un software de facturacion en Fiskaly. Segun la normativa Verifactu y TicketBAI, es obligatorio declarar ante la autoridad fiscal el software que se utiliza para generar las facturas electronicas.

Se deben proporcionar datos como el nombre del software, version, y la informacion del desarrollador (NIF y nombre de la empresa). El modulo utiliza la operacion PUT (upsert).

Si no se proporciona un software_id, se genera automaticamente un UUIDv4.

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
software_id	text	No	UUID del software (auto-generado si vacio)
name	text	Si	Nombre del software de facturacion
version	text	No	Version del software
nif_developer	text	No	NIF/CIF de la empresa desarrolladora
developer_name	text	No	Nombre de la empresa desarrolladora

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,
    "software": { "...datos del software registrado..." },
    "software_id": "550e8400-e29b-41d4-a716-446655440000",
    "message": "Software \"MiERP v2.0\" registrado exitosamente"
  }
}

Ejemplo de Uso

Caso basico

{
  "credentials_id": "mi-fiskaly",
  "taxpayer_id": "uuid-contribuyente",
  "name": "MiERP",
  "version": "2.0.1",
  "nif_developer": "B87654321",
  "developer_name": "Mi Empresa Software SL"
}

API Utilizada

• Fiskaly SIGN ES API - PUT /taxpayers/{taxpayer_id}/software/{software_id}

Notas

• Utiliza PUT (upsert): si el software ya existe, se actualiza
• Si no se proporciona software_id, se genera un UUIDv4 automaticamente
• El nombre del software es obligatorio
• El registro del software es obligatorio segun la normativa Verifactu/TicketBAI

Nodos Relacionados

• FiskalyGetSoftware - Obtener software
• FiskalyUpsertTaxpayer - Crear/actualizar contribuyente
• FiskalyCreateInvoice - Crear/actualizar factura