Emitir boleta de honorarios (beta)
Emite exclusivamente el borrador vigente de una solicitud con consentimiento o permiso recurrente verificado.
| Tool ID | sii.honorario.emitir |
| Nombre MCP | sii__honorario__emitir |
| Conector | sii |
| Plano | action |
| Scope (permiso) | sii:honorarios:write |
| 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. Una solicitud sólo cruza una vez la barrera de envío. Ante resultado_desconocido se consulta el resultado persistido y se concilia; cambiar de clave no permite volver a emitir la misma solicitud. 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 |
|---|---|---|---|
previewRef | string | sí | Referencia opaca: el servidor verifica propietario, snapshot, autorización y vigencia. |
JSON Schema de entrada
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"previewRef": {
"type": "string",
"minLength": 1,
"maxLength": 8192,
"description": "Referencia opaca: el servidor verifica propietario, snapshot, autorización y vigencia."
}
},
"required": [
"previewRef"
],
"additionalProperties": false
}Salida
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
resultado | valor | sí | Resultado persistido del único intento de emisión. |
JSON Schema de salida
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"resultado": {
"oneOf": [
{
"type": "object",
"properties": {
"estado": {
"type": "string",
"const": "emitido",
"description": "El proveedor confirmó la emisión de esta solicitud."
},
"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."
},
"folio": {
"type": "string",
"maxLength": 64,
"pattern": "^[1-9]\\d*$",
"description": "Folio confirmado por el SII."
}
},
"required": [
"estado",
"solicitudId",
"folio"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"estado": {
"type": "string",
"const": "rechazado",
"description": "El proveedor confirmó el rechazo sin emitir."
},
"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."
},
"codigo": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"description": "Código del rechazo confirmado."
},
"puedeReintentar": {
"type": "boolean",
"const": false,
"description": "La misma solicitud no permite otro envío."
}
},
"required": [
"estado",
"solicitudId",
"codigo",
"puedeReintentar"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"estado": {
"type": "string",
"const": "resultado_desconocido",
"description": "El resultado requiere conciliación con el SII antes de confirmarse."
},
"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."
},
"puedeReintentar": {
"type": "boolean",
"const": false,
"description": "El envío no puede repetirse mientras su resultado sea incierto."
}
},
"required": [
"estado",
"solicitudId",
"puedeReintentar"
],
"additionalProperties": false
}
],
"description": "Resultado persistido del único intento de emisión."
}
},
"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.
Solicitar anulación de honorarios (beta)
Solicita una única anulación del documento y motivo aprobados con referencia vigente y protocolo certificado.
Previsualizar anulación de honorarios (beta)
Consulta la previsualización del SII para una solicitud de anulación persistida, documento y motivo exactos.