Preparar boleta de honorarios (beta)
Prepara en el SII el borrador de una solicitud autorizada de honorarios.
| 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
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.
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. |
JSON Schema de entrada
{
"$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
}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] |
JSON Schema de salida
{
"$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
}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.