Χρειάζονται 4 στοιχεία για να δημιουργηθεί μοναδική ταυτότητα για το κάθε παραστατικό.
\nΚωδικός καταστήματος
\nΚωδικός είδους παραστατικού
\nΣειρά αρίθμησης
\nΑρίθμηση
\nΣτοιχεία σχετικά με το ΜΑΡΚ των παραστατικών αναγράφονται στα πεδία marked_at, mark, aade_uid.
Το πρωτόκολλο επικοινωνίας είναι ένα κοινό RESTful HTTP. Όλες τα request/response είναι json μορφής.
\nΓια validation σφάλματα επιστρέφεται HTTP status 422 και στο περιεχόμενο αναγράφεται το λανθασμένο πεδίο και το είδος του σφάλματος.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"1408338","collectionId":"defab8ec-f1c6-4089-86d1-5b45c91c6074","publishedId":"2sAXxMgtQW","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2024-10-06T15:33:47.000Z"},"item":[{"name":"Παραστατικά","item":[{"name":"Δημιουργία Παραστατικού","id":"8306f748-fad0-4904-8cad-170c2d93f4e7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"store","value":"1","type":"text","description":"ID καταστήματος
\n"},{"key":"name","value":"Εισιτήριο 5678 για ΒΚΜ1234","type":"text","description":"Προεραιτικό, τίτλος παραστατικού
\n"},{"key":"sequence","value":"Α","type":"text","description":"Σειρά αρίθμησης
\n"},{"key":"number","value":"441","type":"text","description":"Αύξων αριθμός παραστατικού
\n"},{"key":"issued_at","value":"2025-10-28 23:59:59","type":"text","description":"Ημερομηνία και ώρα έκδοσης παραστατικού σε μορφή MySQL
\n"},{"key":"tax_document","value":"receipt-providing-services","type":"text","description":"Κωδικός Είδους παραστατικού
\n"},{"key":"payment_method","value":"cash","type":"text","description":"Κωδικός Τρόπου Πληρωμής
\n"},{"key":"final_price","value":"123.45","description":"Τελική Τιμή παραστατικού
\n","type":"text"},{"key":"net_value","value":"99.56","description":"Καθαρή Αξία
\n","type":"text"},{"key":"vat_value","value":"23.89","description":"Αξία ΦΠΑ
\n","type":"text"},{"key":"vat_percentage","value":"24","description":"Ποσοστό ΦΠΑ
\n","type":"text"},{"key":"mark_now","value":"1","description":"Προαιρετικό. Εάν απουσιάζει ή είναι απενεργοποιημένο (0, false) το παραστατικό μόνο αποθηκεύεται και θα διαβιβαστεί αργότερα. Εάν ενεργοποιημένο (=1) τότε το παραστατικό πρώτα διαβιβάζεται κι έπειτα επιστρέφεται απάντηση συμπεριλαμβάνοντας το ΜΑΡΚ.
\n","type":"text"},{"key":"generate_pdf","value":"false","description":"Προαιρετικό. Εάν είναι ενεργοποιημένο τότε δημιουργείται το αρχείο και συμπεριλαμβάνεται το url στην απάντηση (file_url).
Το ΑΦΜ του λήπτη, ειναι απαραιτητο μονο οταν το παραστατικο ειναι τιμολογιο. Διαφορετικά μπορεί να απουσιάζει ή να είναι κενό.
\n","type":"text","uuid":"5141218a-ad83-4c94-aab2-bef777df75e0"}]},"url":"https://invoices.my-parking.eu/api/invoices","description":"Εάν αποσταλλεί παραστατικό με ίδια ταυτότητα τότε δεν επιστρέφεται σφάλμα και δεν αποθηκεύεται εκ νέου.
Στο πεδίο created_atτης απάντησης αναγράφεται πότε δημιουργήθηκε το παραστατικό.
Κωδικός Καταστήματος
\n","type":"text/plain"},"key":"store","value":"1"}],"variable":[]}},"response":[{"id":"96ae9488-8902-46e6-9655-9079768a5945","name":"Success","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://invoices.my-parking.eu/api/invoices?store=1","host":["https://invoices.my-parking.eu"],"path":["api","invoices"],"query":[{"key":"store","value":"1","description":"Κωδικός Καταστήματος"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.19.2"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"PHP/8.1.13"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Sun, 06 Oct 2024 16:21:02 GMT"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"},{"key":"Access-Control-Allow-Origin","value":"*"}],"cookie":[],"responseTime":null,"body":"{\n \"current_page\": 1,\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"προαιρετικό\",\n \"sequence\": \"A\",\n \"number\": 1,\n \"code_name\": \"ΑΠΥ A 1\",\n \"issued_at\": \"2023-07-18 00:00:00\",\n \"tax_document_id\": 1,\n \"payment_method_id\": 1,\n \"final_price\": 10,\n \"initial_price\": 10,\n \"discount_value\": 0,\n \"discount_percentage\": 0,\n \"net_value\": 8.064516129,\n \"vat_percentage\": 24,\n \"vat_value\": 1.935483871,\n \"sales_amount\": 10,\n \"collected_amount\": 10,\n \"customer_business_name\": null,\n \"customer_first_name\": null,\n \"customer_last_name\": null,\n \"customer_vin\": null,\n \"customer_activity\": null,\n \"customer_address\": null,\n \"customer_postal_code\": null,\n \"customer_tax_office\": null,\n \"customer_city\": null,\n \"customer_country\": null,\n \"marked_at\": \"2023-09-18 17:39:49\",\n \"mark\": \"400001917184794\",\n \"aade_uid\": \"F3F4AEBBEB24E753FAE968D7C7FAF05F8C2E9783\",\n \"cancellation_marked_at\": null,\n \"cancellation_mark\": null,\n \"store_id\": 1,\n \"invoice_import_id\": 1,\n \"created_at\": \"2023-09-18 17:28:27\",\n \"updated_at\": \"2023-09-18 17:39:49\",\n \"deleted_at\": null,\n \"created_by\": 3,\n \"updated_by\": 3,\n \"deleted_by\": null\n },\n {\n \"id\": 2,\n \"name\": \"προαιρετικό\",\n \"sequence\": \"A\",\n \"number\": 2,\n \"code_name\": \"ΑΠΥ A 2\",\n \"issued_at\": \"2023-07-18 00:00:00\",\n \"tax_document_id\": 1,\n \"payment_method_id\": 1,\n \"final_price\": 10,\n \"initial_price\": 10,\n \"discount_value\": 0,\n \"discount_percentage\": 0,\n \"net_value\": 8.064516129,\n \"vat_percentage\": 24,\n \"vat_value\": 1.935483871,\n \"sales_amount\": 10,\n \"collected_amount\": 10,\n \"customer_business_name\": null,\n \"customer_first_name\": null,\n \"customer_last_name\": null,\n \"customer_vin\": null,\n \"customer_activity\": null,\n \"customer_address\": null,\n \"customer_postal_code\": null,\n \"customer_tax_office\": null,\n \"customer_city\": null,\n \"customer_country\": null,\n \"marked_at\": null,\n \"mark\": null,\n \"aade_uid\": null,\n \"cancellation_marked_at\": null,\n \"cancellation_mark\": null,\n \"store_id\": 1,\n \"invoice_import_id\": 2,\n \"created_at\": \"2023-09-18 17:36:53\",\n \"updated_at\": \"2023-09-18 17:36:53\",\n \"deleted_at\": null,\n \"created_by\": 3,\n \"updated_by\": 3,\n \"deleted_by\": null\n },\n {\n \"id\": 3,\n \"name\": \"Εισιτήριο 5678 για ΒΚΜ1234\",\n \"sequence\": \"Α\",\n \"number\": 4,\n \"code_name\": \"ΑΠΥ Α 4\",\n \"issued_at\": \"2024-09-01 23:59:59\",\n \"tax_document_id\": 1,\n \"payment_method_id\": 1,\n \"final_price\": 123.45,\n \"initial_price\": 123.45,\n \"discount_value\": 0,\n \"discount_percentage\": 0,\n \"net_value\": 99.56,\n \"vat_percentage\": 24,\n \"vat_value\": 23.89,\n \"sales_amount\": 123.45,\n \"collected_amount\": 123.45,\n \"customer_business_name\": null,\n \"customer_first_name\": null,\n \"customer_last_name\": null,\n \"customer_vin\": null,\n \"customer_activity\": null,\n \"customer_address\": null,\n \"customer_postal_code\": null,\n \"customer_tax_office\": null,\n \"customer_city\": null,\n \"customer_country\": null,\n \"marked_at\": \"2024-10-06 19:09:33\",\n \"mark\": \"400001937527761\",\n \"aade_uid\": \"4DC0E3FFEFE3DBEBFBF7F7E49846F1B1C6900A0D\",\n \"cancellation_marked_at\": null,\n \"cancellation_mark\": null,\n \"store_id\": 1,\n \"invoice_import_id\": null,\n \"created_at\": \"2024-10-06 19:06:11\",\n \"updated_at\": \"2024-10-06 19:09:33\",\n \"deleted_at\": null,\n \"created_by\": 6,\n \"updated_by\": 6,\n \"deleted_by\": null\n }\n ],\n \"first_page_url\": \"http://parking-invoices.local:8080/api/invoices?page=1\",\n \"from\": 1,\n \"last_page\": 1,\n \"last_page_url\": \"http://parking-invoices.local:8080/api/invoices?page=1\",\n \"links\": [\n {\n \"url\": null,\n \"label\": \"pagination.previous\",\n \"active\": false\n },\n {\n \"url\": \"http://parking-invoices.local:8080/api/invoices?page=1\",\n \"label\": \"1\",\n \"active\": true\n },\n {\n \"url\": null,\n \"label\": \"pagination.next\",\n \"active\": false\n }\n ],\n \"next_page_url\": null,\n \"path\": \"http://parking-invoices.local:8080/api/invoices\",\n \"per_page\": 50,\n \"prev_page_url\": null,\n \"to\": 3,\n \"total\": 3\n}"}],"_postman_id":"74e68a3a-5b3c-4594-b69f-3f19f5c3d348"}],"id":"dabeea9b-90b6-4e34-ac4c-640c35be844c","event":[{"listen":"prerequest","script":{"id":"a997bc36-a0da-4e5d-afe9-cc00c30867e0","type":"text/javascript","packages":{},"requests":{},"exec":[""]}},{"listen":"test","script":{"id":"76160bd6-af61-4c09-a16a-d2ecd0bb6638","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}],"_postman_id":"dabeea9b-90b6-4e34-ac4c-640c35be844c","description":"","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"defab8ec-f1c6-4089-86d1-5b45c91c6074","id":"defab8ec-f1c6-4089-86d1-5b45c91c6074","name":"Parking Invoices","type":"collection"}}}],"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]}},"event":[{"listen":"prerequest","script":{"id":"50bf2e91-ab60-424e-ad7c-60300bc51325","type":"text/javascript","packages":{},"requests":{},"exec":[""]}},{"listen":"test","script":{"id":"c75281b2-70b4-49f7-a997-ef35032d2d7c","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}],"variable":[{"key":"url","value":"https://invoices.my-parking.eu"},{"key":"token","value":""}]}