Xero integrācijas ceļvedis ražošanas grafiku sastādīšanai ar SkyPlanner APS

Xero ir vienots mākoņprodukts ar vairāku nomnieku arhitektūru, un visas organizācijas izmanto vienu un to pašu API. Accounting API ir REST API ar JSON vai XML atbalstu adresē https://api.xero.com/api.xro/2.0/. Katrā izsaukumā organizācija tiek norādīta galvenē Xero-tenant-id. (avots)

Ražošanas grafiku sastādīšanai vajadzīgie galapunkti:

• Pamatdati: /Contacts (klienti un piegādātāji), /Items (Code, IsTrackedAsInventory, QuantityOnHand).
• Pieprasījums: /Quotes (Status ACCEPTED, LineItems), bet ražotnēm, kas vispirms izraksta rēķinu, — /Invoices ar Type ACCREC.
• Apgāde: /PurchaseOrders (DeliveryDate, ExpectedArrivalDate, LineItems ar ItemCode).
• Datu ierakstīšana atpakaļ: /Quotes/{QuoteID}/History, /Invoices, /Quotes un Projects API adresē https://api.xero.com/projects.xro/2.0/projects/{projectId}/time.

Visi sarakstu galapunkti pieņem galveni If-Modified-Since, tāpēc katrā sinhronizācijā tiek nolasīti tikai mainītie dati. Ieraksti tiek veidoti un atjaunināti paketēs. Materiālu specifikācijām, tehnoloģiskajiem procesiem un ražošanas pasūtījumiem galapunktu nav.

“Webhooks allow you to subscribe to certain events that happen in Xero.” (Tīmekļa aizķeres ļauj abonēt noteiktus Xero notikumus.) (avots) Ražošanas grafiku sastādīšanai svarīgie notikumi ir Contact un Invoice — katram no tiem ir CREATE un UPDATE.

Kā tās darbojas:

• Viena tīmekļa aizķere katrai lietotnei aptver visas pievienotās organizācijas.
• Katrā piegādātajā ziņojumā ir notikumu masīvs ar resursa ID un notikuma tipu. Pēc tam saņēmējs nolasa pašu resursu.
• Katrs piegādātais ziņojums ir parakstīts ar galveni x-xero-signature, kas izveidota, izmantojot lietotnes tīmekļa aizķeres atslēgu. Pirms ziņojumu piegādes sākšanas Xero nosūta pārbaudi “Intent to receive” (gatavība saņemt).
• Xero atkārto neveiksmīgās piegādes un atspējo tīmekļa aizķeri, ja kļūmes turpinās. Tāpēc saņēmējs ātri nosūta atbildi un apstrādi veic pēc tam.

Piedāvājumiem, precēm un iepirkuma pasūtījumiem nav tīmekļa aizķeru notikumu. SkyPlanner tos nolasa ar īsiem periodiskās aptaujas intervāliem, izmantojot If-Modified-Since. Ja nekas nav mainījies, katram entītijas veidam ir vajadzīgs viens izsaukums.

1. Sākotnējā pamatdatu ielāde. Nolasiet kontaktus un preces pa lapām, pēc tam — atvērtos iepirkuma pasūtījumus un pieņemtos piedāvājumus. Izveidojiet klientus SkyPlanner, laukā external_identifier norādot Xero ContactID, bet produktiem un materiāliem kā atslēgu izmantojiet preces kodu. Pēc tam izveidojiet to, kā Xero nav: darba centrus, procesa soļus katram produktam, maiņas, atvaļinājumus un sagatavošanas laikus. Procesa soļus visātrāk var ielādēt ar CSV vai Excel importu.

2. Pasūtījumu sinhronizācija. Periodiski aptaujājiet piedāvājumus ar If-Modified-Since. Kad piedāvājuma statuss kļūst ACCEPTED, SkyPlanner izveido pasūtījumu, laukā external_order_number norādot piedāvājuma numuru. Vērtība laukā delivery_date tiek iegūta no lauka, ko jūsu ražotne izmanto solītajam piegādes datumam; šo atbilstību nosaka ieviešanas laikā. Katrai piedāvājuma rindai tiek izveidoti ražošanas uzdevumi atbilstoši produkta procesa soļiem. Iepirkuma pasūtījumu rindas kļūst par ienākošajiem materiāliem ar paredzēto saņemšanas datumu, tāpēc ražošanas uzdevumi gaida piegādi. Katru nakti pilnībā nolasot atvērtos piedāvājumus un iepirkuma pasūtījumus, tiek uztvertas visas iepriekš nepamanītās izmaiņas.

3. Grafika un pabeigšanas datu ierakstīšana atpakaļ. Rezultāti tiek ierakstīti Xero ar trim izsaukumiem:

• PUT /Quotes/{QuoteID}/History pievieno piezīmi ar plānoto pabeigšanas datumu. Pieņemtā piedāvājumā drīkst mainīt tikai kontaktu un piezīmes, tāpēc datums tiek saglabāts vēstures piezīmē. (avots)
• Kad pasūtījums ir pabeigts, POST /Invoices izveido pārdošanas rēķinu ar Type ACCREC, Status DRAFT, piedāvājuma kontaktu un rindām, kā arī piedāvājuma numuru laukā Reference. Jūsu grāmatvedis to apstiprina un nosūta, izmantojot Xero.
• POST /Quotes ar QuoteID un Status INVOICED noslēdz piedāvājumu. Accounting API atļauj statusa maiņu no Accepted uz Invoiced.

4. Darba izpildes apstiprinājumi ražotnē un projektu laika uzskaite. Operatori reģistrē darbu ar SkyPlanner Mobile Confirmations, Production Timer vai Quick Log Mode. Darba izpildes gaita uzreiz atjaunina grafiku, un Autopilot pārplāno atlikušo darbu. Projektu darbiem SkyPlanner nosūta stundas kā laika uzskaites ierakstus attiecīgajam projekta uzdevumam, norādot Xero lietotāju, datumu un ilgumu. (avots)

5. Datu pārvaldības un konfliktu risināšanas noteikumi. Dokumentējiet tos pirms palaišanas:

• Xero nav ražošanas datu objektu. Katra produkta procesa soļus glabājiet SkyPlanner, sasaistot tos ar Xero preces kodu. Preču kodus nemainiet.
• Piedāvājumiem nav webhook paziņojumu. Pieprasiet tos ar If-Modified-Since īsos intervālos, ievērojot minūtes un dienas ierobežojumus.
• Apstiprināti piedāvājumi ir bloķēti. Pēc apstiprināšanas var mainīt tikai kontaktinformāciju un piezīmes, tāpēc solīto datumu nolasa vienreiz — apstiprināšanas brīdī. Plānoto datumu ieraksta vēstures piezīmē.
• Krājumu atlikumi mainās atbilstoši rēķiniem. Precēm ar krājumu uzskaiti Xero maina atlikumu, izmantojot pārdošanas rēķinus, piegādātāju rēķinus un kredītrēķinus. Vienojieties ar grāmatvedi, kā uzskaitīt gatavo produkciju un izlietotos materiālus.
• Projektu laika uzskaitei vajadzīgi Xero lietotāji. Katrs laika uzskaites ieraksts ir piesaistīts Xero lietotājam. Izlemiet, kuru operatoru nostrādāto laiku nodot Xero Projects, bet pārējo uzskaiti atstājiet SkyPlanner.
• Detalizētas piekļuves atļaujas. Jau sākumā pieprasiet detalizētas piekļuves atļaujas, jo plašās piekļuves atļaujas tiek pakāpeniski atceltas.
• Lietotnes līmenis. Partnera līmenis nosaka, cik organizāciju lietotne var savienot un cik API izsaukumu dienā tai ir pieejams. Izvēlieties līmeni atbilstoši ražotņu skaitam.