allegro / allegro-api

Issue tracker and wiki for Allegro REST API
https://developer.allegro.pl/
213 stars 39 forks source link

Etykieta do paczki - pole referencenumber w wywołaniu api dla operation/createNewParcel #6198

Closed urszulade closed 1 year ago

urszulade commented 1 year ago

Mam problem podobny co w wątku: https://github.com/allegro/allegro-api/issues/5577

Potrzebuję na etykiecie wyświetlić własny wewnętrzny numer. Wg dokumentacji API wydaje się że do tego właśnie zostało stworzone pole referenceNumber:

image

Jednak na generowanych etykietach w polu "Refernce No. 1" znajduje się numer przesyłki Allegro: image

Czy da się w tym miejscu umieścić własny numer, własny tekst?

We wspomnianym wątku była mowa ograniczeniach co do długości tego tekstu - podczas testów napotkaliśmy błąd gdy jako label.referenceNumber były przekazane nieodpowiednie znaki (w błędzie była mowa o konieczności spełnienia wyrażenia regularnego [A-za-z0-9 _-]*, ale potem po spełnieniu tych warunków błąd już co prawda nie wystąpił, ale na etykiecie nasz własny tekst i tak się nie pojawił.

Czy coś się od tego czasu zmieniło? I czy jest jakaś możliwość umieszczenia swojego własnego tekstu w polu "Refernce No. 1"?

Użyty kurier to było "Allegro One (UPS)"

Lukasz-Zurek commented 1 year ago

W przypadku etykiet Allegro One (UPS), pole, w którym mogłabyś coś wstawić - jak widać na zrzucie - jest już przez nas zajęte (pojawia się tam numer paczki ALE). Na tych etykietach nic więcej już się nie zmieścisz/nie przekażesz.

Natomiast dla etykiet Allegro One (One Kurier) możesz taki dodatkowy tekst przekazać w polu "items.description".

urszulade commented 1 year ago

To jeszcze dopytam o jedną rzecz, czy na pewno dobrze rozumiem...

Chodzi o to mapowanie nazw kurierów (https://developer.allegro.pl/tutorials/jak-zarzadzac-przesylkami-przez-wysylam-z-allegro-LRVjK7K21sY#jak-utworzyc-nowa-paczke) - przyznam, że ono jest trochę niejasne.

Gdy pobieram szczegóły przesyłki (order/checkout-forms), to dostaję w delivery -> method -> name -> dostaję tu jakąś nazwę stringową (np. "Allegro One Box"). Zasadniczo porównuję to z wynikiem parcel-management/delivery-services -> name Ale te stringi nie są 1:1 równe. Czasem są, a czasem nie, zwłaszcza przy tych nazwach z nawiasami ("Allegro One Box, One Kurier" vs "Allegro One Box (One Kurier)"). I przy tworzeniu createNewParcel używam odpowiednio zmapowane id.

I czy dobrze rozumiem, że do mapowania tych nazw należy się posiłkować tabelką (https://developer.allegro.pl/tutorials/jak-zarzadzac-przesylkami-przez-wysylam-z-allegro-LRVjK7K21sY#jak-utworzyc-nowa-paczke):

Dlatego dla "Allegro One Punkt" i "Allegro One Box" używam kuriera "Allegro One (UPS)" - bo tak wynika z tej tabelki? I to jedyne, co mogę wybrać, prawda? Rozumiem, że innych użyć nie mogę? Wszystkich opcji nie sprawdzałam, ale kilka razy przypisując innego kuriera (niezgodnego z tabelką) dostawałam błąd, że musi być kurier wybrany w transakcji (co jest w sumie logiczne).

I teraz do celu: Nie używam "Allegro One (One Kurier)" - bo dla "Allegro One Punkt" i "Allegro One Box" nie mogę go użyć, prawda?

"Allegro One (One Kurier)" wymaga, aby nadanie robić z odpowiedniego miasta. Zasadniczo rozumiem, że cokolwiek zahacza o One Kurier, to musi być nadane z odpowiedniego miasta. U nas nadanie jest z innego miejsca, wiec chyba nie ma wyjścia i One Kurier użyć nie możemy, pozostaje wyłącznie: Allegro One (Punkt, Box) - realizowany przez UPS z dostawą jutro

A zatem jeśli chodzi o etykietę to pozostaje wyłącznie kurier "Allegro One (UPS)" dla którego własnego tekstu na etykiecie nie włożę. Będę wdzięczna za potwierdzenie, że powyższe rozumowanie jest ok.

Lukasz-Zurek commented 1 year ago

Tak, w przypadku metod dostawy wybieranych przez Kupującego:

musisz skorzystać z usługi Allegro One (UPS), zgodnie z przytoczoną tabelką.

W tabelce masz kolumnę "Metoda dostawy wybrana przez kupującego", dla której wskazujemy "Dozwoloną umowę Allegro (usługa dostawy)" (trzecia kolumna), którą po nazwie zidentyfikujesz (tj. uzyskasz wartość "service.id") za pomocą GET /parcel-management/delivery-services.

Do mapowania możesz śmiało wspomagać się naszą tabelą. Dodam tylko, że 26 października wprowadzimy zmianę, która ma na celu ułatwić mapowanie metod dostawy i tworzenie przesyłek. Tabelę również wtedy zaktualizujemy.

stale[bot] commented 1 year ago

W tym wątku nie pojawiła się żadna nowa odpowiedź w ciągu 7 dni, dlatego automatycznie oznaczamy go jako przeterminowany. Jeśli w ciągu kolejnych 7 dni nie pojawi się żadna odpowiedź, wątek zostanie zamknięty. Dziękujemy za zaangażowanie w dyskusję i zachęcamy Cię do wypełnienia ankiety dotyczącej naszego wsparcia na forum.


There was no new reply in this thread within 7 days, therefore, we automatically marked it as expired. If no response is received within the next 7 days, this thread will be closed. Thank you for engaging in the discussion. We encourage you to complete our forum support survey.