Product managing functions are divided into following:

Get a product listGETproductlist.nv Download
Get product detailsGETgetproduct.nv Download
Import product detailsPOSTproduct.nvproduct.dtdDownload
Get a structural product listGETwebshopproductlist.nv Download
Get structural product imagesGETwebshopproductimages.nv Download
Get inventory by warehouseGETinventorybywarehouse.nv Download
Import warehouse eventPOSTwarehouseevent.nvwarehouseevent.dtdDownload


Get a product list

Resource: productlist.nv

List of products from Netvisor can be retrieved as described below. List contains basic information of each product. Details of each product can be retrieved one by one by using Get product details request.

Querystring parameters:

Parameter nameOccursDescriptionExample
changedsince0...1Filters result to contain only products having change after given date, date in format YYYY-MM-DD2012-01-01
keyword0...1Filters result to products that include given text / value in product name or product code


LevelElement nameType and lengthOccursDescriptionExample
3NetvisorKeyNumeric1Product identifier in Netvisor 123 
3ProductCodeText1Code of the product A54 
3NameText1Name of the productThe product
3UnitPriceNumeric1Unit net price of product, 12 decimal1,960000000000
3UnitGrossPriceNumeric1Unit gross price of product, 12 decimal2,430400000000
3ProductGroupIDNumeric1Product group ID. Can be empty. 2 
3ProductGroupDescriptionText1Product group, whole hierarchy. Can be empty.Books / Science fiction books 
3UriText1URI which can be used to retrieve details of the product/getproduct.nv?id=123


Get Product details

Resource: getproduct.nv

Before retrieving product information, a list of products must be requested to pick the Netvisor key of the wanted product. Specific product information of one product can be retrieved with the Netvisor key. Using parameter idlist, specific product information of max 400 products can be retreived.

Querystring parameters:

Parameter nameOccursDescriptionExample
id1Netvisor key of the wanted product123
idlist0...1Can be used to get the details of several products with given ID. Max. 400 identifiers.1,2,3


LevelElement nameType and lengthOccursDescriptionExample
3NetvisorKeyNumeric1Netvisor key of the product 
3ProductCodeText1Product code CC
3ProductGroupText1Product group's name Books
3NameText1Product's name Code Complete 
3DescriptionText1Description Second edition 
3UnitPriceNumeric1Net price of a single unit 42,5
Attr.typeText1Always netnet
3UnitGrossPriceNumeric1Gross price of a single unit52,7
Attr.typeText1Always grossgross
3UnitText1Unit of measurementpc

Weight of a single unit.
NB element is expired, please use element ProductNetWeight instead


3PurchasePriceNumeric1Purchase price of a single unit 25
3TariffHeadingText1Tariff headingCode Complete 
3ComissionPercentageNumeric1Commission 11
3IsActiveNumeric1Is product active: 0 = no, 1 = yes1
3IsSalesProductNumeric1Is this a sales product: 0 = no, 1 = yes0
3countryoforiginText1Country of originFI
Attr.typeText1Always ISO-3166ISO-3166
3DefaultVatPercentNumeric1VAT rate22
3DefaultDomesticAccountNumberNumeric1Domestic account number by default 
3DefaultEuAccountNumberNumeric1EU area account number by default 
3DefaultOutsideEuAccountNumberNumeric 1International account number by default  
3InventoryAmountNumeric1Amount in storage 2,00
3InventoryMidPriceNumeric1Average price 5,00
3InventoryValueNumeric1Inventory value: amount in storage * average price 10,0000
3InventoryReservedAmountNumeric1Amount reserved 1,00
3InventoryOrderedAmountNumeric1Amount ordered 0,00
3ProductNetWeightNumeric1Net weight11,20
Attr.weightunitText1Unit of net weight: g, kg or tkg
3ProductGrossWeightNumeric1Gross weight12,60
Attr.weightunitText1Unit of gross weight: g, kg or tkg
4PackageWidthNumeric1Package width in centimeters7,30
Attr.unitText1Package width unitcm
4PackageHeightNumeric1Package height in centimeters15,00
Attr.unitText1Package height unitcm
4PackageLengthNumeric1Package lenght in centimeters36,10
Attr.unitText1Package lenght unitcm


Import product details

Importing data trough the interface is not supported for extended product management.

Resource: product.nv

Querystring parameters:

Parameter nameOccursDescriptionExample
method1Add or EditAdd
id0-1Must be included if Method = Edit, defines the product to update123

If method has not been set or the product to be updated is not found with the id, an INVALID_DATA -error with further details is returned. The id for the product to be update can be obtained with the Get a Product list resource.

The data to import is sent with the request as an XML with the following structure:

LevelElement nameType and lengthOccursDescriptionExample
3productcodeText0...1Product codeCC
3productgroupText1Product is added to the group if it exist. If it doesn't, it will be createdBooks
3nameText1Name of the productCode Complete
3descriptionText0...1Description of the product Second edition
3unitpriceNumeric1Price of a single unit 42,5
Attr.typeText1net or grossnet
3unitText0...1Unit of measurement, existing is used if found, otherwise new one is created pc
3unitweightNumeric0...1Weight of a single unit with two decimals1,00
3purchasepriceNumeric0...1Purchase price of a single unit25
3tariffheadingText0...1Tariff heading of the unit Code Complete
3comissionpercentageNumeric0...1Commission percentage of the unit11
3isactiveNumeric1Is product active: 0 = no, 1 = yes 1
3issalesproductNumeric1Is this a sales product: 0 = no, 1 = yes 1
3inventoryenabledNumeric0...1Is the product in storage: 0 = no, 1 = yes 1
3countryoforiginText0...1Country of originFI
Attr.typeText0...1Always ISO-3166ISO-3166
3defaultvatpercentageNumeric1Vat class, if class is not found, an error is returned22
3productnetweightNumeric0...1Net weight11,2
3productgrossweightNumeric0...1gross weight12,6
3productweightunitNumeric0...1net and gross weight unit: g, kg, tn kg 
3packagewidthNumeric1Package width in centimeters7,3
3packageheightNumeric1Package height in centimeters15,0
3packagelengthNumeric1Package length in centimeters36,1


Get a structural product list

Resource: webshopproductlist.nv

Used to retrieve a structural list of products. This resource can only be used if extended product management is in use. List contains information of products like name and description in different languages, and information on the variants of the product.

Querystring parameters:

Parameter nameOccursDescriptionExample
limitDeleted0...1When defined, only active main products are included in result1
limitActive0...1When defined, only active products are included in result1
limitPublished0...1When defined, only published products are included in result1
limitSellable0...1When defined, only sellable products are included in result1
0...1When defined, only products edited since given day are included in result2016-01-28
limitSourceProductNetvisorKey0...1Limits result by given source product key in Netvisor154
limitshownonwebshopproducts0...1Limits result set by containing only products to show in webshop45



LevelElement NameType and lengthOccursDescriptionExample
3NetvisorKey Numeric 1Product identifier in Netvisor145
3NameText1...3Name of the productThe Product
Attr.languageText Language of the name: FIEN or SEFI
3DescriptionText1...3Description of the productthis is a product
Attr.languageText Language of the description: FIEN or SEFI
3ProductCodeText1Product codeA123
4NameText1...3Name of the product groupGroup 1
Attr.languageText Language of the product group name: FIEN or SEFI
3UnitNetPriceNumeric 1Price of a single unit  12,00 
3UnitGrossPriceNumeric1Gross price of the unit 14,64 
3Unit Text 1Unit of measurement pc
3UnitWeight Numeric 1Weight of a single unit 1,50
3ImageURI Text 1URI for an image for the product /webshopproductimages.nv?
3URIText 1Uri for retrieving full product information/getproduct.nv?id=165
3InventoryAmountNumeric1Amount of unit in inventory 30,00
3InventoryOrderedAmountNumeric1Amount of ordered units1,00
3InventoryReservedAmountNumeric1Amount of reserved units 5,00
3IsActiveNumeric1Is the product active:
0 = no, 1 = yes
 IsSalesProductNumeric1Is this a sales product:
0 = no, 1 = yes
3IsStorageProductNumeric1Is this product in storage:
0 = no, 1 = yes
3DefaultVatPercentage>Numeric1VAT rate22
3IsPublishedNumeric1Has the product been published:
0 = no, 1 = yes
3VersionNumberNumeric1Version number of the product  
3PrimaryEANCodeNumeric1 978020137962
3SecondaryEANCodeNumeric1 978020137963
5DescriptionText1Description of the price groupCA1
5ValueNumeric1Value of the price group1,5
Attr.typeText1Type of value, multiplier or fixedmultiplier
5NameText1...3Name of the variantShirt, Red
Attr.languageText Language of variant name: FIEN or SEFI
5DescriptionText1...3Description of variantA red shirt
Attr.languageText Language of variant description: FIEN or SEFI
5VariantIdentifierText1Identifier of the product variant in NetvisorABC002
5ImageUriText1Uri of the product variant image/webshopproductimages.nv?
5LastchangeDateDate1Timestamp when the product variant is modified30.1.2014 10:12:06
5UnitNetPriceNumeric1Net price of the product variant12,00
5UnitGrossPriceNumeric1Gross price of the product variant14,62
5InventoryAmountNumeric1Amount of variants in inventory 35,00
5InventoryOrderedAmountNumeric 1Amount of variants ordered 12,00
5InventoryReservedAmountNumeric 1Amount of variants ordered 1,00
5PrimaryEANCodeNumeric1 978020137962
5SecondaryEANCodeNumeric1 978020137963
7DescriptionText1Description of the variant's price group 
7ValueNumeric1Value of the price group 
Attr.typeText1Type of value, multipliermultiplier
6VariantPropertyText1Product attribute
6VariantPropertyValueText1Product attribute value
3CustomTagAggr.0...nProduct additional information field
4CustomTagNameText1Field name
Additional information
4CustomTagValueText1Field value
Field 1


Get structural product images

Resource: webshopproductimages.nv

Will get products first picture. If product has variants, recourse will return all pictures of variant.

Querystring parameters:

Parameter nameOccursDescriptionExample
identifer1Identifier of product which images to get123
NetvisorKeyList0...1Filter search with several ID's (Netvisor key), separated with comma. Max. 400 identifiers1,2,3


LevelElement NameType and lengthOccursDescriptionExample
3MimeTypeText1Image MIME typeimage/jpg
3TitleText1Title of the imageImage
3FileNameText1File name of the imageimage.jpg
3DocumentDataBase641Image data in Base64 encoded string 


Get inventory by warehouse

Resource: inventorybywarehouse.nv

This resource allows retrieving product inventory for each warehouse. If detailed information about a product is needed, they can be retrieved with Get product details.

Querystring parameters:

productid0...1Filter search with productid (Netvisor key)123
productidlist0...1Filter search with several product id's (Netvisor key), separated with comma123,456,789
inventoryplaceid0...1Filter with inventory ID
inventoryplacename0...1Filter with inventory namewarehouse 5
limitvendorid0..1Filter with vendor's ID
changedsince0...1Filter to changes since the time given1.5.2014 12:00:00
limitunderalertlimit0...11 = return only products under alert limit1
productgroupname0...1Limit search to given product groupexample group

Example query:
(retrieve products under alert limit from inventory with id 321)


LevelElement nameType and lengthOccursDescriptionExample
3NetvisorKeyNumeric1Product's ID in the database, can be used to retrieve full product information or to link the product to an invoice165
3NameText1Product nameTest product
3CodeText1Product's codeTT
3GroupNameText1Productgroupcampaign products
3ProductUriText1URI for retrieving full product information/getproduct.nv?id=165
4NetvisorKeyNumeric1Warehouse's ID
4NameText1Warehouse's nameMain warehouse
4ReservedAmountNumeric1Amount reserved from this warehouse10,00
4OrderedAmountNumeric1Amount ordered to this warehouse15,00
4InventoryAmountNumeric1Amount of product in this warehouse34,00
3TotalReservedAmountNumeric1Amount of reserved from all warehouses524,00
3TotalOrderedAmountNumeric1Amount ordered from all warehouses125,00
3TotalAmountNumeric1Amount of product in all warehouses647,00


Import warehouse event

Resource: warehouseevent.nv

This resource allows importing a single warehouse event into Netvisor.
The data to import is included in the query as an XML with following structure:

2descriptionText0...1Description of the eventTest event
2referenceText1Reference number of the event1070
2deliverymethodText0...1Method of delivery, delivery methods are controlled in Netvisor, imported line must match with one in NetvisorPick up
2distributerText0...1ID or name of the distributor110
Attr.typeText0...1Attribute type:
- netvisor = NetvisorKey of the distributor
- customer = Name of the distributor
4eventtypeText1Type of the warehouse event, warehouse events are controlled in Netvisor, imported line must match with one in NetvisorSale
Attr.typeText0...1Type of the event, for now, always "customer"customer
4productText1Id of the product, netvisor-key or product code32154
Attr.typeText0...1Type of product id, "netvisor" or "customer"netvisor
4inventoryplaceText0...1Name of the warehouse, warehouses are controlled in Netvisor, imported line must match with one in NetvisorMain warehouse
4descriptionText0...1Description of the warehouse event line 
4quantityNumeric1Amount of products12
4unitpriceNumeric1Price of a single unit, always imported as net price100,00
4valuedateDate1Date of the warehouse event.2014-05-13
Attr.formatText1Always ansiansi
4statusText1Status of the warehouse eventopen

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.