Na čo rozhranie slúži
GraphQL je read-only doplnok REST API určený na flexibilné filtrovanie, projekcie a serverové reporty. MCP nad ním poskytuje nástroje pre AI klientov a na zápisy používa bezpečný draft-first postup cez REST API.
Endpointy a autentifikácia
POST /v1/graphql
GET /v1/graphql/schema.graphql
GET/POST /mcpGraphQL aj SDL používajú rovnakú autorizáciu ako REST Open API. MCP HTTP endpoint prijíma API kľúč v Bearer hlavičke alebo OAuth client credentials v Basic hlavičke.
Schéma a kompatibilita
Aktuálne úplné SDL je dostupné na uvedenom schema endpointe po prihlásení. Introspection zostáva zapnutá, pretože MCP klienti skladajú read-only dotazy dynamicky. Odstránenie alebo nekompatibilné zmeny polí vyžadujú novú verziu endpointu; zastarávajúce členy sa najprv označia direktívou @deprecated s uvedením náhrady.
Menový základ súm
Pri fakturačných dokladoch nie sú polia totalPrice a restToPay v rovnakej mene. totalPrice je hrubá suma vrátane DPH v domácej mene firmy, zatiaľ čo restToPay je v mene dokladu. Domácu neuhradenú sumu vracia restToPayHome; tú možno priamo porovnať s totalPrice. Pre agregované pohľadávky použite report reportUnpaidIssuedInvoices a pole remainingHomeAmount alebo totalHomeAmount.
Bezpečnostné limity
Schéma neobsahuje mutations ani subscriptions. Server obmedzuje hĺbku dotazu na 20, veľkosť stránky na 100 a cenu operácie na 10 000. MCP navyše odmietne zapisovaciu operáciu ešte pred volaním API.