Fiskaly Upsert Software

Description

This module allows registering or updating billing software information in Fiskaly. Under the Verifactu and TicketBAI regulations, it is mandatory to declare to the tax authority the software used to generate electronic invoices.

Data such as the software name, version, and developer information (NIF and company name) must be provided. The module uses the PUT (upsert) operation.

If no software_id is provided, a UUIDv4 is automatically generated.

The module is of type hidden (hidden in the main interface).

Configuration

Parameter	Type	Required	Description
credentials_id	credentials	Yes	Fiskaly credential
taxpayer_id	text	Yes	UUID of the taxpayer
software_id	text	No	UUID of the software (auto-generated if empty)
name	text	Yes	Billing software name
version	text	No	Software version
nif_developer	text	No	Developer company NIF/CIF
developer_name	text	No	Developer company name

Credentials

Requires Fiskaly type credentials with:

• api_key: Fiskaly API Key
• api_secret: Fiskaly API Secret

Output

{
  "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"
  }
}

Usage Example

Basic case

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

API Used

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

Notes

• Uses PUT (upsert): if the software already exists, it is updated
• If software_id is not provided, a UUIDv4 is automatically generated
• The software name is required
• Software registration is mandatory under Verifactu/TicketBAI regulations

Related Nodes

• FiskalyGetSoftware - Get software
• FiskalyUpsertTaxpayer - Create/update taxpayer
• FiskalyCreateInvoice - Create/update invoice