Fiskaly Auth

Description

This module performs authentication against the Fiskaly SIGN ES API using the configured API Key and API Secret credentials. Upon successful authentication, it obtains a pair of JWT tokens: access_token to perform operations and refresh_token to renew the session.

It is the first necessary step before using any other Fiskaly module. Other Fiskaly modules manage authentication internally, but this node allows explicitly obtaining tokens if manual control of the authentication flow is needed.

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

Configuration

Parameter	Type	Required	Description
credentials_id	credentials	Yes	Fiskaly credential configured in the system

Credentials

Requires Fiskaly type credentials with the following fields:

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

These values are obtained from the Fiskaly dashboard when registering an organization.

Output

{
  "nextModule": "siguiente_modulo",
  "data": {
    "success": true,
    "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
    "refresh_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
    "message": "Autenticacion Fiskaly exitosa"
  }
}

Usage Example

Basic case

{
  "credentials_id": "mi-credencial-fiskaly"
}

API Used

• Fiskaly SIGN ES API - Authentication endpoint (POST /auth)

Notes

• Other Fiskaly modules authenticate automatically using the _fiskalyHelper helper
• This node is useful for verifying that credentials are correctly configured
• JWT tokens have a limited expiration time

Related Nodes

• FiskalyUpsertTaxpayer - Create/update taxpayer
• FiskalyCreateInvoice - Create/update invoice
• FiskalyGetInvoices - Get invoices
• All other fiskaly* modules