API Facturación

Invalidación de Documentos

Esta sección describe cómo invalidar documentos tributarios electrónicos previamente emitidos.

Importante

Los documentos solo pueden invalidarse dentro de plazos específicos: facturas hasta 3 meses después, otros documentos solo en las primeras 24 horas.

Catálogos de referencia

Para conocer los códigos de tipo de invalidación (CAT-024) y otros valores requeridos, consulta la sección de Catálogos.

Invalidar Documento

POST /api/v1/invalidation

Invalida un documento tributario electrónico previamente emitido

Este endpoint permite invalidar un documento tributario electrónico previamente emitido.

Ejemplo de Solicitud

Request 

{
  "generation_code": "UUID-del-documento-original",
  "replacement_generation_code": "UUID-del-documento-nuevo",
  "reason": {
    "type": 1,
    "responsible_name": "Juan Pérez",
    "responsible_doc_type": "36",
    "responsible_num_doc": "04141201721034",
    "requestor_name": "María López",
    "requestor_doc_type": "36",
    "requestor_num_doc": "06142301891012"
  }
}

Ejemplo de Respuesta

Response 

{
  "success": true,
  "data": "DTE invalidated successfully"
}

Campos de invalidación

Campos necesarios para invalidar un documento

generation_code

Requerido
string
UUID del documento a invalidar

replacement_generation_code

Opcional
string
UUID del documento de reemplazo (requerido para tipos 1 y 3)

reason.type

Requerido
integer
Tipo de invalidación (1, 2 o 3)

reason.responsible_name

Requerido
string
Nombre del responsable

reason.responsible_doc_type

Requerido
string
Tipo de documento del responsable

reason.responsible_num_doc

Requerido
string
Número de documento del responsable

reason.requestor_name

Requerido
string
Nombre del solicitante

reason.requestor_doc_type

Requerido
string
Tipo de documento del solicitante

reason.requestor_num_doc

Requerido
string
Número de documento del solicitante

reason.reason_field

Opcional
string
Motivo (obligatorio para tipo 3)
Sí Indica campo obligatorio

Tipos de Invalidación

Tipo 1 - Sustitución por Error

Este tipo se utiliza cuando hay errores en la información del documento y se ha emitido uno nuevo para sustituirlo.

Ejemplo de invalidación Tipo 1 

{
  "generation_code": "UUID-del-documento-original",
  "replacement_generation_code": "UUID-del-documento-nuevo",
  "reason": {
    "type": 1,
    "responsible_name": "Juan Pérez",
    "responsible_doc_type": "36",
    "responsible_num_doc": "04141201721034",
    "requestor_name": "María López",
    "requestor_doc_type": "36",
    "requestor_num_doc": "06142301891012"
  }
}

Tipo 2 - Anulación Simple

Este tipo se utiliza cuando se desea anular el documento sin emitir uno nuevo.

Ejemplo de invalidación Tipo 2 

{
  "generation_code": "UUID-del-documento-original",
  "reason": {
    "type": 2,
    "responsible_name": "Juan Pérez",
    "responsible_doc_type": "36",
    "responsible_num_doc": "04141201721034",
    "requestor_name": "María López",
    "requestor_doc_type": "36",
    "requestor_num_doc": "06142301891012"
  }
}

Tipo 3 - Anulación por Motivo Específico

Este tipo se utiliza cuando hay un motivo específico para la invalidación que debe documentarse.

Ejemplo de invalidación Tipo 3 

{
  "generation_code": "UUID-del-documento-original",
  "replacement_generation_code": "UUID-del-documento-nuevo",
  "reason": {
    "type": 3,
    "responsible_name": "Juan Pérez",
    "responsible_doc_type": "36",
    "responsible_num_doc": "04141201721034",
    "requestor_name": "María López",
    "requestor_doc_type": "36",
    "requestor_num_doc": "06142301891012",
    "reason_field": "Descripción detallada del motivo de invalidación"
  }
}

Validaciones Específicas

  • El documento a invalidar debe existir y estar en estado "RECEIVED" (no puede estar invalidado, rechazado o pendiente)
  • Para tipo 1 (sustitución por error) y tipo 3 (motivo específico), el documento de reemplazo debe existir y estar en estado "RECEIVED"
  • Para tipo 2 (anulación simple), no debe proporcionarse documento de reemplazo
  • Para tipo 3, el campo reason_field es obligatorio
  • Restricciones temporales:
    • Facturas (01): Se pueden invalidar hasta 3 meses después de emitidas
    • Otros documentos: Solo dentro de las 24 horas posteriores a la emisión

Recomendación

Asegúrate de tener un documento de reemplazo válido antes de intentar una invalidación de tipo 1 o 3.