Notas de Crédito (05) y Débito (06)

Las Notas de Crédito Electrónicas (DTE-05) y las Notas de Débito Electrónicas (DTE-06) son documentos utilizados para modificar información de un documento tributario electrónico emitido previamente, como una Factura Electrónica (DTE-01) o un Comprobante de Crédito Fiscal Electrónico (DTE-03).

Nota de Crédito (DTE-05)

La Nota de Crédito se utiliza para disminuir total o parcialmente el valor de una operación previamente facturada.

Casos de uso comunes

Devolución de productos.
Descuentos otorgados después de emitir la factura.
Corrección de cantidades facturadas en exceso.
Corrección de precios cobrados incorrectamente.
Anulación parcial de una operación.

Ejemplo

Factura original:

{
  "descripcion": "Pasta de ajo",
  "cantidad": 1,
  "precioUnitario": 20.0
}

Posteriormente se concede un descuento de $5.00 al cliente.

Resultado del ajuste:

{
  "tipoDte": "05",
  "motivo": "Descuento posterior a la venta",
  "montoAjuste": 5.0
}

La Nota de Crédito reducirá el monto total de la operación en $5.00.

Nota de Débito (DTE-06)

La Nota de Débito se utiliza para incrementar total o parcialmente el valor de una operación previamente facturada.

Casos de uso comunes

Cobros omitidos en la factura original.
Ajustes de precio posteriores a la emisión.
Recargos autorizados contractualmente.
Corrección de montos facturados por debajo del valor real.

Ejemplo

Factura original:

{
  "descripcion": "Pasta de ajo",
  "cantidad": 1,
  "precioUnitario": 20.0
}

Posteriormente se determina un cargo adicional de $3.00.

Resultado del ajuste:

{
  "tipoDte": "06",
  "motivo": "Cargo adicional por ajuste de precio",
  "montoAjuste": 3.0
}

La Nota de Débito incrementará el monto total de la operación en $3.00.

Diferencias entre ambos documentos

Documento	Efecto
Nota de Crédito (DTE-05)	Disminuye el valor de una operación previamente facturada.
Nota de Débito (DTE-06)	Incrementa el valor de una operación previamente facturada.

Relación con el documento original

Toda Nota de Crédito o Nota de Débito debe hacer referencia al documento que se desea modificar mediante su Código de Generación y demás datos de identificación requeridos por el Ministerio de Hacienda.

Estos documentos no sustituyen la factura original; únicamente registran el ajuste correspondiente sobre la operación previamente emitida.

Endpoints

Nota de Crédito (05): POST /dte/dte05
Nota de Débito (06): POST /dte/dte06

(Consulta la guía de Endpoints y Entornos para obtener la URL base según el ambiente).

Estructura del Payload (JSON)

{
  "receptor": {
    "tipoDocumento": "36",
    "numDocumento": "06141112221015",
    "nrc": "1503456",
    "nombre": "DISTRIBUIDORA DE ALIMENTOS S.A. DE C.V.",
    "codActividad": "47219",
    "descActividad": "Venta al por menor de productos alimenticios",
    "nombreComercial": null,
    "direccion": {
      "departamento": "02",
      "municipio": "14",
      "distrito": "07",
      "complemento": "Calle Principal #10, Santa Ana"
    },
    "telefono": null,
    "correo": null
  },
  "items": [
    {
      "descripcion": "Pasta de ajo premium",
      "cantidad": 1,
      "codigo": "AJ001",
      "precioUnitario": 20.0,
      "montoDescu": 0,
      "tipoImpuesto": "GRAVADO",
      "uniMedida": 99,
      "tipoItem": 1
    }
  ],
  "condicionOperacion": 1,
  "codigoGeneracion": "F3A2B5E6-7788-4F29-9A12-DDF4280E1F03"
}

Campos Clave de Ajuste

Campo	Tipo	Requerido	Descripción
`codigoGeneracion`	string	Sí	UUID (`codigoGeneracion`) del documento original (Factura o Crédito Fiscal) que se desea afectar.
`isRetenIva`	boolean	No	Indica si al Comprobante se le aplica la retención del 1% de IVA (debe corresponder con el original).
`condicionOperacion`	number	Sí	Condición de la operación. Normalmente `1` (Contado).

Respuestas de la API

El endpoint retorna el detalle completo del documento creado en base de datos junto con la respuesta de firma y el resultado directo del Ministerio de Hacienda. El formato de respuesta es idéntico para ambos documentos (DTE-05 y DTE-06), variando únicamente el valor del campo tipo y numeroControl.

Respuesta Exitosa (201 Created)

Se retorna cuando el documento de ajuste es firmado correctamente y aceptado por el Ministerio de Hacienda (estado: "PROCESSED").

{
  "status": "success",
  "data": {
    "id": 1005,
    "tipo": "NOTA_DEBITO",
    "codigoGeneracion": "A1B2C3D4-E5F6-7A8B-9C0D-1E2F3A4B5C6D",
    "numeroControl": "DTE-06-S001P003-000000000000010",
    "estado": "PROCESSED",
    "ambiente": "TEST",
    "total": "20",
    "dteJson": {
      // ... (Estructura interna del DTE firmado enviado a Hacienda)
    },
    "dteFirmado": "eyJhbGciOiJSUzUxMiJ9.eyJpZGVudGlmaWNhY2lvbiI6ZX...",
    "selloRecibido": "20261A2B3C4D5E6F7G8H9I0J1K2L3M4N5O6P",
    "respuestaMh": {
      "estado": "PROCESADO",
      "version": 2,
      "ambiente": "00",
      "codigoMsg": "001",
      "versionApp": 2,
      "clasificaMsg": "10",
      "observaciones": [],
      "selloRecibido": "20261A2B3C4D5E6F7G8H9I0J1K2L3M4N5O6P",
      "descripcionMsg": "RECIBIDO",
      "fhProcesamiento": "07/06/2026 23:11:27",
      "codigoGeneracion": "A1B2C3D4-E5F6-7A8B-9C0D-1E2F3A4B5C6D"
    },
    "dteJsonUrl": "emisores/empresa-pruebas/DTES/TEST/2026/06/07/DTE06/json/A1B2C3D4-E5F6-7A8B-9C0D-1E2F3A4B5C6D.json",
    "dtePdfUrl": "emisores/empresa-pruebas/DTES/TEST/2026/06/07/DTE06/pdf/A1B2C3D4-E5F6-7A8B-9C0D-1E2F3A4B5C6D.pdf",
    "sequenceNumber": "10",
    "sequenceId": 50,
    "serie": "P003",
    "emisorId": 1,
    "branchId": 1,
    "pointOfSaleId": 8,
    "tokenId": 21,
    "errorTecnico": null,
    "createdAt": "2026-06-07T23:11:27.449Z",
    "analisisHacienda": {
      "estadoDocumento": "PROCESSED",
      "aceptadoPorMH": true,
      "tieneObservaciones": false,
      "observaciones": [],
      "erroresValidacion": [],
      "mensaje": "Documento procesado exitosamente"
    }
  }
}

Errores Comunes

Error	Causa
`DOCUMENT_NOT_FOUND`	El código de generación original no existe en la base de datos.
`DOCUMENT_NOT_PROCESSED`	El documento original no ha sido aceptado por Hacienda aún (puede estar rechazado o en contingencia).