v-Track Client -> API Web Service

Τεκμηρίωση endpoint για την χρήση v-Track Client Web Service .

Χρήση API Web Service

Η χρήση του API μπορεί να γίνει από οποιοδήποτε λογισμικό εσωτερικού η εξωτερικού δικτύου (υπό προϋποθέσεις)

Ενεργοποίηση Service

Για να ενεργοποιήσετε τα Web Service στο v-Track Client θα πρέπει να εισάγετε το αρχείο C:\NETWERK\v-track\V-Track Web Server.xml στον Task Scheduler των Windows και να εκκινήσετε την υπηρεσία

Εντολή δημιουργίας Voucher

http://127.0.0.1:2012/webservice.php?ACTION=CREATE&MODULE=ACS&ID=2893

Με την συγκεκριμένη κλήση δημιουργείτε ο αριθμός αποστολής με ACS για τo παραστατικό με συγκεκριμένο ID

Response
{"Success":1,"Voucher":"NP220404132GR"}


Για τις αντιστοιχίες MODULE δείτε τον παρακάτω πίνακα
To ID είναι το παραστατικό που έχει δηλωθεί στο Configuration του v-Track Client

Εντολή εκτύπωσης

http://127.0.0.1:2012/webservice.php?ACTION=PRINT&ID=43587

Με την συγκεκριμένη κλήση δίνουμε εντολή εκτύπωσης για το voucher που δημιουργήθηκε στο παραστατικό με συγκεκριμένο ID

Response
{"Success":1"}

Εντολή Διαγραφής

http://127.0.0.1:2012/webservice.php?ACTION=DELETE&ID=43587

Με την συγκεκριμένη κλήση διαγράφουμε έναν αριθμό αποστολής για το παραστατικό με συγκεκριμένο ID

Response
{"Success":1"}

Εκτύπωση παραγγελίας Skroutz

http://127.0.0.1:2012/webservice.php?ACTION=SKRMPRINT&SKRC=230618-5761403

Με τη συγκεκριμένη εντολή μπορούμε να δώσουμε εντολή εκτύπωσης για συγκεκριμένο αριθμό παραγγελίας Skroutz

Response
{"Success":1"}

Προβολή Λίστας εκτυπωτών

http://127.0.0.1:2012/webservice.php?ACTION=PRINTER_LIST

Με τη συγκεκριμένη εντολή βλέπουμε τους διαθέσιμους εκτυπωτές κάτω απο τον χρήστη SYSTEM

Response
{
	"1":"Send To OneNote 2016",
	"2":"OKI MC332(PCL)",
	"3":"Microsoft XPS Document Writer",
	"4":"Godex GE300"
}

Προβολή πλήρους ιστορικού αποστολής μέσω Token Service

http://127.0.0.1:2012/webservice.php?ACTION=OPENDETAILS&VOUCHER=1507137096&REDIRECT=0

Με τη συγκεκριμένη εντολή μπορούμε να δούμε το ιστορικό μιας αποστολής απευθείας μέσα από το dashboard

Εάν η REDIRECT είναι 1 τότε θα μας κάνει αναδρομολόγηση στην σελίδα αποτελεσμάτων του dashboard. Εάν είναι 0 θα μας επιστρέψει το url με το Token το οποίο θα είναι διαθέσιμο για 60 λεπτά

Response
{
	"Url":"https:\\dashboard.v-track.gr\index.php?SCREEN=customer\search_voucher&ssSearchFiler=voucher&voucher=1507137096&set_token=xxxxxxxxxxx"	
}

Υπολογισμός εξόδων αποστολής (Για Softone)

http://127.0.0.1:2011/webservice.php?ACTION=S1EXP&ID=111381&ZIP=57010®ION=Πευκα&COD=1.80&WEIGHT=2&RECEPTION=0&MODULE=AUTO

Με το συγκεκριμένο Service μπορούμε να υπολογίσουμε τα έξοδα αποστολής μιας αποστολής σύμφωνα με τον τιμοκατάλογο χρέωσης της εκάστοτε Courier, συνδυάζοντας πληροφορίες όπως ΤΚ, Περιοχή, Βάρος, Αντικαταβολή και παράδοσης Reception

Το συγκεκριμένο Service μπορεί να μεταβάλει τα έξοδα (104 Μεταφορικά Πωλήσεων) ή την αξία ενός συγκεκριμένου είδους που χρησιμοποιείτε ως Έξοδο αποστολής απευθείας στο παραστατικό

Κάνοντας χρήση την παράμετρο AUTO στο MODULE μπορεί το σύστημα να επιλέξει αυτόματα την ποιο οικονομική Courier (εάν έχουμε πάνω από 1) ενώ εάν ορίσουμε στο MODULE π.χ. ACS θα υπολογίσει τα έξοδα αποστολής για την ACS

Στατιστικά Αποστολής

http://127.0.0.1:2012/webservice.php?ACTION=COURIERSTAT&ZIP=57010®ION=Πευκα&COD=1&WEIGHT=2&RECEPTION=0

Με το συγκεκριμένη Service θα πάρουμε χρήσιμές πληροφορίες για την αποστολή μας όπως :

  • Delivered = Ποσοστό Παραδόσεων για το συγκεκριμένο κατάστημα Courier
  • Return = Επιστροφές για το συγκεκριμένο κατάστημα Courier
  • Score = Courier με την ποιο γρήγορης παράδοσης
  • Inaccessible = Εάν η περιοχή είναι Δυσπρόσιτη η όχι
  • Estimate_cost = *Εκτίμηση κόστους αποστολής (μεταφορικά)

*Η εκτίμηση κόστους προέρχεται από έναν πολύπλοκο μηχανισμό με τον οποίο μπορεί να υπολογιστεί η αξία των μεταφορικών συνδυάζοντας ΤΚ, Περιοχή, Βάρος, Αντικαταβολή και αν είναι παράδοση Reception

Πίνακας Module

Module Courier
ACS ACS
ELTA ΕΛΤΑ
GENTAX ΓΕΝΙΚΗ ΤΑΧΥΔΡΟΜΙΚΗ
SPEEDEX SPEEDEX
TAX ΕΛΛΗΝΙΚΟ ΤΑΧΥΔΡΟΜΕΙΟ
ENTIPPOS PAC-MAN
TAS TAS
VTRS VTRS
EASYMAIL EASYMAIL
MYCOURIERNOW MYCOURIERNOW
COURIERCENTER COURIER CENTER
SVUUM SVUUM
KRONOSEXPRESS KRONOSEXPRESS
WEBOXIT WEBOXIT
BCS BCS
BOXNOW BOXNOW
TURNAROUND TURNAROUND
TAXYDEMA ΤΑΧΥΔΕΜΑ
ICC ICC
CTS CTS
SKROUTZLASTMILE SKROUTZ LAST MILE
HAPPYCOURIER HAPPY COURIER
AIOLOS AIOLOS COURIER
MYTRANS MY TRANS
BOXEXPRESS BOX EXPRESS
REDCOURIER RED COURIER
CITYCOURIER CITY COURIER
XPCOURIER XP COURIER
DKCOURIER DK COURIER
DAILYCOURIER DAILY COURIER