REST API med authentification (username + usertoken)
- Priser
- Lagertal
- Leveringsadresser
- Login
Vi anbefaler at der oprettes en dedikeret bruger til formålet for at hindre at funktionen forsvinder såfremt en ansat i virksomheden stopper. Bemærk at brugeren ikke selv kan angive en ”UserToken”. Denne oprettes af os.
REST API uden authentification
- Stamdata på varenummer
Filudveksling
- Lagertal i CSV format
- Prisfiler i CSV format
- Productfeed i XML format
REST API med authentification (username + usertoken)
Priser
/api/UserToken/GetPrices?userName=[UserName]&userToken=[UserToken]&productNumbers=[ItemNumber]
Priser må hentes ved aktuelt behov for at præsentere prisen for en enkelt eller et mindre antal varer. Det er ikke tilladt at crawle for alle priser eller lave store schedulerede kørsler.
Priser skal gemmes i en lokal cache og prisen må kun hentes én gang pr. vare pr. konto pr. døgn.
Under normale omstændigheder ændres priser kun én gang i døgnet (Kl: 00:00).
Bemærk at prisen som standard hentes ud fra den aftale der er tilknyttet hovedkontoen. Såfremt der ønskes priser fra en anden konto anvendes funktionen ”Skift priskonto”.
Såfremt der ønskes en samlet prisliste over vores produkter kan disse fx hentes via denne side: https://ao.dk/mit-ao/filer/andre-formater
Vi har mulighed for at lave yderligere tilpassede formater, men anbefaler typisk at der benyttes formatet AOEXPORT, da indeholder den data der oftest efterspørges.
Kodeeksempel:
Svar:
Normal vare
[{
"RabatVaerdiVarerabat":170.52,
"RabatVaerdiOnline":2.35,
"RabatProcentVarerabat":42.00,
"RabatProcentOnline":1.00,
"Rabat":170.52,
"OnlineRabat":2.35,
"ErVejledende":false,
"Listepris":406.00,
"Varenr":"614541600",
"DinPris":233.13,
"Afgifter":0.0,
"ErKampagnepris":false,
"ErDiscount":false,
"Avance":0.0,
"Udsalgspris":0.0
}]
Kampagnevare
[{
"RabatVaerdiVarerabat":0.0,
"RabatVaerdiOnline":0.0,
"RabatProcentVarerabat":0.0,
"RabatProcentOnline":0.0,
"Rabat":0.0,
"OnlineRabat":0.0,
"ErVejledende":false,
"Listepris":1395.00,
"Varenr":"601021200",
"DinPris":1395.00,
"Afgifter":0.0,
"ErKampagnepris":true,
"ErDiscount":false,
"Avance":0.0,
"Udsalgspris":0.0
}]
Bemærk: Såfremt varen er på kampagne returneres denne pris som ”Listepris”.
Lagertal
/api/lager/hentlagertal?userName=[UserName]&userToken=[UserToken]&productNumbers=861730100;018814040
Lagerbeholdninger bør kun hentes efter behov og der må ikke crawles. Som udgangspunkt må der ikke hentes mere end 50 lagertal af gangen.
Kodeeksempel
Svar:
De interessante dele af svaret er markeret.
- ”Maalingsenhed” = salgsenhed
- ”CentralAntalPaaLager” er den beholdning der er muligt at levere på næstkommende leveringdag.
- ”CentralLagerStatus” : 1 = Lagerført vare, 2 = Vare med længere leveringstid
- ” CentralLeveringsdage” antal leveringsdage på varer med status 2.
[{
"Varenr":"601021200",
"Maalingsenhed":"stk",
"CentralLager":"Centrallageret",
"CentralAntalPaaLager":414.000000,
"CentralLeveringsdage":"1",
"CentralErVejledende":false,
"IsFromDk":false,
"CentralLagerStatus":1,
"DitLager":"460",
"DitAntalPaaLager":8.000000,
"DitLeveringsdage":"1",
"DitErVejledende":false,
"DitLagerStatus":1,
"CombinedStock":0.0,
"ErLagerfortPaaCentral":true,
"ErLagerfortPaaDinButik":true,
"KunLagerfoertPaaHorsensOgDeadlineOverskredet":false
}]
Leveringsadresser
/api/UserToken/GetAddressesForAccount?kontonummer=[kontonummer]&username=[UserName]&userToken=[UserToken]
Via dette endpoint hentes de leveringsadresser der er registreret pr. konti hos AO. Ved oprettes af ordrer via fx. EDI eller webservices bør der altid anvendes korrekt addresseID ved faste leveringsadresser for at sikre at leveringsaftaler overholdes af distributøren.
Disse adresseID'er kan hentes her.
Login
/api/UserToken/Login?UserName=[UserName]&UserToken=[UserToken]&ReturnUrl=https://ao.dk/services (Optional)
Via dette endpoint kan der foretages et login på AO.dk evt. med automatisk redirect til en ønsket side.
REST API uden authentification
Stamdata på specifikt varenummer:
For at læse stamdata på et specifikt varenummer kan denne læses med nedenstående API:
https://ao.dk/api/Soeg/EnkeltProdukt?varenr=601021200
hvor 601021200 er vores varenummer.
API’et returnerer en masse stamdata på det angivne varenummer, hvorimod det returnerer ”null” på et ugyldigt varenummer såsom https://ao.dk/api/Soeg/EnkeltProdukt?varenr=601021XXX
Alle varer - Generelt varestamdata:
Såfremt der ønskes en samlet (pris)liste over vores produkter kan disse fx hentes via denne side: https://ao.dk/mit-overblik/filer
Vi har mulighed for at lave yderligere tilpassede formater, men anbefaler typisk at der benyttes formatet AOEXPORT, da indeholder den data der oftest efterspørges.
Alle varer - Udvidet varestamdata
Hvis der ønskes adgang til ALT vores varestamdata (som deles med 3. part) er det muligt at hentes dette via vores eksterne productfeed. Dette er dog typisk kun relevant i forbindelse med Webshop hvor der er behov for beskrivelser, dokumenter etc.
Læs mere her: https://ao.dk/services/digitale-muligheder/integrationer/productfeed
Erfaringen er at der er en overordentlig kompleks sag at gå i gang med, og det anbefales ikke medmindre det er bydende nødvendigt.
Filudveksling
Lagertal:
Vores aktuelle lagertal kan hentes via dette link:
https://ao.dk/services/digitale-muligheder/integrationer/hent-lagertalbeholdninger
Prisfiler
Hvis du ønsker en samlet prisliste over vores produkter kan disse fx hentes via denne side: https://ao.dk/mit-overblik/filer