Οι επιλογές γενικής χρήσης είναι χρήσιμες όταν θέλουμε να καλούμε ένα εξωτερικό πρόγραμμα ή σύνδεσμο στέλνοντας δεδομένα από την EMDI.
Πρώτα από όλα φτιάχνουμε την επιλογή που θέλουμε.
Να σημειωθεί ότι μπορείς να επιλέξεις και το εικονίδιο που θέλεις να εμφανίζεται από τα προτεινόμενα.
Στο πεδίο σύνδεσμος βάζουμε την μεταβλητή που μας ενδιαφέρει.
Πχ #SMS
Αν το μήνυμα που θέλουμε να στέλνουμε είναι προκαθορισμένο γράφουμε δίπλα από την μεταβλητή ; και το θέμα πχ ;test
Χρησιμοποιούμε τις παρακάτω μεταβλητές
| #DID | Αριθμός παραστατικού |
| #REL | Σχετικά |
| #CID | Κωδικός πελάτη |
| #CAA | “Aa” βάσης, πελάτη |
| #DAA | “Aa” βάσης, παραστατικού |
| #TPV | Σύνολο προ ΦΠΑ |
| #TOT | Σύνολο |
| #VAT | ΦΠΑ |
| #QUA | Σύνολο ποσότητας |
| #EML | Email πελάτη/προμηθευτή |
| #TEL | Τηλέφωνο πελάτη/προμηθευτή |
| #MOB | Κινητό πελάτη/προμηθευτή |
| #VOU | Voucher |
| #NAM | Επωνυμία |
| #PRO | Προϊόντα παραστατικού |
| #SXO | Σχόλιο παραστατικού |
| #CU1 | Προσαρμοσμένο πεδίο |
| #CU2 | Προσαρμοσμένο πεδίο |
| #CU3 | Προσαρμοσμένο πεδίο |
| #CU4 | Προσαρμοσμένο πεδίο |
| #CU5 | Προσαρμοσμένο πεδίο |
Εντολές
| #SMS | Αποστολή SMS. Μετά από τη μεταβλητή για εκτέλεση αποστολών βάζουμε “;” και τον τίτλο προκαθορισμένου κειμένου sms. | ||
| #EMA | Αποστολή Email. Μετά από τη μεταβλητή για εκτέλεση αποστολών βάζουμε “;” και τον τίτλο προκαθορισμένου κειμένου email. | ||
| #PST | Κλήση POST σε URL. Μετά από τη μεταβλητή βάζουμε τα υπόλοιπα πεδία διαχωρισμένα με “|”. Οι αντιστοιχίσεις είναι οι εξής:
παράδειγμα:
|
Αποστολή παραστατικού στο skroutz
Στην περίπτωση αποστολής παραστατικού στο skroutz, θα χρειαστεί να υπάρχει ο αριθμός παραγγελίας του skroutz σε κάποιο πεδίο, ώστε να μπορεί να εισαχθεί στο παραπάνω url.
- Στην περίπτωση απευθείας γέφυρας μεταξύ του εμπορικού προγράμματος και skroutz, ο αριθμός παραγγελίας skroutz έρχεται αυτόματα στο πεδίο #REL, συνεπώς η διεύθυνση παραπάνω θα ακολουθούσε την παρακάτω δομή:
|
1 |
#PST|https://api.skroutz.gr/merchants/ecommerce/orders/#REL/invoices|invoice_file=#PDF|Authorization:Bearer XXXXXXXXXXXXXXXXXXXX&Accept:application/vnd.skroutz+json; version=3.0|"success":true|one|two |
όπου #REL είναι το πεδίο σχετικού παραστατικού της παραγγελίας και XXXXXXXXXXXXXXXXXXXX το api token από το skroutz merchants (Υπηρεσίες–>Skroutz marketplace).
Το παραπάνω παράδειγμα url ισχύει και στην περίπτωση που ο αριθμός παραγγελίας skroutz υπάρχει μεμονωμένος σε πεδίο.
- Στην περίπτωση που δεν υπάρχει απευθείας γέφυρα μεταξύ του εμπορικού προγράμματος και του skroutz, ο αριθμός παραγγελίας θα πρέπει είτε να έρθει μέσω της γέφυρας μεταξύ εμπορικού και e-shop στο πεδίο των σχολίων της παραγγελίας είτε να καταχωρηθεί χειροκίνητα στο πεδίο των σχολίων της παραγγελίας. Σε αυτή την περίπτωση, το url θα ακολουθήσει την παρακάτω δομή:
|
1 |
#PST|https://api.skroutz.gr/merchants/ecommerce/orders/#SXO/invoices|invoice_file=#PDF|Authorization:Bearer JQVdPni2v8PJSAgV713PIRujjWacb46dFAgar5PwSsPbmjodCVa2lun3pDuwHROIaKIduBMjHV1eFUVxlDezSA==&Accept:application/vnd.skroutz+json; version=3.0|"success":true|| |
όπου #SXO είναι το πεδίο σχολίων της παραγγελίας και προϋπόθεση είναι στο σχόλιο της παραγγελίας να υπάρχει μόνο ο αριθμός παραγγελίας του skroutz.
Εφόσον στο σχόλιο της παραγγελίας υπάρχουν π.χ. και σχόλια πελάτη, θα πρέπει κάπως να απομονώσουμε τον αριθμό παραγγελίας skroutz που θα υφίσταται επίσης στα σχόλια. Σε αυτή την περίπτωση θα χρησιμοποιήσουμε την παρακάτω δομή στο url:
|
1 |
#PST|https://api.skroutz.gr/merchants/ecommerce/orders/#SXO/invoices|invoice_file=#PDF|Authorization:Bearer bkel6PMlY52sBDD6EklODsG6mBJdHSRL5CkZi01VmfApeVbXNsdDRv1LJoGEqtMz4pNi8bPBH1YPlnBeuIk83A==&Accept:application/vnd.skroutz+json; version=3.0|"success":true|:|: |
όπου #SXO είναι το πεδίο σχολίων της παραγγελίας, αλλά στο τέλος του url διαχωρίζουμε τον αριθμό παραγγελίας στα σχόλια με τα δύο : μέσα στα οποία θα πρέπει να βρίσκεται ο αριθμός παραγγελίας.
Παράδειγμα:
|
1 |
ΠΛΗΡΩΜΗ ΜΕ ΑΝΤΙΚΑΤΑΒΟΛΗ - ΑΡΙΘΜΟΣ ΠΑΡΑΓΓΕΛΙΑΣ SKROUTZ :101589: |
όπου ο αριθμός παραγγελίας 101589 βρίσκεται ανάμεσα στα δύο : και μπορεί έτσι να αναγνωριστεί από το εμπορικό πρόγραμμα.
Παραδείγματα
Όταν πατάς το πλήκτρο και έχεις ορίσει ιστοσελίδα τότε η EMDI στέλνει τα σχετικά παραστατικά:
|
1 |
https://www.sbzsystems.com/emdi_open_bridge.php?key=&action=redirect&orderid=#DID&customerid=#CID |
Ενώ αν καλέσεις κάποιο πρόγραμμα στέλνονται 2 πεδία:
- Αριθμός γραμμής παραστατικού
- Αριθμός γραμμής πελάτη
πχ:
|
1 |
C:\projects\EmporikhSQL\text.exe #DID #CID |
Το τι θα καλείται ορίζεται στις ρυθμίσεις->αγορές/πωλήσεις->Πλήκτρο γενικής χρήσης
Τα προϊόντα παραστατικού αποστέλλονται με μορφή
|
1 |
|ΠΕΡΙΓΡΑΦΗ|ΑΞΙΑ\n|ΠΕΡΙΓΡΑΦΗ|ΑΞΙΑ\n|ΠΕΡΙΓΡΑΦΗ|ΑΞΙΑ\n...Σύνολο|ΣΥΝΟΛΙΚΗ ΑΞΙΑ||\n |
Οι επιλογές εμφανίζονται στο παραστατικό των αγορών/πωλήσεων
