SIFENDE
Referencia APIExplorador de la API

Cancelar un documento

Envía a SIFEN el evento de cancelación. Sólo se puede cancelar un documento aprobado y dentro del plazo que fija SIFEN. Una respuesta 4003 se trata como éxito equivalente porque SIFEN ya tiene registrada una cancelación para el CDC.

POST
/api/v1/documento-electronico/{cdc}/cancelar

Authorization

apiKey
AuthorizationBearer <token>

API key de Sifende en el header Authorization: Bearer sk_live_.... Además de autenticar, fija el contribuyente emisor: por eso el emisor no se envía en el body.

In: header

Path Parameters

cdc*string

CDC del documento a cancelar, 44 dígitos

Header Parameters

Idempotency-Key?string

Clave opcional para identificar una intención idempotente en operaciones compatibles. Acepta un solo valor de 1 a 255 caracteres ASCII visibles, sin espacios al inicio ni al final.

Match^[!-~](?:[ -~]{0,253}[!-~])?$
Length1 <= length <= 255

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

*/*

application/problem+json

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://example.com/api/v1/documento-electronico/01800123451001001000000122026042710000000006/cancelar" \  -H "Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000" \  -H "Content-Type: application/json" \  -d '{    "motivo": "string"  }'
{  "eventoSifenId": 0,  "documentoElectronicoId": 0,  "contribuyenteId": 0,  "tipoEvento": "string",  "estadoEvento": "string",  "cdc": "string",  "motivo": "string",  "protocoloAutorizacion": "string",  "codigoRespuesta": "string",  "mensajeRespuesta": "string",  "fechaCreacion": "2019-08-24T14:15:22Z",  "fechaProcesamiento": "2019-08-24T14:15:22Z",  "numeroTimbrado": 0,  "establecimiento": "string",  "puntoExpedicion": "string",  "numeroInicio": "string",  "numeroFin": "string",  "tipoDocumento": 0,  "serieNumero": "string"}

Descargar el KuDE en PDF GET

Devuelve un PDF conservado o solicita preparación sin correo si falta. Un 202 es JSON, no un PDF: seguir Location con soloConsulta=true, cada 5 segundos. Solo consulta no publica ni crea otra solicitud; un pendiente no confirma entrega al broker. Se verifican titularidad y retención antes de consultar archivos o solicitar preparación. Las notas de remisión requieren APROBADO o APROBADO_OBSERVACION; de lo contrario, 403. Los fallos técnicos antes informados como 422 ahora usan 500/503 según la causa.

Inutilizar un rango de numeración POST

Informa a SIFEN que un rango de números de un timbrado no se va a usar. Una respuesta 4066 deja el resultado terminal INDETERMINADA y bloquea nuevos envíos para proteger el rango.