Emitir DTE

Emitir un DTE

El proceso tiene dos pasos: emitir (genera el XML firmado) y enviar (lo manda al SII).

El servidor calcula los montos. montoTotal y montoItem son opcionales: si los mandás, se usan como confirmación y la API devuelve 400 si no coinciden con lo calculado — sin consumir folio. Un folio gastado no se recupera, y reenviar con el mismo folio es rechazo por folio duplicado.

Paso 1: Emitir

curl -X POST https://api.example.com/api/v1/tenants/{tenantId}/dte \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "tipoDte": 33,
    "receptor": {
      "rut": "77.777.777-7",
      "razonSocial": "Cliente SpA",
      "giro": "Comercio",
      "direccion": "Calle 1",
      "comuna": "Santiago",
      "ciudad": "Santiago"
    },
    "detalle": [
      {
        "nombre": "Servicio de desarrollo web",
        "cantidad": 1,
        "precioUnitario": 100000,
        "montoItem": 100000
      },
      {
        "nombre": "Hosting anual",
        "cantidad": 12,
        "precioUnitario": 5000,
        "montoItem": 60000
      }
    ],
    "montoTotal": 190400
  }'

const dte = await fetch(
  `https://api.example.com/api/v1/tenants/${tenantId}/dte`,
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer sk_live_...',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      tipoDte: 33,
      receptor: {
        rut: '77.777.777-7',
        razonSocial: 'Cliente SpA',
        giro: 'Comercio',
        direccion: 'Calle 1',
        comuna: 'Santiago',
        ciudad: 'Santiago',
      },
      detalle: [
        { nombre: 'Servicio de desarrollo web', cantidad: 1, precioUnitario: 100000, montoItem: 100000 },
        { nombre: 'Hosting anual', cantidad: 12, precioUnitario: 5000, montoItem: 60000 },
      ],
      montoTotal: 190400,
    }),
  }
).then(r => r.json())

Respuesta:

{
  "id": "uuid",
  "tipoDte": 33,
  "folio": 145,
  "rutReceptor": "77.777.777-7",
  "razonSocialReceptor": "Cliente SpA",
  "montoTotal": "190400.00",
  "estado": "generado",
  "createdAt": "2024-03-15T10:30:00Z"
}

Paso 2: Enviar al SII

Puedes enviar uno o varios DTEs en un mismo sobre:

curl -X POST https://api.example.com/api/v1/tenants/{tenantId}/dte/send \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"dteIds": ["uuid-dte-1", "uuid-dte-2"]}'

await fetch(
  `https://api.example.com/api/v1/tenants/${tenantId}/dte/send`,
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer sk_live_...',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ dteIds: [dte.id] }),
  }
)

Receptor

Campo	Requerido	Descripción
`rut`	Sí	RUT del receptor
`razonSocial`	Sí	Nombre legal
`giro`	No	Actividad económica
`direccion`	No	Dirección
`comuna`	No	Comuna
`ciudad`	No	Ciudad

Detalle

Cada ítem del detalle:

Campo	Requerido	Descripción
`nombre`	Sí	Descripción del producto/servicio
`cantidad`	Sí	Cantidad (positivo)
`precioUnitario`	Sí	Precio unitario
`montoItem`	Sí	Monto total del ítem
`exento`	No	`true` si el ítem es exento de IVA

Referencias (notas de crédito/débito)

Para notas de crédito o débito, incluye el campo referencias:

{
  "tipoDte": 61,
  "referencias": [
    {
      "tipoDocRef": 33,
      "folioRef": 145,
      "fechaRef": "2024-03-15",
      "razonRef": "Anulación de factura",
      "codigoRef": 1
    }
  ]
}

Estados del DTE

Estado	Descripción
`generado`	XML firmado, no enviado al SII
`enviado`	Enviado al SII, esperando respuesta
`aceptado`	Aceptado por el SII
`rechazado`	Rechazado por el SII

Descargar XML

curl https://api.example.com/api/v1/tenants/{tenantId}/dte/{dteId}/xml \
  -H "Authorization: Bearer sk_live_..." \
  -o factura.xml

Boletas: los precios incluyen IVA

En una boleta el precio que ve el cliente ya trae el IVA adentro. Para eso está preciosConIva:

{
  "tipoDte": 39,
  "preciosConIva": true,
  "detalle": [
    { "nombre": "Cambio de aceite", "cantidad": 1, "precioUnitario": 19900 },
    { "nombre": "Alineacion y balanceo", "cantidad": 1, "precioUnitario": 9900 }
  ]
}

El total del documento es exactamente 29.800, lo que el cliente pagó, y el servidor desagrega MontoNeto: 25042 e IVA: 4758.

preciosConIva no se infiere del tipo de documento. Una factura a un consumidor con precio de vitrina también trae precios brutos, y adivinar por tipo declararía IVA sobre el IVA en silencio. El default es false: el comportamiento de siempre.

Una boleta puede no tener receptor

Las boletas (39, 41) van a consumidor final, que no se identifica: receptor es opcional para ellas. Para cualquier otro tipo es obligatorio, y la base lo garantiza con un CHECK.

Descuentos

Por línea y globales, en pesos o en porcentaje. Los dos niveles existen por separado en el XML porque el SII exige que aparezcan en la representación impresa.

{
  "tipoDte": 33,
  "receptor": { "rut": "77.777.777-7", "razonSocial": "Cliente SpA" },
  "detalle": [
    { "nombre": "Pañuelo AFECTO", "cantidad": 746, "precioUnitario": 5777, "descuentoPct": 10 },
    { "nombre": "ITEM 2 AFECTO",  "cantidad": 690, "precioUnitario": 4829, "descuentoPct": 22 }
  ],
  "descuentoGlobalPct": 5
}

Regla	Comportamiento
`descuentoPct` + `descuentoMonto` en la misma línea	`400 DTE_DESCUENTO_AMBIGUO`
`descuentoGlobal` + `descuentoGlobalPct`	`400 DTE_DESCUENTO_AMBIGUO`
Descuento mayor al monto de la línea	`400 DTE_DESCUENTO_EXCEDE_MONTO`
Descuento global	Solo sobre el subtotal afecto, nunca sobre el exento
Orden	Primero el de línea, después el global sobre el subtotal ya descontado

Notas de crédito y débito

Se emiten con su propio endpoint, que deriva los datos del documento original:

curl -X POST https://api.example.com/api/v1/tenants/{tenantId}/dte/{dteId}/nota \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "tipoDte": 61,
    "codigoRef": 3,
    "razonRef": "DEVOLUCION DE MERCADERIAS",
    "lineas": [ { "numeroLinea": 1, "cantidad": 274 } ]
  }'

Se manda solo la cantidad. El precio unitario y el descuento salen de la línea original, porque el SII cruza la nota contra el documento referenciado.

`codigoRef`	Significado	¿Lleva `lineas`?
1	Anula el documento	No: anular es total por definición
2	Corrige el texto (giro, dirección)	No: no mueve montos
3	Corrige montos / devolución parcial	Sí, obligatorio

Para corregir el receptor sin tocar montos, se manda receptor con solo los campos a cambiar: el resto se copia del original.

Fechas

fechaEmision es opcional y por default es hoy en hora de Chile (America/Santiago), no UTC. Entre las 21:00 y la medianoche locales las dos fechas difieren, y un DTE con fecha futura es un reparo del SII.

Un error de montos no se rechaza: se acepta con reparos

Esto es lo más importante de esta guía. El SII no rechaza un documento cuyos montos están mal calculados: lo acepta con reparos, y el documento queda con validez legal y tributaria completa. Corregirlo después exige emitir una nota de crédito o débito con codigoRef: 3, y reenviar el documento corregido consume un folio nuevo (el mismo folio es rechazo por duplicado). Por eso esta API valida los montos antes de consumir el folio y devuelve 400 en vez de corregir en silencio: es la única forma de que el error salga barato.

Empezar

Flujos principales

Referencia

Emitir un DTE

Paso 1: Emitir

Paso 2: Enviar al SII

Receptor

Detalle

Referencias (notas de crédito/débito)

Estados del DTE

Descargar XML

Boletas: los precios incluyen IVA

Una boleta puede no tener receptor

Descuentos

Notas de crédito y débito

Fechas

Un error de montos no se rechaza: se acepta con reparos

​Emitir un DTE

​Paso 1: Emitir

​Paso 2: Enviar al SII

​Receptor

​Detalle

​Referencias (notas de crédito/débito)

​Estados del DTE

​Descargar XML

​Boletas: los precios incluyen IVA

​Una boleta puede no tener receptor

​Descuentos

​Notas de crédito y débito

​Fechas

​Un error de montos no se rechaza: se acepta con reparos

Emitir un DTE

Paso 1: Emitir

Paso 2: Enviar al SII

Receptor

Detalle

Referencias (notas de crédito/débito)

Estados del DTE

Descargar XML

Boletas: los precios incluyen IVA

Una boleta puede no tener receptor

Descuentos

Notas de crédito y débito

Fechas

Un error de montos no se rechaza: se acepta con reparos