Fiskaly Upsert Signer

Descripcion

Este modulo permite registrar o actualizar un firmante (signer) en Fiskaly. Los firmantes son certificados digitales utilizados para la firma electronica de las facturas, requisito obligatorio segun las normativas Verifactu y TicketBAI.

Se pueden proporcionar el certificado y la clave privada en formato PEM, o la contrasena del certificado PKCS12 si aplica. El modulo utiliza la operacion PUT (upsert) de la API.

Si no se proporciona un signer_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
signer_id	text	No	UUID del firmante (auto-generado si vacio)
certificate	textarea	No	Certificado digital en formato PEM
private_key	textarea	No	Clave privada del certificado en formato PEM
password	text	No	Contrasena del certificado PKCS12 (si aplica)

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,
    "signer": { "...datos del firmante..." },
    "signer_id": "550e8400-e29b-41d4-a716-446655440000",
    "message": "Firmante 550e8400-e29b-41d4-a716-446655440000 creado/actualizado exitosamente"
  }
}

Ejemplo de Uso

Caso basico

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

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

Notas

• Utiliza PUT (upsert): si el firmante ya existe, se actualiza
• Si no se proporciona signer_id, se genera un UUIDv4 automaticamente
• Los certificados se pasan en formato PEM (texto con delimitadores BEGIN/END)
• El certificado es necesario para firmar electronicamente las facturas

Nodos Relacionados

• FiskalyGetSigners - Obtener firmantes
• FiskalyUpsertTaxpayer - Crear/actualizar contribuyente
• FiskalyCreateInvoice - Crear/actualizar factura