Factuarea APIDevelopers

Recursos y prompts

Lee las reglas fiscales y usa los cinco flujos guiados antes de invocar herramientas de negocio.

Los recursos ofrecen orientación fiscal reutilizable; los prompts organizan una tarea en pasos. Ninguno concede un scope ni ejecuta la operación de negocio. Descúbrelos con resources/list y prompts/list, usando el protocolo vigente, y lee o desarrolla el elemento correspondiente antes de invocar una herramienta.

Nueve recursos fiscales

La URI de cada recurso empieza por factuarea://guardrails/; pasa la URI completa a resources/read.

Sufijo de URIFinalidad
emision-borrador-a-emitidaPasar un borrador a factura emitida.
anular-o-rectificarElegir anulación o factura rectificativa.
tipos-de-facturaSeleccionar el tipo de factura.
lineas-e-importesPreparar líneas, impuestos e importes.
claves-de-regimenElegir claves de régimen fiscal.
numeracion-de-seriesUsar correctamente las series de numeración.
validacion-de-nifValidar la identificación del comprador.
puertas-de-verifactuRevisar los requisitos de VeriFactu.
multi-empresaSeleccionar el contexto de empresa correcto.

Cinco prompts guiados

Nombre del promptFinalidad
emitir_facturaPreparar y emitir una factura.
arreglar_factura_fallidaDiagnosticar una factura fallida.
alta_de_nifGuiar el alta del NIF.
conectar_tiendaConectar y configurar una tienda.
diagnosticar_pedido_no_facturadoInvestigar un pedido que no produjo factura.

Invoca prompts/get con el nombre recibido y los argumentos declarados. No deduzcas los argumentos del nombre del prompt: consulta prompts/list. Para conectar_tienda, establece primero la autorización del proveedor y comprueba los scopes de tu API key. Para diagnosticar pedidos, consulta el evento de integración y si admite reproceso antes de crear un documento manualmente.

Resuelve un rechazo de las reglas

mcp_guardrail_violation es un rechazo de negocio 422 con rule_id, guardrail_uri y un subcódigo en los datos del error. Lee el recurso indicado, corrige la petición y conserva la política de idempotencia de la operación prevista. Los prompts y recursos ayudan a preparar una llamada válida; no evitan la validación, el aislamiento entre empresas ni los scopes.

En esta página

¿Te echamos una mano?Contactar con soporte