# Solicitar anulación de honorarios (beta)

> Solicita una única anulación del documento y motivo aprobados con referencia vigente y protocolo certificado.



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

|                     |                                                                   |
| ------------------- | ----------------------------------------------------------------- |
| **Tool ID**         | `sii.honorario.anular`                                            |
| **Nombre MCP**      | `sii__honorario__anular`                                          |
| **Conector**        | `sii`                                                             |
| **Plano**           | `action`                                                          |
| **Scope (permiso)** | `sii:honorarios:annul`                                            |
| **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. Un resultado desconocido se consulta y concilia con la misma operación; ninguna clave nueva autoriza repetir el POST. El estado fiscal y la atribución del resultado se informan por separado. La ejecuta Emisso dentro de una solicitud de anulación, no tu integración. Para anular una boleta, crea la solicitud: [POST /api/v1/honorarios\_annulment\_requests](https://connect.emisso.ai/docs/api/createHonorariosAnnulmentRequest).

## Entrada [#entrada]

| Campo        | Tipo                                | Requerido | Descripción                                                                     |
| ------------ | ----------------------------------- | --------- | ------------------------------------------------------------------------------- |
| `previewRef` | string `^bhcp1\.[A-Za-z0-9_-]{43}$` | sí        | Referencia opaca del preview vigente y aprobado de esta solicitud de anulación. |

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

  ```json
  {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "previewRef": {
        "type": "string",
        "pattern": "^bhcp1\\.[A-Za-z0-9_-]{43}$",
        "description": "Referencia opaca del preview vigente y aprobado de esta solicitud de anulación."
      }
    },
    "required": [
      "previewRef"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Salida [#salida]

| Campo                       | Tipo                                                                                                                          | Requerido | Descripción                                                                                                             |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | --------- | ----------------------------------------------------------------------------------------------------------------------- |
| `resultado`                 | objeto                                                                                                                        | sí        | Resultado durable de la anulación, con estado fiscal y atribución separados.                                            |
| `resultado.estado`          | `"anulada"` · `"pendiente_receptor"` · `"rechazada"` · `"revision_administrativa"` · `"resultado_desconocido"`                | sí        | Resultado de la solicitud; resultado\_desconocido exige consultar y reconciliar el mismo intento, sin repetir el envío. |
| `resultado.solicitudId`     | string `^bhc_[A-Za-z0-9_-]+$`                                                                                                 | sí        | ID de la solicitud de anulación cuyo resultado durable se informa.                                                      |
| `resultado.puedeReintentar` | booleano                                                                                                                      | sí        | Siempre false: el envío fiscal final de esta solicitud nunca se repite.                                                 |
| `resultado.atribucion`      | `"own_response"` · `"observed_external"` · `"unknown"`                                                                        | sí        | Origen de la evidencia: respuesta propia correlacionada, observación externa o atribución desconocida.                  |
| `resultado.estadoFiscal`    | `"vigente"` · `"vigente_anulacion_pendiente"` · `"anulada"` · `"observada_receptor"` · `"observada_unidad"` · `"desconocido"` | sí        | Estado fiscal observado de la boleta; una observación no demuestra por sí sola que esta solicitud causó el cambio.      |

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

  ```json
  {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "resultado": {
        "type": "object",
        "properties": {
          "estado": {
            "type": "string",
            "enum": [
              "anulada",
              "pendiente_receptor",
              "rechazada",
              "revision_administrativa",
              "resultado_desconocido"
            ],
            "description": "Resultado de la solicitud; resultado_desconocido exige consultar y reconciliar el mismo intento, sin repetir el envío."
          },
          "solicitudId": {
            "type": "string",
            "maxLength": 128,
            "pattern": "^bhc_[A-Za-z0-9_-]+$",
            "description": "ID de la solicitud de anulación cuyo resultado durable se informa."
          },
          "puedeReintentar": {
            "type": "boolean",
            "const": false,
            "description": "Siempre false: el envío fiscal final de esta solicitud nunca se repite."
          },
          "atribucion": {
            "type": "string",
            "enum": [
              "own_response",
              "observed_external",
              "unknown"
            ],
            "description": "Origen de la evidencia: respuesta propia correlacionada, observación externa o atribución desconocida."
          },
          "estadoFiscal": {
            "type": "string",
            "enum": [
              "vigente",
              "vigente_anulacion_pendiente",
              "anulada",
              "observada_receptor",
              "observada_unidad",
              "desconocido"
            ],
            "description": "Estado fiscal observado de la boleta; una observación no demuestra por sí sola que esta solicitud causó el cambio."
          }
        },
        "required": [
          "estado",
          "solicitudId",
          "puedeReintentar",
          "atribucion",
          "estadoFiscal"
        ],
        "additionalProperties": false,
        "description": "Resultado durable de la anulación, con estado fiscal y atribución separados."
      }
    },
    "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-anular.
