mcp_guardrail_violation
La llamada infringe una regla fiscal declarada y se ha rechazado LOCALMENTE, antes de ejecutar nada: no se ha creado, modificado ni borrado ningún documento. Es el único código del catálogo que ninguna ruta de la API v1 puede emitir — quien lo recibe está hablando por MCP. El `subcode` dice cuál de los nueve guardrails se ha infringido, y los datos del error traen `guardrail_uri` (el resource que explica la regla) y `rule_id` (la regla concreta, con la forma `BR-XXX-NNN`).
| Code | Type | HTTP | Categoría |
|---|---|---|---|
mcp_guardrail_violation | invalid_request_error | 422 | MCP |
Causa
La llamada infringe una regla fiscal declarada y se ha rechazado LOCALMENTE, antes de ejecutar nada: no se ha creado, modificado ni borrado ningún documento. Es el único código del catálogo que ninguna ruta de la API v1 puede emitir — quien lo recibe está hablando por MCP. El subcode dice cuál de los nueve guardrails se ha infringido, y los datos del error traen guardrail_uri (el resource que explica la regla) y rule_id (la regla concreta, con la forma BR-XXX-NNN).
Qué hacer
No reintentes ni esperes: la misma llamada volverá a rechazarse igual. Lee el resource que indica guardrail_uri y haz la operación que sí corresponde —anular en vez de borrar una factura emitida, rectificar en vez de editarla, emitir en la serie que toca—. El mensaje del error ya nombra la regla infringida y esa lectura, así que basta con seguirlo.