SifenCancelarDE
Description
Section titled “Description”Cancels an Electronic Document that was already approved by SIFEN, through a signed event (siRecepEvento). The node builds the cancellation event with the given reason, signs it with the .p12 certificate from the credential, and sends it over SOAP with mutual TLS. Cancellation is only valid within the deadline set by DNIT from the DE’s approval; past that deadline, DNIT rejects the event.
Configuration
Section titled “Configuration”| Field | Type | Required | Description |
|---|---|---|---|
| credentials_id | credentials | Yes | SIFEN credential |
| cdc | text | No | CDC of the DE to cancel, 44 digits. If left empty, taken from the input data |
| motivo | textarea | Yes | Cancellation reason, between 5 and 500 characters |
Credentials
Section titled “Credentials”This module requires a sifen credential (.p12 certificate, RUC and environment). See the full field list in SifenEmitirDE.
Output
Section titled “Output”{ "success": true, "cdc": "01800123456001001000001234567890123456789012", "estado": "cancelled", "codigo": "0260", "mensaje": "Evento procesado con éxito", "protocolo": "112233445"}Usage Example
Section titled “Usage Example”{ "credentials_id": "cred-sifen-prod", "cdc": "01800123456001001000001234567890123456789012", "motivo": "Error in the receiver's data"}- The reason must be between 5 and 500 characters; the node validates this before contacting SIFEN
- Cancellation is sent as a signed event, not as a new DE: the original voucher is marked as cancelled, it is not replaced
- Only valid within the deadline set by DNIT from the approval (typically 48 hours by regulation); past that deadline a credit note must be issued instead
- If SIFEN rejects the event, the node returns the rejection code and message without marking the DE as cancelled locally
Related Nodes
Section titled “Related Nodes”- SifenEmitirDE - Issue the DE that can later be cancelled
- SifenConsultarDE - Verify the DE’s status after cancellation