---
title: "CMS_B2B_B2C protocol"
canonical: "https://wiki.soft1.eu/space/ATEL/182092865/CMS_B2B_B2C%20protocol"
format: markdown
---
> Macro (inline-media-image)

   
  
Πρωτόκολλο ανταλλαγής δεδομένων μεταξύ ERP CMS και Ιστότοπου   
  
  
  
  
<span style="color: #17365d">Πρωτόκολλο ανταλλαγής δεδομένων μεταξύ ERP-CMS και Ιστότοπου</span>  
**[Γενικά](#CMS_B2B_B2Cprotocol-_Toc494362884)**[ ](#CMS_B2B_B2Cprotocol-_Toc494362884)  
**[Αναλυτική περιγραφή ανταλλαγής δεδομένων](#CMS_B2B_B2Cprotocol-_Toc494362885)**[ ](#CMS_B2B_B2Cprotocol-_Toc494362885)  
[uploadfile.asp ](#CMS_B2B_B2Cprotocol-_Toc494362886)  
[xmlParser.asp ](#CMS_B2B_B2Cprotocol-_Toc494362887)  
[getdata.asp ](#CMS_B2B_B2Cprotocol-_Toc494362888)  
[cleardata.asp ](#CMS_B2B_B2Cprotocol-_Toc494362889)  
**[Επεξήγηση των XML](#CMS_B2B_B2Cprotocol-_Toc494362890)**[ ](#CMS_B2B_B2Cprotocol-_Toc494362890)  
[Είδη ](#CMS_B2B_B2Cprotocol-_Toc494362891)  
[Κατηγορίες ΦΠΑ ](#CMS_B2B_B2Cprotocol-_Toc494362892)  
[Κατασκευαστές ](#CMS_B2B_B2Cprotocol-_Toc494362893)  
[Kατηγορίες ειδών ](#CMS_B2B_B2Cprotocol-_Toc494362894)  
[Κόστη αποστολής ](#CMS_B2B_B2Cprotocol-_Toc494362895)  
[Στοιχεία επαφών ](#CMS_B2B_B2Cprotocol-_Toc494362896)  
[Ρυθμίσεις ιστότοπου ](#CMS_B2B_B2Cprotocol-_Toc494362897)  
[Γλώσσες ιστότοπου ](#CMS_B2B_B2Cprotocol-_Toc494362898)  
[Banners ](#CMS_B2B_B2Cprotocol-_Toc494362899)  
[Σελίδες ιστότοπου ](#CMS_B2B_B2Cprotocol-_Toc494362900)  
[Κατηγορίες νέων ](#CMS_B2B_B2Cprotocol-_Toc494362901)  
[Τα νέα της εταιρίας ](#CMS_B2B_B2Cprotocol-_Toc494362902)  
[Μοντέλα διαθεσιμότητας ](#CMS_B2B_B2Cprotocol-_Toc494362903)  
[Σημειώσεις: ](#CMS_B2B_B2Cprotocol-_Toc494362904)  
**[Αναλυτική περιγραφή χρήσης του Web](#CMS_B2B_B2Cprotocol-_Toc494362905)**[ ](#CMS_B2B_B2Cprotocol-_Toc494362905)**[Service](#CMS_B2B_B2Cprotocol-_Toc494362905)**[ ](#CMS_B2B_B2Cprotocol-_Toc494362905)  
[Γενικά ](#CMS_B2B_B2Cprotocol-_Toc494362906)  
[Αναλυτικά ](#CMS_B2B_B2Cprotocol-_Toc494362907)  
*[ES_CUSTCHECK.](#CMS_B2B_B2Cprotocol-_Toc494362908)*[ ](#CMS_B2B_B2Cprotocol-_Toc494362908)  
*[ES_CUSTBALANCE.](#CMS_B2B_B2Cprotocol-_Toc494362909)*[ ](#CMS_B2B_B2Cprotocol-_Toc494362909)  
*[ES_ORDERLIST.](#CMS_B2B_B2Cprotocol-_Toc494362910)*[ ](#CMS_B2B_B2Cprotocol-_Toc494362910)  
*[ES_PREPAREORDER.](#CMS_B2B_B2Cprotocol-_Toc494362911)*[ ](#CMS_B2B_B2Cprotocol-_Toc494362911)  
*[ES_CUSTADD.](#CMS_B2B_B2Cprotocol-_Toc494362912)*[ ](#CMS_B2B_B2Cprotocol-_Toc494362912)  
*[ES_ITEMAVAIL](#CMS_B2B_B2Cprotocol-_Toc494362913)*[ ](#CMS_B2B_B2Cprotocol-_Toc494362913)  
*[ES_PREPAY.](#CMS_B2B_B2Cprotocol-_Toc494362914)*[ ](#CMS_B2B_B2Cprotocol-_Toc494362914)  
*[ES_MATIMAGES](#CMS_B2B_B2Cprotocol-_Toc494362915)*[ ](#CMS_B2B_B2Cprotocol-_Toc494362915)  
*[DM_INSERT](#CMS_B2B_B2Cprotocol-_Toc494362916)*[ ](#CMS_B2B_B2Cprotocol-_Toc494362916)  
*[DM_LOCATE](#CMS_B2B_B2Cprotocol-_Toc494362917)*[ ](#CMS_B2B_B2Cprotocol-_Toc494362917)  
**[Παράρτημα](#CMS_B2B_B2Cprotocol-_Toc494362918)**[ ](#CMS_B2B_B2Cprotocol-_Toc494362918)  
[Ονοματολογία αρχείων ](#CMS_B2B_B2Cprotocol-_Toc494362919)

# > Macro (anchor)

Γενικά

Όλες οι αποστολές στοιχείων από το ERP προς τον Web Server είναι ενσωματωμένες στο πρόγραμμα και εκτελούνται αυτόματα χωρίς να απαιτείται παρέμβαση του χρήστη.  
Στο κείμενο που ακολουθεί, η ονοματολογία που χρησιμοποιείται είναι σταθερή. Οποιαδήποτε τροποποίηση θα πρέπει να γίνει με ανακατεύθυνση στην πλευρά του server.  
Τα μηνύματα πιθανών λαθών που επιστρέφονται από τον Web Server, εμφανίζονται στην οθόνη του χρήστη του ERP ως έχουν, χωρίς καμία παρέμβαση.  
Όλη η επικοινωνία γίνεται μέσω HTTP POST και HTTP GET. Τα δεδομένα θα πρέπει να είναι σε XML format.  
To ERP για το σύνολο της επικοινωνίας του με τον Web Server χρησιμοποιεί συγκεκριμένες σελίδες, όπως αυτές αναλύονται παρακάτω. Οι σελίδες επικοινωνίας πρέπει να βρίσκονται σε υποφάκελο του root του ιστότοπου με όνομα "**syndicate**" (πχ. [http://www.altec.gr/syndicate](http://www.altec.gr/syndicate)). 

# > Macro (anchor)

Αναλυτική περιγραφή ανταλλαγής δεδομένων

*Κάθε επικοινωνία από το ERP προς τον Web* *Server προστατεύεται μέσω της κωδικοποιημένης (MD5) αποστολής (με GET) του serial* *number του ERP. Με την παράμετρο ****clid**** αποστέλλεται το serial* *number και με την παράμετρο ****cluid**** το κωδικοποιημένο serial* *number.* O server πριν προχωρήσει σε οποιοδήποτε επεξεργασία θα πρέπει να επιβεβαιώσει την γνησιότητα των στοιχείων, αφού θα έχει στη διάθεσή του το ειδικό κλειδί του πελάτη. Το κλειδί αυτό ορίζεται στο ERP και αποστέλλεται στον υπεύθυνο του Web Server κατά την πρώτη επικοινωνία, πριν ακόμα στηθεί ο ιστότοπος.

## > Macro (anchor)

uploadfile.asp

- **<*****uploadfile.asp*****>** Σελίδα για αποστολή αρχείων. Με κλήση της σελίδας αυτής επιτυγχάνεται η αποστολή κάθε είδους αρχείου (κείμενο, φωτογραφία, flash κλπ.), σύμφωνα με τις παρακάτω παραμέτρους (POST parameters) :
  - **uType**
    - '0' = null
    - '1' = προϊόν
    - '2' = κατηγορία προϊόντος
    - '3' = σελίδα κειμένου
    - '4' = νέα της εταιρίας
    - '5' = banners
    - '6' = κατασκευαστές
    - '7' = ρυθμίσεις ιστότοπου
    - '8' = εικόνες υφής ομάδων χρωμάτων
  - **uFile**
    - Filename = όνομα αρχείου προς αποστολή (βλ. παράρτημα)

Με την πετυχημένη ολοκλήρωση της αποστολής, θα πρέπει να επιστρέφεται το μονοπάτι αποθήκευσης του αρχείου στο server, υπό μορφή <file:\xxx\xxx\xxxx.zzz>. Οτιδήποτε άλλο θεωρείται σφάλμα και εμφανίζεται στην οθόνη του χρήστη του ERP. Η αποστολή των αρχείων γίνεται πριν γίνει η αποστολή του xml, το οποίο θα περιέχει το μονοπάτι αποθήκευσης.  
Οι επιτρεπόμενες μορφές αρχείων είναι : jpg, png, ico, doc, xls, swf, pdf, docx, xlsx, rar, zip

## > Macro (anchor)

xmlParser.asp

- **<*****xmlParser.asp*****>** Σελίδα για αποστολή δεδομένων προς επεξεργασία. Το XML που περιέχει τα προς αποστολή στοιχεία αποστέλλεται με τις παρακάτω παραμέτρους (GET parameters) :
  - **md**
    - '0' = null
    - '1' = ρυθμίσεις ιστότοπου
    - '2' = γλώσσες ιστότοτπου
    - '3' = captions ιστότοπου
    - '4' = κατηγορίες νέων
    - '5' = νέα της εταιρίας
    - '6' = στοιχεία επικοινωνίας
    - '7' = banners
    - '8' = κείμενα σελίδων
    - '9' = συντελεστές ΦΠΑ
    - '10' = κατασκευαστές
    - '11' = κατηγορίες προϊόντων
    - '12' = προϊόντα
    - '13' = κόστη αποστολών
    - '14' = μοντέλα διαθεσιμότητας

Στις επόμενες σελίδες υπάρχουν πίνακες με αναλυτική περιγραφή του περιεχομένου (XML) του κάθε τύπου μηνύματος. To ίδιο το XML αποστέλλεται με POST.  
Παράδειγμα μηνύματος:  
Header=Content-Type: text/xml  
Body=XML text.  
Σε περίπτωση σφάλματος πρέπει να επιστρέφεται string που περιέχει τη λεκτικό '**ERROR**'

## > Macro (anchor)

getdata.asp

- <***getdata.asp***> Η σελίδα αυτή χρησιμοποιείται για να ζητηθούν στοιχεία από τον server. Τα στοιχεία αυτά είναι τα διαθέσιμα template / themes και τα στατικά captions του ιστότοπου. παράμετρος που αποστέλλεται στην σελίδα αυτή είναι :
- **xml**
- themes= templates ιστότοπου
- constants = στατικά captions ιστότοπου

  
Μετά την επεξεργασία στο ERP, τα νέα στοιχεία επιστρέφονται στον server με την **<xmlParser.asp>.**

## > Macro (anchor)

cleardata.asp

- **<*****cleardata.asp*****>** Χρησιμοποιείται για τη διαγραφή στοιχείων από τον ιστότοπο.

Οι παράμετροι (GET) που αποστέλλονται είναι:

- 
  - **clear**
    - 'all' = Όλα
    - 'pages' = κείμενα σελίδων
    - 'news' = νέα της εταιρίας
    - 'contacts' = στοιχεία επικοινωνίας
    - 'banners' = banners
    - 'courier' = κόστη αποστολής
    - 'manufacturers'= κατασκευαστές
    - 'countries' = χώρες
    - 'languages'= γλώσσες ιστότοπου
    - 'items' = προϊόντα
    - 'settings' = ρυθμίσεις ιστότοπου
    - 'availmodels'= μοντέλα διαθεσιμότητας
    - 'item_categories'= κατηγορίες ειδών
  - **ids**
    - comma separated ids για στοχευμένες διαγραφές. Για διαγραφή όλων των εγγραφών η συγκεκριμένη παράμετρος παίρνει τιμή -1.
  - **langid**
    - id για να επιτευχθεί διαγραφή στοιχείων μόνο στη συγκεκριμένη γλώσσα. Με τιμή -1 επιτυγχάνεται η αντίστοιχη διαγραφή, ανεξαρτήτου γλώσσας.

  


# > Macro (anchor)

Επεξήγηση των XML

## > Macro (anchor)

> Macro (anchor)

Είδη

|  |  |  |  |  |  |  |  |  |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| **Πεδίο ERP** |  |  |  |  |  |  | **Κόμβος XML** |  |
| Κλειδί είδους |  |  |  |  |  |  | id |  |
| Κλειδί γλώσσας |  |  |  |  |  |  | langid |  |
| Ενεργό από |  |  |  |  |  |  | activeFrom |  |
| Ενεργό εως |  |  |  |  |  |  | activeTo |  |
| Νέο από |  |  |  |  |  |  | newFrom |  |
| Νέο εως |  |  |  |  |  |  | newTo |  |
| Κωδικός |  |  |  |  |  |  | sku |  |
| Τίτλος |  |  |  |  |  |  | title |  |
| Σύντομη περιγραφή |  |  |  |  |  |  | shortDescription |  |
| Αναλυτική περιγραφή (html format text) |  |  |  |  |  |  | longDescription |  |
| Κατασκευαστής |  |  |  |  |  |  | manufacturerID |  |
| Κατηγορία |  |  |  |  |  |  | categoryID |  |
| Τιμή (δημοσίευσης) (παλαιός τρόπος) |  |  |  |  |  |  | price |  |
| Τιμή χονδρικής |  |  |  |  |  |  | whsPrice |  |
| Τιμή λιανικής |  |  |  |  |  |  | rtlPrice |  |
| Τιμή web |  |  |  |  |  |  | webPrice |  |
| Τύπος τιμής δημοσίευσης   
0 : Τιμή χονδρικής   
1 : Τιμή λιανικής   
2 : Τιμή web   
3 : [Κείμενο τιμής](#CMS_B2B_B2Cprotocol-_Γλώσσες_ιστοτόπου) |  |  |  |  |  |  | priceUsed |  |
| Κατηγορία ΦΠΑ |  |  |  |  |  |  | taxid |  |
| Περιλαμβάνει ΦΠΑ |  |  |  |  |  |  | taxincluded |  |
| Hot spot |  |  |  |  |  |  | specialHotSpot |  |
| Μήκος |  |  |  |  |  |  | length |  |
| Ύψος |  |  |  |  |  |  | height |  |
| Βάθος |  |  |  |  |  |  | depth |  |
| Βάρος |  |  |  |  |  |  | weight |  |
| Ειδική εικόνα |  |  |  |  |  |  | specialPhoto |  |
| Εικόνες |  |  |  |  |  |  | photos |  |
|  | Σχετική διαδρομή στον web server (από το uploadfile.asp) |  |  |  |  |  | photo |  |
| Άλλες κατηγορίες |  |  |  |  |  |  | secondaryCategories |  |
|  | Κλειδί |  |  |  |  |  | catid |  |
| Σχετιζόμενα είδη |  |  |  |  |  |  | relatedItems |  |
|  | Κωδικός |  |  |  |  |  | itemSku |  |
| Προσφορά |  |  |  |  |  |  | offer |  |
|  | Τιμή |  |  |  |  |  | price |  |
|  | Από |  |  |  |  |  | dateFrom |  |
|  | Εως |  |  |  |  |  | dateTo |  |
| Χαρακτηριστικά |  |  |  |  |  |  | attributes |  |
|  | Κλειδί |  |  |  |  |  | attribute | id |
|  | Τίτλος |  |  |  |  |  | attribute | title |
|  | Τιμή |  |  |  |  |  | attribute | value |
|  | Τύπος φίλτρου |  |  |  |  |  | attribute | filtertype |
| Χρώματα |  |  |  |  |  |  | colors |  |
|  | Τίτλος |  |  |  |  |  | color | title |
|  | Περιγραφή |  |  |  |  |  | color | description |
|  | RGB (ΗΕΧ)* |  |  |  |  |  | color | rgb |
|  | Ομάδες χρώματος** |  |  |  |  |  | color | colorgroups |
|  | Εικόνα υφής |  |  |  |  |  | color | image |
| Μεγέθη |  |  |  |  |  |  | sizes |  |
|  | Κλειδί |  |  |  |  |  | size | id |
|  | Τίτλος |  |  |  |  |  | size | title |
| Τιμές ανά χρώμα/μέγεθος |  |  |  |  |  |  | colorSizePrices |  |
|  | Τιμές χονδρικής |  |  |  |  |  | whsPrices |  |
|  |  |  | Χρώμα |  |  | color value="title" |  |  |
|  |  |  |  |  |  | Μέγεθος |  | <size value="id"> [αξία] |  |  |
|  | Τιμές λιανικής |  |  |  |  |  | rtlPrices |  |
|  |  |  | Χρώμα |  |  | color value="title" |  |  |
|  |  |  |  |  |  | Μέγεθος |  | <size value="id"> [αξία] |  |  |
|  | Τιμές Web |  |  |  |  |  | webPrices |  |
|  |  |  | Χρώμα |  |  | color value="title" |  |  |
|  |  |  |  |  |  | Μέγεθος |  | <size value="id"> [αξία] |  |  |
|  | Τιμές προσφορών Web |  |  |  |  |  | offerPrices |  |
|  |  |  | Χρώμα |  |  | color value="title" |  |  |
|  |  |  |  |  |  | Μέγεθος |  | <size value="id" dateFrom="date" dateTo="date"> [αξία] |  |  |
| Εικόνες ανά χρώμα |  |  |  |  |  |  | colorPhotos |  |
|  | Εικόνα ανά χρώμα |  |  |  |  |  | colorPhoto |  |
|  |  |  | Κωδικός χρώματος |  |  | colorCode |  |  |
|  |  |  | Σχετική διαδρομή στον web server (από το uploadfile.asp) |  |  | photo |  |  |
|  |  |  | Εικόνες slider ανά χρώμα |  |  | colorSliderImages |  |  |
|  |  |  |  | Σχετική διαδρομή στον web server |  |  | sliderImage |  |
| Χαρακτηρισμένο από |  |  |  |  |  |  | specialFrom |  |
| Χαρακτηρισμένο έως |  |  |  |  |  |  | specialTo |  |
| SEO λέξεις κλειδιά |  |  |  |  |  |  | seoKeywords |  |
| SEO Περιγραφή |  |  |  |  |  |  | seoDescription |  |
| Εικόνες slider |  |  |  |  |  |  | sliderImages |  |
|  | Σχετική διαδρομή στον web server |  |  |  |  |  | sliderImage |  |
| Ημερομηνίες ανά Χ/Μ |  |  |  |  |  |  | colorSizeDates |  |
|  | Ενεργό |  |  |  |  |  | activeDates |  |
|  |  | Χρώμα |  |  |  |  | color value="title" |  |
|  |  |  |  | Μέγεθος |  |  | <size value="id" dateFrom="date" dateTo="date"> [αξία] |  |  |  |
|  | Χαρακτηρισμένο |  |  |  |  |  | specialDates |  |
|  |  | Χρώμα |  |  |  |  | color value="title" |  |
|  |  |  |  | Μέγεθος |  |  | <size value="id" dateFrom="date" dateTo="date"> [αξία] |  |  |  |
|  | Νέο είδος |  |  |  |  |  | newDates |  |
|  |  | Χρώμα |  |  |  |  | color value="title" |  |
|  |  |  |  | Μέγεθος |  |  | <size value="id" dateFrom="date" dateTo="date"> [αξία] |  |  |  |

**Σημ.** **Το πεδίο μπορεί να έχει παραπάνω από μία τιμές, οι οποίες χωρίζονται με '**;{*}'  
**Σημ.** ***Το πεδίο μπορεί να έχει παραπάνω από μία τιμές, οι οποίες χωρίζονται με '**,{*}' 

## > Macro (anchor)

Κατηγορίες ΦΠΑ

|  |  |
| --- | --- |
| **Πεδίο ERP** | **Κόμβος XML** |
| Κλειδί | id |
| Ποσοστό | value1 |
| Μειωμένο ποσοστό | value2 |

## > Macro (anchor)

Κατασκευαστές

|  |  |
| --- | --- |
| **Πεδίο ERP** | **Κόμβος XML** |
| Κλειδί | id |
| Κλειδί γλώσσας | langid |
| Κωδικός | title |
| Περιγραφή | description |
| Διεύθυνση ιστοσελίδας | url |
| Εικόνα | photo |

## > Macro (anchor)

Kατηγορίες ειδών

|  |  |
| --- | --- |
| **Πεδίο ERP** | **Κόμβος XML** |
| Ανανέωση κατηγοριών (Οι πιθανές τιμές είναι **0**: γίνεται κανονική αποστολή – **1**: γίνεται αποστολή όλων των κατηγοριών. Σε περίπτωση μη συμφωνίας με το site πρέπει να διαγραφούν οι κατηγορίες από το site | refresh |
| Κλειδί | id |
| Κλειδί γλώσσας | langid |
| Όνομα | name |
| Σύντομη περιγραφή | description |
| Σειρά εμφάνισης | order |
| Μητρική κατηγορία | parentid |
| Ορατή | isvisible |
| Εικόνα | photo |
| Ειδική θέση (κλειδί) | specialHotSpot |
| SEO λέξεις κλειδιά | seoKeywords |
| SEO Περιγραφή | seoDescription |
| Τίτλος κατηγορίας | title |
| Επικεφαλίδα SEO (H1) | seoH1 |
| Αναλυτική περιγραφή | longDescription |

## > Macro (anchor)

Κόστη αποστολής

|  |  |  |  |  |  |
| --- | --- | --- | --- | --- | --- |
| **Πεδίο ERP** |  |  |  |  | **Κόμβος XML** |
| Μεταφορείς |  |  |  |  | DeliveryCarriers |
|  | Μεταφορέας |  |  |  | carrier id="*num*" |
|  |  | Περιγραφή μεταφορέα |  |  | name langid="*num*" |
| Ζώνες χρέωσης αποστολών |  |  |  |  | DeliveryCostZones |
|  | Ζώνη χρέωσης (id, id μεταφορέα) |  |  |  | CostZone id ="*num*" carrid="*num*" |
|  |  | Περιγραφή ζώνης ανά γλώσσα |  |  | name langid="*num*" |
|  |  | Ταχυδρομικοί κώδικες |  |  | zipCodes |
|  |  |  | Εύρος Τ.Κ. (id, id μετφορέα, id χώρας) |  | zipRange id ="*num*" carrid="*num*" cntid="*num*" |
|  |  |  |  | T.K από | zipFrom |
|  |  |  |  | Τ.Κ. έως | zipTo |
| Τρόποι παράδοσης |  |  |  |  | DeliveryKind |
|  | Τρόπος παράδοσης |  |  |  | Kind id="*num*" |
|  |  | Περιγραφή τρόπου παράδοσης ανά γλώσσα |  |  | name langid="*num*" |
| Χρεώσεις αποστολών |  |  |  |  | DeliveryCost |
|  | Χρέωση αποστολών |  |  |  | Cost id="*num*" CostZone="*num*" DeliveryKind="*num*" Weight="*num*" Cost="*num*" OrderValue="*num*" |


## > Macro (anchor)

Στοιχεία επαφών

|  |  |
| --- | --- |
| **Πεδίο ERP** | **Κόμβος XML** |
| Κλειδί | id |
| Κλειδί γλώσσας | langid |
| e-mail | email |
| Τμήμα | division |
| Περιγραφή | description |


## > Macro (anchor)

Ρυθμίσεις ιστότοπου

|  |  |  |  |  |  |  |  |  |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| **Πεδίο ERP** |  |  |  |  |  |  |  | **Κόμβος XML** |
| Meta keys |  |  |  |  |  |  |  | MetaKeys |
| Meta descriptions |  |  |  |  |  |  |  | MetaDesc |
| Λογότυπο |  |  |  |  |  |  |  | logo |
| GOOGLEANALYTICS |  |  |  |  |  |  |  | googleAnalytics |
| Custom CSS |  |  |  |  |  |  |  | customCss |
| Custom JS |  |  |  |  |  |  |  | customJs |
| Εμφάνιση τιμών |  |  |  |  |  |  |  | show_prices |
| Θέμα |  |  |  |  |  |  |  | theme |
| Skin |  |  |  |  |  |  |  | skin |
| Εμφάνιση προκαθορισμένων σελίδων |  |  |  |  |  |  |  | showDefaultPages |
| Ρυθμίσεις σειράς παραγγελιών B2Β |  |  |  |  |  |  |  | orderSettingsB2B |
|  |  | Να επιτρέπονται παραγγελίες εκτός σύνδεσης |  |  |  |  | allowWhenServiceDown |  |
|  |  | Μηνύματα απαγόρευσης |  |  |  |  | langMessages |  |
|  |  |  | Μήνυμα απαγόρευσης |  |  |  |  | langMessage |
|  |  |  |  |  | Κωδικός γλώσσας |  |  | langID |
|  |  |  |  |  | Μήνυμα |  |  | constrMsg |
| Ρυθμίσεις σειράς παραγγελιών B2C (Τιμολόγιο) |  |  |  |  |  |  |  | orderSettingsB2CInvoice |
|  |  | Να επιτρέπονται παραγγελίες εκτός σύνδεσης |  |  |  |  | allowWhenServiceDown |  |
|  |  | Μηνύματα απαγόρευσης |  |  |  |  | langMessages |  |
|  |  |  | Μήνυμα απαγόρευσης |  |  |  |  | langMessage |
|  |  |  |  |  | Κωδικός γλώσσας |  |  | langID |
|  |  |  |  |  | Μήνυμα |  |  | constrMsg |
| Ρυθμίσεις σειράς παραγγελιών B2C (Απόδειξη) |  |  |  |  |  |  |  | orderSettingsB2CReceipt |
|  |  | Να επιτρέπονται παραγγελίες εκτός σύνδεσης |  |  |  |  | allowWhenServiceDown |  |
|  |  | Μηνύματα απαγόρευσης |  |  |  |  | langMessages |  |
|  |  |  | Μήνυμα απαγόρευσης |  |  |  |  | langMessage |
|  |  |  |  | Κωδικός γλώσσας |  |  |  | langID |
|  |  |  |  | Μήνυμα |  |  |  | constrMsg |
| Ρυθμίσεις παραγγελιοληψίας χωρών |  |  |  |  |  |  |  | countrySettings |
|  |  | Επιτρέπεται/Απαγορεύεται η παραγγελιοληψία στις παρακάτω χώρες |  |  |  |  | allowCntOrders |  |
|  |  | Χώρες |  |  |  |  | countries |  |
|  |  |  | Χώρα |  |  |  |  | country |
|  |  |  |  | Κωδικός ISO χώρας |  |  |  | isoCode |
|  |  |  |  | Επιτρέπονται/ Απαγορεύονται Παραγγελίες |  |  |  | orders |
|  |  |  |  | Επιτρέπονται/ Απαγορεύονται Αποστολές |  |  |  | dispatch |
| Ομάδες χρωμάτων |  |  |  |  |  |  |  | colorGroups |
|  |  | Ομάδα χρώματος |  |  |  |  | colorGroup id="*num*" |  |
|  |  |  | Μετάφραση ομάδας χρ. |  |  |  |  | cgPerLang langid="*num*" |
|  |  |  |  | Τίτλος |  |  |  | title |
|  |  |  |  | RGB |  |  |  | rgb |
|  |  |  |  | Εικόνα υφής |  |  |  | image |
| Ανατευθύνσεις σελίδων ιστοτόπου |  |  |  |  |  |  |  | redirections |
|  |  | Ανακατεύθυνση σελίδας ιστοτόπου |  |  |  |  | Redirection id="*num*" |  |
|  |  |  | Παλαιό URL |  |  |  |  | oldurl |
|  |  |  | Νέο URL |  |  |  |  | newurl |
| Εικονίδιο ιστοσελίδας (favicon) |  |  |  |  |  |  |  | favicon |
| Χώρες |  |  |  |  |  |  |  | countries |
|  |  | Χώρα |  |  |  |  | country cntid="*num*" |  |
|  |  |  | Περιγραφή |  |  |  |  | name langid="*num*" |
| Πληρωμές (παλαιός τρόπος) |  |  |  |  |  |  |  | payment |
|  |  |  |  |  |  | Πιστωτική κάρτα |  | creditCard |
|  |  |  |  |  |  | Αντικαταβολή |  | onDelivery |
|  |  |  |  |  |  | Κόστος αντικαταβολής |  | onDeliveryCost |
|  |  |  |  |  |  | Παραλαβή από κατάστημα |  | shopPickup |
|  |  |  |  |  |  | Email για PayPal |  | merchantemail |
|  |  |  |  |  |  | Token για PayPal |  | merchanttoken |
|  |  |  |  |  |  | Κωδικός επιβάρυνσης αντικαταβολής |  | onDeliveryChargeCode |
|  |  |  |  |  |  | Κωδικός επιβάρυνσης αποστολών |  | CourrierChargeCode |
| Πληρωμές |  |  |  |  |  |  |  | payments |
|  |  | Τρόπος πληρωμής |  |  |  |  | payment |  |
|  |  |  | Κωδικός τρ. πληρωμής |  |  |  |  | id |
|  |  |  | Ενεργός |  |  |  |  | isActive |
|  |  |  | Παράμετροι τρ. πληρωμής ** |  |  |  |  | payDefs |
|  |  |  | Τιμές παραμέτρων ** |  |  |  |  | payValues |
|  |  |  | Κόστος επιβάρυνσης |  |  |  |  | payCharge |
|  |  |  | Περιγραφή τρ. πληρωμής |  |  |  |  | payDescrLang |
|  |  |  |  | Γλώσσα |  |  |  | langid |
|  |  |  |  | Περιγραφή |  |  |  | payDescr |
|  |  |  |  | Μήνυμα |  |  |  | payMsg |
| Κωδικοί επιβαρύνσεων |  |  |  |  |  |  |  | chargeCode |
|  | Κωδικός επιβάρυνσης αντικαταβολής |  |  |  |  |  |  | onDeliveryChargeCode |
|  | Κωδικός επιβάρυνσης αποστολών |  |  |  |  |  |  | CourrierChargeCode |
| Ρυθμιση web service |  |  |  |  |  |  |  |  |
|  |  |  |  |  |  | Διεύθυνση |  | url |
|  |  |  |  |  |  | Χρήστης |  | username |
|  |  |  |  |  |  | Συνθηματικό |  | password |
| Τύπος πελάτη B2C* |  |  |  |  |  |  |  | hasGeneralClient |
| Κλειδί γενικού πελάτη B2C* |  |  |  |  |  |  |  |  |
| Γενικό e-mail επικοινωνίας |  |  |  |  |  |  |  | email |
| Κωδικός ηλ. Πληρωμών εμπόρου (παλαιός τρόπος) |  |  |  |  |  |  |  | merchantID |

**Σημ. *{**}Υπάρχει δυνατότητα να δημιουργηθεί πελάτης στο ERP αντίστοιχα με τους πελάτες του ιστότοπου ή να υπάρχει ένας γενικός πελάτης ERP για όλους τους πελάτες του ιστότοπου. Αυτό καθορίζεται από το πεδίο <hasGeneralClient> που παίρνει τιμές 0 ή 1, σε περίπτωση που είναι 1 το <generalClientID> καθορίζει το κλειδί πελάτη που θα χρησιμοποιηθεί στην επικοινωνία από ιστότοπο προς ERP.  
*Σημ. *** Οι παράμετροι και οι τιμές παραμέτρων έρχονται με string διαχωρισμένα με ';'. Η αντιστοιχία τους είναι 1-1 

## > Macro (anchor)

> Macro (anchor)

Γλώσσες ιστότοπου

|  |  |  |
| --- | --- | --- |
| **Πεδίο ERP** |  | **Κόμβος XML** |
| Κλειδί |  | id |
| Περιγραφή |  | name |
| Κωδικός (EL, EN, FR κλπ) |  | abbrev |
| Ενεργή |  | isActive |
| Μεταφράσεις λεκτικών |  | webCaptions |
|  | Λεκτικό ανά τύπο(**domainkind)** **1** : Λεκτικό τιμής είδους (σε συνδιασμό με **[priceUsed](#CMS_B2B_B2Cprotocol-_Είδη)** **=4**) | caption domainkind="*num*" |

  
  


## > Macro (anchor)

Banners

|  |  |
| --- | --- |
| **Πεδίο ERP** | **Κόμβος XML** |
| Κλειδί | id |
| Κλειδί γλώσσας | langid |
| Θέση | position |
| Εικόνα* | image |
| Σύνδεσμος (URL)* | link |
| Script* | script |
| Αρχείο flash* | swf |
| Τίτλος banner | title |

**Σημ.**Οι πιθανοί συνδιασμοί είναι εικόνα και σύνδεσμος, script ή αρχείο flash.

## > Macro (anchor)

Σελίδες ιστότοπου

|  |  |
| --- | --- |
| **Πεδίο ERP** | **Κόμβος XML** |
| Κλειδί | id |
| Κλειδί γλώσσας | langid |
| Τίτλος | title |
| Τίτλος (html) | htmltitle |
| Λέξεις κλειδιά | keywords |
| Περιγραφή | description |
| Περίληψη | summary |
| Περιεχόμενο (html format text) | content |
| Σειρά εμφάνισης | order |
| Κλειδί μητρικής σελίδας | parentId |
| Ορατή | isvisible |
| Τοποθέτηση στο υποσέλιδο | isforfooter |
| Τοποθέτηση στο μενού | isformenu |
| Τοποθέτηση στην κεφαλίδα | isfortoplinks |
| Ειδική θέση | specialHotSpot |
| Εικόνα | photo |
| Ειδική εικόνα κεφαλίδας κειμένου | topBanner |


## > Macro (anchor)

Κατηγορίες νέων

|  |  |
| --- | --- |
| **Πεδίο ERP** | **Κόμβος XML** |
| Κλειδί | id |
| Κλειδί γλώσσας | langid |
| Ενεργή | isActive |
| Τίτλος | title |
| Σειρά εμφάνισης | order |

## > Macro (anchor)

Τα νέα της εταιρίας

|  |  |
| --- | --- |
| **Πεδίο ERP** | **Κόμβος XML** |
| Κλειδί | id |
| Κλειδί γλώσσας | langid |
| Ενεργό | isActive |
| Κλειδί κατηγορίας νέων | category |
| Τίτλος | title |
| Ημ/νια καταχώρησης | date |
| Περίληψη | summary |
| Περιεχόμενο (html format text) | content |
| Εικόνα | photo |

## > Macro (anchor)

Μοντέλα διαθεσιμότητας

|  |  |  |  |  |  |
| --- | --- | --- | --- | --- | --- |
| **Πεδίο ERP** |  |  |  |  | **Κόμβος XML** |
| Μοντέλο διαθεσιμότητας |  |  |  |  | availmodel |
|  | Κλειδί |  |  | id |  |
|  | Κωδικός |  |  | code |  |
|  | Περιγραφή μοντέλου |  |  | description |  |
|  | Μηνύματα διαθεσιμότητας |  |  | qtyMessages |  |
|  |  | Μήνυμα διαθεσιμότητας |  | qtymessage |  |
|  |  |  | Κλειδί γλώσσας |  | langid |
|  |  |  | Ποσότητα |  | quantity |
|  |  |  | Μήνυμα |  | Availmessage |

  


## > Macro (anchor)

Σημειώσεις:



- Σε περίπτωση που το περιεχόμενο σε html format έχει εικόνες επικολλημένες στο κείμενο, αν αυτές είναι σε τοπική θέση στον Η/Υ του συγγραφέα, θα αποσταλούν ξεχωριστά και θα αντικατασταθεί η διαδρομή μέσα στο κείμενο βάση της απάντησης του ιστότοπου. Μετά θα γίνει η αποστολή του αντίστοιχου XML.


# > Macro (anchor)

Αναλυτική περιγραφή χρήσης του Web Service

## > Macro (anchor)

Γενικά

Η ηλεκτρονική παραγγελιοληψία ανταλλάσσει δεδομένα με το ERP μέσω του αντίστοιχου Web Service. Οι εντολές που μπορούν να χρησιμοποιηθούν είναι :

- ES_CUSTCHECKΈλεγχος ύπαρξης πελάτη
- ES_CUSTBALANCE Οικονομικές κινήσεις πελάτη (χρεώσεις/πιστώσεις)
- ES_ORDERLIST Παραγγελίες πελάτη
- ES_PREPAREORDERΠροετοιμασία καταχώρησης παραγγελίας (παράμετροι)
- ES_CUSTADD Άνοιγμα νέου πελάτη (B2C)
- ES_PREPAY Προεξόφληση παραγγελίας (μέσω πιστωτικής κάρτας)
- DM_INSERT Γενική καταχώρηση (data module)
- DM_LOCATE Γενική άντληση στοιχείων (data module)
- DM_CALC Υπολογισμοί παραστατικών (χωρίς καταχώρηση)
- ES_ ITEMAVAIL Έλεγχος διαθεσιμότητας ειδών
- ES_MATIMAGESΔιαχείριση εικόνων ειδών

  
Πριν ξεκινήσει η χρήση του web service, καλό θα είναι να γίνει ένας έλεγχος για τη διαθεσιμότητα της υπηρεσίας. Η εντολή είναι η **AtlAvail,** η οποία επιστρέφει μηδέν (0) που σημαίνει το Atlantis/xLINE δεν είναι διαθέσιμο ή ένα (1) που σημαίνει το Atlantis/xLINE είναι διαθέσιμο.   
Επίσης για τις εντολές DM_* που αφορούν παραγγελίες θα πρέπει να χρησιμοποιείται το **DMCLASS = TWEBSTORECUSTTRADE** η οποία περιέχει και τις παρακάτω παραμέτρους:

- **LINESIZENUM** : Καταχωρούμε είτε διαβάζουμε το χρώμα βάσει του ID του και όχι του λεκτικού (STORETRADELINES)
- **IsUndoneDescr** : Διαβάζουμε την περιγραφή όσον αφορά την κατάσταση της παραγγελίας (Εκτελεσμένη, ανεκτέλεστη κλπ) (FINTRADE)


## > Macro (anchor)

Αναλυτικά

### > Macro (anchor)

ES_CUSTCHECK.

Για να εγκριθεί ένας Β2Β χρήστης στο e-shop είναι απαραίτητο να προϋπάρχει στο Atlantis ERP και να είναι χαρακτηρισμένος ως πελάτης web. Η απαραίτητη παράμετρος εισόδου είναι το AFM(ΑΦΜ), βάση του οποίου γίνεται η σχετική αναζήτηση. Προαιρετική παράμετρος είναι η GETADDRESS(λήψη διευθύνσεων), η οποία καλεί το Atlantis να επιστρέψει τις διευθύνσεις έδρας και αποστολής.  
Παράδειγμα κλήσης:  
<ATLCOMMAND>  
<ACTDEF>  
<AUTHDATA USER="Atlantis_user" PASSWORD="PW" />  
<ACTDATA ACTION="ES_CUSTCHECK"/>  
<OPTDATA AFM="100000001" GETADDRESS="0" />   
</ACTDEF>  
</ATLCOMMAND>  
Στον παραπάνω έλεγχο πελάτη για ΑΦΜ 100000001 εφόσον πληροί τις προϋποθέσεις το Atlantis θα επιστρέψει το παρακάτω XML:  
<?xml version="1.0" encoding="UTF-8" ?>   
<ATLCOMMAND>  
<ACTDEF/>  
<TABLEDATA/>  
<ACTRESULT RESCODE="0" B2BCODE="1" WELCOMEMSG="δοκιμή 123 τέστ" PLACEORDERS="1"/>  
</ATLCOMMAND>  
που σημαίνει ότι ο πελάτης βρέθηκε στο Atlantis(RESCODE=0) με ID(B2BCODE)=1 και μπορεί να καταχωρήσει παραγγελίες μέσω e-shop. To WELCOMEMSG είναι κείμενο υποδοχής που μπορεί να εμφανιστεί στο χρήστη του e-shop. Το B2BCODE, που επιστρέφεται, είναι για χρήση στις επόμενες εντολές ως KEYVALUE παράμετρος. Σε περίπτωση σφάλματος αποστέλονται τα εξής XML:  
Έλεγχος πελάτη με ΑΦΜ 100000003  
<?xml version="1.0" encoding="UTF-8" ?>   
<ATLCOMMAND>  
<ACTDEF/>  
<TABLEDATA/>  
<ACTRESULT RESCODE="1" ERROR="Δεν υπάρχει καταχωρημένος πελάτης με το ΑΦΜ που δώσατε."/>  
</ATLCOMMAND>   
Έλεγχος πελάτη με ΑΦΜ 100000002  
<?xml version="1.0" encoding="UTF-8" ?>   
<ATLCOMMAND>  
<ACTDEF/>  
<TABLEDATA/>  
<ACTRESULT RESCODE="2" ERROR="Ο πελάτης αυτός δεν είναι χαρακτηρισμένος για καταχώρηση παραγγελιών μέσω web."/>  
</ATLCOMMAND>

### > Macro (anchor)

ES_CUSTBALANCE.

Η εντολή αυτή μπορεί να κληθεί με 2 τρόπους. Στην **πρώτη** περίπτωση το e-shop μπορεί να ζητήσει την καρτέλα με τις κινήσεις του πελάτη έως μια ημ/νια από την αρχή της αντίστοιχης περιόδου. Για παράδειγμα με ορισμένες μηνιαίες περιόδους και αίτηση κινήσεων μέχρι την 18/3/2010, θα επιστραφεί ένα εκ μεταφοράς από ημ/νιες προ της 1/3/2010 και αναλυτικά οι κινήσεις από 1/3/2010 μέχρι και την 18/3/2010. Παράδειγμα αιτήματος XML:  
<ATLCOMMAND>  
<ACTDEF>  
<AUTHDATA USER="altec" PASSWORD="" />  
<ACTDATA ACTION="ES_CUSTBALANCE" KEYVALUE="1"/>  
<OPTDATA TODATE="18/03/2010"/>  
</ACTDEF>  
</ATLCOMMAND>  
Στην **δεύτερη** περίπτωση μπορούν να ζητηθούν κινήσεις από – έως ημερομηνία. Για παράδειγμα με οριμένες μηνιαίες περιόδους και αίτηση κινήσεων από την 4/3/2010 έως και την 18/3/2010, θα επιστραφεί εκ μεταφοράς από ημ/νίες προ της 4/3/2010 και αναλυτικά οι κινήσεις από 4/3/2010 έως και την 18/3/2010. Παράδειγμα αιτήματος XML:  
<ATLCOMMAND>  
<ACTDEF>  
<AUTHDATA USER="altec" PASSWORD="" />  
<ACTDATA ACTION="ES_CUSTBALANCE" KEYVALUE="1"/>  
<OPTDATA FROMDATE = "04/03/2010" TODATE="18/03/2010"/>  
</ACTDEF>  
</ATLCOMMAND>  
Η απάντηση και στις 2 περιπτώσεις θα είναι:  
<?xml version="1.0" encoding="UTF-8" ?>  
<ATLCOMMAND>  
<ACTDEF/>  
<TABLEDATA>  
<CUSTBALANCE>  
<RECDATA>  
<UREC ID="-1" TRNDATE="0" TRADECODE="-1" JUSTIFICATION="Εκ μεταφοράς" CREDIT="30" DEBIT="148,04" BALANCE="118,04"/>  
<UREC ID="24" TRNDATE="06/04/2010" TRADECODE="00ΠΑΡ0000003" JUSTIFICATION="ΠΑΡΑΓΓΕΛΙΑ ΑΠΟ ΠΕΛΑΤΗ" CREDIT="0" DEBIT="0" BALANCE="118,04"/>  
<UREC ID="25" TRNDATE="07/04/2010" TRADECODE="00ΤΔΑ0000035" JUSTIFICATION="ΤΙΜΟΛΟΓΙΟ ΠΩΛΗΣΗΣ" CREDIT="0" DEBIT="35,34" BALANCE="153,38"/>  
</RECDATA>  
</CUSTBALANCE>  
</TABLEDATA>  
<ACTRESULT RESCODE="0"/>  
</ATLCOMMAND>  
Το attribute ID είναι το κλειδί της κίνησης για χρήση σε αιτήματα ανάλυσής της, το TRNDATE είναι η ημ/νια της κίνησης, το TRADECODE είναι ο αριθμός παραστατικού, το JUSTIFICATION η αιτιολογία/περιγραφή της κίνησης, τα CREDIT/DEBIT είναι πίστωση/χρέωση αντίστοιχα και το BALANCE είναι το υπόλοιπο του πελάτη.   
Σε περίπτωση που η ημ/νια είναι εκτός χρήσεων και περιόδων, επιστρέφει XML σφάλματος:  
<?xml version="1.0" encoding="UTF-8" ?>  
<ATLCOMMAND>  
<ACTDEF/>  
<TABLEDATA/>  
<ACTRESULT RESCODE="1" ERROR="Η ημερομηνία είναι εκτός χρήσεων και περιόδων."/>  
</ATLCOMMAND> 

### > Macro (anchor)

> Macro (anchor)

ES_ORDERLIST.

Με αυτό το αίτημα εμφανίζεται στο χρήστη/πελάτη του e-shop μια λίστα με τις παραγγελίες που έχει θέσει και την κατάστασή τους (εκκρεμεί, μερικώς εκτελεσμένη και εκτελεσμένη) για την ημ/νια επιλογής και 1 μήνα(30 ημέρες) πίσω.Η εμφανιζόμενη λίστα περιέχει τις παραγγελίες που έχουν καταχωρηθεί έως την ημερομηνία επιλογής (παράμετρος DATE) και σύμφωνα με την παράμετρο NUMDAYS.   
Οι παράμετροι που δέχεται στο node <OPTDATA> είναι:

- DATE(ημ/νια επιλογής)
- NUMDAYS, εάν δεν δηλωθεί στη κλήση θα εμφανιστούν οι εγγραφές των τελευταίων 30 ημερών. Εάν δηλωθεί με τιμή 0, θα εμφανιστούν μόνο οι εγγραφές της ημερομηνίας που έχει δηλωθεί στην παράμετρο DATE. Τέλος αν δηλωθεί ακέραια τιμή <> 0 θα φέρει τις εγγραφές από την ημερομηνία επιλογής (DATE) μείον τόσες μέρες, όση είναι η τιμή της.
- ONLYWEB με τιμές «0» οπότε θα επιστραφούν όλες οι παραγγελίες του πελάτη ή «1» οπότε θα φέρει όσες παραγγελίες έχουν γίνει από το e-shop. Αν δεν υπάρχει θεωρείται πάντα με τιμή «1».
- FTRIDS το οποίο δέχεται τα ID των παραγγελιών, που θέλουμε να εμφανίσουμε, χωρισμένα με κόμμα.
- BRAID (προαιρετικά) για αναφορά σε συγκεκριμένο υποκατάστημα
- CUSBRAID (προαιρετικά) για αναφορά σε συγκεκριμένο υποκατάστημα πελάτη. Με τιμή **-1** φέρνει μόνο τις παραγγελίες που **δεν** έχουν υποκατάστημα πελάτη

Παράδειγμα XML αιτήματος:  
<ATLCOMMAND>  
<ACTDEF>  
<AUTHDATA USER="unisoftaltec" PASSWORD="" />  
<ACTDATA ACTION="ES_ORDERLIST" KEYVALUE="1"/>  
<OPTDATA DATE="2/5/2010" NUMDAYS="15" ONLYWEB="0" FTRIDS="11,34,36" BRAID="1" CUSBRAID="1" />  
</ACTDEF>  
</ATLCOMMAND>   
  
  
  
  
  
  
  
  
XML απάντησης:  
<?xml version="1.0" encoding="UTF-8" ?>  
<ATLCOMMAND>  
<ACTDEF/>  
<TABLEDATA>  
<ORDERLIST>  
<RECDATA>   
<UREC FTRID="11" DATE="18/03/2010" INVOICE="00ΠΑΡ0000001" AMOUNT="115,43" STATUS="Εκτελεσμένη"/>  
<UREC FTRID="34" DATE="06/04/2010" INVOICE="00ΠΑΡ0000003" AMOUNT="94,49" STATUS="Μερικώς εκτελεσμένη"/>  
<UREC FTRID="36" DATE="07/04/2010" INVOICE="00ΤΔΑ0000035" AMOUNT="35,34" STATUS="Εκτελεσμένη"/>  
</RECDATA>  
</ORDERLIST>  
</TABLEDATA>  
<ACTRESULT RESCODE="0"/>  
</ATLCOMMAND>  
Τα attributes που επιστρέφονται είναι FTRID κλειδί παραγγελίας για χρήση σε αιτήματα ανάλυσης, DATE ημ/νια της παραγγελίας, INVOICE σχετικό παραστατικό, AMOUNT αξία παραγγελίας και STATUS η κατάστασή της. Με τις κλήσεις web service της ομάδας DM_* είναι δυνατή περαιτέρω επεξεργασία με έναρξη τη λίστα. 

### > Macro (anchor)

ES_PREPAREORDER.


> Macro (unmigrated-wiki-markup)


### > Macro (anchor)

ES_CUSTADD.

Με αυτό το ρήμα ένας ιστότοπος ενεργοποιημένος ως B2C e-shop, έχει τη δυνατότητα να προσθέτει πελάτες στο ERP που θα αντιστοιχούν στους πελάτες/χρήστες του. Χρειάζεται 2 παραμέτρους NAME & AFM, με υποχρεωτική τιμή στο NAME. Παράδειγμα XML αιτήματος:  
<?xml version="1.0" encoding="UTF-8" ?>  
<ATLCOMMAND>  
<ACTDEF>  
<AUTHDATA USER="unisoft" PASSWORD="" />  
<ACTDATA ACTION="ES_CUSTADD" />  
<OPTDATA NAME="Πελάτης Λιανικής 1" AFM="100000001"/>  
</ACTDEF>  
</ATLCOMMAND>  
XML απάντησης:  
<?xml version="1.0" encoding="UTF-8" ?>   
<ATLCOMMAND>  
<ACTDEF/>  
<TABLEDATA/>  
<ACTRESULT RESCODE="0" CUSID="1"/>  
</ATLCOMMAND>  
Σε περίπτωση σφάλματος επιστρέφεται αντίστοιχο μήνυμα από το ERP και RESCODE=1.   
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  


### > Macro (anchor)

ES_ITEMAVAIL

Υπάρχει η δυνατότητα ελέγχου διαθεσιμότητας ειδών. Αυτό μπορεί να γίνει με κλήση στο web service με το ρήμα ES_ITEMAVAIL. Οι παράμετροι κλήσης είναι:

1. ITEID: Είναι το ID του είδους (αριθμητικό πεδίο). Υποχρεωτική παράμετρος, αν δεν υπάρχει επιστρέφει σφάλμα με κωδικό 1 και μήνυμα «Είναι απαραίτητο να οριστεί το ID του είδους.», εκτός αν ορισθεί ITEIDS.
2. ITEIDS: Τα IDS των ειδών, σε περίπτωση που ζητηθούν υπόλοιπα πολλών ειδών. Δεν λειτουργεί για χρώματα/μεγέθη. Δεν πρέπει να δίνεται ταυτόχρονα με το ITEID.
3. CUSKIND: Είναι ο τύπος πελάτη (string πεδίο). Δέχεται 2 τιμές «B2B» & «B2C». Υποχρεωτική παράμετρος, αν δεν υπάρχει επιστρέφει σφάλμα με κωδικό 3 και μήνυμα «Είναι απαραίτητο να οριστεί κωδικός πελάτη (B2B ή B2C).».
4. LANGID: Το ID της γλώσσας που θα επιστραφεί το μήνυμα. Αν δεν οριστεί θεωρείται πάντα 1 (κύρια γλώσσα). Προαιρετικό.
5. SIZE: Το ID του μεγέθους. Χρειάζεται μόνο όταν θέλουμε να δούμε διαθεσιμότητα σε χρώμα/μέγεθος. Προαιρετικό.
6. COLOR: Ο κωδικός του χρώματος. Χρειάζεται μόνο όταν θέλουμε να δούμε διαθεσιμότητα σε χρώμα/μέγεθος. Προαιρετικό.
7. CSMODE: Τύπος απάντησης Χ/Μ. Προαιρετικό. Οι διαθέσιμες τιμές είναι

- 'ALL': Δεν πρέπει να έχουν συμπληρωθεί οι παράμετροι 'COLOR' και 'SIZE'. Επιστρέφονται τα υπόλοιπα ανά Χ/Μ και τα συνολικά υπόλοιπα του είδους
- 'PERSIZE': Πρέπει να έχει συμπληρωθεί η παράμετρος 'SIZE' και όχι η παράμετρος 'COLOR'. Επιστρέφονται τα υπόλοιπα ανά Χ/Μ για το συγκεκριμένο μέγεθος καθώς και τα συνολικά υπόλοιπα του μεγέθους.
- 'PERCOLOR': Πρέπει να έχει συμπληρωθεί η παράμετρος 'SIZE' και όχι η παράμετρος 'COLOR'. Επιστρέφονται τα υπόλοιπα ανά Χ/Μ για το συγκεκριμένο χρώμα καθώς και τα συνολικά υπόλοιπα του χρώματος.

  
Παράδειγμα XML αιτήματος για **απλό είδος**:  
<ATLCOMMAND>  
<ACTDEF>  
<AUTHDATA USER="unisoftaltec" PASSWORD="" />  
<ACTDATA ACTION="ES_ITEMAVAIL" />  
<OPTDATA ITEID="23" CUSKIND="B2C" LANGID="1" />  
</ACTDEF>  
</ATLCOMMAND>

  
  
  
  
<ATLCOMMAND>  
<ACTDEF/>  
<TABLEDATA>  
<STOCKANALYSIS>  
<RECDATA>  
<UREC JUSTIFICATION="Πώληση" PROSPMODE="0" TIEDMODE="1" EXPECTED="0" TIED="4"/>  
<UREC ESTDATE="04/03/2011" JUSTIFICATION="Πώληση" PROSPMODE="0" TIEDMODE="1" EXPECTED="0" TIED="1"/>  
</RECDATA>  
</STOCKANALYSIS>  
</TABLEDATA>  
<ACTRESULT STOREQTY="65" AVAILQTY="61" RESCODE="0" STOCKACTION="0" AVAILMSG="Το είδος είναι άμεσα διαθέσιμο"/>  
</ATLCOMMAND>  
XML Απάντησης για **απλό είδος**:   
  
  
  
  
  
  
  
Παράδειγμα XML αιτήματος για **πολλά** **απλά είδη**:  
<ATLCOMMAND>  
<ACTDEF>  
<AUTHDATA USER="unisoftaltec" PASSWORD="" />  
<ACTDATA ACTION="ES_ITEMAVAIL" />  
<OPTDATA ITEIDS="92233,92244,92246" CUSKIND="B2C" LANGID="1" />  
</ACTDEF>  
</ATLCOMMAND>

  
  
  
  
<ATLCOMMAND>  
<ACTDEF/>  
<TABLEDATA>  
<RESULTANALYSIS>  
<RECDATA>  
<UREC AVAILMSG="Μη διαθέσιμο" STOCKACTION="0" AVAILQTY="0" STOREQTY="0" ITEID="92244"/>  
<UREC AVAILMSG="Μη διαθέσιμο" STOCKACTION="0" AVAILQTY="-1" STOREQTY="0" ITEID="92246"/>  
<UREC AVAILMSG="Μη διαθέσιμο" STOCKACTION="0" AVAILQTY="0" STOREQTY="" ITEID="92233"/>  
</RECDATA>  
</RESULTANALYSIS>  
<STOCKANALYSIS>  
<RECDATA>  
<UREC ITEID="92244" TIED="14" EXPECTED="0" TIEDMODE="1" PROSPMODE="0" JUSTIFICATION="Πώληση"/>  
<UREC ITEID="92246" TIED="24" EXPECTED="0" TIEDMODE="1" PROSPMODE="0" JUSTIFICATION="Πώληση"/>  
<UREC ITEID="92246" TIED="1" EXPECTED="0" TIEDMODE="2" PROSPMODE="0" JUSTIFICATION="Πώληση"/>  
<UREC ITEID="92233" TIED="4" EXPECTED="0" TIEDMODE="3" PROSPMODE="0" JUSTIFICATION="Πώληση"/>  
</RECDATA>  
</STOCKANALYSIS>  
</TABLEDATA>  
<ACTRESULT/>  
</ATLCOMMAND>  
XML Απάντησης για **πολλά** **απλά είδη**:   
  
  
  
  
  
  
  
  
  
  
  
  
  
<ATLCOMMAND>  
<ACTDEF>  
        <AUTHDATA USER="unisoftaltec" PASSWORD="" />  
        <ACTDATA ACTION="ES_ITEMAVAIL" />  
        <OPTDATA ITEID="16" CUSKIND="B2C" LANGID="1" SIZE="1" COLOR="blue" />  
     </ACTDEF>  
</ATLCOMMAND>  
Παράδειγμα XML αιτήματος για **είδος** **με** **χρώμα/μέγεθος**:   
  
  
  
<ATLCOMMAND>  
<ACTDEF/>  
<TABLEDATA/>  
<ACTRESULT STOREQTY="6" AVAILQTY="8" RESCODE="0" AVAILMSG=" Το είδος είναι περιορισμένης διαθεσιμότητας." EXPECTEDPURCH="2" EXPECTEDPROD="0" TIEDSALES="0" STOCKACTION="0"/>  
</ATLCOMMAND>  
XML Απάντησης για **είδος με χρώμα / μέγεθος**:   
  
  
  
  
  
<ATLCOMMAND>  
<ACTDEF>  
        <AUTHDATA USER="unisoftaltec" PASSWORD="" />  
        <ACTDATA ACTION="ES_ITEMAVAIL" />  
        <OPTDATA ITEID="63" CUSKIND="B2C" LANGID="1" SIZE="1" CSMODE="PERSIZE" />  
     </ACTDEF>  
</ATLCOMMAND>  
Παράδειγμα XML αιτήματος για **είδος με χρώμα/μέγεθος και τύπο απάντησης**:   
  
  
  
<ATLCOMMAND>  
<ACTDEF/>  
<TABLEDATA>  
<STOCKANALYSIS>  
<RECDATA>  
<UREC COLOR="RED" SIZE="1" STOREQTY="2" AVAILQTY="8" EXPECTEDPURCH="8" EXPECTEDPROD="0" TIEDSALES="2" />  
<UREC COLOR="RED" SIZE="2" STOREQTY="2" AVAILQTY="11" EXPECTEDPURCH="9" EXPECTEDPROD="0" TIEDSALES="0" />  
</RECDATA>  
</STOCKANALYSIS>  
</TABLEDATA>  
<ACTRESULT STOREQTY="4" AVAILQTY="19" RESCODE="0" AVAILMSG=" Το είδος είναι περιορισμένης διαθεσιμότητας." EXPECTEDPURCH="17" EXPECTEDPROD="0" TIEDSALES="2" STOCKACTION="0"/>  
</ATLCOMMAND>  
XML Απάντησης για **είδος με χρώμα / μέγεθος και τύπο απάντησης**:   
  
  
  
  
  
  
  
  
  
  
  
  
Επεξήγηση απάντησης:  
Απλό είδος

1. STOREQTY: Η ποσότητα που υπάρχει αυτή τη στιγμή στην αποθήκη.
2. AVAILQTY: Η ποσότητα που είναι διαθέσιμη για παραγγελία μετά τους υπολογισμούς.
3. RESCODE: Κωδικός απάντησης. 0=επιτυχία, >0 σφάλμα ή παρατήρηση.
4. AVAILMSG: Μήνυμα διαθεσιμότητας.

Είδος με χρώμα/μέγεθος

1. STOREQTY: Η ποσότητα που υπάρχει αυτή τη στιγμή στην αποθήκη.
2. AVAILQTY: Η ποσότητα που είναι διαθέσιμη για παραγγελία μετά τους υπολογισμούς.
3. RESCODE: Κωδικός απάντησης. 0=επιτυχία, >0 σφάλμα ή παρατήρηση.
4. AVAILMSG: Μήνυμα διαθεσιμότητας.
5. EXPECTEDPURCH: Αναμενόμενα από αγορές.
6. EXPECTEDPROD: Αναμενόμενα από παραγωγή.
7. TIEDSALES: Δεσμευμένα από πωλήσεις.
8. STOCKACTION: Συμπεριφορά ελέγχου υπολοίπου. **0**: Επιτρέπεται backorder παραγγελία **1**: Απαγορεύεται backorder παραγγελία. **2**: Επιτρέπεται backorder παραγγελία (Απαγόρ. Λογ. Υπολ)

  
Στο απλό είδος υπάρχει και ένας πίνακας στην απάντηση με πρόσθετα στοιχεία σχετικά με τα αναμενόμενα δεσμευμένα, όπως ημ/νια, τύπος δεσμευμένου/αναμενόμενου και σχετικές ποσότητες. 

### > Macro (anchor)

ES_PREPAY.

Αυτό το ρήμα χρησιμοποιείται για την προεξόφληση μέσω πιστωτικής κάρτας της παραγγελίας B2C πελάτη. Δέχεται 6 παραμέτρους το FTRID που είναι το κλειδί της παραγγελίας, το κλειδί του πελάτη CUSID, το κλειδί της σειράς παραγγελίας DSRID, το συνολικό ποσό παραγγελίας AMOUNT , τον αριθμό της πιστωτικής κάρτας CARDNUM σε μορφή «1234-*****-*****-5678», προαιρετικά την ημερομηνία του εξοφλητικού παραστατικού PAYDATE και προαιρετικά την GLUPDATED με τιμή 0 αν θέλουμε να δημιουργηθεί άρθρο λογιστικής ή 1 για να μη δημιουργηθεί άρθρο. Στην περίπτωση που δεν έχει εισαχθεί PAYDATE, η ημερομηνία συμπίπτει με την ημερομηνία του παραστατικού παραγγελίας. Στην περίπτωση που δεν έχει εισαχθεί η GLUPDATED, η προκαθορισμένη τιμή είναι 1. Παράδειγμα XML αιτήματος:  
<?xml version="1.0" encoding="UTF-8" ?>  
<ATLCOMMAND>  
<ACTDEF>  
<AUTHDATA USER="unisoftaltec" PASSWORD="" />  
<ACTDATA ACTION="ES_PREPAY" />  
<OPTDATA FTRID="27" CUSID="1" DSRID="9002" AMOUNT="298.16" CARDNUM="1234-*****-*****-5678" PAYDATE="21/4/2012" GLUPDATED=0/>  
</ACTDEF>  
</ATLCOMMAND>  
XML απάντησης: <?xml version="1.0" encoding="UTF-8" ?>   
<ATLCOMMAND>  
<ACTDEF/>  
<TABLEDATA/>  
<ACTRESULT RESCODE="0" SUCCESS="Επιτυχής εξόφληση"/>  
</ATLCOMMAND>Σε περίπτωση σφάλματος επιστρέφεται αντίστοιχο μήνυμα από το ERP και RESCODE=1   


### > Macro (anchor)

ES_MATIMAGES

Αυτό το ρήμα χρησιμοποιείται για την προβολή ή τροποποίηση των εικόνων του eshop καθώς και των εικόνων των υφών του χρωματολογίου. Οι παράμετροι κλήσης είναι:

1. ITEID : Το ID του είδους (αριθμητικό πεδίο). Υποχρεωτική παράμετρος.
2. ACTION : Επιθυμητή ενέργεια (string πεδίο) . Οι τιμές είναι:

- "GET" : Για την προβολή των εικόνων του είδους. Οι εικόνες επιστρέφονται στο XML σε Base64 μορφή.
- "SET" : Για την τροποποίηση των εικόνων του είδους

  
Στην περίπτωση του ACTION "GET", υπάρχει επίσης και η παράμετρος 'COLORCODE' για να επιστραφούν εικόνες μόνο ενός συγκεκριμένου χρώματος.  
Στην περίπτωση που του ACTION έχει οριστεί ως "SET", υπάρχουν άλλες δύο παράμετροι κλήσης που έχουν να κάνουν με τη μορφή των εικόνων:

1. LOADTYPE : Τρόπος φόρτωσης φωτογραφιών από το WebService (string πεδίο). Οι τιμές είναι:

- "BINARY" : Οι τιμές των πεδίων των εικόνων πρέπει να είναι σε Base 64 κωδικοποιημένη μορφή
- "LOCALPATH" : Οι τιμές των πεδίων των εικόνων πρέπει να είναι οι διαδρομές των αρχείων εικόνων. Τα αρχεία θα πρέπει να είναι τοποθετημένα σε χώρο 'ορατό' από το WebService.

1. SAVETYPE : Τρόπος αποθήκευσης των φωτογραφιών στο ERP (string πεδίο). Οι τιμές είναι :

- "BINARY" : Οι εικόνες θα αποθηκευτούν στη βάση στην binary μορφή τους
- "LOCALPATH" : Τη βάση θα αποθηκευτεί η διαδρομή των εικόνων. **Δεν ισχύει** όταν το LOADTYPE="BINARY"

Στα πεδία των εικόνων στην περίπτωση του SET οι πιθανές τιμές (ανάλογα με το LOADTYPE) είναι :

- Η Base64 binary μορφή της εικόνας
- Το local path της εικόνας
- Το λεκτικό "CLEAR" για διαγραφή της εικόνας από το ERP
- Καμία τιμή για μη γίνει καμία μεταβολή της εικόνας

  
Παράδειγμα XML αιτήματος "GET" :  
<ATLCOMMAND>  
<ACTDEF>  
<AUTHDATA USER="altecunisoft" PASSWORD="" />  
<ACTDATA ACTION="ES_MATIMAGES" />  
<OPTDATA ITEID="23" ACTION="GET"/>  
</ACTDEF>  
</ATLCOMMAND>

  
  
  
  
<ATLCOMMAND>  
<ACTDEF />  
<TABLEDATA>  
<MATIMAGES>  
<RECDATA>  
<UREC IMAGE1="" IMAGE2="" IMAGE3="" IMAGE4="" IMAGE5="" />  
</RECDATA>  
</MATIMAGES>  
<SPECIALIMAGES>  
<RECDATA>  
<UREC SPECIALIMAGE="JQEPvQBkxyFWdq" />  
</RECDATA>  
</SPECIALIMAGES>  
<COLORIMAGES>  
<RECDATA>  
<UREC COLORCODE1="ΚΟΚΚΙΝΟ" COLORIMAGE1="" COLORIMAGE1_2="" COLORIMAGE1_3="" COLORIMAGE1_4="" COLORIMAGE1_5="" COLORCODE2="ΠΡΑΣΙΝΟ"  
COLORIMAGE2="" COLORIMAGE2_2="" COLORIMAGE2_3="" COLORIMAGE2_4="" COLORIMAGE2_5="" COLORCODE3="ΜΠΛΕ" COLORIMAGE3="" COLORIMAGE3_2="" COLORIMAGE3_3="" COLORIMAGE3_4="" COLORIMAGE3_5="" />  
</RECDATA>  
</COLORIMAGES>  
<COLORTEXTURES>  
<RECDATA>  
<UREC COLORCODE1="ΚΟΚΚΙΝΟ" COLORTEXTURE1="JQEPvQBkxyFWdq"  
COLORCODE2="ΠΡΑΣΙΝΟ" COLORTEXTURE2="" COLORCODE3="ΜΠΛΕ"  
COLORTEXTURE3="" />  
</RECDATA>  
</COLORTEXTURES>  
</TABLEDATA>  
<ACTRESULT RESCODE="0" />  
</ATLCOMMAND>XML Απάντησης "GET":   
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
<ATLCOMMAND>  
<ACTDEF>  
<AUTHDATA USER="altecunisoft" PASSWORD="" />  
<ACTDATA ACTION="ES_MATIMAGES" />  
<OPTDATA ACTION="SET" ITEID="118" LOADTYPE="LOCALPATH" SAVETYPE="BINARY"/>  
</ACTDEF>  
<TABLEDATA>  
<MATIMAGES>  
<RECDATA>   
<UREG IMAGE1="c:\IMAGE1.JPG" IMAGE2="CLEAR" IMAGE3="" IMAGE4="" IMAGE5="" />  
</RECDATA>  
</MATIMAGES>  
<SPECIALIMAGES>  
<RECDATA>  
<UREG SPECIALIMAGE=""/>  
</RECDATA>  
</SPECIALIMAGES>  
<COLORIMAGES>  
<RECDATA>  
<UREG COLORCODE1="ΚΙΤΡΙΝΟ" COLORIMAGE1="C:\Colimg1.png" />  
</RECDATA>  
</COLORIMAGES>  
<COLORTEXTURES>  
<RECDATA>  
<UREG COLORCODE1="ΚΙΤΡΙΝΟ" COLORTEXTURE1=""/>  
</RECDATA>  
</COLORTEXTURES>  
</TABLEDATA>  
</ATLCOMMAND>Παράδειγμα XML αιτήματος "SET":   
  
  
  
  
  
  
  
  
  
  
  
  
  
XML απάντησης "SET":<ATLCOMMAND>  
<ACTDEF/>  
<TABLEDATA/>  
<ACTRESULT RESCODE="0" SUCCESS="Επιτυχής ενημέρωση εικόνων."/>  
</ATLCOMMAND>   
  
  


### > Macro (anchor)

DM_INSERT

<ATLCOMMAND>  
<ACTDEF>  
<AUTHDATA USER="UNISOFT" PASSWORD="" />  
<ACTDATA ACTION="DM_INSERT" DMCLASS="**TWEBSTORECUSTTRADE**" />  
<OPTDATA METADATA="1" RETNULLS="1" RECNODES="1" />  
</ACTDEF>  
<TABLEDATA>  
<FINTRADE>  
<RECDATA>  
<UREC DSRID="2" FTRDATE="3/01/2009" CUSID="173" />  
</RECDATA>  
</FINTRADE>  
<STORETRADE>  
<RECDATA>  
<UREC GEOID="28" />  
</RECDATA>  
</STORETRADE>  
<STORETRADELINES>  
<RECDATA>  
<UREC ITEID="83042" PRIMARYQTY="3" PRICE="10" />  
<UREC ITEID="82427" PRIMARYQTY="7" PRICE="12" />  
<UREC ITEID="87440" PRIMARYQTY="2" PRICE="20" />  
</RECDATA>  
</STORETRADELINES>  
</TABLEDATA>  
</ATLCOMMAND>  
Παράδειγμα χρήσης   
  
  
  
  
  
  
  
  
  
  
  
  
  


### > Macro (anchor)

DM_LOCATE

<ATLCOMMAND>  
<ACTDEF>  
<AUTHDATA USER=" UNISOFT " PASSWORD="" />  
<ACTDATA ACTION="DM_LOCATE" DMCLASS="**TWEBSTORECUSTTRADE**" KEYVALUE="123" />  
</ACTDEF>  
</ATLCOMMAND>  
Παράδειγμα χρήσης   
  
  
  
  
  
  
  
  


# > Macro (anchor)

Παράρτημα

## > Macro (anchor)

Ονοματολογία αρχείων

- **PROD_**<id είδους>**DET<**0-4**>_**<γλώσσα>.ext : εικόνες είδους 1-5
- **PROD_**<id είδους>***DETCOLIMAGE*****<**κωδικός χρώματος**>_**<γλώσσα>.ext : εικόνα υφής χρωματολογίου είδους ανά χρώμα
- **PROD_**<id είδους>**_**<γλώσσα>.ext : ειδική εικόνα είδους
- **PAGE***<id σελίδας>***BANNER_**<γλώσσα>.ext : Top banner σελίδας
- **PAGE***<id σελίδας>***PHOTO_**<γλώσσα>.ext : φωτογραφία σελίδας
- **BANNER***<id banner>*<γλώσσα>.ext : αρχεία banners
- **MANUF***<id κατασκευαστή>*<γλώσσα>.ext : εικόνα κατασκευαστή
- **CAT***<id κατηγορίας>*<γλώσσα>.ext : εικόνα κατηγορίας
- **NEWS***<id είδησης>*<γλώσσα>.ext : εικόνα είδησης
- **LOGO**.ext : εικόνα (logo) ιστότοπου
- **FAVICON**.ext : εικονίδιο ιστότοπου (favicon)
- **CGIMG***<id ομάδας χρώματος>*<γλώσσα>.ext : εικόνα υφής ομάδας χρώματος
- Για εικόνες και αρχεία που έχουν εισαχθεί από το σχεδιασμό ενημέρωσης ιστότοπου ,ισχύει η ίδια ονοματολογία με prefix **CUSTOM_** (πχ CUSTOM_CAT_32_1.jpg)
- Εικόνες και αρχεία που έχουν εισαχθεί από τον editor (αναλυτικές περιγραφές κλπ.), αποστέλλονται με το όνομά τους