# Emitir boleta de honorarios (beta)

> Emite exclusivamente el borrador vigente de una solicitud con consentimiento o permiso recurrente verificado.



{/* AUTO-GENERATED by @emisso/codegen. DO NOT EDIT. */}

|                     |                                                                   |
| ------------------- | ----------------------------------------------------------------- |
| **Tool ID**         | `sii.honorario.emitir`                                            |
| **Nombre MCP**      | `sii__honorario__emitir`                                          |
| **Conector**        | `sii`                                                             |
| **Plano**           | `action`                                                          |
| **Scope (permiso)** | `sii:honorarios:write`                                            |
| **Auth**            | `connection_credentials`                                          |
| **Versión**         | `1`                                                               |
| **Sensible**        | sí                                                                |
| **Deprecado**       | no                                                                |
| **Comportamiento**  | readOnly=false, destructive=true, idempotent=true, openWorld=true |

> **La ejecuta Emisso, no tu integración.** Corre dentro de una solicitud, en el enlace alojado o en su proceso en segundo plano, sobre una conexión dedicada que Emisso administra. Con una clave de API o un token OAuth la llamada se rechaza. Esta página documenta qué hace y qué devuelve.

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

Cada llamada lleva una Idempotency-Key UUID v4. Una solicitud sólo cruza una vez la barrera de envío. Ante resultado\_desconocido se consulta el resultado persistido y se concilia; cambiar de clave no permite volver a emitir la misma solicitud. La ejecuta Emisso dentro de una solicitud de honorarios, no tu integración. Para emitir una boleta, crea la solicitud: [Pedir boletas de honorarios](https://connect.emisso.ai/docs/emitir/honorarios).

## Entrada [#entrada]

| Campo        | Tipo   | Requerido | Descripción                                                                            |
| ------------ | ------ | --------- | -------------------------------------------------------------------------------------- |
| `previewRef` | string | sí        | Referencia opaca: el servidor verifica propietario, snapshot, autorización y vigencia. |

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

  ```json
  {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "previewRef": {
        "type": "string",
        "minLength": 1,
        "maxLength": 8192,
        "description": "Referencia opaca: el servidor verifica propietario, snapshot, autorización y vigencia."
      }
    },
    "required": [
      "previewRef"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Salida [#salida]

| Campo       | Tipo  | Requerido | Descripción                                        |
| ----------- | ----- | --------- | -------------------------------------------------- |
| `resultado` | valor | sí        | Resultado persistido del único intento de emisió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": {
              "estado": {
                "type": "string",
                "const": "emitido",
                "description": "El proveedor confirmó la emisión de esta solicitud."
              },
              "solicitudId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 128,
                "pattern": "^bhr_[a-zA-Z0-9]+$",
                "description": "Identificador opaco de la solicitud de honorarios en tu organización."
              },
              "folio": {
                "type": "string",
                "maxLength": 64,
                "pattern": "^[1-9]\\d*$",
                "description": "Folio confirmado por el SII."
              }
            },
            "required": [
              "estado",
              "solicitudId",
              "folio"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "estado": {
                "type": "string",
                "const": "rechazado",
                "description": "El proveedor confirmó el rechazo sin emitir."
              },
              "solicitudId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 128,
                "pattern": "^bhr_[a-zA-Z0-9]+$",
                "description": "Identificador opaco de la solicitud de honorarios en tu organización."
              },
              "codigo": {
                "type": "string",
                "minLength": 1,
                "maxLength": 128,
                "description": "Código del rechazo confirmado."
              },
              "puedeReintentar": {
                "type": "boolean",
                "const": false,
                "description": "La misma solicitud no permite otro envío."
              }
            },
            "required": [
              "estado",
              "solicitudId",
              "codigo",
              "puedeReintentar"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "estado": {
                "type": "string",
                "const": "resultado_desconocido",
                "description": "El resultado requiere conciliación con el SII antes de confirmarse."
              },
              "solicitudId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 128,
                "pattern": "^bhr_[a-zA-Z0-9]+$",
                "description": "Identificador opaco de la solicitud de honorarios en tu organización."
              },
              "puedeReintentar": {
                "type": "boolean",
                "const": false,
                "description": "El envío no puede repetirse mientras su resultado sea incierto."
              }
            },
            "required": [
              "estado",
              "solicitudId",
              "puedeReintentar"
            ],
            "additionalProperties": false
          }
        ],
        "description": "Resultado persistido del único intento de emisión."
      }
    },
    "required": [
      "resultado"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Errores de esta tool [#errores-de-esta-tool]

Tu integración no recibe errores de esta tool porque no la llama: con una clave de API o un token OAuth la llamada se rechaza antes de ejecutarse. Lo que falle dentro de la solicitud se informa en la solicitud misma; «Qué hace» dice cómo pedirla.


---

Esta página es parte de la documentación de Emisso. El índice completo, con cada página y su descripción, está en https://connect.emisso.ai/llms.txt. Esta misma página en HTML: https://connect.emisso.ai/docs/referencia/sii/honorario-emitir.
