Rest API Calls
Γενικό Πλαίσιο REST API Calls
Τα API της Entersoft είναι οργανωμένα γύρω από το REST. Τα API μας έχουν URL προσανατολισμένα σε πόρους, δέχονται σώματα (Body) αιτημάτων με κωδικοποίηση φόρμας, και επιστρέφουν αποκρίσεις με κωδικοποίηση JSON. Τέλος, χρησιμοποιούν τυπικούς κώδικες απόκρισης HTTP και έλεγχο ταυτότητας.
Κλήση μέσω Postman
Σε κάθε request που γίνεται προς την τοποθεσία https://api.entersoft.gr/api/ θα πρέπει να έχετε ορίσει :
- Τον τύπο της κλήσης, ο οποίος είναι POST
σε όλες τις περιπτώσεις.
Το URL, το οποίο είναι της μορφής : https://Πρότυπο:Esapihost/api/eshopconnector/{}
- Για το Live περιβάλλον esapihost: api.entersoft.gr
- Για το TEST δοκιμαστικό περιβάλλον esapihost: eswebapi-next.azurewebsites.net
- Καθώς επίσης τα δεδομένα της κλήσης σε επίπεδο Body, row, τα δεδομένα της κλήσης θα πρέπει να είναι σε μορφή Json.
- Κατόπιν της αγοράς του Entersoft Connector for Softone Sales Suite από το Cloud Store της Entersoft.
- Δημιουργείστε το κλειδί σύνδεσης Header API key, το οποίο μπορείτε είτε να αντιγράψετε και να το αποθηκεύσετε για ασφάλεια.
Σας δίνεται επίσης και το Header Api name
Header name: X-ESAPIKEY-S1SALESUITE
Header value: bd9*****-****-b743-****-************,********-****-****-****-************,*******7796
Το κλειδί αυθεντικοποίησης των κλήσεων Authorization key Header API key (X-ESAPIKEY-S1SALESUITE) και header Api value , μπορείτε να το δηλώσετε σε επίπεδο Header μέσα στο collection και να ορίσετε στον τύπο αυθεντικοποίησης <<API Key>>, έτσι ώστε να μην το προσθέτετε κάθε φορά σε όλα τα requests, όπως εμφανίζεται στις εικόνες 1 και 2 παρακάτω. Οι εικόνες είναι με χρήση του εργαλείου Postman.
Ορισμός τύπου Authorization
Αυτόματα ορίζεται το Api key και το Value στο header
Στις κλήσεις που απαιτούνται παράμετροι στο body, υπάρχει πίνακας με τα πεδία που απαιτούνται Υποχρεωτικά (Υ) και Προαιρετικά (Π) . Σε όλες τις παραμέτρους που αναφέρεται η παράμετρος page No, αφορά τον αριθμό της σελίδας. Σε όλες τις κλήσεις που πραγματοποιείται το μέγιστο πλήθος γραμμών στα responses ανά σελίδα είναι 200 (γραμμές), επομένως αν το Rows counts στην επιστρεφόμενη κλήση είναι 250, αυτό σημαίνει ότι πρέπει να επαναλάβετε την κλήση με page No = 2 .
EndPoints
Στη συνέχεια θα παρουσιάσουμε τις κλήσεις που μπορείτε να πραγματοποιήσετε έτσι ώστε να ανταλλάσσετε πληροφορίες με την εφαρμογή Entersoft Bussines Suite. Ένα σύνολο από αυτές θα αναλυθούν ενδεικτικά στην επόμενη ενότητα.
| Service | Τύπος | EndPoint |
|---|---|---|
| Είδη και αποθέματα | ||
| Products | POST | api/eshopconnector/Products |
| ProductColors | POST | api/eshopconnector/ProductColors |
| ProductSizes | POST | api/eshopconnector/ProductsProductSizes |
| Colors | POST | api/eshopconnector/Colors |
| Sizes | POST | api/eshopconnector/Sizes |
| Categories | POST | api/eshopconnector/Categories |
| SubCategories | POST | api/eshopconnector/SubCategories |
| Families | POST | api/eshopconnector/Families |
| SubFamilies | POST | api/eshopconnector/SubFamilies |
| Mus | POST | api/eshopconnector/Mus |
| ProductsStock | POST | /api/eshopconnector/ProductsStock |
| Πελάτες | ||
| UpsertTradeAccount | UpsertTradeAccount | |
| Customers | POST | api/eshopconnector/Customers |
| CustomersAdditionalSites | POST | api/eshopconnector/CustomersAdditionalSites |
| CustomerCategories | POST | api/eshopconnector/CustomerCategories |
| CustomerFamilies | POST | api/eshopconnector/CustomerFamilies |
| CustomerGroups | POST | api/eshopconnector/CustomerGroups |
| CustomerLedger | POST | api/eshopconnector/CustomerLedger |
| Πίνακες συναλλαγών | ||
| ShippingMethods | POST | api/eshopconnector/ShippingMethods |
| PaymentMethods | POST | api/eshopconnector/PaymentMethods |
| SpecialAccountandTaxes | POST | api/eshopconnector/SpecialAccountsAndTaxes |
| Contracts | POST | api/eshopconnector/Contracts |
| UpsertTradeAccountContract | api/eshopconnector/UpsertTradeAccountContract | |
| DocumentSeries | api/eshopconnector/DocumentSeries | |
| Παραστατικά | ||
| SubmitOrUpdateOrder | POST | api/eshopconnector/SubmitOrUpdateOrder |
| SaveAndIssueDocument | POST | api/eshopconnector/SaveAndIssueDocument |
| CancelOrder | POST | api/eshopconnector/CancelOrder |
| OrderStatus | POST | api/eshopconnector/OrderStatus |
Για να ξεκινήσετε γρήγορα με τα Entersoft API, μπορείτε να χρησιμοποιήσετε το Entersoft Workspace στο Postman. Η συλλογή περιλαμβάνει ενδεικτικά, μεγάλο μέρος των κλήσεων που απαιτούνται για τη διασύνδεση.
Entersoft Bussines Suite Collection
Στο Entersoft Bussines Suite Collection , διατίθενται παραδείγματα κλήσεων καθώς επίσης και σημειώσεις για την κάθε μέθοδο.
Για να λάβετε το αρχείο πατήστε εδώ.
Services
Products
/eshopconnector/Products(POST):
Με την κλήση Products λαμβάνετε τα είδη από την εφαρμογή Entersoft Bussines Suite (EBS).
Οι Παράμετροι που χρειάζονται για την κλήση είναι:
Παράμετροι:
| Πεδίο | Τύπος | Περιγραφή | Υποχρεωτικό | |
|---|---|---|---|---|
| ChangedSinceTS | string | Έχουν λάβει αλλαγή από την ημερομηνία/ώρα και έπειτα | ΝΑΙ | |
| aExpandProductColorSize | boolean | Αν η παράμετρος είναι true σας επιστρέφει τους κωδικούς των χρωμάτων και των μεγεθών των ειδών. Σε διαφορετική περίπτωση το παραλείπετε ή το αποστέλλετε κενό. | ΟΧΙ | |
| Code | string | Κωδικός | ΟΧΙ | |
| Description | string | Περιγραφή | ΟΧΙ | |
| Family | string | Οικογένεια | ΟΧΙ | |
| SubFamily | string | Ομάδα | ΟΧΙ | |
| Category | string | Κατηγορία | ΟΧΙ | |
| SubCategory | string | Υποκατηγορία | ΟΧΙ | |
| PageNo | integer | Αφορά τον αριθμό σελίδων. Επειδή σε κάθε κλήση products τα δεδομένα που λαμβάνετε έχουν ως όριο το πλήθος των 500 εγγραφών ανά σελίδα, προκειμένου να λάβετε τα επόμενα είδη θα πρέπει να χρησιμοποιήσετε την παράμετρο PageNo ώστε να λάβετε το επόμενο πακέτο ειδών. | ΟΧΙ | |
Παράδειγμα στοιχείων εισαγωγής:
{
"ChangedSinceTS": "2022-10-30T09:32:13.188Z",
"Code": "string",
"Description": "string",
"Family": "string",
"SubFamily": "string",
"Category": "string",
"SubCategory": "string",
"ExpandProductColorSize": true,
"PageNo": 0
}
Απάντηση Κλήσης:
Παράδειγμα Απάντησης Κλήσης:
{
"PagingInfo": {
"Page": 1,
"PageSize": 200,
"WithCount": true
},
"RowsCount": 1,
"ResponseTime": "2023-11-03T11:29:11.6028161Z",
"SrvRoundTripms": 128,
"Totalms": 132,
"Data": [
{
"GID": "9d00d2e4-94ef-4b50-9fc1-32ad74da13fb",
"Code": "ΑΠ000165",
"AlternativeCode": "10.64.558.139",
"Barcode": "10.64.558.139",
"Description": "ΚΑΜΕΡΑ DAHUA CVI 2 Mp DOME HAC-HDW1200M",
"Family": "01",
"RetailPrice": 45.0000000000,
"WholesalePrice": 36.2900000000,
"DiscountPRC": 0.0000000000,
"VatPRC": 24.0000000000,
"BasicMUCode": "ΤΕΜ",
"SizeSet": "36-42",
"ProductSizes": [
{
"Code": "42",
"Description": "42"
},
{
"Code": "40",
"Description": "40"
},
{
"Code": "38",
"Description": "38"
},
{
"Code": "36",
"Description": "36"
}
],
"ColorSet": "ΑΠ000165",
"ProductColors": [
{
"Code": "GR",
"Description": "ΠΡΑΣΙΝΟ",
"AlternativeDescription": "GREEN"
},
{
"Code": "RE",
"Description": "ΚΟΚΚΙΝΟ",
"AlternativeDescription": "RED"
},
{
"Code": "RT",
"Description": "Ροδακινι",
"AlternativeDescription": "#ffA500"
}
],
"Weight": 0.0,
"Stock": 0,
"LastModifiedDate": "2023-11-03T13:04:57.643"
}
]
}
Στοιχεία που επιστρέφονται:
| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
| GID | string | Μοναδικό κλειδί του είδους στη βάση |
| LastModifiedDate | Ημερομηνία και ώρα τελευταίας τροποποίησης | |
| Code | string | Κωδικός του είδους |
| AlternativeCode | string | Εναλλακτικός κωδικός |
| Barcode | string | Barcode |
| Description | string | Περιγραφή |
| AlternativeDescription | string | Εναλλακτική Περιγραφή |
| LongDescription | string | N/A |
| ImageURL | string | N/A |
| Family | string | Οικογένεια |
| SubFamily | string | Ομάδα |
| Category | string | Κατηγορία |
| SubCtegory | string | Υποκατηγορία |
| RetailPrice | Τιμή Λιανικής | |
| WholesalePrice | Τιμή Χονδρικής | |
| DiscountPRC | Έκπτωση | |
| VatPRC | Φ.Π.Α. | |
| Manufacturer | string | N/A |
| BasicMUCode | string | Μονάδα Μέτρησης |
| SizeSet | string | |
| ColorSet | string | Χρώμα |
| Weight | number | Βάρος |
| Stock | integer | Υπόλοιπο |
OrderStatus
/eshopconnector/OrderStatus(POST):
Λαμβάνετε, πληροφόρηση για παραστατικά καταχωρημένα στην εφαρμογή QuickBiz. Σημαντικό είναι ότι από την εκτέλεση της κλήσης μπορείτε να λάβετε, πεδία όπως MARK, UID, Επωνυμία Παρόχου ΗΛ.Τιμολόγησης, Authentication Key, url παραστατικού, όπως τηρούνται στο πάροχο ηλεκτρονικής τιμολόγησης, καθώς και url του mydata αν χρησιμοποιείται την άμεση διαβίβαση και όχι τον πάροχο ηλεκτρονικής τιμολόγησης.
Παράμετροι που απαιτούνται:
| Πεδίο | Τύπος | Περιγραφή | Υποχρεωτικότητα |
|---|---|---|---|
| SearchCode | string | Κωδικός παραγγελίας | Υ |
| PageNo | integer | Αριθμός σελίδων | Π |
Παράδειγμα Κλήσης:
{
"SearchCode": "string",
"PageNo": 0
}
Απάντηση Κλήσης:
Παράδειγμα Απάντησης Κλήσης:
{
"PagingInfo": {
"Page": 0,
"PageSize": 0,
"WithCount": true
},
"RowsCount": 0,
"ResponseTime": "2023-10-29T17:39:42.812Z",
"SrvRoundTripms": 0,
"Totalms": 0,
"Data": [
{
"GID": "string",
"TagId": 0,
"Tag": "string",
"PayableAmountWithoutDiscounts": 0,
"AltDocCode": "string",
"TransportCostValue": 0,
"fTransportPlanGID": "string",
"ESDCreated": "2023-10-29T17:39:42.812Z",
"ESDModified": "2023-10-29T17:39:42.812Z",
"ESUCreated": "string",
"ESUModified": "string",
"fDocTypeGID": "string",
"fDocSerieGID": "string",
"fShippingMethodCode": "string",
"fPaymentMethodGID": "string",
"DocCode": "string",
"fTradeAccountGID": "string",
"TradeAccountType": "Customer",
"TradeAccountSearchOptions": 0,
"TradeAccountCode": "string",
"TradeAccountName": "string",
"fTradeAccountSiteGID": "string",
"fDeliverySiteGID": "string",
"PaymentAmount": 0,
"NetValue": 0,
"ChargesValue": 0,
"TaxesValue": 0,
"VatValue": 0,
"TotalValue": 0,
"DiscountsValue": 0,
"DeductionsValue": 0,
"PayableAmount": 0,
"Comments": "string",
"fSalesPersonGID": "string",
"fActivityCode": "string",
"fBusinessUnitCode": "string",
"fDimension1Code": "string",
"fDimension2Code": "string",
"DeliveryDate": "2023-10-29T17:39:42.812Z",
"UDFString1": "string",
"UDFString2": "string",
"UDFString3": "string",
"UDFString4": "string",
"UDFString5": "string",
"UDFValue1": 0,
"UDFValue2": 0,
"UDFValue3": 0,
"UDFValue4": 0,
"UDFValue5": 0,
"UDFDate1": "2023-10-29T17:39:42.812Z",
"UDFDate2": "2023-10-29T17:39:42.812Z",
"UDFDate3": "2023-10-29T17:39:42.812Z",
"UDFDate4": "2023-10-29T17:39:42.812Z",
"UDFDate5": "2023-10-29T17:39:42.812Z",
"UDFFlag1": true,
"UDFFlag2": true,
"UDFFlag3": true,
"UDFFlag4": true,
"UDFFlag5": true,
"fUDF1Code": "string",
"fUDF2Code": "string",
"fUDF3Code": "string",
"fUDF4Code": "string",
"fUDF5Code": "string"
}
]
}
Families
/eshopconnector/Families(POST):
Σας επιστρέφει τις οικογένειες των ειδών.
Παράμετροι που απαιτούνται:
Δεν απαιτούνται παράμετροι.
Στοιχεία Απάντησης Κλήσης:
| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
| Page | integer | Σελίδα |
| PageSize | integer | Μέγεθος σελίδας |
| WithCount | boolean | |
| RowsCount | integer | Πλήθος Γραμμών |
| ResponseTime | datetime | Χρόνος απόκρισης |
| SrvRoundTripms | integer | |
| Totallms | integer | |
| Code | string | Κωδικός Μεγέθους |
| Description | string | Περιγραφή Μεγέθους |
| InActive | boolean | Κατάσταση |
| IsWeb | boolean | Υποδεικνύει αν είναι για το web |
Παράδειγμα Απάντησης Κλήσης:
{
"PagingInfo": {
"Page": -1,
"PageSize": -1,
"WithCount": true
},
"RowsCount": 2,
"ResponseTime": "2023-10-30T11:36:22.6227759Z",
"SrvRoundTripms": 29,
"Totalms": 262,
"Data": [
{
"Code": "01",
"Description": "ΤΕΣΤ09072023",
"InActive": false,
"IsWeb": false,
"TS": "AAAAAAABE1M="
},
{
"Code": "02",
"Description": "Οικογένεια",
"InActive": false,
"IsWeb": false,
"TS": "AAAAAAACG3M="
}
]
}
SubFamilies
/eshopconnector/SubFamilies(POST):
Σας επιστρέφει τις ομάδες των ειδών.
Παράμετροι που απαιτούνται:
Δεν απαιτούνται παράμετροι.
Στοιχεία Απάντησης Κλήσης:
| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
| Page | integer | Σελίδα |
| PageSize | integer | Μέγεθος σελίδας |
| WithCount | boolean | |
| RowsCount | integer | Πλήθος γραμμών |
| ResponseTime | datetime | Χρόνος απόκρισης |
| SrvRoundTripms | integer | |
| Totallms | integer | |
| Code | string | Κωδικός Ομάδας |
| Description | string | Περιγραφή Ομάδας |
| InActive | boolean | Κατάσταση |
| IsWeb | boolean | Υποδεικνύει αν είναι για το web |
Παράδειγμα Απάντησης Κλήσης:
{
"PagingInfo": {
"Page": -1,
"PageSize": -1,
"WithCount": true
},
"RowsCount": 1,
"ResponseTime": "2023-10-31T07:43:57.014603Z",
"SrvRoundTripms": 34,
"Totalms": 36,
"Data": [
{
"Code": "01",
"Description": "Ομάδα",
"InActive": false,
"IsWeb": false,
"TS": "AAAAAAACG3I="
}
]
}
Categories:
/eshopconnector/Categories(POST):
Σας επιστρέφει τις ομάδες των ειδών.
Παράμετροι που απαιτούνται:
Δεν απαιτούνται παράμετροι.
Στοιχεία Απάντησης Κλήσης:
| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
| Page | integer | Σελίδα |
| PageSize | integer | Μέγεθος σελίδας |
| WithCount | boolean | |
| RowsCount | integer | Πλήθος Γραμμών |
| ResponseTime | datetime | Χρόνος απόκρισης |
| SrvRoundTripms | integer | |
| Totallms | integer | |
| Code | string | Κωδικός Κατηγορίας |
| Description | string | Περιγραφή Κατηγορίας |
| InActive | boolean | Κατάσταση |
| IsWeb | boolean | Υποδεικνύει αν είναι για το web |
Παράδειγμα Απάντησης Κλήσης:
{
"PagingInfo": {
"Page": -1,
"PageSize": -1,
"WithCount": true
},
"RowsCount": 2,
"ResponseTime": "2023-10-30T11:38:51.1716534Z",
"SrvRoundTripms": 22,
"Totalms": 23,
"Data": [
{
"Code": "Cat1",
"Description": "Cat1",
"InActive": false,
"IsWeb": false,
"TS": "AAAAAAAAHpI="
},
{
"Code": "1",
"Description": "Κατηγορία",
"InActive": false,
"IsWeb": false,
"TS": "AAAAAAACG3Q="
}
]
}
Mus
/eshopconnector/Mus(POST):
Σας επιστρέφει τις μονάδες μέτρησης των ειδών.
Παράμετροι που απαιτούνται:
Δεν απαιτούνται παράμετροι.
Στοιχεία Απάντησης Κλήσης:
| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
| Page | integer | Σελίδα |
| PageSize | integer | Μέγεθος σελίδας |
| WithCount | boolean | Πλήθος Γραμμών |
| RowsCount | integer | |
| ResponseTime | datetime | Χρόνος απόκρισης |
| SrvRoundTripms | integer | |
| Totallms | integer | |
| Code | string | Κωδικός Μονάδας Μέτρησης |
| Description | string | Περιγραφή Μονάδας Μέτρησης |
| InActive | boolean | Κατάσταση |
Παράδειγμα Απάντησης Κλήσης:
{
"PagingInfo": {
"Page": -1,
"PageSize": -1,
"WithCount": true
},
"RowsCount": 41,
"ResponseTime": "2023-10-31T07:46:39.9184921Z",
"SrvRoundTripms": 54,
"Totalms": 70,
"Data": [
{
"Code": "001",
"Description": "Μονάδες",
"InActive": false,
"TS": "AAAAAAAAK/s="
},
{
"Code": "1 000 kWh",
"Description": "Χίλιες κιλοβατώρες",
"AlternativeDescription": "1 000 kWh",
"InActive": true,
"TS": "AAAAAAAAK/w="
},
{
"Code": "1 000 l",
"Description": "χίλια Λίτρα",
"AlternativeDescription": "1 000 l",
"InActive": true,
"TS": "AAAAAAAAK/0="
}
]
}
PaymentMethods
/eshopconnector/PaymentMethods(POST):
Λαμβάνετε τους τρόπους πληρωμής.
Παράμετροι που απαιτούνται:
| Πεδίο | Τύπος | Περιγραφή | Υποχρεωτικό |
|---|---|---|---|
| RequestParams | string | ΝΑΙ | |
| PageNo | integer | Αριθμός σελίδων | ΟΧΙ |
Παράδειγμα Κλήσης:
{
"RequestParams": {},
"PageNo": 0
}
Στοιχεία Απάντησης Κλήσης:
| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
| Page | integer | Σελίδα |
| PageSize | integer | Μέγεθος σελίδας |
| WithCount | boolean | Πλήθος Γραμμών |
| RowsCount | integer | |
| ResponseTime | datetime | Χρόνος απόκρισης |
| SrvRoundTripms | integer | |
| Totallms | integer | |
| Code | string | Κωδικός Τρόπου Πληρωμής |
| Description | string | Περιγραφή Τρόπου Πληρωμής |
| InActive | boolean | Κατάσταση |
Παράδειγμα απάντησης Κλήσης:
{
"PagingInfo": {
"Page": -1,
"PageSize": -1,
"WithCount": true
},
"RowsCount": 21,
"ResponseTime": "2023-10-31T07:26:21.5395944Z",
"SrvRoundTripms": 25,
"Totalms": 582,
"Data": [
{
"GID": "6f680464-84ff-49d4-8998-20b28485f90a",
"Code": "0004",
"Description": "Επι Πιστώσει (βάσει ημερών πίστωσης του συναλλασσόμενου)",
"InActive": false,
"TS": "AAAAAAAAHoA="
},
{
"GID": "7e648181-465a-4023-a30d-a49d02875971",
"Code": "0002",
"Description": "Επι Πιστώσει (45 ημερών)",
"InActive": false,
"TS": "AAAAAAAAHoU="
},
{
"GID": "dcfa0ccb-e345-4fc5-8e3f-c6b3c87755f0",
"Code": "0001",
"Description": "Μετρητοίς",
"InActive": false,
"TS": "AAAAAAAAHog="
}
]
}
ShippingMethods
/eshopconnector/ShippingMethods(POST):
Λαμβάνετε τους Τρόπους Αποστολής.
Παράμετροι που απαιτούνται:
| Πεδίο | Τύπος | Περιγραφή | Υποχρεωτικό |
|---|---|---|---|
| RequestParams | string | ΝΑΙ | |
| PageNo | integer | Αριθμός σελίδων | ΟΧΙ |
Παράδειγμα Κλήσης:
{
"RequestParams": {},
"PageNo": 0
}
Στοιχεία Απάντησης Κλήσης:
| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
| Page | integer | Σελίδα |
| PageSize | integer | Μέγεθος σελίδας |
| WithCount | boolean | Πλήθος Γραμμών |
| RowsCount | integer | |
| ResponseTime | datetime | Χρόνος απόκρισης |
| SrvRoundTripms | integer | |
| Totallms | integer | |
| Code | string | Κωδικός Τρόπου Αποστολής |
| Description | string | Περιγραφή Τρόπου Αποστολής |
| InActive | boolean | Κατάσταση |
Παράδειγμα Απάντησης Κλήσης:
{
"PagingInfo": {
"Page": -1,
"PageSize": -1,
"WithCount": true
},
"RowsCount": 8,
"ResponseTime": "2023-10-30T09:48:13.3192861Z",
"SrvRoundTripms": 28,
"Totalms": 29,
"Data": [
{
"Code": "CC",
"Description": "Εταιρία μεταφορών",
"InActive": false,
"TS": "AAAAAAAAHqY="
},
{
"Code": "COURIER",
"Description": "Ταχυδρομείο",
"InActive": false,
"TS": "AAAAAAAAHqc="
},
]
}
SpecialAccountsAndTaxes
/eshopconnector/SpecialAccountsAndTaxes(POST):
Λαμβάνετε τους Φόρους, Κρατήσεις, Παρακρατήσεις, Επιβαρύνσεις.
Παράμετροι που απαιτούνται:
| Πεδίο | Τύπος | Περιγραφή | Υποχρεωτικό |
|---|---|---|---|
| RequestParams | string | ΝΑΙ | |
| PageNo | integer | Αριθμός σελίδων | ΟΧΙ |
Παράδειγμα Κλήσης:
{
"RequestParams": {},
"PageNo": 0
}
Στοιχεία Απάντησης Κλήσης:
| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
| Page | integer | Σελίδα |
| PageSize | integer | Μέγεθος σελίδας |
| WithCount | boolean | Πλήθος Γραμμών |
| RowsCount | integer | |
| ResponseTime | datetime | Χρόνος απόκρισης |
| SrvRoundTripms | integer | |
| Totallms | integer | |
| Code | String | Κωδικός Ειδικού Λογαριασμού |
| Description | string | Περιγραφή Ειδικού Λογαριασμού |
| InActive | boolean | Κατάσταση |
Παράδειγμα Απάντησης Κλήσης:
{
"PagingInfo": {
"Page": -1,
"PageSize": -1,
"WithCount": true
},
"RowsCount": 16,
"ResponseTime": "2023-10-30T09:49:17.4145375Z",
"SrvRoundTripms": 27,
"Totalms": 27,
"Data": [
{
"GID": "43ea5f48-50f5-4846-a8a9-cfe4185129a8",
"Code": "003",
"Description": "Προκαταβληταίος φόρος δικηγόρων 15%",
"InActive": false
},
{
"GID": "93b79e0f-3f57-4f68-9e3a-6fa8eb079ec4",
"Code": "01",
"Description": "Παρακράτηση 8 %",
"InActive": false
},
}
SubmitOrUpdateOrder
/eshopconnector/SubmitOrUpdateOrder(POST):
Η κλήση SubmitOrUpdateOrder χρησιμέυει στην δημιουργία και αποθήκευση παραστατικού. Μπορείτε να δημιουργήσετε μια νέα παραγγελία
Παράμετροι που απαιτούνται:
Για να ενημερωθείτε σχετικά με όλα τα πεδία που μπορείτε να χρησιμοποιήσετε, επισκεφτείτε το swagger της Entersoft https://eswebapi-next.azurewebsites.net/swagger/ui/index , όπου μπορείτε να αναζητήσετε με τη λέξη κλειδί eshopconnector όλες τις κλήσεις σχετικά με τη διασύνδεση του e-shop, καθώς επίσης με τα διαθέσιμα πεδία.
Οι ελάχιστοι παράμετροι, προκειμένου να πραγματοποιήσετε επιτυχώς μια κλήση API της μορφής SubmitOrUpdateOrders, αναφέρονται στον πίνακα παρακάτω:
| Πεδίο | Τύπος | Περιγραφή | Υποχρεωτικό |
|---|---|---|---|
| fDocTypeGID | string | Κωδικός Παραστατικού (ο τύπος παραστατικού π.χ. ΠΑΡ για παραγγελία) | ΝΑΙ |
| fDocSerieGID | string | Η σειρά που ανήκει το παραστατικό | ΝΑΙ |
| fBusinessUnitCode | string | Υποχρεωτική τιμή “Eshop” | ΝΑΙ |
| fTradeAccountGID | string | Ο κωδικός συναλλασσόμενου | ΝΑΙ |
| fShippingMethodCode | string | Ο κωδικός του τρόπου αποστολής όπως τηρείται στην εφαρμογή | ΟΧΙ |
| fTransitionStepCode | string | Ο κωδικός του βήματος εξέλιξης | ΝΑΙ |
| fPaymentMethodGID | string | Ο κωδικός του τρόπου πληρωμής όπως τηρείται στην εφαρμογή (κωδικοί 1000 για αντικαταβολή, 1001 για PayPal, 1002 για Πιστωτική Κάρτα, 1003 για Τραπεζική Κατάθεση) | ΝΑΙ |
| LineCreditCardPayments | Χρησιμοποιείται μόνο για τους τρόπους πληρωμής (1001,1002). Αλλιώς ο κόμβος παραλείπεται. Αφορά τρόπους πληρωμής με Πιστωτικές κάρτες. | ΝΑΙ | |
| fCashAccountGID | string | Χρησιμοποιείται μόνο για τους τρόπους πληρωμής (1001,1002). Αλλιώς ο κόμβος παραλείπεται. Αφορά τον χρηματικό λογαριασμό του εκάστοτε τρόπου πληρωμής. | ΝΑΙ |
| fColorCode | string | Κωδικός χρώματος | ΟΧΙ |
| fSizeCode | string | Κωδικός μεγέθους | ΟΧΙ |
| TotalValue | integer | Συνολική αξία γραμμής | ΝΑΙ |
| SearchCode | string | Κωδικός αναζήτησης του είδους, μπορείτε να χρησιμοποιήσετε και το barcode | ΝΑΙ |
| Quantity | integer | Ποσότητα είδους | ΝΑΙ |
| Price | integer | Τιμή είδους | ΟΧΙ |
| PriceIncludedVat | boolean | Αν η Τιμή περιλαμβάνει Φ.Π.Α. | ΟΧΙ |
| UDFString1 | String | Οριζόμενο πεδίο σχολίου | ΟΧΙ |
| UDFString2 | String | Οριζόμενο πεδίο σχολίου | ΟΧΙ |
| UDFString3 | String | Οριζόμενο πεδίο σχολίου | ΟΧΙ |
| UDFString4 | String | Οριζόμενο πεδίο σχολίου | ΟΧΙ |
| UDFString5 | String | Οριζόμενο πεδίο σχολίου | ΟΧΙ |
| UDFValue1 | Decimal | Οριζόμενο πεδίο τιμής | ΟΧΙ |
| UDFValue2 | Decimal | Οριζόμενο πεδίο τιμής | ΟΧΙ |
| UDFValue3 | Decimal | Οριζόμενο πεδίο τιμής | ΟΧΙ |
| UDFValue4 | Decimal | Οριζόμενο πεδίο τιμής | ΟΧΙ |
| UDFValue5 | Decimal | Οριζόμενο πεδίο τιμής | ΟΧΙ |
| UDFDate1 | Date | Οριζόμενο πεδίο ημερομηνίας | ΟΧΙ |
| UDFDate2 | Date | Οριζόμενο πεδίο ημερομηνίας | ΟΧΙ |
| UDFDate3 | Date | Οριζόμενο πεδίο ημερομηνίας | ΟΧΙ |
| UDFDate4 | Date | Οριζόμενο πεδίο ημερομηνίας | ΟΧΙ |
| UDFDate5 | Date | Οριζόμενο πεδίο ημερομηνίας | ΟΧΙ |
| UDFFlag1 | Boolean | Οριζόμενο πεδίο σήμανσης λαμβάνει την τιμή true | ΟΧΙ |
| UDFFlag2 | Boolean | Οριζόμενο πεδίο σήμανσης λαμβάνει την τιμή true | ΟΧΙ |
| UDFFlag3 | Boolean | Οριζόμενο πεδίο σήμανσης λαμβάνει την τιμή true | ΟΧΙ |
| UDFFlag4 | Boolean | Οριζόμενο πεδίο σήμανσης λαμβάνει την τιμή true | ΟΧΙ |
| UDFFlag5 | Boolean | Οριζόμενο πεδίο σήμανσης λαμβάνει την τιμή true | ΟΧΙ |
| fUDF1Code | String | Οριζόμενο πεδίο πίνακα | ΟΧΙ |
| fUDF2Code | String | Οριζόμενο πεδίο πίνακα | ΟΧΙ |
| fUDF3Code | String | Οριζόμενο πεδίο πίνακα | ΟΧΙ |
| fUDF4Code | String | Οριζόμενο πεδίο πίνακα | ΟΧΙ |
| fUDF5Code | String | Οριζόμενο πεδίο πίνακα | ΟΧΙ |
Παράδειγμα Κλήσης:
{
"Header": {
"fDocTypeGID": "ΠΑΡ",
"fDocSerieGID": "D",
"fTradeAccountGID": "ΠΛ001029",
"fShippingMethodCode": "COURIER",
"fPaymentMethodGID": "1002",
"fBusinessUnitCode": "Eshop",
"fTransitionStepCode": "Ελήφθη ΤΔΑ"
},
"LineItems": [
{
"SearchCode": "52056962321",
"Quantity": 2,
"Price": 100,
"fColorCode": "BR",
"fSizeCode": "36",
"TotalValue": 260.00,
"PriceIncludedVat": true
}
],
"LineCreditCardPayments":
[
{
"fCashAccountGID":"G-3",
"Amount": 260.00
}
]
}
Στοιχεία Απάντησης Κλήσης:
Για να ενημερωθείτε σχετικά με όλα τα πεδία που θα λάβετε από την κλήση, επισκεφτείτε το swagger της Entersoft
https://eswebapi-next.azurewebsites.net/swagger/ui/index , όπου μπορείτε να αναζητήσετε με τη λέξη κλειδί eshopconnector όλες τις κλήσεις σχετικά με τη διασύνδεση του e-shop, καθώς επίσης με τα διαθέσιμα πεδία.
Παράδειγμα Απάντησης Κλήσης:
{
"Header": {
"GID": "9d873281-13db-42c4-bc37-dfb39d401450",
"TransportCostValue": 0.0,
"ESDCreated": "2023-10-31T10:07:02",
"ESUCreated": "ADMIN",
"fDocTypeGID": "a154f21f-e652-492c-aa77-f82764fa8131",
"fDocSerieGID": "fcda7f35-cd8c-4963-9458-6ce5bdf7c664",
"fShippingMethodCode": "COURIER",
"fPaymentMethodGID": "dcfa0ccb-e345-4fc5-8e3f-c6b3c87755f0",
"DocCode": "ΠΑΡ-Α-59-00022",
"fTradeAccountGID": "ec82f2cf-237e-437a-bc3e-c9608c754eee",
"TradeAccountType": 0,
"TradeAccountCode": "ΠΛ000017",
"TradeAccountName": "Test AE",
"fTradeAccountSiteGID": "17e9b204-d438-4deb-b341-9f093d950894",
"fDeliverySiteGID": "17e9b204-d438-4deb-b341-9f093d950894",
"PaymentAmount": 0.0,
"NetValue": 8.06,
"ChargesValue": 0.0,
"TaxesValue": 0.0,
"VatValue": 1.94,
"TotalValue": 10.00,
"DiscountsValue": 0.0,
"DeductionsValue": 0.0,
"PayableAmount": 10.00,
"fSalesPersonGID": "bfb25276-4d60-4b7e-bf6c-ff065dd7b462",
"DeliveryDate": "2023-10-31T10:07:00",
"UDFValue1": 0.0,
"UDFValue2": 0.0,
"UDFValue3": 0.0,
"UDFValue4": 0.0,
"UDFValue5": 0.0,
"UDFFlag1": false,
"UDFFlag2": false,
"UDFFlag3": false,
"UDFFlag4": false,
"UDFFlag5": false
},
"LineItems": [
{
"GID": "3438e3d0-7357-45c2-80df-97b865d17747",
"fItemGID": "a095102e-d47e-42b7-bcdf-02ff4c54cf64",
"ItemClass": 1,
"ItemCode": "8887785696",
"ItemDescription": "Product 1 Eshop",
"fItemMUGID": "314d8c8a-c7a9-4f01-8cb5-034168ffcbef",
"ItemMUCode": "ΤΕΜ",
"ItemMUDescription": "Αριθμός τεμαχίων",
"ItemMUSymbol": "Τεμ",
"fColorCode": "BR",
"fSizeCode": "36",
"Quantity": 1.0,
"Price": 10.00,
"PriceIncludedVat": true,
"BaseValue": 8.06,
"Discount1": 0.025,
"Discount1Value": 0.00200,
"Discount2": 0.000,
"Discount2Value": 0.00000,
"Discount3": 0.0,
"Discount3Value": 0.00,
"Discount4": 0.0,
"Discount4Value": 0.0,
"DiscountsValue": 0.00,
"ChargesValue": 0.0,
"TaxesValue": 0.0,
"NetValue": 8.06,
"VatValue": 1.94,
"TotalValue": 10.00,
"GrossDiscount": 0.0,
"GrossDiscountValue": 0.0,
"LineCharacteristics": 0,
"fSalesPersonGID": "bfb25276-4d60-4b7e-bf6c-ff065dd7b462",
"fActivityCode": "1",
"DeliveryDate": "2023-10-31T10:07:00",
"UDFValue1": 0.0000,
"UDFValue2": 0.0000,
"UDFValue3": 0.0,
"UDFValue4": 0.0,
"UDFValue5": 0.0
}
],
"LOD": 0
}
UpsertTradeAccount
/eshopconnector/UpsertTradeAccount(POST):
Δημιουργία νέου πελάτη.
Παράμετροι που απαιτούνται:
Για να ενημερωθείτε σχετικά με όλα τα πεδία που μπορείτε να χρησιμοποιήσετε, επισκεφτείτε το swagger της Entersoft https://eswebapi-next.azurewebsites.net/swagger/ui/index όπου μπορείτε να αναζητήσετε με τη λέξη κλειδί eshopconnector όλες τις κλήσεις σχετικά με τη διασύνδεση του e-shop, καθώς επίσης με τα διαθέσιμα πεδία. Να επισημάνουμε σε αυτό το σημείο ότι θα πρέπει να χρησιμοποιηθεί η παράμετρος fBusinessUnitCode με τιμή “Eshop”. Ο έλεγχος για το αν ένας πελάτης είναι ήδη ανοιγμένος γίνεται με βάση το email αν δεν υπάρχει ΑΦΜ, αν υπάρχει ΑΦΜ τότε ο έλεγχος γίνεται με βάση αυτό. Επομένως δεν δημιουργείται νέος πελάτης ωστόσο γίνεται η όποια ενημέρωση επιθυμεί ο χρήστης.
| Πεδίο | Τύπος | Περιγραφή | Υποχρεωτικό |
|---|---|---|---|
| "TradeAccountType": | Επιλέγετε πάντα 0 | ΝΑΙ | |
| "TaxRegistrationNumber": | string | ΑΦΜ πελάτη | ΝΑΙ |
| "GID": | string | Μοναδικός Κωδικός πελάτη | ΟΧΙ |
| "fEInvoiceProfileGID" | string | Πρέπει να λαμβάνει την τιμή (pdf-P0-emai) | ΝΑΙ |
| "Code": | string | Κωδικός Πελάτη | ΝΑΙ |
| "AlterantiveCode" | Εναλλακτικός Κωδικός Πελάτη | ΟΧΙ | |
| "Name": | string | Επωνυμία Επιχείρησης | ΝΑΙ |
| "FirstName": | string | Όνομα Πελάτη | ΝΑΙ |
| "LastName": | string | Επώνυμο Πελάτη | ΝΑΙ |
| "FullName": | string | Ονοματεπώνυμο πελάτη | ΝΑΙ |
| "TaxOfficeCode": | string | Δ.Ο.Υ. πελάτη | ΝΑΙ |
| "Address": | string | Διεύθυνση Πελάτη | ΝΑΙ |
| "PostalCode": | string | Ταχυδρομικός κωδικός πελάτη | ΝΑΙ |
| "ClubCardNumber": | string | Κωδικός Κάρτας Πελάτη | ΟΧΙ |
| "ActivityDescription": | string | Δραστηριότητα Πελάτη | ΟΧΙ |
| "Phone1": | string | Τηλέφωνο 1 Πελάτη | ΟΧΙ |
| "Phone2": | string | Τηλέφωνο 2 Πελάτη | ΟΧΙ |
| "EMailAddress": | string | Ηλ.Διεύθυνση Πελάτη | ΝΑΙ |
| "Inactive": | string | Κατάσταση Πελάτη (ενεργός, ανενεργός) | ΟΧΙ |
| "Comments": | string | Σχόλια Πελάτη | ΟΧΙ |
Παράδειγμα Κλήσης:
{
"TradeAccount": {
"TradeAccountType": 0,
"TaxRegistrationNumber": "9",
"GID": "2111-555-666-987",
"Code": "string",
"Name": "Marc",
"FirstName": "Marc",
"LastName": "Sale",
"FullName": "Marc Sale",
"fEInvoiceProfileGID": "pdf-P0-email",
"TaxOfficeCode": "0000",
"Address": "test",
"PostalCode": "26442",
"ClubCardNumber": "11585962",
"ActivityDescription": "test",
"Phone1": "2104585963",
"Phone2": "2104587594",
"EMailAddress": "test@entersoft.gr",
"Inactive": true,
"Comments": "string"
},
"DurationInMilliSeconds": 0
}
Στοιχεία Απάντησης Κλήσης:
Για να ενημερωθείτε σχετικά με όλα τα πεδία που θα λάβετε από την κλήση, επισκεφτείτε τo swagger της Entersoft https://eswebapi-next.azurewebsites.net/swagger/ui/index, όπου μπορείτε να αναζητήσετε με τη λέξη κλειδί eshopconnector όλες τις κλήσεις σχετικά με τη διασύνδεση του e-shop, καθώς επίσης με τα διαθέσιμα πεδία.
Παράδειγμα Απάντησης Κλήσης:
{
"DurationInMilliSeconds": 172,
"TradeAccount": {
"GID": "a1bcbb65-c527-49d8-a6b0-f248a9d67e92",
"Code": "ΠΛ001006"
}
}
CancelOrder
/eshopconnector/CancelOrder(POST):
Ακυρώνετε μια παραγγελία.
Παράμετροι που απαιτούνται:
| Πεδίο | Τύπος | Περιγραφή | Υποχρεωτικό |
|---|---|---|---|
| SearchCode | string | ΝΑΙ | |
| PageNo | integer | Αριθμός σελίδων | ΟΧΙ |
Παράδειγμα:
{
"SearchCode": "string",
"PageNo": 0
}
Απάντηση Κλήσης:
Παράδειγμα Απάντησης Κλήσης:
{
"ScrollerDataset": {
"RemotingFormat": "Xml",
"SchemaSerializationMode": "IncludeSchema",
"CaseSensitive": false,
"DefaultViewManager": [
{}
],
"EnforceConstraints": true,
"DataSetName": "",
"Namespace": "",
"Prefix": "",
"ExtendedProperties": {},
"HasErrors": true,
"IsInitialized": true,
"Locale": "string",
"Site": {
"Component": {
"Site": {}
},
"Container": {
"Components": [
{}
]
},
"DesignMode": true,
"Name": "string"
},
"Relations": [
{}
],
"Tables": [
{}
],
"Container": {
"Components": [
{}
]
},
"DesignMode": true
},
"TargetDatasets": [
{
"RemotingFormat": "Xml",
"SchemaSerializationMode": "IncludeSchema",
"CaseSensitive": false,
"DefaultViewManager": [
{}
],
"EnforceConstraints": true,
"DataSetName": "",
"Namespace": "",
"Prefix": "",
"ExtendedProperties": {},
"HasErrors": true,
"IsInitialized": true,
"Locale": "string",
"Site": {
"Component": {
"Site": {}
},
"Container": {
"Components": [
{}
]
},
"DesignMode": true,
"Name": "string"
},
"Relations": [
{}
],
"Tables": [
{}
],
"Container": {
"Components": [
{}
]
},
"DesignMode": true
}
],
"Variables": {}
}
ProductColors
/eshopconnector/ProductColors(POST):
Αντλείτε τους κωδικούς των χρωμάτων που περιλαμβάνονται μέσα στο Χρωματολόγιο που ζητήσατε.
Παράμετροι που απαιτούνται:
| Πεδίο | Τύπος | Περιγραφή | Υποχρεωτικό |
|---|---|---|---|
| SearchCode | string | Κωδικός Χρωματολογίου | ΝΑΙ |
| PageNo | integer | Αριθμός σελίδας | ΟΧΙ |
Παράδειγμα:
{
"SearchCode": "ΣΑΙΖΟΝ 1",
"PageNo": 0
}
Απάντηση Κλήσης:
| Πεδίο | Τύπος | Περιγραφή | Υποχρεωτικό |
|---|---|---|---|
| Code | string | Κωδικός Χρώματος | ΝΑΙ |
| Alternative Description | string | Εναλλακτική περιγραφή του Χρωματολογίου | ΟΧΙ |
| Description | integer | Περιγραφή του Χρωματολογίου | ΟΧΙ |
Παράδειγμα Απάντησης Κλήσης:
{
"PagingInfo": {
"Page": -1,
"PageSize": -1,
"WithCount": true
},
"RowsCount": 5,
"ResponseTime": "2023-11-06T11:00:09.6030523Z",
"SrvRoundTripms": 227,
"Totalms": 564,
"Data": [
{
"Code": "BL",
"Description": "ΜΑΥΡΟ",
"AlternativeDescription": "BLACK"
},
{
"Code": "GR",
"Description": "ΠΡΑΣΙΝΟ",
"AlternativeDescription": "GREEN"
},
{
"Code": "RE",
"Description": "ΚΟΚΚΙΝΟ",
"AlternativeDescription": "RED"
},
{
"Code": "BR",
"Description": "ΚΑΦΕ",
"AlternativeDescription": "BROWN"
},
{
"Code": "RT",
"Description": "Ροδακινι",
"AlternativeDescription": "#ffA500"
}
],
"InputPayload": {
"SearchCode": "ΣΑΙΖΟΝ 1",
"PageNo": 1
}
}
ProductSizes
/eshopconnector/ProductSizes(POST):
Αντλείτε τους κωδικούς των μεγεθών που περιλαμβάνονται μέσα στο Μεγεθολόγιο που ζητήσατε.
Παράμετροι που απαιτούνται:
| Πεδίο | Τύπος | Περιγραφή | Υποχρεωτικό |
|---|---|---|---|
| SearchCode | string | Κωδικός Μεγεθολογίου | ΝΑΙ |
| PageNo | integer | Αριθμός σελίδας | ΟΧΙ |
Παράδειγμα:
{
"SearchCode": " XS-S-M",
"PageNo": 0
}
Απάντηση Κλήσης:
| Πεδίο | Τύπος | Περιγραφή | Υποχρεωτικό |
|---|---|---|---|
| Code | string | Κωδικός Μεγέθους | ΝΑΙ |
| Alternative Description | string | Εναλλακτική περιγραφή του Μεγεθολογίου | ΟΧΙ |
| Description | integer | Περιγραφή του Μεγεθολογίου | ΟΧΙ |
Παράδειγμα Απάντησης Κλήσης:
{
"PagingInfo": {
"Page": -1,
"PageSize": -1,
"WithCount": true
},
"RowsCount": 3,
"ResponseTime": "2023-11-06T11:09:30.3559334Z",
"SrvRoundTripms": 75,
"Totalms": 102,
"Data": [
{
"Code": "XS",
"Description": "Extra Small"
},
{
"Code": "M",
"Description": "Medium"
},
{
"Code": "S",
"Description": "Small"
}
],
"InputPayload": {
"SearchCode": "XS-S-M",
"PageNo": 1
}
}
SaveAndIssueDocument
/eshopconnector/SaveAndIssueDocument(POST):
Η κλήση SaveAndIssueDocument χρησιμέυει στην αποθήκευση και διαβίβαση του παραστατικού στην ΑΑΔΕ, εφόσον έχει δηλωθεί μέσα στην σειρά του παραστατικού στο πεδίο ηλεκτρονική τιμολόγηση η παράμετρος μέσω παρόχου, χωρίς να έχει γίνει δήλωση φόρμας εκτύπωσης, μέσου εκτύπωσης και τρόπου κλήσης.
Παράμετροι που απαιτούνται:
| Πεδίο | Τύπος | Περιγραφή | Υποχρεωτικό |
|---|---|---|---|
| fDocTypeGID | string | Κωδικός Παραστατικού (π.χ. ΑΠΛ ) | ΝΑΙ |
| fDocSerieGID | string | Η σειρά που ανήκει το παραστατικό | ΝΑΙ |
| fBusinessUnitCode | string | Υποχρεωτική τιμή “Eshop” | ΝΑΙ |
| fTradeAccountGID | string | Ο κωδικός συναλλασσόμενου | ΝΑΙ |
| fShippingMethodCode | string | Ο κωδικός του τρόπου αποστολής όπως τηρείται στην εφαρμογή | ΟΧΙ |
| fTransitionStepCode | string | Ο κωδικός του βήματος εξέλιξης | ΝΑΙ |
| fPaymentMethodGID | string | Ο κωδικός του τρόπου πληρωμής όπως τηρείται στην εφαρμογή (κωδικοί 1000 για αντικαταβολή, 1001 για PayPal, 1002 για Πιστωτική Κάρτα, 1003 για Τραπεζική Κατάθεση) | ΝΑΙ |
| LineCreditCardPayments | Χρησιμοποιείται μόνο για τους τρόπους πληρωμής με πιστωτική κάρτα. Αλλιώς ο κόμβος παραλείπεται. | ΝΑΙ | |
| fCashAccountGID | string | Χρησιμοποιείται μόνο για τους τρόπους πληρωμής με πιστωτική κάρτα. Αλλιώς ο κόμβος παραλείπεται.. | ΝΑΙ |
| Installmetns | integer | Πλήθος δόσεων, αφορά τρόπο πληρωμής με πιστωτική κάρτα | ΝΑΙ |
| fColorCode | string | Κωδικός χρώματος | ΟΧΙ |
| fSizeCode | string | Κωδικός μεγέθους | ΟΧΙ |
| TotalValue | integer | Συνολική αξία γραμμής | ΝΑΙ |
| SearchCode | string | Κωδικός αναζήτησης του είδους, μπορείτε να χρησιμοποιήσετε και το barcode | ΝΑΙ |
| fItemGID | string | Ο κωδικός της υπηρεσίας | ΝΑΙ |
| ItemClass | string | Λαμβάνει την τιμή 0 αν αφορά υπηρεσία ή την τιμή 1 αν αφορά είδος αποθήκης | ΝΑΙ |
| Quantity | integer | Ποσότητα είδους | ΝΑΙ |
| Price | integer | Τιμή είδους | ΟΧΙ |
| PriceIncludedVat | boolean | Αν η Τιμή περιλαμβάνει Φ.Π.Α. | ΟΧΙ |
| UDFString1 | String | Οριζόμενο πεδίο σχολίου | ΟΧΙ |
| UDFString2 | String | Οριζόμενο πεδίο σχολίου | ΟΧΙ |
| UDFString3 | String | Οριζόμενο πεδίο σχολίου | ΟΧΙ |
| UDFString4 | String | Οριζόμενο πεδίο σχολίου | ΟΧΙ |
| UDFString5 | String | Οριζόμενο πεδίο σχολίου | ΟΧΙ |
| UDFValue1 | Decimal | Οριζόμενο πεδίο τιμής | ΟΧΙ |
| UDFValue2 | Decimal | Οριζόμενο πεδίο τιμής | ΟΧΙ |
| UDFValue3 | Decimal | Οριζόμενο πεδίο τιμής | ΟΧΙ |
| UDFValue4 | Decimal | Οριζόμενο πεδίο τιμής | ΟΧΙ |
| UDFValue5 | Decimal | Οριζόμενο πεδίο τιμής | ΟΧΙ |
| UDFDate1 | Date | Οριζόμενο πεδίο ημερομηνίας | ΟΧΙ |
| UDFDate2 | Date | Οριζόμενο πεδίο ημερομηνίας | ΟΧΙ |
| UDFDate3 | Date | Οριζόμενο πεδίο ημερομηνίας | ΟΧΙ |
| UDFDate4 | Date | Οριζόμενο πεδίο ημερομηνίας | ΟΧΙ |
| UDFDate5 | Date | Οριζόμενο πεδίο ημερομηνίας | ΟΧΙ |
| UDFFlag1 | Boolean | Οριζόμενο πεδίο σήμανσης λαμβάνει την τιμή true | ΟΧΙ |
| UDFFlag2 | Boolean | Οριζόμενο πεδίο σήμανσης λαμβάνει την τιμή true | ΟΧΙ |
| UDFFlag3 | Boolean | Οριζόμενο πεδίο σήμανσης λαμβάνει την τιμή true | ΟΧΙ |
| UDFFlag4 | Boolean | Οριζόμενο πεδίο σήμανσης λαμβάνει την τιμή true | ΟΧΙ |
| UDFFlag5 | Boolean | Οριζόμενο πεδίο σήμανσης λαμβάνει την τιμή true | ΟΧΙ |
| fUDF1Code | String | Οριζόμενο πεδίο πίνακα | ΟΧΙ |
| fUDF2Code | String | Οριζόμενο πεδίο πίνακα | ΟΧΙ |
| fUDF3Code | String | Οριζόμενο πεδίο πίνακα | ΟΧΙ |
| fUDF4Code | String | Οριζόμενο πεδίο πίνακα | ΟΧΙ |
| fTradeAccountContractADACode | String | Κωδικός ΑΔΑ | ΝΑΙ |
| fTradeAccountContractGID | String | GID της σύμβασης που έχει δημιουργηθεί | ΝΑΙ |
| fUDF5Code | String | Οριζόμενο πεδίο πίνακα | ΟΧΙ |
Παράδειγμα:
{
"Header": {
"fDocTypeGID": "ΑΠΥ-ΗΚ",
"fDocSerieGID": "RT",
"fTradeAccountGID": "ΠΛ000001",
"fTradeAccountContractGID": "0246c472-daee-4972-ae7c-dd7b941f3d33",
"fTradeAccountContractADACode": "1ΑΦΡΤ"
"fShippingMethodCode": "COURIER",
"fPaymentMethodGID": "1002",
"fBusinessUnitCode": "Eshop"
},
"LineItems": [
{
"fItemGID": "ΥΠ000019",
"ItemClass": 0,
"Quantity": 2,
"Price": 100,
"TotalValue": 260.00,
"PriceIncludedVat": true
}
],
"LineCreditCardPayments":
[
{
"fCashAccountGID":"G-3",
"Amount": 20,
"Installments": 1
}
]
}
Στοιχεία Απάντησης Κλήσης:
Για να ενημερωθείτε σχετικά με όλα τα πεδία που θα λάβετε από την κλήση, επισκεφτείτε το swagger της Entersoft
https://eswebapi-next.azurewebsites.net/swagger/ui/index , όπου μπορείτε να αναζητήσετε με τη λέξη κλειδί eshopconnector όλες τις κλήσεις σχετικά με τη διασύνδεση του e-shop, καθώς επίσης με τα διαθέσιμα πεδία.
Services
/eshopconnector/Services(POST):
Με την κλήση Products λαμβάνετε τα είδη από την εφαρμογή QuickBiz.
Παράμετροι που απαιτούνται:
| Πεδίο | Τύπος | Περιγραφή | Υποχρεωτικό |
|---|---|---|---|
| ChangedSinceTS | string | Έχουν λάβει αλλαγή από την ημερομηνία/ώρα και έπειτα | ΝΑΙ |
| Family | string | Οικογένεια | ΟΧΙ |
| SubFamily | string | Ομάδα | ΟΧΙ |
| Category | string | Κατηγορία | ΟΧΙ |
| SubCategory | string | Υποκατηγορία | ΟΧΙ |
| PageNo | integer | Αφορά τον αριθμό σελίδων. Επειδή σε κάθε κλήση products τα δεδομένα που λαμβάνετε έχουν ως όριο το πλήθος των 500 εγγραφών ανά σελίδα, προκειμένου να λάβετε τα επόμενα είδη θα πρέπει να χρησιμοποιήσετε την παράμετρο PageNo ώστε να λάβετε το επόμενο πακέτο ειδών. | ΟΧΙ |
Παράδειγμα:
{
"ChangedSinceTS": "2022-10-30T09:32:13.188Z",
"PageNo": 0
}
Παράδειγμα Απάντησης Κλήσης:
{
"PagingInfo": {
"Page": 1,
"PageSize": 200,
"WithCount": true
},
"RowsCount": 2,
"ResponseTime": "2024-01-30T08:00:39.5247145Z",
"SrvRoundTripms": 309,
"Totalms": 318,
"Data": [
{
"GID": "02847546-bb6c-4d76-b0ca-956461c74692",
"Code": "ΥΠ000001",
"Description": "Yπηρεσία Συντήρησης",
"RetailPrice": 0.0000000000,
"WholesalePrice": 0.0000000000,
"DiscountPRC": 0.0000000000,
"VatPRC": 24.0000000000,
"BasicMUCode": "001",
"LastModifiedDate": "2023-12-01T18:24:17.357"
},
{
"GID": "62ad1933-51c6-4250-bbe7-68e1464db318",
"Code": "ΥΠ000002",
"Description": "Υπηρεσία 2",
"RetailPrice": 350.0000000000,
"WholesalePrice": 210.0000000000,
"DiscountPRC": 0.0000000000,
"VatPRC": 24.0000000000,
"BasicMUCode": "001",
"LastModifiedDate": "2024-01-29T19:18:42"
}
],
"InputPayload": {
"ChangedSinceTS": "2022-10-30T09:32:13.188Z",
"PageNo": 1
}
}
| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
| GID | string | Μοναδικό κλειδί του είδους στη βάση |
| LastModifiedDate | Ημερομηνία και ώρα τελευταίας τροποποίησης | |
| Code | string | Κωδικός της υπηρεσίας |
| AlternativeCode | string | Εναλλακτικός κωδικός |
| Barcode | string | Barcode |
| Description | string | Περιγραφή |
| AlternativeDescription | string | Εναλλακτική Περιγραφή |
| LongDescription | string | N/A |
| ImageURL | string | N/A |
| Family | string | Οικογένεια |
| SubFamily | string | Ομάδα |
| Category | string | Κατηγορία |
| SubCtegory | string | Υποκατηγορία |
| RetailPrice | Τιμή Λιανικής | |
| WholesalePrice | Τιμή Χονδρικής | |
| DiscountPRC | Έκπτωση | |
| VatPRC | Φ.Π.Α. | |
| Manufacturer | string | N/A |
| BasicMUCode | string | Μονάδα Μέτρησης |
ProductsStock
/api/eshopconnector/ProductsStock:
Με την κλήση ProductsStock, έχετε την δυνατότητα να λαμβάνετε το υπόλοιπο ανά είδος καθώς επίσης αν το είδος παρακολουθεί διαστάσεις (χρώμα-μέγεθος), να λαμβάνετε τα υπόλοιπα ανά χρώμα – μέγεθος.
Παράμετροι που απαιτούνται:
| Πεδίο | Τύπος | Περιγραφή | Υποχρεωτικό |
|---|---|---|---|
| Code | string | Κωδικός είδους | ΝΑΙ |
| Color Code | string | Κωδικός Χρώματος | ΟΧΙ |
| Size Code | string | Κωδικός Μεγέθους | ΟΧΙ |
| LastChangeDateTime | Αφορά το ημερολογιακό διάστημα από το οποίο και έπειτα επιθυμείτε να λάβετε τις αλλαγές που έχουν γίνει. | ΝΑΙ | |
| PageNo | integer | Αφορά τον αριθμό σελίδων. Επειδή σε κάθε κλήση products τα δεδομένα που λαμβάνετε έχουν ως όριο το πλήθος των 500 εγγραφών ανά σελίδα, προκειμένου να λάβετε τα επόμενα είδη θα πρέπει να χρησιμοποιήσετε την παράμετρο PageNo ώστε να λάβετε το επόμενο πακέτο ειδών. | ΟΧΙ |
Παράδειγμα:
{
"Code": "1122342",
"ColorCode": "GR",
"SizeCode": "M",
"LastChangeDateTime": "2022-12-02T14:29:36.329Z",
"PageNo": 0
}
Παράδειγμα Απάντησης Κλήσης:
"PagingInfo": {
"Page": -1,
"PageSize": -1,
"WithCount": true
},
"RowsCount": 1,
"ResponseTime": "2024-12-04T10:21:38.5209459Z",
"SrvRoundTripms": 131,
"Totalms": 155,
"Data": [
{
"GID": "79566ff3-6485-459e-884a-653a75af6663",
"ColorCode": "GR",
"SizeCode": "M",
"Stock": 2.0000000000
}
],
"InputPayload": {
"Code": "1122342",
"ColorCode": "GR",
"SizeCode": "M",
"LastChangeDateTime": "2022-12-02T14:29:36.329Z",
"PageNo": 1
}
}
| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
| GID | string | Μοναδικό κλειδί του είδους στη βάση |
| Code | string | Κωδικός της υπηρεσίας |
| AlternativeCode | string | Εναλλακτικός κωδικός |
| ColorCode | string | Κωδικός Χρώματος |
| SizeCode | string | Κωδικός Μεγέθους |
| Stock | numeric | Υπόλοιπο Είδους |
UpserTradeAccountContract
/api/eshopconnector/UpsertTradeAccountContract:
Με την κλήση UpsertTradeAccountContract, έχετε την δυνατότητα να για την εισάγετε τις Συμβάσεων συναλλασσόμενων.
Παράμετροι που απαιτούνται:
| Πεδίο | Τύπος | Περιγραφή | Υποχρεωτικό |
|---|---|---|---|
| Code | string | Κωδικός σύμβασης | ΝΑΙ |
| Description | string | Περιγραφή σύβασης | ΝΑΙ |
| AlternativeCode | string | Εναλλακτικός κωδικός | ΟΧΙ |
| AlternativeDescription | string | Εναλλακτική περιγραφή | ΟΧΙ |
| Inactive | string | Λαμβάνει την τιμή false (ενεργό) | ΝΑΙ |
| fTradeAccountGID | string | Κωδικός πελάτη | ΝΑΙ |
| fCategoryCode | string | Κατηγορία Σύμβασης | ΝΑΙ |
| fPaymentMethodGID | string | Κωδικός τρόπου πληρωμής | ΝΑΙ |
| fContractADAMCode | string | Αριθμός διαδικτυακής ανάρτησης μητρώου -ΑΔΑΜ | ΝΑΙ |
| fContractingAuthorityPersonGID | string | Αφορά την επιλογή Αναθέτουσας αρχής με επιλεγμένο τον κωδικός ΑΑΗΤ | ΝΑΙ |
| ADA | string | Πεδίο ΑΔΑ | ΝΑΙ |
| Code | string | Κωδικός ΑΔΑ | ΝΑΙ |
| BudgetType | string | Τύπος προϋπολογισμού | ΝΑΙ |
| Comments | string | Πεδίο σχολίων ΑΔΑ | ΟΧΙ |
| ContractingAuthorityOfElectronicInvoicingCode | string | Αφορά το κωδικό ΑΑΗΤ της Αναθέτουσας αρχής | ΝΑΙ |
Παράδειγμα:
{
"TradeAccountContract": {
"Code": "1234567",
"Description": "Σύμβαση B2G",
"AlternativeCode": "5555",
"AlternativeDescription": "Σύμβαση B2G 6",
"fCategoryCode": "B2G",
"Inactive": false,
"fTradeAccountGID": "ΠΛ003395",
"fPaymentMethodGID": "0002",
"fContractADAMCode": "555555",
"fContractingAuthorityPersonGID": "0003814",
"ContractingAuthorityOfElectronicInvoicingCode": "1007.E84605.0001",
"ADA": [
{
"Code": "1ΑΦΡΤ",
"BudgetType":3,
"Comments": "TEST"
}
]
}
}
Παράδειγμα Απάντησης Κλήσης:
{
"DurationInMilliSeconds": 31,
"TradeAccountContract": {
"GID": "0246c472-daee-4972-ae7c-dd7b941f3d33",
"Code": "1234567"
}
}
