Liidestused / ERP / Xero
Xero liidestamise juhend tootmise ajakava koostamiseks SkyPlanner APS-iga
See liidestamisjuhend näitab Xero nõustajatele, konsultantidele ja IT-meeskondadele, kuidas ühendada Xero SkyPlanner APS-iga. SkyPlanner vahetab Xeroga andmeid mõlemas suunas Xero Accounting API ja Projects API kaudu:
- SkyPlannerisse tuuakse kontaktid, laoarvestusega kaubad koos laokogustega, kinnitatud pakkumised ning ostutellimused koos saabumiskuupäevadega.
- Planeeritud valmimiskuupäev kirjutatakse tagasi märkusena iga pakkumise ajalukku.
- Valminud tellimused saadetakse tagasi müügiarvete mustanditena koos pakkumise ridade ja viitega ning pakkumise olekuks saab Invoiced.
- Projektitöödele registreeritud tunnid saadetakse tagasi Xero Projects ajakirjetena.
- Xero veebikonksud teavitavad kontaktide ja arvete muudatustest ning SkyPlanneri veebikonksud edastavad ajakava muudatused kohe nende tekkimisel.
Xero on raamatupidamistarkvara, mistõttu ei sisalda see tootestruktuure, tehnoloogilisi marsruute, masinaid ega tootmistellimusi. Töökeskusi, tööetappe, vahetusi ja seadistusaegu hallatakse SkyPlanneris. SkyPlanneri meeskond seadistab liidestuse juurutamise käigus teie Xero organisatsiooni jaoks ja pakub tuge ka pärast kasutuselevõttu. See juhend on mõeldud nõustajatele ja arendajatele, kes soovivad liidestamises osaleda või ise SkyPlanneri dokumenteeritud REST API abil lahendusi luua (API dokumentatsioon).
Xero Accounting API
Xero on üks mitut rentnikku teenindav pilvetoode ja kõik organisatsioonid kasutavad sama API-t. Accounting API on REST API aadressil https://api.xero.com/api.xro/2.0/ ning kasutab JSON- või XML-vormingut. Iga päringu päises Xero-tenant-id määratakse organisatsioon. (allikas)
Ajakava koostamiseks vajalikud lõpp-punktid:
- Põhiandmed:
/Contacts(kliendid ja tarnijad),/Items(Code, IsTrackedAsInventory, QuantityOnHand). - Nõudlus:
/Quotes(Status väärtusega ACCEPTED, LineItems) ning ettevõtetele, kes esitavad arve enne tootmist,/Invoices, kus Type on ACCREC. - Tarned:
/PurchaseOrders(DeliveryDate, ExpectedArrivalDate, LineItems koos väljaga ItemCode). - Tagasikirjutamine:
/Quotes/{QuoteID}/History,/Invoices,/Quotesja Projects API aadressilhttps://api.xero.com/projects.xro/2.0/projects/{projectId}/time.
Kõik loendite lõpp-punktid toetavad päist If-Modified-Since, nii et igal sünkroonimisel loetakse ainult muutunud andmeid. Uued kirjed ja muudatused saadetakse pakettidena. Tootestruktuuride, tehnoloogiliste marsruutide ega tootmistellimuste jaoks lõpp-punkte ei ole.
Autentimine, juurdepääsuõigused ja piirangud
Xero kasutab OAuth 2.0 protokolli. Xero administraator logib ühe korra sisse, annab rakendusele loa ja valib organisatsiooni. Rakendus taotleb õigust offline_access, et hoida ühendust värskendustõendite abil. (allikas)
Xero asendab ulatuslikud juurdepääsuõigused täpsemalt piiritletud õigustega ning uued rakendused saavad juba täpsemalt piiritletud õigused. Tootmise ajakava koostamiseks kasutatav liidestus vajab järgmisi õigusi:
accounting.invoicespakkumiste, arvete, ostutellimuste ja kaupade jaoksaccounting.contactsklientide ja tarnijate jaoksaccounting.settings.readkaupade seadete jaoksprojectsajakirjete jaoksoffline_access
Xero piirab päringute arvu nii organisatsiooni kohta (samaaegselt, minutis ja päevas) kui ka rakenduse kohta. Piirangu ületamisel tagastab see HTTP 429 vastuse koos päisega Retry-After. Päevane päringulimiit ja ühendatud organisatsioonide arv sõltuvad rakenduse partneritasemest. Mõlemad on kirjas Xero API piirangute lehel. Veebikonksud, päisega If-Modified-Since lugemispäringud ja pakettidena kirjutamine hoiavad ajakava koostamise liidestuse päringumahu kindlalt lubatud piirides.
SkyPlanneri REST API kasutab autentimiseks API tõendit päises Authorization-Token (SkyPlanner Settings > API). API on dokumenteeritud Swagger/OpenAPI vormingus. Liidestamise õpetus juhendab esimeste päringute tegemisel.
Veebikonksud
“Webhooks allow you to subscribe to certain events that happen in Xero.” (Veebikonksud võimaldavad tellida teavitusi teatud Xeros toimuvate sündmuste kohta.) (allikas) Ajakava koostamisel on olulised Contact ja Invoice sündmused, mõlemal tüübid CREATE ja UPDATE.
Nii need toimivad:
- Üks veebikonks rakenduse kohta katab kõik ühendatud organisatsioonid.
- Iga saadetis sisaldab sündmuste massiivi koos ressursi ID ja sündmuse tüübiga. Vastuvõtja loeb seejärel ressursi andmed.
- Iga saadetis allkirjastatakse päisega
x-xero-signature, mis luuakse rakenduse veebikonksu võtme alusel. Enne saatmise alustamist teeb Xero kontrolli “Intent to receive”. - Xero proovib ebaõnnestunud saadetisi uuesti saata ja lülitab korduvalt ebaõnnestuva veebikonksu välja. Seetõttu vastab vastuvõtja kiiresti ja töötleb andmeid alles pärast vastamist.
Pakkumiste, kaupade ja ostutellimuste jaoks veebikonksusündmusi ei ole. SkyPlanner küsib nende muudatusi lühikeste intervallidega, kasutades päist If-Modified-Since. Kui midagi pole muutunud, kulub iga olemitüübi kohta üks päring.
Andmete vastendamine
| Xero objekt (lõpp-punkt) | SkyPlanneri objekt | Suund | Sagedus |
|---|---|---|---|
Contact, IsCustomer (/Contacts) | Klient (external_identifier, delivery_priority) | Xero → SkyPlanner | Esmane laadimine, seejärel veebikonksu teavituse korral |
Item, laoarvestusega ja ilma, koos väljaga QuantityOnHand (/Items) | Tooted ja materjalid, laoseis | Xero → SkyPlanner | Esmane laadimine, seejärel päise If-Modified-Since alusel |
Quote, Status väärtusega ACCEPTED, koos väljaga LineItems (/Quotes) | Tellimus (external_order_number, delivery_date), tööd iga rea kohta | Xero → SkyPlanner | Perioodilised päringud päisega If-Modified-Since |
Invoice, Type väärtusega ACCREC (enne tootmist arveldavad ettevõtted) (/Invoices) | Tellimus ja tööd | Xero → SkyPlanner | Reaalajas veebikonksu kaudu |
PurchaseOrder koos väljaga ExpectedArrivalDate või DeliveryDate (/PurchaseOrders) | Saabuv materjal (estimated_delivery_date) | Xero → SkyPlanner | Perioodilised päringud päisega If-Modified-Since |
Märkus pakkumise ajaloos (PUT /Quotes/{QuoteID}/History) | Planeeritud valmimiskuupäev | SkyPlanner → Xero | Ajakava muutumisel |
Invoice, Type väärtusega ACCREC, Status väärtusega DRAFT, Reference = pakkumise number (POST /Invoices) | Valminud tellimus | SkyPlanner → Xero | Tellimuse valmimisel |
Quote, Status väärtusega INVOICED (POST /Quotes) | Valminud tellimus | SkyPlanner → Xero | Arve loomisel |
Projects ajakirje (POST /projects/{projectId}/time) | Mobile Confirmations, ajakirjed | SkyPlanner → Xero | Töö registreerimisel |
| Xeros puudub | Töökeskused, tööetapid, vahetused, puudumised, seadistusaegade maatriks, tööriistad, operaatorite arv, alternatiivsed töökeskused | Hallatakse SkyPlanneris | Seadistatakse juurutamise käigus |
Liidestuslahendused
1. Põhiandmete esmane laadimine. Lugege lehekülgede kaupa kontaktid ja kaubad, seejärel avatud ostutellimused ja kinnitatud pakkumised. Looge SkyPlanneris kliendid, kasutades välja external_identifier väärtusena Xero ContactID-d, ning tooted ja materjalid, kasutades võtmena kaubakoodi. Seejärel lisage andmed, mida Xeros ei ole: töökeskused, iga toote tööetapid, vahetused, puhkused ja seadistusajad. Tööetapid saab kõige kiiremini lisada CSV- või Exceli impordiga.
2. Tellimuste sünkroonimine. Küsige pakkumiste muudatusi päisega If-Modified-Since. Kui pakkumise olekuks saab ACCEPTED, loob SkyPlanner tellimuse, mille välja external_order_number väärtuseks on pakkumise number. Väärtus delivery_date tuleb väljast, mida teie ettevõte kasutab lubatud tarnekuupäeva jaoks; see vastendus määratakse juurutamise käigus. Igast pakkumise reast luuakse toote tööetappide alusel tööd. Ostutellimuse read lisatakse saabuva materjalina eeldatavale saabumiskuupäevale, nii et tööd ootavad tarnet. Igaöine avatud pakkumiste ja ostutellimuste täielik lugemine leiab kõik vahele jäänud muudatused.
3. Ajakava ja valmimisandmete tagasikirjutamine. Tulemused viiakse Xerosse kolme päringuga:
- PUT
/Quotes/{QuoteID}/Historylisab märkuse planeeritud valmimiskuupäevaga. Kinnitatud pakkumisel saab muuta ainult kontakti ja märkusi, seega salvestatakse kuupäev ajaloo märkusse. (allikas) - Tellimuse valmimisel loob POST
/Invoicesmüügiarve, mille Type on ACCREC ja Status on DRAFT. Arvele kantakse pakkumise kontakt ja read ning välja Reference väärtuseks saab pakkumise number. Teie raamatupidaja kinnitab arve ja saadab selle Xeros välja. - POST
/Quoteskoos väljaga QuoteID ja Status väärtusega INVOICED sulgeb pakkumise. Accounting API lubab muuta oleku Accepted olekuks Invoiced.
4. Tootmistööde kinnitused ja projektiaeg. Operaatorid registreerivad tööd funktsioonidega SkyPlanner Mobile Confirmations, Production Timer või Quick Log Mode. Töö edenemine kajastub ajakavas kohe ja Autopilot planeerib ülejäänu ümber. Projektitööde puhul saadab SkyPlanner tunnid projekti ülesandele ajakirjetena koos Xero kasutaja, kuupäeva ja kestusega. (allikas)
5. Andmete haldamise ja konfliktide lahendamise reeglid. Pange need enne kasutuselevõttu kirja:
| Andmed | Haldav süsteem |
|---|---|
| Kontaktid, kaubad, hinnad, pakkumised, ostutellimused, arved, raamatupidamine | Xero |
| Töökeskused, tööetapid, vahetused, puudumised, seadistusaegade maatriks, tööriistad, alternatiivsed ressursid | SkyPlanner |
| Tööde järjekord, algus- ja lõpuajad, iga töö töökeskus | SkyPlanner |
| Pakkumise märkus planeeritud valmimiskuupäevaga | SkyPlanner, kirjutatakse Xerosse |
| Arve mustand lõpetatud tellimuste eest, projektile kulunud aeg | SkyPlanner loob, pärast kinnitamist vastutab andmete eest Xero |
Projekti tavapärased etapid
Juurutamine valmib tavaliselt mõne nädala jooksul pärast kasutuselevõtu alustamist. Enne seda saate 30-päevase tasuta prooviperioodi jooksul kasutada oma andmeid: Xerost CSV-failina eksporditud kontakte, tooteid ja avatud pakkumisi.
Projekt hõlmab järgmisi etappe:
- Ühendamine. Xero administraator annab SkyPlannerile juurdepääsu ja valib organisatsiooni.
- Tootmise käivitav objekt. Leppige kokku, kas tootmise käivitavad aktsepteeritud pakkumised või müügiarved.
- Vastendamine. Määrake kindlaks vastendustabel, artiklikoodid, arvete kontod, maksude vaikeväärtused ja reeglid, mis määravad andmete eest vastutava süsteemi.
- Esmane andmete laadimine. Kontaktid, artiklid, avatud ostutellimused ja aktsepteeritud pakkumised.
- Tootmismudel. Töökeskused, toodete tööetapid, vahetused, seadistusaegade maatriks, tööriistad ja operaatorite arv SkyPlanneris.
- Sünkroonimine. Kontaktide ja arvete jaoks kasutatakse veebikonkse, pakkumisi, artikleid ja ostutellimusi päritakse perioodiliselt päisega
If-Modified-Since. Lisaks tehakse igal ööl andmete võrdlus. - Tagasikirjutamine. Esmalt pakkumiste märkused, seejärel arvete mustandid ja pakkumiste olek ning lõpuks projektile kulunud aeg, kui seda kasutatakse.
- Paralleeltestimine ja käivitamine. Võrrelge SkyPlanneri kuupäevi oma praeguse plaaniga, laske raamatupidajal esimesed arvete mustandid üle vaadata ning lülitage seejärel tagasikirjutamine sisse.
Millega Xero liidestamisel arvestada
- Xeros puuduvad tootmisobjektid. Hoidke toodete tööetappe SkyPlanneris ja siduge need Xero artiklikoodiga. Hoidke artiklikoodid muutumatuna.
- Pakkumistel puudub veebikonks. Pärige neid lühikeste ajavahemike järel päisega
If-Modified-Since, järgides minuti- ja päevalimiite. - Aktsepteeritud pakkumised on lukustatud. Pärast aktsepteerimist saab muuta ainult kontaktandmeid ja märkusi. Seetõttu loetakse lubatud kuupäev üks kord aktsepteerimise hetkel ning planeeritud kuupäev kirjutatakse ajalukku märkusena.
- Laoseis muutub arvete alusel. Xero muudab laoarvestusega artiklite laokoguseid müügiarvete, ostuarvete ja kreeditarvete kaudu. Leppige raamatupidajaga kokku, kuidas kajastada valmistoodangut ja kasutatud materjale.
- Projektiaja arvestuseks on vaja Xero kasutajaid. Ajakanded on seotud Xero kasutajaga. Otsustage, milliste operaatorite tööaeg saadetakse moodulisse Xero Projects, ja hoidke ülejäänute ajakanded SkyPlanneris.
- Detailsed juurdepääsuõigused. Taotlege kohe alguses detailseid juurdepääsuõigusi, sest laiaulatuslikud õigused kõrvaldatakse kasutuselt.
- Rakenduse pakett. Partneripakett määrab, mitu organisatsiooni saab rakendusega ühendada ja mitu API-kutset võib päevas teha. Valige pakett tehaste arvu järgi.
Kes Xero liidestuse seadistab ja seda toetab?
Töö hõlmab teie artikleid, pakkumisi ja ostutellimusi ning seda, kuidas valmis tööd arveldamisse jõuavad. Lisaks seadistatakse andmed, mida Xeros ei ole: töökeskused, tööetapid, vahetused, seadistusaegade maatriks, tööriistad, operaatorite arv ja alternatiivsed ressursid.
- SkyPlanneri meeskond seadistab liidestuse kasutuselevõtu käigus ja pakub tuge ka pärast käivitamist. Iga tootmisettevõte seadistab Xeros artikleid, pakkumisi ja laoseisu omamoodi ning liidestamisel arvestatakse just nende eripäradega.
- Liidestuse saab luua teie Xero nõustaja või liidestuspartner. SkyPlanner pakub selleks REST API-t, Swagger/OpenAPI dokumentatsiooni ja veebihaake.
- Teie arendajad saavad luua selle baasil oma lahenduse, kasutades API pääsutõendit. Alustamiseks piisab API pääsutõendist ja vajaduse korral aitab SkyPlanneri meeskond. Toote dokumentatsiooni, sealhulgas ostutellimuste ning toodete ja materjalide API kohta, leiate SkyPlanneri dokumentatsioonist.
SkyPlanneri hind algab 199 € kuus ja sisaldab 5 töökeskust. Arveldamine toimub kord kuus. Liidestuse hinnapakkumine koostatakse ette teie protsessi ja vajaduste järgi koos valitud paketiga, nii et näete kogukulu enne alustamist. Vaadake hindu ja funktsioone ning lugege Xero enda võimaluste kohta artiklist Kas Xeroga saab koostada tootmise ajakava? Ülevaate leiate Xero lehelt ja teised süsteemid kõigi liidestuste lehelt.
Tootjate kogemused SkyPlanneriga
2 hajasäästu igal nädalal
„SkyPlanner on viinud meie tootmise planeerimise Exceli tabelitest tootmise reaalajas optimeerimiseni.“
Kalle Kalliomäki, tarneahelaspetsialist
UTU · Elektrikilbid ja jaotusseadmed
Tootmise planeerimisel säästetakse igal nädalal 2 tundi tööaega ning uus tööjärjekord jõuab tootmisliinile sekunditega.
+90%tootmise tõhusust
„Tootmise tõhusus on kasvanud 90%.“
Abdul Rucyinga, IT-juht
Laboratory & Allied · Ravimite tootmine
Tootmise tõhusus on kasvanud 90% ning kõiki töökeskusi hõlmava optimeeritud kolmekuulise plaani koostamine võtab alla 30 minuti.
Vähemmaterjalipuudusest tingitud seisakuid
„SkyPlanneri väärtus meie jaoks seisneb selles, et see on igapäevatöös toimiv tööriist, eriti tarnekuupäevade määramisel.“
Tommi Männistö, tootmise planeerimise juht
Eskomatic · Mehaaniline töötlemine allhankena
Koormuse automaatne ajastamine võimaldab määrata täpsemad tarnekuupäevad ning materjalipuudusest tingitud tootmisseisakuid on märgatavalt vähem.
1 000-tetöökäskude ajakava koostatakse automaatselt
„Tootmine on nüüd hoopis teistmoodi kontrolli all ning meie arusaam tootmisvõimsusest on täiesti uuel tasemel.“
Hannu Ryynänen, tegevjuht
Mamec · Tööstuslikud segistid, pumbad ja kõrgtehnoloogiline allhanketootmine
Tuhandete töökäskude ajakava koostatakse automaatselt ning kogu organisatsioonil on tootmisest reaalajas ülevaade.
Korduma kippuvad küsimused
Kas Xerol on tootmisandmete API?
Xerol on Accounting API ja Projects API. Mõlemad on REST-liidesed, mis kasutavad OAuth 2.0 autentimist. Need hõlmavad kontakte, artikleid, pakkumisi, arveid, ostutellimusi ja ajakandeid. Tootmisandmeid, näiteks töökeskusi ja tööetappe, hoitakse SkyPlanneris.
Kas SkyPlanner saab andmeid Xerosse tagasi kirjutada?
Jah. SkyPlanner lisab iga pakkumise ajalukku planeeritud valmimiskuupäeva, loob tellimuse valmimisel pakkumise ridadega müügiarve mustandi, määrab pakkumise olekuks Invoiced ja saadab projektide ajakanded.
Kas Xero saadab muudatused reaalajas?
Xero veebihaagid hõlmavad kontakte ja arveid. SkyPlanner loeb parameetri If-Modified-Since abil pakkumisi, artikleid ja ostutellimusi, mis on pärast viimast sünkroonimist muutunud, ning viib andmed igal ööl kooskõlla. Nii jõuab uus aktsepteeritud pakkumine kiiresti ajakavasse.
Kust tulevad materjaliloendid, tehnoloogilised marsruudid ja masinad, kui neid Xeros ei ole?
SkyPlannerist. Töökeskused, toodete tööetapid, vahetused ja seadistusajad seadistate ühe korra käsitsi või impordite CSV- või Exceli failist. Iga toode on seotud Xero artiklikoodiga, nii et uued aktsepteeritud pakkumised lisatakse ajakavasse automaatselt.
Kas saame SkyPlannerit enne liidestuse loomist proovida?
Jah. 30-päevase tasuta prooviperioodi jooksul saate kasutada kuni 20 töökeskust ja importida Xero andmed CSV-failist. Krediitkaarti pole vaja. Alustage prooviperioodi või võtke ühendust müügimeeskonnaga, et määrata liidestuse ulatus.
