Factura afecta (33)

El tipo_dte 33 es la Factura Electrónica afecta a IVA: el caso más común para SpAs, empresas de servicios profesionales y comercio B2B. Esta es la página canónica de campos de la familia de facturas: Factura exenta (34), Nota de Crédito (61) y Nota de Débito (56) documentan solo sus diferencias respecto de esta página.

Campos del request

POST /api/v1/dtes acepta este body para tipo 33:

Los montos son opcionales porque Notta los calcula desde los items. Si los mandas y no cuadran, el endpoint responde 400 con código validation_failed y el detalle campo por campo en issues[].

Request

Puedes emitir por los 2 canales programáticos (API, MCP) + el dashboard:

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": 33,
    "rut_emisor": "76123456-0",
    "receptor": {
      "rut": "11111111-1",
      "razon_social": "Cliente Ejemplo SpA",
      "giro": "Comercio",
      "direccion": "Av Siempre Viva 123",
      "comuna": "Santiago"
    },
    "forma_pago": 2,
    "fecha_emision": "2026-05-13",
    "items": [{
      "nombre": "Consultoría mayo 2026",
      "cantidad": 5,
      "precio_unitario": 50000,
      "exento": false,
      "monto_item": 250000
    }]
  }'

Response

El endpoint responde 202 Accepted: la emisión es asíncrona. El DTE queda queued, y la transición a EPR ocurre tras firma + envío al SII (típicamente 2-15 segundos).

{
  "id": "01957a91-0b50-7000-8000-000000000001",
  "status": "queued",
  "folio": 1234,
  "tipo_dte": 33,
  "rut_emisor": "76123456-0",
  "rut_receptor": "11111111-1",
  "monto_neto": 250000,
  "monto_exento": 0,
  "iva": 47500,
  "monto_total": 297500,
  "sii_env": "cert",
  "sii_status": "queued",
  "fecha_emision": "2026-05-13",
  "links": {
    "self": "/api/v1/dtes/01957a91-0b50-7000-8000-000000000001",
    "pdf": "/api/v1/dtes/01957a91-0b50-7000-8000-000000000001/pdf",
    "xml": "/api/v1/dtes/01957a91-0b50-7000-8000-000000000001/xml",
    "events": "/api/v1/dtes/01957a91-0b50-7000-8000-000000000001/events"
  }
}

Para seguir el estado, lee links.events: GET /api/v1/dtes/{id}/events devuelve la historia completa de transiciones en orden cronológico ascendente ({status, at, source, glosa} por cada una) con scope dte:read. Es el endpoint canónico de seguimiento: trae los estados transitorios que links.self ya no muestra (devuelve solo el último) y la glosa del rechazo en el mismo request. POST /api/v1/dtes/{id}/refresh-status no es el mecanismo de seguimiento: es la escotilla para un poll que se murió, y en bucle solo abre sesiones contra el SII con tu certificado. El detalle de los dos está en Referencia API de DTEs.

Descuentos

Notta soporta los dos descuentos del portal del SII:

• Por línea (items[].descuento_pct): el porcentaje de descuento de esa línea. monto_item debe venir ya descontado: el % es informativo (<DescuentoPct>) y el SII valida monto_item = round(cantidad*precio_unitario) - descuento.
• Global (descuento_global): descuentos o recargos sobre el total del documento (<DscRcgGlobal>). Reducen (descuento) o aumentan (recargo) el neto afecto antes del IVA. Puedes combinar hasta 20 y usar aplica_exento para que el ajuste vaya sobre la base exenta.

Notta recalcula monto_neto, iva y monto_total con los descuentos aplicados: no necesitas mandarlos.

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": 33,
    "receptor": {
      "rut": "11111111-1",
      "razon_social": "Cliente Ejemplo SpA",
      "giro": "Comercio",
      "direccion": "Av Siempre Viva 123",
      "comuna": "Santiago"
    },
    "forma_pago": 2,
    "fecha_emision": "2026-05-13",
    "items": [{
      "nombre": "Conjunto estantería",
      "cantidad": 1,
      "precio_unitario": 250000,
      "exento": false,
      "monto_item": 212500,
      "descuento_pct": 15
    }],
    "descuento_global": [
      { "tipo": "descuento", "es_porcentaje": true, "valor": 10 }
    ]
  }'

En el ejemplo la línea aplica 15% (250000 → 212500) y el descuento global de 10% reduce el neto afecto (212500 → 191250) antes de calcular el IVA.

Estados SII

status y sii_status traen el mismo valor, y junto a ellos viene el bloque estado con ese valor ya clasificado: terminal te dice cuándo dejar de esperar y categoria / accion son enums cerrados para ramificar sin leer la prosa.

La tabla completa vive en Estados del DTE, con lo que significa cada código, cuál es terminal, la cadencia real del seguimiento y el algoritmo de espera recomendado. Es la única lista: duplicarla aquí es cómo un estado que ya nadie escribe sobrevive años en la documentación.

Lo que conviene saber al emitir una 33: espera hasta que estado.terminal sea true (nunca hasta que sii_status valga EPR, porque un rechazo también es final) y no te alarmes si ves -11. Ese código no es un estado del documento, es la consulta de estado fallando mientras el SII todavía no registra el envío recién subido, y es el camino normal de la mayoría de los documentos.

Idempotency

Todo POST exige el header Idempotency-Key (UUIDv7 recomendado); sin él, el endpoint responde 400 con código idempotency_key_missing. Si la misma key llega dos veces, retorna el resultado de la primera operación en lugar de duplicar el DTE.

El MCP genera keys frescas automáticamente.

Próximos pasos

• Nota de Crédito (61): corrige o anula una factura ya aceptada por el SII.
• Referencia API de DTEs: todos los endpoints de /dtes (list, detail, PDF, XML y refresh-status).
• Errores: el shape uniforme de error (code, hint, next_action) y cómo manejarlo.