Allegro WebAPI

Interfejs programistyczny platformy Allegro

doFeedback

Ostatnia zmiana: 14.02.2012 r.
Dostępność:
Metoda pozwala na wystawienie komentarza sprzedającemu będącemu stroną transakcji, do ofert, w których zakup miał miejsce przed 3 kwietnia 2017 roku (data graniczna: 02.04.23:59:59). Kupujący, oprócz wystawienia samego komentarza, zobowiązany jest także do wypełnienia oceny sprzedaży w poszczególnych obszarach. Metoda pozwala także na użycie stałego szablonu komentarza pozytywnego (zawsze dostępnego w języku kraju, do którego zalogowany jest użytkownik), zamiast wpisywania jego treści ręcznie (w takim przypadku ręcznie wpisana treść komentarza każdorazowo zostanie nadpisana zawartością szablonu).

  1. session-handle | string | wymagany
    Identyfikator sesji użytkownika, uzyskany za pomocą metody doLogin(Enc).
  2. fe-item-id | long | wymagany
    Identyfikator oferty, do której ma zostać dodany komentarz.
  3. fe-use-comment-template | int | niewymagany
    Informacja o tym, czy w miejsce ręcznie wpisywanej treści komentarza pozytywnego (czyli tylko dla fe-comment-type = POS), użyty zostać powinien standardowy szablon komentarza przygotowany przez Allegro: Transakcja przebiegła pomyślnie. Polecam. (1 - użycie szablonu, 0 - ręczne wpisanie treści komentarza pozytywnego).
  4. fe-to-user-id | int | wymagany
    Identyfikator użytkownika, któremu ma zostać wystawiony komentarz.
  5. fe-comment | string | wymagany (niewymagany gdy fe-use-comment-template = 1)
    Treść komentarza (ok. 250 znaków).
  6. fe-comment-type | string | wymagany
    Typ komentarza (POS - pozytywny, NEG - negatywny).
  7. fe-op | int | wymagany
    Strona, której ma zostać wystawiony komentarz (1 - komentarz ma zostać wystawiony sprzedającemu, 2 - wartość zdezaktualizowana).
  8. fe-rating | SellRatingEstimationStruct[] | niewymagany (wymagany, gdy fe-op = 1)
    Tablica struktur zawierająca informacje o ocenie poszczególnych obszarów sprzedaży.
    1. sell-rating-group-id | int | wymagany
      Identyfikator obszaru sprzedaży (listę identyfikatorów obszarów sprzedaży uzyskać można za pomocą metody doGetSellRatingReasons). Przy wysyłce gratis, koszcie wysyłki 0 zł lub w przypadku w którym to sprzedający pokrywał koszty wysyłki - gdy wartość w tym polu jest ustawiona na 4 (Koszt wysyłki), a sell-rating-group-estimation ustawione jest na wartość < 5, ocena w tym obszarze automatycznie podmieniana będzie na 5 - niezależnie od faktycznie przekazywanych danych.
    2. sell-rating-group-estimation | int | wymagany
      Ocena obszaru sprzedaży (dopuszczalny zakres: 1-5).
    3. sell-rating-reason-id | int | niewymagany (wymagany, gdy sell-rating-group-estimation < 4)
      Identyfikator powodu niezadowolenia z transakcji dot. danego obszaru (listę identyfikatorów powodów uzyskać można za pomocą metody doGetSellRatingReasons). Identyfikator należy przekazać dla oceny obszaru sprzedaży niższej niż 4. Dla oceny równej 4 lub 5 wartość przekazywana w tym polu będzie ignorowana.



Orientacyjna struktura wywołania metody

$dofeedback_request = array(
   'session-handle' => '22eb99326c6be29aa16d07d622bcfbcbee94ad54846f2f4e03_1',
   'fe-item-id' => 971093571,
   'fe-use-comment-template' => 0,
   'fe-to-user-id' => 2580451,
   'fe-comment' => 'Wzorowa transakcja - polecam!',
   'fe-comment-type' => 'POS',
   'fe-op' => 1,
   'fe-rating' => array()
);

  1. feedback-id | int
    Identyfikator wystawionego komentarza.



Orientacyjna struktura odpowiedzi serwera

$dofeedback_response = array(
   'feedback-id' => 499101706
);

  • ERR_ADD_FEEDBACK_TO_AUKCJEWP
    Nie można wystawić komentarza do wskazanej oferty, ponieważ została ona przeniesiona z serwisu WP.
  • ERR_AUCTION_KILLED
    Nie można wystawić komentarza do wskazanej oferty, ponieważ została ona usunięta przez administratora serwisu.
  • ERR_BLOCKED_USER_CANT_INVOKE_METHOD
    Użytkownik z blokadą konta nie może korzystać z tej metody.
  • ERR_FEEDBACK_CANCELLED
    Jedna ze stron wystawiła już wcześniej komentarz do tej oferty i został on unieważniony za porozumieniem stron.
  • ERR_FEEDBACK_NOT_ALLOWED
    Nie można wystawić komentarza do wskazanej transakcji, gdyż złamała ona Regulamin. Skontaktuj się z Allegro przez formularz kontaktowy.
  • ERR_FEEDBACK_REMOVED
    Komentarz do tej oferty został już wcześniej wystawiony, ale administrator serwisu usunął go z jednego z możliwych powodów.
  • ERR_FEEDBACK_TOO_LONG
    Przekroczono maksymalny dopuszczalny rozmiar treści komentarza (ok. 250 znaków).
  • ERR_FEEDBACK_WORD_TOO_LONG
    Wykryto zbyt długie słowo w komentarzu. Sprawdź i popraw treść swojej opinii.
  • ERR_FORBIDDEN_CHAR_IN_FEEDBACK
    W treści komentarza użyto niedozwolonych znaków. Wszystkie użyte znaki muszą istnieć w alfabecie kraju zalogowanego użytkownika.
  • ERR_FORBIDDEN_WORDS_IN_FEEDBACK
    W treści komentarza użyto niedozwolonych słów (wulgaryzmy, adresy stron WWW).
  • ERR_INVALID_BUYER_OR_SELLER
    Niepoprawny identyfikator oferty lub identyfikator użytkownika, któremu ma zostać wystawiony komentarz.
  • ERR_MANY_FEEDBACKS
    Użytkownikowi we wskazanej ofercie został już wystawiony komentarz.
  • ERR_NEUTRAL_FEEDBACKS_ARE_DISABLED
    Przepraszamy, wystawienie komentarza neutralnego nie jest już możliwe.
  • ERR_NO_DATABASE
    Problemy z bazą danych Allegro.
  • ERR_NO_SESSION / ERR_SESSION_EXPIRED
    Niepoprawny identyfikator sesji lub sesja wygasła.
  • ERR_RATING_NOT_FOUND_OR_INCORRECT
    Brak, niekompletna lub niepoprawnie wypełniona ocena sprzedaży.
  • ERR_REASON_NOT_FOUND_OR_INCORRECT
    Nie podano identyfikatora powodu niezadowolenia z transakcji (w przypadku, gdy ocena obszaru sprzedaży jest mniejsza od 4) lub podany identyfikator jest nieprawidłowy.
  • ERR_SELECT_FB_TYPE_AND_WRITE_TEXT
    Nie wybrano typu lub nie podano treści komentarza.
  • ERR_SELLER_FEEDBACK_NOT_ALLOWED
    W jednej z transakcji byłeś sprzedającym, nie możesz wystawić komentarza.
  • ERR_TEMPLATE_INCORRECT_COMMENT_TYPE
    Użycie szablonu jest możliwe tylko dla komentarza pozytywnego.
  • ERR_TO_WHO_NOT_SELECTED
    Nie wybrano strony, której ma zostać wystawiony komentarz.
  • ERR_USER_IS_GUEST
    Wskazany użytkownik nie ma zarejestrowanego konta w serwisie.
  • ERR_USER_NOT_EXISTS
    Użytkownik o podanym identyfikatorze nie istnieje.
  • ERR_USERS_NOT_WON_THIS_AUCTION
    Wybrany użytkownik nie był kupującym we wskazanej ofercie.
  • 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.