Nota de débito (56)

Aumenta el monto de un documento emitido declarando la causal correcta — las 3 razones válidas, sus combos de cod_ref y el bloqueo del Oficio SII 2011/2020.

El tipo_dte 56 es la Nota de Débito: aumenta el monto de un DTE previo (cargo omitido, intereses pactados) o anula una Nota de Crédito. Requiere references al documento original y un campo nd_reason que declara la causal.

Los campos base del request (receptor, items, montos) están en /docs/emit-factura-33; aquí solo los propios de la ND. Puedes emitirla por los 3 canales programáticos (API, CLI, MCP) + el dashboard; los ejemplos de esta guía usan curl.

Causales válidas

nd_reason es obligatorio y solo acepta 3 valores. Cada causal habilita combinaciones específicas de cod_ref — si el combo no calza, la API rechaza con validation_failed:

`nd_reason`	`cod_ref` permitido	Cuándo usarlo
`correccion_monto`	`3`	Facturaste de menos y necesitas subir el neto + IVA del documento original.
`reposicion_nc_anulada`	`2` o `1` (la referencia apunta a la NC, tipo 61)	Con `2` repones una factura cuya NC fue anulada; con `1` anulas la NC referenciada.
`interese_moratorio_contractual`	`3`	Cobrás intereses por mora pactados por contrato sobre una factura impaga.

Intereses moratorios legales — Oficio SII 2011/2020

Los intereses moratorios legales (los que fija la ley sin pacto entre las partes) no se documentan con DTE. Por eso interese_moratorio_legal está fuera del enum a propósito: la API lo rechaza siempre, sin override. Solo los intereses contractuales van como ND.

Referencias

Cada entrada de references lleva los 6 campos, todos obligatorios:

Campo	Tipo	Descripción
`line_num`	entero 1-40	Número de línea de la referencia
`tipo_doc_ref`	entero	Tipo del documento referenciado (33/34, o 61 para `reposicion_nc_anulada`)
`folio_ref`	entero positivo	Folio del documento original
`fecha_ref`	`YYYY-MM-DD`	Fecha de emisión del documento original
`cod_ref`	`1` \| `2` \| `3`	Tiene que calzar con la causal según la tabla anterior
`razon_ref`	string (mín. 1)	Motivo del cargo o de la anulación

Request

Intereses por mora pactados en contrato sobre la factura 33 folio 1234:

curl -X POST https://app.notta.cl/api/v1/dtes \
  -H "Authorization: Bearer ntt_cert_..." \
  -H "X-Cert-Id: 01957a91-0b50-7000-8000-cccc00000001" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "tipo_dte": 56,
    "rut_emisor": "76123456-0",
    "receptor": { "rut": "11111111-1", "razon_social": "Cliente Ejemplo SpA" },
    "fecha_emision": "2026-05-13",
    "nd_reason": "interese_moratorio_contractual",
    "references": [{
      "line_num": 1,
      "tipo_doc_ref": 33,
      "folio_ref": 1234,
      "fecha_ref": "2026-04-02",
      "cod_ref": 3,
      "razon_ref": "Interés moratorio pactado en contrato"
    }],
    "items": [{
      "nombre": "Interés pactado por pago diferido",
      "cantidad": 1,
      "precio_unitario": 15000,
      "exento": false,
      "monto_item": 15000
    }]
  }'

El X-Cert-Id es el id de tu certificado (paso 1 del quickstart o dashboard).

Response

La emisión es asíncrona: el endpoint responde 202 con status: "queued" y el envío al SII corre detrás.

{
  "id": "01957a91-0b50-7000-8000-000000000056",
  "status": "queued",
  "folio": 320,
  "tipo_dte": 56,
  "rut_emisor": "76123456-0",
  "rut_receptor": "11111111-1",
  "monto_neto": 15000,
  "monto_exento": 0,
  "iva": 2850,
  "monto_total": 17850,
  "sii_env": "cert",
  "sii_status": "queued",
  "fecha_emision": "2026-05-13",
  "links": {
    "self": "/api/v1/dtes/01957a91-0b50-7000-8000-000000000056",
    "pdf": "/api/v1/dtes/01957a91-0b50-7000-8000-000000000056/pdf",
    "xml": "/api/v1/dtes/01957a91-0b50-7000-8000-000000000056/xml",
    "events": "/api/v1/dtes/01957a91-0b50-7000-8000-000000000056/events"
  }
}

Próximos pasos

Nota de crédito (61) — la operación inversa: anula o rebaja un documento emitido.
Referencia API de DTEs — todos los endpoints de consulta, PDF y XML.
Errores — qué devuelve la API cuando la causal o el combo de cod_ref no validan.
Webhooks — recibe la transición a EPR o rechazo sin polling.