K čemu rozhraní slouží
GraphQL je read-only doplněk REST API určený pro flexibilní filtrování, projekce a serverové reporty. MCP nad ním poskytuje nástroje pro AI klienty a pro zápisy používá bezpečný draft-first postup přes REST API.
Endpointy a autentizace
POST /v1/graphql
GET /v1/graphql/schema.graphql
GET/POST /mcpGraphQL i SDL používají stejnou autorizaci jako REST Open API. MCP HTTP endpoint přijímá API klíč v Bearer hlavičce nebo OAuth client credentials v Basic hlavičce.
Schéma a kompatibilita
Aktuální úplné SDL je dostupné na výše uvedeném schema endpointu po přihlášení. Introspection zůstává zapnutá, protože MCP klienti skládají read-only dotazy dynamicky. Odstraňování nebo nekompatibilní změny polí vyžadují novou verzi endpointu; zastarávající členy se nejdříve označí direktivou @deprecated s uvedením náhrady.
Měnový základ částek
U fakturačních dokladů nejsou pole totalPrice a restToPay ve stejné měně. totalPrice je hrubá částka včetně DPH v domácí měně firmy, zatímco restToPay je v měně dokladu. Domácí neuhrazenou částku vrací restToPayHome; tu lze přímo porovnat s totalPrice. Pro agregované pohledávky použijte report reportUnpaidIssuedInvoices a pole remainingHomeAmount nebo totalHomeAmount.
Bezpečnostní limity
Schéma neobsahuje mutations ani subscriptions. Server omezuje hloubku dotazu na 20, velikost stránky na 100 a cenu operace na 10 000. MCP navíc odmítne zápisovou operaci ještě před voláním API.