# Emitir boleta en e-Boleta
> Emite en E-Boleta del SII la boleta de un previewRef vigente.
{/* AUTO-GENERATED by @emisso/codegen. DO NOT EDIT. */}
| | |
| ------------------- | ----------------------------------------------------------------- |
| **Tool ID** | `sii.boleta.emitir` |
| **Nombre MCP** | `sii__boleta__emitir` |
| **Conector** | `sii` |
| **Plano** | `action` |
| **Scope (permiso)** | `sii:boletas:write` |
| **Auth** | `connection_credentials` |
| **Versión** | `1` |
| **Sensible** | sí |
| **Deprecado** | no |
| **Comportamiento** | readOnly=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`](/docs/referencia/conexiones/estado-consultar).
## Qué hace [#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 [#entrada]
| Campo | Tipo | Requerido | Descripción |
| ------------ | -------------------------- | --------- | ------------------------------------------------------------------------------------------------------------ |
| `previewRef` | string `^[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
```json
{
"$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 [#ejemplo]
```bash title="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"}}'
```
```json title="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):**
```json
{
"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](/docs/emitir/boletas).
## Salida [#salida]
| Campo | Tipo | Requerido | Descripción |
| ----------- | ----- | --------- | ------------------------------------------------- |
| `resultado` | valor | sí | Desenlace tributario allowlisted de la operación. |
JSON Schema de salida
```json
{
"$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 [#errores-de-esta-tool]
| Código | HTTP | Reintentable | Qué hacer |
| -------------------------------- | ---- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `connection_disabled` | 403 | no | Reactívala en /connections o usa otra conexión del mismo sistema. |
| `connection_not_found` | 404 | no | Usa uno de los connectionId que lista el error, o revisa la conexión en /connections. No hace falta reactivar nada. |
| `connection_credential_required` | 428 | no | Crea 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_busy` | 409 | sí | Espera unos segundos y reintenta. Es una espera transitoria: no necesitas volver a conectar ni ingresar la credencial otra vez. |
| `upstream_error` | 502 | sí | Reintenta más tarde. Si persiste, el problema está en el sistema externo, no en tu integración. |
| `timeout` | 504 | sí | 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](/docs/referencia/errores).