# Previsualizar anulación de honorarios (beta)

> Consulta la previsualización del SII para una solicitud de anulación persistida, documento y motivo exactos.



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

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

> **Requiere conexión.** Indica cuál en cada llamada: header `X-Connect-Connection` en REST, campo `connectionId` en el `execute` 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]

Requiere acceso dedicado del titular y scope sii:honorarios:annul. No anula ni reutiliza el consentimiento de emisión.

## Entrada [#entrada]

| Campo         | Tipo                          | Requerido | Descripción                                                                               |
| ------------- | ----------------------------- | --------- | ----------------------------------------------------------------------------------------- |
| `solicitudId` | string `^bhc_[A-Za-z0-9_-]+$` | sí        | ID de la solicitud persistida de anulación de honorarios, con documento y motivo exactos. |

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

  ```json
  {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "solicitudId": {
        "type": "string",
        "maxLength": 128,
        "pattern": "^bhc_[A-Za-z0-9_-]+$",
        "description": "ID de la solicitud persistida de anulación de honorarios, con documento y motivo exactos."
      }
    },
    "required": [
      "solicitudId"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Salida [#salida]

| Campo             | Tipo                                | Requerido         | Descripción                                                                     |                  |                        |                       |                    |         |         |            |                |         |     |                   |     |                          |                                              |                   |                         |    |                                                                    |
| ----------------- | ----------------------------------- | ----------------- | ------------------------------------------------------------------------------- | ---------------- | ---------------------- | --------------------- | ------------------ | ------- | ------- | ---------- | -------------- | ------- | --- | ----------------- | --- | ------------------------ | -------------------------------------------- | ----------------- | ----------------------- | -- | ------------------------------------------------------------------ |
| `requestId`       | string `^bhc_[A-Za-z0-9_-]+$`       | sí                | ID de la solicitud persistida de anulación de honorarios.                       |                  |                        |                       |                    |         |         |            |                |         |     |                   |     |                          |                                              |                   |                         |    |                                                                    |
| `documentVersion` | entero                              | sí                | Versión exacta del documento y motivo vinculados al preview.                    |                  |                        |                       |                    |         |         |            |                |         |     |                   |     |                          |                                              |                   |                         |    |                                                                    |
| `previewRef`      | string `^bhcp1\.[A-Za-z0-9_-]{43}$` | sí                | Referencia opaca del preview vigente y aprobado de esta solicitud de anulación. |                  |                        |                       |                    |         |         |            |                |         |     |                   |     |                          |                                              |                   |                         |    |                                                                    |
| `previewHash`     | string `^[a-f0-9]{64}$`             | sí                | SHA-256 del contenido material de la previsualización que requiere aprobación.  |                  |                        |                       |                    |         |         |            |                |         |     |                   |     |                          |                                              |                   |                         |    |                                                                    |
| `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 preview como 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",
        "maxLength": 128,
        "pattern": "^bhc_[A-Za-z0-9_-]+$",
        "description": "ID de la solicitud persistida de anulación de honorarios."
      },
      "documentVersion": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991,
        "description": "Versión exacta del documento y motivo vinculados al preview."
      },
      "previewRef": {
        "type": "string",
        "pattern": "^bhcp1\\.[A-Za-z0-9_-]{43}$",
        "description": "Referencia opaca del preview vigente y aprobado de esta solicitud de anulación."
      },
      "previewHash": {
        "type": "string",
        "pattern": "^[a-f0-9]{64}$",
        "description": "SHA-256 del contenido material de la previsualización que requiere aprobación."
      },
      "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 preview como instante ISO 8601 con zona explícita."
      }
    },
    "required": [
      "requestId",
      "documentVersion",
      "previewRef",
      "previewHash",
      "expiresAt"
    ],
    "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).