--- title: "Portal eBoleta" description: "Portal eBoleta" type: "faq" category: "question" tags: [] authors: [Anonymous] date: "2026-09-11" last_update: "2026-09-11" time_minutes: 1 draft: false unlisted: false url: "https://www.apigateway.cl/faq/eboleta" --- # Portal eBoleta --- ## Portal eBoleta: ¿qué puedo emitir y qué necesito? Permite emitir boletas electrónicas tipo 39 y 41, con el contribuyente inscrito en el sistema gratuito del SII. # Portal eBoleta: ¿qué puedo emitir y qué necesito? El producto **Portal eBoleta** es una pasarela al sistema de boleta electrónica del SII y permite emitir **boletas tipo 39 (afecta) y tipo 41 (exenta o no afecta)**. ## Requisitos del lado del SII 1. **La empresa debe estar inscrita** en el sistema de boleta electrónica del SII, y no operando con un software de mercado. 2. La **Declaración de Modelo de Emisión** debe estar completada. 3. La **Casa Matriz** debe estar registrada como domicilio. 4. **El usuario que autentica debe estar autorizado para emitir boletas.** Se autoriza en el SII, en *Servicios Online → Boleta de venta y servicios electrónica → Sistema de emisión de boletas electrónicas SII → Modificar usuarios autorizados*. ## Los campos donde se producen casi todos los errores | Campo | Qué debe contener | |---|---| | `auth.pass.rut` | El RUT del **usuario autorizado** que inicia sesión | | `dte.vendedor` | El RUT del **mismo usuario** que autentica | | `dte.Encabezado.Emisor.RUTEmisor` | El RUT de la **empresa emisora** | | `dte.Encabezado.Emisor.CdgSIISucur` | El **código de sucursal real**, obtenido del recurso de consulta de emisor | Los folios los administra el propio SII: **no se cargan archivos CAF** en eBoleta. La estructura completa del request está en la [documentación de la API](https://www.apigateway.cl/docs/api). --- ## Portal eBoleta: ¿por qué me dice "No tiene folios asignados"? Casi siempre porque el RUTEmisor enviado no es el de la empresa emisora, o por un código de sucursal inválido. # Portal eBoleta: ¿por qué me dice "No tiene folios asignados"? ```json { "code": 400, "detail": "Error en generar DTE: \"No tiene folios asignados (no rows)\"." } ``` El mensaje viene del SII al emitir con el recurso de eBoleta, y suena a un problema tributario, pero en la práctica casi nunca lo es. **Causa 1: el `RUTEmisor` no es el de la empresa.** Los folios pertenecen a la **empresa emisora**. Si en `Encabezado.Emisor.RUTEmisor` envías el RUT de la **persona que autentica**, el mensaje es literalmente correcto: ese RUT no tiene folios ni podría tenerlos. Recuerda la distribución: `auth.pass.rut` y `dte.vendedor` llevan el usuario que autentica; `RUTEmisor` lleva la empresa. **Causa 2: el código de sucursal no existe.** Enviar `"CdgSIISucur": 0` no funciona. Obtén el código real con el recurso de **consulta de emisor** de eBoleta y toma el `codigo` de la sucursal que corresponda, habitualmente la Casa Matriz. Esto explica también por qué la emisión manual en el portal del SII sí funciona: el portal selecciona la sucursal internamente. **Causa 3:** si ninguna de las anteriores aplica, verifica que la empresa esté autorizada para emitir boleta electrónica en el SII y que su autorización no haya sido revocada. --- ## Portal eBoleta: ¿por qué me dice "Contribuyente no se encuentra autorizado"? El SII rechaza la emisión cuando el usuario no tiene permiso para emitir boletas o la empresa no está en el sistema gratuito. # Portal eBoleta: ¿por qué me dice "Contribuyente no se encuentra autorizado"? Este mensaje aparece al emitir con el recurso de eBoleta y viene del SII: significa que, desde su punto de vista, la operación no está permitida. Revisa tres puntos: **1. El usuario que autentica no tiene permiso para emitir.** Estar registrado como **representante legal** no es lo mismo que estar **autorizado para emitir boletas**: son permisos distintos en el SII. Se autoriza en *Servicios Online → Boleta de venta y servicios electrónica → Sistema de emisión de boletas electrónicas SII → Modificar usuarios autorizados*, ingresando el RUT de la persona. Puedes verificarlo con el recurso de **consulta de emisor** de eBoleta: en la respuesta aparece el arreglo `usuarios` con sus permisos. **2. El RUT en `vendedor` debe ser el del usuario que autentica**, no el de la empresa. **3. La empresa debe estar en el sistema gratuito del SII.** Si está inscrita con un **software de mercado**, no figura como emisor en el portal eBoleta y no podrás emitir por esa vía. > [!TIP] Verifícalo primero en el portal del SII > > Si el usuario puede emitir manualmente en [eboleta.sii.cl](https://eboleta.sii.cl) con las mismas credenciales, los permisos están bien y el problema está en los campos del request. Si tampoco puede emitir ahí, hay que resolverlo primero ante el SII. --- ## Portal eBoleta: ¿por qué me dice "Falta configurar algunos datos de la empresa"? Se produce por un código de sucursal inválido o por un usuario sin permisos de emisión. # Portal eBoleta: ¿por qué me dice "Falta configurar algunos datos de la empresa"? El mensaje completo del SII menciona folios o sucursales, y sugiere que falta configurar algo ante el SII. En los casos revisados la causa estuvo en el **request** del recurso de emisión de eBoleta. Dos puntos, en orden: **1. El código de sucursal.** Enviar `"CdgSIISucur": 0` no funciona: `0` no es un código válido. Obtén el real con el recurso de **consulta de emisor** de eBoleta y usa el `codigo` de tu Casa Matriz. **2. El usuario que autentica y el campo `vendedor`.** Si con el código correcto el error persiste, la autenticación debe hacerse con un **usuario autorizado para emitir boletas** —no con las credenciales de la empresa— y el RUT en `dte.vendedor` debe ser el de ese mismo usuario. En la respuesta del recurso de consulta de emisor, el arreglo `usuarios` muestra a cada uno con su campo `permisos`. Hemos visto casos con `"es_representante": true` pero `"permisos": 0`: ser representante legal no otorga el permiso de emisión. Revisa [Portal eBoleta: "Contribuyente no se encuentra autorizado"](https://www.apigateway.cl/faq/eboleta/contribuyente-no-se-encuentra-autorizado). > [!INFO] Por qué el portal del SII sí funciona > > Al emitir manualmente, el portal resuelve internamente la sucursal y el usuario en sesión. Por API tienes que indicar ambos explícitamente. --- ## Portal eBoleta: ¿qué significa el error de OAuth o timeout esperando localStorage? Indica que el flujo de autenticación del SII no se completó, y la causa habitual es la configuración del proxy. # Portal eBoleta: ¿qué significa el error de OAuth o timeout esperando localStorage? ```json { "status": "400", "detail": "Error al inicializar: Error al procesar OAuth redirect: Timeout esperando localStorage..." } ``` El mensaje describe el flujo de autenticación del SII quedándose a medias al consumir un recurso de eBoleta. La causa habitual es la **configuración del proxy**, y en particular que falte alguno de los dominios que el servicio necesita alcanzar. El diagnóstico confunde porque la autenticación **sí llega al SII**: con una clave incorrecta el error es distinto, y con la clave correcta se produce este timeout, lo que hace pensar que el problema está después del login. Qué revisar: 1. Que estén permitidos **todos** los dominios necesarios en tu proxy. Revisa [¿Qué dominios debe permitir mi proxy?](https://www.apigateway.cl/faq/proxy/que-dominios-debe-permitir-mi-proxy). 2. La ACL de tu Squid, contra la [configuración del tutorial](https://www.apigateway.cl/docs/tutoriales/proxy#content-2-configuración-de-squid). 3. Los [problemas comunes del tutorial de proxy](https://www.apigateway.cl/docs/tutoriales/proxy#content-problemas-comunes), punto por punto. 4. Si restringes por origen, que nuestra IP esté en tu lista de permitidos. > [!WARNING] Alcanzar los dominios del SII no basta > > Comprobar que tu proxy llega a `clave.w.sii.cl` o a `eboleta.sii.cl` no prueba que la ACL esté completa: los dos son `.sii.cl`, y una ACL a la que le falta otro dominio de la lista pasa igual esa prueba. Verifica los **tres** dominios, uno por uno. > > Entrar manualmente al portal desde tu navegador tampoco sirve como prueba: tu navegador no sale por tu proxy. El login funciona ahí aunque la ACL esté incompleta, y es lo que hace parecer que el problema está en el SII. Si tras descartar el proxy el error persiste, revisa los permisos del usuario ante el SII y los campos del request, porque este mismo síntoma puede tener esas causas. Revisa [Errores de proxy y timeouts hacia el SII](https://www.apigateway.cl/docs/solucion-de-problemas/errores-de-proxy). > [!INFO] Sobre el parámetro `state` que se repite > > Varios usuarios han notado que el `state` de la URL de OAuth es idéntico entre peticiones y han supuesto un problema de CSRF. Ese valor **proviene del SII** y su repetición es esperada: no es la causa del error. --- ## Portal eBoleta: ¿puedo anular una boleta por API? El producto eBoleta no cuenta con un recurso de anulación; se anula en el portal del SII. # Portal eBoleta: ¿puedo anular una boleta por API? **No.** El producto Portal eBoleta permite emitir, listar y consultar documentos, pero **no cuenta con un recurso para anular** una boleta ya emitida. La anulación debes hacerla directamente en el portal del SII. Si necesitas anular Boletas de Honorarios o de Terceros, esos productos sí tienen recurso de anulación: revisa [BHE y BTE: ¿puedo anular una boleta por API?](https://www.apigateway.cl/faq/bhe/puedo-anular-una-bhe-o-bte). --- Última actualización el 11/09/2026