Παραγγελιοληψία και myDATA API: όλα τα παραδείγματα JSON, από το δελτίο μέχρι την επιστροφή στην κάρτα
Δέκα στιγμές μιας βάρδιας, δέκα πλήρη σώματα αιτήματος για το POST /invoices: δελτίο παραγγελίας, απόδειξη που κλείνει τα δελτία, πάγκος και take-away, κάρτα στο τερματικό και στην πόρτα, μικτή πληρωμή, ακύρωση, επιστροφή στην κάρτα, κέρασμα και γεύμα προσωπικού.
Ένα σύστημα παραγγελιοληψίας εκδίδει σε μια βάρδια δέκα διαφορετικά πράγματα: δελτία στο τραπέζι, αποδείξεις στον πάγκο, κάρτες στο τερματικό, επιστροφές, κεράσματα. Αυτή η σελίδα τα έχει όλα, με τη σειρά, σαν πλήρη JSON που στέλνεις στο POST /invoices.
Κάθε παράδειγμα είναι ολόκληρο σώμα αιτήματος. Αλλάζεις τα id με τα δικά σου και το στέλνεις. Πότε χρειάζεται το καθένα το εξηγεί ο οδηγός για το σύστημα παραγγελιοληψίας και myDATA.
| Στιγμή | Παραστατικό |
|---|---|
| 1. Παραγγελία στο τραπέζι | 8.6 |
| 2. Πληρωμή του τραπεζιού | 11.1 |
| 3. Πάγκος και take-away | 11.1 |
| 4. Κάρτα στο τερματικό | 11.1 |
| 5. Κάρτα στην πόρτα ή στην παραλαβή | 11.1 |
| 6. Μετρητά και κάρτα στον ίδιο λογαριασμό | 11.1 και 8.4 |
| 7. Ακύρωση απόδειξης | 11.4 |
| 8. Επιστροφή στην κάρτα | 8.5 |
| 9. Κέρασμα | 11.1 |
| 10. Γεύμα προσωπικού | 6.1 |
Πριν ξεκινήσεις
- Σειρές: κάθε τύπος θέλει τη δική του σειρά. Το
billing_book_idτο παίρνεις από τοGET /billing_books. Στον δοκιμαστικό λογαριασμό οι βασικές σειρές είναι ήδη στημένες, και όσες λείπουν, όπως 8.4 ή 6.1, τις δημιουργείς με τοPOST /billing_books. - Τερματικό: το
pos_device_idείναι το id του τερματικού όπως το δήλωσες στο Wrapp, από τοGET /pos_devices. - Ρητά ποσά παντού: κάθε γραμμή έχει δικά της
net_total_price,vat_totalκαιsubtotal, και το παραστατικό τα τέσσερα σύνολά του. Δεν υπολογίζονται από την ποσότητα και την τιμή. - Χαρακτηρισμοί: οι χαρακτηρισμοί εσόδου στα παραδείγματα είναι ενδεικτικοί. Ποιος ισχύει για την επιχείρηση το αποφασίζει ο λογιστής της.
- Μοναδικό
external_id: αν βάλεις τον αριθμό της παραγγελίας σου, μια επανάληψη της ίδιας κλήσης απορρίπτεται αντί να βγάλει δεύτερο παραστατικό.
1. Παραγγελία στο τραπέζι: Δελτίο Παραγγελίας Εστίασης 8.6
Ένα δελτίο για κάθε γύρο, στο τραπέζι του: το catering_table_id είναι ένα ανοιχτό τραπέζι από τα catering_tables. Οι γραμμές του δελτίου παίρνουν category1_95 με _, γιατί το δελτίο δεν χαρακτηρίζει έσοδο.
{
"invoice_type_code": "8.6",
"billing_book_id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"catering_table_id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"counterpart": {
"name": "Τραπέζι 12",
"vat": "",
"city": "",
"street": "",
"number": "",
"postal_code": ""
},
"net_total_amount": 19.11,
"vat_total_amount": 2.99,
"total_amount": 22.10,
"payable_total_amount": 22.10,
"invoice_lines": [
{
"line_number": 1,
"name": "Μπριάμ",
"quantity": 2,
"quantity_type": 1,
"unit_price": 8.85,
"net_total_price": 17.70,
"vat_rate": 13,
"vat_total": 2.30,
"subtotal": 20.00,
"classification_category": "category1_95",
"classification_type": "_"
},
{
"line_number": 2,
"name": "Νερό 1lt",
"quantity": 1,
"quantity_type": 1,
"unit_price": 1.41,
"net_total_price": 1.41,
"vat_rate": 24,
"vat_total": 0.69,
"subtotal": 2.10,
"classification_category": "category1_95",
"classification_type": "_"
}
]
}
Το δελτίο έχει 24 ώρες για να συσχετιστεί με την απόδειξη που το κλείνει. Τον κύκλο ζωής του, την ακύρωση και τα σφάλματα τα καλύπτει ο οδηγός για το Δελτίο Παραγγελίας Εστίασης και τις 24 ώρες.
2. Πληρωμή του τραπεζιού: απόδειξη 11.1 που κλείνει τα δελτία
Το τραπέζι 12 παρήγγειλε δύο γύρους των 22,10 €. Η απόδειξη των 44,20 € κουβαλάει τα ΜΑΡΚ και των δύο δελτίων στο correlated_invoices, και το τραπέζι στο catering_table_id. Αν ο λογαριασμός μοιραστεί σε περισσότερες αποδείξεις, η συντηρητική υλοποίηση βάζει το ΜΑΡΚ του δελτίου σε καθεμία.
{
"invoice_type_code": "11.1",
"billing_book_id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"correlated_invoices": ["400001xxxxxxxx1", "400001xxxxxxxx2"],
"catering_table_id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"payment_method_type": 0,
"counterpart": {
"name": "Ιδιώτης πελάτης",
"country_code": "GR"
},
"invoice_lines": [
{
"line_number": 1,
"name": "Μπριάμ",
"quantity": 4,
"quantity_type": 1,
"unit_price": 8.85,
"net_total_price": 35.40,
"vat_rate": 13,
"vat_total": 4.60,
"subtotal": 40.00,
"classification_category": "category1_1",
"classification_type": "E3_561_003"
},
{
"line_number": 2,
"name": "Νερό 1lt",
"quantity": 2,
"quantity_type": 1,
"unit_price": 1.41,
"net_total_price": 2.82,
"vat_rate": 24,
"vat_total": 1.38,
"subtotal": 4.20,
"classification_category": "category1_1",
"classification_type": "E3_561_003"
}
],
"net_total_amount": 38.22,
"vat_total_amount": 5.98,
"total_amount": 44.20,
"payable_total_amount": 44.20
}
Το τραπέζι δεν κλείνει μόνο του. Μετά την τελευταία απόδειξη το κλείνεις εσύ:
curl -X POST 'https://wrapp.ai/api/v1/catering_tables/xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/close' \ -H 'Authorization: Bearer xxxxxxxxxxxxxx'
3. Πάγκος και take-away: απόδειξη 11.1 απευθείας
Όταν ο πελάτης πληρώνει τη στιγμή της παραγγελίας, στον πάγκο, στο take-away ή στο delivery, η απόδειξη βγαίνει απευθείας: χωρίς δελτίο και χωρίς τραπέζι.
{
"invoice_type_code": "11.1",
"billing_book_id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"payment_method_type": 0,
"counterpart": {
"name": "Ιδιώτης πελάτης",
"country_code": "GR"
},
"invoice_lines": [
{
"line_number": 1,
"name": "Γύρος χοιρινός μερίδα",
"quantity": 2,
"quantity_type": 1,
"unit_price": 10.62,
"net_total_price": 21.24,
"vat_rate": 13,
"vat_total": 2.76,
"subtotal": 24.00,
"classification_category": "category1_1",
"classification_type": "E3_561_003"
},
{
"line_number": 2,
"name": "Αναψυκτικό 330ml",
"quantity": 2,
"quantity_type": 1,
"unit_price": 1.61,
"net_total_price": 3.22,
"vat_rate": 24,
"vat_total": 0.78,
"subtotal": 4.00,
"classification_category": "category1_1",
"classification_type": "E3_561_003"
}
],
"net_total_amount": 24.46,
"vat_total_amount": 3.54,
"total_amount": 28.00,
"payable_total_amount": 28.00
}
4. Κάρτα στο τερματικό: απόδειξη 11.1 με pos_device_id
Με pos_device_id και payment_method_type: 3 το ποσό πηγαίνει στο τερματικό. Η απάντηση είναι pending και η απόδειξη παίρνει ΜΑΡΚ μόλις εγκριθεί η πληρωμή. Το αποτέλεσμα έρχεται με webhook: η εκδοθείσα απόδειξη σε επιτυχία, και μια αποτυχία ή ακύρωση στο τερματικό ξεχωριστά.
{
"invoice_type_code": "11.1",
"billing_book_id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"payment_method_type": 3,
"pos_device_id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"external_id": "order-1042",
"invoice_lines": [
{
"line_number": 1,
"name": "Μπριάμ",
"quantity": 2,
"quantity_type": 1,
"unit_price": 8.85,
"net_total_price": 17.70,
"vat_rate": 13,
"vat_total": 2.30,
"subtotal": 20.00,
"classification_category": "category1_1",
"classification_type": "E3_561_003"
},
{
"line_number": 2,
"name": "Νερό 1lt",
"quantity": 1,
"quantity_type": 1,
"unit_price": 1.41,
"net_total_price": 1.41,
"vat_rate": 24,
"vat_total": 0.69,
"subtotal": 2.10,
"classification_category": "category1_1",
"classification_type": "E3_561_003"
}
],
"net_total_amount": 19.11,
"vat_total_amount": 2.99,
"total_amount": 22.10,
"payable_total_amount": 22.10
}
Το τερματικό πρέπει να είναι συνδεδεμένο με το Wrapp και δηλωμένο στον λογαριασμό. Στο staging λειτουργούν μόνο δοκιμαστικά τερματικά Viva, όπως εξηγεί ο οδηγός για τη σύνδεση Viva SoftPOS.
5. Κάρτα στην πόρτα ή στην παραλαβή: aade_preloaded
Όταν η απόδειξη πρέπει να υπάρχει πριν πληρώσει ο πελάτης, στο delivery με κάρτα στην πόρτα ή στην πληρωμή στην παραλαβή, πρόσθεσε "aade_preloaded": true. Η απόδειξη εκδίδεται αμέσως με ΜΑΡΚ και τρόπο πληρωμής «επί πιστώσει», και η χρέωση περιμένει στο τερματικό.
{
"invoice_type_code": "11.1",
"billing_book_id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"payment_method_type": 3,
"pos_device_id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"aade_preloaded": true,
"external_id": "order-1043",
"invoice_lines": [
{
"line_number": 1,
"name": "Μπριάμ",
"quantity": 2,
"quantity_type": 1,
"unit_price": 8.85,
"net_total_price": 17.70,
"vat_rate": 13,
"vat_total": 2.30,
"subtotal": 20.00,
"classification_category": "category1_1",
"classification_type": "E3_561_003"
},
{
"line_number": 2,
"name": "Νερό 1lt",
"quantity": 1,
"quantity_type": 1,
"unit_price": 1.41,
"net_total_price": 1.41,
"vat_rate": 24,
"vat_total": 0.69,
"subtotal": 2.10,
"classification_category": "category1_1",
"classification_type": "E3_561_003"
}
],
"net_total_amount": 19.11,
"vat_total_amount": 2.99,
"total_amount": 22.10,
"payable_total_amount": 22.10
}
- Πληρωμή με κάρτα σε εκείνο το τερματικό: ο τρόπος πληρωμής γίνεται κάρτα, με νέο ΜΑΡΚ πληρωμής. Δεν έρχεται δεύτερο webhook, οπότε τα στοιχεία της κάρτας τα διαβάζεις από το
GET /invoices/{id}. - Πληρωμή με μετρητά: ακυρώνεις τη χρέωση στο τερματικό και η απόδειξη μένει «επί πιστώσει». Δεν χρειάζεται πιστωτικό ούτε νέα απόδειξη.
6. Μετρητά και κάρτα στον ίδιο λογαριασμό: 11.1 και 8.4
Το API δέχεται έναν τρόπο πληρωμής ανά παραστατικό. Ο λογαριασμός των 44,20 € πληρώνεται 20,00 € μετρητά και 24,20 € με κάρτα, σε δύο κλήσεις. Πρώτα η απόδειξη για όλο το ποσό, «επί πιστώσει»:
{
"invoice_type_code": "11.1",
"billing_book_id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"payment_method_type": 1,
"counterpart": {
"name": "Ιδιώτης πελάτης",
"country_code": "GR"
},
"invoice_lines": [
{
"line_number": 1,
"name": "Μπριάμ",
"quantity": 4,
"quantity_type": 1,
"unit_price": 8.85,
"net_total_price": 35.40,
"vat_rate": 13,
"vat_total": 4.60,
"subtotal": 40.00,
"classification_category": "category1_1",
"classification_type": "E3_561_003"
},
{
"line_number": 2,
"name": "Νερό 1lt",
"quantity": 2,
"quantity_type": 1,
"unit_price": 1.41,
"net_total_price": 2.82,
"vat_rate": 24,
"vat_total": 1.38,
"subtotal": 4.20,
"classification_category": "category1_1",
"classification_type": "E3_561_003"
}
],
"net_total_amount": 38.22,
"vat_total_amount": 5.98,
"total_amount": 44.20,
"payable_total_amount": 44.20
}
Μετά η Απόδειξη Είσπραξης POS 8.4, μόνο για το μέρος της κάρτας, με το ΜΑΡΚ της απόδειξης στο correlated_invoices. Το τερματικό χρεώνει τα 24,20 € και η 8.4 παίρνει ΜΑΡΚ μόλις εγκριθεί η πληρωμή.
{
"invoice_type_code": "8.4",
"billing_book_id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"correlated_invoices": ["400001xxxxxxxx1"],
"payment_method_type": 3,
"pos_device_id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"counterpart": {
"name": "Ιδιώτης πελάτης",
"country_code": "GR"
},
"invoice_lines": [
{
"line_number": 1,
"name": "Είσπραξη με κάρτα",
"quantity": 1,
"quantity_type": 1,
"unit_price": 24.20,
"net_total_price": 24.20,
"vat_rate": 0,
"vat_total": 0.00,
"subtotal": 24.20,
"classification_category": "category1_95",
"classification_type": "_",
"vat_exemption_code": "0"
}
],
"net_total_amount": 24.20,
"vat_total_amount": 0.00,
"total_amount": 24.20,
"payable_total_amount": 24.20
}
Για τα μετρητά δεν χρειάζεται άλλο παραστατικό. Αν η απόδειξη κλείνει δελτία, κουβαλάει και τα ΜΑΡΚ τους, όπως στο βήμα 2.
7. Ακύρωση απόδειξης: πιστωτικό λιανικής 11.4
Μια απόδειξη που πήρε ΜΑΡΚ δεν αλλάζει. Την αντιλογίζεις με ένα 11.4 σε δική του σειρά, με τις ίδιες γραμμές, τον ίδιο τρόπο πληρωμής και το ΜΑΡΚ της αρχικής στο correlated_invoices.
{
"invoice_type_code": "11.4",
"billing_book_id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"payment_method_type": 0,
"correlated_invoices": ["400001xxxxxxxx1"],
"counterpart": {
"name": "Ιδιώτης πελάτης",
"country_code": "GR"
},
"invoice_lines": [
{
"line_number": 1,
"name": "Γύρος χοιρινός μερίδα",
"quantity": 2,
"quantity_type": 1,
"unit_price": 10.62,
"net_total_price": 21.24,
"vat_rate": 13,
"vat_total": 2.76,
"subtotal": 24.00,
"classification_category": "category1_1",
"classification_type": "E3_561_003"
},
{
"line_number": 2,
"name": "Αναψυκτικό 330ml",
"quantity": 2,
"quantity_type": 1,
"unit_price": 1.61,
"net_total_price": 3.22,
"vat_rate": 24,
"vat_total": 0.78,
"subtotal": 4.00,
"classification_category": "category1_1",
"classification_type": "E3_561_003"
}
],
"net_total_amount": 24.46,
"vat_total_amount": 3.54,
"total_amount": 28.00,
"payable_total_amount": 28.00
}
8. Επιστροφή στην κάρτα: Απόδειξη Επιστροφής POS 8.5
Τα χρήματα επιστρέφουν στην κάρτα από το τερματικό. Το refund_invoice_id είναι το id του Wrapp για το παραστατικό που χρέωσε την κάρτα, εδώ η 8.4 του βήματος 6, και όχι ΜΑΡΚ. Το ποσό της 8.5 είναι το ποσό που επιστρέφεται, οπότε μια 8.4 δέχεται και μερικές επιστροφές.
{
"invoice_type_code": "8.5",
"billing_book_id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"payment_method_type": 3,
"pos_device_id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"refund_invoice_id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"counterpart": {
"name": "Ιδιώτης πελάτης",
"country_code": "GR"
},
"net_total_amount": 5.00,
"vat_total_amount": 0.00,
"total_amount": 5.00,
"payable_total_amount": 5.00,
"invoice_lines": [
{
"line_number": 1,
"name": "Επιστροφή στην κάρτα",
"quantity": 1,
"quantity_type": 1,
"unit_price": 5.00,
"net_total_price": 5.00,
"vat_rate": 0,
"vat_total": 0.00,
"subtotal": 5.00,
"classification_category": "category1_95",
"classification_type": "_",
"vat_exemption_code": "0"
}
]
}
- Η 8.5 εκδίδεται μόλις το τερματικό ολοκληρώσει την επιστροφή.
- Ο αντιλογισμός της πώλησης είναι ξεχωριστό 11.4, χωρίς τερματικό, όπως στο βήμα 7.
- Αν την κάρτα τη χρέωσε η ίδια η 11.1, βήματα 4 και 5, ένα 11.4 με
pos_device_id,refund_invoice_idτο id της 11.1 και το ΜΑΡΚ της στοcorrelated_invoicesκάνει και τα δύο μαζί: πιστώνει την πώληση και επιστρέφει στην κάρτα.
9. Κέρασμα: γραμμή μηδενικής αξίας στην 11.1
Το κερασμένο είδος μπαίνει στην απόδειξη με την τιμή καταλόγου στο unit_price, μηδενικά ποσά, category1_95 με _, και τον πραγματικό συντελεστή ΦΠΑ του είδους.
{
"invoice_type_code": "11.1",
"billing_book_id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"payment_method_type": 0,
"net_total_amount": 10.00,
"vat_total_amount": 1.30,
"total_amount": 11.30,
"payable_total_amount": 11.30,
"invoice_lines": [
{
"line_number": 1,
"name": "Μπιφτέκι μερίδα",
"quantity": 1,
"quantity_type": 1,
"unit_price": 10.00,
"net_total_price": 10.00,
"vat_rate": 13,
"vat_total": 1.30,
"subtotal": 11.30,
"classification_category": "category1_1",
"classification_type": "E3_561_003"
},
{
"line_number": 2,
"name": "Πατάτες κέρασμα",
"quantity": 1,
"quantity_type": 1,
"unit_price": 3.50,
"net_total_price": 0.00,
"vat_rate": 13,
"vat_total": 0.00,
"subtotal": 0.00,
"classification_category": "category1_95",
"classification_type": "_"
}
]
}
Στο δελτίο παραγγελίας 8.6 μια γραμμή μηδενικής αξίας δεν μπαίνει δίπλα σε χρεωμένες: το myDATA απορρίπτει το δελτίο με σφάλμα 222. Το κερασμένο είδος πηγαίνει σε δικό του, ολομήδενο δελτίο, ή μόνο στην απόδειξη, όπως παραπάνω.
Το κέρασμα μπορεί να εκδοθεί και σαν 6.1, όπως το γεύμα προσωπικού στο επόμενο βήμα. Ποιος από τους δύο τρόπους ισχύει, το αποφασίζει ο λογιστής της επιχείρησης.
10. Γεύμα προσωπικού: Στοιχείο Αυτοπαράδοσης 6.1
Σε δική του σειρά, με category1_6 και E3_595, τρόπο πληρωμής «επί πιστώσει», και την αιτιολογία στο notes, που τυπώνεται στις παρατηρήσεις. Ο αντισυμβαλλόμενος είναι προαιρετικός. Τη βάση του ΦΠΑ την ορίζει ο λογιστής.
{
"invoice_type_code": "6.1",
"billing_book_id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"payment_method_type": 1,
"notes": "Αιτιολογία: γεύμα προσωπικού",
"net_total_amount": 2.00,
"vat_total_amount": 0.26,
"total_amount": 2.26,
"payable_total_amount": 2.26,
"invoice_lines": [
{
"line_number": 1,
"name": "Μερίδα μπιφτέκι",
"quantity": 1,
"quantity_type": 1,
"unit_price": 2.00,
"net_total_price": 2.00,
"vat_rate": 13,
"vat_total": 0.26,
"subtotal": 2.26,
"classification_category": "category1_6",
"classification_type": "E3_595"
}
]
}
Πώς ξεκινάς
Κάνε δωρεάν εγγραφή στο wrapp.ai με το ΑΦΜ σου και πάτα «Δοκίμασε το API». Παίρνεις email σύνδεσης και API key για το staging.wrapp.ai, και στέλνεις κάθε παράδειγμα αυτής της σελίδας χωρίς φορολογική ισχύ. Πού βρίσκεις το key το δείχνει ο οδηγός για το δοκιμαστικό API key, και όλα τα endpoints είναι στην τεκμηρίωση του API.
Συχνές ερωτήσεις
Ποια παραστατικά εκδίδει ένα σύστημα παραγγελιοληψίας μέσω API;
Το Δελτίο Παραγγελίας Εστίασης 8.6 για κάθε γύρο στο τραπέζι, την απόδειξη λιανικής 11.1 που κλείνει τα δελτία ή που εκδίδεται απευθείας στον πάγκο και στο take-away, την Απόδειξη Είσπραξης POS 8.4 για το μέρος της κάρτας σε μικτή πληρωμή, την Απόδειξη Επιστροφής POS 8.5 για επιστροφή στην κάρτα, το πιστωτικό λιανικής 11.4 για ακύρωση απόδειξης, και το Στοιχείο Αυτοπαράδοσης 6.1. Όλα στέλνονται στο ίδιο endpoint, POST /invoices.
Πώς κλείνει η απόδειξη τα δελτία παραγγελίας;
Η απόδειξη 11.1 κουβαλάει τα ΜΑΡΚ όλων των δελτίων του τραπεζιού στο correlated_invoices και το τραπέζι στο catering_table_id. Η συσχέτιση πρέπει να γίνει μέσα σε 24 ώρες από την έκδοση του δελτίου.
Κλείνει μόνο του το τραπέζι μετά την απόδειξη;
Όχι. Μετά την τελευταία απόδειξη το κλείνεις εσύ, με POST /catering_tables/:id/close.
Πώς στέλνω λογαριασμό που πληρώθηκε μισά μετρητά και μισά κάρτα;
Με δύο κλήσεις, γιατί το API δέχεται έναν τρόπο πληρωμής ανά παραστατικό. Πρώτα η απόδειξη 11.1 για όλο το ποσό με payment_method_type 1, επί πιστώσει. Μετά μια 8.4 μόνο για το ποσό της κάρτας, με pos_device_id, payment_method_type 3 και το ΜΑΡΚ της απόδειξης στο correlated_invoices. Για τα μετρητά δεν χρειάζεται άλλο παραστατικό.
Πώς γίνεται επιστροφή χρημάτων στην κάρτα μέσω API;
Με μια 8.5 που έχει pos_device_id και refund_invoice_id το id του Wrapp για το παραστατικό που χρέωσε την κάρτα, όχι ΜΑΡΚ. Το ποσό της 8.5 είναι το ποσό της επιστροφής, οπότε γίνονται και μερικές επιστροφές. Αν την κάρτα τη χρέωσε η ίδια η 11.1, ένα 11.4 με pos_device_id και refund_invoice_id πιστώνει την πώληση και επιστρέφει στην κάρτα μαζί.
Μπορεί η απόδειξη να βγει πριν πληρώσει ο πελάτης με κάρτα;
Ναι, με "aade_preloaded": true μαζί με το pos_device_id. Η 11.1 εκδίδεται αμέσως με ΜΑΡΚ και τρόπο πληρωμής επί πιστώσει, και η χρέωση περιμένει στο τερματικό. Με πληρωμή κάρτας ο τρόπος πληρωμής αλλάζει σε κάρτα. Με μετρητά ακυρώνεις τη χρέωση στο τερματικό και η απόδειξη μένει επί πιστώσει, χωρίς άλλο παραστατικό.
Πώς περνάω ένα κέρασμα στην απόδειξη;
Σαν γραμμή μηδενικής αξίας: unit_price η τιμή καταλόγου, μηδενικά ποσά, category1_95 με _, και ο πραγματικός συντελεστής ΦΠΑ του είδους. Το κέρασμα μπορεί να εκδοθεί και σαν 6.1. Ποιος από τους δύο τρόπους ισχύει το αποφασίζει ο λογιστής της επιχείρησης.
Πού δοκιμάζω τα παραδείγματα;
Χρειάζεσαι βοήθεια;
Αν έχεις απορία για αυτό το θέμα ή θέλεις να σιγουρευτείς ότι όλα ρυθμίστηκαν σωστά, επικοινώνησε μαζί μας και θα το δούμε μαζί.