Γενικό Πλαίσιο REST API Calls

Τα API της Entersoft είναι οργανωμένα γύρω από το REST. Τα API μας έχουν URL προσανατολισμένα σε πόρους, δέχονται σώματα (Body) αιτημάτων με κωδικοποίηση φόρμας, και επιστρέφουν αποκρίσεις με κωδικοποίηση JSON. Τέλος, χρησιμοποιούν τυπικούς κώδικες απόκρισης HTTP και έλεγχο ταυτότητας.

Κλήση μέσω Postman

Σε κάθε request που γίνεται προς την τοποθεσία https://api.entersoft.gr/api/  θα πρέπει να έχετε ορίσει :

1. Τον τύπο της κλήσης, ο οποίος είναι POST  σε όλες τις περιπτώσεις.

Το URL, το οποίο είναι της μορφής : https://{{esapihost}}/api/eshopconnector/{}

• Για το Live περιβάλλον esapihost: api.entersoft.gr

• Για το TEST δοκιμαστικό περιβάλλον esapihost: eswebapi-next.azurewebsites.net

1. Καθώς επίσης τα δεδομένα της κλήσης σε επίπεδο Body, row, τα δεδομένα της κλήσης θα πρέπει να είναι σε μορφή Json.

2. Κατόπιν της αγοράς του QuickBiz E-shop Connector από το Cloud Store της Entersoft, από την εφαρμογή QuickBiz, στο πεδίο Παραμετροποίηση Eshop Connector όπως εμφανίζεται στην εικόνα παρακάτω,

επιλέγετε Δημιουργία νέου, και παράγεται αυτόματα το κλειδί σύνδεσης Header API key, το οποίο μπορείτε είτε να αντιγράψετε είτε να αποστείλετε με email. Καθώς επίσης σας δίνεται και το Header Api name

                    Header name: X-ES-APIKEY-QBIZESHOPCONNECTOR

Header value: bd9*****-****-b743-****-************,********-****-****-****-************,*******7796

Το κλειδί αυθεντικοποίησης των κλήσεων Authorization key  Header API key (X-ES-APIKEY-QBIZESHOPCONNECTOR) και header Api value , μπορείτε να το δηλώσετε σε επίπεδο Header μέσα στο collection και να ορίσετε στον τύπο αυθεντικοποίησης <<API Key>>, έτσι ώστε να μην το προσθέτετε κάθε φορά  σε όλα τα requests, όπως εμφανίζεται στις εικόνες 1 και 2 παρακάτω. Οι εικόνες είναι μέσα από το εργαλείο Postman.

Ορισμός τύπου Authorization: (εικόνα 1)

Αυτόματα ορίζεται το Api key και το Value  στο header: (εικόνα 2)

Στις κλήσεις που απαιτούνται παράμετροι στο body, υπάρχει πίνακας με τα πεδία που απαιτούνται Υποχρεωτικά (Υ) και Προαιρετικά (Π) . Σε όλες τις παραμέτρους που αναφέρεται η παράμετρος page No, αφορά τον αριθμό της σελίδας. Σε όλες τις κλήσεις που πραγματοποιείται το μέγιστο πλήθος γραμμών στα responses ανά σελίδα είναι 200 (γραμμές), επομένως αν το Rows counts στην επιστρεφόμενη κλήση είναι 250, αυτό σημαίνει ότι πρέπει να επαναλάβετε την κλήση με page No = 2 .

EndPoints:

Στη συνέχεια θα παρουσιάσουμε την κάθε κλήση που μπορείτε να πραγματοποιήσετε έτσι ώστε να ανταλλάσσετε πληροφορίες με την εφαρμογή QuickBiz.

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

Για να ξεκινήσετε γρήγορα με τα Entersoft API, μπορείτε να χρησιμοποιήσετε το Entersoft Workspace στο Postman. Η συλλογή περιλαμβάνει όλα τα Entersoft API που απαιτούνται για τη διασύνδεση με τον eshop connector.

Στο QuickBiz Collection, διατίθενται παραδείγματα όλων των κλήσεων καθώς επίσης και σημειώσεις για την κάθε μέθοδο.

Services

Products

/eshopconnector/Products(POST):

Με την κλήση Products λαμβάνετε τα είδη από την εφαρμογή QuickBiz.

Οι Παράμετροι που χρειάζονται για την κλήση είναι:

Παράμετροι:

Παράδειγμα στοιχείων εισαγωγής:

{

  "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"

        }

    ]

}

Στοιχεία που επιστρέφονται:

OrderStatus

/eshopconnector/OrderStatus(POST):

Λαμβάνετε, πληροφόρηση για παραστατικά καταχωρημένα στην εφαρμογή QuickBiz. Σημαντικό είναι ότι από την εκτέλεση της κλήσης μπορείτε να λάβετε, πεδία όπως MARK, UID, Επωνυμία Παρόχου ΗΛ.Τιμολόγησης, Authentication Key,  url παραστατικού, όπως τηρούνται στο πάροχο ηλεκτρονικής τιμολόγησης, καθώς και url του mydata αν χρησιμοποιείται την άμεση διαβίβαση και όχι τον πάροχο ηλεκτρονικής τιμολόγησης.

Παράμετροι που απαιτούνται:

Παράδειγμα Κλήσης:

{

  "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):

Σας επιστρέφει τις οικογένειες των ειδών.

Παράμετροι που απαιτούνται:

Δεν απαιτούνται παράμετροι.

Στοιχεία Απάντησης Κλήσης:

Παράδειγμα Απάντησης Κλήσης:

{

    "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):

Σας επιστρέφει τις ομάδες των ειδών.

Παράμετροι που απαιτούνται:

Δεν απαιτούνται παράμετροι.

Στοιχεία Απάντησης Κλήσης:

Παράδειγμα Απάντησης Κλήσης:

{

    "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):

Σας επιστρέφει τις ομάδες των ειδών.

Παράμετροι που απαιτούνται:

Δεν απαιτούνται παράμετροι.

Στοιχεία Απάντησης Κλήσης:

Παράδειγμα Απάντησης Κλήσης:

{

    "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):

Σας επιστρέφει τις μονάδες μέτρησης των ειδών.

Παράμετροι που απαιτούνται:

Δεν απαιτούνται παράμετροι.

Στοιχεία Απάντησης Κλήσης:

Παράδειγμα Απάντησης Κλήσης:

{

    "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": {},

  "PageNo": 0

}

Στοιχεία Απάντησης Κλήσης:

Παράδειγμα απάντησης Κλήσης:

{

    "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": {},

  "PageNo": 0

}

Στοιχεία Απάντησης Κλήσης:

Παράδειγμα Απάντησης Κλήσης:

{

    "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": {},

  "PageNo": 0

}

Στοιχεία Απάντησης Κλήσης:

Παράδειγμα Απάντησης Κλήσης:

{

    "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, αναφέρονται στον πίνακα παρακάτω:

Παράδειγμα Κλήσης:

{

    "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 αν δεν υπάρχει ΑΦΜ, αν υπάρχει ΑΦΜ τότε ο έλεγχος γίνεται με βάση αυτό. Επομένως δεν δημιουργείται νέος πελάτης ωστόσο γίνεται η όποια ενημέρωση επιθυμεί ο χρήστης.

Παράδειγμα Κλήσης:

{

  "TradeAccount": {

    "TradeAccountType": 0,

    "TaxRegistrationNumber": "9",

    "GID": "2111-555-666-987",

    "Code": "string",

    "Name": "Marc",

    "FirstName": "Marc",

    "LastName": "Sale",

    "FullName": "Marc Sale",

    "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": 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": "ΣΑΙΖΟΝ 1",

  "PageNo": 0

}

Απάντηση Κλήσης:

Παράδειγμα Απάντησης Κλήσης:

{

    "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": " XS-S-M",

  "PageNo": 0

}

Απάντηση Κλήσης:

Παράδειγμα Απάντησης Κλήσης:

{

    "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 χρησιμέυει στην αποθήκευση και διαβίβαση του παραστατικού στην ΑΑΔΕ, εφόσον έχει δηλωθεί μέσα στην σειρά του παραστατικού στο πεδίο ηλεκτρονική τιμολόγηση η παράμετρος μέσω παρόχου, χωρίς να έχει γίνει δήλωση φόρμας εκτύπωσης, μέσου εκτύπωσης και τρόπου κλήσης.

Παράμετροι που απαιτούνται:

Παράδειγμα:

{

    "Header": {

        "fDocTypeGID": "ΑΠΥ-ΗΚ",

        "fDocSerieGID": "RT",

        "fTradeAccountGID": "ΠΛ000001",

        "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": "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

    }

}

ProductsStock

/api/eshopconnector/ProductsStock:

Με την κλήση ProductsStock, έχετε την δυνατότητα να λαμβάνετε το υπόλοιπο ανά είδος καθώς επίσης αν το είδος παρακολουθεί διαστάσεις (χρώμα-μέγεθος), να λαμβάνετε τα υπόλοιπα ανά χρώμα – μέγεθος.

Παράμετροι που απαιτούνται:  

Παράδειγμα:  

{

  "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

    }

}