Project

General

Profile

View source (English) EN RU ET LT LV Eesti
English Русский Lietuvių Latviešu

Wiki » 06 Prepared integration package and ERPs »

Source has been updated (v8), translation is from v7.

StandardBooks

00 Teha

  1. Lisa logistika käsiraamat API kaudu

01 Ülevaade

  1. Eesti suurima funktsionaalsusega äritarkvara. Raamatupidamine.
  2. https://www.excellent.ee/standard-books/
  3. Toetab 2doc, 4doc ja e-arve formaate.
  4. Excellenti algne juhend asub siin: https://www.excellent.ee/pdf/Docura_seadistamine_myyk.pdf

02 Seadistamine ERP-s

01 NB! Failide import/arhiveerimine/eksport tee

Docura mooduli aktiveerimiseks palume saata päring :

"Palun aktiveerida meie ettevõttele moodul "Failide import/arhiveerimine/eksport tee"."

Dokumentide XML-failide import ja eksport hakkab toimuma automaatselt läbi nende kaustade. Nende kaustade asukohad ja nimed on saadavad vaid Excellent konsultandilt.

02 Palun pange tähele:

a. Standard Books 8.5 või uuem versioon;
b. Standard Booksi moodulid "Müügihaldus" ja "Logistika";
c. Docura API võti: Seaded - Kasutajad - Lisa API kasutaja

NB! Standard Booksi uus versioon sisaldab järgmist täiendust: moodulisse Üldine > Seaded > EDI API seaded > Docura sakk on lisatud uus linnuke "Tellimuse impordil võta klient tarnekohast". See tähendab, et tarneaadresside asemel tuleb poed salvestada kontaktidena. Kui teil on vana versioon ja te ei soovi neid kirjeid käsitsi teha, saate tellida Excellentilt selle "ühe kliki lahenduse", võttes ühendust nende konsultandiga, arvestades 1-2 tundi Excellenti tööaega nende tunnitasu 95 EUR + käibemaks.

03 Üldine > Seaded > EDI API seaded, sakk "Docura"

04 Üldine > Seaded > E-teenuste seaded

Integratsiooni aktiveerimiseks ava moodul Üldine > Seaded > E-teenuste seaded ja vali tab "Muud teenused". Reas Docura EDI vajuta nupule Aktiveeri.

05 Müügiarved > Registrid > Artiklid

  1. Informatsioon toodete/kaupade kohta (artikli kood, GTIN/EAN-kood, toote nimetus, ühik jne) tuleb vahetada kliendiga ehk kauba ostjaga.
  2. Docura kaudu müüdavate/lähetatavate artiklite kaartidel peab olema valitud valik „Artikli tüüp = Laos hoitav artikkel“. See tähendab, et nende artiklite kohta peab pidama laoraamatupidamist ja laoseisu jälgima Standard Booksis.
  3. Artikli kaardil, kaardil „Retsept“ peab olema täidetud väli „EAN-kood“ või „Vöötkood“. Siia tuleb sisestada kauba GTIN-kood.
  4. Kui Teie ettevõte lähetab kaupu, millele tuleb määrata „Parim enne“ kuupäev, siis on oluline artiklikaartidel märkida „Seerianumbri jälgimine = Seerianumber/Partii nr.“ Tähelepanu, kui kasutate seda võimalust, siis peate alati laosisestuse ridadel täitma seerianumbri või partii numbri ja „Parim enne“ kuupäeva.
  5. Pakendite kohta luua eraldi artiklikaardid tüübiga „pakend“, vaata PDF juhendit.

06 Kontaktid

  1. Kontaktid on juriidilised isikud (ostjad/tarnijad).
  2. Klientide puhul, kellele saadetakse dokumente Docura kaudu, peab kontakti kaardil (vahelehel "E-andmevahetus") olema Kanali eelistus = "Docura".
  3. Klientide puhul, kellega toimub elektrooniliste saatelehtede vahetus, peab kontakti kaardil vahelehel "E-andmevahetus" olema lisaks Kanali eelistusele valitud valik "EDI Doc klient".

07 Müügihaldus > Seadistused > Saateaadressid

  1. Standard Booksis peaks olema üks peakontakt ja kõik nn laod/kauplused peaksid olema eraldi saateaadressid. Kuidas sisestada ühele kliendile mitu saateaadressi, vaata Excellent juhendist: https://www.excellent.ee/kasutajatugi/kuidas-saab-uhele-kliendile-sisestada-mitu-lahetusaadressi/
  2. Klientide erinevad saateaadressid ehk tarnekohad tuleb sisestada moodulisse Müügihaldus > Seadistused > Saateaadressid.
  3. Saateaadresse identifitseeritakse lisaks koodile ka GLN-koodiga.
  4. Docura süsteemis peavad olema samad koodid nagu Standard Booksis: BuyerParty > PartyCode on tellimusel olev kliendi kood ja DeliveryCode > PartyCode on tellimusel olev saateaadressi kood ehk nn kaupluse kood. Tellimusel on kaupluse kood Saateaadressi koodi väljal.
  5. XML väljad Party moodustatakse järgmiselt:
    1. Klient: BuyerParty/PartyCode
    2. Saateaadressi kood: DeliveryParty/PartyCode
    3. Tellimisaadressi kood: OrderParty/PartyCode
  6. NB! Veendu, et kontaktikood ("Klient") ja saateaadressi "Kood" ei kattuks.
  7. Kui klient on sisestatud kahel korral (nt A1M OÜ), otsib Standard Books tellimuse saabumisel vastet registrinumbri järgi. Nii leiab programm esimese kliendi kõige madalama kontaktikoodiga. Et leida siin õige klient, tuleks vale kontakt andmebaasis märkida suletuks või eemaldada selle registrinumber.
  8. Docura EDI mooduli aktiveerimiseks Standard Booksis peavad partnerid sisestama eraldi kõik kauplused, millel on saateaadressid.
  9. Saateaadresside kasutamine on korrektsete andmete edastamise üks eeltingimusi. Klient peaks lähtuma sellest, et tegemist on ühekordse seadistusega.
  10. Kui tellimuses on vale või puuduv info, satuvad tellimused Vigaste e-tellimuste registrisse. Mõned Telema kliendid saavad endiselt kasutada vana 2-dokumendi lahendust ja sellepärast on neil iga kauplus lisatud programmi eraldi kontaktina, kuid õige viis oleks kasutada saateaadresse.

Meie konsultant saab klienti abistada saateaadresside programmi korrektsel sisestamisel ja seadistamisel. Pärast seda saab klient Standard Booksis saateaadressid txt-failina eksportida; Docura keskkonda importimiseks tuleb fail vastavasse formaati kohandada.

08 Kontaktide ja tarneaadresside linkimine Docuras

  1. Igal kontaktil peab olema kood, mis tuleb Docuras partneri kaardil siduda "Juriidilise" aadressiga (st emaettevõttega).
  2. Igal tarneaadressil peab olema kood, mis tuleb Docuras partneri kaardil siduda kaupluse aadressiga.
    1. Juriidilist koodi saab kontrollida kaupluse/tarneaadressi kaardilt
    2. 12345 : Juriidiline kood
    3. 12345-1 : Tarnekood

09 Numbri seeriad (valikuline)

Kui kasutate numbri seeriaid, kontrollige, et need oleksid täidetud ka dokumentide jaoks, mida Docuraga vahetate. Vaadake PDF-juhendit.

NB! Numbri seeria vahemik võib otsa saada ka keset aastat, mitte ainult aastavahetusel. Kui vahemik ("Kuni" väli) saab otsa, ei saa uus dokument numbrit ja Docurast saabunud dokumenti ei impordita Standard Booksi. Sellisel juhul ilmub registrisse kaardike ilma numbrita, mis blokeerib ka järgmiste dokumentide liikumise. Mida sellises olukorras teha, vaadake KKK-st punkti "05 Tagastustellimus (RETANN) – numbri seeria on täis ja tagastustellimuse kasutamine".

Kontrollige, et numbri seeriad oleksid täidetud iga dokumenditüübi jaoks, mida Docuraga vahetate. Docuraga seotud registrite numbri seeriad asuvad enamasti:

  1. Müügihaldus > Seaded > Numbri seeriad - müügitellimused (ORDER);
  2. Logistika > Seaded > Numbri seeriad - tagastustellimused (RETANN) ja muud logistikaregistrid.

03 KKK

01 E-arve DepID vs DepId. DepID on kasutusel

Kui arve XML-is on element <DepId> (vastavalt Eesti e-arve standardile), kas see sobib teile või peaksime saatma selle Telema formaadi järgi, st <DepID>? Ja seda nii BuyerParty kui ka RecipientParty blokkides.

Saadetakse <DepID>

02 Allahindlus

Mida on vaja muuta, et Selveri tellimused ei läheks enam valede tellimuste hulka, sest hinnad pole õiged?

Teine küsimus: kuidas saab tellimusele määrata 10% allahindluse? See on koht, kus % on tellimuses.

Kuna meie klientidel on erinevad allahindlused, kas ma saan Selveri kaardile lisada ka 10% allahindluse? Nii et see lisatakse tootele automaatselt, kui toode on valitud?

Vastus:

Tõenäoliselt puudub teil kontaktkaardil müügimakse tähtaeg. Saate selle lisada Selveri kontaktkaardile, vahekaardil „Tingimused“, väljale „Müügimakse tähtaeg“.

Kui allahindlus -10% peaks tulema Docurast saadud XML-ist, siis tuleks muuta Üldine > Seaded > EDI API seaded, vahekaardil „Docura EDI“, valikut „Hinnad tellimustel“. Kui soovite, et programm arvestaks XML-is, st saadud tellimustes, olevaid hindu, siis peaksite valima valiku „Võta hinnad ja allahindlus alati kliendi tellimusest“ või „Kui Docurast saadud tellimuses pole hindu, võta hinnad programmist“.

Standard Booksi programmis on hinnakirjad.

Hinnakirju saab siduda Kliendi, Kliendiklassi, Maksetähtaja ja Arvega. Hinnakirjal saab näidata, millist hinnamuutuste valemit allahindlus või juurdehindlus järgib. Hinnakirjal, kus valemit pole näidatud, saab ise määrata, kuidas hindu muuta. Kui hinnakiri on kliendikaardile määratud, siis sellele kliendile arve koostamisel pakutakse kauba hindu hinnakirja alusel. Kliendikaardil oleval hinnakirjal on kõrgem prioriteet kui näiteks maksetähtajal määratud hinnakirjal. Arvel saab hinnakirja vajadusel muuta.

Saadan hinnakirjade seadistamise juhendi.

https://www.excellent.ee/kasutajatugi/kuidas-hinnakiri-koostada/

03 Saateleht, DESADV, partii number (LotNum) ja parim enne (BestBefore)

Küsimus:

Kuidas lisada Standard Booksis saatelehele (DESADV) LotNum (partii number), tootmiskuupäev (ProductionDate), BB (parim enne)?

Vastus:

Kui artiklikaardile on määratud "Seerianumbri jälgimine = Seerianumber või Partii number", siis lao sissetulekuga kaupu lattu võttes saab sisestada ka lahtri "Seerianumber/Partii number" ning vajadusel täita "Parim enne" lahtri. Nii on kaup laos koos seeria/partii numbri ja parim enne kuupäevaga.
https://www.excellent.ee/kasutajatugi/kuidas-maaratakse-toodetele-seerianumbrid/

Kui nüüd teha sellisele kaubale lähetus ehk saateleht, siis nõuab programm nende väljade täitmist ka B-tabil. Sealt jõuab info desadv XML-i. Olen lisanud ka ühe näite manusena.

<ItemReserve>
  <LotNum>31102024-150</LotNum>
  <BestBefore>2024-11-25</BestBefore>
  <ItemReserveUnit>
    <ItemUnit>KG</ItemUnit>
    <AmountActual>2.00</AmountActual>
  </ItemReserveUnit>
</ItemReserve>

Tootmiskuupäeva info jälgimiseks Standard Booksis välja puudub. Kui klient seda vajab, saame selle lisada eritarkvarana.

04 Uus aasta, aga tellimused ei jõua Standard Booksi süsteemi: mida teha?

Standard Booksi kasutaja peab kontrollima, kas programmi on lisatud uus majandusaasta ja uue aasta tellimuste numbriseeria: https://www.excellent.ee/kasutajatugi/majandusaasta-lopetamise-toimingud-programmis/

Sama probleem tekib ka siis, kui numbriseeria saab otsa keset aastat, mitte ainult aastavahetusel – vaata järgmist punkti "05 Tagastustellimus (RETANN)".

05 Tagastustellimus (RETANN) – numbriseeria on täis ja tagastustellimuse kasutamine

Sümptom: Docurast saadetud tagastustellimus (RETANN) programmi ei jõua. Docura poolelt dokument läks edukalt välja, kuid Standard Booksi logistika registrisse see ei teki. Tagastustellimuste registrisse on tekkinud 1 numberita kaart, sest selle registri numbriseeria on otsa saanud.

Põhjus: tagastustellimuste registri numbriseeria vahemik on täis (number “Kuni” väljal on otsa saanud), mistõttu dokument ei saa numbrit ja kaarti ei teki. Numberita kaart blokib ka kõikide järgnevate dokumentide liikumise. NB! Numbriseeria võib otsa saada ka keset aastat, mitte ainult aastavahetusel (vaata ka punkti „04 Uus aasta, aga tellimused ei jõua Standard Booksi süsteemi“).

Lahendus:

  1. Kontrolli numbriseeriat: Logistika > Seadistused > Numbriseeriad > Tagastustellimused – vaata, et vahemik ei ole lõppenud ja vajadusel suurenda „Kuni“ väljal olevat numbrit.
  2. Kustuta numberita kaart tagastustellimuste registrist:
    1. Logistika > Registrid > Tagastustellimused;
    2. kaart tuleb kindlasti kustutada, vastasel juhul ei hakka andmed liikuma ja ka järgnevad importimised ebaõnnestuvad.
  3. Kui numberita kaardi kustutamine ebaõnnestub, anna meile sellest teada – sel juhul tuleb kaart kustutada Excellent-i konsultandi abiga (, tel +372 669 1111). Kaart tuleb igal juhul eemaldada, et andmed hakkaksid liikuma.
  4. Anna Docurasse teada, millal järgmine tagastustellimus Docurast saadetakse, ja kontrolli, kas see jõudis tagastustellimuste registrisse.
  5. Ennetus: hoia numbriseeriate vahemikud piisavalt suured ja kontrolli neid ka keset aastat, mitte ainult aastavahetusel.

Tagastustellimuse kasutamine: programmi jõudnud tagastustellimusest saab luua Koosta > Tagastatud kauba ja selle alusel kaup lattu tagasi võtta (laoseis uueneb).

Sama vealoogika kehtib ka teiste Docuraga vahetatavate dokumenditüüpide puhul (näiteks müügitellimus ORDER) – vaata punkti „04 Uus aasta, aga tellimused ei jõua Standard Booksi süsteemi: mida teha?“ ja „02 Seadistamine ERP-s > 09 Numbriseeriad (valikuline)“.

Kasutatud juhendid:

  1. Excellent-i juhend Docura kasutamise kohta (tagastustellimus, lk 10): https://www.excellent.ee/pdf/Docura_kasutamine_myyk.pdf#page=10
  2. Majandusaasta lõpetamise toimingud: https://www.excellent.ee/kasutajatugi/majandusaasta-lopetamise-toimingud-programmis/

Source version: 7 · Status: stale · Roman Startsev