# Preparar boleta de honorarios (beta)

> Prepara en el SII el borrador de una solicitud autorizada de honorarios.



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

|                     |                                                                   |
| ------------------- | ----------------------------------------------------------------- |
| **Tool ID**         | `sii.honorario.previsualizar`                                     |
| **Nombre MCP**      | `sii__honorario__previsualizar`                                   |
| **Conector**        | `sii`                                                             |
| **Plano**           | `action`                                                          |
| **Scope (permiso)** | `sii:honorarios:write`                                            |
| **Auth**            | `connection_credentials`                                          |
| **Versión**         | `1`                                                               |
| **Sensible**        | sí                                                                |
| **Deprecado**       | no                                                                |
| **Comportamiento**  | readOnly=true, destructive=false, 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]

Requiere acceso dedicado del titular y permiso sii:honorarios:write. Devuelve una referencia vinculada a la solicitud y al contenido verificado; no emite. 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                                                           |
| ------------- | --------------------------- | --------- | --------------------------------------------------------------------- |
| `solicitudId` | string `^bhr_[a-zA-Z0-9]+$` | sí        | Identificador opaco de la solicitud de honorarios en tu organización. |

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

  ```json
  {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "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."
      }
    },
    "required": [
      "solicitudId"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Salida [#salida]

| Campo         | Tipo                              | Requerido         | Descripción                                                                            |                  |                        |                       |                    |         |         |            |                |         |     |                   |     |                          |                                              |                   |                         |    |                                                                 |
| ------------- | --------------------------------- | ----------------- | -------------------------------------------------------------------------------------- | ---------------- | ---------------------- | --------------------- | ------------------ | ------- | ------- | ---------- | -------------- | ------- | --- | ----------------- | --- | ------------------------ | -------------------------------------------- | ----------------- | ----------------------- | -- | --------------------------------------------------------------- |
| `requestId`   | string `^bhr_[a-zA-Z0-9]+$`       | sí                | Identificador opaco de la solicitud de honorarios en tu organización.                  |                  |                        |                       |                    |         |         |            |                |         |     |                   |     |                          |                                              |                   |                         |    |                                                                 |
| `version`     | entero                            | sí                | Versión del documento que debe autorizar el profesional.                               |                  |                        |                       |                    |         |         |            |                |         |     |                   |     |                          |                                              |                   |                         |    |                                                                 |
| `previewRef`  | string                            | sí                | Referencia opaca: el servidor verifica propietario, snapshot, autorización y vigencia. |                  |                        |                       |                    |         |         |            |                |         |     |                   |     |                          |                                              |                   |                         |    |                                                                 |
| `payloadHash` | string `^[a-f0-9]{64}$`           | sí                | SHA-256 del contenido canónico de la solicitud.                                        |                  |                        |                       |                    |         |         |            |                |         |     |                   |     |                          |                                              |                   |                         |    |                                                                 |
| `bruto`       | entero                            | sí                | Honorarios brutos en pesos chilenos.                                                   |                  |                        |                       |                    |         |         |            |                |         |     |                   |     |                          |                                              |                   |                         |    |                                                                 |
| `retencion`   | entero                            | sí                | Impuesto que retiene el receptor, en pesos chilenos.                                   |                  |                        |                       |                    |         |         |            |                |         |     |                   |     |                          |                                              |                   |                         |    |                                                                 |
| `liquido`     | entero                            | sí                | Monto que recibe el emisor después de la retención, en pesos chilenos.                 |                  |                        |                       |                    |         |         |            |                |         |     |                   |     |                          |                                              |                   |                         |    |                                                                 |
| `ppmEmisor`   | entero                            | no                | Pago provisional a cargo del emisor cuando el receptor no retiene, en pesos chilenos.  |                  |                        |                       |                    |         |         |            |                |         |     |                   |     |                          |                                              |                   |                         |    |                                                                 |
| `expiresAt`   | string \`^(?:(?:\d\d\[2468]\[048] | \d\d\[13579]\[26] | \d\d0\[48]                                                                             | \[02468]\[048]00 | \[13579]\[26]00)-02-29 | \d{4}-(?:(?:0\[13578] | 1\[02])-(?:0\[1-9] | \[12]\d | 3\[01]) | (?:0\[469] | 11)-(?:0\[1-9] | \[12]\d | 30) | (?:02)-(?:0\[1-9] | 1\d | 2\[0-8])))T(?:(?:\[01]\d | 2\[0-3]):\[0-5]\d(?::\[0-5]\d(?:.\d+)?)?(?:Z | (\[+-]\(?:\[01]\d | 2\[0-3]):\[0-5]\d)))$\` | sí | Vencimiento del borrador, instante ISO 8601 con zona explícita. |

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

  ```json
  {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "requestId": {
        "type": "string",
        "minLength": 1,
        "maxLength": 128,
        "pattern": "^bhr_[a-zA-Z0-9]+$",
        "description": "Identificador opaco de la solicitud de honorarios en tu organización."
      },
      "version": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991,
        "description": "Versión del documento que debe autorizar el profesional."
      },
      "previewRef": {
        "type": "string",
        "minLength": 1,
        "maxLength": 8192,
        "description": "Referencia opaca: el servidor verifica propietario, snapshot, autorización y vigencia."
      },
      "payloadHash": {
        "type": "string",
        "pattern": "^[a-f0-9]{64}$",
        "description": "SHA-256 del contenido canónico de la solicitud."
      },
      "bruto": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991,
        "description": "Honorarios brutos en pesos chilenos."
      },
      "retencion": {
        "type": "integer",
        "minimum": 0,
        "maximum": 9007199254740991,
        "description": "Impuesto que retiene el receptor, en pesos chilenos."
      },
      "liquido": {
        "type": "integer",
        "minimum": 0,
        "maximum": 9007199254740991,
        "description": "Monto que recibe el emisor después de la retención, en pesos chilenos."
      },
      "ppmEmisor": {
        "description": "Pago provisional a cargo del emisor cuando el receptor no retiene, en pesos chilenos.",
        "type": "integer",
        "minimum": 0,
        "maximum": 9007199254740991
      },
      "expiresAt": {
        "type": "string",
        "format": "date-time",
        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
        "description": "Vencimiento del borrador, instante ISO 8601 con zona explícita."
      }
    },
    "required": [
      "requestId",
      "version",
      "previewRef",
      "payloadHash",
      "bruto",
      "retencion",
      "liquido",
      "expiresAt"
    ],
    "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-previsualizar.
