Fiskaly Upsert Signer

Description

This module allows registering or updating a signer in Fiskaly. Signers are digital certificates used for the electronic signing of invoices, a mandatory requirement under the Verifactu and TicketBAI regulations.

The certificate and private key can be provided in PEM format, or the PKCS12 certificate password if applicable. The module uses the API’s PUT (upsert) operation.

If no signer_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
signer_id	text	No	UUID of the signer (auto-generated if empty)
certificate	textarea	No	Digital certificate in PEM format
private_key	textarea	No	Certificate private key in PEM format
password	text	No	PKCS12 certificate password (if applicable)

Credentials

Requires Fiskaly type credentials with:

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

Output

{
  "nextModule": "siguiente_modulo",
  "data": {
    "success": true,
    "signer": { "...datos del firmante..." },
    "signer_id": "550e8400-e29b-41d4-a716-446655440000",
    "message": "Firmante 550e8400-e29b-41d4-a716-446655440000 creado/actualizado exitosamente"
  }
}

Usage Example

Basic case

{
  "credentials_id": "mi-fiskaly",
  "taxpayer_id": "uuid-contribuyente",
  "certificate": "-----BEGIN CERTIFICATE-----\nMIID...\n-----END CERTIFICATE-----",
  "private_key": "-----BEGIN PRIVATE KEY-----\nMIIE...\n-----END PRIVATE KEY-----"
}

API Used

• Fiskaly SIGN ES API - PUT /taxpayers/{taxpayer_id}/signers/{signer_id}

Notes

• Uses PUT (upsert): if the signer already exists, it is updated
• If signer_id is not provided, a UUIDv4 is automatically generated
• Certificates are passed in PEM format (text with BEGIN/END delimiters)
• The certificate is needed to electronically sign invoices

Related Nodes

• FiskalyGetSigners - Get signers
• FiskalyUpsertTaxpayer - Create/update taxpayer
• FiskalyCreateInvoice - Create/update invoice