Hermes WEB App REST API

Περιεχόμενο

Εισαγωγή
Γενικοί Κωδικοί σφάλματος API
Web App Module Hermes: Rest Api (pegapi00)
- Hello
Web App Module Hermes Πυρήνα (kernel)
Web App Module Hermes: e-Courier (courier)
Web App Module Hermes: Tour Agent (tour00)

Εισαγωγή

Οι τύποι των δεδομένων του REST Service είναι:

String: Συμβολοσειρά
Number: Όλες οι πιθανές αριθμητικές μεταβλητές
Boolean: Ακέραιος αριθμός. Οι τιμές που μπορεί να πάρει είναι 0 για το false και 1 για το true
Date: Η ημερομηνία. Η ημερομηνία πρέπει να είναι της μορφής "Y-m-d"

Mπόρειτε να κατεβασετε το collation για το Postman με όλα τα end-points του service απο εδώ

Τα request παραλαβής (GET) των δεδομένων έχουν τις εξής παραμέτρους:

recperpage: Το πλήθος των δεδομένων που θα γίνουν παραλαβή
page: Η σελίδα των δεδομένων.
order_array: Τα πεδία με το οποία θα γίνει η ταξινόμηση των αποτελεσμάτων του get.
π.χ. /api/crm001/d00?order_array[p19]=DESC&order_array[nr01]=ACS
filter: Οι συνθήκες επιλογής δεδομένων εμφάνισης.
π.χ. /api/crm001/d00?filter[or][0][p19][starts]=ψ&filter[or][1][p19][equals]=Φύλακας 1 - Οδηγος&filter[and][0][nr01][lt]=3000033
Εάν Θέλω να μου φέρει από τους συναλλασσόμενους όσους ο διακριτικός τους τίτλος ξεκινά από "ψ" ή είναι ίσος με "Φύλακας 1 - Οδηγος" και το Μ.Κ. είναι μικρότερο από 3000033.
Αναλυτικά.
Στο filter τα όρισμα είναι:

'or' ή 'and' όπου ορίζεται η συνθήκη σύνδεσης των υποσυνθηκών.
Ένας αύξοντας αριθμός που χαρακτηρίζει την υποσυνθήκη.
Το πεδίο στο οποίο θα υπάρχει ο περιορισμός.
Η συνθήκη του περιορισμού*.
Η τιμή σύγκρισης με το πεδίο

* Οι συνθήκες περιορισμών είναι:

Όνομα	Περιγραφή	MySQL Operators - Functions	Παράδειγμα
equals	Ισότητα	=	filter[and][0][p19][equals]=Φύλακας 1
notequals	Διάφορο	!=	filter[and][0][p19][notequals]=Φύλακας 1
starts	Ξεκινάει από	LIKE 'a%'	filter[and][0][p19][starts]=Ψ
contains	Περιέχει	LIKE '%a%'	filter[and][0][p19][contains]=Ψ
ends	Τελειώνει	LIKE '%a'	filter[and][0][p19][ends]=Ψ
in	Εμπεριέχεται σε ένα σύνολο	IN()	filter[and][0][nr01][in][0]=3000027&filter[and][0][nr01][in][1]=3000028&filter[and][0][nr01][in][2]=3000029
notin	Δεν εμπεριέχεται σε ένα σύνολο	NOT IN()	filter[and][0][nr01][notin][0]=3000027&filter[and][0][nr01][notin][1]=3000028&filter[and][0][nr01][notin][2]=3000029
lt	Το πεδίο είναι μικρότερο από την τιμή	<	filter[and][0][nr01][lt]=3000030
lte	Το πεδίο είναι μικρότερο ή ίσο από την τιμή	<=	filter[and][0][nr01][lte]=3000030
gt	Το πεδίο είναι μεγαλύτερο από την τιμή	>	filter[and][0][nr01][gt]=3000030
gte	Το πεδίο είναι μεγαλύτερο ή ίσο από την τιμή	>=	filter[and][0][nr01][gte]=3000030

* Εκτός από τα πεδία του response μπορούμε να χρησιμοποιήσουμε και το πεδιο remdatetime που περιεχει το concat(remdate , ' ' , remtime) ετσι μπορουμε να αναζητησουμε τα record που ειναι μεγαλυτερα απο μια ημερομηνία και ώρα.
π.χ. ?filter[and][0][remdatetime][gte]=2021-05-03 19:20:00

Τα request διαγραφής δεδομένων (DELETE) θα πρέπει πάντα να έχουν συμπληρωμένο το {id} που θα διαγραφεί

Τα request δημιουργίας νέων εγγραφών (POST) εάν έχουν συμπληρωμένο το {id} και βρουν την εγγραφή την κάνουν update

Τα request διαχείρισης εγγραφών (PUT) θα πρέπει πάντα να έχουν συμπληρωμένο το {id} το οποίο θα διαχειριστούν

Σε όλα τα (GET) μπορούμε να συμπληρώσουμε μετά τα endpoints μπορούμε να συμπληρώσουμε.

/all
Mε το /all μας φέρνει όλα τα δεδομένα και σε όσα πεδία συνδέονται με άλλο πινάκα εκτός από το πεδίο του κωδικού μας φέρνει και την περιγραφή από το δεύτερο πίνακα με την λογική v_selectbox_{όνομα πεδίου}

/gridall
Η ίδια λογική με το /all αλλα μας φέρνει μόνο τα πεδία που έχουν οριστεί ότι εμφανίζονται στις λίστες δεδομένων.

/{id}
Με το /{id} μας φέρνει την εγγραφή με μοναδικό κωδικό {id}

Γενικοί Κωδικοί σφάλματος API

Γενική μορφή ενός σφάλματος

{
	"code":Κωδικός Σφάλματος ,
	"data":{ 
		"error":{
			"title":"Τίτλος Σφάλματος",
			"detail":"Περιγραφή Σφάλματος"
		}
	}
}

Τίτλος	Πεδίο	Τύπος	Μέγεθος
Κωδικός Σφάλματος	code	String
Η περιγραφή του Σφάλματος	data	Array		Πίνακας με την περιγραφή του σφάλματος. {"error":{ "title":"Τίτλος Σφάλματος", "detail":"Περιγραφή Σφάλματος"}}

Method: GET, POST, DELETE, PUT

RESPONSE / HTTP response code: 400
Εάν το module το οποίο ορίζεται URL δεν υπάρχει
RESPONSE / HTTP response code: 400
Εάν η μέθοδος ή ο πίνακας που καλείται δεν υπάρχει κάτω από το module του URL
RESPONSE / HTTP response code: 401
Εάν η μέθοδος που καλείται χρειάζεται δικαιώματα και ο συνδεδεμένος χρήστης δεν τα έχει
RESPONSE / HTTP response code: 405
Όταν η μέθοδος του request δεν υποστηρίζεται από το Service

Method: GET

RESPONSE / HTTP response code: 290
Δεν βρέθηκαν εγγραφές στην εκτέλεση του get

Method: POST

RESPONSE / HTTP response code: 403
Πρόβλημα κατά την αποθήκευση
RESPONSE / HTTP response code: 500
Εκτέλεση μεθόδου POST όπου το Post Size είναι μεγαλύτερο από το όριο του server

Method: DELETE

RESPONSE / HTTP response code: 400
Δε βρέθηκε o πίνακας ή ο μοναδικός κωδικός
RESPONSE / HTTP response code: 403
Όταν οι περιορισμοί του πίνακα δεν επιτρέπουν τη διαγραφή της εγγραφής
RESPONSE / HTTP response code: 404
Δε βρέθηκε η εγγραφή στον πίνακα

Web App Module Hermes: Rest Api (pegapi00)

Hello

URL: "/hermes_api/pegapi00/hello"

Method: GET REQUEST

{ "sid":"String" }

Τίτλος	Πεδίο	Τύπος	Μέγεθος
SESSION ID της σύνδεσης	sid	String		Δεν είναι υποχρεωτικό

RESPONSE / HTTP response code: 200

{ "code":200, "data":{ "msg":"Hello OK", "isloggedin":0, "sid":"b5b12k5v9t9soint6e4jsovn11" } }

Τίτλος	Πεδίο	Τύπος
Session ID	sid	String
Εάν υπάρχει χρήστης συνδεδεμένος κάτω από το SID	isloggedin	Boolean
Περιγραφή	msg	String

*Κατεβάστε το JSON για το Postman

Web App Module Hermes Πυρήνα (kernel)

Σύνδεση Χρήστη

URL: "/hermes_api/kernel/login"

Method: POST REQUEST

{ "type":"json", "username":"admin", "password":"admin", "lang": "GR" }

Τίτλος	Πεδίο	Τύπος	Μέγεθος
Τύπος Δεδομένων Επικοινωνίας	type	String		json
Όνομα Χρήστη	username	String	50	Το όνομα χρήστη στο front end
Συνθηματικό	password	String	50	Το συνθηματικό του χρήστη στο front end
Γλώσσα Δεδομένων	lang	String		Η γλώσσα δεδομένων παραμένει η ίδια για όλα τα request μετά το login. Έχετε τη δυνατότητα όμως σε κάθε request το οποίο εκτελείτε να μπορείτε να του αλλάξετε τιμή. GR: Για να επιστρέφει τα δεδομένα στα ελληνικά. EN: Για να επιστρέφει τα δεδομένα στα αγγλικά.

RESPONSE / HTTP response code: 200

{ "code":200, "data":{ "sid":String } }

Τίτλος	Πεδίο	Τύπος	Μέγεθος
Session ID	sid	String

*Κατεβάστε το JSON για το Postman

RESPONSE / HTTP response code: 401

Όταν το username ή το password είναι λάθος.

RESPONSE / HTTP response code: 403

Όταν ο χρήστης είναι ήδη συνδεδεμένος στο service.

Χώρες

URL: "/hermes_api/kernel/d23/{id}"

Method: GET REQUEST

{ "sid":"String" }

Τίτλος	Πεδίο	Τύπος	Μέγεθος
SESSION ID της σύνδεσης	sid	String

RESPONSE / HTTP response code: 200

Τίτλος	Πεδίο	Τύπος	Μέγεθος
M.K.	nr01	Νumeric	15
Κωδικός	p01	String	3
Χώρα	p02	String	50	Η περιγραφή της χώρας στην γλώσσα που έχω συνδεθεί.

*Κατεβάστε το JSON για το Postman

Αποσύνδεση Χρήστη

URL: "/hermes_api/kernel/logout"

Method: POST REQUEST

{ "sid":"String" }

Τίτλος	Πεδίο	Τύπος	Μέγεθος
SESSION ID της σύνδεσης	sid	String

RESPONSE / HTTP response code: 200

{ "code":200,"data":[] }

*Κατεβάστε το JSON για το Postman

Web App Module Hermes: e-Courier (courier)

Καταστάσεις Voucher

URL: "/hermes_api/courier/r14/{id}"

Method: GET REQUEST

{ "sid":"String" }

Τίτλος	Πεδίο	Τύπος	Μέγεθος
SESSION ID της σύνδεσης	sid	String

RESPONSE / HTTP response code: 200

Τίτλος	Πεδίο	Τύπος	Μέγεθος
M.K.	nr01	Νumeric	15
Κωδικός	p01	String	3
Περιγραφή	p02	String	50	Η περιγραφή της κατάστασης στην γλώσσα που έχω συνδεθεί.
Εµφανίζεται το voucher στις λίστες των χρηστών	rdusr	Boolean
Τροποποιείται από τους χρήστες	mdusr	Boolean
Επιλέγεται από τους χρήστες	excusr	Boolean
Εμφανίζεται το πεδίο της Υπογραφής κι είναι υποχρεωτικό	sign_r	Boolean
Εμφανίζεται το πεδίο Υπεύθυνος Παραλαβής και είναι υποχρεωτικό	name_s	Boolean
Εμφανίζεται το πεδίο Υπεύθυνος Παράδοσης και είναι υποχρεωτικό	name_r	Boolean

*Κατεβάστε το JSON για το Postman

Εκτύπωση Voucher

URL: "/hermes_api/courier/print_voucher"

Method: GET REQUEST

Τίτλος	Πεδίο	Τύπος	Μέγεθος
SESSION ID της σύνδεσης	sid	String
Μοναδικός Κωδικός Φόρμας Εκτύπωσης	hcou01nr01	Νumeric	15	O μοναδικός κωδικός της φόρμας εκτύπωσης (Toolbox->Εργαλεία Παραμετροποίησης->Παραμετροποίηση Ηermes Modules->Παραμετροποίηση Courier->Φόρμες εκτύπωσης Voucher). Εάν είναι κενός ή δεν είναι ενεργό το πεδίο "Άμεση εκτέλεση" τότε εκτυπώνετε η φόρμα των ετικετών.
Κωδικοί Voucher	voucher	Array		Οι μοναδικοί κωδικοί των voucher που θα εκτυπωθούν

REQUEST / HTTP response code: 200

Εάν είναι επιτυχής η εκτέλεση τότε επιστρέφει το PDF που δημιουργήθηκε.

*Κατεβάστε το JSON για το Postman

RESPONSE / HTTP response code: 404

Εάν δεν βρεθούν τα voucher για εκτύπωση.

Εύρεση Περιοχή Εξυπηρέτησης - Ζώνης

URL: "/hermes_api/courier/make_zonearea"

Method: GET REQUEST

Τίτλος	Πεδίο	Τύπος	Μέγεθος
SESSION ID της σύνδεσης	sid	String
Κωδικός Χώρας	d23p01	String	3	Ο κωδικός της χώρας. Eίναι ο κωδικός που επιστρέφει στο request Χώρες
Τ.Κ.	r21p02	String	20	Το T.K. για το οποίο θέλουμε να βρεθεί ο "Κωδικός Ζώνης Εξυπηρέτησης" και ο "Κωδικός Περιοχής Εξυπηρέτησης". Η αναζήτηση θα γίνει στον πίνακα "Περιοχές Εξυπηρέτησης Ανά ΤΚ"
Κωδικός Ζώνης Εξυπηρέτησης	r02p01	String	10
Κωδικός Περιοχής Εξυπηρέτησης	r07p01	String	10

RESPONSE / HTTP response code: 200

{ "code": 200, "data": [ { "d23p01": "GR", "r21p02": "15772", "r07p02": "ΖΩΓΡΑΦΟΣ-ΑΤΤΙΚΗΣ", "r02p01": "001", "r07p01": "ΤΚ874" } ] }

Τίτλος	Πεδίο	Τύπος	Μέγεθος
Χώρα	d23p01	String	3
Τ.Κ.	r21p02	String	20
Περιγραφή Περιοχής Εξυπηρέτησης	r07p02	String
Κωδικός Περιοχής Εξυπηρέτησης	r02p01	String	10
Κωδικός Ζώνης Εξυπηρέτησης	r07p01	String	10

*Κατεβάστε το JSON για το Postman

Παρακολούθηση Voucher

URL: "/hermes_api/courier/voucher_tracking"

Method: GET REQUEST

Τίτλος	Πεδίο	Τύπος	Μέγεθος
SESSION ID της σύνδεσης	sid	String
Κωδικοί Voucher	vouchercode	Array		Οι κωδικοί των voucher που θέλω να παρακολουθήσω

RESPONSE / HTTP response code: 200

{ "code": 200, "data": [ { "r18p01": "WEB3000340", "r18p014": "ΠΡΔ", "r14p02": "Εγινε Παράδοση Στον Παραλήπτη", "r18p125": "", "r18p0101": "Δοκιμαστικός Χρήστης", "r18p0201": "ΤΕΣΑΕ", "r18p119": "", "r18p117": "2019-10-23", "r18p118": "15:40", "r15r14r25": [ { "p01": "ΕΚΡ", "p02": "Pending (for Pickup)", "dt": "2019-10-23", "tm": "14:45", "r25r26": [] }, { "p01": "ΤΣΕΚ", "p02": "Done check Receipt of Stock", "dt": "2019-10-23", "tm": "14:51", "r25r26": [] }, { "p01": "ΑΝΑ", "p02": "Done Assign Guide", "dt": "2019-10-23", "tm": "15:08", "r25r26": [] }, { "p01": "ΑΝΑΠ", "p02": "Σε Οδηγό (προς παράδοση)", "dt": "2019-10-23", "tm": "15:13", "r25r26": [ { "p01": "10", "p02": "Αποστολή SMS με την ώρα παράδοσης", "dt": "2019-10-23", "tm": "15:22" } ] }, { "p01": "ΠΡΔ", "p02": "Done Delivery The Receiver", "dt": "2019-10-23", "tm": "15:40", "r25r26": [] } ] } ], "info": { "recperpage": 9999999999, "page": 0, "totalrec": 0 } }

Τίτλος	Πεδίο	Τύπος	Μέγεθος
Κωδικός Voucher	r18p01	String	15
Κωδικός Τρέχουσας Κατάστασης	r18p014	String	5
Περιγραφή Τρέχουσας Κατάστασης	r14p02	String	50
Αριθμός Εντολής	r18p125	String	15	Εμφανίζεται μόνο όταν είναι ενεργή η αντίστοιχη παράμετρος
Τίτλος Αποστολέα	r18p0101	String	40	Εμφανίζεται μόνο όταν είναι ενεργή η αντίστοιχη παράμετρος
Τίτλος Παραλήπτη	r18p0201	String	40	Εμφανίζεται μόνο όταν είναι ενεργή η αντίστοιχη παράμετρος
Υπεύθυνος Παράδοσης	r18p119	String	20	Εμφανίζεται μόνο όταν είναι ενεργή η αντίστοιχη παράμετρος
Ημερομηνία Παράδοσης	r18p117	Date		Εμφανίζεται μόνο όταν είναι ενεργή η αντίστοιχη παράμετρος
Ωρα Παράδοσης	r18p118	String	5	Εμφανίζεται μόνο όταν είναι ενεργή η αντίστοιχη παράμετρος
Voucher Συνεργάτη	r18p032	String	30	Εμφανίζεται μόνο όταν είναι ενεργή η αντίστοιχη παράμετρος
Πίνακας με όλο το ιστορικό καταστάσεων του voucher	r15r14r25	Array
Κωδικός Κατάστασης	r15r14r25['p01']	String	5
Περιγραφή Κατάστασης	r15r14r25['p02']	String	50
Ημερομηνία Αλλαγής Κατάστασης	r15r14r25['dt']	Date
Ώρα Αλλαγής Κατάστασης	r15r14r25['tm']	String	5
Πίνακας με τις ενέργειες που έγιναν κάτω από αυτή την κατάσταση	r15r14r25['r25r26']	Array
Κωδικός Ενέργειας	r15r14r25['r25r26']['p01']	String	5
Περιγραφή Ενέργειας	r15r14r25['r25r26']['p02']	String	50
Ημερομηνία Εκτέλεσης Ενέργειας	r15r14r25['r25r26']['dt']	Date
Ώρα Εκτέλεσης Ενέργειας	r15r14r25['r25r26']['tm']	String	5

*Κατεβάστε το JSON για το Postman

Υπολογισμός Κόστους Αποστολής

URL: "/hermes_api/courier/calculate_cost"

Method: GET REQUEST

Τίτλος	Πεδίο	Τύπος	Μέγεθος
SESSION ID της σύνδεσης	sid	String
Είδος Εντολής	p126	Νumeric	1	1 => Εντολή, 2 => Αποστολή, 3 => Παραλαβή. Εάν από τις παραμέτρους είναι ενεργό το πεδίο τότε η προκαθορισμένη τιμή είναι 2. Διαφορετικά η προκαθορισμένη τιμή είναι 1. Ανάλογα το είδος της εντολής αρχικοποιούντε τα στοιχεία του αποστολέα ή παραλήπτη με τα στοιχεία του συνδεδεμένου χρήστη
Βάρος (σε κιλά)	p101	Νumeric	10,3
Μήκος (cm)	p102	Νumeric	3
Πλάτος (cm)	p103	Νumeric	3
Ύψος (cm)	p104	Νumeric	3
Χώρα Αποστολέα	p0104country	String	3	Ο κωδικός της χώρας. Eίναι ο κωδικός που επιστρέφει στο request Χώρες
Περιοχή Εξυπηρέτησης Αποστολέα	p0104	String	10	Ο κωδικός της περιοχής εξυπηρέτησης. Eίναι ο κωδικός που επιστρέφει στο request Εύρεση Περιοχή Εξυπηρέτησης - Ζώνης
Ζώνη Αποστολέα	p0105	String	5	Ο κωδικός της ζώνης. Eίναι ο κωδικός που επιστρέφει στο request Εύρεση Περιοχή Εξυπηρέτησης - Ζώνης
Διεύθυνση Αποστολέα	p0102	String	40
ΤΚ Αποστολέα	p0108	String	20
Περιοχή Αποστολέα	p0103	String	40
Χώρα Παραλήπτη	p0204country	String	3	Ο κωδικός της χώρας. Eίναι ο κωδικός που επιστρέφει στο request Χώρες
Περιοχή Εξυπηρέτησης Παραλήπτη	p0204	String	10	Ο κωδικός της περιοχής εξυπηρέτησης. Eίναι ο κωδικός που επιστρέφει στο request Εύρεση Περιοχή Εξυπηρέτησης - Ζώνης
Ζώνη Παραλήπτη	p0205	String	5	Ο κωδικός της ζώνης. Eίναι ο κωδικός που επιστρέφει στο request Εύρεση Περιοχή Εξυπηρέτησης - Ζώνης
Διεύθυνση Παραλήπτη	p0202	String	40
ΤΚ Παραλήπτη	p0208	String	20
Περιοχή Παραλήπτη	p0203	String	40
Ημερομηνία Επιθυμητής Παραλαβής	p106	Date		Το πεδίο αυτό συμπληρώνετε αυτόματα. Το συμπληρώνετε μόνο εάν θέλετε η παραλαβή να γίνει συγκεκριμένη ημέρα (π.χ. Σάββατο).
Ώρα Επιθυμητής Παραλαβής από	p107	String	5	Το πεδίο αυτό συμπληρώνετε αυτόματα. Το συμπληρώνετε μόνο εάν θέλετε η παραλαβή να γίνει συγκεκριμένη ώρα
Ώρα Επιθυμητής Παραλαβής έως	p108	String	5	Το πεδίο αυτό συμπληρώνετε αυτόματα βάση της επιθυμητής ώρας παραλαβής από. Το συμπληρώνετε μόνο εάν θέλετε χρονική δέσμευση στην παραλαβή.
Ημερομηνία Επιθυμητής Παράδοσης	p109	Date		Το πεδίο αυτό συμπληρώνετε αυτόματα. Το συμπληρώνετε μόνο εάν θέλετε η παράδοση να γίνει συγκεκριμένη ημέρα (π.χ. Σάββατο).
Ώρα Επιθυμητής Παράδοσης από	p110	String	5	Το πεδίο αυτό συμπληρώνετε αυτόματα. Το συμπληρώνετε μόνο εάν θέλετε η παράδοση να γίνει συγκεκριμένη ώρα
Ώρα Επιθυμητής Παράδοσης έως	p111	String	5	Το πεδίο αυτό συμπληρώνετε αυτόματα βάση της επιθυμητής ώρας παράδοσης από. Το συμπληρώνετε μόνο εάν θέλετε χρονική δέσμευση στην παράδοση.
Ποσό Αντικαταβολής σε Μετρητά	p022	Νumeric	10,2
Ποσό Αντικαταβολής σε Επιταγή	p023	Νumeric	10,2
Κωδικός είδους εργασίας	p04	Νumeric	1	Εάν είναι κενός τότε στα αποτελέσματα του υπολογισμού του κόστος θα εμφανιστούν όλες οι οι πιθανές εργασίες της αποστολής.

RESPONSE / HTTP response code: 200

{ "code": 200, "data": { "validatedata": { "p126": 2, "p04": "", "p101": "", "p102": "", "p103": "", "p104": "", "p0104country": "", "p0204country": "", "p0104": "ΤΚ874", "p0204": "ΤΚ458", "p0105": "001", "p0205": "003", "p0102": "Χλ", "p0202": "", "p0108": "15772", "p0208": "83102", "p0103": "Ζωγράφου", "p0203": "", "p106": "2017-01-05", "p109": "2017-01-06", "p107": "", "p108": "", "p110": "", "p111": "", "p022": "", "p023": "", "p0204_multirec": [ { "r07p01": "ΤΚ458", "r07p02": "ΜΑΡΑΘΟΚΑΜΠΟΣ-ΣΑΜΟΥ", "r02p01": "003" }, { "r07p01": "ΤΚ463", "r07p02": "ΣΑΜΟΣ-ΣΑΜΟΥ", "r02p01": "003" } ] }, "total": [ { "r01p01": "001", "r01p02": "Επόμενη Ημέρα", "r01p30": " ", "r18p05": 8.94, "r18p07": "", "r18p08": "", "r18p010": 8.94, "r18p011": 2.15, "r18p012": 11.09, "r04p013": "", "r04p014": "" } ] } }

Τίτλος	Πεδίο	Τύπος	Μέγεθος
Τα δεδομένα του Request μετά τις αυτόματες συμπληρώσεις	validatedata	Array
Είδος Εντολής	validatedata['p126']	Νumeric	1
Βάρος (σε κιλά)	validatedata['p101']	Νumeric	10,3
Μήκος (cm)	validatedata['p102']	Νumeric	3
Πλάτος (cm)	validatedata['p103']	Νumeric	3
Ύψος (cm)	validatedata['p104']	Νumeric	3
Χώρα Αποστολέα	validatedata['p0104country']	String	3
Περιοχή Εξυπηρέτησης Αποστολέα	validatedata['p0104']	String	10
Επιπλέον Περιοχή Εξυπηρέτησης Αποστολέα	validatedata['p0104_multirec']	Array		Εάν στα στοιχεία του αποστολέα υπάρχουν περισσότερες από μια περιοχές εξυπηρέτησης τότε εμφανίζονται σε αυτό το array. Η καταχώρηση του voucher πρέπει να γίνει με την σωστή περιοχή εξυπηρέτησης ώστε να υπολογιστεί σωστά το κόστος αποστολής
Κωδικός της περιοχής εξυπηρέτησης	validatedata['p0104_multirec']['r07p01']	String	10
Περιγραφή της περιοχής εξυπηρέτησης	validatedata['p0104_multirec']['r07p02']	String	50
Κωδικός ζώνης	validatedata['p0104_multirec']['r02p01']	String	5
Ζώνη Αποστολέα	validatedata['p0105']	String	5
Διεύθυνση Αποστολέα	validatedata['p0102']	String	40
ΤΚ Αποστολέα	validatedata['p0108']	String	20
Περιοχή Αποστολέα	validatedata['p0103']	String	40
Χώρα Παραλήπτη	validatedata['p0204country']	String	3
Περιοχή Εξυπηρέτησης Παραλήπτη	validatedata['p0204']	String	10
Επιπλέον Περιοχή Εξυπηρέτησης Παραλήπτη	validatedata['p0204_multirec']	Array		Εάν στα στοιχεία του παραλήπτη υπάρχουν περισσότερες από μια περιοχές εξυπηρέτησης τότε εμφανίζονται σε αυτό το array. Η καταχώρηση του voucher πρέπει να γίνει με την σωστή περιοχή εξυπηρέτησης ώστε να υπολογιστεί σωστά το κόστος αποστολής
Κωδικός της περιοχής εξυπηρέτησης	validatedata['p0204_multirec']['r07p01']	String	10
Περιγραφή της περιοχής εξυπηρέτησης	validatedata['p0204_multirec']['r07p02']	String	50
Κωδικός ζώνης	validatedata['p0204_multirec']['r02p01']	String	5
Ζώνη Παραλήπτη	validatedata['p0205']	String	5
Διεύθυνση Παραλήπτη	validatedata['p0202']	String	40
ΤΚ Παραλήπτη	validatedata['p0208']	String	20
Περιοχή Παραλήπτη	validatedata['p0203']	String	40
Ημερομηνία Επιθυμητής Παραλαβής	validatedata['p106']	Date
Ώρα Επιθυμητής Παραλαβής από	validatedata['p107']	String	5
Ώρα Επιθυμητής Παραλαβής έως	validatedata['p108']	String	5
Ημερομηνία Επιθυμητής Παράδοσης	validatedata['p109']	Date
Ώρα Επιθυμητής Παράδοσης από	validatedata['p110']	String	5
Ώρα Επιθυμητής Παράδοσης έως	validatedata['p111']	String	5
Ποσό Αντικαταβολής σε Μετρητά	validatedata['p022']	Νumeric	10,2
Ποσό Αντικαταβολής σε Επιταγή	validatedata['p023']	Νumeric	10,2
Κωδικός είδους εργασίας	validatedata['p04']	String	5	Εάν είναι κενός τότε στα αποτελέσματα του υπολογισμού του κόστος θα εμφανιστούν όλες οι οι πιθανές εργασίες της αποστολής.
Πίνακας με το κόστος αποστολής ανά εργασία	total	Array
Κωδικός εργασίας	total['r01p01']	String	5
Περιγραφή εργασίας	total['r01p02']	String	50
Κείμενο εργασίας	total['r01p30']	Memo
Αξία Διαδρομής (από Ζώνες)	total['r18p05']	Νumeric	10,2
Κόστος Λοιπών Χρεώσεων	total['r18p07']	Νumeric	10,2
Κόστος Ειδικών Χρεώσεων	total['r18p08']	Νumeric	10,2
Καθαρή Αξία	total['r18p010']	Νumeric	10,2
ΦΠΑ	total['r18p011']	Νumeric	10,2
Τελικό Σύνολο	total['r18p012']	Νumeric	10,2
Ημέρες παράδοσης από	total['r04p013']	Νumeric	3
Ημέρες παράδοσης έως	total['r04p014']	Νumeric	3

*Κατεβάστε το JSON για το Postman

Voucher

URL: "/hermes_api/courier/r18/{id}"

Method: GET REQUEST

{ "sid":"String" }

Τίτλος	Πεδίο	Τύπος	Μέγεθος
SESSION ID της σύνδεσης	sid	String

RESPONSE / HTTP response code: 200

Επιστρέφει μόνο τα voucher του τελευταίου μήνα.

Τίτλος	Πεδίο	Τύπος	Μέγεθος
Μοναδικός κωδικός	nr01	Νumeric	15
Αριθμός Voucher	p01	String	15
Ημερομηνία Καταχώρησης	p015	Date
Αριθμός Εντολής	p125	String	15
Είδος Εντολής	p126	Νumeric	1	1 => Εντολή, 2 => Αποστολή, 3 => Παραλαβή.
Κωδικός είδους εργασίας	p04	String	5	Εάν είναι κενός τότε στα αποτελέσματα του υπολογισμού του κόστος θα εμφανιστούν όλες οι οι πιθανές εργασίες της αποστολής.
Κωδικός κατάστασης	p014	String	5	Εάν είναι κενός τότε στα αποτελέσματα του υπολογισμού του κόστος θα εμφανιστούν όλες οι οι πιθανές εργασίες της αποστολής.
Κωδικός (CRM) Αποστολέα	p0100	Νumeric	15
Διακριτικός Τίτλος Αποστολέα	p0101	String	40
Διεύθυνση Αποστολέα	p0102	String	40
Περιοχή Αποστολέα	p0103	String	40
Περιοχή Εξυπηρέτησης Αποστολέα	p0104	String	10
Ζώνη Αποστολέα	p0105	String	5
Τηλέφωνο 1 Αποστολέα	p0106	String	20
Τηλέφωνο 2 Αποστολέα	p0109	String	20
Σημειώσεις Αποστολέα	p0107	Memo
ΤΚ Αποστολέα	p0108	String	20
E-mail Αποστολέα	p0110	String	20
Κωδικός (CRM) Παραλήπτη	p0200	Νumeric	15
Διακριτικός Τίτλος Παραλήπτη	p0201	String	40
Διεύθυνση Παραλήπτη	p0202	String	40
Περιοχή Παραλήπτη	p0203	String	40
Περιοχή Εξυπηρέτησης Παραλήπτη	p0204	String	10
Ζώνη Παραλήπτη	p0205	String	5
Τηλέφωνο 1 Παραλήπτη	p0206	String	20
Τηλέφωνο 2 Παραλήπτη	p0209	String	20
Σημειώσεις Παραλήπτη	p0207	Memo
ΤΚ Παραλήπτη	p0208	String	20
E-mail Παραλήπτη	p0210	String	20
Ημερομηνία Επιθυμητής Παραλαβής	p106	Date
Ώρα Επιθυμητής Παραλαβής από	p107	String	5
Ώρα Επιθυμητής Παραλαβής έως	p108	String	5
Ημερομηνία Επιθυμητής Παράδοσης	p109	Date
Ώρα Επιθυμητής Παράδοσης από	p110	String	5
Ώρα Επιθυμητής Παράδοσης έως	p111	String	5
Ημερομηνία Παραλαβής	p113	Date
Ωρα Παραλαβής	p114	String	5
Υπεύθυνος Παραλαβής	p115	String	20
Ηµεροµηνία Παράδοσης	p117	Date
Ωρα Παράδοσης	p118	String	5
Υπεύθυνος Παράδοσης	p119	String	20
Τεμάχια	p120	Νumeric	5
Βάρος (σε κιλά)	p101	Νumeric	10,3
Μήκος (cm)	p102	Νumeric	3
Πλάτος (cm)	p103	Νumeric	3
Ύψος (cm)	p104	Νumeric	3
Ογκοµετρικό βάρος	p105	Νumeric	10,3
Ποσό Αντικαταβολής σε Μετρητά	p022	Νumeric	10,2
Ποσό Αντικαταβολής σε Επιταγή	p023	Νumeric	10,2
Ηµ/νία Παραλαβής Αντικαταβολής-Επιστρεφόµενου (εταιρεία)	p024	Date
Ηµ/νία Παράδοσης Αντικαταβολής-Επιστρεφόµενου Σε Πελάτη p025 D 8	p025	Date
Voucher Παράδοσης Αντικαταβολής- Επιστρεφόµενου	p027	String	15
Voucher Συνεργάτη	p032	String	20
Voucher Επιστροφής	p041	String	20
Σύνολο Χρέωσης	p09	Νumeric	10
Καθαρή Αξία	p010	Νumeric	10,2
ΦΠΑ	p011	Νumeric	10,2
Τελικό Σύνολο	p012	Νumeric	10,2
Αξία Διαδρομής (από Ζώνες)	p05	Νumeric	10,2
Κόστος Λοιπών Χρεώσεων	p07	Νumeric	10,2
Κόστος Ειδικών Χρεώσεων	p08	Νumeric	10,2
% ΦΠΑ	p016	Νumeric	5,2
Οι τιµές έχουν ΦΠΑ	p017	Boolean	1
Λογικό 1 - 10	pdl01-pdl10	Boolean	1	Εμφανίζονται μόνο όταν είναι συμπληρωμένες οι περιγραφές τους στην εφαρμογή
Λεκτικό 1 - 5	pdc01-pdc05	String		Εμφανίζονται μόνο όταν είναι συμπληρωμένες οι περιγραφές τους στην εφαρμογή
Αριθµός 1 - 10	pdn01-pdn10	String		Εμφανίζονται μόνο όταν είναι συμπληρωμένες οι περιγραφές τους στην εφαρμογή
Παράµετρος 1 - 5	pdp01-pdp10	String		Εμφανίζονται μόνο όταν είναι συμπληρωμένες οι περιγραφές τους στην εφαρμογή

*Κατεβάστε το JSON για το Postman

Method: POST REQUEST

*Στα δεδομένα του REQUEST μπορούν να συμμετέχουν και τα Παραμετρικά Πεδία Voucher που εμφανίζονται στο Internet

Τίτλος	Πεδίο	Τύπος	Μέγεθος
SESSION ID της σύνδεσης	sid	String
Αριθμός Voucher	p01	String	15	Εάν είναι κενός τότε συμπληρώνεται αυτόματα.
Είδος Εντολής	p126	Νumeric	1	1 => Εντολή, 2 => Αποστολή, 3 => Παραλαβή. Εάν από τις παραμέτρους είναι ενεργό το πεδίο τότε η προκαθορισμένη τιμή είναι 2. Διαφορετικά η προκαθορισμένη τιμή είναι 1. Ανάλογα το είδος της εντολής αρχικοποιούντε τα στοιχεία του αποστολέα ή παραλήπτη με τα στοιχεία του συνδεδεμένου χρήστη.
Κωδικός είδους εργασίας	p04	Νumeric	1	Εάν είναι κενός συμπληρώνετε αυτόματα με την πρώτη εργασία που θα βρει από τα στοιχεία αποστολής. Μπορείτε να δείτε όλους του κωδικούς εργασίας μιας αποστολής από την εκτέλεση του request Υπολογισμός Κόστους Αποστολής
Κωδικός Κατάστασης	p014	String	5	Εάν το πεδίο είναι κενό θα πάρει την κατάσταση που πέρνουν όλα τα νέα voucher.
Τεμάχια	p120	Νumeric	5	Εάν το πεδίο είναι κενό θα πάρει την προκαθορισμένη τιμή 1.
Βάρος (σε κιλά)	p101	Νumeric	10,3
Μήκος (cm)	p102	Νumeric	3
Πλάτος (cm)	p103	Νumeric	3
Ύψος (cm)	p104	Νumeric	3
Κωδικός Αποστολέα	p0100	Νumeric	15	Εάν το είδος εντολής είναι αποστολή τότε μπορείτε να συμπληρώσετε τον συμπληρώσετε τον κωδικό του συσχετιζόμενου υποκαταστήματος του συνδεδεμένου χρήστη ώστε να συμπληρωθούν τα στοιχεία της αποστολής αυτόματα. Διαφορετικά μπορείτε να συμπληρώσετε τον κωδικό του προσώπου του συνδεδεμένου χρήστη ώστε να συμπληρωθούν τα στοιχεία της αποστολής αυτόματα. Εάν έχετε δώσει τιμή σε αυτό το πεδίο τα υπόλοιπα πεδία του αποστολέα μπορούν να είναι κενά.
Διακριτικός Τίτλος Αποστολέα	p0101	String	40
Χώρα Αποστολέα	p0104country	String	3	Ο κωδικός της χώρας. Eίναι ο κωδικός που επιστρέφει στο request Χώρες
Περιοχή Εξυπηρέτησης Αποστολέα	p0104	String	10	Ο κωδικός της περιοχής εξυπηρέτησης. Eίναι ο κωδικός που επιστρέφει στο request Εύρεση Περιοχή Εξυπηρέτησης - Ζώνης
Ζώνη Αποστολέα	p0105	String	5	Ο κωδικός της ζώνης. Eίναι ο κωδικός που επιστρέφει στο request Εύρεση Περιοχή Εξυπηρέτησης - Ζώνης
Διεύθυνση Αποστολέα	p0102	String	40
ΤΚ Αποστολέα	p0108	String	20
Περιοχή Αποστολέα	p0103	String	40
Τηλέφωνο 1 Αποστολέα	p0106	String	20
Τηλέφωνο 2 Αποστολέα	p0109	String	20
E-mail Αποστολέα	p0110	String	60
Σημειώσεις Αποστολέα	p0107	Memo		Το πεδίο μπορεί να είναι κενό.
Κωδικός Παραλήπτη	p0200	Νumeric	15	Εάν το είδος εντολής είναι παραλαβή τότε μπορείτε να συμπληρώσετε τον συμπληρώσετε τον κωδικό του συσχετιζόμενου υποκαταστήματος του συνδεδεμένου χρήστη ώστε να συμπληρωθούν τα στοιχεία της παραλαβής αυτόματα. Διαφορετικά μπορείτε να συμπληρώσετε τον κωδικό του προσώπου του συνδεδεμένου χρήστη ώστε να συμπληρωθούν τα στοιχεία της παραλαβής αυτόματα. Εάν έχετε δώσει τιμή σε αυτό το πεδίο τα υπόλοιπα πεδία του παραλήπτη μπορούν να είναι κενά.
Διακριτικός Τίτλος Παραλήπτη	p0201	String	40
Χώρα Παραλήπτη	p0204country	String	3	Ο κωδικός της χώρας. Eίναι ο κωδικός που επιστρέφει στο request Χώρες
Περιοχή Εξυπηρέτησης Παραλήπτη	p0204	String	10	Ο κωδικός της περιοχής εξυπηρέτησης. Eίναι ο κωδικός που επιστρέφει στο request Εύρεση Περιοχή Εξυπηρέτησης - Ζώνης
Ζώνη Παραλήπτη	p0205	String	5	Ο κωδικός της ζώνης. Eίναι ο κωδικός που επιστρέφει στο request Εύρεση Περιοχή Εξυπηρέτησης - Ζώνης
Διεύθυνση Παραλήπτη	p0202	String	40
ΤΚ Παραλήπτη	p0208	String	20
Περιοχή Παραλήπτη	p0203	String	40
Τηλέφωνο 1 Παραλήπτη	p0206	String	20
Τηλέφωνο 2 Παραλήπτη	p0209	String	20
E-mail Παραλήπτη	p0210	String	60
Σημειώσεις Παραλήπτη	p0207	Memo		Το πεδίο μπορεί να είναι κενό.
Ημερομηνία Επιθυμητής Παραλαβής	p106	Date		Το πεδίο αυτό συμπληρώνετε αυτόματα. Το συμπληρώνετε μόνο εάν θέλετε η παραλαβή να γίνει συγκεκριμένη ημέρα (π.χ. Σάββατο).
Ώρα Επιθυμητής Παραλαβής από	p107	String	5	Το πεδίο αυτό συμπληρώνετε αυτόματα. Το συμπληρώνετε μόνο εάν θέλετε η παραλαβή να γίνει συγκεκριμένη ώρα
Ώρα Επιθυμητής Παραλαβής έως	p108	String	5	Το πεδίο αυτό συμπληρώνετε αυτόματα βάση της επιθυμητής ώρας παραλαβής από. Το συμπληρώνετε μόνο εάν θέλετε χρονική δέσμευση στην παραλαβή.
Ημερομηνία Επιθυμητής Παράδοσης	p109	Date		Το πεδίο αυτό συμπληρώνετε αυτόματα. Το συμπληρώνετε μόνο εάν θέλετε η παράδοση να γίνει συγκεκριμένη ημέρα (π.χ. Σάββατο).
Ώρα Επιθυμητής Παράδοσης από	p110	String	5	Το πεδίο αυτό συμπληρώνετε αυτόματα. Το συμπληρώνετε μόνο εάν θέλετε η παράδοση να γίνει συγκεκριμένη ώρα
Ώρα Επιθυμητής Παράδοσης έως	p111	String	5	Το πεδίο αυτό συμπληρώνετε αυτόματα βάση της επιθυμητής ώρας παράδοσης από. Το συμπληρώνετε μόνο εάν θέλετε χρονική δέσμευση στην παράδοση.
Ποσό Αντικαταβολής σε Μετρητά	p022	Νumeric	10,2
Ποσό Αντικαταβολής σε Επιταγή	p023	Νumeric	10,2

RESPONSE / HTTP response code: 201

{ "code": 201, "data": { "nr01": "3000341", "p01": "WEB3000341" }, }

Τίτλος	Πεδίο	Τύπος	Μέγεθος
Μοναδικός Κωδικός Voucher	nr01	Νumeric	15
Αριθμός Voucher	p01	String	15

*Κατεβάστε το JSON για το Postman

RESPONSE / HTTP response code: 400

Όταν παρουσιάζεται κάποιο σφάλμα στα δεδομένα του voucher.

{ "code": 4000, "data": [ { } ] }

RESPONSE / HTTP response code: 400

Όταν παρουσιάζεται κάποιο σφάλμα στον υπλογισμό του κόστοτς αποστολής

{ "code": 4001, "data": [ { } ] }

Method: PUT REQUEST

Στο REQUEST PUT ορίζετε μόνο τα πεδία τα στα οποία θέλετε να γίνει αλλαγή στην τιμή τους. *Στα δεδομένα του REQUEST μπορούν να συμμετέχουν και τα Παραμετρικά Πεδία Voucher που εμφανίζονται στο Internet.

PUT /api/{{module}}/{{TABLE}}/{{ID}} HTTP/1.1 Host: {{HOST}} Cache-Control: no-cache sid={{SID}}

Τίτλος	Πεδίο	Τύπος	Μέγεθος
SESSION ID της σύνδεσης	sid	String
Αριθμός Voucher	p01	String	15
Κωδικός είδους εργασίας	p04	Νumeric	1
Κωδικός Κατάστασης	p014	Νumeric	1
Βάρος (σε κιλά)	p101	Νumeric	10,3
Μήκος (cm)	p102	Νumeric	3
Πλάτος (cm)	p103	Νumeric	3
Ύψος (cm)	p104	Νumeric	3
Διακριτικός Τίτλος Αποστολέα	p0101	String	40
Περιοχή Εξυπηρέτησης Αποστολέα	p0104	String	10
Ζώνη Αποστολέα	p0105	String	5
Διεύθυνση Αποστολέα	p0102	String	40
ΤΚ Αποστολέα	p0108	String	20
Περιοχή Αποστολέα	p0103	String	40
Τηλέφωνο 1 Αποστολέα	p0106	String	20
Τηλέφωνο 2 Αποστολέα	p0109	String	20
E-mail Αποστολέα	p0110	String	60
Σημειώσεις Αποστολέα	p0107	Memo
Διακριτικός Τίτλος Παραλήπτη	p0201	String	40
Περιοχή Εξυπηρέτησης Παραλήπτη	p0204	String	10
Ζώνη Παραλήπτη	p0205	String	5
Διεύθυνση Παραλήπτη	p0202	String	40
ΤΚ Παραλήπτη	p0208	String	20
Περιοχή Παραλήπτη	p0203	String	40
Τηλέφωνο 1 Παραλήπτη	p0206	String	20
Τηλέφωνο 2 Παραλήπτη	p0209	String	20
E-mail Παραλήπτη	p0210	String	60
Σημειώσεις Παραλήπτη	p0207	Memo
Ημερομηνία Επιθυμητής Παραλαβής	p106	Date
Ώρα Επιθυμητής Παραλαβής από	p107	String	5
Ώρα Επιθυμητής Παραλαβής έως	p108	String	5
Ημερομηνία Επιθυμητής Παράδοσης	p109	Date
Ώρα Επιθυμητής Παράδοσης από	p110	String	5
Ώρα Επιθυμητής Παράδοσης έως	p111	String	5
Ποσό Αντικαταβολής σε Μετρητά	p022	Νumeric	10,2
Ποσό Αντικαταβολής σε Επιταγή	p023	Νumeric	10,2

RESPONSE / HTTP response code: 201

{ "code": 201, "data": { "nr01": "3000341", "p01": "WEB3000341" }, }

*Κατεβάστε το JSON για το Postman

RESPONSE / HTTP response code: 400

Όταν παρουσιάζεται κάποιο σφάλμα στα δεδομένα του voucher.

{ "code": 4000, "data": [ { } ] }

RESPONSE / HTTP response code: 400

Όταν παρουσιάζεται κάποιο σφάλμα στον υπλογισμό του κόστοτς αποστολής

{ "code": 4001, "data": [ { } ] }

RESPONSE / HTTP response code: 401

Όταν ο μοναδικός κωδικός του voucher είναι κενός ή δεν υπάρχει στην βάση δεδομένων .

RESPONSE / HTTP response code: 401

Όταν ο μοναδικός κωδικός του voucher δεν υπάρχει στην βάση δεδομένων κάτω από τον συνδεδεμένο χρήστη.

Web App Module Hermes: Tour Agent (tour00)

Δρομολόγια

URL: "/hermes_api/tour00/tour00_11/{id}"

Method: GET REQUEST

{ "sid" : "String" }

RESPONSE / HTTP response code: 200

Τίτλος	Πεδίο	Τύπος	Μέγεθος
ΜΚ Δρομολογίου	nr01	Νumeric	15
Εκδρομή (Πρότυπη)	tour00_10	Νumeric	15
Εκδρομή (Πρότυπη) - Περιγραφή	tour00_10_p01	String	100
Ημερομηνία	dt	Date	8
Ώρα Αναχώρησης	tm01	String	5
Ώρα Επιστροφής	tm02	String	5
Γλώσσες Ξενάγησης	tour00_14p00	Memo	10

*Κατεβάστε το JSON για το Postman

Εισιτήρια

URL: "/hermes_api/tour00/tour00_20/{id}"

Method: GET REQUEST

{ "sid" : "String" }

RESPONSE / HTTP response code: 200

Τίτλος	Πεδίο	Τύπος	Μέγεθος
ΜΚ Εισιτηρίου	nr01	Νumeric	15
Σειρά Εισιτηρίου	tour00_21p00	String	3
Αριθμός Εισιτηρίου	p50	Νumeric	10
Εκδρομή (Πρότυπη)	tour00_10	Νumeric	15
Εκδρομή (Πρότυπη) - Περιγραφή	tour00_10_p01	String	100
Ημερομηνία	dt	Date	8
Ώρα Αναχώρησης	tm01	String	5
Ώρα Επιστροφής	tm02	String	5
Oνοματεπώνυμο Leader	p100	String	100
Συναλλασσόμενος (Tour Operator - Πωλητής)	vendor_d00	Νumeric	15
Συναλλασσόμενος (Tour Operator - Πωλητής) - Οναματεπώνυμο	vendor_d00_p19	String	100
Ακυρώθηκε	p400	Boolean	1

*Κατεβάστε το JSON για το Postman

RESPONSE / HTTP response code: 401

Εάν ο χρήστης δεν έχει κάνει Login

RESPONSE / HTTP response code: 407

Εάν ο χρήστης που έχει κάνει Login ΔΕΝ είναι Tour Operator ή Πωλητής (Μη Εξουσιοδοτημένος Χρήστης)

{ "code": 407, "data": [ { "error": { "title": "Unauthorized User", "detail": "Unauthorized User! This action cannot be completed by an Unauthorized User" } } ], "info": "" }

Καταχώρηση Κράτησης

URL: "/hermes_api/tour00/make_reservation"

Method: POST REQUEST

Τίτλος	Πεδίο	Τύπος	Μέγεθος
Δρομολόγιο	tour00_11	Νumeric	15
Χειρόγραφο	p401	Boolean	1
Τελική Τιμή Εισιτηρίου	p301	Νumeric	15,2
Γλώσσες Ξενάγησης	tour00_14p00	Memo	10
Σημείο Αναχώρησης	tour00_13_00	Νumeric	15
Σχόλια σημείου Αναχώρησης	p30_00	Memo	10
Σημείο Επιστροφής	tour00_13_01	Νumeric	15
Σχόλια σημείου Επιστροφής	p30_01	Memo	10
Σειρά Εισιτηρίου	tour00_21p00	String	3
Αριθμός Εισιτηρίου	p50	Νumeric	10
Κωδικός Εισιτηρίου	p200	String	100
Oνοματεπώνυμο Leader	p100	String	100
Όνομα Ξενοδοχείου	p04	String	50
Αριθμός Δωματίου	p05	String	6
Ημεροομηνία Έκδοσης	dti	Date	8
Ώρα Έκδοσης	tmi	String	5
Επιβάτες	passengers	String		Οι Επιβάτες της Κράτησης κωδικοποιημένοι σε json μορφή: [ { "tour00_24p00":"Ονοματεπώνυμο", "tour00_24pass":"Τύπος(0-Ενήλικας,1-Παιδί,2-Βρέφος)", "tour00_24p04":"Φύλο(1-Άνδρας,2-Γυναικα)", "tour00_24p05":"Ημ/νία Γέννησης", "tour00_24p06":"Εθνικότητα", "tour00_24p010":"Διεύθυνση", "tour00_24p01":"Τηλέφωνο", "tour00_24p02_1":"Τύπος Εγγράφου (0,1-Διαβατήριο,2-Ταυτότητα)", "tour00_24p02":"Αριθμός Εγγράφου" }, {}, ..., {} ]

RESPONSE / HTTP response code: 200

Επιτυχής Καταχώρηση

{ "code": 200, "data": { "msg": "Reservation Submitted Successfully", "tour00_20_nr01": "3000375" }, "info": { "recperpage": 9999999999, "page": 0, "totalrec": 0 } }

*Κατεβάστε το JSON για το Postman

RESPONSE / HTTP response code: 401

Ο χρήστης δεν έχει κάνει Log In

{ "code": 401, "data": [ { "error": { "title": "Unauthorized", "detail": "Unauthorized You must be logged in " } } ], "info": "" }

RESPONSE / HTTP response code: 407

Εάν ο χρήστης που έχει κάνει Login ΔΕΝ είναι Tour Operator ή Πωλητής (Μη Εξουσιοδοτημένος Χρήστης)

{ "code": 407, "data": [ { "error": { "title": "Unauthorized User", "detail": "Unauthorized User! This action cannot be completed by an Unauthorized User" } } ], "info": "" }

RESPONSE / HTTP response code: 409

Τα στοιχεία της Κράτησης που έδωσε ο χρήστης δεν είναι έγκυρα.

{ "code": 409, "data": { "msg": "1)Πρέπει να προσθέσετε Επιβάτες!" }, "info": { "recperpage": 9999999999, "page": 0, "totalrec": 0 } }

Ακύρωση Κράτησης

URL: "/hermes_api/tour00/cancel_reservation"

Method: POST REQUEST

Τίτλος	Πεδίο	Τύπος	Μέγεθος
ΜΚ Κράτησης προς Ακύρωση	tour00_20	Νumeric	15

RESPONSE / HTTP response code: 200

Επιτυχής Καταχώρηση

{ "code": 200, "data": { "msg": "Reservation Canceled Successfully", "tour00_20_nr01": "3000375" }, "info": { "recperpage": 9999999999, "page": 0, "totalrec": 0 } }

*Κατεβάστε το JSON για το Postman

RESPONSE / HTTP response code: 401

Ο χρήστης δεν έχει κάνει Log In

{ "code": 401, "data": [ { "error": { "title": "Unauthorized", "detail": "Unauthorized You must be logged in " } } ], "info": "" }

RESPONSE / HTTP response code: 406

Η κράτηση έχει ήδη Ακυρωθεί

{ "code": 406, "data": { "msg": "Reservation already cancelled!" }, "info": { "recperpage": 9999999999, "page": 0, "totalrec": 0 } }

RESPONSE / HTTP response code: 406

Το ΜΚ της Κράτησης προς Ακύρωση δεν είναι έγκυρο.

{ "code": 406, "data": { "msg": "Invalid ID!" }, "info": { "recperpage": 9999999999, "page": 0, "totalrec": 0 } }

RESPONSE / HTTP response code: 407

Εάν ο χρήστης που έχει κάνει Login ΔΕΝ είναι Tour Operator ή Πωλητής (Μη Εξουσιοδοτημένος Χρήστης)

{ "code": 407, "data": [ { "error": { "title": "Unauthorized User", "detail": "Unauthorized User! This action cannot be completed by an Unauthorized User" } } ], "info": "" }

RESPONSE / HTTP response code: 409

Δεν είναι δυνατή η ακύρωση του εισιτηρίου

{ "code": 409, "data": { "msg": "1)Έχετε υπερβεί το Χρόνο που επιτρέπεται η Ακύρωση Eισιτηρίου πριν την έναρξη της εκδρομής (30 λετπά πριν την έναρξη)!" }, "info": { "recperpage": 9999999999, "page": 0, "totalrec": 0 } }