Factuarea APIDevelopers

Recursos i prompts

Llegeix les regles fiscals i fes servir els cinc fluxos guiats abans d’invocar eines de negoci.

Els recursos ofereixen orientació fiscal reutilitzable; els prompts organitzen una tasca en passos. Cap no concedeix un scope ni executa l’operació de negoci. Descobreix-los amb resources/list i prompts/list, fent servir el protocol vigent, i llegeix o desenvolupa l’element corresponent abans d’invocar una eina.

Nou recursos fiscals

La URI de cada recurs comença per factuarea://guardrails/; passa la URI completa a resources/read.

Sufix de URIFinalitat
emision-borrador-a-emitidaPassar un esborrany a factura emesa.
anular-o-rectificarTriar anul·lació o factura rectificativa.
tipos-de-facturaSeleccionar el tipus de factura.
lineas-e-importesPreparar línies, impostos i imports.
claves-de-regimenTriar claus de règim fiscal.
numeracion-de-seriesFer servir correctament les sèries de numeració.
validacion-de-nifValidar la identificació del comprador.
puertas-de-verifactuRevisar els requisits de VeriFactu.
multi-empresaSeleccionar el context d’empresa correcte.

Cinc prompts guiats

Nom del promptFinalitat
emitir_facturaPreparar i emetre una factura.
arreglar_factura_fallidaDiagnosticar una factura fallida.
alta_de_nifGuiar l’alta del NIF.
conectar_tiendaConnectar i configurar una botiga.
diagnosticar_pedido_no_facturadoInvestigar una comanda que no va produir cap factura.

Invoca prompts/get amb el nom rebut i els arguments declarats. No dedueixis els arguments del nom del prompt: consulta prompts/list. Per a conectar_tienda, estableix primer l’autorització del proveïdor i comprova els scopes de la teva API key. Per diagnosticar comandes, consulta l’esdeveniment d’integració i si admet reprocessament abans de crear un document manualment.

Resol un rebuig de les regles

mcp_guardrail_violation és un rebuig de negoci 422 amb rule_id, guardrail_uri i un subcodi a les dades de l’error. Llegeix el recurs indicat, corregeix la petició i conserva la política d’idempotència de l’operació prevista. Els prompts i recursos ajuden a preparar una crida vàlida; no eviten la validació, l’aïllament entre empreses ni els scopes.

En aquesta pàgina

Et donem un cop de mà?Contactar amb suport