40. BoxNow

BoxNow este un serviciu de curierat pentru livrare la oficii poștale automate (APM) și dulapuri. În integrarea TrimiteInBoxNowconectează sistemul la BoxNow Partner API prin OAuth2 și permite:

• creați și urmăriți expedierile;
• generarea etichetelor (PDF/ZPL);
• punct de livrareri de taxare/puncte de primire (puncte de service);
• calcularea prețului pe intervale de greutate;
• actualizare automată a punctelor (cron: în fiecare zi la 21:00).

Cerințe preliminare #

1. Contract BoxNow și acces la portalul partenerului.
2. Acreditări OAuth2 de la BoxNow:
   • Client ID
   • Client Secret
     Acestea sunt diferite de numele de utilizator/parola portalului web.

Pasul 1: Creați integrarea BoxNow #

Accesați Couriers → Configurare și selectați BoxNow. Setările sunt în două grupuri: Autentificare și Opțiuni generale.

Pasul 2: Autentificare #

Fără acreditări valide, solicitările API vor returna erori de autentificare (coduri X403 etc.).

Pentru testare puteți folosi serverul de scenă; pentru expedieri reale — producție.

Pasul 3: Opțiuni generale #

API URL #

Dacă câmpul este gol, sistemul utilizează producția.

Locație de origine implicită #

Selectabil dintr-un meniu derulant (încărcat din API-ul BoxNow:apps/boxnow/origins).

• Acesta este depozitul/locația expeditorului din care provin transporturile.
• Implicit poate fi „Orice APM” (any-apm), dacă nu selectați o anumită locație.
• Pentru o funcționare stabilă, se recomandă alegerea unui anumit depozit contractat cu BoxNow.

Restricționați returnările #

• Dezactivat (implicit) — Sunt permise derulări.
• Activat – Retururile sunt interzise pentru expedierile din această integrare.

Dimensiunea implicită a compartimentului #

Se folosește atunci când lipsesc dimensiunile locului (locului) din expediție:

Intervalele de prețuri #

Matrice JSON cu prețuri în funcție de greutate în grame:

[ {"from": 0, "to": 3000, "price": 3}, {"from": 3001, "to": 6000, "price": 6}, {"from": 6001, "to": 10000, "price": 8}, {"from": 10001, "to": 20000, "price": 10} ]

• from– greutate minimă (incl.)
• to— greutate maximă (incl.); dacă lipsește — fără limită superioară
• price— prețul pentru gamă (ar putea fi0pentru transport gratuit)

Dacă nu configurați intervale, sunt utilizate valorile implicite încorporate (3 / 6 / 8 / 10 pentru greutățile corespunzătoare de până la 20 kg).

Pasul 5: Tarife și puncte de ridicare #

Tarifar #

Integrarea percepe un tarif:

• Nume: Rata implicită Boxnow
• Tip: autoservire/punct service (TYPE_SELF_SERVICE_POINT)
• ID extern:88

Puncte de preluare (APM/Culatare) #

• Punctele sunt sincronizate de API-ul BoxNow.
• Automat: în fiecare zi la ora 21:00 (cronupdate-service-points).
• Dacă este necesar, începeți încărcarea manuală de la administrația serviciului de curierat (dacă este disponibilă în instalația dvs.).

Când plasează o comandă, clientul trebuie să aleagă un punct de service BoxNow – fără acesta, expedierea nu poate fi exportată.

Pasul 6: Cerințe la crearea unei expedieri #

Când exportați în BoxNow, cererea trebuie să aibă:

Restricții #

• Greutate maximă: 20.000 g (20 kg)
• Volumul maxim: 600×600×600 mm (216.000.000 mm³)
• Dacă este depășit, calculatorul/exportul returnează un mesaj de eroare.

Ramburs la livrare si plata #

• Comandă plătită → Mod preplătit (fără NP).
• Comandă neplătită → Mod COD (ramburs la livrare).

Suma de încasare include valoarea comenzii și, dacă este necesar, costul livrării (conform setărilor expeditorului/serviciului).

Pasul 7: Etichete și urmărire #

După exportul cu succes:

1. BoxNow returnează un ID de expediere și un număr de urmărire.
2. Din OrderAdmin, puteți imprima o etichetă (PDF sau ZPL) folosind serviciul de etichetă al integrării.
3. Stările sunt actualizate în funcție de API și de sarcinile de urmărire configurate.

La reîncercare, dacă expedierea a fost deja creată în BoxNow, dar nu există nicio urmărire în TrimiteIn, sistemul poate restaura datele din fișierul salvat. exportResult nicio solicitare API nouă.

Pasul 8: Testarea înainte de producție #

1. Setați adresa URL API = Etapă.
2. Introduceți ID-ul clientului de testare/Secretul din BoxNow.
3. Creați un transport de testare cu o greutate mică și un punct de testare valid.
4. Verificați: calcul → export → etichetă → urmărire.
5. Schimbați la acreditările de producție și producție înainte de comenzile reale.

Probleme comune #