Integrācijas / ERP / Visma Net ERP
Visma Net integrācijas ceļvedis ražošanas grafiku sastādīšanai ar SkyPlanner APS
Šajā Visma Net integrācijas ceļvedī partneriem un IT komandām ir parādīts, kā savienot Visma Net (Visma.net ERP) ar SkyPlanner APS. SkyPlanner nodrošina divvirzienu integrāciju ar Visma Net, izmantojot Visma Net API:
- SkyPlanner saņem noliktavas preces, Kit specifications, pārdošanas pasūtījumus, krājumu atlikumus un iepirkuma pasūtījumus.
- Grafikā ieplānotie ražošanas uzdevumi kļūst par Kit assemblies dokumentiem, kurus iegrāmato pēc darba pabeigšanas.
- Operatoru nostrādātās stundas tiek nosūtītas atpakaļ kā Employee time cards.
- SkyPlanner nosūta grafika izmaiņas ar webhook palīdzību, tiklīdz tās notiek.
Ieviešanas laikā SkyPlanner komanda pielāgo integrāciju jūsu Visma Net konfigurācijai un nodrošina tās atbalstu arī pēc palaišanas. Šis ceļvedis ir paredzēts partneriem un izstrādātājiem, kuri vēlas piedalīties integrācijā vai paši izstrādāt risinājumus, izmantojot dokumentēto SkyPlanner REST API (API uzziņa).
Visma Net integrācijas saskarnes
- Visma Net ERP API. REST saskarne ar OpenAPI specifikāciju, kuras nosaukums joprojām ir “Visma.net ERP API v1” un kurā ir v1 un v2 ceļi. Bāzes URL ir
https://api.finance.visma.net. Vecā domēnaintegration.visma.netpieprasījumu caurlaidspēja tiek ierobežota no 2026. gada 1. februāra, un domēna darbība tiek izbeigta (paziņojums). - SalesOrder service v3 ir pieejams adresē
https://salesorder.visma.net. Pārdošanas pasūtījumu v1 un v2 galapunktu dzīves cikls ir beidzies. - Webhooks ir pieejami portālā Visma Developer Portal.
- Background API. Izmantojot galveni
erp-api-background, ilgstošie izsaukumi tiek ievietoti rindā, atbildē tiek atgriezts kods 202 ar uzdevuma ID un tiek nosūtīts paziņojums, kad rezultāts ir gatavs. - Importēšanas un eksportēšanas scenāriji sistēmā Visma Net izmanto CSV, Excel vai SQL datu nodrošinātājus vienreizējai pamatdatu ielādei.
API nav galapunktu ražošanas pasūtījumiem, tehnoloģiskajiem procesiem vai darba centriem, jo Visma Net šādu objektu nav. Grafika sastādīšanai nepieciešamos datus iegūst no precēm, komplektiem, pasūtījumiem un krājumiem:
GET /v1/inventory: noliktavā uzskaitāmās un neuzskaitāmās preces, tostarp komplekta pazīme un preces klaseGET /v1/KitSpecifications/{kitInventoryID}/{revisionID}: katras redakcijas komponentu rindasGET /v1/kitassembly: esošie komplektēšanas dokumenti, kurus var filtrēt pēc veida un statusa- SalesOrder service v3: pieprasījums ar pieprasītajiem datumiem un pasūtījumu rindām
GET /v1/inventorysummary/{inventoryNumber}: faktiskie un pieejamie krājumu atlikumi katrā noliktavāGET /v1/purchaseorderunGET /v2/PurchaseReceipt: gaidāmie materiāli un to saņemšanas dokumenti
Visi sarakstu galapunkti pieņem lastModifiedDateTime kopā ar lastModifiedDateTimeCondition, kā arī pageNumber un pageSize, tāpēc katrā sinhronizācijā var pārsūtīt tikai izmaiņas.
Autentifikācija un ierobežojumi
Visma Net izmanto Visma Connect (OpenID Connect un OAuth 2.0):
- Reģistrējiet Service Integration portālā Visma Developer Portal.
- Integrāciju apstiprina klienta Visma Net nomnieka administrators.
- Pieprasiet piekļuves pilnvaras adresē
https://connect.visma.com/connect/token, izmantojot klienta akreditācijas datu plūsmu un norādottenant_idun API piekļuves tvērumus, piemēram,visma_api:read. Piekļuves pilnvaras ir derīgas 3 600 sekundes.
Pieprasījumu biežuma ierobežojumi tiek piemēroti fiksētos stundas intervālos katram uzņēmumam un klientam. Atbildēs ir galvenes X-RateLimit-Limit, X-RateLimit-Remaining un X-RateLimit-Reset. Ja ierobežojums ir pārsniegts, tiek atgriezts kods 429 ar Retry-After (pieprasījumu biežuma ierobežojumi). Galvenes ETag un If-Match aizsargā datu atjauninājumus.
Partneri veic testēšanu demonstrācijas uzņēmumā, izmantojot Visma bezmaksas Integrator Programme. SkyPlanner pusē REST API autentifikācijai izmanto API pilnvaru (SkyPlanner Settings > API), un tā dokumentācija ir pieejama Swagger/OpenAPI formātā. Integrācijas pamācībā ir soli pa solim aprakstīti pirmie izsaukumi.
Notikumi, webhooks un periodiska datu pieprasīšana
Portālā Visma Developer Portal pieejamie webhooks nodrošina paziņojumus par grafiku sastādīšanai svarīgajiem notikumiem:
- Inventory Item Created, Updated un Changed
- Purchase Order Changed un Status Changed
- Sales Order Changed un Status Changed, kuru publicēšana tiek pārcelta uz SalesOrderService
Kit assembly un Kit specifications nav notikumu. SkyPlanner periodiski pieprasa šo objektu datus, izmantojot lastModifiedDateTime filtrus. Krājumu atlikumi tiek pieprasīti grafika aprēķināšanas laikā. Pretējā virzienā SkyPlanner nosūta webhook paziņojumus, mainoties stāvoklim vai grafikam.
Datu kartēšana
| Visma Net objekts (galapunkts) | SkyPlanner objekts | Virziens | Biežums |
|---|---|---|---|
Stock items, Non-stock items (/v1/inventory) | Produkti un materiāli | Visma Net → SkyPlanner | Sākotnējā ielāde, pēc tam webhook paziņojumi |
Kit specifications (/v1/KitSpecifications) | Produkta struktūra un katram produktam nepieciešamie materiāli | Visma Net → SkyPlanner | Sākotnējā ielāde, pēc tam periodiska pieprasīšana |
| Pārdošanas pasūtījumi (SalesOrder service v3) | Pasūtījumi ar izpildes termiņiem un klienta prioritāti | Visma Net → SkyPlanner | Webhook |
Kit assembly ar statusu On hold (/v1/kitassembly), ja komplektēšanas dokumenti tiek veidoti Visma Net | Ražošanas uzdevumi | Visma Net → SkyPlanner | Periodiska pieprasīšana |
Inventory summary (/v1/inventorysummary) | Krājumu atlikumi katrā noliktavā | Visma Net → SkyPlanner | Pieprasīšana grafika aprēķināšanas laikā |
Iepirkuma pasūtījumi un saņemšanas dokumenti (/v1/purchaseorder, /v2/PurchaseReceipt) | Gaidāmie materiāli ar piegādes datumu; krājumu atlikumu atjaunināšana pēc iepirkuma pasūtījuma piegādes | Visma Net → SkyPlanner | Webhook paziņojums, pēc tam datu nolasīšana |
| Visma Net nav pieejams | Procesa posmi, darba centri, maiņas, sagatavošanas laiku matrica, instrumenti, alternatīvie resursi | Uztur sistēmā SkyPlanner | Konfigurē ieviešanas laikā |
Kit assembly izveide un atjaunināšana (POST/PUT /v1/kitassembly) | Grafikā ieplānots ražošanas uzdevums: komplekta prece, daudzums, plānotais pabeigšanas datums | SkyPlanner → Visma Net | Mainoties grafikam, izmantojot SkyPlanner webhook |
Kit assembly iegrāmatošana (/v1/kitassembly/{type}/{refNo}/action/release) | Pabeigts ražošanas uzdevums: saražotā produkcija un komponentu patēriņš | SkyPlanner → Visma Net | Pēc pabeigšanas |
Inventory receipt, Inventory issue (/v1/inventoryReceipt, /v1/inventoryissue, iegrāmatošana) | Saražotā produkcija un materiālu patēriņš, ja komplekti netiek izmantoti | SkyPlanner → Visma Net | Pēc pabeigšanas |
Employee time card (/v1/timeCard) | Katra operatora reģistrētās stundas | SkyPlanner → Visma Net | Reizi nedēļā |
Integrācijas modeļi
1. Sākotnējā pamatdatu ielāde. Nolasiet noliktavas preces, preču klases un katra komplekta jaunāko Kit specification redakciju. Sasaistiet katru komponenta rindu ar SkyPlanner materiālu. Pēc tam izveidojiet datus, kuru Visma Net nav: darba centrus, maiņas, procesa posmus ar sagatavošanas un izpildes laikiem, sagatavošanas laiku matricu un instrumentu prasības. Importējiet tos CSV vai Excel formātā. Šī ir apjomīgākā projekta daļa.
2. Pasūtījumu sinhronizācija. Izvēlieties vienu pieprasījuma modeli:
- Pēc pārdošanas pasūtījumiem. Atvērtās pārdošanas pasūtījumu rindas komplektu precēm kļūst par SkyPlanner pasūtījumiem, kuros pieprasītais datums ir izpildes termiņš.
- Pēc komplektēšanas dokumentiem. Visma Net izveidotie Kit assemblies dokumenti ar statusu On hold kļūst par SkyPlanner ražošanas uzdevumiem.
Atvērtie iepirkuma pasūtījumi tiek saņemti kopā ar to datumiem. SkyPlanner uzskata pasūtīto materiālu par pieejamu iepirkuma pasūtījuma piegādes datumā un atjaunina krājumu atlikumus, kad pasūtījumam piešķirts statuss Delivered. Izmantojot arī krājumu kopsavilkumu, grafika sastādīšanā tiek pārbaudīti gan esošie krājumi, gan gaidāmie iepirkumi.
3. Grafika datu ierakstīšana atpakaļ. Ja plānošana balstās uz pārdošanas pasūtījumiem, SkyPlanner katram grafikā ieplānotajam ražošanas uzdevumam izveido Kit assembly dokumentu ar veidu Production. Tajā norāda komplekta preci, redakciju, noliktavu, daudzumu un komponentus un sasaista dokumentu ar pārdošanas pasūtījuma rindu. Komplektēšanas datums ir plānotais pabeigšanas datums. Kad Autopilot pārplāno uzdevumu, datums pirms iegrāmatošanas tiek atjaunināts ar PUT.
Kit assembly ir viens lauks Date, tāpēc operāciju laiki paliek SkyPlanner, bet Visma Net saņem pārdošanai un krājumu uzskaitei svarīgo datumu.
4. Darba izpildes apstiprinājumi ražotnē. Operatori reģistrē darbu, izmantojot Mobile Confirmations vai Production Timer, un laika uzskaites ieraksti nodrošina aktuālu grafiku. Kad pēdējais posms ir pabeigts, SkyPlanner izsauc Kit assembly iegrāmatošanas darbību. Tā iegrāmato saražoto produkciju un komponentu patēriņu, un pēc tam tiek izveidota virsgrāmatas grāmatojumu pakete. Stundas tiek apkopotas iknedēļas Employee time cards vai projektu darījumos, ja darbs tiek veikts projektu ietvaros.
5. Atbildība par datiem un konfliktu risināšanas noteikumi. Dokumentējiet tos pirms ekspluatācijas sākšanas:
| Dati | Atbildīgā sistēma |
|---|---|
| Preces, Kit specifications, pārdošanas pasūtījumi, iepirkuma pasūtījumi, krājumi, izmaksas | Visma Net |
| Procesa posmi, darba centri, maiņas, sagatavošanas darbības, instrumenti | SkyPlanner |
| Ražošanas uzdevumu secība, sākuma un beigu laiks, piesaiste darba centriem | SkyPlanner |
| Kit assembly datums pirms iegrāmatošanas | SkyPlanner |
| Iegrāmatoti Kit assemblies un darba laika uzskaites dokumenti | Visma Net, iegrāmatošanu ierosina SkyPlanner |
Mainot Kit specification, tiek izveidota jauna versija. Atkārtoti nolasiet jaunāko versiju un atjaunojiet datu atbilstības, jo komplektēšanai var izmantot tikai jaunāko versiju. Manuāli veiktās komponentu izmaiņas komplektēšanas dokumentā paliek spēkā Visma Net sistēmā, tāpēc SkyPlanner pirms iegrāmatošanas atkārtoti nolasa šo dokumentu.
Tipiskie projekta posmi
Ieviešanu parasti pabeidz dažu nedēļu laikā pēc ieviešanas procesa sākuma. Pirms tam 30 dienu bezmaksas izmēģinājumā varat izmantot savus datus, kas iegūti ar Visma Net eksporta scenāriju un importēti CSV vai Excel formātā.
- Tvēruma noteikšana. Nosakiet pieprasījuma modeli, datu atbilstību tabulu, atbildības noteikumus un to, kur rakstīt datus atpakaļ (Kit assembly vai krājumu saņemšanas dokumentos).
- Visma Connect iestatīšana. Reģistrējiet Service Integration un saņemiet nomnieka administratora apstiprinājumu. Vispirms veiciet pārbaudi demonstrācijas uzņēmumā.
- Ražošanas modelis. Darba centri, maiņas, procesa posmi, sagatavošanas darbības un instrumenti SkyPlanner sistēmā.
- Sākotnējā datu ielāde. Noliktavas preces, preču klases, Kit specifications, noliktavas un krājumi.
- Pārdošanas un iepirkuma pasūtījumu sinhronizācija. Pārdošanas pasūtījumiem, iepirkuma pasūtījumiem un precēm izmanto webhook paziņojumus, bet komplektiem un krājumiem — periodisku datu pieprasīšanu. Šajā posmā īsteno arī pilnvaru atjaunošanu un 429 atbilžu apstrādi.
- Datu rakstīšana atpakaļ. Kit assembly izveide, atjaunināšana un iegrāmatošana, kā arī darba laika uzskaites dokumenti.
- Paralēlā testēšana. Izmantojiet SkyPlanner paralēli pašreizējam plānam un salīdziniet datumus.
- Ekspluatācijas sākšana. Ieslēdziet datu rakstīšanu atpakaļ, kad dati sakrīt.
Kas jāņem vērā, plānojot Visma Net integrāciju
- Nav importējamu tehnoloģisko procesu. Visus procesa posmus, sagatavošanas un izpildes laikus vispirms definē SkyPlanner sistēmā. Ieplānojiet nepieciešamo darbu un nosakiet atbildīgo.
- Advanced logistics. Kit assembly izmantošanai nepieciešama Advanced logistics grupa. Ja izmantojat Standard logistics, saražoto produkciju iegrāmatojiet ar Inventory receipt un Inventory issue.
- Bloķētas versijas. Izmantotu Kit specification versiju nevar rediģēt, un komplektēšanai var izmantot tikai jaunāko versiju.
- Mērvienības. Kit assembly ir sava mērvienība. Importējot saskaņojiet to ar SkyPlanner daudzumiem.
- Periodiska datu pieprasīšana bez notikumiem. Komplektiem nav tīmekļa aizķeru. Lai nepārsniegtu stundas pieprasījumu ierobežojumu, izmantojiet
lastModifiedDateTime, lai nolasītu tikai izmaiņas, nevis atkārtoti ielādētu visus datus. - Aktuālie galapunkti. Integrācijas izstrādē izmantojiet tikai
api.finance.visma.netun SalesOrder service v3. - Nomnieka apstiprinājums. Autentifikācija ar klienta akreditācijas datiem nedarbosies, kamēr nomnieka administrators nebūs apstiprinājis lietotni. Ieplānojiet šo soli laikus.
- Nedēļas darba laika uzskaite. Darba laika uzskaites dokumentiem nepieciešams Advanced financials, un tos veido par nedēļu. Apkopojiet operatoru nostrādātās stundas pa nedēļām vai iegrāmatojiet tās projektu darījumos.
Kas konfigurē Visma Net integrāciju un nodrošina tās atbalstu
- SkyPlanner komanda konfigurē integrāciju ieviešanas laikā un nodrošina atbalstu pēc ekspluatācijas sākšanas. Tas ietver SkyPlanner pusi, ražošanas modeli, kura Visma Net nav, un saskaņotos Visma Net API izsaukumus. Katrā rūpnīcā Visma Net izmanto atšķirīgi, un konfigurācijā šīs zināšanas tiek liktas lietā.
- Var piedalīties arī jūsu Visma Net partneris. Visma nodrošina Visma Net kopā ar Visma sertificētiem partneriem, kuri pārzina jūsu konfigurāciju un var pārskatīt datu atbilstības un Visma Connect lietotni. SkyPlanner nodrošina REST API, Swagger/OpenAPI dokumentāciju un tīmekļa aizķeres.
- Integrāciju var izstrādāt arī jūsu izstrādātāji, izmantojot to pašu dokumentēto REST API un API pilnvaru. Lai sāktu, pietiek ar API pilnvaru, un SkyPlanner komanda vajadzības gadījumā palīdz. Publiskā dokumentācija ir pieejama SkyPlanner dokumentācijā.
Kad savienojums ir izveidots, Arcturus dzinis sastāda grafiku, izmantojot aktuālos Visma Net pasūtījumus, un pabeigtie darbi nonāk atpakaļ Visma Net kā iegrāmatoti Kit assemblies. Cena ir no 199 € mēnesī, ietverot 5 darba centrus, ar ikmēneša norēķiniem. Integrācijas cenu nosaka iepriekš atbilstoši jūsu procesam un vajadzībām un norāda kopā ar izvēlētā plāna cenu, lai visas izmaksas būtu zināmas pirms darba sākuma.
Apskatiet cenas un uzziniet, kāpēc Visma Net nepieciešams grafiku sastādīšanas rīks, sadaļā Visma Net ražošanas plānošana, ievērojot reālo iekārtu un personāla jaudu. Pārskats pieejams Visma Net lapā, bet informācija par citām ERP sistēmām — ERP integrāciju sadaļā.
Ražotāju atsauksmes par SkyPlanner
2 hietaupītas katru nedēļu
“Ar SkyPlanner mūsu ražošanas plānošana ir pārgājusi no Excel izklājlapām uz ražošanas optimizāciju reāllaikā.”
Kalle Kalliomäki, piegādes ķēdes speciālists
UTU · Elektriskās sadalnes un komutācijas iekārtas
Ražošanas plānošana katru nedēļu ietaupa 2 darba stundas, un jaunā darbu rinda ražošanas līnijā nonāk dažu sekunžu laikā.
+90%ražošanas efektivitāte
“Ražošanas efektivitāte ir pieaugusi par 90%.”
Abdul Rucyinga, IT vadītājs
Laboratory & Allied · Farmaceitisko produktu ražošana
Ražošanas efektivitāte ir pieaugusi par 90%, un optimizēta trīs mēnešu plāna izveide visiem darba centriem aizņem mazāk nekā 30 minūtes.
98%piegāžu savlaicīgums, iepriekš — aptuveni 50%
“SkyPlanner ir izšķiroša nozīme mūsu piegāžu savlaicīguma uzturēšanā.”
Hannu Lahtinen, izpilddirektors
KJH-Comp · Lokšņu metāla apstrāde un līgumražošana
Piegāžu savlaicīgums pieauga no aptuveni 50% līdz pat 98%, un grafiku sastādīšanai tagad vajadzīgs viens meistars, nevis divi.
6 mēnešusuz priekšu pārdošanas komanda redz brīvo jaudu
“SkyPlanner rada pamatu visai ražošanas plānošanai un nodrošina tās uzticamību.”
Anu Järvinen, ražošanas vadītāja
Fredman Operations · Saskarei ar pārtiku piemērots iepakojuma papīrs
Pārdošanas komanda redz brīvo jaudu sešus mēnešus uz priekšu, un uz grafika izmaiņu pieprasījumiem, kas agrāk prasīja stundu vai ilgāk, tagad atbild dažu sekunžu laikā.
Biežāk uzdotie jautājumi
Vai Visma Net API ir ražošanas pasūtījumi?
Nē. Visma Net nav ražošanas pasūtījumu, tehnoloģisko procesu vai darba centru objektu, tāpēc to nav arī API. Ražošanas dokuments ir Kit assembly, kas pieejams adresē /v1/kitassembly, savukārt tehnoloģiskos procesus un darba centrus uztur SkyPlanner.
Kādu autentifikāciju izmanto integrācija?
Integrācija izmanto Visma Connect ar OAuth 2.0 klienta akreditācijas datu plūsmu un ir reģistrēta kā Service Integration portālā Visma Developer Portal. Integrāciju apstiprina nomnieka administrators, un pilnvaras ir derīgas vienu stundu.
Vai Visma Net var nosūtīt izmaiņas reāllaikā?
Precēm, pārdošanas pasūtījumiem un iepirkuma pasūtījumiem — jā, izmantojot Visma Developer Portal tīmekļa aizķeres. Kit assemblies un Kit specifications nav notikumu, tāpēc to izmaiņas nolasa ar periodiskiem pieprasījumiem, atlasot tikai mainītos datus. SkyPlanner tīmekļa aizķeres nosūta grafika izmaiņas, tiklīdz tās notiek.
Kā pabeigtās ražošanas dati tiek ierakstīti atpakaļ Visma Net?
SkyPlanner izveido Kit assembly katram ieplānotajam ražošanas uzdevumam, atjaunina tā datumu un pēc uzdevuma pabeigšanas izsauc darbību release. Šī darbība iegrāmato saražoto produkciju un komponentu patēriņu. Ja komplektus neizmanto, to pašu paveic Inventory receipt un Inventory issue.
Vai varam izmēģināt SkyPlanner pirms integrācijas izstrādes?
Jā. 30 dienu bezmaksas izmēģinājumā var izmantot līdz 20 darba centriem un importēt Visma Net datus CSV vai Excel formātā. Kredītkarte nav nepieciešama. Sāciet izmēģinājumu vai sazinieties ar pārdošanas komandu, lai noteiktu integrācijas tvērumu.
