Αναφορά Μορφής XML
Έκδοση: 2.0 — Ιούνιος 2026
Μορφή: Αποκλειστικό XML, ευθυγραμμισμένο με τις συμβάσεις GS1 XML
Το EDIconnect χρησιμοποιεί μορφή XML με κοινή δομή για όλα τα μηνύματα. Αυτή η σελίδα περιγράφει τους γενικούς κανόνες δομής, κωδικοποίησης και επικύρωσης.
Τύποι Εγγράφων
Το πεδίο DocumentType στην κεφαλίδα μηνύματος αναγνωρίζει τον τύπο εγγράφου. Η τιμή καθορίζει πώς επεξεργάζεται το μήνυμα στο σύστημα:
| Μήνυμα | DocumentType | Περιγραφή |
|---|---|---|
| ORDERS | OR |
Εντολή Αγοράς |
| ORDRSP | OA |
Επιβεβαίωση Εντολής (αποδεκτή) |
| ORDRSP | OR |
Απόκριση Εντολής με αλλαγές |
| DESADV | DL |
Ειδοποίηση Αποστολής |
| INVOIC | FV |
Φορολογικό Τιμολόγιο |
| INVOIC | NC |
Πιστωτικό Σημείωμα |
| RECADV | NIR |
Ειδοποίηση Παραλαβής Εμπορευμάτων |
| RECADV | R |
Επιστροφή Εμπορευμάτων |
| RECADV | 70E |
Κατάσχεση (ζημία/καραντίνα) |
| PRICAT | PC |
Κατάλογος Τιμών |
Το πεδίο καθορίζεται στο στοιχείο <DocumentType> εντός του τμήματος <Header> του μηνύματος:
<Header>
<DocumentType>FV</DocumentType>
<DocumentNumber>FACT2024001</DocumentNumber>
<DocumentDate>2024-03-15</DocumentDate>
...
</Header>
Κωδικοποίηση και Δήλωση
<?xml version="1.0" encoding="UTF-8"?>
Όλα τα μηνύματα πρέπει να χρησιμοποιούν κωδικοποίηση UTF-8. Η δήλωση XML είναι υποχρεωτική.
Γενική Δομή
<?xml version="1.0" encoding="UTF-8"?>
<Message>
<Version>2.0</Version>
<Documents>
<{MessageType}>
<Header>
<DocumentType>{type}</DocumentType>
<DocumentNumber>{number}</DocumentNumber>
<DocumentDate>{date}</DocumentDate>
...
</Header>
<{Parties}>
...
</{Parties}>
<Lines>
<Line>...</Line>
</Lines>
<Summary>
...
</Summary>
</{MessageType}>
</Documents>
</Message>
Η έκδοση XML (<Version>) ποικίλλει ανά μήνυμα: όλα τα μηνύματα χρησιμοποιούν v2.0.
Χώροι Ονομάτων
| Μήνυμα | Χώρος ονομάτων |
|---|---|
| ORDERS | urn:azuvio:ediconnect:orders:v1 |
| DESADV | urn:azuvio:ediconnect:desadv:v1 |
| INVOIC | urn:azuvio:ediconnect:invoic:v1 |
| RECADV | urn:azuvio:ediconnect:recadv:v1 |
Μορφές Ημερομηνίας και Ώρας
| Τύπος | Μορφή | Παράδειγμα |
|---|---|---|
| Ημερομηνία | YYYY-MM-DD |
2024-03-15 |
| ΗμερομηνίαΏρα | YYYY-MM-DDTHH:MM:SS |
2024-03-15T14:30:00 |
| ΗμερομηνίαΏρα με ζώνη | ISO 8601 | 2024-03-15T14:30:00+02:00 |
Αριθμητική Μορφή
- Δεκαδικό διαχωριστικό:
.(τελεία, όχι κόμμα) - Χωρίς διαχωριστικά χιλιάδων
- Ποσότητες: έως 3 δεκαδικά ψηφία
- Τιμές: έως 4 δεκαδικά ψηφία
- Χρηματικές αξίες: έως 2 δεκαδικά ψηφία
GLN (Global Location Number)
Τα GLN είναι αριθμητικές συμβολοσειρές 13 ψηφίων. Πάντα να αποστέλλετε ως συμβολοσειρά, με διατήρηση των αρχικών μηδενικών:
<BuyerGLN>0594123456789</BuyerGLN> <!-- σωστό -->
<BuyerGLN>594123456789</BuyerGLN> <!-- λάθος — 12 ψηφία -->
Το GLN και EAN πρέπει πάντα να αποστέλλονται ως συμβολοσειρές, όχι ως ακέραιοι. Ένα GLN όπως 0594123456789 γίνεται 594123456789 εάν αντιμετωπιστεί ως long — ακυρώνοντας τον αναγνωριστή εταίρου.
EAN / GTIN
Οι κωδικοί προϊόντων ακολουθούν το GTIN-13 (EAN-13): αριθμητικές συμβολοσειρές 13 ψηφίων.
Κωδικοί Μονάδας Μέτρησης
Το EDIconnect χρησιμοποιεί κωδικούς UN/ECE Recommendation 20:
| Κωδικός | Περιγραφή |
|---|---|
PCE |
Τεμάχιο |
KGM |
Κιλόγραμμο |
LTR |
Λίτρο |
CTN |
Χαρτόκουτο |
PLT |
Παλέτα |
MTR |
Μέτρο |
SET |
Σετ |
Κωδικοί Νομίσματος
Τριψήφιοι κωδικοί ISO 4217: RON, EUR, USD, GBP.
Όρια Μεγέθους Μηνύματος
| Παράμετρος | Όριο |
|---|---|
| Μέγιστο μέγεθος αρχείου | 10 MB |
| Μέγιστες γραμμές ανά μήνυμα | 9.999 |
| Μέγιστα πακέτα ανά DESADV | 999 |
| Μέγιστα είδη ανά PRICAT | 50.000 |
Επικύρωση XSD
Επικυρώνετε έναντι του αντίστοιχου σχήματος XSD πριν από την αποστολή:
| Μήνυμα | Σχήμα XSD |
|---|---|
| ORDERS | Azuvio-CRMconnect-EDIconnect-ORDERS-v2.0.xsd |
| DESADV | Azuvio-CRMconnect-EDIconnect-DESADV-v2.0.xsd |
| RECADV | Azuvio-CRMconnect-EDIconnect-RECADV-v2.0.xsd |
| INVOIC | Azuvio-CRMconnect-EDIconnect-INVOIC-v2.0.xsd |
Η HTTP μεταφορά επιστρέφει 400 Bad Request με σώμα σφάλματος εάν η επικύρωση αποτύχει.
Κεφαλίδες HTTP (μεταφορά REST)
Content-Type: application/xml; charset=UTF-8
Accept: application/xml
Authorization: Bearer {token}
X-EDI-SenderGLN: {your GLN}
X-EDI-ReceiverGLN: {partner GLN}
X-EDI-MessageType: ORDERS
X-EDI-DocumentType: OR
Η κεφαλίδα X-EDI-DocumentType πρέπει να ταιριάζει με το πεδίο <DocumentType> στο σώμα του μηνύματος.