Emitir boleta de honorarios (beta)

Emite exclusivamente el borrador vigente de una solicitud con consentimiento o permiso recurrente verificado.

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

CampoTipoRequeridoDescripción
previewRefstringsí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

CampoTipoRequeridoDescripción
resultadovalorsí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.

En esta página