Emitir boleta en e-Boleta (beta)

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


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.

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

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

{
  "$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
}

Salida

Campo	Tipo	Requerido	Descripción
`resultado`	valor	sí	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 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
}

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.

Emitir boleta en e-Boleta (beta)

Qué hace

Entrada

Salida

Errores de esta tool

On this page