Product service

Read and write products, both single products and big batches with queues.

URL /V1/ProductService.svc
WSDL /V1/ProductService.svc?wsdl
See environments

Direct and queued requests in ProductService

Requests that handle a single product will be processed directly. The main use-case is for administrative applications. Extensive use may be throttled or handled in separate contracts.

Batch reading/writing will be queued.
To see if the batch has been processed and if the result is ready either use the pingback parameter. or use GetResult operation (the exact method depends on the expected result type).
Queuing enables the API to process batches greater than 30 000 products. There is no upper limit set. All operations that use queuing are marked with "Queued" in their name.

The GetResult-operation either returns the result or throws WorkNotDoneFault which the client is supposed to catch. The exception also provides the time interval when the client should re-check.

C#-SDK takes care of queue and polling of GetResult operations. SDK provides synchronous methods.

Product identifiers

Read more about product identifiers used in Get-methods.


Direct requests

Get by identifier

GetByIdentifier

Returns one or many products matching the identifier and to which the user has read access.

Parameters

Returns

Get single

GetSingleByIdentifier

Bahaviour when using the parameter type ByNumber:

Parameters

Returns

GetSingleByIdentifierAsBmecat

Parameters

Returns


Queued requests

GetManyByIdentifiersQueued

A many-version of GetByIdentifier. Input is a list of product identifiers

Parameters

Returns

Products not found are not reported.
If there are duplicate products only one is returned.

Get result

This methods provide the result of queued work, when the work has been processed.

If the work is not ready, these throw WorkNotReadyFault. Choose appropriate method based on the expected result format.

GetResult

Parameters

Returns

GetResultAsXml [not yet implemented]

Parameters

Returns


Direct update requests

Note on manufacturer identifier in Product

Only updating existing products is possible here. For applying for new products, please see Candidate service.

When updating as the role manufacturer you are only authorized to update your own products.

If no value is supplied in the field Identifier in ApiProduct Manufacturer the logged in users manufacturer identity is used.

UpdateSingle

Parameters

Returns

UpdateSingleAsBmecat [not yet implemented]

Parameters

Returns


Queued update requests

Update many

Only updating existing products is possible here. For applying for new products, please see Candidate service.

UpdateManyQueued

Parameters

Returns

UpdateManyFromBmecatQueued [not yet implemented]

Parameters

Returns

GetUpdateResult

Used for getting the feedback of how update/work batch went. Can be used for creating a report for the end-user.

Parameters

Returns