Vodnik za povezavo sistema Xero s SkyPlanner APS za terminiranje proizvodnje

Xero je enotna oblačna rešitev za več najemnikov, vse organizacije pa uporabljajo isti API. Accounting API je REST API na naslovu https://api.xero.com/api.xro/2.0/ in uporablja JSON ali XML. Vsak klic določi organizacijo v glavi Xero-tenant-id. (vir)

Končne točke, potrebne za terminiranje:

• Matični podatki: /Contacts (stranke in dobavitelji), /Items (Code, IsTrackedAsInventory, QuantityOnHand).
• Povpraševanje: /Quotes (Status ACCEPTED, LineItems), za delavnice, ki najprej izdajo račun, pa /Invoices s Type ACCREC.
• Oskrba: /PurchaseOrders (DeliveryDate, ExpectedArrivalDate, LineItems z ItemCode).
• Zapis nazaj: /Quotes/{QuoteID}/History, /Invoices, /Quotes in Projects API na naslovu https://api.xero.com/projects.xro/2.0/projects/{projectId}/time.

Vsaka končna točka za sezname sprejema glavo If-Modified-Since, zato se ob vsaki sinhronizaciji preberejo samo spremenjeni podatki. Ustvarjanje in posodabljanje zapisov potekata paketno. Končnih točk za kosovnice, tehnološke postopke ali proizvodne naloge ni.

“Webhooks allow you to subscribe to certain events that happen in Xero.” (Spletni kavlji omogočajo naročanje na določene dogodke v Xero.) (vir) Za terminiranje sta pomembna dogodka Contact in Invoice, oba z vrstama CREATE in UPDATE.

Kako delujejo:

• En spletni kavelj na aplikacijo pokriva vse povezane organizacije.
• Vsako poslano obvestilo vsebuje polje dogodkov z ID-jem vira in vrsto dogodka. Prejemnik nato prebere vir.
• Vsako poslano obvestilo je podpisano z glavo x-xero-signature, ustvarjeno s ključem spletnega kavlja aplikacije. Pred začetkom pošiljanja Xero izvede preverjanje “Intent to receive” (pripravljenost na prejemanje).
• Xero neuspešno pošiljanje ponovi, spletni kavelj s ponavljajočimi se napakami pa onemogoči. Zato prejemnik hitro odgovori, obdelavo pa opravi zatem.

Za ponudbe, artikle in nabavna naročila ni dogodkov spletnih kavljev. SkyPlanner jih bere v kratkih intervalih z If-Modified-Since. Če ni sprememb, je za vsako entiteto potreben en klic.

1. Začetni prenos matičnih podatkov. Po straneh preberite stike in artikle, nato še odprta nabavna naročila in sprejete ponudbe. V SkyPlanner ustvarite stranke z vrednostjo Xero ContactID v polju external_identifier ter izdelke in materiale s šifro artikla kot ključem. Nato dodajte podatke, ki jih Xero ne hrani: delovne centre, korake postopkov za posamezne izdelke, izmene, dopuste in pripravljalne čase. Korake postopkov najhitreje uvozite iz CSV ali Excela.

2. Sinhronizacija naročil. Ponudbe periodično berite z If-Modified-Since. Ko ponudba preide v stanje ACCEPTED, SkyPlanner ustvari naročilo s številko ponudbe v polju external_order_number. Vrednost delivery_date se prenese iz polja, ki ga vaša delavnica uporablja za obljubljeni datum in katerega preslikava se določi med uvajanjem. Iz vsake postavke nastanejo operacije po korakih postopka za izdelek. Iz postavk nabavnih naročil se ustvarijo pričakovane dobave materiala s predvidenimi datumi prihoda, zato operacije čakajo na dobavo. Nočno branje vseh odprtih ponudb in nabavnih naročil zajame vse, kar je bilo izpuščeno.

3. Prenos terminskega plana in podatkov o zaključku v Xero. Rezultati se v Xero zapišejo s tremi klici:

• PUT /Quotes/{QuoteID}/History doda opombo s planiranim datumom zaključka. Pri sprejeti ponudbi je mogoče spreminjati samo stik in opombe, zato se datum shrani v opombo v zgodovini. (vir)
• Ob zaključku naročila POST /Invoices ustvari prodajni račun s Type ACCREC, Status DRAFT, stikom in postavkami iz ponudbe ter številko ponudbe v polju Reference. Vaš knjigovodja ga v programu Xero odobri in pošlje.
• POST /Quotes s QuoteID in Status INVOICED zapre ponudbo. Prehod iz Accepted v Invoiced je veljavna sprememba stanja v Accounting API.

4. Potrjevanje dela v proizvodnji in projektne ure. Operaterji evidentirajo delo s SkyPlanner Mobile Confirmations, Production Timer ali Quick Log Mode. Napredek takoj posodobi terminski plan, Autopilot pa preostalo delo na novo razporedi. Pri projektnem delu SkyPlanner ure zapiše kot časovne vnose na projektno nalogo skupaj z uporabnikom Xero, datumom in trajanjem. (vir)

5. Pravila o lastništvu podatkov in reševanju neskladij. Zapišite jih pred zagonom:

• Xero nima proizvodnih objektov. Operacije za vsak izdelek hranite v SkyPlanner in jih povežite s šifro artikla v Xero. Šifer artiklov ne spreminjajte.
• Za ponudbe ni spletnih kavljev. Pogosto jih preverjajte s poizvedbami z If-Modified-Since, pri tem pa upoštevajte omejitve števila klicev na minuto in na dan.
• Sprejete ponudbe so zaklenjene. Po sprejetju je mogoče spreminjati le kontaktne podatke in opombe. Zato se obljubljeni datum prebere enkrat, ob sprejetju, planirani datum pa se zapiše kot opomba v zgodovino.
• Zaloga se spreminja na podlagi računov. Xero spreminja količino na zalogi na podlagi izdanih računov, prejetih računov in dobropisov za artikle, za katere se vodi zaloga. Z računovodjo se dogovorite, kako boste knjižili končne izdelke in porabljeni material.
• Za čas dela na projektih potrebujete uporabnike Xero. Vsak vnos časa je vezan na uporabnika Xero. Določite, kateri operaterji bodo beležili čas v Xero Projects, čas preostalih pa hranite v SkyPlanner.
• Podrobno opredeljeni obsegi dostopa. Že od začetka zahtevajte podrobno opredeljene obsege dostopa, saj se široki obsegi ukinjajo.
• Raven aplikacije. Partnerska raven določa, koliko organizacij lahko aplikacija poveže in koliko klicev lahko opravi na dan. Pri izbiri ravni upoštevajte število obratov.