59 Release 2019-R12

2019-R12 - Release Notes API

We have added a new property ProductMini in StructuredOutputOptions
This is for a future implementation and should not be used in this version.
The SOAP API Service contract has not changed.

Internal ref

VVS-1705

58 Release 2019-R11

2019-R11 - Release Notes API

We have started building a REST API with functions from the SOAP API.
In this work we have changed a lot in the internal machinery of the API functions as they will serve two API interfaces in the future.
The SOAP API contract has not changed.

Run SOAP api with https

Now we have added the opportunity to run the SOAP API with https.
Add "secure" at the end of the URI to the web service
Example TEST: https://test.ws.vvsinfo.se/V1/ProductService.svc/secure
Example PROD: https://ws.vvsinfo.se/V1/ProductService.svc/secure

Correction of function GetManyByIdentifiersQueued

The GetManyByIdentifiersQueued feature has been in the API contract but has never been used. It also turned out to have a bug that we have now fixed.
You can submit the same type of identifiers (search keys) as for GetByIdentifier and GetSingleByIDentifier
If you send in identifiers that give duplicates of product, only one product is returned.
Articles that does not get a hit are NOT reported back because the API contract does not support this and we do not want to break it.
Note that this is an asynchronous method that returns a queue ID (QueueId). The result is usually checked with GetResult.
It is possible to use PingBackURL to get a signal when the result is clear.
Number of articles: Our recommendation is not to search for more than 500 items in a call.

Correction of GetUpdateResult .NET API SDK

We found that the GetUpdateResult method did not handle WorkNotReadyFault correctly.
This was due to a mismatch between the namespace for SOAP Faults in the SDK's proxy for the SOAP service and the SOAP service itself.
We had not updated SDK's proxy client at an earlier time.
The SDKs are now corrected and now they match.

Internal ref

-

57 Value of TypeId in ApiProductExtNumber was not set

BUG: ApiProductExtNumber - TypeId value was always 0

See ApiProduct External numbers (ApiProductExtNumber) for more information.

Internal ref

Internal ref numbers VVS-1618

56 Updated documentation regarding UriTypes

IMPROVEMENT: New dynamic view of avalable URI-types

See ApiProduct Uri-types for more information.

Internal ref

Internal ref numbers VVS-1316

55 Updated documentation regarding image scaling

IMPROVEMENT: Urls and recommendations about scaling of images.

See About scaling of images for more information.

Internal ref

Internal ref numbers VVS-1559

54 Bugfix for updating ETIM-values

BUG: Changning ETIM-value resulted in error missing content access

When updating etimvalues server responded with error message

"Missing content access for field 'Etim.EFnnnnn'" 

Internal ref numbers VVS-1605

53 Bugfix for readonly fields

BUG: Some readonly fields were wrongly seen as changed by the caller

See ApiProduct for more information.

Ignoring these fields in update methods

SEG and VVS

• NumberStr
• IsWholesalerApproved
• ReplacedByNumberStr

SEG only

• ReplacedPartlyByNumberStr
• ReplacesNumberStr
• ReplacesPartlyNumberStr

Internal ref numbers VVS-1604

52 Changes in fields

IMPROVEMENT: Added fields DescriptionEn, GroupingWord and ProductModel.

See ApiProduct for more information.

Note field DescriptionEn
DescriptionEn replaces the field NameLongEn for longer english description.

• is ordered in the ApiProduct Structure in the SOAP-body or SOAP-response. (After BulletText)
• Is set to be not required when updating.

CHANGE: NameLongEn

New meaning for NameLongEn which now contains the longer english name for the product.

Internal ref

Internal ref numbers VVS-1454, VVS-1423 and VVS-1581

51 IMPROVEMENT: Added field IsWholesalerApproved

See ApiProductPackage for more information.

50 IMPROVEMENT: ProductService improved behaviour in GetByIdentifier and GTIN.

As a manufacturer you can only search within your own products. As a manufacturer you have to provide your own manufactureridentifuer or leave it blank
Have a look at ProductIdentifiers ByManufacturerAndArticleGTIN

49 IMPROVEMENT: ProductService Added faultcontract InternalErrorFault to IProductService.

Added Faultcontract InternalErrorFault to all methods in IProductService for a more robust error handling and return.

48 BUGFIX: ProductService GetResult and GetUpdateResult when work not ready(VVS-1503).

ProductService GetResult and GetUpdateResult wrongly returned a WorkNotProcessedException instead of WorkNotReadyException.
This now fixed.

47 BUGFIX: Fixed a bug for User SafeWater (VVS-1497).

46 BUGFIX: Fixed a bug regarding Count and CountWithDecimals in ApiProductPackage (VVS-1443).

• Count and CountIsSpecified are now optional
• Changed logic for use of these fields

See ApiProductPackage for more information.

45 Added optional field ReachVersionOfCandidateList in ApiProduct and extended validation for REC-type (VVS-1436).

• Extended validation of ApiProductExtNumber REC-type
• Added field ReachVersionOfCandidateList in ApiProduct for candidate list date

44 Added field in APIProductPackage and changes in handling of package levels (VVS-1243).

Added fields CountWithDecimals and CountWithDecimalsIsSpecified, CountWithDecimals is also added as a return value.
For measurements M and M2 you have to use CountWithDecimals.

The field Count will remain, but is to be considered as obsolete and will be deprecated in the future.

The number of levels for ProductPackages changes from three to four by adding Mellan2 (SortOrder=3).
it is also possible to skip levels if desired.

All packages specified as level 3 (Top in the old specification) will be updated to level 4 prior to this update being released.

See ApiProductPackage for more information.

43 Added parameter in SearchProductsParameters for SearchQueued (VVS-1419)

For Productservice Search. Added parameter LastChangedOptionSearchGreaterThanOnly for managing behaviour of comparision of lastChanged.

See SearchProductsParameters for more info.

42 Added fields in ApiProduct (VVS-1419)

Added readonly fields in the following structures

ApiProduct

• ReplacedByNumberStr

ApiProduct.IndustrySpecificSEG

• ReplacedPartlyByNumberStr
• ReplacesNumberStr
• ReplacesPartlyNumberStr

41 BUGFIX: Fixed bug in SearchQueued (VVS-1419)

In Productservice Search. Filter criteria didn't work for these fields in SearchProductsParameters.

• ActiveStatus
• InfoLevel
• EtimClassIdentifier

40 Fixed bug regarding fields seemed changed by user but were not (VVS-1391)

Bug occured when updating products.

For these fields

• BulletText
• Description
• NameEn
• NameLongEn
• NameLongSv
• NameSv
• OtherInfo

39 Updated documentation on ProductService

Update info on Productservice.

Mainly behaviour on using product identifiers has been straightened up.

• Productservice GetSingleByIdentifier

When using update functions as the role manufacturer you are only authorized to update your own products. Read more here.

• Productservice UpdateSingle
• Productservice UpdateMany

38 New ApiProduct-field NumberStr

General information for the added field NumberStr on ApiProduct.

37 Pingback functionality enabled for queued requests

The PingbackUrl Option when using SearchQueued and UpdateQueued is now enabled.

• Productservice Search.
• Productservice UpdateMany.
• ApiQueuedRequest.
• ApiQueuedUpdateRequest.
• PingbackUrl.

36 ProductService - Search restriction for manufacturers

As a manufacturer you may only search your own products. Please enter your ManufacturerId into search options. An error will be thrown otherwise.Productservice.
Notes on search parameters: SearchProductsParameters

36 ProductService - Search restriction

Added validation and restrictions on search options to use at least one esarch filter parameter.Productservice.
Notes on search parameters: SearchProductsParameters

35 ProductService - Search by ProductGroup

Added search options for searching by ProductGroupId or ProductGroupIdentifier in Productservice.
Notes on search parameters: SearchProductsParameters
Product Groups can be retreived with the method GetProductGroups in GlobalDataService

34 FlatService - Minor update in error reporting

Updated UpdateArticlesInner in FlatService to just report ETIM-errors and not any existing errors on product.

33 BUGFIX: UpdateManyQueued - Error when trying to update a product that does not exist

In Productservice.
Got System.NullReferenceException when trying to update a produt that does not exist.
Fixed so API now returns a better error message stating that the product could not be found and what product-key that caused the problem.

32 BUGFIX: Error while updating StorageRequirement and DangerousItem

In Productservice. Notes on properies and values : ApiProduct
An error occured when trying to update the properties StorageRequirement and DangerousItem

31 API supports updates of ETIM-data

In Productservice. Notes on properies and values : ApiProduct ApiEtimInfo
Updating ETIM-data is now supported. (Documentation on this is currently a work in progress, we apologise for this)

30 BUGFIX: Bugfixes related to Queued-functions

In Productservice and CandidateService.
Error when updating or importing many products with the same picture/document. Only the first product was updated. wich resulted in File not found validation errors for the remainig products.

29 BUGFIX: Bugfixes related to Queued-functions

In Productservice. Internal error when getting results from UpdateManyQueued using method GetUpdateResult
In Productservice Reference to Article/product in error messages was wronlgy prefixed with "MANU" insstead of "ART"

28 BUGFIX: Improved Handling of Carriagereturn and Linefeed and invalid characters

In Productservice. Fields that can contain CRLF (x0D x0A) or just CR (x0D) is converted to LF (x0A)
Cleans invalid XML-characters from these fields as well. W3-standard documentation about XML and Linebreaks Affected fields in APiProduct

• NameEn
• NameSv
• NameLongEn
• NameLongSv
• Description
• BulletText
• OtherInfo

27 Handling of Carriagereturn and Linefeed, BUGFIX: Handling of ETIM-data

Fields that can contain CRLF (x0D x0A) or just CR (x0D) is converted to LF (x0A) W3-standard documentation about XML and Linebreaks Affected fields in APiProduct

• NameEn
• NameSv
• NameLongEn
• NameLongSv
• Description
• BulletText
• OtherInfo

26 Bugfix UpdateManyQueued processing

Bugfix: Fixed UpdateManyQueued to correctly process all products. Only the first 10 were processed. Productservice

25 Bugfix UpdateManyQueued with documents

Bugfix: Fixed UpdateManyQueued to correctly update documents and images Productservice
Documentation: Updated documentation for ApiProduct with field-lengths for string-fields ApiProduct

24 Bugfix reading products with ETIM-data

Bugfix: Fixed GetByIdentifier-methods error when etim-group had enddate
Productservice

23 Bugfix reading products

Bugfix: Fixed GetByIdentifier-methods error when searching by GTIN
Productservice
ProductIdentifiers

22 ETIM-features

Bugfix: Fixed Get-methods returned duplicates of ETIM-data
Productservice
StructuredOptions
ApiProduct ApiEtimInfo

21 ETIM-features

Added option to include ETIM-data for retrieved products in Get-methods
Productservice
StructuredOptions
ApiProduct ApiEtimInfo

20 Restructured .NET example

Removed unsolved external reference to assembly. Moved tools code to project.

19 New product-field BulletText

General support for the added field BulletText on ApiProduct.

Modified 2017-01-30 Field BulletText appears last.

18 Updates of ExtNumbers and Packages

Import methods of CandidateService and update methods of ProductService support new fields now

• ExtNumbers (List<ApiProductExtNumber>) - eg GTIN-numbers, manufacturer own numbers
• Packages (List<ApiProductPackage>)

17 Updates

Productservice

• Added method GetByIdentifier - returns many products per number if exist
• Changed behaviour GetSingleByIdentifier - active return

CandidateService

• Import - Error if trying to update candidate with ID that is already a product

16 Updates

CandidateService

• Bugfix method - GetCandidateGroupsFiltered SearchById prevents reading wrong manufacturer

15 Updates

CandidateService

• Fixed method - GetCandidateGroupsFiltered doing a bad database request

14 Updates

CandidateService

• Added new method - GetCandidateGroupsFiltered with corresponding parameters
• Added field BecameRevisionDate to ApiCandidateItem
• BUGFIX: Setting BecameRevisionDate for imported candidates

13 Updates

CandidateService

• Bug fixed in GetCandidateGroups. Row references are now returned as correct ranges

12 Updates

CandidateService

• Updated GetCandidateGroups which returned too many items per candidate group and product group

• Fixed bug regarding authentication calling GetSingleByIdentifier

11 Updates

Changed Names for the following types

• ApiProductManufacturer renamed to ApiManufacturerInProduct
• ApiProductStorageRequirement renamed to ApiProductStorageRequirementTypes

ApiProduct Changes

• ProductGroupId field removed
• ManufacturerIdentifier field removed

Removed following types

• Parameters.ApiProductInfoLevelType Removed

ApiCandidateImportResult Changes

• ProductIdentifier field added

10 Updates

Changed response type for ICandidateService.ImportWithGroupedResult to ApiCandidateImportGroupedResult

Bugfix: Import returns validation errors as it should. Bug returned duplcates.

ApiManufacturer Renamed following fields

• ResponsibleAdminInfo
• ResponsibleDocsInfo
• ResponsibleImagesInfo
• ResponsibleCEOInfo
• ResponsibleMarketInfo
• ResponsibleEconomyInfo

9 Updates

Updated ApiProduct with fields for manufacturer (Name Alias, Id and Identifier) Documentation for ApiProductManufacturer

8 Updates

New service Documentation for ManufacturerService

7 Updates

Candidate import
New method ImportWithGroupedResult.

ApiProduct

• ApiProduct New field : ProductId
• ApiProduct New field : SeriesName
• ApiProduct New fields : BvbResult, BvbVersion, BvbId

CandidateService - Candidate Import

• Updates are keyed on ProductId

Candidate import and product update can take document parameters to upload documents and images.
Documentation for CandidateService Documentation for ProductService

GlobalDataService
New methods GetProductGroups GetUriTypes.
Documentation for GlobalDataService

6 Products SearchQueued and SearchAsBmecatQueued support splitting batches

Use parameter TakeApproximately to split up huge results.

5 SOAP action namespace, removed tempuri

All SOAP actions are now in correct namespace Prodibas.API.V1, tempuri has been removed.

4 GlobalDataService more methods implemented

Methods GetUnits(), GetCountries(), GetDangerousItems(), GetStorageRequirements(), GetPackageTypes(), GetPackagingFunctions(), GetPalletTypes() are now implemented.

3 Model validation

ModelValidationError and ModelValidationException are now in correct namespaces.

2 ApiProduct class changed to non-generic

For simplicity the ApiProduct<IndustrySpecificAbstractBase> has been changed to ApiProduct. You should still use property IndustrySpecific for industry-specific information. This change gives you shorter and simpler class names in the WSDL contract.

1 Updated SDK and examples

• The queued queries now delay 5 seconds before making the first GetResult() request. This makes it more likely to receive a result on the first GetResult() request for small batches.
• Examples now use test-manufacturers including their API-keys. Directly executable.