mcp_guardrail_violation
La crida infringeix una regla fiscal declarada i s'ha rebutjat LOCALMENT, abans d'executar res: no s'ha creat, modificat ni esborrat cap document. És l'únic codi del catàleg que cap ruta de l'API v1 no pot emetre — qui el rep està parlant per MCP. El `subcode` diu quin dels nou guardrails s'ha infringit, i les dades de l'error porten `guardrail_uri` (el resource que explica la regla) i `rule_id` (la regla concreta, amb la forma `BR-XXX-NNN`).
| Code | Type | HTTP | Categoria |
|---|---|---|---|
mcp_guardrail_violation | invalid_request_error | 422 | MCP |
Causa
La crida infringeix una regla fiscal declarada i s'ha rebutjat LOCALMENT, abans d'executar res: no s'ha creat, modificat ni esborrat cap document. És l'únic codi del catàleg que cap ruta de l'API v1 no pot emetre — qui el rep està parlant per MCP. El subcode diu quin dels nou guardrails s'ha infringit, i les dades de l'error porten guardrail_uri (el resource que explica la regla) i rule_id (la regla concreta, amb la forma BR-XXX-NNN).
Què fer
No ho reintentis ni esperis: la mateixa crida es tornarà a rebutjar igual. Llegeix el resource que indica guardrail_uri i fes l'operació que sí que correspon —anul·lar en comptes d'esborrar una factura emesa, rectificar en comptes d'editar-la, emetre a la sèrie que toca—. El missatge de l'error ja anomena la regla infringida i aquesta lectura, així que n'hi ha prou de seguir-lo.