Šifra, EAN in enota
Določimo glavni identifikator, obravnavo različic, aktivnost, mersko enoto in polja, ki jih je dovoljeno posodabljati.
SAOP iCenter · tehnična priprava
SAOP iCenter API: kaj potrebujete pred integracijo?
SAOP iCenter je mogoče povezovati z zunanjimi sistemi prek njegovega API-ja, vendar se izvedljivost ne določi samo po seznamu želja. Preveriti moramo dejansko namestitev, licenco, omogočene module, uporabniške pravice, razpoložljive metode in podatkovne šifrante.
Uradni programski vmesnik
Kaj SAOP iCenter API omogoča?
API je nadzorovan način, da zunanja aplikacija bere ali zapisuje podatke v iCenter brez ročnega prepisovanja. Javna SAOP pomoč in dokumentacija prikazujeta metode za različne poslovne objekte, med drugim za artikle, cene, stranke, naročila in dokumente. To ne pomeni, da so vse metode na voljo ali primerne v vsaki namestitvi.
Tehnični vmesnik uporablja XML podatke, pri katerih je treba upoštevati zahtevano strukturo in kodiranje. Integracijska aplikacija zato podatke iz spletne trgovine, datoteke ali drugega API-ja najprej preveri in pretvori v obliko, ki jo pričakuje konkretna SAOP metoda. Odgovor API-ja se zabeleži in vsebinsko preveri, ne samo tehnično sprejme.
Dokumentacijo vedno odpremo na naslovu dejanskega naročnikovega okolja. Javni primer je orientacija, ne dokaz, da je ista metoda omogočena tudi pri naročniku.
Kontrolni seznam
Katere dostope in podatke potrebujemo?
Za varen predtest potrebujemo ločenega tehničnega uporabnika z najmanjšimi pravicami, ki še omogočajo dogovorjeno delo. Razvoj z administratorskim računom po elektronski pošti ni dobra praksa. Dostop, geslo ali drug skrivni podatek se posreduje po dogovorjenem varnem kanalu in se ne zapisuje v javno dokumentacijo ali dnevnik.
- osnovni URL iCenter API-ja in dostop do dokumentacije ali Swagger prikaza
- podatek o različici iCentra, nameščenih modulih in API licenci
- šifra organizacije ter ločen testni uporabnik z ustreznimi pravicami
- omrežni dostop, dovoljen naslov strežnika ali VPN, če je zahtevan
- izbrane knjige naročil, skladišča, ceniki, poslovalnice in stroškovna mesta
- davčne kode, enote mere, načini plačila, dostave in drugi uporabljeni šifranti
- realni primeri artikla, stranke, naročila, popusta in dokumenta
- oseba, ki rezultat preveri neposredno v iCentru
Pred ponudbo in razvojem
Vsak načrtovani tok preverimo z majhnim, nadzorovanim testom.
Prvi test je prijava in branje enega znanega zapisa. Tako preverimo povezljivost, pravice, strukturo odgovora, straničenje in identifikatorje. Pri podatkih, ki jih želimo zapisovati, pripravimo ločen testni primer v pravilni knjigi ali organizaciji. Pred zapisom se z naročnikom dogovorimo, kako se testni dokument označi in pozneje obravnava.
Pri naročilu ni dovolj, da API vrne uspešen odgovor. V iCentru je treba preveriti glavo, partnerja, postavke, cene, popuste, davek, skladišče, način plačila, dostavo, opombe in morebitne zaokrožitve. Pri cenah in zalogi primerjamo izvorno vrednost z vrednostjo, ki jo bo prejela trgovina.
- 01
Bralni test
Preberemo znan artikel, ceno, stranko ali dokument in primerjamo rezultat z iCentrom.
- 02
Pregled šifrantov
Potrdimo kode, ki jih mora integracija uporabljati za knjige, davke, enote, plačila, dostavo in skladišča.
- 03
Omejen zapis
Ustvarimo ali spremenimo en testni zapis z vnaprej potrjenimi podatki in ga preverimo v programu.
- 04
Test napake
Namerno uporabimo manjkajočo ali napačno vrednost ter preverimo, da je napaka razumljivo zabeležena in zapis ni podvojen.
- 05
Potrditev izvedljivosti
Šele nato v končno specifikacijo vključimo metode in polja, ki so na dejanskem okolju uspešno preverjeni.
Poslovni pomen podatkov
Polja med sistemoma se redko ujemajo brez pravil.
Shopify, druga spletna trgovina ali zunanji katalog uporabljajo svoje identifikatorje in poimenovanja. SAOP uporablja svoje šifre artiklov, partnerjev, knjig, skladišč in davčnih nastavitev. Integracija zato potrebuje potrjeno tabelo preslikav. SKU je lahko glavni ključ za artikel, vendar mora biti v obeh sistemih enoličen in nespremenljiv.
Partnerja lahko iščemo po dogovorjeni kombinaciji davčne številke, e-pošte ali interne oznake. Pravilo mora povedati, kdaj se obstoječi partner posodobi in kdaj se ustvari nov. Tudi statusi niso nujno enaki: stanje v pripravi, odpremljeno ali stornirano se preslika samo, če ima na obeh straneh jasen poslovni pomen.
Cenik, datum in skladišče
Izberemo točen cenik, davčno obravnavo in skladišče. Več skladišč ali cenikov zahteva dodatna pravila.
Knjiga in poslovni šifranti
Potrdimo knjigo dokumentov, partnerja, postavke, popuste, dostavo, plačilo, davek, opombe in zunanjo referenco.
Zanesljivo izvajanje
Vmesna baza in dnevnik varujeta pred izgubo ter podvajanjem.
Namenska aplikacija shrani povezavo med zunanjim identifikatorjem in identifikatorjem v SAOP-u, čas zadnje uspešne obdelave, kontrolni podpis pomembnih podatkov ter odgovor API-ja. S tem lahko ob ponovitvi preveri, ali je bilo naročilo že zapisano, in pri začasni nedosegljivosti nadaljuje iz čakalne vrste.
Kontrolna plošča pokaže stanje povezave, zadnje zagone, število uspešnih, preskočenih in neuspešnih zapisov ter kratek opis napake. Ne sme prikazovati gesel ali celotnih občutljivih odgovorov. Ročni zagon in varen ponovni poskus sta namenjena nadzoru integracije, ne urejanju celotnega iCentra.
Neposreden dostop do podatkovne baze uporabimo le, če ga ponudnik in naročnik izrecno dovolita ter je tehnično utemeljen. Prednost ima uradni API, ker bolje varuje poslovna pravila sistema.
Realna pričakovanja
Kaj lahko spremeni obseg ali onemogoči posamezno funkcijo?
- metoda ni vključena v različico, modul ali licenco dejanskega okolja
- tehnični uporabnik nima potrebnih pravic ali strežnik ni omrežno dosegljiv
- API omogoča branje, ne pa tudi zahtevanega ustvarjanja ali spreminjanja
- obvezni šifranti ali poslovne nastavitve niso pripravljeni
- identifikatorji artiklov in partnerjev niso enolični ali se spreminjajo
- zahtevani dokument nastaja v drugem procesu in ga API še ne more vrniti
- količina podatkov ali odzivni čas zahtevata paketno obdelavo in daljši začetni uvoz
Če predtest pokaže omejitev, jo zapišemo pred razvojem. Predlagamo manjši obseg, drugačen tok ali ločeno nadgradnjo, ne pa funkcije, ki je ni mogoče zanesljivo prevzeti.
Pogosta vprašanja
Najpogostejša vprašanja o SAOP API pripravi.
Možnosti vedno preverimo na konkretnih sistemih, licencah, dostopih in vzorčnih podatkih.
Ali je javni SAOP Swagger dovolj za izdelavo integracije?
Ne. Pokaže možne metode in modele, preveriti pa je treba dokumentacijo, različico, module, licenco in pravice konkretne naročnikove namestitve.
Ali lahko integracija neposredno zapisuje naročila v SAOP?
Če dejanska namestitev omogoča ustrezno metodo in so pripravljeni vsi obvezni šifranti. Pred vključitvijo izvedemo omejen zapis ter poslovno preverjanje rezultata v iCentru.
Zakaj potrebujete realne vzorčne dokumente?
Dokumentacija opiše strukturo, vzorci pa pokažejo dejansko uporabo knjig, davkov, popustov, skladišč in posebnih pravil podjetja. Brez njih preslikava ni dovolj zanesljiva.
Ali potrebujemo testno okolje?
Če je na voljo, ga uporabimo. Če ga ni, se z naročnikom dogovorimo za strogo omejene in jasno označene teste v produkciji ter za način preverjanja in odstranitve testnih posledic.
Ali je mogoče prenašati samo spremenjene zapise?
Pogosto da, kadar metoda zagotavlja zanesljiv čas spremembe, straničenje ali drug ustrezen filter. Konkretno možnost preverimo na vključeni metodi in dodamo periodično kontrolno uskladitev.
Začetni tehnični pregled
Pošljite povpraševanje