Emisión de DTE
Aprende desde cero a emitir facturas, boletas, notas de crédito, guías de despacho y otros documentos tributarios electrónicos desde tu software con API Gateway V2.
Errores frecuentes
Esta es una guía de diagnóstico. Busca el síntoma que ves y la etapa en que ocurre.
Errores de la API (antes de llegar al SII)
| Síntoma | Causa | Solución |
|---|---|---|
401 |
Token ausente o mal escrito. | Usa la cabecera Authorization: Token <token>, con la palabra Token y un espacio. |
402 |
La conexión no tiene créditos o tiene un problema de pago. | Revisa tu conexión en app.apigateway.cl. |
404 |
La URL de la operación no existe. | Revisa las cuatro partes de la URL y que el método sea POST. |
400 |
Falta un parámetro o tiene otro nombre. | Todos los parámetros van dentro de parameters, con el nombre exacto de la documentación (bag, source, request, doc, company, trackId). |
422 con No se encontró un deserializador capaz de construir una instancia de ... requiere datos codificados en base64 válido. |
Un XML (del DTE, del sobre o del CAF) o un .p12 no viene en base64. |
Codifica en base64, en una sola línea, sin saltos. |
422 con Se requieren los datos del certificado ... |
Certificado incompleto. | Envía certificate + privateKey (PEM), o data + password (.p12). |
503 |
El servicio de LibreDTE no está disponible en ese momento. | Reintenta en unos minutos. |
Errores al construir el documento o el sobre
Mensaje (detail) |
Causa | Solución |
|---|---|---|
El XPath "//Encabezado/IdDoc/Folio" ... es obligatorio: no coincidió con ningún nodo. |
Falta IdDoc.Folio. |
Asigna el folio desde tu control de folios. |
El folio N ... no está disponible en el rango del CAF ... |
El folio no está en el CAF enviado. | Revisa el rango del CAF y que sea el CAF del tipo de documento correcto. |
El CAF ... fue autorizado al emisor ..., pero el documento ... es del emisor ... |
El CAF es de otra empresa: su RUT no coincide con RUTEmisor. |
Usa un CAF solicitado por la misma empresa que emite el documento. |
El CAF ... es del tipo de documento ..., pero el documento ... es del tipo ... |
El CAF es de otro tipo de documento. | Usa el CAF del mismo tipo que el documento: de facturas para una factura, de boletas para una boleta. |
The verification digit of the RUT ... is incorrect. |
RUT con dígito verificador incorrecto. | Valida los RUT al registrarlos en tu sistema. |
Falta incluir documento de referencia. |
Nota de crédito o débito sin Referencia. |
Agrega la referencia al documento que corrige. |
La carátula del sobre no está definida. |
Al armar el sobre falta emisor.autorizacion_dte (la resolución) o el certificado. |
Envía la resolución del emisor y el certificado en dispatcher/create. |
| Totales distintos a los esperados | En una factura enviaste precios con IVA, o en una boleta precios sin IVA. | Factura: PrcItem neto. Boleta: PrcItem con IVA. |
Rechazos del SII
| Estado | Causa común | Solución |
|---|---|---|
RSC Rechazado por error en el esquema |
Un campo supera su largo máximo, tiene un formato inválido o falta. | Valida con validator/validateSchema antes de enviar. Revisa los largos máximos (por ejemplo, GiroRecep 40 caracteres). |
RFR Rechazado por error en la firma |
El XML se modificó después de firmarlo (por ejemplo, al cambiar su codificación). | Guarda y envía el base64 tal como lo entregó la API. No conviertas el XML a UTF-8. |
RCT Rechazado por error en la carátula |
La resolución (número o fecha) no corresponde, o no corresponde al ambiente. | En certificación usa número 0 y la fecha de certificación; en producción, la resolución real. |
EPR con facturas, notas o guías rechazadas |
Un dato del documento no es válido para el SII: folio no autorizado, CAF de otro ambiente, receptor inexistente, referencia a un documento que no existe. | Pide el detalle con requestXmlDocumentSentStatusByEmail (ver Consultar el estado). |
EPR con reparos |
El documento es válido, pero tiene observaciones menores. | Revisa las observaciones para corregir los documentos siguientes. |
Errores con boletas
| Síntoma | Causa | Solución |
|---|---|---|
El tipo de documento Factura electrónica no se puede agregar a un sobre de tipo ENVIO_BOLETA. |
Juntaste una boleta y otro DTE en el mismo sobre. | Arma un sobre para las boletas y otro para los demás documentos. |
El XML es un EnvioBOLETA y no se puede enviar con el worker de DTE, las boletas se envían con el worker de boletas. |
Enviaste un sobre de boletas con sii_dte: el SII recibe las boletas por otro servicio. |
Las boletas se envían con sii_boleta/sendXmlDocument y su estado se consulta con sii_boleta/checkXmlDocumentSentStatus. |
rate_limit.remaining en 0 |
Usaste todas las solicitudes que permite el servicio de boletas del SII. | Espera los segundos de rate_limit.reset antes de la siguiente llamada. |
| Totales distintos a los esperados | Enviaste precios sin IVA. | En una boleta, PrcItem va con IVA incluido. |
Boleta exenta con MntExe en 0 |
Los ítems de la boleta 41 no tienen IndExe. |
Marca cada ítem con IndExe: 1. |
RPT Envío repetido rechazado |
Enviaste de nuevo un sobre que el SII ya había recibido. | Consulta el estado con el Track ID del primer envío. |
details con boletas rechazadas |
Un dato de esas boletas no es válido para el SII. | Revisa section, description y detail de cada error (ver Consultar el estado de boletas). |
Errores de autenticación en el SII
| Síntoma | Causa | Solución |
|---|---|---|
| Falla la autenticación al enviar o consultar | Certificado vencido, revocado o autofirmado. | Usa un certificado vigente, emitido por una entidad autorizada. |
| Falla la autenticación con un certificado válido | La persona del certificado no está autorizada en el SII para la empresa. | En el SII, la empresa debe registrar a esa persona como usuario autorizado para DTE. |
| El documento se envió a producción por error | No se indicó options.environment. |
Indica siempre el ambiente. El valor por defecto es producción. |
Errores de diseño que aparecen más tarde
Estos errores no dan un mensaje inmediato, pero causan problemas en producción:
| Problema | Consecuencia | Prevención |
|---|---|---|
| Dos emisiones usan el mismo folio | El SII rechaza la segunda, o hay dos documentos distintos con el mismo número. | Reserva el folio con una transacción en tu base de datos. |
| No se guardó el Track ID | No puedes saber si el documento fue aceptado. | Guárdalo apenas lo recibes. |
| Se construyó de nuevo un documento ya enviado | Hay dos XML distintos para el mismo folio. | Si falla el envío, reintenta el mismo sobre. Solo se construye de nuevo cuando el SII lo rechazó. |
| Se volvió a emitir un documento rechazado con otro folio | El folio del documento rechazado queda sin usar en el CAF. | Emite el documento corregido con el mismo folio. |
| No se guardó el XML | Pierdes el respaldo legal del documento. | Guarda cada XML emitido por al menos 6 años. |
| Se agotaron los folios | No se puede emitir. | Solicita un nuevo CAF antes de que se agote el actual. |
¿No encuentras tu error?
Revisa la solución de problemas de la documentación. Si el problema sigue, abre un ticket indicando la operación, la hora de la llamada y el mensaje de detail (sin enviar tu certificado ni tu token).
En esta página
Última actualización el 05/11/2026
por Anonymous