Boletas 39 y 41

Connect emite boletas en E-Boleta, el sistema gratuito de boletas del SII, a nombre de la empresa de una conexión. Admite la boleta afecta 39 y la exenta 41, con una línea, cantidad uno y un total entero en pesos. Tu software o tu agente prepara la boleta, revisa la vista previa y la emite: la respuesta trae el folio y el enlace oficial al PDF de la boleta, listo para imprimir.

Los datos de los ejemplos son ficticios. No los envíes.

Qué necesitas

1. La empresa con E-Boleta habilitado en el SII para el tipo que vas a emitir (39, 41 o ambos). Si la empresa no puede emitir ese tipo en eboleta.sii.cl, Connect tampoco.
2. Una conexión SII de representante. En Conexiones, al conectar la empresa elige Con clave de persona: el RUT y la clave tributaria de una persona que la representa, más el RUT de la empresa. Una conexión creada con la clave de la empresa no emite boletas.
3. Las boletas activas en esa conexión. Al conectar, marca Emitir en el SII a nombre de la empresa e ingresa la clave del certificado digital: esa casilla autoriza también las boletas, sin un segundo interruptor, y la clave se exige porque firma las notas de crédito, incluidas las que anulan boletas. Al cerrar, el alta dice si las boletas quedaron activas. Si la conexión ya existe, actívalas en su pestaña Ajustes, panel Emisión en el SII, sin cambiar su ID: con Activar emisión si la conexión solo lee (ver Activar la emisión en una conexión que ya tienes), o con Volver a comprobar en el SII si ya emite facturas pero no boletas. La casilla y el panel requieren un rol de owner o admin en la organización de Connect.
4. Una clave de API con el permiso sii:boletas:write, o un agente conectado por MCP con ese permiso. sii:write no lo sustituye. Las claves no se editan: si la tuya no lo tiene, crea otra en API keys.

Para emitir la boleta, E-Boleta no usa la clave del certificado: Connect entra con la clave tributaria de la conexión, la resuelve en el servidor y nunca la pone en tus llamadas, en los resultados ni en los logs. No se la entregues a tu agente.

La boleta siempre sale a nombre de la empresa de la conexión, aunque la persona represente a varias. El selector de empresa de eboleta.sii.cl es solo del navegador y no cambia lo que emite Connect: para emitir por otra empresa, conéctala aparte.

1. Previsualiza la boleta

sii.boleta.previsualizar entra a E-Boleta con la credencial de la conexión, comprueba la boleta contra la configuración de la empresa y devuelve un previewRef, sin emitir nada:

curl -X POST https://connect.emisso.ai/api/v1/tools/sii.boleta.previsualizar/execute \
  -H "Authorization: Bearer connect_sk_…" \
  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \
  -H "Content-Type: application/json" \
  -d '{
    "input": {
      "candidato": {
        "tipoDte": "39",
        "montoTotal": 25000,
        "detalle": "Mantención de jardín - Av. Los Aromos 1234",
        "medioPagoCodigo": "TRANSFERENCIA"
      }
    }
  }'

Salida esperada (200, campo data):

{
  "candidato": {
    "tipoDte": "39",
    "montoTotal": 25000,
    "detalle": "Mantención de jardín - Av. Los Aromos 1234",
    "medioPagoCodigo": "TRANSFERENCIA"
  },
  "totales": { "total": 25000 },
  "advertencias": ["receptor_no_informado"],
  "sucursal": { "codigo": 0, "direccion": "Av. Los Aromos 1234", "comuna": "Providencia" },
  "previewRef": "<referencia opaca>"
}

sucursal es la sucursal desde la que saldrá la boleta. Este ejemplo no la indica porque la empresa tiene una sola; si tiene varias, ve Sucursal.

La vista previa no escribe en el SII. El previewRef vence en 15 minutos y solo lo emite la misma clave de API (o la misma persona) en la misma conexión. Si cambias algún dato, previsualiza de nuevo.

Sucursal

La boleta sale a nombre de una sucursal de la empresa. Si E-Boleta muestra una sola, se usa esa y no hace falta indicarla. Si la empresa tiene varias, cada vista previa indica la suya en sucursal: Connect no guarda una ni usa una por defecto, así que la misma conexión puede emitir desde distintas sucursales.

Lista las sucursales con sii.boleta_sucursales.listar (no emite ni guarda nada):

curl -X POST https://connect.emisso.ai/api/v1/tools/sii.boleta_sucursales.listar/execute \
  -H "Authorization: Bearer connect_sk_…" \
  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \
  -H "Content-Type: application/json" \
  -d '{}'

{
  "sucursales": [
    { "codigo": 0, "direccion": "Av. Los Aromos 1234", "comuna": "Providencia" },
    { "codigo": 81, "direccion": "Calle Las Palmas 567", "comuna": "Ñuñoa" }
  ]
}

Y envía el código en la vista previa:

{ "candidato": { "tipoDte": "39", "montoTotal": 25000 }, "sucursal": 81 }

La respuesta de la vista previa incluye sucursal (código, dirección y comuna): revísala antes de emitir. Sin sucursal y con varias sucursales, la vista previa responde sii_emitter_profile_required (message: sii_eboleta_sucursal_ambigua) y el suggested_fix trae la misma lista. Un código que E-Boleta no muestra responde validation_error (message: sii_eboleta_sucursal_inexistente).

2. Emite la boleta

Genera una clave de idempotencia (UUID v4), guárdala junto a la boleta en tu sistema antes de llamar y envía el previewRef a sii.boleta.emitir:

curl -X POST https://connect.emisso.ai/api/v1/tools/sii.boleta.emitir/execute \
  -H "Authorization: Bearer connect_sk_…" \
  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \
  -H "Idempotency-Key: 7c1e4b9a-2f6d-4e8b-a3c5-0d9f1b2e6a47" \
  -H "Content-Type: application/json" \
  -d '{"input": {"previewRef": "<referencia opaca>"}}'

Salida esperada (200, recortada):

{
  "data": {
    "resultado": {
      "estado": "emitida",
      "tipoDte": "39",
      "folio": "1287",
      "pdfUrl": "https://eboleta.s3.amazonaws.com/prod/pdf/…/boleta39_folio1287_2026-09-16.pdf?…",
      "puedeReintentar": false
    }
  },
  "meta": {
    "tool_id": "sii.boleta.emitir",
    "request_id": "b52d8e10-4c3a-4f7e-9a61-2e8c0f5d7b93",
    "operation_request_id": "b52d8e10-4c3a-4f7e-9a61-2e8c0f5d7b93"
  }
}

Guarda folio y meta.operation_request_id, el identificador que Connect le asigna a la emisión y que no cambia al repetir la llamada.

pdfUrl es el enlace oficial de E-Boleta al PDF de la boleta, el mismo que abre Ver PDF en eboleta.sii.cl: ábrelo o imprímelo directamente, sin otra llamada a Connect. Quien tenga el enlace puede abrir el PDF, así que trátalo como el documento mismo. Repetir la llamada con la misma clave lo devuelve de nuevo. Si E-Boleta no lo entregó junto con el folio, la respuesta no lo trae y lo obtienes con la descarga.

Nadie confirma boleta por boleta: quien preparó la boleta la confirma al emitirla, y la autorización se dio al activar las boletas en la conexión. La llamada tarda algunos segundos, porque Connect vuelve a entrar a E-Boleta, comprueba que la boleta sigue siendo la que previsualizaste y espera el folio. No la cortes con un timeout corto; si se corta, repítela con la misma clave.

3. Descarga el PDF

sii.boleta.descargar busca en E-Boleta una boleta de la empresa de la conexión y entrega su enlace oficial (pdfUrl) y el PDF en base64: el mismo documento que abre Ver PDF en eboleta.sii.cl, con su timbre. Pide el tipo, el folio y el día de emisión; la empresa la fija la conexión, no un parámetro:

curl -X POST https://connect.emisso.ai/api/v1/tools/sii.boleta.descargar/execute \
  -H "Authorization: Bearer connect_sk_…" \
  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \
  -H "Content-Type: application/json" \
  -d '{"input": {"tipoDte": "39", "folio": "1287", "fecha": "2026-09-16"}}'

Salida esperada (200, campo data, recortada):

{
  "tipoDte": "39",
  "folio": "1287",
  "nombreArchivo": "boleta39_folio1287.pdf",
  "contentType": "application/pdf",
  "byteLength": 48213,
  "sha256": "<64 caracteres hexadecimales>",
  "contenidoBase64": "JVBERi0xLjQK…",
  "pdfUrl": "https://eboleta.s3.amazonaws.com/prod/pdf/…/boleta39_folio1287_2026-09-16.pdf?…"
}

Para mostrar o imprimir basta pdfUrl. Si usas contenidoBase64, decodifícalo y compara su SHA-256 con sha256 antes de imprimir o guardar el archivo. fecha es el día de emisión en hora de Chile (AAAA-MM-DD): Connect busca la boleta ese día, el anterior y el siguiente. Sirve también para boletas que la empresa emitió en eboleta.sii.cl, no solo para las que emitió Connect.

Connect no guarda el PDF: lo baja de E-Boleta en cada llamada, que tarda algunos segundos y usa la conexión mientras corre. Si lo vas a necesitar más de una vez, guárdalo tú. Una boleta recién emitida puede tardar unos minutos en aparecer en E-Boleta; si la llamada responde que no la encuentra, reintenta más tarde.

Por MCP

Un agente conectado al servidor MCP hace las mismas llamadas. La vista previa no escribe, así que va por execute, y params lleva lo mismo que el input de REST, incluida sucursal cuando la empresa tiene varias:

{
  "tool": "sii.boleta.previsualizar",
  "connectionId": "conn_9tKfR2mQx4Vb",
  "params": {
    "candidato": {
      "tipoDte": "39",
      "montoTotal": 25000,
      "detalle": "Mantención de jardín - Av. Los Aromos 1234",
      "medioPagoCodigo": "TRANSFERENCIA"
    },
    "sucursal": 81
  }
}

Listar las sucursales tampoco escribe, así que va por execute, con params vacío:

{ "tool": "sii.boleta_sucursales.listar", "connectionId": "conn_9tKfR2mQx4Vb", "params": {} }

La emisión escribe, así que va por execute_write, con la clave de idempotencia como argumento, fuera de params:

{
  "tool": "sii.boleta.emitir",
  "connectionId": "conn_9tKfR2mQx4Vb",
  "idempotencyKey": "7c1e4b9a-2f6d-4e8b-a3c5-0d9f1b2e6a47",
  "params": { "previewRef": "<referencia opaca>" }
}

La UUID del ejemplo solo ilustra el formato: genera una propia por boleta.

La descarga del PDF no escribe, así que va por execute:

{
  "tool": "sii.boleta.descargar",
  "connectionId": "conn_9tKfR2mQx4Vb",
  "params": { "tipoDte": "39", "folio": "1287", "fecha": "2026-09-16" }
}

La descarga devuelve el PDF completo en base64, que ocupa mucho contexto del modelo. Si el agente solo tiene que entregar el documento, le basta el pdfUrl que ya trae la emisión.

El candidato, campo por campo

No envíes neto ni IVA: en la 39, E-Boleta los calcula a partir del total. Una boleta de $25.000 queda con $21.008 de neto y $3.992 de IVA. La 41 es exenta y no lleva IVA. La vista previa devuelve solo el total.

Los medios de pago son los que muestra hoy el catálogo de E-Boleta, y Connect contrasta el código con ese catálogo en cada vista previa. Sin medioPagoCodigo, la vista previa advierte medio_pago_no_informado.

La boleta no lleva fecha, folio, varias líneas, cantidades, referencias ni descuentos: la fecha y el folio los pone E-Boleta al emitir.

Receptor

Sin receptor, la boleta va al consumidor final genérico del SII y la vista previa advierte receptor_no_informado. Para identificar a quien compra:

{
  "tipoDte": "39",
  "montoTotal": 25000,
  "detalle": "Mantención de jardín",
  "receptor": {
    "rut": "77123456-9",
    "razonSocial": "Comercial Los Aromos SpA",
    "direccion": "Av. Providencia 1234, Providencia",
    "correo": "pagos@ejemplo.cl"
  }
}

Cada empresa tiene reglas propias en E-Boleta: sobre cierto monto o con cierto medio de pago puede exigir detalle, medio de pago o receptor completo (con correo y teléfono). Connect las lee en cada vista previa y rechaza la boleta antes de enviarla si falta algo.

Resultados

sii.boleta.emitir devuelve un resultado con uno de tres estados. puedeReintentar siempre es false: nunca autoriza a preparar otra boleta para lo mismo.

Resultado desconocido

Connect guarda la operación antes de un único envío a E-Boleta. Si la respuesta se pierde (un corte, un timeout), recibes resultado_desconocido con siguientePaso: "reconciliacion_automatica_o_soporte". Mientras tanto, la reconciliación automática busca la boleta en los reportes de E-Boleta de la empresa.

1. No crees otra clave de idempotencia ni otra vista previa. Una clave nueva puede emitir una segunda boleta.
2. Repite la misma llamada con la misma clave. No reenvía nada: devuelve el estado guardado de la operación, con meta.idempotency en replayed. Funciona aunque el previewRef ya haya vencido.
3. Si sigue desconocido, entrega a soporte el operation_request_id.

No compartas con soporte cuerpos completos, credenciales ni el previewRef.

Errores frecuentes

Estos errores llegan antes de que la boleta salga hacia E-Boleta: la boleta no se envió. Cuando el código es upstream_unexpected_response, el campo message del error dice cuál es el caso y suggested_fix, qué corregir.

El catálogo completo está en la referencia de errores.

Ver la boleta emitida

• Por API: la emisión ya trae pdfUrl, el enlace oficial al PDF. Para una boleta anterior, o si no vino, usa sii.boleta.descargar.
• En Connect: en Conexiones, abre la conexión y entra a Datos → Emisión: las boletas emitidas desde esa conexión aparecen en su propia sección, cada una con su PDF. Cada llamada queda además en la bitácora de la organización.
• En el SII: entra a eboleta.sii.cl con la clave tributaria de la persona, elige la empresa en el selector, abre Reportes, busca la boleta por su folio y usa Ver PDF.

Desactivar

Para dejar de emitir boletas desde una empresa, abre la conexión, entra a Ajustes y pulsa Dejar de emitir (dueño o administrador): eso impide boletas nuevas, conserva el connectionId y lo sincronizado, y la conexión vuelve a cobrarse como lectura. Puedes reactivarla con Activar emisión. Emisso también puede cortar la emisión de toda la organización, boletas incluidas, como medida de cierre general. Nada de eso borra la auditoría: una operación ya iniciada conserva su identidad y se sigue consultando con su misma clave.

La referencia completa del contrato está en sii.boleta.previsualizar y sii.boleta.emitir.