Factuarea APIDevelopers

Resources and prompts

Read fiscal guardrails and use the five guided workflows before calling business tools.

Resources provide reusable fiscal guidance; prompts organize a task into steps. Neither one grants a scope nor performs the business operation. Discover them with resources/list and prompts/list, using the current protocol, then read or expand the relevant item before calling a tool.

Nine fiscal resources

Each resource URI starts with factuarea://guardrails/; pass the complete URI to resources/read.

URI suffixPurpose
emision-borrador-a-emitidaMove a draft to an issued invoice.
anular-o-rectificarChoose annulment or a corrective invoice.
tipos-de-facturaSelect the invoice type.
lineas-e-importesPrepare lines, taxes and amounts.
claves-de-regimenChoose tax-regime codes.
numeracion-de-seriesUse numbering series correctly.
validacion-de-nifValidate buyer identification.
puertas-de-verifactuReview prerequisites for VeriFactu.
multi-empresaSelect the correct company context.

Five guided prompts

Prompt namePurpose
emitir_facturaPrepare and issue an invoice.
arreglar_factura_fallidaDiagnose a failed invoice.
alta_de_nifGuide tax-ID setup.
conectar_tiendaConnect and configure a store.
diagnosticar_pedido_no_facturadoTrace an order that produced no invoice.

Call prompts/get with the returned name and declared arguments. Do not guess arguments from the Spanish prompt name: inspect prompts/list. For conectar_tienda, first establish provider authorization and check your API-key scopes. For order diagnosis, inspect the integration event and its replayability before creating a document manually.

Recover from a guardrail rejection

mcp_guardrail_violation is a 422 business rejection with rule_id, guardrail_uri and a subcode in its error data. Read the referenced resource, correct the request and keep the intended operation’s idempotency policy. Prompts and resources help prepare a valid call; they do not bypass validation, tenant isolation or scopes.

On this page

Need a hand?Contact support