Connect
ReferenciaServicio de Impuestos Internos

Emitir boleta en e-Boleta

Emite en E-Boleta del SII la boleta de un previewRef vigente.

Tool IDsii.boleta.emitir
Nombre MCPsii__boleta__emitir
Conectorsii
Planoaction
Scope (permiso)sii:boletas:write
Authconnection_credentials
Versión1
Sensiblesí
Deprecadono
ComportamientoreadOnly=false, destructive=true, idempotent=true, openWorld=true

Requiere conexión. Indica cuál en cada llamada: header X-Connect-Connection en REST y campo connectionId en el execute_write de MCP. No hay resolución implícita, ni siquiera con una sola conexión activa: la conexión es la empresa. El id sale de conexiones.estado.consultar.

Qué hace

Quien la preparó la confirma al emitir; exige Idempotency-Key UUID v4 explícita. Si E-Boleta devuelve el folio, responde emitida en la misma llamada. Si la respuesta se pierde, responde resultado_desconocido y la reconciliación lo resuelve: repite la MISMA clave para consultarlo; una clave nueva emitiría otra boleta.

Entrada

CampoTipoRequeridoDescripción
previewRefstring ^[A-Za-z0-9_.-]+$síReferencia opaca de preparación ligada a su propietario; vigencia máxima de 15 minutos para iniciar emisión.
JSON Schema de entrada
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "previewRef": {
      "type": "string",
      "minLength": 24,
      "maxLength": 8192,
      "pattern": "^[A-Za-z0-9_.-]+$",
      "description": "Referencia opaca de preparación ligada a su propietario; vigencia máxima de 15 minutos para iniciar emisión."
    }
  },
  "required": [
    "previewRef"
  ],
  "additionalProperties": false
}

Ejemplo

curl
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: 9d1f4c2a-7b30-4e58-9c11-2f6a8de5b743" \
  -H "Content-Type: application/json" \
  -d '{"input":{"previewRef":"ebr.1.1.Tz4Kp9Wm2Qx7Lb5N.Vc8Rj3Yt6Hn1Fs0Gk4DmQw.Jq2Ux9Ab4Lr7Wn1Ze5Ct8Ks3Pv6Hy0Mf2Gd9Tb4Nx7Qa1Rw5Ej8Lc3Vu6Is0Op2Y"}}'
MCP · meta-tool execute_write
{
  "tool": "sii.boleta.emitir",
  "params": {
    "previewRef": "ebr.1.1.Tz4Kp9Wm2Qx7Lb5N.Vc8Rj3Yt6Hn1Fs0Gk4DmQw.Jq2Ux9Ab4Lr7Wn1Ze5Ct8Ks3Pv6Hy0Mf2Gd9Tb4Nx7Qa1Rw5Ej8Lc3Vu6Is0Op2Y"
  },
  "connectionId": "conn_9tKfR2mQx4Vb",
  "idempotencyKey": "9d1f4c2a-7b30-4e58-9c11-2f6a8de5b743"
}

Clave de idempotencia obligatoria. Sin ella la llamada responde idempotency_key_missing. Genera un UUID v4 nuevo por operación y envíalo en Idempotency-Key (REST) o en idempotencyKey (MCP). Repite la misma clave solo al reintentar esa operación.

Salida esperada (200):

{
  "data": {
    "resultado": {
      "estado": "emitida",
      "tipoDte": "39",
      "folio": "1287",
      "pdfUrl": "https://eboleta.s3.amazonaws.com/prod/pdf/76987654/39/boleta39_folio1287_2026-09-16.pdf?AWSAccessKeyId=EJEMPLO&Expires=1789585200&Signature=EJEMPLO",
      "puedeReintentar": false
    }
  },
  "meta": {
    "request_id": "req_…",
    "tool_id": "sii.boleta.emitir",
    "plane": "action",
    "latency_ms": 7410,
    "audit_status": "recorded"
  }
}

Primero previsualiza con sii.boleta.previsualizar: emitir solo acepta lo previsualizado y se reintenta con la misma Idempotency-Key. pdfUrl abre el PDF oficial sin otra llamada. Paso a paso en Boletas 39 y 41.

Salida

CampoTipoRequeridoDescripción
resultadovalorsíDesenlace tributario allowlisted de la operación.
JSON Schema de salida
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "resultado": {
      "oneOf": [
        {
          "type": "object",
          "properties": {
            "tipoDte": {
              "type": "string",
              "enum": [
                "39",
                "41"
              ],
              "description": "Tipo de boleta: 39 afecta o 41 exenta."
            },
            "puedeReintentar": {
              "type": "boolean",
              "const": false,
              "description": "Siempre false: no autoriza repetir el compromiso externo."
            },
            "estado": {
              "type": "string",
              "const": "emitida",
              "description": "Emisión concluyente: E-Boleta devolvió tipo y folio, o la reconciliación los confirmó."
            },
            "folio": {
              "type": "string",
              "pattern": "^[1-9][0-9]*$",
              "description": "Folio externo conservado como texto; solo con identidad concluyente."
            },
            "pdfUrl": {
              "description": "Enlace oficial de E-Boleta al PDF de esta boleta, el mismo que abre «Ver PDF» en eboleta.sii.cl. Viene cuando E-Boleta lo entrega junto con el folio; si falta, sii.boleta.descargar lo trae.",
              "type": "string",
              "maxLength": 4096,
              "format": "uri"
            }
          },
          "required": [
            "tipoDte",
            "puedeReintentar",
            "estado",
            "folio"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "tipoDte": {
              "type": "string",
              "enum": [
                "39",
                "41"
              ],
              "description": "Tipo de boleta: 39 afecta o 41 exenta."
            },
            "puedeReintentar": {
              "type": "boolean",
              "const": false,
              "description": "Siempre false: no autoriza repetir el compromiso externo."
            },
            "estado": {
              "type": "string",
              "const": "rechazada",
              "description": "Rechazo concluyente sin consumo de folio."
            },
            "motivo": {
              "type": "string",
              "enum": [
                "rechazo_concluyente_sin_emision"
              ],
              "description": "Motivo seguro del rechazo confirmado."
            }
          },
          "required": [
            "tipoDte",
            "puedeReintentar",
            "estado",
            "motivo"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "tipoDte": {
              "type": "string",
              "enum": [
                "39",
                "41"
              ],
              "description": "Tipo de boleta: 39 afecta o 41 exenta."
            },
            "puedeReintentar": {
              "type": "boolean",
              "const": false,
              "description": "Siempre false: no autoriza repetir el compromiso externo."
            },
            "estado": {
              "type": "string",
              "const": "resultado_desconocido",
              "description": "Evidencia insuficiente para afirmar emisión o rechazo."
            },
            "siguientePaso": {
              "type": "string",
              "const": "reconciliacion_automatica_o_soporte",
              "description": "Consultar evidencia mediante reconciliación o soporte."
            }
          },
          "required": [
            "tipoDte",
            "puedeReintentar",
            "estado",
            "siguientePaso"
          ],
          "additionalProperties": false
        }
      ],
      "description": "Desenlace tributario allowlisted de la operación."
    }
  },
  "required": [
    "resultado"
  ],
  "additionalProperties": false
}

Errores de esta tool

CódigoHTTPReintentableQué hacer
connection_disabled403noReactívala en /connections o usa otra conexión del mismo sistema.
connection_not_found404noUsa uno de los connectionId que lista el error, o revisa la conexión en /connections. No hace falta reactivar nada.
connection_credential_required428noCrea un enlace con conexiones.enlace.crear (modo reconectar si la conexión ya existe) y pide a la persona que entregue la credencial de nuevo. No reintentes con la credencial anterior.
connection_busy409síEspera unos segundos y reintenta. Es una espera transitoria: no necesitas volver a conectar ni ingresar la credencial otra vez.
upstream_error502síReintenta más tarde. Si persiste, el problema está en el sistema externo, no en tu integración.
timeout504síReintenta. Para sincronizaciones largas usa la vía asíncrona y consulta el estado del trabajo.

Toda llamada puede devolver además los códigos transversales (validation_error, unauthorized, scope_not_granted, rate_limited, entre otros): el detalle vive en el catálogo de errores.

Descargar el PDF de una boleta

Descarga desde E-Boleta del SII el PDF oficial de una boleta 39 o 41 de la empresa de la conexión, por tipo, folio y fecha de emisión, y lo devuelve en base64 con su SHA-256 y con su enlace oficial de E-Boleta (pdfUrl).

Preparar boleta en e-Boleta

Prepara una boleta 39 o 41 en E-Boleta del SII sin emitir y devuelve previewRef, vigente 15 minutos.

En esta página

Qué haceEntradaEjemploSalidaErrores de esta tool