Integrări / ERP / Visma Net ERP
Ghid de integrare Visma Net pentru programarea producției cu SkyPlanner APS
Acest ghid de integrare Visma Net le arată partenerilor și echipelor IT cum să conecteze Visma Net (Visma.net ERP) la SkyPlanner APS. SkyPlanner se integrează bidirecțional cu Visma Net prin Visma Net API:
- Se importă articolele stocabile, Kit specifications, comenzile de vânzare, nivelurile stocurilor și comenzile de achiziție.
- Operațiile programate devin înregistrări Kit assembly, care sunt validate la finalizarea lucrului.
- Orele lucrate de operatori sunt trimise înapoi ca înregistrări Employee time cards.
- Webhook-urile SkyPlanner transmit modificările programului pe măsură ce apar.
Echipa SkyPlanner adaptează integrarea la configurația dumneavoastră Visma Net în etapa de implementare și asigură asistență după punerea în funcțiune. Acest ghid se adresează partenerilor și dezvoltatorilor care vor să participe sau să dezvolte singuri soluții folosind REST API documentat al SkyPlanner (documentația API).
Interfețele de integrare Visma Net
- Visma Net ERP API. REST cu o specificație OpenAPI intitulată în continuare “Visma.net ERP API v1”, cu căi v1 și v2. URL-ul de bază este
https://api.finance.visma.net. Vechiul domeniuintegration.visma.netare traficul limitat începând cu 1 februarie 2026 și este în curs de închidere (anunț). - SalesOrder service v3 la
https://salesorder.visma.net. Endpointurile v1 și v2 pentru comenzile de vânzare au ajuns la sfârșitul ciclului de viață. - Webhookuri prin Visma Developer Portal.
- Background API. Antetul
erp-api-backgroundpune în coadă apelurile de lungă durată, returnează 202 cu un ID de sarcină și vă notifică atunci când rezultatul este gata. - Scenarii de import și export în Visma Net, cu furnizori de date CSV, Excel sau SQL, pentru încărcări punctuale ale nomenclatoarelor.
API-ul nu are endpointuri pentru comenzi de producție, fluxuri tehnologice sau centre de lucru, deoarece Visma Net nu conține astfel de obiecte. Datele necesare programării provin din articole, kituri, comenzi și stocuri:
GET /v1/inventory: articole stocabile și nestocabile, inclusiv indicatorul de kit și clasa articoluluiGET /v1/KitSpecifications/{kitInventoryID}/{revisionID}: linii de componente pentru fiecare revizieGET /v1/kitassembly: asamblări existente, care pot fi filtrate după tip și stare- SalesOrder service v3: cerere cu termenele solicitate și liniile de comandă
GET /v1/inventorysummary/{inventoryNumber}: cantități în stoc și disponibile pentru fiecare depozitGET /v1/purchaseorderșiGET /v2/PurchaseReceipt: materiale de aprovizionat și recepții
Toate endpointurile de listare acceptă lastModifiedDateTime împreună cu lastModifiedDateTimeCondition, precum și pageNumber și pageSize, astfel încât fiecare sincronizare poate fi incrementală.
Autentificare și limite
Visma Net folosește Visma Connect (OpenID Connect și OAuth 2.0):
- Înregistrați o Service Integration în Visma Developer Portal.
- Administratorul instanței Visma Net a clientului aprobă integrarea.
- Solicitați tokenuri prin fluxul client credentials la
https://connect.visma.com/connect/token, transmițândtenant_idși domeniile de acces API, cum ar fivisma_api:read. Tokenurile sunt valabile 3.600 de secunde.
Limitele de apeluri se aplică într-o fereastră orară fixă, pentru fiecare companie și client. Răspunsurile includ X-RateLimit-Limit, X-RateLimit-Remaining și X-RateLimit-Reset, iar depășirea limitei returnează 429 cu Retry-After (limite de apeluri). Anteturile ETag și If-Match protejează actualizările.
Partenerii testează pe o companie demonstrativă prin programul gratuit Integrator Programme de la Visma. În SkyPlanner, autentificarea pentru REST API se face cu un token API (SkyPlanner Settings > API), iar documentația este disponibilă în Swagger/OpenAPI. Tutorialul de integrare vă ghidează prin primele apeluri.
Evenimente, webhookuri și interogări periodice
Webhookurile din Visma Developer Portal acoperă evenimentele relevante pentru programare:
- Inventory Item Created, Updated și Changed
- Purchase Order Changed și Status Changed
- Sales Order Changed și Status Changed, care trec la sursa de evenimente SalesOrderService
Nu există evenimente pentru Kit assembly sau Kit specifications. SkyPlanner le interoghează periodic folosind filtre lastModifiedDateTime. Soldurile stocurilor sunt interogate la rularea programării. În sens invers, SkyPlanner trimite webhookuri când se schimbă starea sau programul de producție.
Maparea datelor
| Obiect Visma Net (endpoint) | Obiect SkyPlanner | Direcție | Frecvență |
|---|---|---|---|
Articole stocabile și nestocabile (/v1/inventory) | Produse și materiale | Visma Net → SkyPlanner | Încărcare inițială, apoi webhook |
Kit specifications (/v1/KitSpecifications) | Structura produsului, materiale pentru fiecare produs | Visma Net → SkyPlanner | Încărcare inițială, apoi interogări periodice |
| Comenzi de vânzare (SalesOrder service v3) | Comenzi cu termene de livrare și prioritatea clientului | Visma Net → SkyPlanner | Webhook |
Kit assembly cu starea On hold (/v1/kitassembly), dacă asamblările sunt create în Visma Net | Operații | Visma Net → SkyPlanner | Interogări periodice |
Situația stocurilor (/v1/inventorysummary) | Solduri de stoc pentru fiecare depozit | Visma Net → SkyPlanner | Interogare la rularea programării |
Comenzi de achiziție, recepții de achiziții (/v1/purchaseorder, /v2/PurchaseReceipt) | Materiale de aprovizionat, cu data livrării; actualizarea stocului la livrarea comenzii de achiziție | Visma Net → SkyPlanner | Webhook, apoi citire |
| Nu există în Visma Net | Etape de proces, centre de lucru, schimburi, matricea timpilor de pregătire, scule, resurse alternative | Gestionate în SkyPlanner | Configurate în etapa de implementare |
Creare și actualizare Kit assembly (POST/PUT /v1/kitassembly) | Operație programată: articol de tip kit, cantitate, data planificată de finalizare | SkyPlanner → Visma Net | La modificarea programului, prin webhook SkyPlanner |
Validare Kit assembly (/v1/kitassembly/{type}/{refNo}/action/release) | Operație finalizată: producție realizată și consum de componente | SkyPlanner → Visma Net | La finalizare |
Intrare în stoc, ieșire din stoc (/v1/inventoryReceipt, /v1/inventoryissue, validare) | Producție realizată și consum de materiale, când nu se folosesc kituri | SkyPlanner → Visma Net | La finalizare |
Employee time card (/v1/timeCard) | Ore înregistrate pentru fiecare operator | SkyPlanner → Visma Net | Săptămânal |
Modele de integrare
1. Încărcarea inițială a nomenclatoarelor. Citiți articolele stocabile, clasele de articole și cea mai recentă revizie Kit specification pentru fiecare kit. Asociați fiecare linie de componentă cu un material din SkyPlanner. Apoi definiți ceea ce nu există în Visma Net: centrele de lucru, schimburile, etapele de proces cu timpii de pregătire și de execuție, matricea timpilor de pregătire și cerințele de scule. Importați aceste date în format CSV sau Excel. Aceasta este cea mai mare parte a proiectului.
2. Sincronizarea comenzilor. Alegeți un singur model pentru preluarea cererii:
- Pe baza comenzilor de vânzare. Liniile deschise din comenzile de vânzare pentru articolele de tip kit devin comenzi SkyPlanner, cu data solicitată drept termen de livrare.
- Pe baza asamblărilor. Înregistrările Kit assembly create în Visma Net cu starea On hold devin operații SkyPlanner.
Comenzile de achiziție deschise sunt importate împreună cu datele lor. SkyPlanner consideră că materialul comandat este disponibil la data livrării din comanda de achiziție și actualizează stocul când comanda este marcată Delivered. Folosind și situația stocurilor, programarea verifică atât stocul existent, cât și achizițiile care urmează să sosească.
3. Scrierea programului înapoi în ERP. Într-o configurație bazată pe comenzi de vânzare, SkyPlanner creează o înregistrare Kit assembly de tip Production pentru fiecare operație programată. Completează articolul de tip kit, revizia, depozitul, cantitatea și componentele și leagă asamblarea de linia comenzii de vânzare. Data asamblării este data planificată de finalizare. Când Autopilot mută operația, un apel PUT actualizează data înainte de validare.
Kit assembly are un singur câmp Date, așa că detaliile de timp la nivel de operație rămân în SkyPlanner, iar Visma Net primește data relevantă pentru vânzări și stocuri.
4. Confirmări din producție. Operatorii își înregistrează activitatea cu Mobile Confirmations sau Production Timer, iar înregistrările de timp mențin programul la zi. La finalizarea ultimei etape, SkyPlanner apelează acțiunea de validare pentru Kit assembly. Validarea înregistrează producția realizată și consumul de componente, după care urmează lotul de înregistrări din registrul contabil general. Orele sunt centralizate săptămânal în Employee time cards sau în tranzacții de proiect pentru lucrările bazate pe proiecte.
5. Responsabilitatea asupra datelor și regulile de soluționare a conflictelor. Documentați-le înainte de punerea în funcțiune:
| Date | Sistem responsabil |
|---|---|
| Articole, Kit specifications, comenzi de vânzare, comenzi de achiziție, stocuri, costuri | Visma Net |
| Etape de proces, centre de lucru, schimburi, pregătiri, scule | SkyPlanner |
| Succesiunea operațiilor, orele de început și de sfârșit, alocarea la centrele de lucru | SkyPlanner |
| Data documentului Kit assembly înainte de validare | SkyPlanner |
| Documente Kit assembly și pontaje validate | Visma Net, cu înregistrare din SkyPlanner |
Modificarea unei Kit specification creează o revizie nouă. Citiți din nou ultima revizie și refaceți maparea, deoarece numai ultima revizie poate fi folosită pentru asamblare. Modificările manuale ale componentelor dintr-un document de asamblare rămân valabile în Visma Net, așa că SkyPlanner recitește documentul înainte de validare.
Etapele obișnuite ale proiectului
Implementarea se încheie, de regulă, în câteva săptămâni de la începerea configurării inițiale. Înainte de această etapă, puteți folosi perioada de testare gratuită de 30 de zile cu propriile date, extrase printr-un scenariu de export Visma Net și importate în format CSV sau Excel.
- Definirea domeniului. Stabiliți modelul cererii, tabelul de mapare, responsabilitățile asupra datelor și destinația înregistrărilor trimise înapoi (Kit assembly sau recepții în stoc).
- Configurarea Visma Connect. Înregistrați Service Integration și obțineți aprobarea administratorului instanței. Testați mai întâi într-o companie demonstrativă.
- Modelul de producție. Centre de lucru, schimburi, etape de proces, pregătiri și scule în SkyPlanner.
- Încărcarea inițială. Articole stocabile, clase de articole, Kit specifications, depozite, stocuri.
- Sincronizarea comenzilor de vânzare și de achiziție. Webhook-uri pentru comenzi de vânzare, comenzi de achiziție și articole; interogări periodice pentru kituri și stocuri. Tot aici se gestionează reînnoirea tokenurilor și răspunsurile 429.
- Scrierea înapoi în ERP. Crearea, actualizarea și validarea documentelor Kit assembly, plus pontajele.
- Testarea în paralel. Rulați SkyPlanner în paralel cu planul actual și comparați datele.
- Punerea în funcțiune. Activați scrierea înapoi în ERP după ce datele corespund.
Ce trebuie să aveți în vedere la integrarea cu Visma Net
- Nu există fluxuri tehnologice de importat. Toate etapele de proces și toți timpii de pregătire și de execuție se definesc în SkyPlanner. Estimați efortul necesar și stabiliți cine răspunde de această activitate.
- Advanced logistics. Kit assembly necesită grupul Advanced logistics. Cu Standard logistics, înregistrați producția obținută folosind Inventory receipt și Inventory issue.
- Revizii blocate. O revizie Kit specification deja utilizată nu poate fi modificată, iar pentru asamblare se poate folosi numai ultima revizie.
- Unități de măsură. Documentul Kit assembly are propria unitate de măsură. La import, asigurați concordanța acesteia cu cantitățile din SkyPlanner.
- Interogări periodice în lipsa evenimentelor. Kiturile nu au webhook-uri. Preluați doar modificările pe baza
lastModifiedDateTime, fără reîncărcări complete, pentru a respecta limita orară de cereri. - Endpoint-uri actuale. Dezvoltați integrarea folosind exclusiv
api.finance.visma.netși SalesOrder service v3. - Aprobarea administratorului de mediu. Autentificarea prin client credentials nu funcționează până când administratorul mediului nu aprobă aplicația. Programați această etapă din timp.
- Pontaje săptămânale. Pontajele necesită Advanced financials și se întocmesc săptămânal. Centralizați orele operatorilor pe săptămână sau înregistrați-le ca tranzacții de proiect.
Cine configurează integrarea cu Visma Net și oferă asistență
- Echipa SkyPlanner configurează integrarea în etapa inițială și oferă asistență după punerea în funcțiune. Aceasta acoperă partea SkyPlanner, modelul de producție care lipsește din Visma Net și apelurile API Visma Net convenite. Fiecare fabrică folosește Visma Net în mod diferit, iar aceste particularități sunt luate în calcul la configurare.
- Partenerul dumneavoastră Visma Net poate participa. Visma furnizează Visma Net prin parteneri certificați Visma, care vă cunosc configurația și pot verifica maparea și aplicația Visma Connect. SkyPlanner pune la dispoziție REST API, documentația Swagger/OpenAPI și webhook-uri.
- Dezvoltatorii dumneavoastră pot realiza integrarea folosind același REST API documentat și un token API. Un token API este suficient pentru a începe, iar echipa SkyPlanner oferă ajutor la nevoie. Consultați documentația publică la documentația SkyPlanner.
După conectare, motorul Arcturus programează producția pe baza comenzilor actualizate din Visma Net, iar operațiile finalizate sunt înregistrate înapoi în Visma Net ca documente Kit assembly validate. Prețul pornește de la 199 € pe lună, cu 5 centre de lucru incluse și facturare lunară. Primiți dinainte o ofertă pentru integrare, adaptată procesului și nevoilor dumneavoastră, împreună cu oferta pentru abonament, astfel încât să cunoașteți costul total înainte de a începe.
Consultați prețurile și aflați de ce Visma Net are nevoie de un instrument de programare a producției în pagina despre programarea cu capacitate finită pentru Visma Net. Găsiți prezentarea generală pe pagina Visma Net și alte sisteme ERP în secțiunea de integrări ERP.
Ce spun producătorii despre SkyPlanner
2 heconomisite în fiecare săptămână
„Cu SkyPlanner, am trecut de la planificarea producției în foi de calcul Excel la optimizarea producției în timp real.”
Kalle Kalliomäki, specialist în lanțul de aprovizionare
UTU · Tablouri electrice și aparataj de comutație
Planificarea producției economisește 2 ore de lucru în fiecare săptămână, iar o nouă listă de operații ajunge la linia de producție în câteva secunde.
+90%eficiență în producție
„Eficiența în producție a crescut cu 90%.”
Abdul Rucyinga, director IT
Laboratory & Allied · Producție farmaceutică
Eficiența în producție a crescut cu 90%, iar realizarea unui plan optimizat pe trei luni, pentru toate centrele de lucru, durează mai puțin de 30 de minute.
98%respectarea termenelor de livrare, față de aproximativ 50% anterior
„SkyPlanner are un rol decisiv în menținerea nivelului de respectare a termenelor noastre de livrare.”
Hannu Lahtinen, director general
KJH-Comp · Prelucrarea tablei și producție pe bază de contract
Rata de respectare a termenelor de livrare a crescut de la aproximativ 50% până la 98%, iar programarea producției necesită acum un singur responsabil în loc de doi.
6 lunide vizibilitate asupra capacității disponibile pentru echipa de vânzări
„SkyPlanner oferă o bază solidă și siguranță pentru întreaga planificare a producției.”
Anu Järvinen, manager de producție
Fredman Operations · Hârtie pentru ambalaje destinate contactului cu alimentele
Echipa de vânzări vede capacitatea disponibilă cu șase luni înainte, iar cererile de modificare a programului, care necesitau o oră sau mai mult, primesc acum răspuns în câteva secunde.
Întrebări frecvente
API-ul Visma Net include comenzi de producție?
Nu. Visma Net nu are obiecte pentru comenzi de producție, fluxuri tehnologice sau centre de lucru, deci nici API-ul nu le include. Documentul de producție este Kit assembly, disponibil la /v1/kitassembly, iar fluxurile tehnologice și centrele de lucru sunt gestionate în SkyPlanner.
Ce metodă de autentificare folosește integrarea?
Integrarea folosește Visma Connect cu fluxul client credentials din OAuth 2.0 și este înregistrată ca Service Integration în Visma Developer Portal. Administratorul mediului aprobă integrarea, iar tokenurile sunt valabile o oră.
Poate Visma Net să transmită modificările în timp real?
Pentru articole, comenzi de vânzare și comenzi de achiziție, da, prin webhook-urile din Visma Developer Portal. Kit assemblies și Kit specifications nu emit evenimente și sunt preluate prin interogări periodice incrementale. Webhook-urile proprii SkyPlanner transmit modificările programului pe măsură ce apar.
Cum se înregistrează producția finalizată înapoi în Visma Net?
SkyPlanner creează un document Kit assembly pentru fiecare operație programată, îi actualizează data și apelează acțiunea release când operația este finalizată. Acțiunea release înregistrează producția obținută și consumul de componente. Fără kituri, Inventory receipt și Inventory issue îndeplinesc același rol.
Putem testa SkyPlanner înainte de a realiza integrarea?
Da. Perioada de testare gratuită de 30 de zile permite utilizarea a până la 20 de centre de lucru, cu importuri CSV sau Excel din Visma Net, fără card de credit. Începeți testarea sau discutați cu echipa de vânzări pentru definirea domeniului integrării.
