Documentation Blog

Dodano informację o ilościach i jednostkach miary

Fri, 31 Oct 2025 00:00:00 GMT

W dniu 31 października 2025 roku wprowadzono do plików CSV Product Information możliwość pokazywania dla wybranych towarów informacji o ilości i jednostce miary. Domyślnie informacje te nie są widoczne, na życzenie Klienta włączane są dodatkowe pola: unit i quantity.

Dodano informację o kodach GTU (Grupy Towarów i Usług)

Mon, 13 Oct 2025 00:00:00 GMT

W dniu 13 października 2025 roku wprowadzono do plików CSV możliwość wyświetlania dla tych towarów których to dotyczy, kodów GTU (Grupy Towarów i Usług). Domyślnie kody są dodawane do plików Product Information, na życzenie możliwe jest włączenie widoczności kodów w plikach Stock, Stock Price, Wholesale Pricing.

Dodano możliwość ograniczenia zakresu plików CSV do wybranych producentów

Fri, 10 Oct 2025 00:00:00 GMT

W dniu 10 października 2025 roku wprowadzono do plików CSV możliwość pokazywania w nich tylko produktów wskazanych producentów. Bazując np. na obecnym pliku Product Information można wskazać wybranych obecnych w nim producentów i zgłosić potrzebę obecności w plikach tylko towarów pochodzących od tych producentów.

Dodanie pola gtuCode

Wed, 10 Sep 2025 00:00:00 GMT

W dniu 10 września 2025 roku wprowadzono pole gtuCode.

Dodanie możliwości odpytania usługi Catalog po GenericArticle dla powyżej 10 tysięcy towarów

Tue, 09 Sep 2025 00:00:00 GMT

W dniu 09 września 2025 roku wprowadzono zmiany dla usługi Catalog. Dodano możliwość wyszukania obiektów po GenericArticle, powyżej 10 tysięcy.

Usunięcie facets z odpowiedzi endpointu GET/products w usłudze Catalog

Thu, 29 May 2025 00:00:00 GMT

W dniu 29 maja 2025 roku wprowadzono zmiany dla usługi Catalog. Z odpowiedzi usunięto obiekt facets, który zawierał identyfikator kategorii lub atrybutu.

Dodawanie nowego pola w odpowiedzi z usługi Delivery

Tue, 06 May 2025 00:00:00 GMT

W dniu 6 maja 2025 roku wprowadzono zmiany dla usługi Delivery. Do odpowiedzi dodano nowy obiekt: brandReference zawierający informację o firmie powiązanej z towarem.

Umożliwiono wprowadzanie dodatkowych deliveryMethods w usłudze Sales

Tue, 14 Jan 2025 00:00:00 GMT

W dniu 14 stycznie 2025 roku wprowadzono zmiany w walidacji danych wejściowych umożliwiając wskazanie deliveryMethod = DISTR dla klientów z Belgii.

Dodano informację o blokadzie zwrotu w usłudze Pricing i Inventory

Fri, 20 Dec 2024 00:00:00 GMT

W dniu 20 grudnia 2024 roku wprowadzono usługach Pricing i Inventory oraz Catalog nową kolumnę: blocked_return. Kolumna ta zawiera informację o ew. ustawionej blokadzie zwrotu na dany towar (w takim przypadku pojawia się wartość: true).

Dodano informację o blokadzie zwrotu w plikach CSV ProductInformation

Thu, 05 Dec 2024 00:00:00 GMT

W dniu 4 grudnia 2024 roku wprowadzono do plików CSV ProductInformation nową kolumnę: blocked_return. Kolumna ta zawiera informację o ew. ustawionej blokadzie zwrotu na dany towar (w takim przypadku pojawia się wartość: true). Na życzenie Klienta możliwe jest wyłączenie prezentowania dodatkowej kolumny.

Informacja o trasach przypiętych do klienta w usłudze Customer

Mon, 19 Aug 2024 00:00:00 GMT

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.

Dodanie możliwości odpytania usługi Catalog po SKU lub indexie towaru

Mon, 15 Jul 2024 00:00:00 GMT

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:

Aby wywołać operację GET /products przy użyciu kodu SKU, należy przesłać parametr zapytania queryParam o nazwie sku.
Aby wywołać operację GET /products przy użyciu indeksu towaru, należy przesłać parametr zapytania queryParam o nazwie index.

Przykłady użycia:

Wywołanie po kodzie SKU:

GET /products?sku=

Wywołanie po indeksie towaru:

GET /products?index=

Informacja o automatycznym potwierdzaniu zamówień w usłudze Customer

Wed, 10 Jul 2024 00:00:00 GMT

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.

Walidacja przesłanych kodów towarów(SKU/index)

Wed, 19 Jun 2024 00:00:00 GMT

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:

Inventory
Pricing
Sales

Kody EAN w odpowiedziach usług

Mon, 17 Jun 2024 00:00:00 GMT

17 maja ukazała się nowa wersja usług:

Delivery
Invoice
Inventory
Pricing
Sales

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"
        ]
    }
]

Nowa usługa Catalog jako REST'owa alternatywa dla pobierania pliku CSV ProductInformation

Fri, 31 May 2024 00:00:00 GMT

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:

- Search Categories - umożliwia pobranie hierarchicznej struktury kategorii produktów.

[
    {
        "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"
    },
    ...
]

- Search Product - służy do wyszukiwania definicji produktów z użyciem paginacj oraz filtrów (identyfikatora kategorii oraz nazwy producenta)

{
    "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
            },
            ...
        ]
    }
}

Więcej informacji https://intercars.gitlab.io/ic-api/docs/documentation/direct/catalog

Results total w usługach Delivery oraz Invoice

Wed, 08 May 2024 00:00:00 GMT

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.

Czasy dostawy w usłudze Inventory

Wed, 24 Apr 2024 00:00:00 GMT

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"
    }
]

Ścieżka logistyczna w usłudze Customer

Mon, 22 Apr 2024 00:00:00 GMT

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"
}

Widoczność faktur odbiorców na koncie płatnika

Wed, 10 Apr 2024 00:00:00 GMT

10 kwietnia 2024 wprowadzono zmianę w usłudze Invoice w operacji GET /invoice o zwracanie faktur kont odbiorców na koncie płatnika.

Dodanie statusu użytkownika w usłudze Customer

Fri, 29 Mar 2024 00:00:00 GMT

Od 28 marca 2024 operacja GET /customer w usłudze Customer zwraca informacje czy konto użytkownika jest aktywne. Informacja zwracana jest w nowym polu status z możliwymi wartościami: ACTIVE lub INACTIVE

Usprawnienie niezawodności serwisów w ramach IC API

Thu, 28 Mar 2024 00:00:00 GMT

Pod koniec marca wprowadzono zmiany techniczne w większości usług IC API w celu zmniejszanie zależności usług do innych komponentów. Celem zmian jest zwiększenie dostępności IC API dla wszystkich klientów.

Dodano nowe informacji o towarach

Wed, 27 Mar 2024 00:00:00 GMT

Od 28 marca 2024 usługi Invntory, Pricing, Sales zwracają nowe informacje o towarach tj.:

index - indeks towaru
name - nazwa towaru
description - opis towaru
gtuCode - kod GTU

Dodanie funkcjonalności odpytywania usług po indeksie towaru

Tue, 26 Mar 2024 00:00:00 GMT

26 marca 2024 umożliwiono odpytywanie usług posługując się indeksem towaru zamiast kodem sku. Funkcjonalność dodana w usługach:

Inventory
Pricing
Sales

Przykład wywołania operacji POST /stock usługi Invetory

{
    "index": "290 887,500317793"
}

Dodanie fukncjonalności składania zamówień z wyborem metody dostawy dla użytkowników UA

Wed, 13 Mar 2024 00:00:00 GMT

13 marca 2024 dla kont UA dodano możliwość składania zamówień podajć metodę dostawy. Aby skorzystać z nowej funkcji należy w przesłanym komunikacie w body wiadomości przesłać element deliveryMethod z wartością SHOP lub SHIPMENT.

Przykład wywołania operacji POST /sales/requisition usługi Sales z metodą dostawy:

{
    "deliveryMethod": "SHIPMENT",
    "lines": [
        {
            "index": "LY1121",
            "requiredQuantity": 1
        }
    ]
}

Zwracanie nowych informacji o finansach użytkownika

Wed, 28 Feb 2024 00:00:00 GMT

28 lutego 2024 w odopowiedzi operacji GET /finances usługi Customer dodano nowe informacje o finansach tj.:

availableCreditLimit - dostępny limit kredytowy
notInvoicedOrders - kwota niezafakturowanych zamówień

Numer FV w usługach Delivery

Wed, 20 Dec 2023 00:00:00 GMT

W dniu 12.20.2023 została wdrożona nowa wersja usługi delivery umożliwiająca bezpośrednie pobranie powiązanego numeru faktury. Dodatkowe pole dostepnę jest jako fiscalDocumentNumber:

[
    {
        "id": "193834/AAA/2024",
        "orderId": "154548/AAA/2024",
        "billTo": "112790",
        "shipTo": "112790",
        "shipFrom": "AAA",
        "deliveryMethod": "I",
        "creationDate": "2024-04-11T13:23:20+02:00",
        "currencyCode": "PLN",
        "fiscalDocumentNumber": "00037557/AAA/24/F",
        "lines": [
            {
                "index": "111 2222 31",
                "sku": "AAAAAA",
                "name": "Rozrząd kpl. (pasek + rolka + pompa cieczy)",
                "shippedQuantity": 1,
                "returnedQuantity": 0,
                "unitPriceNet": 265.05,
                "unitPriceGross": 326.01,
                "vatPercentage": 23,
                "totalNet": 265.05,
                "totalGross": 326.01
            }
        ]
    }
]

Walidacja parametru sku

Wed, 06 Dec 2023 00:00:00 GMT

6 Grudnia wprowadzono walidację parametrów sku w usługach Inventory oraz Price. W przypadku podania nieprawidłowej wartości w odpowiedzi zostanie zwrócony nagłowek HTTP o nazwie "skipSkuList" z inforamcją o sku, które zostały zignorowane. W przypadku gdy żaden z parametrów nie jest poprawny zostanie zwrócony komunikat o błędzie walidacji.

Wprowadzenie alternatywnych metod dostaw przy składaniu zamówień

Wed, 22 Nov 2023 00:00:00 GMT

W dniu 22.11.2023 umożliwono składanie zamówień podając alternatywne metody dostaw tj.: PACZKOMATY i XPRESS DELIVERY. Aby skorzystać z dodanej funkcjonalności konto użytkownika musi być odpowiednio skonfigurowane i w body operacji POST /ic/sales/requisition należy dodać element deliveryMethod z odpowiednią wartością.

Możliwe wartości deliveryMethod:

5 - XPRESS DELIVERY
6 - PACZKOMATY

Zwracanie informacji o podzielonym zamówieniu

Mon, 04 Sep 2023 00:00:00 GMT

W dniu 04.09.2023 wprowadzono zmianę w operacji do składania zamówień POST /ic/sales/requisition. Teraz w odpowiedzi operacji może być zwrócne kilka zamówień zamiast jednego. Taki przypadek pojawia się gdy składane zamówienie zostanie podzielone na kilka zamówień.

Zwiększenie wydajności usług Pricing i Sales

Tue, 29 Aug 2023 00:00:00 GMT

29.08.2023 wdrożono usprawnienia techniczne w usługach Pricing i Sales w celu zwiększenia wydajności i elastyczności serwisu.

Wprowadzenie identyfikatora technicznego w usłudze Invoice

Wed, 26 Jul 2023 00:00:00 GMT

26.07.2023 w usłudze Invoice dodano identyfiktar techniczny.

Operacja Search Invoice(np. GET /ic/invoice?issueDateFrom=2023-03-01&issueDateTo=2023-03-05) w odpowiedzi zawiera dodatkowo element techId.
Operaja Get Invoice Details można wywołać posługując się identyfkatorem technicznym. Aby skorzystać oprócz identyfikatora technicznego należy przekazać query param techId z wartością true np. GET /ic/invoice/251191019?techId=true

Dodanie informacji o zwrotach niezafakturowanych towarów

Tue, 27 Jun 2023 00:00:00 GMT

W dniu 27.06.2023 udostępniono nową wersję usługi Delivery, która w odpowiedzi zwraca nowy element returnedQuantity - informacje o zwrotach niezafakturowanych towarów, przykład odpowiedzi z informacją returnedQuantity:

[

    {

        "id": "111111/XXX/2023",

        "orderId": "222222/XXX/2023",

        "billTo": "111111",

        "shipTo": "222222",

        "shipFrom": "XXX",

        "deliveryMethod": "I",

        "creationDate": "2023-06-01T10:52:46+02:00",

        "currencyCode": "PLN",

        "lines": [

            {

                "index": "D4-1594C",

                "sku": "E15554",

                "name": "Zestaw naprawczy zacisku hamulcowego",

                "shippedQuantity": 1,

                "returnedQuantity”: 1,

                "unitPriceNet": 57.89,

                "unitPriceGross": 71.2,

                "vatPercentage": 23,

                "totalNet": 57.89,

                "totalGross": 71.2

            }

        ]

    }

]

Nowe serwery IC API

Wed, 11 Jan 2023 00:00:00 GMT

Od 01.02.2023 do 15.02.2023 planujemy migrację serwerów IC. W zwiazku z tym wszyscy klienci będą musieli zmienić swoje ustawienia konfiguracyjne. Zmieni się URL oraz informacje bezpieczeństwa. Wszystkie usługi, operacje i parametry pozostają bez zmian.

Szczególowy plan migracji zostanie rozesłany do wszystkich zaresjestrowanych klientów IC

Informacje o produktach IC

Tue, 03 Jan 2023 00:00:00 GMT

W styczniu na IC API pojawi się nowa funckjonalność Katalogu Produktu. Z jago pomocą można wyszukać informacje o produktach/częsciach znajdujacych się w ofercie IC. Szczególowe informacje pojaią się wkrótce.

Dropshiping dostępny na produkcji

Wed, 07 Dec 2022 00:00:00 GMT

API do sprzedazy w modelu Dropshipping dostepne do uzycia .