Allegro WebAPI

Interfejs programistyczny platformy Allegro

doSellSomeAgain

Ostatnia zmiana: 24.07.2014 r.
Dostępność:
Metoda pozwala na wystawienie ofert w serwisie na podstawie ofert istniejących. Z uwagi na specyfikę działania mechanizmu ponownego wystawiania ofert - identyfikatory ofert zwracane na wyjściu, to identyfikatory ofert na podstawie których nowe oferty zostały/miały zostać wystawione - nie identyfikatory nowowystawionych ofert. W celu sprawdzenia numeru nowowystawionej oferty należy nadać jej lokalny identyfikator podczas wywoływania doSellSomeAgain, a następnie użyć go w metodzie doVerifyItem.

  1. session-handle |  string | wymagany
    Identyfikator sesji użytkownika, uzyskany za pomocą metody doLogin(Enc).
  2. sell-items-array | long[] | wymagany
    Tablica identyfikatorów ofert, które mają zostać wystawione ponownie (maks. 25).
  3. sell-starting-time | long | niewymagany
    Data wystawienia ofert (w formacie Unix time). W przypadku gdy oferty mają zostać wystawione od razu, w parametrze tym należy przekazać 0.
  4. sell-auction-duration | int | wymagany
    Czas trwania oferty w dniach (dozwolone wartości: 3, 5, 7, 10, 14 oraz 21 - ostatnie tylko dla: Rosji, Ukrainy, Rumunii i Serbii).
  5. sell-options | int | niewymagany
    Parametr pozwalający na wskazanie dodatkowych czynności, które mają zostać wykonane po ponownym wystawieniu oferty (1 - źródłowe oferty zostaną usunięte z odpowiedniej zakładki w Moim Allegro, 2 - zostanie wysłany e-mail potwierdzający wystawienie, 3 - obie wymienione).
  6. local-ids | int[] | niewymagany
    Tablica lokalnych identyfikatorów, które mają zostać dodatkowo nadane ofertom (zakres: 1-9999999999999).



Orientacyjna struktura wywołania metody

$dosellsomeagain_request = array(
   'session-handle' => '22eb99326c6be29aa16d07d622bcfbcbee94ad54846f2f4e03_1',
   'sell-items-array' => array(1048196513, 1027093711),
   'sell-starting-time' => 0,
   'sell-auction-duration' => 7,
   'sell-option' => 2,
   'local-ids' => array(10, 11)
);

  1. items-sell-again | StructSellAgain[]
    Tablica struktur zawierających informacje o ofertach wystawionych ponownie.
    1. sell-item-id | long
      Identyfikator oferty, na podstawie której została wystawiona nowa oferta.
    2. sell-item-info | string
      Informacja o kosztach związanych z wystawieniem oferty.
    3. sell-item-local-id | int
      Wartość nadanego lokalnego identyfikatora (do wykorzystania w doVerifyItem).
  2. items-sell-failed | StructSellFailed[]
    Tablica struktur zawierających informacje o ofertach, które nie zostały wystawione ponownie.
    1. sell-item-id | long
      Identyfikator oferty, na podstawie której miała zostać wystawiona nowa oferta.
    2. sell-fault-code | string
      Kod błędu wskazujący na powód niepowodzenia.
    3. sell-fault-string | string
      Komunikat błędu opisujący powód niepowodzenia.
  3. items-sell-not-found | long[]
    Tablica identyfikatorów ofert, które nie zostały wystawione ponownie (wskazane oferty nie należały do zalogowanego użytkownika lub podane identyfikatory były niepoprawne).



    Orientacyjna struktura odpowiedzi serwera

    $dosellsomeagain_response = array(
       'items-sell-again' => array(
          array(
             'sell-item-id' => 1048196513,
             'sell-item-info' => 'Wystawienie przedmiotu: 0,15 zł',
             'sell-item-local-id' => 10)),
       'items-sell-failed' => array(),
       'items-sell-not-found' => array(1027093711)
    );

    • ERR_AUCTION_TYPE_NOT_EXISTS
      Nie można wystawić wieloprzedmiotowej licytacji lub na podaną kategorię nałożone jest ograniczenie niepozwalające na wystawianie w niej ofert wieloprzedmiotowych.
    • ERR_BLOCK_SELL_COMPANY_INFO
      Użytkownik z blokadą znaczka Firma nie może wystawiać nowych ofert. 
    • ERR_BLOCK_SELL_SELL
      Użytkownik z blokadą sprzedaży na koncie nie może wystawiać nowych ofert. Aby wyjaśnić powód blokady, należy skontaktować się z Allegro poprzez formularz kontaktowy.
    • ERR_BLOCKED_USER_CANT_INVOKE_METHOD
      Użytkownik z blokadą konta nie może korzystać z tej metody.
    • ERR_CATEGORY_NOT_FOUND
      Nie podano identyfikatora kategorii, identyfikator jest błędny, lub wskazana kategoria nie jest kategorią najniższego rzędu.
    • ERR_CATEGORY_PAGE_NOT_ENOUGH_MONEY
      Nie można ustawić opcji promowania oferty na stronie kategorii z powodu braku funduszy na koncie wystarczających do uiszczenia przedpłaty (dotyczy Czech).
    • ERR_DEBT_NO_EXTRAS
      Stan konta jest zbyt niski, by wystawienie oferty było możliwe (dotyczy Ukrainy i Bułgarii).
    • ERR_DEPARTMENT_PAGE_RATING_TOO_LOW
      Nie można ustawić opcji promowania oferty na stronie działu z powodu niewystarczającej liczby punktów użytkownika (wymagane min. 5 punktów).
    • ERR_FEATURED_NOT_ACTIVATED
      Nie można ustawić opcji Wyróżnienie z powodu braku pełnej aktywacji konta (dot. Rosji).
    • ERR_INCORRECT_CONVERSION_TO_CORE
      To jest oferta ze sklepu Allegro. Tutaj wystawisz tylko oferty niesklepowe.
    • ERR_INPUT_ARRAY_EMPTY
      Nie podano min. jednego identyfikatora oferty.
    • ERR_INVALID_DURATION_TIME
      Niepoprawna wartość w parametrze określającym czas trwania oferty.
    • ERR_ITEM_AND_LOCAL_IDS_MISMATCHED
      Liczba identyfikatorów w tablicy local-ids jest różna od liczby podanych identyfikatorów ofert.
    • ERR_ITEMS_ARRAY_OVERSIZED
      Liczba podanych identyfikatorów ofert przekracza dopuszczalny limit (maks. 25).
    • ERR_JUNIOR_CANT_BID_LIST_IN_THIS_CATEGORY
      Użytkownik konta Junior nie może wystawić oferty w wybranej kategorii (ograniczenia dot. kategorii: Nieruchomości, Samochody, Motocykle, Inne pojazdy i łodzie, Trafika, Broń, Wiatrówki, Erotyka).
    • ERR_JUNIOR_LIMIT_EXCEEDED
      Przekroczono limit 50 zł na wystawianie ofert, który obowiązuje dla użytkowników konta Junior.
    • ERR_MAIN_AND_CATEGORY_PAGE_NOT_ENOUGH_MONEY
      Nie można ustawić opcji promowania oferty na stronie głównej serwisu oraz stronie kategorii z powodu braku funduszy na koncie wystarczających do uiszczenia przedpłaty (dotyczy Czech).
    • ERR_MAIN_PAGE_INCORRECT_CATEGORY
      Dla wybranej kategorii nie można ustawić opcji promowania oferty na stronie głównej serwisu.
    • ERR_MAIN_PAGE_NOT_ENOUGH_MONEY
      Nie można ustawić opcji promowania oferty na stronie głównej serwisu z powodu braku funduszy na koncie wystarczających do uiszczenia przedpłaty (dotyczy Czech).
    • ERR_NO_DATABASE
      Problemy z bazą danych Allegro.
    • ERR_NO_ON_DELIVERY_PAYMENT
      Dla wybranych opcji płatności przy odbiorze należy wybrać odpowiednią formę płatności.
    • ERR_NO_PREPAID_PAYMENT
      Dla wybranych opcji płatności z góry należy wybrać odpowiednią formę płatności.
    • ERR_NO_SESSION / ERR_SESSION_EXPIRED
      Niepoprawny identyfikator sesji lub sesja wygasła.
    • ERR_NOT_ALLOWED_CHARS_IN_ITEM_NAME_OFFLINER
      W tytule oferty użyto niedozwolonych znaków. Wszystkie użyte znaki muszą istnieć w alfabecie kraju zalogowanego użytkownika.
    • ERR_NOT_ENOUGH_MONEY_TO_SELL
      Stan konta jest zbyt niski, by wystawić ofertę z płatnymi opcjami promowania (dotyczy Czech i Rosji).
    • ERR_OBLIGATORY_ATTRIB_NOT_SET
      Nie podano parametru wymaganego dla wybranej kategorii.
    • ERR_OTHER_PHOTO_ERROR
      Wyniknęły problemy podczas przesyłania zdjęć na serwer.
    • ERR_PHARMACY_NO_COMPANY
      Aby móc wystawiać oferty w kategorii Leki bez recepty należy posiadać konto Firma.
    • ERR_PHARMACY_NOT_ACTIVE
      Aby móc wystawiać oferty w kategorii Leki bez recepty należy posiadać aktywny status Apteka.
    • ERR_PHARMACY_NOT_ALLOWED_AUCTION_TYPE
      W kategorii Leki bez recepty wystawiane być mogą wyłącznie oferty Kup Teraz!.
    • ERR_PHARMACY_REQUIREMENTS_NOT_MET
      Aby móc wystawiać oferty w kategorii Leki bez recepty należy brać udział w programie Aukro+, a wystawiany towar nie może być w stanie innym niż nowy (dotyczy CZ).
    • ERR_POSTAGE_OPTIONS_VALUES_INCORRECT
      Niepoprawnie wypełniono koszta dostawy (należy podać wartość we wszystkich trzech polach: pierwsza sztuka, kolejna sztuka, ilość w paczce - lub jedynie dla pierwszej sztuki).
    • ERR_SELECT_PHOTO
      Brak danych zdjęcia.
    • ERR_TOO_DISTANT_FUTURE
      Niepoprawna (zbyt odległa) data rozpoczęcia oferty (maks. 30 dni naprzód).
    • ERR_TOO_MANY_FUTURE_AT_THIS_TIME
      Przekroczono ogólny limit ofert do planowanego wystawienia (1000) w wybranej 5-minutowej puli.
    • ERR_TOO_MANY_ITEMS
      Przekroczono limit na wystawianie ofert przez użytkowników bez pełnej aktywacji konta (dotyczy Rosji).
    • ERR_TOO_MANY_YOUR_FUTURE_AUCTIONS
      Przekroczono jednostkowy (dla użytkownika) limit ofert do planowanego wystawienia (1000).
    • ERR_WEBAPI_KEY_INACTIVE
      Klucz WebAPI na którym została wygenerowana sesja został zdezaktywowany (jego właściciel nie zaakceptował warunków Regulaminu WebAPI).
    • ERR_WEBAPI_NOT_AVAIL
      Problemy z usługą Allegro WebAPI.

    Allegro nie bierze odpowiedzialności za skutki wykorzystania zamieszczonych przykładów kodu, nie daje także gwarancji ich poprawnego działania. Widoczny kod ma charakter wyłącznie poglądowy i może zawierać błędy.