Bygg på Flow. Eller la agenten gjøre det.
Et REST-API med over 500 endepunkter, beskrevet i OpenAPI og skrevet for å leses av både mennesker og AI-agenter. Gi agenten én lenke, så har den det den trenger. API-tilgang følger med fra Flow Pro.
- 500+
- endepunkter
- OpenAPI 3.0
- uten innlogging
- Stage
- og produksjon
- Webhooks
- med nye forsøk
$ curl https://api.flowretail.com/v2/tenants/{tenantUid}/products?pageSize=2 \ -H "Authorization: Bearer $FLOW_TOKEN" { "items": [ { "productUid": "regnjakke-fjell-m", "name": "Regnjakke Fjell, str. M", "recommendedRetailPrice": 129900 }, // 1 299,00 … ], "paging": { "totalCount": 1284, "pageNumber": 1, "pageSize": 2 } }
Inngangene agenten trenger
Dokumentasjonen og API-et er laget for å leses av en AI-agent like mye som av deg. Spesifikasjonen hentes fra API-et selv, krever ingen innlogging og lages på nytt ved hver utrulling.
Lim lenken inn i Claude Code, Cursor, Copilot eller en annen agent som kan hente nettsider.
Den eneste fasiten for felt og endepunkter. Stage har sin egen /spec.
Hele dokumentasjonen samlet, klar til å legges i agentens kontekst.
Oversikt over alle sidene, så agenten kan hente bare det den trenger.
…/<side>.mdLegg .md på slutten av adressen til en dokumentasjonsside.
…/<side>.md?ask=<spørsmål>Still et spørsmål til en side og få svaret tilbake som tekst.
https://api.flowretail.com/v2Hver forespørsel har Authorization: Bearer <token>. Mellom systemer brukes et integrasjonstoken fra Flow Admin.
https://api.stage.flowretail.com/v2Bygg mot stage først.
Alle endepunktene, med eksempler, for deg som leser selv. MCP med lesetilgang til Flow Retail er i pilot. Spør oss om du vil prøve den.
Én prompt, riktige kall fra første linje
Prompten ber agenten lese dokumentasjonen og spesifikasjonen først, og følge reglene den ellers ofte tar feil av. Kopier den inn i agenten før den skriver kode.
Les hele guiden for AI-agenter (åpnes i ny fane)Integrasjonspartnere får gratis og ubegrenset hjelp fra utviklerne våre, også på Slack. Ta med logId fra feilen når du spør. integration@flowretail.no
Read https://docs.flowretail.com/docs/llms-full.txt and fetch the OpenAPI spec
from https://api.flowretail.com/v2/spec before writing any code.
Flow Retail API rules you must follow:
- Base URL https://api.flowretail.com/v2, auth via `Authorization: Bearer <token>`.
- All amounts, percentages and quantities are integers with two implied
decimals. 1299 means 12.99. Never send a float.
- Identifiers end in Uid and are strings.
- Clear text and Uid fields with ""; clear date fields with null.
- List responses are { items, paging } with totalCount/pageNumber/pageSize.
- Errors are { code, message, logId }. Branch on code, never on message.
- Orders, receipts and tills are under /tenants/{tenantUid}/stores/{storeUid}/.
Products, price lists and customers are under /tenants/{tenantUid}/.
- Use the batch endpoints for stock and prices.
- Webhooks carry references only. Acknowledge within 10 seconds, deduplicate
on jobId, and fetch the entity before acting.
- Verify every endpoint and field against the spec. Do not invent either.Sju regler agenter oftest tar feil av
Les dem før du, eller agenten, skriver kode. De står også i prompten over.
- 1
Beløp er heltall med to desimaler
Ingen desimaltall i API-et. Gang med 100 på vei inn, del på 100 på vei ut, og rund av selv.
1299 = 12,99 250 = 2,50 % 150 = 1,50 stk - 2
ID-er slutter på Uid og er tekst
Et felt som peker på noe annet, bruker navnet til det det peker på. Virksomheten heter tenantUid i adressene.
productUid, ikke productId - 3
Tøm et felt etter type
Tekst og valgfrie Uid-felt tømmes med tom tekst. Datofelt tømmes med null.
tekst: "" dato: null - 4
Lister har items og paging
Ingen markør og ingen neste-lenke. Standard sidestørrelse er 1000, så sett den med vilje.
siste side når items.length < pageSize - 5
Feil har tre felt
Velg vei etter code, aldri etter message, som kan være oversatt. Ta vare på logId og oppgi den til support.
{ "code", "message", "logId" } - 6
Adressen bestemmer omfanget
Varer, prislister og kunder ligger under kunden. Ordre, kvitteringer og kasser ligger under butikken. Lager ligger under et lager i en butikk.
/tenants/{tenantUid}/stores/{storeUid}/… - 7
Bruk batch for lager og priser
Lager tar opptil 1000 rader per kall, alt eller ingenting. Priser kan opprettes, endres og slettes i samme kall.
PUT …/warehouses/{warehouseUid}/stock/batch
Få beskjed når noe skjer
Systemet ditt slipper å spørre gang på gang. Fire ting er verdt å vite.
- 1
Svar innen 10 sekunder
Kommer det ikke svar innen 10 sekunder, regnes hendelsen som levert. Svar med 200 eller 202 med en gang, og gjør jobben fra din egen kø.
- 2
Nye forsøk i to døgn
Ved nettverksfeil, 429 og 5xx prøver Flow igjen opptil 30 ganger over omtrent to døgn. Dedupliser på jobId.
jobId, attempt - 3
Bare referanser
Hendelsen sier hva som endret seg (Id og Uid), ikke den nye tilstanden. Hent saken fra API-et før du gjør noe.
- 4
Avstem med jevne mellomrom
Noen hendelser sendes ikke, som nye ordre, parkerte ordre som utløper, og sletting. Hent listene jevnlig for å fange dem.
«Integrasjonen av SAP og Flow har vært knirkefri. Siden plattformen er API-first, har du tilgang til alle endepunktene du trenger. Og dukker det opp spørsmål, står utvikler- og supportteamet klart til å hjelpe.»
Axel Lindeberg, SAP-integrasjonsspesialist Eplehuset
Les om EplehusetKlar til å bygge? Start mot stage i dag.
API-tilgang følger med fra Flow Pro. Spør oss om tilgang til stage og et integrasjonstoken.