allegro-api icon indicating copy to clipboard operation
allegro-api copied to clipboard

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

Open urszulade opened this issue 3 years ago • 4 comments

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)"

urszulade avatar Oct 07 '22 07:10 urszulade

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".

Lukasz-Zurek avatar Oct 07 '22 07:10 Lukasz-Zurek

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.

urszulade avatar Oct 07 '22 08:10 urszulade

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

  • Allegro One Punkt,
  • Allegro One Box,

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.

Lukasz-Zurek avatar Oct 07 '22 10:10 Lukasz-Zurek

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.

stale[bot] avatar Oct 14 '22 19:10 stale[bot]