W dniu 19 sierpnia 2024 roku wprowadzono nową wersję usługi Customer. Do odpowiedzi operacji GET /customer dodano nową flagę routes active. Flaga ta informuje, czy do klienta są aktualnie przypięte trasy logistyczne.
W dniu 15 lipca 2024 roku wprowadzono możliwość odpytywania operacji GET /products w usłudze Catalog na podstawie kodu SKU lub indeksu towaru.
Szczegóły implementacji:
Przykłady użycia:
GET /products?sku=<kod_SKU>
Wywołanie po indeksie towaru:
GET /products?index=<indeks_towaru>
W dniu 10 lipca 2024 roku wprowadzono nową wersję usługi Customer. Do odpowiedzi operacji GET /customer dodano nową flagę automaticOrderConfirmation. Flaga ta informuje, czy zamówienia składane przez użytkownika będą wysyłane w trybie automatycznego potwierdzania.
19 maja wprowadzono walidację kodów towarów (SKU/index) przesyłanych przez użytkowników. Wszystkie towary, które są niedostępne lub błędne, zostaną pominięte w odpowiedzi. Pełna lista pominiętych produktów będzie zwrócona w nagłówku HTTP: skpSkuList dla zapytań po SKU lub skiIndexList dla zapytań po indeksie.
Zmiana wprowadzona w usługach:
17 maja ukazała się nowa wersja usług:
W odpowiedziach wyżej wymienionych usług, dodano kody EAN w sekcji z informacjami o towarach.
Przykład odpowiedzi usługi Inventory z kodami EAN zwróconymi dla towaru 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"
]
}
]
31 maja 2024 wprowadzono nowa usługę Catalog. Usługa umożliwia wyszukiwanie definicji produktów w czasie rzeczywistym.
Na usługę składają się obecnie dwie operacje:
[
{
"categoryId": "SalesClassificationNode_6100000",
"label": "Filtry"
},
{
"categoryId": "SalesClassificationNode_6200000",
"label": "Silnik / osprzęt"
},
{
"categoryId": "SalesClassificationNode_6300000",
"label": "Zawieszenie / Koła"
},
{
"categoryId": "SalesClassificationNode_6400000",
"label": "Amortyzacja pojazdu"
},
{
"categoryId": "SalesClassificationNode_6811050",
"label": "Układ zapłonowy / żarowy"
},
...
]
{
"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": "Obudowa filtra oleju",
"description": "Obudowa filtra oleju pasuje do: 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": "filtr oleju DB",
"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
},
...
]
}
}
8 Maja dodano nowy nagłówek HTTP zawierający informację o ilości wyszukanych danych na potrzeby paginacji o nazwie "restultsTotal" w usłudze Delivery oraz Invoice.
Na początku maja planowane jest zaktualizowanie usługi Inventory o dodatkowe informacje dotyczące czasów dostawy artykułów z poszczególnych magazynów do fili bazowej przypisanej do klienta. Dodatkowe, opcjonalne pola orderDateTimeTo, shipToBusinessUnitDeliveryDateTime, customerRouteStartDateTime, customerRouteCode zostały dodane do struktury odpowiedzi:
[
{
"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"
}
]
W usłudze Customer 22 Kwietnia 2024 roku zostało dodane dodatkowe pole logisticPath. Jest to ścieżka logistyczna klienta. Struktura odpowiedzi została zmodyfikowana:
{
"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"
}
10 kwietnia 2024 wprowadzono zmianę w usłudze Invoice w operacji GET /invoice o zwracanie faktur kont odbiorców na koncie płatnika.