- Κατευθυντήριες οδηγίες ενοποίησης
- Υποστηριζόμενες δυνατότητες (Άλλες δυνατότητες)
- Συμπληρωματικά δεδομένα
- Δεδομένα επιπέδου II και III
- Δεδομένα επιπέδου II/III για την τράπεζα εμπόρου First Data
Δεδομένα επιπέδου II/III για την τράπεζα εμπόρου First Data
Αυτή η σελίδα περιέχει πρόσθετες λεπτομέρειες ενοποίησης επιπλέον των όσων παρέχονται στον στάνταρ οδηγό ενοποίησης επιπέδου II/III, και αφορά συγκεκριμένα την τράπεζα εμπόρου First Data.
Η πύλη θα υποβάλει δεδομένα του επιπέδου II/III όπως τα παρέχετε στην τράπεζα εμπόρου First Data μόνο αν δώσετε κατ' ελάχιστον τα ακόλουθα πεδία:
- ΤΚ του προορισμού αποστολής (
shipping.address.postcodeZip) - ΤΚ προέλευσης αποστολής (
shipping.origin.postcodeZip, αν δεν παρέχεται, η τιμή όπως διαμορφώνεται στο προφίλ εμπόρου σας μπορεί να υποβληθεί στην τράπεζα εμπόρου.) - Δεδομένα συναλλαγής επιπέδου είδους
- ποσότητα είδους (
transaction.item[n].quantity) - κωδικός προϊόντος είδους (
transaction.item[n].name) - μονάδα μέτρησης είδους (
transaction.item[n].unitOfMeasure) - κωδικός εμπορεύματος είδους (
transaction.item[n].detail.commodityCodeήtransaction.item[n].detail.acquirerCustom ={"XD34_4":"<non-integer item commodity code>"})
- ποσότητα είδους (
- το αναγνωριστικό σας φορολογικής εγγραφής (
order.taxRegistrationId(συνιστάται ιδιαίτερα για την επίτευξη καλύτερων διατραπεζικών προμηθειών))
Δεδομένα επιπέδου II
Για να δώσετε τα ακόλουθα δεδομένα επιπέδου ΙΙ στο αίτημα συναλλαγής σας, χρησιμοποιήστε τα αντίστοιχα πεδία επιπέδου παραγγελίας ή/και επιπέδου συναλλαγής του <<webServicesIntegration>> με τις λεπτομέρειες ενοποίησης όπως φαίνεται στη στήλη "Τιμή πεδίου" στον παρακάτω πίνακα.
| Δεδομένα επιπέδου II | Πεδίο επιπέδου παραγγελίας | Πεδίο επιπέδου συναλλαγής | Τιμή πεδίου |
|---|---|---|---|
| Αναφορά αγοράς εμπόρου | order.referenceΑν δεν δοθεί, η πύλη χρησιμοποιεί την τιμή όπως παρέχεται στο πεδίο order.id (υποχρεωτικό).
|
- |
Αυτό το πεδίο είναι υποχρεωτικό για τις κάρτες Mastercard (έως και 17 χαρακτήρες), αλλά προαιρετικό για τις κάρτες Visa (έως 25 χαρακτήρες). |
| Αριθμός αναφοράς πελάτη/κατόχου κάρτας | order.customerReference |
- |
Αυτό το πεδίο είναι υποχρεωτικό για τις κάρτες Mastercard και Visa. |
| Αριθμός τιμολογίου | order.invoiceNumber |
- |
Αυτό το πεδίο είναι υποχρεωτικό για τις κάρτες Mastercard, αλλά προαιρετικό για τις κάρτες Visa. |
| Ποσό αποστολής και χειρισμού | order.shippingAndHandlingAmount |
transaction.shippingAndHandlingAmount |
Αν παρέχετε ένα ποσό αποστολής και χειρισμού, ίσως χρειαστεί να δώσετε επίσης τα εξής:
|
| Ποσό φόρου | order.taxAmount |
transaction.taxAmount |
Αυτό το πεδίο είναι υποχρεωτικό για τις κάρτες Mastercard, αλλά προαιρετικό για τις κάρτες Visa. |
| Ποσό δασμού | Από την API έκδοση 67 και νεότερη, χρησιμοποιείτε το παρακάτω:order.dutyAmountΓια τις API εκδόσεις νεότερες από 67, χρησιμοποιείτε το παρακάτω: order.tax[n].type=DUTYorder.tax[n].amount |
Από την API έκδοση 67 και νεότερη, χρησιμοποιείτε το παρακάτω:transaction.dutyAmountΓια τις API εκδόσεις νεότερες από 67, χρησιμοποιείτε το παρακάτω: transaction.tax[n].type=DUTYtransaction.tax[n].amount |
- |
Δεδομένα επιπέδου III
Για να δώσετε τα ακόλουθα δεδομένα επιπέδου III στο αίτημα συναλλαγής σας, χρησιμοποιήστε τα αντίστοιχα πεδία επιπέδου παραγγελίας (από την ομάδα παραμέτρων order.item[n]) ή/και επιπέδου συναλλαγής (από την ομάδα παραμέτρων transaction.item[n]) του <<webServicesIntegration>> με τις λεπτομέρειες ενοποίησης όπως φαίνεται στη στήλη "Τιμή πεδίου" στον παρακάτω πίνακα.
| Δεδομένα επιπέδου III | Πεδίο επιπέδου παραγγελίας | Πεδίο επιπέδου συναλλαγής | Τιμή πεδίου |
|---|---|---|---|
| Μονάδα μέτρησης είδους | order.item[n].unitOfMeasure |
transaction.item[n].unitOfMeasure |
Πρέπει να δώσετε τη σωστή τιμή απαρίθμησης όπως απαιτείται από την τράπεζα εμπόρου σας, βλ. Τιμές απαρίθμησης μονάδας μέτρησης είδους. |
| Τύπος φόρου είδους | order.item[n].detail.unitTaxType |
transaction.item[n].detail.unitTaxType |
Πρέπει να δώσετε τη σωστή τιμή απαρίθμησης για τον κωδικό τύπου φόρου όπως απαιτείται από την τράπεζα εμπόρου σας, βλ. Τιμές απαρίθμησης τύπου φόρου. |
| Τύπος φόρου είδους [n] | order.item[n].detail.tax[m].type |
transaction.item[n].detail.tax[m].type |
Μόνο οι λεπτομέρειες που παρέχονται για το πρώτο στοιχείο της λίστας (transaction.item[n].detail.unitTax[1].*) θα υποβληθούν στην τράπεζα εμπόρου. Πρέπει να δώσετε τη σωστή τιμή απαρίθμησης για τον κωδικό τύπου φόρου όπως απαιτείται από την τράπεζα εμπόρου σας, βλ. Τιμές απαρίθμησης τύπου φόρου. |
| Κωδικός εμπορεύματος είδους | order.item[n].detail.acquirerCustom ={"XD34_4":"<non-integer item commodity code>"} |
transaction.item[n].detail.acquirerCustom ={"XD34_4":"<non-integer item commodity code>"} |
Χρησιμοποιήστε αυτό το πεδίο αν θέλετε να υποβάλετε έναν μη ακέραιο κωδικό εμπορεύματος για ένα στοιχείο γραμμής. Για να υποβάλετε έναν αριθμητικό κωδικό εμπορεύματος για ένα στοιχείο γραμμής, μπορείτε να υποβάλετε στα πεδία order.item[n].detail.commodityCode ή transaction.item[n].detail.commodityCode. |
Τιμές απαρίθμησης τύπου φόρου
Παρέχετε τη σωστή τιμή απαρίθμησης τύπου φόρου στα πεδία order.item[n].detail.unitTaxType ή/και transaction.item[n].detail.unitTaxType
| Κωδικός τύπου φόρου | Περιγραφή |
|---|---|
| 00 | Άγνωστο |
| 01 | Ομοσπονδιακός/εθνικός φόρος επί των πωλήσεων |
| 02 | Πολιτειακός φόρος επί πωλήσεων |
| 03 | Φόρος επί πωλήσεων πόλης |
| 04 | Τοπικός φόρος επί πωλήσεων |
| 05 | Δημοτικός φόρος επί πωλήσεων |
| 06 | Άλλος φόρος |
| 10 | Φόρος προστιθέμενης αξίας (ΦΠΑ) |
| 11 | Φόρος αγαθών και υπηρεσιών (GST) |
| 12 | Περιφερειακός φόρος επί πωλήσεων |
| 20 | Φόρος δωματίου |
| 21 | Φόρος πληρότητας |
| 22 | Φόρος ενέργειας |
Τιμές απαρίθμησης μονάδας μέτρησης είδους
Παρέχετε τη σωστή τιμή απαρίθμησης μονάδας μέτρησης για είδη γραμμής στα πεδία order.item[n].unitOfMeasure ή/και transaction.item[n].unitOfMeasure
| Κωδικός μονάδας μέτρησης είδους | Περιγραφή |
|---|---|
| ACR | Έικρ (4840 yd2) |
| ASM | Κατά μάζα αλκοολικός τίτλος |
| ASV | Κατά όγκο αλκοολικός τίτλος |
| AMP | Αμπέρ |
| AMH | Αμπερώρα (3,6 kC) |
| ARE | ;Έιρ (100 m2) |
| BAR | Bar |
| BLL | Βαρέλι (πετρελαίου) (158,987 dm3) |
| BFT | Μετρικό πόδι ξυλείας |
| BQL | Μπεκερέλ |
| BIL | Δισεκατομμύρια ευρώ |
| MLD | Δισεκατομμύρια δολάρια ΗΠΑ |
| BX | ox |
| BHP | Ιπποδύναμη πέδησης (245,7 W) |
| BTU | Βρετανική θερμική μονάδα (1,055 kilojoules) |
| BUA | Μπούσελ (35,2391 dm3) |
| BUI | Μπούσελ (36,36874 dm3) |
| CDL | Κηρίο |
| CCT | Μεταφορική ικανότητα σε μετρικούς τόνους |
| CS | ase |
| CNT | Cental GB (45,359237 kg) |
| CGM | Εκατοστόγραμμο |
| CLT | Εκατοστόλιτρο |
| CMT | Εκατοστόμετρο |
| DTN | Centner, μετρικό (100 kg) (συνώνυμο: δεκατόνος) |
| WCD | Cord (3,63 m3) |
| COU | Κουλόμπ |
| CKG | Κουλόμπ ανά χιλιόγραμμο |
| DMQ | Κυβικό δεκάμετρο |
| FTQ | Κυβικό πόδι |
| INQ | Κυβική ίντσα |
| MTQ | Κυβικό μέτρο |
| MQH | Κυβικό μέτρο ανά ώρα |
| MQS | Κυβικό μέτρο ανά δευτερόλεπτο |
| MMQ | Κυβικό χιλιοστό |
| YDQ | Κυβική γιάρδα |
| CUR | Κιουρί |
| DAY | Ημέρα |
| DEC | Δεκαετία |
| DAA | Στρέμμα |
| DLT | Δεκάλιτρο |
| DMT | Δεκάμετρο |
| CEL | Βαθμοί Κελσίου |
| FAH | Βαθμός Φαρενάιτ |
| KEL | Βαθμός Κέλβιν: όπως Κέλβιν |
| DPT | Τονάζ εκτοπίσματος |
| DZN | Δωδεκάδα |
| DZP | Δώδεκα πακέτα |
| DZR | Δώδεκα ζευγάρια |
| DPC | Δώδεκα τεμάχια |
| DRL | Δώδεκα ρολά |
| DRM | Drachm ΗΒ (3,887935 g) |
| DRI | Dram ΗΒ (1,771745 g) |
| DRA | Dram ΗΠΑ (3,887935 g) |
| BLD | Ξηρό βαρέλι (115,627 dm3) |
| GLD | Ξηρό γαλόνι (4,404884 dm3) |
| PTD | Ξηρή πίντα (0,55061 dm3) |
| QTD | Ξηρό κουάρτ (1,101221 dm3) |
| EA ή EAC | Κάθε |
| FAR | Φαράντ |
| OZI | Υγρή ουγγιά (28,413 cm3) |
| OZA | Υγρή ουγγιά (29,5735 cm3) |
| FOT | Πόδι (0,3048 m) |
| GLI | Γαλόνι (4,546092 dm3) |
| GBQ | Γιγαμπεκερέλ |
| GWH | Γιγαβατώρα (1 εκατομμύριο kW/h) |
| GII | Gill (0,142065 dm3) |
| GIA | Gill (11,8294 cm3) |
| GRN | Grain ΗΒ, ΗΠΑ (64,798910 mg) |
| GRM | Gram |
| GFI | Gram σχάσιμων ισοτόπων |
| GGR | Great gross (12 gross) |
| GRO | Gross |
| GRT | Μικτός (καταχωρημένος) τόνος |
| SAN | Εξάμηνο |
| HAR | Εκτάριο |
| HBA | Hectobar |
| HGM | Εκατόγραμμο |
| DTH | Εκατόκιλο |
| HLT | Εκατόλιτρο |
| HPA | Εκατόλιτρο καθαρής αλκοόλης |
| HMT | Εκατόμετρο |
| HTZ | Hertz |
| HUR | Ώρα |
| CEN | Εκατό |
| BHX | Εκατό κιβώτια |
| HIU | Εκατό διεθνείς μονάδες |
| CLF | Εκατό φύλλα |
| CNP | Εκατό πακέτα |
| CWA | Εκατόβαρο ΗΠΑ (45,3592 kg) |
| INH | Ίντσα (25,4 mm) |
| ITM | Είδος |
| JOU | Joule |
| KEL | Κέλβιν |
| KBA | Kilobar |
| KGM | Χιλιόγραμμο |
| KPH | Χιλιόγραμμο καυστικής ποτάσας |
| KSH | Χιλιόγραμμο καυστικής σόδας |
| KNS | Χιλιόγραμμο ονομασμένης ουσίας |
| KNI | Χιλιόγραμμο αζώτου |
| KPP | Χιλιόγραμμο φωσφονικού ανυδρίτη |
| KPP | Χιλιόγραμμο πεντοξειδίου του φωσφόρου |
| KPH | Χιλιόγραμμο υδροξειδίου του καλίου |
| KPO | Χιλιόγραμμο οξειδίου του καλίου |
| KSD | Χιλιόγραμμο ουσίας 90% ξηρά |
| KUR | Χιλιόγραμμο ουρανίου |
| KMQ | Χιλιόγραμμο ανά κυβικό μέτρο |
| KGS | Χιλιόγραμμο ανά δευτερόλεπτο |
| KHZ | Kilohertz |
| KJO | Kilogoule |
| KMT | Χιλιόμετρο |
| KMH | Χιλιόμετρο ανά ώρα |
| KPA | Kilopascal |
| KTN | Χιλιοτόνος |
| KVR | Kilovar |
| KVT | Κιλοβόλτ |
| KVA | Κιλοβόλτ-αμπέρ |
| KWT | Κιλοβάτ |
| KWH | Κιλοβατώρα |
| KNT | Κόμβος (1 ναυτικό μίλι ανά ώρα) |
| LEF | Φύλλο |
| GLL | Υγρό γαλόνι (3,7854l dm3) |
| PTL | Υγρή πίντα (0,473176 dm3) |
| QTL | Υγρό quart (0,946353 dm3) |
| LTR | Λίτρο (1 dm3) |
| LPA | Λίτρο καθαρής αλκοόλης |
| LTN | Μακρύς τόνος ΗΒ, ΗΠΑ (1,0160469 t) |
| LUM | Lumen |
| LUX | Lux |
| MHZ | Megahertz |
| MAL | Μεγαλίτρο |
| MAM | Μεγαμέτρο |
| MPA | Megapascal |
| MVA | Μεγαβόλτ-αμπέρ (1000 KVA) |
| MAW | Μεγαβάτ |
| MWH | Μεγαβατώρα (100 kW/h) |
| MTR | Μέτρο |
| MTS | Μέτρο ανά δευτερόλεπτο |
| MSK | Μέτρο ανά δευτερόλεπτο στο τετράγωνο |
| CTM | Μετρικό καράτι (200 mg = 2,10-4 kg) |
| TNE | Μετρικός τόνος (1000 kg) |
| MBR | Millibar |
| MCU | Millicurie |
| MGM | Χιλιοστόγραμμο |
| MI.T | Χιλιοστόλιτρο |
| MMT | Χιλιοστό |
| MIO | Εκατομμύριο |
| HMQ | Εκατομμύρια κυβικά μέτρα |
| MIU | Εκατομμύρια διεθνείς μονάδες |
| MIN | Λεπτό |
| MON | Μήνας |
| NMI | Ναυτικό μίλι (1852 m) |
| NTT | Καθαρός (καταχωρημένος) τόνος |
| NEW | Newton |
| NMB | Αριθμός |
| NAR | Αριθμός ειδών |
| NBB | Αριθμός μπομπίνων |
| NCL | Αριθμός κυψελών |
| NIU | Αριθμός διεθνών μονάδων |
| NMP | Αριθμός πακέτων |
| NMR | Αριθμός ζευγών |
| NPL | Αριθμός δεμάτων |
| NPT | Αριθμός εξαρτημάτων |
| NRL | Αριθμός ρολών |
| OHM | Ohm |
| ONZ | Ουγγιά ΗΒ, ΗΠΑ (28,349523 g) |
| APZ | Ουγγιά ΗΒ, ΗΠΑ (31,10348 g) (συνώνυμο: Troy ounce) |
| PK | Πακέτο |
| PAL | Pascal |
| DWT | Pennyweight ΗΒ, ΗΠΑ (1,555174 g) |
| PCE | Τεμάχιο |
| PCB | Τεμάχιο |
| PSC | Τεμάχιο |
| PTI | Πίντα (0,568262 dm3) |
| LBR | Λίβρα ΗΒ, ΗΠΑ (0,45359237 kg) |
| PGL | Proof gallon |
| LBS | Λίβρες |
| QTI | Quart (1,136523 dm3) |
| QAN | Τρίμηνο |
| QTR | Quarter, ΗΒ (12,700586 kg) |
| RPM | Στροφές το λεπτό |
| RPS | Στροφές το δευτερόλεπτο |
| SCO | Score |
| SCR | Scruple ΗΒ, ΗΠΑ (1,295982 g) |
| SEC | Δευτερόλεπτο |
| SET | Σετ |
| SHT | Τόνος αποστολής |
| SST | Short standard (7200 matches) |
| SIE | Siemens |
| CMK | Τετραγωνικό εκατοστό |
| DMK | Τετραγωνικό δεκατόμετρο |
| FTK | Τετραγωνικό πόδι |
| INK | Τετραγωνική ίντσα |
| KMK | Τετραγωνικό χιλιόμετρο |
| MTK | Τετραγωνικό μέτρο |
| MIK | Τετραγωνικό μίλι |
| MMK | Τετραγωνικό χιλιοστό |
| YDK | Τετραγωνική γιάρδα |
| WSD | Standard |
| ATM | Standard atmosphere (101325 Pa) |
| SMI | (Statute) mile (1609,344 m) |
| STI | Stone ΗΒ (6,350293 kg) |
| ATT | Technical atmosphere (98066,5 Pa) |
| DAD | Δέκα ημέρες |
| TPR | Δέκα ζευγάρια |
| MIL | Χίλια |
| TAH | Χιλιοαμπερώρα |
| MBF | Χίλια μετρικά πόδια ξυλείας (2,36 m3) |
| TQD | Χίλια κυβικά μέτρα ανά ημέρα |
| MBE | Ισοδύναμο χιλίων πρότυπων τούβλων |
| TSH | Τόνος ατμού ανά ώρα |
| TSD | Τόνος ουσίας 90% ξηρά |
| TRL | Τρισεκατομμύρια ευρώ |
| APZ | Troy ounce |
| ST | Άγνωστη μονάδα μέτρησης |
| VLT | Volt |
| WTT | Watt |
| WHR | Βατώρα |
| WEB | Weber |
| WEE | Εβδομάδα |