Integracijos / ERP / Xero
Xero integravimo vadovas gamybos tvarkaraščiams sudaryti su SkyPlanner APS
Šiame Xero integravimo vadove Xero patarėjams, konsultantams ir IT komandoms paaiškinama, kaip sujungti Xero su SkyPlanner APS. SkyPlanner keičiasi duomenimis su Xero abiem kryptimis per Xero Accounting API ir Projects API:
- Į SkyPlanner perduodami kontaktai, prekės, kurių atsargos apskaitomos, su turimais kiekiais, priimti komerciniai pasiūlymai ir pirkimo užsakymai su numatomomis gavimo datomis.
- Planuojama užbaigimo data grąžinama į Xero kaip pastaba kiekvieno komercinio pasiūlymo istorijoje.
- Užbaigti užsakymai grąžinami į Xero kaip pardavimo sąskaitų faktūrų juodraščiai su komercinio pasiūlymo eilutėmis ir Reference reikšme, o pasiūlymo būsena pakeičiama į Invoiced.
- Užregistruotos projekto darbų valandos grąžinamos kaip Xero Projects laiko įrašai.
- Xero įvykių pranešimai informuoja apie kontaktų ir sąskaitų faktūrų pakeitimus, o SkyPlanner įvykių pranešimai perduoda tvarkaraščio pakeitimus vos jiems įvykus.
Xero yra apskaitos programinė įranga, todėl joje nėra gaminių komplektavimo žiniaraščių, technologinių maršrutų, įrenginių ar gamybos užsakymų. Darbo centrai, proceso etapai, pamainos ir paruošimo laikai tvarkomi SkyPlanner. Diegimo metu SkyPlanner komanda sukonfigūruoja integraciją su jūsų Xero organizacija ir ją palaiko pradėjus naudoti. Šis vadovas skirtas patarėjams ir programuotojams, kurie nori dalyvauti šiame darbe arba patys kurti sprendimus naudodamiesi dokumentuota SkyPlanner REST API (API žinynas).
Xero Accounting API
Xero yra vienas debesijos produktas, aptarnaujantis daug organizacijų, ir visos jos naudoja tą pačią API. Accounting API yra REST API, pasiekiama adresu https://api.xero.com/api.xro/2.0/ ir palaikanti JSON arba XML. Kiekvienoje užklausoje organizacija nurodoma antraštėje Xero-tenant-id. (Šaltinis)
Gamybos tvarkaraščiams sudaryti reikalingi API adresai:
- Pagrindiniai duomenys:
/Contacts(klientai ir tiekėjai),/Items(Code, IsTrackedAsInventory, QuantityOnHand). - Paklausa:
/Quotes(Status ACCEPTED, LineItems), o dirbtuvėms, kurios pirmiausia išrašo sąskaitą, –/Invoicessu Type ACCREC. - Tiekimas:
/PurchaseOrders(DeliveryDate, ExpectedArrivalDate, LineItems su ItemCode). - Duomenų įrašymas į Xero:
/Quotes/{QuoteID}/History,/Invoices,/Quotesir Projects API adresuhttps://api.xero.com/projects.xro/2.0/projects/{projectId}/time.
Visi sąrašų API adresai priima antraštę If-Modified-Since, todėl per kiekvieną sinchronizavimą nuskaitomi tik pasikeitę duomenys. Įrašai kuriami ir atnaujinami paketais. Gaminių komplektavimo žiniaraščiams, technologiniams maršrutams ar gamybos užsakymams skirtų API adresų nėra.
Autentifikavimas, prieigos teisės ir ribos
Xero naudoja OAuth 2.0. Xero administratorius vieną kartą prisijungia, patvirtina programą ir pasirenka organizaciją. Programa prašo offline_access teisės, kad galėtų palaikyti ryšį naudodama atnaujinimo prieigos raktus. (Šaltinis)
Xero plačias prieigos teises keičia detalesnėmis, o naujoms programoms jau suteikiamos detalios teisės. Gamybos tvarkaraščių sudarymo integracijai reikia:
accounting.invoices– komerciniams pasiūlymams, sąskaitoms faktūroms, pirkimo užsakymams ir prekėmsaccounting.contacts– klientams ir tiekėjamsaccounting.settings.read– prekių nustatymamsprojects– laiko įrašamsoffline_access
Xero riboja užklausų skaičių kiekvienai organizacijai (vienu metu, per minutę ir per dieną) ir kiekvienai programai. Viršijus ribą, grąžinamas HTTP 429 atsakymas su antrašte Retry-After. Dienos užklausų limitas ir prijungtų organizacijų skaičius priklauso nuo programos partnerystės lygio. Abu nurodyti Xero API ribų puslapyje. Naudojant įvykių pranešimus, duomenų nuskaitymą su If-Modified-Since ir įrašymą paketais, gamybos tvarkaraščių sudarymo integracijos užklausų skaičius lieka gerokai mažesnis už nustatytus limitus.
SkyPlanner REST API autentifikavimui naudoja API prieigos raktą antraštėje Authorization-Token (SkyPlanner Settings > API). API dokumentacija pateikiama Swagger/OpenAPI formatu. Integravimo pamokoje paaiškinta, kaip atlikti pirmąsias užklausas.
Įvykių pranešimai
„Webhooks allow you to subscribe to certain events that happen in Xero.” (Įvykių pranešimai leidžia užsiprenumeruoti tam tikrus Xero įvykius.) (Šaltinis) Gamybos tvarkaraščiams sudaryti svarbūs Contact ir Invoice įvykiai; abu turi CREATE ir UPDATE tipus.
Kaip jie veikia:
- Viena programai sukonfigūruota įvykių pranešimų prenumerata apima visas prijungtas organizacijas.
- Kiekviename pranešime pateikiamas įvykių masyvas su ištekliaus ID ir įvykio tipu. Gavęs pranešimą, gavėjas nuskaito patį išteklių.
- Kiekvienas pranešimas pasirašomas antrašte
x-xero-signature, sugeneruota naudojant programos įvykių pranešimų raktą. Prieš pradėdama siųsti pranešimus, Xero atlieka „Intent to receive“ patikrą. - Xero pakartotinai siunčia nepristatytus pranešimus, o jei pristatyti nuolat nepavyksta, išjungia jų siuntimą. Todėl gavėjas greitai patvirtina gavimą, o duomenis apdoroja vėliau.
Komerciniams pasiūlymams, prekėms ir pirkimo užsakymams įvykių pranešimai nesiunčiami. SkyPlanner juos tikrina trumpais intervalais, naudodama If-Modified-Since. Jei niekas nepasikeitė, tam reikia vienos užklausos kiekvienam objekto tipui.
Duomenų susiejimas
| Xero objektas (API adresas) | SkyPlanner objektas | Kryptis | Dažnis |
|---|---|---|---|
Contact, IsCustomer (/Contacts) | Klientas (external_identifier, delivery_priority) | Xero → SkyPlanner | Pradinis įkėlimas, vėliau – gavus įvykio pranešimą |
Item, kurio atsargos apskaitomos arba neapskaitomos, su QuantityOnHand (/Items) | Produktai ir medžiagos, atsargos | Xero → SkyPlanner | Pradinis įkėlimas, vėliau – naudojant If-Modified-Since |
Quote su Status ACCEPTED ir LineItems (/Quotes) | Užsakymas (external_order_number, delivery_date), kiekvienos eilutės užduotys | Xero → SkyPlanner | Periodinis tikrinimas naudojant If-Modified-Since |
Invoice su Type ACCREC (dirbtuvėms, kurios pirmiausia išrašo sąskaitą) (/Invoices) | Užsakymas ir užduotys | Xero → SkyPlanner | Realiuoju laiku per įvykių pranešimus |
PurchaseOrder su ExpectedArrivalDate arba DeliveryDate (/PurchaseOrders) | Laukiama medžiagų siunta (estimated_delivery_date) | Xero → SkyPlanner | Periodinis tikrinimas naudojant If-Modified-Since |
Pastaba komercinio pasiūlymo istorijoje (PUT /Quotes/{QuoteID}/History) | Planuojama užbaigimo data | SkyPlanner → Xero | Pasikeitus tvarkaraščiui |
Invoice su Type ACCREC, Status DRAFT, Reference = komercinio pasiūlymo numeris (POST /Invoices) | Užbaigtas užsakymas | SkyPlanner → Xero | Užbaigus užsakymą |
Quote su Status INVOICED (POST /Quotes) | Užbaigtas užsakymas | SkyPlanner → Xero | Sukūrus sąskaitą faktūrą |
Projects laiko įrašas (POST /projects/{projectId}/time) | Mobile Confirmations, darbo laiko įrašai | SkyPlanner → Xero | Registruojant darbą |
| Xero nėra | Darbo centrai, proceso etapai, pamainos, neatvykimai, paruošimo laikų matrica, įrankiai, operatorių skaičius, alternatyvūs darbo centrai | Tvarkoma SkyPlanner | Sukonfigūruojama diegimo metu |
Integravimo būdai
1. Pradinis pagrindinių duomenų įkėlimas. Puslapiais nuskaitykite kontaktus ir prekes, tada – neįvykdytus pirkimo užsakymus ir priimtus komercinius pasiūlymus. SkyPlanner sukurkite klientus, kaip external_identifier naudodami Xero ContactID, o produktus ir medžiagas kurkite naudodami prekės kodą kaip raktą. Tada sukurkite tai, ko Xero nėra: darbo centrus, kiekvieno produkto proceso etapus, pamainas, atostogas ir paruošimo laikus. Proceso etapus greičiausia įkelti importuojant CSV arba Excel failą.
2. Užsakymų sinchronizavimas. Periodiškai tikrinkite komercinius pasiūlymus naudodami If-Modified-Since. Kai pasiūlymo būsena tampa ACCEPTED, SkyPlanner sukuria užsakymą, kurio external_order_number yra pasiūlymo numeris. delivery_date reikšmė gaunama iš lauko, kuriame jūsų dirbtuvės nurodo pažadėtą pristatymo datą; šis laukas susiejamas diegimo metu. Iš kiekvienos pasiūlymo eilutės sukuriamos užduotys pagal produkto proceso etapus. Pagal pirkimo užsakymų eilutes sukuriamos laukiamos medžiagų siuntos su numatoma gavimo data, todėl užduotys nepradedamos, kol medžiagos nepristatytos. Kasnakt nuskaitomi visi atviri komerciniai pasiūlymai ir neįvykdyti pirkimo užsakymai, kad būtų aptikti praleisti pakeitimai.
3. Tvarkaraščio ir užbaigimo duomenų įrašymas į Xero. Rezultatai perduodami į Xero trimis užklausomis:
- PUT
/Quotes/{QuoteID}/Historyprideda pastabą su planuojama užbaigimo data. Priimtame komerciniame pasiūlyme leidžiama keisti tik kontaktą ir pastabas, todėl data įrašoma į istorijos pastabą. (Šaltinis) - Užbaigus užsakymą, POST
/Invoicessukuria pardavimo sąskaitą faktūrą su Type ACCREC, Status DRAFT, komercinio pasiūlymo kontaktu bei eilutėmis ir pasiūlymo numeriu lauke Reference. Jūsų buhalteris ją patvirtina ir išsiunčia per Xero. - POST
/Quotessu QuoteID ir Status INVOICED uždaro komercinį pasiūlymą. Accounting API leidžia pakeisti būseną iš Accepted į Invoiced.
4. Darbų patvirtinimas ceche ir projekto darbo laiko apskaita. Operatoriai registruoja darbą naudodami SkyPlanner Mobile Confirmations, Production Timer arba Quick Log Mode. Pagal darbų eigą tvarkaraštis atnaujinamas iš karto, o Autopilot perplanuoja likusius darbus. Projekto darbų valandas SkyPlanner įrašo kaip projekto užduoties laiko įrašus, nurodydama Xero naudotoją, datą ir trukmę. (Šaltinis)
5. Atsakomybės už duomenis ir konfliktų sprendimo taisyklės. Užrašykite jas prieš pradėdami naudoti integraciją:
| Duomenys | Atsakinga sistema |
|---|---|
| Kontaktai, prekės, kainos, komerciniai pasiūlymai, pirkimo užsakymai, sąskaitos faktūros, apskaita | Xero |
| Darbo centrai, proceso etapai, pamainos, neatvykimai, paruošimo laikų matrica, įrankiai, alternatyvūs ištekliai | SkyPlanner |
| Užduočių seka, pradžios ir pabaigos laikas, kiekvienos užduoties darbo centras | SkyPlanner |
| Pastaba apie planuojamą užbaigimą komerciniame pasiūlyme | SkyPlanner, įrašoma į Xero |
| Sąskaitos juodraštis užbaigtiems užsakymams, projekto darbo laikas | Sukuria SkyPlanner, po patvirtinimo duomenis valdo Xero |
Įprasti projekto etapai
Diegimas paprastai baigiamas per kelias savaites nuo tada, kai pradedamas pradinis parengimas. Prieš tai galite 30 dienų nemokamai išbandyti sistemą su savo duomenimis: iš Xero CSV formatu eksportuotais kontaktais, produktais ir atvirais komerciniais pasiūlymais.
Patį projektą sudaro šie etapai:
- Prijungimas. Xero administratorius suteikia SkyPlanner prieigą ir pasirenka organizaciją.
- Paklausos objektas. Susitariama, kas inicijuos gamybą: priimti komerciniai pasiūlymai ar pardavimo sąskaitos.
- Duomenų susiejimas. Nustatoma susiejimo lentelė, prekių kodai, sąskaitoms naudojamos apskaitos sąskaitos, numatytieji mokesčių nustatymai ir duomenų valdymo taisyklės.
- Pradinis duomenų įkėlimas. Įkeliami kontaktai, prekės, atviri pirkimo užsakymai ir priimti komerciniai pasiūlymai.
- Gamybos modelis. SkyPlanner sistemoje nustatomi darbo centrai, kiekvieno produkto gamybos operacijos, pamainos, paruošimo laikų matrica, įrankiai ir operatorių skaičius.
- Sinchronizavimas. Kontaktų ir sąskaitų pakeitimams naudojami webhook pranešimai, komerciniai pasiūlymai, prekės ir pirkimo užsakymai periodiškai tikrinami naudojant
If-Modified-Since, o kasnakt duomenys sutikrinami. - Duomenų įrašymas į Xero. Pirmiausia įrašomos komercinių pasiūlymų pastabos, tada – sąskaitų juodraščiai ir pasiūlymų būsenos, galiausiai – projektų darbo laikas, jei jis apskaitomas.
- Lygiagretus testavimas ir paleidimas. Palyginkite SkyPlanner datas su dabartiniu planu, paprašykite buhalterio patikrinti pirmuosius sąskaitų juodraščius, tada įjunkite duomenų įrašymą į Xero.
Į ką atsižvelgti planuojant integraciją su Xero
- Xero neturi gamybos objektų. Kiekvieno produkto gamybos operacijas saugokite SkyPlanner sistemoje ir susiekite jas su Xero prekės kodu. Prekių kodų nekeiskite.
- Komerciniams pasiūlymams webhook pranešimai nesiunčiami. Dažnai tikrinkite jų pakeitimus naudodami
If-Modified-Since, bet neviršykite minutės ir dienos užklausų limitų. - Priimti komerciniai pasiūlymai užrakinami. Priėmus pasiūlymą galima keisti tik kontaktinius duomenis ir pastabas, todėl pažadėta data nuskaitoma vieną kartą, priėmimo metu, o suplanuota data įrašoma kaip pastaba istorijoje.
- Atsargų likučiai keičiasi pagal sąskaitas. Xero atnaujina apskaitomų prekių likučius pagal pardavimo ir pirkimo sąskaitas bei kreditines sąskaitas. Su buhalteriu susitarkite, kaip bus apskaitoma pagaminta produkcija ir sunaudotos medžiagos.
- Projekto darbo laikui registruoti reikia Xero naudotojų. Darbo laiko įrašai priskiriami Xero naudotojui. Nuspręskite, kurių operatorių darbo laikas bus perduodamas į Xero Projects, o kitų darbo laiko duomenis palikite SkyPlanner sistemoje.
- Detalios prieigos teisės. Nuo pat pradžių prašykite detalių prieigos teisių, nes plačios apimties teisių atsisakoma.
- Programėlės planas. Partnerio planas nustato, kiek organizacijų programėlė gali prijungti ir kiek užklausų per dieną gali atlikti. Planą rinkitės atsižvelgdami į gamyklų skaičių.
Integracija su Xero: kas ją konfigūruoja ir prižiūri
Darbai apima jūsų prekes, komercinius pasiūlymus, pirkimo užsakymus ir užbaigtų darbų perdavimą sąskaitoms išrašyti. Taip pat pridedami duomenys, kurių Xero nesaugo: darbo centrai, gamybos operacijos, pamainos, paruošimo laikų matrica, įrankiai, operatorių skaičius ir alternatyvūs ištekliai.
- SkyPlanner komanda sukonfigūruoja integraciją pradinio parengimo metu ir teikia pagalbą po paleidimo. Kiekviena gamybos įmonė Xero prekes, komercinius pasiūlymus ir atsargas tvarko savaip – konfigūruojant integraciją ši patirtis pritaikoma praktiškai.
- Integraciją gali sukurti jūsų Xero konsultantas arba integracijų partneris. SkyPlanner suteikia REST API, Swagger/OpenAPI dokumentaciją ir webhook pranešimus.
- Jūsų programuotojai gali kurti savo sprendimus naudodami API prieigos raktą. Pradžiai pakanka API prieigos rakto, o prireikus padeda SkyPlanner komanda. Produkto dokumentaciją, įskaitant pirkimo užsakymus ir produktų bei medžiagų API, rasite SkyPlanner dokumentacijoje.
SkyPlanner kainuoja nuo 199 € per mėnesį, į kainą įskaičiuoti 5 darbo centrai. Mokama kas mėnesį. Integracijos kaina apskaičiuojama iš anksto pagal jūsų procesą ir poreikius kartu su pasirinktu planu, todėl dar prieš pradėdami žinote visas išlaidas. Peržiūrėkite kainas, funkcijas ir sužinokite, ką gali pati Xero, straipsnyje „Ar Xero leidžia sudaryti gamybos tvarkaraščius?“ Apžvalgą rasite Xero puslapyje, o kitas sistemas – visų integracijų sąraše.
Gamintojų atsiliepimai apie SkyPlanner
2 hsutaupoma kas savaitę
„Su SkyPlanner nuo gamybos planavimo Excel lentelėse perėjome prie gamybos optimizavimo realiuoju laiku.“
Kalle Kalliomäki, tiekimo grandinės specialistas
UTU · Elektros skirstomieji skydai ir skirstymo įranga
Planuojant gamybą kas savaitę sutaupomos 2 darbo valandos, o nauja darbų eilė gamybos liniją pasiekia per kelias sekundes.
+90%gamybos efektyvumas
„Gamybos efektyvumas padidėjo 90%.“
Abdul Rucyinga, IT vadovas
Laboratory & Allied · Vaistų gamyba
Gamybos efektyvumas padidėjo 90%, o optimizuotas trijų mėnesių planas visiems darbo centrams sudaromas per mažiau nei 30 minučių.
Mažiauprastovų dėl medžiagų trūkumo
„SkyPlanner mums vertingas tuo, kad tai kasdienėje veikloje pasiteisinantis įrankis, ypač nustatant pristatymo datas.“
Tommi Männistö, gamybos planavimo vadovas
Eskomatic · Mechaninis apdirbimas pagal užsakymą
Automatiškai planuojant apkrovą, pristatymo datos nustatomos tiksliau, o gamybos prastovų dėl medžiagų trūkumo gerokai sumažėjo.
1 000 ir daugiauautomatiškai suplanuotų gamybos užsakymų
„Gamybą dabar valdome kitaip, o mūsų supratimas apie pajėgumus pakilo į visiškai kitą lygį.“
Hannu Ryynänen, generalinis direktorius
Mamec · Pramoniniai maišytuvai, siurbliai ir aukštųjų technologijų gamyba pagal užsakymą
Tūkstančiai gamybos užsakymų suplanuojami automatiškai, o visa organizacija mato gamybos būklę realiuoju laiku.
Dažniausiai užduodami klausimai
Ar Xero turi API gamybos duomenims?
Xero turi Accounting API ir Projects API – abi yra REST sąsajos su OAuth 2.0. Jos apima kontaktus, prekes, komercinius pasiūlymus, sąskaitas, pirkimo užsakymus ir darbo laiko įrašus. Gamybos duomenys, pavyzdžiui, darbo centrai ir gamybos operacijos, saugomi SkyPlanner sistemoje.
Ar SkyPlanner gali įrašyti duomenis į Xero?
Taip. SkyPlanner į kiekvieno komercinio pasiūlymo istoriją įrašo planuojamą užbaigimo datą, o užbaigus užsakymą sukuria pardavimo sąskaitos juodraštį su pasiūlymo eilutėmis, pakeičia pasiūlymo būseną į Invoiced ir perduoda projekto darbo laiko įrašus.
Ar Xero siunčia pakeitimus realiuoju laiku?
Xero webhook pranešimai apima kontaktus ir sąskaitas. SkyPlanner naudodamas If-Modified-Since nuskaito nuo paskutinio sinchronizavimo pasikeitusius komercinius pasiūlymus, prekes ir pirkimo užsakymus, o kasnakt sutikrina duomenis, todėl naujas priimtas pasiūlymas greitai patenka į tvarkaraštį.
Iš kur gaunami medžiagų žiniaraščiai, technologiniai maršrutai ir įrenginių duomenys, jei Xero jų neturi?
Iš SkyPlanner. Darbo centrus, kiekvieno produkto gamybos operacijas, pamainas ir paruošimo laikus nustatote vieną kartą – rankiniu būdu arba importuodami CSV ar Excel failą. Kiekvienas produktas susiejamas su Xero prekės kodu, todėl nauji priimti komerciniai pasiūlymai į tvarkaraštį įtraukiami automatiškai.
Ar galime išbandyti SkyPlanner prieš kurdami integraciją?
Taip. Per 30 dienų nemokamą bandomąjį laikotarpį galite naudoti iki 20 darbo centrų ir importuoti duomenis iš Xero CSV failo. Mokėjimo kortelės nereikia. Išbandykite nemokamai arba susisiekite su pardavimo komanda ir aptarkite integracijos apimtį.
