Stranke in naročila
Prenesejo se podatki, ki so v naročilu dejansko prisotni in potrebni za dogovorjen dokument. Pravilo določi, kdaj partnerja poiščemo, posodobimo ali ustvarimo.
Minimax · spletna trgovina · avtomatizacija
Minimax API integracija s spletno trgovino brez ročnega prepisovanja.
Povezava lahko iz spletne trgovine v Minimax prenaša dogovorjene poslovne podatke in po potrebi vrača podatke, ki jih Minimax API dejansko omogoča prebrati. Obseg določimo šele po preverjanju organizacije, licence, dovoljenj, dokumentnih tokov in vzorčnih podatkov.
Najprej poslovni proces
Kaj naj povezava naredi po prejemu naročila?
Spletne trgovine imajo naročila, Minimax pa več vrst poslovnih dokumentov in pravil njihovega knjiženja. Zato izraz prenos naročila še ne določa rezultata. Naročnik in računovodstvo morata potrditi, kateri dokument se ustvari, v katerem poslovnem letu in organizaciji, s katerimi nastavitvami ter kdo ga pozneje pregleda ali izda.
V prvi fazi je smiselno avtomatizirati en dobro opredeljen tok. Integracija na primer prenese nova plačana naročila, ustvari ali poveže stranko, poveže postavke z artikli in zapiše dokument. Vračila, dobropisi, delne dobave, več skladišč ali več organizacij so ločeni procesi in jih ne vključimo samodejno brez specifikacije.
Artikli in šifranti
Postavko povezujemo z Minimax artiklom prek enolične šifre. Samodejno ustvarjanje manjkajočih artiklov vključimo le, če so določena vsa obvezna polja.
Povratni podatki
Status, številka dokumenta ali drug podatek se lahko vrne v trgovino samo, če ga je mogoče zanesljivo prebrati in smiselno preslikati.
Uradni dostop
Minimax API uporablja pooblaščenega odjemalca in dovoljenje uporabnika.
Uradna navodila Minimax opisujejo API in prijavo OAuth 2.0. Za namensko povezavo potrebujemo registriranega odjemalca, pravilno povratno povezavo ter odobritev uporabnika, ki ima dostop do izbrane organizacije. Skrivni podatki se hranijo šifrirano oziroma izven javnega dela strani in se nikoli ne izpisujejo v dnevnik.
Pred razvojem preverimo pridobitev ter varno obnavljanje dostopa, seznam organizacij in po eno bralno metodo za zahtevane podatke. Nato na testnem ali dogovorjenem omejenem primeru preverimo zapis. Nabor virov in polj se lahko spremeni, zato uporabljamo aktualno dokumentacijo ter modele dejanskega okolja, ne starih primerov kode.
- uporabnik Minimax z dostopom do pravilne organizacije
- registracija API odjemalca in dogovorjen varen način avtorizacije
- potrjena organizacija, poslovno leto in vrsta ciljnega dokumenta
- realni vzorci spletnega naročila ter ustreznega zapisa v Minimaxu
- seznam zahtevanih API operacij in najmanjše potrebne pravice
- kontakt računovodstva za preverjanje davkov, dokumenta in knjiženja
Podatkovna specifikacija
Kaj se bere, obdeluje in zapisuje?
Iz trgovine običajno preberemo identifikator in številko naročila, datum, valuto, stanje plačila, kupca, naslova, davčne podatke, postavke, količine, cene, popuste, davek, dostavo, način plačila in opombe. Prenesemo samo podatke, ki jih cilj potrebuje in jih sme prejeti.
V vmesni aplikaciji se vrednosti normalizirajo in preslikajo. Šifra države, davčna stopnja, merska enota, način plačila, dostava ter artikel morajo dobiti ustrezno vrednost v Minimaxu. Če preslikava manjka, je varneje naročilo zadržati za pregled kot ustvariti vsebinsko napačen dokument.
- enolična zunanja referenca naročila za zaščito pred podvajanjem
- pravilo za iskanje kupca po davčni številki, e-pošti ali drugi oznaki
- povezava SKU-ja trgovine s šifro artikla v Minimaxu
- preslikava davčnih stopenj in preverjanje cen z ali brez DDV-ja
- posebna postavka ali artikel za strošek dostave in druge dodatke
- obravnava popustov, kuponov, zaokrožitev ter manjkajočih podatkov
- pravila za fizične osebe, podjetja in davčne zavezance
Vmesna aplikacija
Čakalna vrsta omogoča varen ponovni poskus.
Dogodek iz trgovine ali redni urnik ustvari opravilo. Aplikacija shrani osnovni identifikator in preveri, ali je bilo naročilo že uspešno obdelano. Nato prebere celoten zapis, izvede validacijo ter ga pripravi za Minimax. Po uspešnem odgovoru shrani Minimax identifikator in rezultat, po začasni napaki pa opravilo ostane v vrsti.
Kontrolna plošča pokaže čas zadnjega uspešnega prenosa, rezultate zagonov, število uspešnih, preskočenih in neuspešnih zapisov ter razumljiv razlog napake. Omogoča ročni zagon in varen ponovni poskus. Osnovna plošča ni namenjena spreminjanju računovodskih dokumentov ali zamenjavi Minimax uporabniškega vmesnika.
- 01
Zajem
Novo ali izbrano naročilo dobi enolično opravilo in se postavi v čakalno vrsto.
- 02
Validacija
Preverijo se kupec, SKU-ji, zneski, davki, valuta ter obvezni podatki ciljnega dokumenta.
- 03
Preslikava
Vrednosti trgovine se pretvorijo v potrjene Minimax identifikatorje in strukturo.
- 04
Zapis
Aplikacija izvede dovoljeno API operacijo ter shrani tehnični in poslovni rezultat.
- 05
Nadzor
Napaka se razvrsti, začasen primer se ponovi, vsebinski primer pa čaka na popravek ali odločitev.
Prevzemni primeri
Testni seznam mora predstavljati resnična naročila.
Pred produkcijo preverimo vsaj fizično osebo, podjetje, davčnega zavezanca, več postavk, popust, kupon, strošek dostave, različne davčne stopnje, že obstoječega kupca in manjkajoč SKU. Znesek dokumenta primerjamo z naročilom po postavkah, davku in zaokrožitvah.
Ponovimo isti dogodek in potrdimo, da ne nastane podvojen dokument. Preverimo tudi prekinjen dostop, potečen žeton, začasno nedosegljiv API in zavrnjen vsebinski zapis. Produkcijo vključimo postopno, prve prenose pa skupaj z naročnikom preverimo v trgovini in Minimaxu.
Sinhronizacijo zaloge, računov, dobropisov ali drugih dodatnih tokov vključimo le, ko so zahtevani poslovni proces, API operacije in prevzemni primeri ločeno potrjeni.
Brez praznih obljub
Od česa je odvisen dejanski obseg?
- funkcionalnosti in pravic izbranega Minimax paketa ter organizacije
- trenutno podprtih objektov, operacij in polj v uradnem API-ju
- vrste dokumenta ter računovodskih nastavitev naročnika
- kakovosti SKU-jev, davčnih podatkov in drugih šifrantov
- možnosti spletne trgovine za dogodke, branje ter povratni zapis
- količine podatkov in omejitev obeh API-jev, ki vplivajo na paketno obdelavo
- posebnih primerov, kot so vračila, dobropisi, več valut ali več organizacij
Pogosta vprašanja
Odgovori pred Minimax API integracijo.
Možnosti vedno preverimo na konkretnih sistemih, licencah, dostopih in vzorčnih podatkih.
Ali se lahko vsako spletno naročilo samodejno prenese v Minimax?
Da, če je jasno določen ciljni dokument, so podatki veljavni in zahtevano operacijo podpira dejanski API. Neveljavni ali nepopolni primeri se zadržijo za pregled.
Ali integracija samodejno izda in davčno potrdi račun?
Ne privzeto. Prenos naročila, ustvarjanje dokumenta, izdaja računa in davčno potrjevanje so različni poslovni koraki. Vključimo samo korake, ki so izrecno dogovorjeni in tehnično preverjeni.
Kako preprečite podvojene dokumente?
Vmesna baza shrani zunanjo referenco naročila, stanje obdelave in Minimax identifikator. Pred ponovnim zapisom aplikacija preveri že uspešen rezultat.
Ali lahko povežete tudi WooCommerce ali drugo trgovino?
Da, če trgovina omogoča zanesljiv dostop do potrebnih podatkov in dogodkov. Minimax del ostane ločen modul, vhodni modul pa se prilagodi konkretni platformi.
Ali je mogoče pozneje dodati nove tokove?
Da. Modularna zasnova omogoča nadgradnje, vendar se zaloga, računi, dobropisi, vračila ali dodatne organizacije specificirajo, preverijo in ocenijo takrat, ko so dejansko potrebni.
Začetni tehnični pregled
Pošljite povpraševanje