FelAnular

Description

Cancels a DTE (invoice or note) previously certified with Guatemala’s SAT, identified by its UUID (Authorization Number). The node sends the cancellation request to the certified provider configured in the credential and, if accepted, updates the document’s status to cancelled in Floogos’s database.

Cancellation always requires a reason, which is recorded both with the certifying provider and in the document’s local history.

Configuration

Field	Type	Required	Description
credentials_id	credentials	Yes	FEL credential
uuid	text	Yes	UUID (Authorization Number) of the DTE to cancel
motivo	textarea	Yes	Cancellation reason

Credentials

This module requires a fel credential type (certifying provider, provider username/password or key, issuer NIT, environment).

Output

{
  "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "estado": "cancelled",
  "motivo": "Wrong receptor NIT",
  "fechaAnulacion": "2026-08-05T16:10:00-06:00"
}

Usage Example

{
  "credentials_id": "cred-fel-prod",
  "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "motivo": "Wrong receptor NIT"
}

Notes

• The reason must be at least 3 characters; if not provided, the node stops before contacting the certifying provider.
• Not every certifying provider adapter supports cancellation; if the one configured in the credential does not implement it, the node returns an error stating so.
• Once cancelled, the DTE is marked cancelled and should no longer be used as a reference for credit/debit notes.
• The SAT sets a time window to cancel a DTE (usually within the same calendar month it was issued); past that window the certifying provider will reject the cancellation.

Related Nodes

• FelEmitirFactura - Issue the invoice to cancel
• FelEmitirNota - Issue a credit/debit note
• FelRepresentacion - Generate the printable representation with QR