WebAPI aktualności - Platforma iStore - Załóż własny sklep internetowy

Tutaj znajdziesz najnowsze informacje dotyczące zmian i wydarzeń związanych z WebAPI

(2011-12-06) Zmianę w parametrze PaymentSession

Dnia 2011-12-05 zmieniliśmy typ parametru PaymentSession z int na string. Z parametru korzystają następujące metody:

doOrder
getOrder

(2011-10-28) Dnia 2011-10-28 wdrożyliśmy zmianę w typie User

Zmiana polega na dodaniu nowego parametru IsCompany typu boolean, parametr ten jest opcjonalny. Z parametru korzystają następujące metody:

doEditOrderClient
doOrder
getOrder
getUser

(2011-09-30) Dnia 2011-09-29 wdrożyliśmy zmianę w metodzie getProductImages

Metoda getProductImages zwraca tablicę obiektów/typów ProductImage[]. Obiekt ten zawiera 2 właściwości:

type ProductImage::Main (bool) - czy obrazek jest zdjęciem domyślnym produktu
type ProductImage::Url (string) - url do obrazka

(2011-09-23) Zmiany w metodach: doOrder, getOrder, doEditOrderClient, getShopData, getUser. Zmiany polegają na dodaniu nowych parametrów oraz modyfikacji istniejących typów parametrów

Dnia 2011-09-22 wdrożyliśmy zmiany w poniższych metodach.

Metoda doOrder

dodanie nowego parametru Status (aktywność kuponu) type string i ulokowanie go w parametrze Coupon type Coupon
dodanie nowego parametru InvoiceAddress type Address:
- Id type int (intidentyfikator adresu)
- Name type string (imię i nazwisko / nazwa)
- Postcode type string (kod pocztowy)
- City type string (miasto)
- Street type string (ulica, numer domu i mieszkania)
- CountrySymbol type string (symbol kraju (ISO 3166-1 alfa-2 ))
- VoivodeshipId - nillable; type int (Identyfikator województwa)
dodanie nowych parametrów firstname type string oraz lastname type string i ulokowanie ich w parametrach type Address

Metoda getOrder

dodanie nowego parametru Status (aktywność kuponu) type string i ulokowanie go w parametrze Coupon type Coupon
dodanie nowego parametru InvoiceAddress type Address:
- Id type int (intidentyfikator adresu)
- Name type string (imię i nazwisko / nazwa)
- Postcode type string (kod pocztowy)
- City type string (miasto)
- Street type string (ulica, numer domu i mieszkania)
- CountrySymbol type string (symbol kraju (ISO 3166-1 alfa-2 ))
- VoivodeshipId - nillable; type int (Identyfikator województwa)
dodanie nowych parametrów firstname type string oraz lastname type string i ulokowanie ich w parametrach type Address

Metoda doEditOrderClient

dodanie nowego parametru InvoiceAddress type Address:
- Id type int (intidentyfikator adresu)
- Name type string (imię i nazwisko / nazwa)
- Postcode type string (kod pocztowy)
- City type string (miasto)
- Street type string (ulica, numer domu i mieszkania)
- CountrySymbol type string (symbol kraju (ISO 3166-1 alfa-2 ))
- VoivodeshipId - nillable; type int (Identyfikator województwa)
dodanie nowych parametrów firstname type string oraz lastname type string i ulokowanie ich w parametrach type Address

Metoda getShopData

dodanie nowych parametrów firstname type string oraz lastname type string i ulokowanie ich w parametrach type Address

Metoda getUser

dodanie nowych parametrów firstname type string oraz lastname type string i ulokowanie ich w parametrach type Address

(2011-08-18) Zmiany w metodach doCategory, getCategoryTree oraz dodanie nowej metody getCategory

2011-08-18 wdrożyliśmy zmiany w WebAPI:

dodanie nowej metody getCategory:
- na wejściu metody:
  - sessionId type string (id sesji)
  - catId type int (id kategorii)
- na wyjściu metody:
  - Id - nillable; type int (identyfikator kategorii)
  - Shopid - nillable; type int (identyfikator sklepu)
  - Children - nillable; type ArrayOfCategory - array of type Category ... is recursive (lista podkategorii)
  - Names - nillable; type ArrayOfTranslationName - array of type TranslationName:
    - Symbol - nillable; type string (Symbol kraju (ISO 3166-1 alfa-2 ))
    - Name - nillable; type string (Nazwa)
  - Descriptions type ArrayOfTranslationDescription - array of type TranslationDescription:
    - Symbol - nillable; type string (Symbol kraju (ISO 3166-1 alfa-2 ))
    - Name - nillable; type string (Opis)
  - Metadescriptions type ArrayOfTranslationName - array of type TranslationName:
    - Symbol - nillable; type string (Symbol kraju (ISO 3166-1 alfa-2 ))
    - Name - nillable; type string (Nazwa)
  - Metakeywords type ArrayOfTranslationName - array of type TranslationName:
    - Symbol - nillable; type string (Symbol kraju (ISO 3166-1 alfa-2 ))
    - Name - nillable; type string (Nazwa)
  - ProductCount type int (ilość produktów przypisana do kategorii)
  - ParentId type int (id kategorii nadrzędnej)
zmiana w metodach doCategory, getCategoryTree:
- na wyjściu metody:
  - Id - nillable; type int (identyfikator kategorii)
  - Shopid - nillable; type int (identyfikator sklepu)
  - Children - nillable; type ArrayOfCategory - array of type Category ... is recursive (lista podkategorii)
  - Names - nillable; type ArrayOfTranslationName - array of type TranslationName:
    - Symbol - nillable; type string (Symbol kraju (ISO 3166-1 alfa-2 ))
    - Name - nillable; type string (Nazwa)
  - Descriptions type ArrayOfTranslationDescription - array of type TranslationDescription:
    - Symbol - nillable; type string (Symbol kraju (ISO 3166-1 alfa-2 ))
    - Name - nillable; type string (Opis)
  - Metadescriptions type ArrayOfTranslationName - array of type TranslationName:
    - Symbol - nillable; type string (Symbol kraju (ISO 3166-1 alfa-2 ))
    - Name - nillable; type string (Nazwa)
  - Metakeywords type ArrayOfTranslationName - array of type TranslationName:
    - Symbol - nillable; type string (Symbol kraju (ISO 3166-1 alfa-2 ))
    - Name - nillable; type string (Nazwa)
  - ProductCount type int (ilość produktów przypisana do kategorii)
  - ParentId type int (id kategorii nadrzędnej)

(2011-08-02) Zmiana w metodach doProduct, getProduct oraz getUnits

2011-07-28 wdrożyliśmy zmianę w metodach doProduct, getProduct oraz getUnits. Zmiana polega na dodaniu kolejnej wartości "op.", w przypadku metod doProduct oraz getProduct dla parametru Unit.

(2011-08-02) Zmiana w metodzie doCategory

2011-07-28 wdrożyliśmy zmianę w metodzie doCategory. Zmiana polega na poprawieniu nazwy parametru z "descpritions" na "descriptions".

(2011-07-14) Zmiana w metodach doProduct oraz getProduct

2011-07-14 wdrożyliśmy zmianę w metodach doProduct oraz getProduct. Zmiana polega na dodaniu nowego parametru Ean. Parametr ten jest opcjonalny.

(2011-07-08) Zmiana w metodzie searchProducts

2011-07-07 wdrożyliśmy zmianę w metodzie searchProducts. Zmiana polega na ograniczeniu ilości wymaganych parametrów do podania na wejściu metody. Wymagane parametry:

SearchedPhrase (szukana fraza w nazwie lub w opisie)
LanguageSymbol (symbol języka)
CurrencyId (identyfikator waluty)

(2011-07-08) Zmiany w metodach doProduct oraz getProduct

2011-07-07 wdrożyliśmy zmiany w dwóch metodach, doProduct oraz getProduct:

usunięte parametry:
- Recommended (produkt jest polecany)
- Deleted (produkt usunięty)
parametry, które zmieniły nazewnictwo:
- 'SWW' -> 'PKWiU'
- 'HideCeneoOpinions' -> 'HideExternalOpinions'
dodane nowe parametry:
- Brutto (cena brutto produktu)
- PromotionBrutto (cena brutto promocyjna)
- WholesaleBrutto (cena brutto hurtowa)

Dodatkowe zmiany w metodzie doProduct:

zmienione wymagane parametry:
- Tax (Stawka podateku VAT)
- Netto (cena netto produktu), Brutto (cena brutto produktu) -> jedna z nich jest wymagana, w przypadku podania obu cen, ważniejsza cena brutto
- PromotionNetto (cena netto promocyjna), PromotionBrutto (cena brutto promocyjna) -> jedna z nich jest wymagana (pod warunkiem, że Promotion (produkt w promocji) zwraca wartość TRUE), w przypadku podania obu cen, ważniejsza cena brutto promocyjna
- WholesaleNetto (cena netto hurtowa), WholesaleBrutto (cena brutto hurtowa) -> jedna z nich jest wymagana (pod warunkiem, że Wholesale (produkt dostępny w sprzedaży hurtowej) zwraca wartość TRUE), w przypadku podania obu cen, ważniejsza cena brutto promocyjna
- MainCategory (Kategoria prowizyjna)
- Names (Przetłumaczona nazwa)
- Description (Przetłumaczony opis) -> w przypadku podania tagów html, błąd informujący o niepoprawnym formacie
- CategoriesIds (identyfikatory kategorii)
- Variants (Wariant produktu) -> wymagane jeśli cecha jest podana
zmieniony sposób domyślnie przyjmowanych wartości przez parametry z przypisaną wartością NULL:
- Currency (Waluta) -> domyślna waluta sklepu
- Promotion (produkt w promocji) -> domyślnie nie
- Wholesale (produkt dostępny w sprzedaży hurtowej) -> domyślnie nie
- New (produkt jest nowością) -> domyślnie nie
- DeliveryTimeLengthPeriod (suffix czasu dostawy (D/H/W) -> domyślnie 'D'
- Active (produkt aktywny) -> domyślnie aktywny
- Unit (Jednostka miary) -> domyślnie szt.
- PostSize (gabaryty) -> domyślnie 'A'
- SortProperty (sposób sortowania cech) -> domyślnie wg. ustawień globalnych
- Availability (dostępność produktu) -> domyślnie dostępny
- Quality (stan produktu) -> domyślnie nowy
- Weight (waga produktu) -> domyślnie '0'
- HideExternalOpinions (włączone opinie cokupić.pl) -> domyślnie zaznaczone ukrywanie opinii
- Width (szerokość w milimetrach) -> domyślnie '0'
- Height (wysokość w milimetrach) -> domyślnie '0'
- Deep (głębokość w milimetrach) -> domyślnie '0'
- InpostEnabled (możliwość używania inpostu dla tego produktu) -> jeśli jest forma dostawy "Paczkomaty", wtedy domyślnie tak
parametry, które służą wyłącznie do odczytu po wywołaniu metody doProduct:
- ImagesIds (lista identyfikatorów obrazów produktu)
- Sequence (identyfikator na liście kolejności sortowania)
- Blocked (produkt zablokowany)
- Available (czy produkt można kupić)

(2011-05-26) Zmiana w metodzie doProducer - nazwa producenta unikalna

2011.05.26 r. wdrożyliśmy zmianę w metodzie doProducer. Zmiana polega na blokadzie możliwości utworzenia producenta o nazwie już istniejącej.

(2011-05-11) Nowe wartości zwracane przez parametr TemplateVersion metody getShopData

05.05.2011r. wdrożyliśmy zmiany w metodzie getShopData. Zaktualizowane zostały dane zwracane przez parametr "TemplateVersion". Poniżej wyszczególniono te dane:

classic1 - niebieski
classic2 - czerwony
classic3 - różowy
classic4 - błękitny
classic5 - zielony
classic6 - bordowy
modern3 - czerwony
modern4 - zielony
modern5 - niebieski
modern6 - różowy
horizon1 - beżowy
horizon2 - niebieski
horizon3 - granatowy
horizon4 - brązowy
experience1 - szary
experience2 - zielony
experience3 - fioletowy
experience4 - czarny

(2011-05-11) Zmiany w typach ProductVariant i Product

05.05.2011r. udostępniliśmy dwa nowe parametry w typach ProductVariant oraz Product:

Typ: ProductVariant - nowe pole: Available - boolean wskazujące na to czy dany wariant produktu można kupić

Typ: Product - nowe pole: Available - boolean wskazujące na to czy dany produkt można kupić

(2011-05-11) Nowa właściwość w strukturze complexType - nillable

05.05.2011r. udostępniliśmy dla każdej właściwości w strukturze complexType nowy parametr nillable zwracający wartości:

„1” – pole niewymagane,
„0” – pole wymagane.

Wartość parametru nillable została określona lustrzanie na podstawie dotychczasowego atrybutu required (required=0 -> nillable=1).

(2011-05-11) Usuwanie kategorii - nowa metoda w WebAPI

05.05.2011r. udostępniliśmy nową metodę: doDeleteCategory. Będzie ona pozwalała na usuwanie wskazanych kategorii. Szczegółowe dane dotyczące nowej metody znajdują się niżej.

doDeleteCategory (string sessionId, int categoryId, int moveCategoryId)

sessionId - sesja
categoryId - identyfikator usuwanej kategorii
moveCategoryId - identyfikator kategorii, do której przenoszone są wszystkie podrzędne kategorie (z produktami) kategorii usuwanej, 0 - oznacza skasowanie wszystkich podrzędnych kategorii (z produktami)

(2011-03-30) Dodawanie i edycja kategorii - nowa metoda w WebAPI

30.03.2011r. udostępniliśmy nową metodę pozwalającą na dodanie oraz edycję kategorii sklepowych z wykorzystaniem WebAPI: doCategory.

Więcej informacji nt. metody doCategory.