Resource: product.nv
HTTP-method: POST
Note! If you are using Rackbeat inventory management in Netvisor, the API documentation can be found here: https://support.netvisor.fi/en/support/solutions/articles/77000554491-rackbeat-stoplight-api
Importing data trough the interface is not supported for extended product management.
Querystring parameters:
| Parameter name | Occurs | Description | Example |
| method | 1 | add or edit | add |
| id | 0-1 | Must be included if Method = Edit, defines the product to update | 123 |
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:
| Level | Element name | Type and length | Occurs | Description | Example |
| Root | root | Aggr. | 1 | ||
| 1 | product | Aggr | 1 | ||
| 2 | productbaseinformation | Aggr. | 1 | ||
| 3 | productcode | String | 0...1 | Product code | CC |
| 3 | productgroup | String | 1 | Product is added to the group if it exist. If it doesn't, it will be created | Books |
| 3 | name | String, max 200 characters | 1 | Name of the product | Code Complete |
| 3 | description | String | 0...1 | Description of the product | Second edition |
| 3 | unitprice | Numeric | 1 | Price of a single unit | 42,5 |
| Attr. | type | String | 1 | net or gross | net |
| 3 | unit | String, max 50 characters | 0...1 | Unit of measurement, existing is used if found, otherwise new one is created | pc |
| 3 | unitweight | Numeric | 0...1 | Product unit weight with two decimals | 1,00 |
| 3 | purchaseprice | Numeric | 0...1 | Purchase price of a single unit | 25 |
| 3 | tariffheading | String | 0...1 | Tariff heading of the unit | Code Complete |
| 3 | comissionpercentage | Numeric | 0...1 | Commission percentage of the unit | 11 |
| 3 | isactive | Numeric | 1 | Is product active: 0 = no, 1 = yes | 1 |
| 3 | issalesproduct | Numeric | 1 | Is this a sales product: 0 = no, 1 = yes | 1 |
| 3 | inventoryenabled | Numeric | 0...1 | Is the product in storage: 0 = no, 1 = yes | 1 |
| 3 | inventorybatchlinkingmode | Numeric | 0...1 | Product's batch processing type. Possible values: No batch processing = 1 Manual batch selection = 2 Newest first by delivery date = 3 Oldest first by delivery date = 4 (FIFO) Newest first by use-by date = 5 Oldest first by yse-by date = 6 Newest first by manufacturing date = 7 Oldest first by manufacturing date = 8 | 4 |
| 3 | countryoforigin | String | 0...1 | Country of origin | FI |
| Attr. | type | String | 0...1 | Always ISO-3166 | ISO-3166 |
| 3 | primaryeancode | String | 0...1 | Product's primary EAN-code | 123456789012 |
| Attr. | type | String | 0...1 | Type of the EAN-code. any, ean8, ean13, code128. | ean13 |
| 3 | secondaryeancode | String | 0...1 | Product's secondary EAN-code | 123456789012 |
| Attr | type | String | 0...1 | Type of the EAN-code. any, ean8, ean13, code128. | ean13 |
| 3 | inventoryalertlimit | Numeric | 0...1 | Product's balance alert | 20,50 |
| 2 | productbookkeepingdetails | Aggr. | 0...1 | ||
| 3 | defaultvatpercentage | Numeric | 1 | Vat class, if class is not found, an error is returned | 24 |
| 3 | defaultdomesticaccountnumber | Numeric | 0...1 | Default domestic bookkeeping account number | 3000 |
| 3 | defaulteuaccountnumber | Numeric | 0...1 | Default EU bookkeeping account number | 3360 |
| 3 | defaultoutsideeuaccountnumber | Numeric | 0...1 | Default outside EU bookkeeping account number | 3380 |
| 2 | productadditionalinformation | Aggr. | 0...1 | ||
| 3 | productnetweight | Numeric | 0...1 | Net weight | 11,2 |
| 3 | productgrossweight | Numeric | 0...1 | gross weight | 12,6 |
| 3 | productweightunit | Numeric | 0...1 | net and gross weight unit: g, kg, tn | kg> |
| 3 | dimension | Aggr. | 0...1 | ||
| 4 | dimensionname | String | 1 | Default dimension header name. Created if needed. | Project |
| 4 | dimensionitem | String | 1 | Default dimension name. Created if needed. | Project 1 |
| 3 | productpackageinformation | Aggr. | 0...1 | ||
| 4 | packagewidth | Numeric | 1 | Package width in centimeters | 7,3 |
| 4 | packageheight | Numeric | 1 | Package height in centimeters | 15,0 |
| 4 | packagelength | Numeric | 1 | Package length in centimeters | 36,1 |
| 3 | productcustomtags | Aggr. | 0...1 | ||
| 4 | productcustomtag | Aggr. | 1...n | Product additional information field | |
| 5 | tagname | String | 1 | Field name | Date field |
| 5 | tagvalue | String | 1 | Field value | 2022-01-01 |
| Attr. | datatype | String | 1 | Field type. date, text, decimal or enum | date |
Did you find it helpful? Yes No
Send feedbackSorry we couldn't be helpful. Help us improve this article with your feedback.