Netvisors beskrivningar av API-resurser har flyttats till en ny dokumentationsplattform baserad på OpenAPI-specifikation, där den tekniska strukturen för API-resurserna är tydligt och enhetligt beskriven. Där finns framöver alla resursernas parametrar, meddelandestrukturer, element och exempel som tidigare har beskrivits på denna sida och dess undersidor. Instruktioner underhålls och uppdateras framöver endast på den nya plattformen.
• Netvisor API Guide – skriftliga instruktioner för användning av API:t
• Netvisor API Reference – teknisk beskrivning av alla resurser
Instruktionerna på den nya plattformen är på engelska. I användningsfallsinstruktionerna finns dock Netvisors finskspråkiga fältnamn i användargränssnittet vid sidan av elementen, så att det är lätt att koppla ihop API:ets element med användargränssnittet.
Vad finns på den nya plattformen
API Reference beskriver varje resurs: HTTP-metod, parametrar, element i förfrågnings- och svarmeddelanden, obligatoriska uppgifter, tillåtna värden, exempelmeddelanden och felmeddelanden.
Building a new integration – byggande av en ny integration:
• Implementing a new integration: faserna i genomförandet av en integration
• Authentication: autentisering och identifierare
• General: allmänna praxis för API:t, såsom svar och felmeddelanden (Responses and errors) samt bilagor (Attachments)
• MCP Server guidelines: rekommendationer för partners som bygger en MCP-server (Model Context Protocol) ovanpå Netvisors API:er.
Best practises – rekommenderade arbetssätt för de vanligaste integrationerna:
• integration av försäljningsfakturor (Sales Invoice Integration)
• integration av inköpsfakturor (Purchase Invoice Integration)
• HRM-integration (HRM Integration)
• arbetstidsintegration (working hours integration)
• import av externa betalningsuppgifter till Netvisor (Importing external payment data to Netvisor)
Netvisor API use cases – användningsfallsinstruktioner:
Instruktioner går steg för steg igenom hur API:t används korrekt. Till exempel vid import av en försäljningsfaktura beskrivs i vilken ordning kunden och produkterna säkerställs, vilka uppgifter som är obligatoriska och vad som händer efter importen.
Resources – avsnittsspecifika resurslista (över)
(Sales, Purchases, Products, Travel, Accounting, Working time, Payroll & salaries, User management and user invitation, Document scan). För varje resurs finns en länk till dess beskrivning i API Reference. I listan (över) finns också länkar till resursernas valideringsscheman (DTD- eller XSD-filer), med hjälp av vilka meddelanden kan kontrolleras före sändning.
Updates and news – aktuella ändringar:
• Netvisor releases: Netvisors publiceringsmeddelanden
• API change log: veckovis ändringslogg över nya resurser och ändringar som införts i API:t
Denna artikel har översatts med hjälp av ett AI-baserat översättningsverktyg. Innehållet eller formuleringen i dessa instruktioner kan avvika från dem i andra instruktioner eller i programvaran.