Previsualizar anulación de honorarios (beta)

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

Tool IDsii.honorario.previsualizar_anulacion
Nombre MCPsii__honorario__previsualizar_anulacion
Conectorsii
Planoaction
Scope (permiso)sii:honorarios:annul
Authconnection_credentials
Versión1
Sensiblesí
Deprecadono
ComportamientoreadOnly=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

Requiere acceso dedicado del titular y scope sii:honorarios:annul. No anula ni reutiliza el consentimiento de emisión. 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

CampoTipoRequeridoDescripción
solicitudIdstring ^bhc_[A-Za-z0-9_-]+$síID de la solicitud persistida de anulación de honorarios, con documento y motivo exactos.
JSON Schema de entrada
{
  "$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
}

Salida

CampoTipoRequeridoDescripción
requestIdstring ^bhc_[A-Za-z0-9_-]+$síID de la solicitud persistida de anulación de honorarios.
documentVersionenterosíVersión exacta del documento y motivo vinculados al preview.
previewRefstring ^bhcp1\.[A-Za-z0-9_-]{43}$síReferencia opaca del preview vigente y aprobado de esta solicitud de anulación.
previewHashstring ^[a-f0-9]{64}$síSHA-256 del contenido material de la previsualización que requiere aprobación.
expiresAtstring `^(?:(?:\d\d[2468][048]\d\d[13579][26]\d\d0[48]
JSON Schema de salida
{
  "$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
}

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.

En esta página