ProductService
A Web Service designed to supply external companies and suppliers with product information in a simple way using GTIN lookups. To get information about how to get access to the Web Service, send an E-mail to support@opv.se. This service can be called with either JSON or SOAP (even though this automatically created documentation only displays the SOAP protocol). It will respond with the same protocol that it was called with.
The following operations are supported. For a formal definition, please review the Service Description.
-
Get24hSecurityKey
Used to get the security key required for calling all the other methods. The security key is vald for 24 hours. Can only be called 50 times each day, so make sure the returned key is cached. -
GetAllAvailableGTINs
Returns a list of all the GTINs that you have access to. langTargetmarketLimit can be used to only request data from products with information in a certain language, thats sold in the requested country. It should be written in ISO 639.1 and ISO 3166. So sv-SE will for instance request Swedish products with information in swedish. If langTargetmarketLimit is null, a product from any country with any language might be returned -
GetChangedProductsGTINs
Returns a list of the GTINs of all products that have been changed or deleted since the Date/Time supplied. If you're caching the information, it should be called once every 10 minutes with a request for the last 10 minutes of updates AND once every 24 hours with a request for everything changed the last 24 hours. A changed product requires you to request the data again and update the cache, a deleted product requires you to delete the data retrieved from us. -
GetCustomProductData
Works just like GetProductData, but lets you decide exactly what information to retrieve about each product. Use the GetCustomProductDataFieldNames-method to get a list of all valid field names that can be requested. The product data is delivered in a name-value-collection called Data in each ArbitraryProduct-object. langTargetmarketLimit can be used to only request data from products with information in a certain language, thats sold in the requested country. It should be written in ISO 639.1 and ISO 3166. So sv-SE will for instance request Swedish products with information in swedish. If langTargetmarketLimit is null, a product from any country with any language might be returned -
GetCustomProductDataFieldNames
Used to get a list of all valid field names to send into the GetCustomProductData-method -
GetMenuCustomProductData
For suppliers only. Works just like GetCustomProductData, but lets you fetch all products attached to a certain menu item. Use the GetCustomProductDataFieldNames-method to get a list of all valid field names that can be requested. The product data is delivered in a name-value-collection called Data in each ArbitraryProduct-object. langTargetmarketLimit can be used to only request data from products with information in a certain language, thats sold in the requested country. It should be written in ISO 639.1 and ISO 3166. So sv-SE will for instance request Swedish products with information in swedish. If langTargetmarketLimit is null, a product from any country with any language might be returned -
GetMenuSubItems
For suppliers only. Returns the sub categories of the parent category. NOT recursive, so the Children-variable of the returned MenuItem will always be null, even though children might exist. -1 = fetch root nodes. If the menu is translated, it's possible to decide what translation to fetch with the language-parameter (otherwise, just supply a null value to the language parameter). The language parameter should contain a string in ISO 639-1 (sv for swedish, da for danish and so on) or ISO 639-1 and ISO 3166 (sv-SE, da-DK and so on) -
GetMenuTree
For suppliers only. Returns the entire category tree with all sub categories. If the menu is translated, it's possible to decide what translation to fetch with the language-parameter (otherwise, just supply a null value to the language parameter). The language parameter should contain a string in ISO 639-1 (sv for swedish, da for danish and so on) or ISO 639-1 and ISO 3166 (sv-SE, da-DK and so on) -
GetProductData
The main function of this Web Service. Looks up and retrieves the data for all the products that matches the GTINs sent in as an argument. The product data is placed in the same order as the GTINs are sent in (so the product information for the GTIN in gtinVec[5] is in Product-vector[5]). Remember that it´s about 48 times faster to call this method ONCE with 50 GTINs, than calling it 50 times with one GTIN in each call - so make sure to call it in baches if possible. Maximum number of GTINs in each call: 500. This method returns Product-objects that has a default set of information that satisfies most needs. If you want more information, more images in each call, or simply want to slim down each call to fit your needs exactly, see the GetCustomProductData-method. langTargetmarketLimit can be used to only request data from products with information in a certain language, thats sold in the requested country. It should be written in ISO 639.1 and ISO 3166. So sv-SE will for instance request Swedish products with information in swedish. If langTargetmarketLimit is null, a product from any country with any language might be returned