Zamówienia Allegro REST API - rozbudowaliśmy sekcję buyer o dodatkowe informacje

[PawelTaberski]

Od dziś w odpowiedzi dla poniższych zasobów:

• GET /order/checkout-forms/{checkoutForm_id}
• GET /order/checkout-forms

otrzymasz dodatkowe informacje w sekcji buyer. Dane uzyskasz dla zamówień w statusie BOUGHT, FILLED_IN i READY_FOR_PROCESSING.

Poniżej przykład rozbudowanej sekcji buyer:

    “buyer”: {
        “id”: “1424041”,                    – identyfikator kupującego
        “email”: “ymu1woaqq+54111a037@user-dev.allegrogroup.pl”,
                                            – adres e-mail kupującego
        “login”: “example_login”,           – login kupującego
        “firstName”: “Tomasz”,              – imię
        “lastName”: “Nowak”,                – nazwisko
        “companyName”: null,                – nazwa firmy
        “guest”: false,                     – czy kupujący jest zarejestrowanym użytkownikiem
        “personalIdentity”: null,           – numer PESEL
        “phoneNumber”: “+381 11 1111111”,   – numer telefonu z ustawień konta kupującego
        “address”: {                        – dane adresowe z ustawień konta
            “street”: “Bułgarska 6990”,     – ulica
            “city”: “Poznań”,               – miasto
            “postCode”: “18-282”,            – kod pocztowy
            “countryCode”: “PL”,            – kod kraju
        }

Ważne! Dodatkowe informacje w sekcji buyer będziemy zwracali dla zamówień utworzonych po 1.08.2019.

Więcej informacji znajdziesz w naszym poradniku - jak obsługiwać zamówienia.

[jakubmaguza]

Kochane Allegro, Czy dalej uważacie, że nie ma sensu podawać danych do wysyłki, jeśli klient nie opłacił zamówienia? Z informacji które zebrałem, dla nieopłaconych zamówień:

• Podajecie dane do wysyłki na stronie
• Podajecie dane do wysyłki w managerze zamówień
• Teraz w API podajecie adres na jaki zarejestrował się kupujący

Nie podajecie jednak danych do wysyłki dla nieopłaconych zamówień w REST API. Zapytam więc ponownie, jaki jest tego powód?

[mroocoo]

Moglibyście się zdecydować na spójne nazewnictwo pól - kod pocztowy tutaj to "postCode" a w CheckoutFormDeliveryAddress "zipCode"

[lukasnet]

Takie kluczowe dane, jak imię i nazwisko, nr tel powinny być również zwracane w zdarzeniach, nie trzeba by było pobierać tych danych z zamówienia.

[PawelTaberski]

@jakubmaguza Adres wysyłki nie musi być identyczny z tym podanym w ustawieniach konta, dlatego jest zwracany po API dopiero, gdy przesyłka jest opłacona (lub kupujący wybrał płatność przy odbiorze). Ponadto kupujący może go zmienić do momenty, aż płatność będzie uznana za zakończoną. @mroocoo Tak, zamierzamy to uspójnić, aby wszędzie było "postCode". @lukasnet Obecnie nie planujemy zwracania takich danych w dzienniku, służy on jedynie do monitorowania akcji, które wykonał klient.

[jakubmaguza]

@PawelTaberski Już parę razy o tym rozmawialiśmy. Zdarzają się kupujący, którzy wybiorą płatność przed wysyłką, po czym zadzwonią i powiedzą że jednak chcą płatność za pobraniem. Tak, wiem że w idealnym świecie taka sytuacja nie ma miejsca, a kupujący ponowi proces rozliczania. Niestety w realnym świecie tak nie jest. Raz na jakiś czas zdarzy coś takiego się zdarzy. Druga opcja to klient który wybierze zwykły przelew. Zanim płatność do nas trafi, chcielibyśmy przygotować mu przesyłkę. Czasem taki klient wyśle potwierdzenie przelewu.

W takiej sytuacji operatorzy muszą wejść na Allegro i ręcznie przepisać adres i np. dane do faktury. Pominę fakt, że pojawiają się pytania, że skoro te dane są na froncie, to dlaczego nie można ich pobrać. Operatorzy nie rozumieją pojęcia RESTApi. Dla nich allegro to allegro.

Skoro te dane fizycznie istnieją i nie jesteście w stanie zabronić ich użycia, to czemu nie chcecie podać ich w REST Api? Wystarczy że napiszecie, że te dane mogą się zmieniać i to już nie będzie wasz problem.

[PawelTaberski]

@jakubmaguza Rozumiem oczywiście przekażę tą sugestię.

[lukada4100]

@jakubmaguza Co się będziesz prosił: o ile się nie mylę, po wypełnieniu przez klienta formularza pozakupowego automatycznie generowany jest email ze szczegółami zamówienia. Ustaw sobie przekierowanie tych maili na konto robocze a potem zrób automat który będzie ci je parsował i zaciągał dane które potrzebujesz. Operatorzy będą happy.

[copyact]

Jak w takim razie przez API przetworzyć zamówienie, gdy płatność automatyczna nie powiodła się i klient zrobił tradycyjny przelew?

[imper86]

@PawelTaberski zacząłem korzystać z nowych zasobów do pobierania zamówień i podpisuję się pod tym, co pisali przedmówcy.

Najgorsze w tym wszystkim jest to, że takich klientów którzy nie kończą płatności jest dużo. Jest też dużo przypadków, gdzie klient ma w danych allegro nieaktualny email i nieaktualny nr telefonu, przez co nie ma możliwości skontaktowania się z takimi jednostkami.

Dane z wypełnionego formularza pozakupowego sytuację naprawiają, ponieważ numer telefonu tam podawany w zdecydowanej większości przypadków jest aktualny, dzięki czemu sprzedający ma możliwość cokolwiek z kupującym ustalić.

Rozumiem, że wycięliście te dane ze względu na przypadki, gdy klient podał nowy adres doręczenia, a sprzedający wysyła na inny, podany we wcześniejszym formularzu, ale prawda jest taka, że do tej pory przez wiele lat sobie z tym radziliśmy, a na ten moment wady tego rozwiązania przeważają zalety.

[PawelTaberski]

@imper86 Rozumiem, Twoją sugestię również przekazałem, jeśli otrzymamy informację o wprowadzeniu jakiejś zmiany w tym procesie to poinformujemy o tym.