Prin proiectul “Soft1 Courier”, Softone isi propune sa puna la dispozitia utilizatorilor sai posibilitatea de generare si printare de AWB-uri pentru documentele de vanzare, facand o conexiune API la urmatorii curieri: DPD, Sameday, Fan Courier, Cargus, GLS.
Instalare
Instalarea consolei “Soft1 Courier” in meniul personal sau in meniul de grup se realizeaza prin adaugarea in “Proprietati” a urmatorilor parametri:
Tip operatie : Dll Form
Obiect/Fisier: .S1ROCourier.dll;frmCourier
Sunt 3 fisiere care vor fi adaugate fizic in folderul aplicatiei Soft1, iar acestea pot fi descarcate de pe pagina dedicata modulelor Soft1 https://productnews.softone.ro/ , din sectiunea Soft1Courier .
Configurare consola
Anterior oricaror mapari, conditia principala ca un document de vanzare sa ajunga in consola Soft1 Courier, este ca in Date livrare sa fie mentionat un transportator setat ca si curier . Setarile necesare pentru afisarea documentelor in consola, implica actualizari in tabela SOCOURIER, ale campurilor: Este curier(ISCOURIER), ApiKey(SOAPIKEY), Utilizator(SOUSRNAME), Parola(SOPASSWORD), Info(SOOTHERID). In cel de-al doilea tabel sunt prezentate campurile obligatorii cerute de fiecare curier.
Actualizarile pot fi facute atat din consola Soft1 Courier (butonul Setari) cat si din Soft1 (Parametri ->Companii -> Zone geografice – Transport ->Curieri
Parametri Consola
|
Este curier |
Bifat, campul seteaza transportatorul din baza de date ca si curier |
|
ApiKey |
API key a curierului |
|
Utilizator |
User-ul pentru conectarea pe platforma curierului |
|
Parola |
Parola pentru conectarea pe platforma curierului |
|
Info |
ID locatie depozit |
Parametri Soft1
|
Tip |
Soft1 Courrier = value 1 |
|
Cod API |
API key a curierului |
|
User Name |
User-ul pentru conectarea pe platforma curierului |
|
Password |
Parola pentru conectarea pe platforma curierului |
|
Cod alternativ |
ID locatie depozit |
|
Curier |
API |
Username |
Parola |
Info (Cod alternativ) |
|
DPD |
|
x |
x |
x |
|
Sameday |
|
x |
x |
x |
|
Fan Courier |
|
x |
x |
x |
|
Cargus |
x |
x |
x |
|
|
GLS |
x (daca suntem in mediul de testare mereu va fi [test]) |
x |
x |
x |
Pentru ca datele sa fie preluate pentru curierul corect, este necesara pastrarea abrevierilor mai jos prezentate la momentul crearii in Soft1 a transportatorului.
|
Abreviere |
Nume curier |
|
dpd |
DPD |
|
sd |
Sameday |
|
fc |
Fan Courier |
|
cargus |
Cargus |
|
gls |
GLS |
! Curierii vor fi creati si setati la nivel de depozit, iar in cazul in care aceeasi firma de curierat va deservi mai multe depozite, abrevierile vor fi descrise astfel :
dpd1, dpd2, dpd3…
sd1, sd2, sd3…
fc1, fc2, fc3…
cargus1, cargus2, cargus 3…
gls1, gls2, gls3 …
Campurile obligatorii pentru transmiterea corecta a unui document in consola si generarea unui AWB pentru transport sunt:
! Judet / Oras/ Cod Postal / Nr. Colete/ Nr. Plicuri / Ramburs pot fi modificate si in consola Soft1 Courier.
ex: Denumirea orasului, a judetului poate fi diferita de la o companie de curierat la alta.
In cazul rambursului, acesta poate avea o valoare diferita decat cea a facturii, precum in cazul unor plati partiale prin alte metode de plata.
! Campul Ramburs nu este un camp salvat in baza de date, este un camp ajutator la printarea AWB-ului pentru a reflecta realitatea in cazul incasarilor de acest tip.
! Campul Ramburs are o limita de 1000 RON pentru FanCourier si 7000 RON pentru GLS.
|
|
|
Soft1 Courier |
|
|
Cargus |
Judet |
permite informatii dupa modelul din baza lor de date (*pt Bucuresti = Bucuresti) |
Camp optional |
|
Oras |
permite informatii dupa modelul din baza lor de date (*pt Bucuresti = Bucuresti) |
Camp obligatoriu |
|
|
Fan Courier |
Judet |
permite informatii dupa modelul din baza lor de date (*pt Bucuresti = Bucuresti) |
Camp optional |
|
Oras |
permite informatii dupa modelul din baza lor de date (*pt Bucuresti = Bucuresti) |
Camp obligatoriu |
|
|
DPD |
Judet |
permite informatii dupa modelul din baza lor de date (*pt Bucuresti = Bucuresti) |
Camp optional |
|
Oras |
permite informatii dupa modelul din baza lor de date (*pt Bucuresti = Bucuresti) |
Camp obligatoriu |
|
|
Sameday |
Judet |
permite informatii dupa modelul din baza lor de date (*pt Bucuresti = Bucuresti) |
Camp obligatoriu |
|
Oras |
permite orice informatie (* daca este selectat Judetul din BD a curierului, atunci in Oras va fi alocat sectorul – acesta poate fi modificat) |
Camp obligatoriu |
|
|
GLS |
Judet |
permite orice informatie |
Camp optional |
|
Oras |
permite orice informatie |
Camp obligatoriu |
|
|
|
Soft1 Courier |
S1 |
||||
|
Cargus |
Bistrita-Nasaud |
Caras-Severin |
Satu Mare |
Bistrita Nasaud |
Caras Severin |
SatuMare |
|
Fan Courier |
Bistrita-Nasaud |
Caras-Severin |
Satu Mare |
|||
|
DPD |
Bistrita-Nasaud |
Caras-Severin |
Satu Mare |
|||
|
Sameday |
Bistrita-Nasaud |
Caras-Severin |
Satu Mare |
|||
Operare consola
Consola Soft1 Courier, este impartita in 4 sectiuni si anume:
Sectiune de filtre : in care putem selecta perioada din care sa aducem documentele de vanzare valide, putem filtra in functie de curieri, depozite sau statusul AWB-urilor.De asemenea se pot face cautari in functie de nr de document sau AWB.
Butonul 
va actualiza lista de documente in urma oricaror modificari.
Sectiune de listare documente: in functie de filtrele propuse mai sus, vor fi listate documentele care indeplinesc criteriile.
!!! Modalitatea de plata va avea implicatii asupra valorii din coloana [Ramburs]; pentru metodele de plata [Ramburs] si [Numerar], vom avea o valoarea de plata echivalenta cu valoarea totala a facturii; pentru orice alta modalitate de plata, valoarea de ramburs va fi 0. Valoarea de ramburs poate fi de asemenea modificata in consola din sectiunea de generare AWB, in cazul in care valoarea de ramburs este diferita de valoarea documentului (precum in cazul platilor partiale prin alte metode de plata).
Sectiune de generare AWB : aici putem face modificari ale nr de colete, plicuri, valoarea ramburs, adresa, daca cele aduse din document nu sunt corecte.
Butonul 
va face initial verificarile necesare iar daca criteriile de la punctele “Setari” si “Campuri obligatorii in Soft1” sunt indeplinite, consola se va conecta pe platforma curierului cu credentialele setate si va genera un AWB. In caz contrar va returna o eroare.
Sectiune de AWB : Mentioneaza AWB generat in functie de documentul pe care suntem pozitionati si permite prelucrarea acestui AWB ( descarcare, printare, stergere, informatii suplimentare)
Campurile editabile din consola sunt campurile din sectiunea de generare AWB. Acestea sunt propuse automat din tranzactie, dar pot fi modificate. In urma generarii AWB, datele modificate vor fi actualizate si in documentul de vanzare.
!!! La GLS in momentul in care avem mai multe colete sau plicuri, curierul va genera cate un numar de AWB pentru fiecare in parte. In cazul in care dorim sa stergem oricare din AWB, toate vor fi sterse intrucat nu poate fi identificat pentru care colet sau plic a fost cancelat numarul de AWB, si astfel va fi necesara regenerarea pentru toate pachetele. De asemenea la momentul in care dorim descarcarea fisierului PDF care contine AWB, se va deschide un folder in care sunt salvate automat toate AWB generate de GLS intrucat acesta este modul in care curierul transmite documentul (la generare si nu la cerere).
Durata estimata de implementare
Durata de implementare este estimata la 80 minute, dar pasul procesarii/ generarii AWB poate intampina anumite dificultati sau intarzieri datorita unor puncte mentionate mai jos:
| De la data | Perioada de inceput pentru selectarea tranzactiilor (este luata in considerare data documentului) |
| Pana la data | Perioada de sfarsit pentru selectarea tranzactiilor (este luata in considerare data documentului) |
| Curier | Pot fi selectati toti curierii fie doar unul dintre ei ( DPD, Fan Curier, Sameday, Cargus) |
| Depozit | Pot fi selectate toate depozitele companiei sau doar un anumit depozit |
| lipsa AWB | Criteriu de afisare a tranzactiilor : fara AWB generat |
| AWB generat | Criteriu de afisare a tranzactiilor : cu AWB generat |
| cu eroare | Criteriu de afisare a tranzactiilor : fara AWB generat si cu eroare la incercarea generarii AWB-ului |
| AWB neprintat | Criteriu de afisare a tranzactiilor : AWB generat dar neprintat |
|
Document |
Criteriu de cautare dupa numarul de document |
| AWB | Criteriu de cautare dupa numarul de AWB generat |
| Nr. Colete | Nr. de colete de transmis per tranzactie de vanzare |
| Nr. Plicuri | Nr. de plicuri de transmis per tranzactie de vanzare |
| Greutate | Greutatea coletelor/plicurilor per tranzactie de vanzare |
| Judet | Judetul catre care se face transportul ( poate fi modificat din butonul ) |
| Oras | Orasul catre care se face transportul( poate fi modificat din butonul ) |
| Cod postal | Codul postal al locatiei catre care se face transportul( poate fi modificat din butonul ) |
FAQ
|
|
Trebuie adaugat nr de tel in depozitul companiei |
|
|
Nu sunt inserate credentialele de conectare pe platforma curierului (user, parola, API key sau pick up point descris de campul [Info]) |
|
|
Orasul din sectiunea “Generare AWB” este lipsa |
|
|
Codul postal este “NULL” sau codul postal nu este specificat dar cerut obligatoriu de curier |
|
|
Nr. Telefon lipseste din fisa clientului. |
|
|
Adresa destinatar(client) lipsa |
|
|
Orasul este lipsa din tab [Date livrare] |
|
|
Codul postal al depozitului de unde se ridica marfa nu este corect. (Eroare GLS) |
|
|
Cod postal lipsa al destinatarului. (Eroare GLS) |
|
|
Oras lipsa al destinatarului. (Eroare GLS) |
