Integrarea Foxpost¶

Foxpost este un transportator maghiar de colete, cunoscut mai ales pentru rețeaua sa națională de automate de colete (lockere). Modulul Delivery Foxpost (eyssen_delivery_foxpost) conectează Odoo la API-ul web Foxpost: adaugă un furnizor de expediere Foxpost cu un mod automat de colete (APM) și un mod livrare la domiciliu, înregistrează fiecare colet și descarcă eticheta sa PDF la validarea comenzii de livrare, păstrează starea coletului sincronizată cu Foxpost și livrează un furnizor de plată dedicat FoxPost COD, pentru plata ramburs (COD), plafonat la 150 000 HUF. În magazinul web, clienții își aleg automatul de colete pe harta oficială Foxpost, fără a părăsi procesul de finalizare a comenzii.

Pentru a configura integrarea, parcurgeți acești pași:

Obțineți datele de autentificare API Foxpost.
Configurați metoda (metodele) de expediere în Odoo.
Opțional, activați furnizorul de plată FoxPost COD.

Vezi și

Configurare cont¶

Conectorul comunică cu API-ul web Foxpost, care necesită trei date de autentificare emise de Foxpost în baza contractului de transport al companiei: un utilizator API, o parolă API și o cheie API. Foxpost operează un sistem separat de test și unul de producție, deci solicitați acces la ambele de la Foxpost: sistemul de test permite repetarea fluxului complet (înregistrarea coletelor, etichete, urmărire) fără a crea colete reale în rețeaua de producție.

Important

Datele de autentificare sunt specifice mediului: folosiți fiecare set numai pe mediul pentru care a fost emis. Mediul pe care îl apelează Odoo este stabilit pentru fiecare metodă de expediere prin butonul său Mediu (vezi mai jos) — verificați întotdeauna dacă datele de autentificare introduse pe metodă corespund mediului selectat.

Configurare metodă de livrare¶

Instalarea modulului creează două metode de expediere gata făcute: Foxpost Parcelmachine (modul automat de colete) și Foxpost Home delivery (modul livrare la domiciliu). Ambele se instalează nepublicate, cu preț zero și date de autentificare goale — sunt șabloane de completat, nu metode funcționale.

Pentru a le configura (sau pentru a crea altele suplimentare), accesați Aplicația Stoc ‣ Configurare ‣ Metode de livrare și deschideți metoda. Selectarea Foxpost în câmpul Furnizor afișează pe formular două file specifice Foxpost: Configurare Foxpost și Prețuri.

Pentru câmpurile comune tuturor transportatorilor terți, cum ar fi Livrare produs sau Țări, consultați documentația transportatorilor terți.

Notă

Pentru ca Odoo să înregistreze colete și să preia etichete, păstrați Nivel de integrare pe Obține preț și creează livrare. Cu Obține preț, metoda doar calculează prețurile la finalizarea comenzii și nu contactează niciodată Foxpost la momentul expedierii.

screenshot: setup-configuration-foxpost-configuration-tab

menu: Inventory ‣ Configuration ‣ Delivery Methods ‣ Foxpost Parcelmachine
shows: A Foxpost shipping method form with Provider set to "Foxpost" and the "Foxpost Configuration" tab open, showing the API User, API Password and API key fields and the delivery type selection.
highlight: The "Foxpost Configuration" tab (red frame).
data: Shipping method "Foxpost Parcelmachine"; use throw-away credentials.
module: eyssen_delivery_foxpost
notes: English UI, light theme, 1440px width.

Date de autentificare¶

În fila Configurare Foxpost, completați cele trei date de autentificare din configurarea contului:

Utilizator API și Parolă API: perechea de autentificare HTTP pentru API-ul web Foxpost.
Cheie API: cheia suplimentară pe care Foxpost o cere la fiecare apel API.

Aceste câmpuri — împreună cu câmpul Tip de livrare descris mai jos — sunt vizibile numai utilizatorilor din grupul Administration / Settings; ceilalți utilizatori văd formularul metodei de expediere fără ele.

Butonul inteligent Mediu din colțul din dreapta sus al formularului comută între Test Environment și Production Environment. În modul de test, fiecare apel merge către API-ul de test Foxpost; treceți metoda în producție după ce fluxul a fost verificat de la un capăt la altul.

Tipuri de livrare¶

Câmpul Tip de livrare din fila Configurare Foxpost selectează unul dintre cele două moduri de operare. O singură metodă de expediere funcționează întotdeauna în exact un mod; pentru a le oferi pe ambele, publicați două metode (ceea ce oferă cele două înregistrări preinstalate).

Mod	Automat de colete (APM)	Livrare la domiciliu
Destinație	Un automat de colete Foxpost ales de client.	Adresa de livrare a clientului.
Selectarea automatului de colete	Fereastră modală cu hartă la finalizarea comenzii pe site; butonul Selectați pe hartă în backend.	Nu se aplică.
Obligatoriu înainte de validarea livrării	ID-ul automatului de colete și un număr de telefon al destinatarului.	Adresa completă de livrare și un număr de telefon al destinatarului.
Metodă preinstalată	Foxpost Parcelmachine	Foxpost Home delivery

Câmpul Este web (Vizibil pe foxpost.hu sau Nu este vizibil pe foxpost.hu) are rolul de a controla dacă la înregistrarea coletului acesta este marcat ca vizibil pe foxpost.hu. În versiunea curentă, fiecare colet este înregistrat ca vizibil, indiferent de această setare, așa că păstrați valoarea implicită Vizibil pe foxpost.hu.

Notă

Numărul de telefon al destinatarului este obligatoriu pentru fiecare expediere Foxpost: se utilizează numărul de mobil, dacă este completat, altfel cel fix, iar validarea unei livrări pentru un contact fără niciun număr de telefon eșuează cu un mesaj de blocare. Foxpost îl folosește pentru a notifica clientul despre colet.

Stabilirea prețurilor¶

Fila Prețuri acceptă două strategii de stabilire a prețurilor:

Preț fix: atunci când nu este definită nicio regulă de preț, prețul de expediere este prețul de vânzare al produsului Livrare produs al metodei, stabilit prin lista de prețuri a comenzii. Câmpul Preț fixat modifică prețul de vânzare de bază al acelui produs, iar regulile listei de prețuri aplicate produsului de livrare îl înlocuiesc pentru fiecare listă de prețuri în parte.
Reguli pe intervale: adăugarea uneia sau mai multor reguli Reguli de preț comută metoda pe prețuri pe intervale în funcție de greutate, volum, greutate × volum, preț sau cantitate. Regulile sunt evaluate în ordinea secvenței, iar prima regulă care se potrivește este cea aplicată. Dacă nicio regulă nu se potrivește (de exemplu, coșul este mai greu decât cel mai mare interval de greutate), metoda rămâne vizibilă la finalizarea comenzii, dar este estompată și nu poate fi selectată — în locul prețului se afișează mesajul Not available for current order.

Prețurile definite în moneda companiei sunt convertite automat în moneda listei de prețuri a comenzii, iar opțiunea standard Gratuit dacă valoarea comenzii este mai mare funcționează suplimentar, peste oricare dintre cele două strategii.

Example

Două reguli — greutate ≤ 2 kg → 990 Ft și greutate ≤ 5 kg → 1 990 Ft — percep 990 Ft pentru un coș de 1,5 kg și 1 990 Ft pentru un coș de 4 kg. Un coș de 10 kg nu se încadrează în niciunul dintre intervale, deci metoda Foxpost este estompată și nu poate fi selectată pentru acel coș.

Ramburs (plata la livrare)¶

Modulul include un furnizor de plată numit Foxpost ramburs, cu cardul la automatul de colete sau la livrare, care permite clientului să plătească în numerar sau cu cardul la ridicarea coletului. Ca orice furnizor de plată, este instalat dezactivat: activați-l și publicați-l din Site web ‣ Configurare ‣ eCommerce: Furnizori de plată pentru a-l oferi la finalizarea comenzii.

Furnizorul apare la pasul de plată doar atunci când o metodă de expediere Foxpost publicată deservește site-ul, iar coșul conține bunuri fizice. Câmpul Sumă maximă este presetat la 150000 — conectorul nu acceptă colete cu ramburs de peste 150 000 HUF — astfel încât comenzile mai mari nu văd niciodată această opțiune. Aceeași limită este aplicată încă o dată la expediere: generarea unei etichete a cărei sumă de ramburs depășește plafonul este blocată cu mesajul „Maximum cash on delivery amount is 150.000,- HUF”.

După plasarea unei comenzi cu ramburs, clientul vede mesajul de confirmare „Your order has been confirmed. Please pay upon delivery.” în locul instrucțiunilor pentru transfer bancar. Acesta este doar text afișat clientului: plata rambursată în așteptare nu confirmă comanda de vânzare — confirmarea acesteia (și crearea livrării) rămâne un pas de back-office. Suma de încasat este calculată dinamic pentru fiecare livrare (transfer) de ieșire, la generarea etichetei de expediere — o singură sumă acoperă întreaga livrare, ținând cont de expedierile parțiale, liniile de servicii și plățile în avans.

Vezi și

Cum se calculează suma rambursului pentru fiecare livrare și verificarea antifraudă opțională a clienților cu ramburs: Plata ramburs (COD)
Cum sunt filtrate metodele de plată pentru fiecare metodă de expediere și cum arată experiența de finalizare și confirmare a comenzii cu ramburs: Metode de plată în funcție de livrare

Important

Ambele metode Foxpost preinstalate includ doar furnizorul FoxPost COD în lista albă Furnizori de plată activați. Prin urmare, în configurația implicită, un client care alege Foxpost poate plăti doar la livrare — atât timp cât nu este activat furnizorul COD al altui transportator, deoarece furnizorii COD sunt validați separat (vezi Metode de plată în funcție de livrare). Adăugați furnizorii de plată prin card și prin transfer bancar ai magazinului în fila Furnizori de plată a fiecărei metode Foxpost pentru a le oferi și pe acestea.

Finalizarea comenzii pe site: alegerea unui automat de colete¶

Când clientul selectează o metodă Foxpost cu automat de colete la pasul de livrare al finalizării comenzii pe site, se deschide o fereastră pe tot ecranul, intitulată Válasszon Foxpost csomagpontot, cu harta oficială Foxpost apt-finder — aceeași hartă cu căutare și listă pe care clienții o cunosc de pe foxpost.hu. Alegerea unui automat închide fereastra, salvează automatul pe comandă și afișează opțiunea sub metoda de livrare selectată, sub forma Választott csomagpont: urmată de numele automatului. Un clic pe metoda Foxpost redeschide harta, astfel încât clientul își poate schimba alegerea oricând înainte de plasarea comenzii.

Dacă metoda de expediere restricționează Țări, automatul ales este validat în raport cu această listă: un automat de colete situat într-o țară pe care metoda nu o deservește este refuzat.

Notă

Închiderea hărții fără a alege un automat nu blochează finalizarea comenzii — clientul poate plasa în continuare comanda. Lipsa automatului de colete este detectată mai târziu, când depozitul validează livrarea: validarea este refuzată cu mesajul „Please select a Foxpost parcel machine (APM ID) on the sales order or transfer before validating the delivery.”, iar personalul poate alege automatul pe comandă sau pe transfer în acel moment (vezi mai jos).

Notă

Textele ferestrei cu harta sunt afișate în prezent în limba maghiară, indiferent de limba site-ului.

Când transportatorul selectat este o metodă Foxpost cu automat de colete, atât formularul comenzii de vânzare, cât și cel al transferului afișează un câmp Automat de colete Foxpost cu un buton Selectați pe hartă. Butonul deschide dialogul Selectați automatul de colete Foxpost cu aceeași hartă Foxpost folosită la finalizarea comenzii; alternativ, ID-ul operatorului automatului (de ex. hu472) poate fi introdus direct. Comanda și toate transferurile ei folosesc un singur automat de colete — modificarea acestuia pe transfer actualizează comanda, iar el poate fi setat doar pe transferurile legate de o comandă de vânzare.

După ce a fost generată prima etichetă de expediere pentru comandă, câmpul și butonul devin doar pentru citire pe ambele formulare: modificarea automatului de destinație după ce coletul există în sistemul Foxpost necesită contactarea Foxpost.

Etichete de expediere¶

Când o livrare de ieșire cu o metodă de expediere Foxpost este validată, Odoo înregistrează coletul la Foxpost și descarcă imediat eticheta acestuia:

Identificatorul returnat al coletului este stocat pe transfer ca ID colet Foxpost și devine Referință urmărire al transferului.
Eticheta PDF este atașată transferului și postată în chatter-ul acestuia sub numele LabelFoxpost-<parcel id>.pdf, gata de tipărit.
Dacă Foxpost respinge coletul (ID de automat invalid, date incorecte etc.), validarea se oprește cu un mesaj de eroare clar și nu se înregistrează nimic.

Înregistrarea coletului la validare necesită ca Nivel de integrare al metodei să fie Obține preț și creează livrare și ca opțiunea Generează etichete de expediere să fie activată pentru tipul de operație (Stoc ‣ Configurare ‣ Tipuri operațiuni); ambele sunt valorile implicite pentru operațiunile de livrare.

Dacă descărcarea etichetei eșuează (de exemplu, o problemă de rețea după o înregistrare reușită), coletul rămâne înregistrat, iar eticheta poate fi descărcată din nou oricând cu butonul Obține eticheta Foxpost din antetul transferului. Butonul este disponibil ori de câte ori transferul are deja un ID de colet; etichetele sunt tipărite în format A6.

Notă

Fiecare transfer călătorește ca un singur colet Foxpost, cu o dimensiune fixă, medie — dimensiunile și greutățile pachetelor nu sunt transmise către Foxpost. Expediați un transfer Foxpost pentru fiecare colet fizic și asigurați-vă că produsele încap fizic într-un compartiment mediu al automatului.

Urmărire și stări¶

După ce un colet este înregistrat, transferul afișează starea sa Foxpost în timp real: Stare colet (o descriere ușor de înțeles) și Cod stare colet (codul de stare Foxpost). Data ultimului eveniment de stare este înregistrată, de asemenea, pe transfer, unde stă la baza urmăririi datei livrării, descrisă mai jos.

O acțiune planificată, Transfer: actualizează informațiile de urmărire Foxpost, interoghează API-ul de urmărire Foxpost la fiecare 3 ore pentru fiecare transfer al cărui colet nu a ajuns încă într-o stare finală (livrat, returnat sau expirat), astfel încât coletele deschise se actualizează fără nicio intervenție manuală. Intervalul poate fi modificat din Setări ‣ Tehnic ‣ Automatizare: Acțiuni planificate, iar butonul Actualizează starea Foxpost din antetul transferului reîmprospătează un singur colet la cerere.

Când Foxpost raportează că clientul a primit coletul — l-a ridicat de la automat sau a acceptat livrarea la domiciliu — data evenimentului este înregistrată pe transfer ca data efectivă a primirii de către client. Această dată alimentează starea livrării comenzii și raportarea datelor de livrare descrise în Starea și datele livrării.

Configurare¶

Listă de verificare pentru o configurare Foxpost funcțională:

Instalați modulul Delivery Foxpost (eyssen_delivery_foxpost); straturile comune de livrare, plată și stare a livrării se instalează automat ca dependențe.
Obțineți de la Foxpost datele de autentificare API pentru test și producție.
În Stoc ‣ Configurare ‣ Metode de livrare, deschideți Foxpost Parcelmachine și/sau Foxpost Home delivery (sau creați metode noi cu Furnizor setat la Foxpost), apoi:
- introduceți Utilizator API, Parolă API și Cheie API;
- verificați Tip de livrare și, dacă este necesar, restricția Țări;
- configurați fila Prețuri (preț fix sau reguli pe intervale);
- testați în Test Environment, apoi comutați la Production Environment cu datele de autentificare de producție;
- publicați metoda pentru ca aceasta să apară pe site.
Pentru a oferi ramburs, activați și publicați furnizorul de plată Foxpost ramburs, cu cardul la automatul de colete sau la livrare din Site web ‣ Configurare ‣ eCommerce: Furnizori de plată.
Adăugați ceilalți furnizori de plată ai magazinului (card, transfer bancar) în fila Furnizori de plată a fiecărei metode Foxpost, astfel încât rambursul să nu fie singura opțiune (vezi Metode de plată în funcție de livrare).
Verificați că tipul de operație de ieșire are activată opțiunea Generează etichete de expediere.

Utilizare¶

Clientul finalizează comanda pe site și selectează o metodă Foxpost. Pentru o metodă cu automat de colete, se deschide harta Foxpost și clientul își alege automatul; pentru livrarea la domiciliu, coletul ajunge la adresa de livrare a clientului.
La pasul de plată, clientul plătește online sau — pentru comenzi de până la 150 000 HUF — alege FoxPost COD și plătește la ridicare.
Comanda de vânzare este confirmată — automat în cazul plăților online; pentru comenzile cu ramburs, confirmarea rămâne un pas de back-office — iar depozitul procesează livrarea. Dacă clientul a omis selectarea automatului, personalul alege unul cu Selectați pe hartă (sau introduce ID-ul) pe comandă sau pe transfer.
Validarea transferului înregistrează coletul la Foxpost, stochează ID colet Foxpost și atașează în chatter eticheta imprimabilă. Pentru comenzile cu ramburs, suma de încasat pentru această livrare specifică este calculată și transmisă odată cu coletul (vezi Plata ramburs (COD)).
Cron-ul de urmărire menține la zi Stare colet. Când clientul primește coletul, data primirii este înregistrată, iar starea livrării comenzii se actualizează în consecință (vezi Starea și datele livrării).

Domeniu de aplicare și module¶

eyssen_delivery_foxpost — conectorul de transportator Foxpost: furnizorul de expediere Foxpost cu modurile automat de colete (APM) și livrare la domiciliu, selectorul de automat de colete bazat pe hartă (la finalizarea comenzii și în backend), prețurile fixe/pe intervale, înregistrarea coletelor și etichetele PDF, sincronizarea urmăririi și înregistrarea furnizorului de plată FoxPost COD.

Conectorul se bazează pe module eYssen comune, documentate în paginile proprii: filtrarea plăților pentru fiecare transportator și experiența de finalizare a comenzii cu ramburs (Metode de plată în funcție de livrare), suma dinamică a rambursului pentru fiecare livrare (Plata ramburs (COD)) și urmărirea datei livrării (Starea și datele livrării).