Integracije / ERP / Visma Net ERP
Vodnik za integracijo Visma Net za terminiranje proizvodnje s SkyPlanner APS
Ta vodnik partnerjem in ekipam IT pojasnjuje, kako Visma Net (Visma.net ERP) povezati s SkyPlanner APS. SkyPlanner prek Visma Net API izmenjuje podatke z Visma Net v obe smeri:
- V SkyPlanner se prenašajo Stock items, Kit specifications, prodajna naročila, stanje zalog in nabavna naročila.
- Iz terminiranih operacij nastanejo Kit assemblies, ki se sprostijo po končanem delu.
- Delovne ure operaterjev se vrnejo kot Employee time cards.
- SkyPlanner prek webhookov pošilja spremembe terminskega plana takoj, ko se zgodijo.
Ekipa SkyPlanner med uvajanjem prilagodi integracijo vaši nastavitvi Visma Net in zanjo zagotavlja podporo tudi po zagonu. Ta vodnik je namenjen partnerjem in razvijalcem, ki želijo sodelovati pri integraciji ali sami razvijati rešitve z dokumentiranim REST API sistema SkyPlanner (referenčna dokumentacija API).
Integracijski vmesniki Visma Net
- Visma Net ERP API. Vmesnik REST s specifikacijo OpenAPI, ki še vedno nosi naslov “Visma.net ERP API v1”, ter potmi v1 in v2. Osnovni URL je
https://api.finance.visma.net. Na stari domeniintegration.visma.netse od 1. februarja 2026 omejuje hitrost zahtevkov, domena pa je v postopku ukinjanja (obvestilo). - SalesOrder service v3 je na naslovu
https://salesorder.visma.net. Končne točke v1 in v2 za prodajna naročila so dosegle konec življenjske dobe. - Spletni kavlji prek portala Visma Developer Portal.
- Background API. Z glavo
erp-api-backgroundse dolgotrajni klici uvrstijo v čakalno vrsto. Odgovor vrne kodo 202 z identifikatorjem opravila, ko je rezultat pripravljen, pa prejmete obvestilo. - Scenariji uvoza in izvoza v Visma Net s ponudniki podatkov CSV, Excel ali SQL za enkratno nalaganje matičnih podatkov.
API nima končnih točk za proizvodne naloge, tehnološke postopke ali delovne centre, ker Visma Net teh objektov nima. Podatki za terminiranje izhajajo iz artiklov, kompletov, naročil in zalog:
GET /v1/inventory: skladiščni in neskladiščni artikli, vključno z oznako kompleta in razredom artiklaGET /v1/KitSpecifications/{kitInventoryID}/{revisionID}: vrstice komponent po revizijahGET /v1/kitassembly: obstoječi sestavi, ki jih je mogoče filtrirati po vrsti in statusu- SalesOrder service v3: povpraševanje z zahtevanimi datumi in postavkami
GET /v1/inventorysummary/{inventoryNumber}: dejanska in razpoložljiva zaloga po skladiščihGET /v1/purchaseorderinGET /v2/PurchaseReceipt: prihajajoči material in prevzemi
Vse končne točke za sezname sprejemajo lastModifiedDateTime skupaj z lastModifiedDateTimeCondition ter pageNumber in pageSize, zato lahko pri vsaki sinhronizaciji prenesete le spremembe.
Avtentikacija in omejitve
Visma Net uporablja Visma Connect (OpenID Connect in OAuth 2.0):
- V portalu Visma Developer Portal registrirajte Service Integration.
- Integracijo odobri skrbnik najemnika v strankinem sistemu Visma Net.
- Žetone zahtevajte s tokom client credentials na naslovu
https://connect.visma.com/connect/token. Pri tem posredujtetenant_idin obsege dovoljenj API, kot jevisma_api:read. Žetoni veljajo 3.600 sekund.
Omejitve števila zahtevkov veljajo v fiksnem enournem oknu za vsako podjetje in odjemalca. Odgovori vsebujejo X-RateLimit-Limit, X-RateLimit-Remaining in X-RateLimit-Reset. Ob prekoračitvi omejitve se vrne koda 429 z Retry-After (omejitve števila zahtevkov). Glavi ETag in If-Match varujeta posodobitve.
Partnerji lahko prek brezplačnega programa Visma Integrator Programme testirajo na predstavitvenem podjetju. Na strani SkyPlanner se REST API avtenticira z žetonom API (SkyPlanner Settings > API), dokumentacija pa je na voljo v Swagger/OpenAPI. Vodič za integracijo vas popelje skozi prve klice.
Dogodki, spletni kavlji in periodično poizvedovanje
Spletni kavlji v portalu Visma Developer Portal pokrivajo dogodke, pomembne za terminiranje:
- Dogodki Inventory Item Created, Updated in Changed
- Dogodka Purchase Order Changed in Status Changed
- Dogodka Sales Order Changed in Status Changed, ki prehajata k izdajatelju SalesOrderService
Za Kit assembly in Kit specifications ni dogodkov. SkyPlanner zanje periodično poizveduje s filtri lastModifiedDateTime. Stanje zalog pridobi ob zagonu terminiranja. V nasprotni smeri SkyPlanner pošilja spletne kavlje ob spremembah stanja ali terminskega plana.
Preslikava podatkov
| Objekt Visma Net (končna točka) | Objekt SkyPlanner | Smer | Pogostost |
|---|---|---|---|
Stock items, Non-stock items (/v1/inventory) | Izdelki in materiali | Visma Net → SkyPlanner | Začetno nalaganje, nato spletni kavelj |
Kit specifications (/v1/KitSpecifications) | Struktura izdelka, materiali po izdelkih | Visma Net → SkyPlanner | Začetno nalaganje, nato periodično poizvedovanje |
| Prodajna naročila (SalesOrder service v3) | Naročila z roki izvedbe in prednostno stopnjo stranke | Visma Net → SkyPlanner | Spletni kavelj |
Kit assembly s statusom On hold (/v1/kitassembly), če se sestavi ustvarjajo v Visma Net | Operacije | Visma Net → SkyPlanner | Periodično poizvedovanje |
Inventory summary (/v1/inventorysummary) | Stanje zalog po skladiščih | Visma Net → SkyPlanner | Poizvedovanje ob zagonu terminiranja |
Nabavna naročila, prevzemi blaga (/v1/purchaseorder, /v2/PurchaseReceipt) | Prihajajoči material z datumom dobave; posodobitev zalog ob dobavi po nabavnem naročilu | Visma Net → SkyPlanner | Spletni kavelj, nato branje |
| Ni v Visma Net | Koraki postopka, delovni centri, izmene, matrika pripravljalnih časov, orodja, alternativni viri | Vzdrževanje v SkyPlanner | Nastavitev med uvajanjem |
Ustvarjanje in posodabljanje Kit assembly (POST/PUT /v1/kitassembly) | Terminirana operacija: artikel kompleta, količina, načrtovani datum zaključka | SkyPlanner → Visma Net | Ob spremembi terminskega plana prek spletnega kavlja SkyPlanner |
Sprostitev Kit assembly (/v1/kitassembly/{type}/{refNo}/action/release) | Zaključena operacija: izdelana količina in poraba komponent | SkyPlanner → Visma Net | Ob zaključku |
Inventory receipt, Inventory issue (/v1/inventoryReceipt, /v1/inventoryissue, sprostitev) | Izdelana količina in poraba materiala, kadar se kompleti ne uporabljajo | SkyPlanner → Visma Net | Ob zaključku |
Employee time card (/v1/timeCard) | Evidentirane ure po operaterjih | SkyPlanner → Visma Net | Tedensko |
Načini integracije
1. Začetno nalaganje matičnih podatkov. Preberite skladiščne artikle, razrede artiklov in najnovejšo revizijo Kit specification za vsak komplet. Vsako vrstico komponente preslikajte v material v SkyPlanner. Nato določite podatke, ki jih Visma Net ne hrani: delovne centre, izmene, korake postopka s pripravljalnimi časi in časi izvajanja, matriko pripravljalnih časov ter zahteve glede orodij. Uvozite jih v obliki CSV ali Excel. To je največji del projekta.
2. Sinhronizacija naročil. Izberite en model povpraševanja:
- Na podlagi prodajnih naročil. Odprte postavke prodajnih naročil za artikle kompletov postanejo naročila v SkyPlanner, pri čemer se zahtevani datum uporabi kot rok izvedbe.
- Na podlagi sestavov. Kit assemblies, ustvarjeni v Visma Net s statusom On hold, postanejo operacije v SkyPlanner.
Odprta nabavna naročila se prenesejo skupaj z datumi. SkyPlanner obravnava naročeni material kot razpoložljiv na datum dobave nabavnega naročila in posodobi zalogo, ko naročilo dobi status Delivered. Pri terminiranju tako na podlagi pregleda zalog in nabavnih naročil preverja tako zalogo kot pričakovane dobave.
3. Povratni zapis terminskega plana. Pri modelu na podlagi prodajnih naročil SkyPlanner za vsako terminirano operacijo ustvari Kit assembly vrste Production. Določi artikel kompleta, revizijo, skladišče, količino in komponente ter sestav poveže s postavko prodajnega naročila. Datum sestava je načrtovani datum zaključka. Ko Autopilot premakne operacijo, se datum pred sprostitvijo posodobi s klicem PUT.
Kit assembly ima eno polje Date, zato časi posameznih operacij ostanejo v SkyPlanner, Visma Net pa prejme datum, ki je pomemben za prodajo in zaloge.
4. Potrjevanje dela v proizvodnji. Operaterji evidentirajo delo z Mobile Confirmations ali Production Timer, evidence časa pa skrbijo za ažurnost terminskega plana. Ko je zadnji korak končan, SkyPlanner za Kit assembly pokliče dejanje sprostitve. Sprostitev knjiži izdelano količino in porabo komponent, nato sledi paket knjižb v glavni knjigi. Ure se združijo v tedenske Employee time cards, pri projektnem delu pa v projektne transakcije.
5. Pravila o lastništvu podatkov in odpravljanju neskladij. Zapišite jih pred prehodom v produkcijo:
| Podatki | Lastnik |
|---|---|
| Artikli, Kit specifications, prodajna naročila, nabavna naročila, zaloga, stroški | Visma Net |
| Koraki procesa, delovni centri, izmene, priprave, orodja | SkyPlanner |
| Zaporedje operacij, časi začetka in konca, dodelitev delovnim centrom | SkyPlanner |
| Datum dokumenta Kit assembly pred sprostitvijo | SkyPlanner |
| Sproščeni dokumenti Kit assemblies in evidence delovnega časa | Visma Net, knjiženje iz sistema SkyPlanner |
Sprememba dokumenta Kit specification ustvari novo revizijo. Znova preberite najnovejšo revizijo in ponovno določite preslikavo, saj je za izdelavo mogoče uporabiti le zadnjo revizijo. Ročne spremembe komponent na dokumentu za sestavljanje ostanejo veljavne v sistemu Visma Net, zato SkyPlanner pred sprostitvijo ta dokument znova prebere.
Običajni koraki projekta
Implementacija je običajno končana v nekaj tednih po začetku uvajanja. Pred tem lahko v 30-dnevnem brezplačnem preizkusu uporabljate lastne podatke iz izvoznega scenarija Visma Net, uvožene v obliki CSV ali Excel.
- Opredelitev obsega. Določite model povpraševanja, tabelo preslikav, pravila o lastništvu podatkov in cilj povratnega zapisovanja (Kit assembly ali prevzemi zaloge).
- Nastavitev Visma Connect. Registrirajte Service Integration in pridobite odobritev skrbnika najemnika. Najprej izvedite preizkus v predstavitvenem podjetju.
- Proizvodni model. Delovni centri, izmene, koraki procesa, priprave in orodja v sistemu SkyPlanner.
- Začetni uvoz. Skladiščni artikli, razredi artiklov, Kit specifications, skladišča, zaloga.
- Sinhronizacija prodajnih in nabavnih naročil. Spletni kavlji za prodajna naročila, nabavna naročila in artikle; periodično poizvedovanje za komplete in zalogo. V tem koraku uredite tudi obnavljanje žetonov in obravnavo odzivov 429.
- Povratno zapisovanje. Ustvarjanje, posodabljanje in sproščanje dokumentov Kit assembly ter evidence delovnega časa.
- Vzporedno testiranje. SkyPlanner uporabljajte vzporedno z obstoječim planom in primerjajte datume.
- Prehod v produkcijo. Ko se podatki ujemajo, vklopite povratno zapisovanje.
Kaj upoštevati pri integraciji s sistemom Visma Net
- Ni tehnoloških postopkov za uvoz. Vse korake procesa ter pripravljalne in izvajalne čase je treba določiti v sistemu SkyPlanner. Predvidite potrebno delo in določite odgovorno osebo.
- Advanced logistics. Kit assembly zahteva skupino Advanced logistics. Pri Standard logistics izdelano količino knjižite z dokumentoma Inventory receipt in Inventory issue.
- Zaklenjene revizije. Že uporabljene revizije Kit specification ni mogoče urejati, za izdelavo pa je mogoče uporabiti le najnovejšo revizijo.
- Merske enote. Kit assembly ima svojo mersko enoto. Ob uvozu jo uskladite s količinami v sistemu SkyPlanner.
- Periodično poizvedovanje brez dogodkov. Kompleti ne podpirajo obvestil webhook. Pridobivajte le spremembe na podlagi
lastModifiedDateTime, namesto da vsakič znova nalagate vse podatke. Tako ne boste presegli urne omejitve števila zahtev. - Aktualne končne točke. Integracijo gradite samo na
api.finance.visma.netin SalesOrder service v3. - Odobritev najemnika. Poverilnice odjemalca ne delujejo, dokler skrbnik najemnika ne odobri aplikacije. Ta korak načrtujte dovolj zgodaj.
- Tedenske evidence delovnega časa. Evidence delovnega časa zahtevajo Advanced financials in se vodijo tedensko. Ure operaterjev združite po tednih ali jih knjižite med projektne transakcije.
Kdo nastavi integracijo s sistemom Visma Net in zagotavlja podporo
- Ekipa SkyPlanner integracijo nastavi med uvajanjem in zanjo zagotavlja podporo po prehodu v produkcijo. To vključuje nastavitve na strani sistema SkyPlanner, proizvodni model, ki ga Visma Net nima, in dogovorjene klice API-ja Visma Net. Vsak obrat uporablja Visma Net drugače in pri teh nastavitvah se upošteva prav to poznavanje vašega načina dela.
- Sodeluje lahko tudi vaš partner za Visma Net. Visma zagotavlja Visma Net skupaj s partnerji, ki jih je certificirala. Ti poznajo vašo konfiguracijo ter lahko pregledajo preslikave in aplikacijo Visma Connect. SkyPlanner zagotavlja REST API, dokumentacijo Swagger/OpenAPI in obvestila webhook.
- Integracijo lahko izdelajo tudi vaši razvijalci, in sicer z istim dokumentiranim REST API-jem in žetonom API. Za začetek zadostuje žeton API, ekipa SkyPlanner pa po potrebi pomaga. Javna dokumentacija je na voljo na strani Dokumentacija SkyPlanner.
Po vzpostavitvi povezave mehanizem Arcturus terminira proizvodnjo na podlagi aktualnih naročil iz sistema Visma Net, opravljeno delo pa se vrne v Visma Net kot sproščeni dokumenti Kit assemblies. Cena se začne pri 199 € na mesec in vključuje 5 delovnih centrov, obračunavanje pa je mesečno. Ponudbo za integracijo pripravimo vnaprej glede na vaš proces in potrebe ter jo predložimo skupaj s ponudbo za paket, da pred začetkom poznate celoten strošek.
Oglejte si cenik in v članku Terminiranje proizvodnje za Visma Net preberite, zakaj Visma Net potrebuje orodje za terminiranje. Pregled najdete na strani Visma Net, druge sisteme ERP pa v pregledu integracij z ERP.
Mnenja proizvodnih podjetij o sistemu SkyPlanner
2 hprihranka vsak teden
»S sistemom SkyPlanner smo pri planiranju proizvodnje prešli z Excelovih preglednic na optimizacijo proizvodnje v realnem času.«
Kalle Kalliomäki, strokovnjak za oskrbovalno verigo
UTU · Električni razdelilniki in stikalne naprave
Pri planiranju proizvodnje vsak teden prihranijo 2 uri dela, novo zaporedje operacij pa do proizvodne linije prispe v nekaj sekundah.
+90%učinkovitost proizvodnje
»Učinkovitost proizvodnje se je povečala za 90%.«
Abdul Rucyinga, vodja IT
Laboratory & Allied · Farmacevtska proizvodnja
Učinkovitost proizvodnje se je povečala za 90%, priprava optimiziranega trimesečnega plana za vse delovne centre pa traja manj kot 30 minut.
98%zanesljivost dobav, prej približno 50%
»SkyPlanner ima odločilno vlogo pri ohranjanju naše zanesljivosti dobav.«
Hannu Lahtinen, direktor
KJH-Comp · Izdelava pločevinastih delov in pogodbena proizvodnja
Zanesljivost dobav se je povečala s približno 50% na kar 98%, za terminiranje pa zdaj namesto dveh vodij potrebujejo le enega.
6 mesecevvnaprej prodaja vidi proste zmogljivosti
»SkyPlanner je temelj celotnega planiranja proizvodnje in zagotavlja njegovo zanesljivost.«
Anu Järvinen, vodja proizvodnje
Fredman Operations · Papir za embalažo, primeren za stik z živili
Prodaja ima vpogled v proste zmogljivosti za šest mesecev vnaprej. Na zahteve za spremembo terminskega plana, za katere so prej potrebovali uro ali več, zdaj odgovorijo v nekaj sekundah.
Pogosta vprašanja
Ali API Visma Net podpira proizvodne naloge?
Ne. Visma Net nima objektov za proizvodne naloge, tehnološke postopke ali delovne centre, zato jih tudi API nima. Proizvodni dokument je Kit assembly na /v1/kitassembly, tehnološke postopke in delovne centre pa hrani SkyPlanner.
Kakšno avtentikacijo uporablja integracija?
Integracija uporablja Visma Connect s tokom OAuth 2.0 client credentials in je registrirana kot Service Integration v Visma Developer Portal. Odobri jo skrbnik najemnika, žetoni pa veljajo eno uro.
Ali lahko Visma Net pošilja spremembe v realnem času?
Za artikle ter prodajna in nabavna naročila da, prek obvestil webhook v Visma Developer Portal. Kit assemblies in Kit specifications nimajo dogodkov, zato se s periodičnim poizvedovanjem pridobivajo le spremembe. SkyPlanner z lastnimi obvestili webhook pošilja spremembe terminskega plana takoj, ko nastanejo.
Kako se zaključena proizvodnja zapiše nazaj v Visma Net?
SkyPlanner za vsako terminirano operacijo ustvari Kit assembly, sproti posodablja njegov datum in po zaključku operacije pokliče dejanje za sprostitev. Sprostitev knjiži izdelano količino in porabo komponent. Brez kompletov enako nalogo opravita Inventory receipt in Inventory issue.
Ali lahko SkyPlanner preizkusimo pred izdelavo integracije?
Da. V 30-dnevnem brezplačnem preizkusu lahko uporabljate do 20 delovnih centrov in uvažate podatke iz sistema Visma Net v obliki CSV ali Excel. Kreditne kartice ne potrebujete. Začnite preizkus ali stopite v stik s prodajo, da opredelite obseg integracije.
