Solicitar anulación de honorarios (beta)
Solicita una única anulación del documento y motivo aprobados con referencia vigente y protocolo certificado.
| 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
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.
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. |
JSON Schema de entrada
{
"$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
}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. |
JSON Schema de salida
{
"$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
}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.