Invalidación (Anulación)

La invalidación (o anulación) se utiliza para dejar sin efecto un DTE emitido que contiene errores o cuya operación no se concretó.

Endpoint

POST /dte/anulacion

(Consulta la guía de Endpoints y Entornos para obtener la URL base).

Estructura del Payload (JSON)

El endpoint soporta dos formas de invalidación según el motivo de la operación:

1. Sustitución de Factura (tipoAnulacion: 1)

Se utiliza cuando se desea anular una factura para ser sustituida por una nueva. En este caso, es obligatorio incluir el campo codigoGeneracionR con el UUID de la nueva factura aprobada.

{
  "codigoGeneracion": "CB33B9B5-7027-4D5F-8C5A-BDFD3416A0F8",
  "codigoGeneracionR": "DF48F726-A717-4C22-A314-875C7B289D9D",
  "motivo": {
    "tipoAnulacion": 1,
    "motivoAnulacion": "Error en datos del cliente",
    "nombreResponsable": "ROBERTO",
    "tipDocResponsable": "13",
    "numDocResponsable": "026256213",
    "nombreSolicita": "KEVIN",
    "tipDocSolicita": "13",
    "numDocSolicita": "062761947"
  }
}

2. Rescisión de Operación (tipoAnulacion: 2)

Se utiliza cuando la operación comercial se cancela por completo (por ejemplo, devolución total de mercadería o servicio no realizado). En este caso, no se debe incluir el campo codigoGeneracionR.

{
  "codigoGeneracion": "CB33B9B5-7027-4D5F-8C5A-BDFD3416A0F8",
  "motivo": {
    "tipoAnulacion": 2,
    "motivoAnulacion": "Error en datos del cliente",
    "nombreResponsable": "ROBERTO",
    "tipDocResponsable": "13",
    "numDocResponsable": "026256213",
    "nombreSolicita": "KEVIN",
    "tipDocSolicita": "13",
    "numDocSolicita": "062761947"
  }
}

---

Parámetros del Payload

Campo	Tipo	Descripción
codigoGeneracion	string	UUID del documento original que será anulado/invalidado.
codigoGeneracionR	string	Condicional. UUID del nuevo documento que reemplaza al DTE invalidado. Requerido obligatoriamente si tipoAnulacion es 1.
motivo	objeto	Detalle de la invalidación y personas responsables de la misma.

Detalle del Objeto motivo

Campo	Tipo	Descripción
tipoAnulacion	entero	Tipo de invalidación: 1 (Sustitución de DTE), 2 (Rescisión de la operación/invalidation definitiva).
motivoAnulacion	string	Explicación detallada del porqué de la invalidación.
nombreResponsable	string	Nombre del empleado o responsable de la empresa que realiza la invalidación.
tipDocResponsable	string	Tipo de documento del responsable (ej. "13" para DUI sin guión, "36" para NIT).
numDocResponsable	string	Número de documento del responsable (9 dígitos sin guiones para DUI).
nombreSolicita	string	Nombre del cliente que solicita la invalidación.
tipDocSolicita	string	Tipo de documento del cliente solicitante (ej. "13" para DUI sin guión).
numDocSolicita	string	Número de documento del cliente solicitante.

Obligatoriedad de Documento en Invalidaciones

Para realizar cualquier invalidación, el Ministerio de Hacienda exige que los campos de identificación del cliente solicitante (nombreSolicita, tipDocSolicita y numDocSolicita) estén presentes y contengan datos válidos según el esquema.

Si estás invalidando una Factura de Consumidor Final (DTE-01) y la factura original se emitió sin registrar un documento (donde el cliente no proporcionó DUI/NIT):

1. Es obligatorio proveer un documento para poder realizar la anulación.
2. Recomendación: Rellena el campo numDocSolicita con un valor secuencial simulado de prueba (por ejemplo, "123456789") y tipDocSolicita con el tipo correspondiente (ej. "13" u otro válido).

De lo contrario, Hacienda rechazará la petición indicando error de validación.

Plazos de Invalidación

Los documentos tributarios electrónicos (DTE) solo pueden invalidarse dentro de los plazos establecidos por el Ministerio de Hacienda.

Para efectos prácticos de validación en el sistema, se recomienda considerar los siguientes tiempos máximos:

Tipo de Documento	Tiempo aproximado para invalidar
FACTURA_CONSUMIDOR_FINAL (DTE-01)	90 días calendario
ANULACION	Según el documento relacionado
CREDITO_FISCAL (DTE-03)	30 días calendario
SUJETO_EXCLUIDO (DTE-14)	90 días calendario
NOTA_CREDITO (DTE-05)	30 días calendario
NOTA_DEBITO (DTE-06)	30 días calendario
COMPROBANTE_RETENCION (DTE-07)	30 días calendario

Consideraciones

• Los documentos de tipo Factura Electrónica (DTE-01), Factura de Sujeto Excluido (DTE-14) y Factura de Exportación pueden invalidarse hasta tres meses después de la obtención del Sello de Recepción.
• Los documentos de tipo Crédito Fiscal, Nota de Crédito, Nota de Débito y Comprobante de Retención poseen un plazo legal equivalente al décimo día hábil del mes siguiente al período tributario de emisión. Para simplificar la validación del sistema, este plazo puede considerarse como 30 días calendario.
• El plazo definitivo será determinado por las validaciones efectuadas por el Ministerio de Hacienda al momento de procesar la solicitud de invalidación.

Reglas Importantes

• El estado del documento cambiará a CANCELLED (o ANULADO) en el sistema local tras una invalidación exitosa.