# Emitir boleta en e-Boleta (beta)

> Inicia un único envío en la beta de e-Boleta para una organización habilitada.



{/* 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, campo `connectionId` en el `execute_write` de MCP y en las opciones del SDK. 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`](../conexiones/estado-consultar).

## Qué hace [#qué-hace]

Exige previewRef vigente, confirmación humana en Connect e Idempotency-Key UUID v4 explícita. El compromiso se guarda antes del POST; la aceptación requiere consulta exacta posterior. Conserva la misma clave para consultar el resultado: un resultado desconocido nunca autoriza reenvío.

## 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. |

<details>
  <summary>
    JSON Schema de entrada
  </summary>

  ```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
  }
  ```
</details>

## Salida [#salida]

| Campo       | Tipo  | Requerido | Descripción                                       |
| ----------- | ----- | --------- | ------------------------------------------------- |
| `resultado` | valor | sí        | Desenlace tributario allowlisted de la operación. |

<details>
  <summary>
    JSON Schema de salida
  </summary>

  ```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 y reconciliación concluyentes."
              },
              "folio": {
                "type": "string",
                "pattern": "^[1-9][0-9]*$",
                "description": "Folio externo conservado como texto; solo con identidad concluyente."
              }
            },
            "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
  }
  ```
</details>

## 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_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](../errores).