A new version of the Customer service was introduced on August 19, 2024. A new flag routes active was added to the response of the GET /customer operation. This flag informs whether there are currently any logistics routes pinned to the customer.
On July 15, 2024, the capability to query the GET /products operation in the Customer service based on SKU or product index was introduced.
Implementation details:
Usage examples:
GET /products?sku=<kod_SKU>
GET /products?index=<indeks_towaru>
On July 10, 2024, a new version of the Customer service was released. A new flag, automaticOrderConfirmation, was added to the response of the GET /customer operation. This flag indicates whether orders placed by the user will be sent with automatic order confirmation.
On May 19th, validation of product codes (SKU/index) submitted by users was introduced. All products that are unavailable or incorrect will be omitted in the response. A complete list of omitted products will be returned in the HTTP header: skpSkuList for queries by SKU or skiIndexList for queries by index.
Change implemented in the services:
On May 17th, a new version of the following services was released:
Delivery Invoice Inventory Pricing Sales In the responses of the aforementioned services, EAN codes have been added to the product information section.
Example of the Inventory service response with EAN codes returned for product D6E01F:
[
{
"sku": "D6E01F",
"location": "TOR",
"availability": 1,
"latestDeliveryDate": "2024-06-25",
"index": "EL001563",
"name": "Zestaw uszczelek pokrywy zaworów",
"description": "Zestaw uszczelek pokrywy zaworów pasuje do: VOLVO C30, S40 II, S80 II, V50, V70 III, FORD C-MAX, C-MAX II, FIESTA V, FOCUS C-MAX, FOCUS II, GALAXY II, GALAXY MK II, KUGA II 1.8-2.5D 10.00-",
"gtuCode": null,
"eans": [
".365100",
"4041248614815"
]
}
]
A new Catalog service was introduced on May 31, 2024. The service allows you to search for product definitions in real time. The service currently consists of two operations:
[
{
"categoryId": "SalesClassificationNode_6100000",
"label": "Filters"
},
{
"categoryId": "SalesClassificationNode_6200000",
"label": "Engine / Equipment"
},
{
"categoryId": "SalesClassificationNode_6300000",
"label": "Wheel suspension"
},
{
"categoryId": "SalesClassificationNode_6400000",
"label": "Vehicle shock absorption"
},
{
"categoryId": "SalesClassificationNode_6811050",
"label": "Ignition/glow system"
},
...
]
{
"totalResults": 816,
"hasNextPage": true,
"requestProcessingTime": 35,
"products": [
{
"towKod": "976822",
"icIndex": "611 180 02 10",
"tecDoc": "611 180 02 10",
"tecDocProd": "633",
"articleNumber": "611 180 02 10",
"manufacturer": "OE MERCEDES",
"shortDescription": "Oil filter housing",
"description": "Oil filter housing fits: MERCEDES 124 (W124)",
"barcodes": [],
"packageWeight": "0.272",
"packageWidth": "9.0",
"packageDepth": "26.0",
"packageHeight": "9.0",
"customsCode": "84219990"
},
{
"towKod": "976801",
"icIndex": "720 277 00 95",
"articleNumber": "7202770095",
"manufacturer": "OE MERCEDES",
"description": "DB oil filter",
"barcodes": [],
"packageWeight": "0.314",
"packageWidth": "17.0",
"packageDepth": "17.0",
"packageHeight": "11.5",
"customsCode": "84212300"
},
...
],
"facets": {
"brands": [
{
"id": "OE VW",
"label": "OE VW",
"count": 30859
},
{
"id": "OE BMW",
"label": "OE BMW",
"count": 20341
},
{
"id": "SF",
"label": "SF",
"count": 7764
},
...
]
}
}
A new HTTP header containing information about the amount of data retrieved for pagination purposes called "resultsTotal" in the Delivery and Invoice services was added on May 8, 2024.
The Inventory service is scheduled to be updated in early May with additional information on delivery times for items from individual warehouses to the base branch assigned to the customer. Additional optional fields orderDateTimeTo, shipToBusinessUnitDeliveryDateTime, customerRouteStartDateTime, customerRouteCode were added to response:
[
{
"sku": "ADDFFF",
"location": "KRC",
"availability": 2,
"latestDeliveryDate": "2024-04-25"
},
{
"sku": "ADDFFF",
"location": "HZA",
"availability": 10,
"latestDeliveryDate": "2024-04-25",
"orderDateTimeTo": "2024-04-24T16:00:00Z",
"shipToBusinessUnitDeliveryDateTime": "2024-04-25T03:00:00Z",
"customerRouteStartDateTime": "2024-03-12T06:15:00Z",
"customerRouteCode": "2KROL1"
},
{
"sku": "ADDFFF",
"location": "HSN",
"availability": 10,
"latestDeliveryDate": "2024-04-25",
"orderDateTimeTo": "2024-04-24T19:00:00Z",
"shipToBusinessUnitDeliveryDateTime": "2024-04-25T03:00:00Z"
}
]
In the Customer service, on April 22, 2024, an additional field named logisticPath was added. It represents the logistic path of the customer. The structure of the response has been modified:
{
"name": "INTER CARS S.A.",
"countryCode": "PL",
"address": [
{
"countryCode": "PL",
"locality": "Kielce",
"streetAddressFull": "Wiejska, 3/5",
"street": "Wiejska",
"building": "1",
"flat": "5",
"postalCode": "25319",
"postOffice": "Warszawa"
}
],
"logisticPath": [
"HSN",
"HZA",
"ZKM",
"LIS"
],
"defaultLocation": "KOM",
"fiscalDocument": "INVOICE",
"paymentMethods": [
"02"
],
"defaultPaymentMethod": "02",
"paymentTerm": 14,
"defaultDeliveryMethod": "I"
}
On April 10, 2024, a change was introduced in the Invoice service in the GET /invoice operation to return invoices of recipient accounts in the payer's account.