ΣΧΕΤΙΚΑ ΜΕ ΤΗΝ ARBITRANS DEMO ΕΦΑΡΜΟΓΩΝ DOWNLOAD ΤΙΜΟΚΑΤΑΛΟΓΟΣ/ΠΑΡΑΓΓΕΛΙΑ ΕΠΙΚΟΙΝΩΝΙΑ

Το ARBITRANS4U δίνει την δυνατότητα στον χρήστη να κάνει άντληση παραστατικών από τα myDATA, μέσω αρχείου διεπαφής.

Η άντληση αυτή μπορεί να χρησιμοποιηθεί τόσο για την προβολή των δεδομένων σε εφαρμογή τρίτου, όσο και για τον ΧΑΡΑΚΤΗΡΙΣΜΟ ΣΕ ΕΠΙΠΕΔΟ ΓΡΑΜΜΗΣ.

ΔΟΜΗ ΑΡΧΕΙΟΥ

Το αρχείο διεπαφής, πρέπει να περιέχει τα πεδία το ένα κάτω από το άλλο.

Η σύνταξη των πεδίων είναι <πεδίο>:<τιμή>. Για παράδειγμα, entityVat:555777003

Υποχρεωτική ονομασία αρχείου myDATAexport.txt

TEMPLATE ΑΡΧΕΙΟΥ ΔΙΕΠΑΦΗΣ

entityVAT:

type:

mark:

pages:

encode:

searchItems:

export:

hideUID:

lineData:

Τα πεδία του αρχείου διεπαφής για την άντληση στοιχείων μητρώου εντός Πελάτη/Προμηθευτή

1. pages: Ο αριθμός των σελίδων που θέλουμε να αντλήσουμε. Ο μέγιστος αριθμός σελίδων είναι 5. Η ελάχιστη άντληση περιλαμβάνει παραστατικά μίας (1) σελίδας.
2. searchItems: Είναι οι παράμετροι αναζήτησης στα myDATA. Η παράμετρος αυτή αποτελείται από τα εξής στοιχεία:

• Ημερομηνία Από
• Ημερομηνία Έως
• ΑΦΜ Οντότητας
• ΑΦΜ Αντισυμβαλλόμενου
• Είδος Παραστατικού (πχ 1.1)
• Μέγιστο mark Αναζήτησης

και η δομή του είναι dataFrom;dateTo;entityVatNumber;counterVatNumber;invType;maxMark;

Παρατηρήστε ότι τα πεδία χωρίζονται μεταξύ τους με ερωτηματικά (;). Η ύπαρξη του ερωτηματικού στο τέλος είναι υποχρεωτική.

Παράδειγμα δομής: 1/1/2022;31/3/2022;;;;

3. export: Η επιλογή 3 (txt απλοποιημένο), επιστρέφει μόνο τα μοναδικά mark και τις γραμμές παραστατικού. Η επιλογή αυτή αγνοεί τα πεδία hideUid και lineData.
4. encode: Εάν δεν οριστεί κωδικοποίηση, χρησιμοποιείται η προεπιλογή κωδικοποίησης αρχείων του συστήματος.
5. lineData: Όταν είναι true, επιστρέφει αναλυτικά μία προς μία τις γραμμές του παραστατικού, με μοναδικά δεδομένα τα

• line (αριθμός γραμμής)
• netValue (καθαρή αξία)
• vatAmount (αξία ΦΠΑ)

διαχωρισμένα με παύλες. Τα παραπάνω δεδομένα είναι τα μοναδικά που χρειάζονται για περιπτώσεις χαρακτηρισμού.
Παράδειγμα εμφάνισης: line:1-netValue:100-vatAmount:24

Παράδειγμα διεπαφής Άντλησης Παραστατικών

entityVAT:555777003

type:0

mark:400001850000000

pages:3

encode:UTF

searchItems:1/1/2023;31/01/2023;;;;;

export:0

hideUID:1

lineData:true

Το παραπάνω παράδειγμα, θα περιστρέψει όλα τα μοναδικά παραστατικά (hideUID:1) που έχει στείλει η οντότητα (type:0), για το διάστημα από 01/01/2023 έως και 31/01/2023 (searchItems:1/1/2023;31/01/2023;;;;;), ξεκινώντας από τον mark 400001850000000 (mark:400001850000000) και μέχρι 3000 παραστατικά (pages:3). Τα δεδομένα θα είναι σε κωδικοποίηση UTF8 (encode:UTF), και θα περιέχει αναλυτικά τις γραμμές για κάθε παραστατικό (lineData:true).

Παράδειγμα Επιστρεφόμενου Αρχείου xml

<invoices>
  <invoice>
    <country>GB</country>
    <issuer>555777003</issuer>
    <counterpart>123456789012</counterpart>
    <issueDate>2022-31-01</issueDate>
    <branch>0</branch>
    <invoiceType>1.3 - Τιμολόγιο Πώλησης / Παραδόσεις Τρίτων Χωρών - (ΤΠΤΧ)</invoiceType>
    <aa>1</aa>
    <series>0</series>
    <currency>GBP</currency>
    <linesData>line:1-netValue:175-vatAmount:0</linesData>
    <totalNetValue>175.00</totalNetValue>
    <totalGrossValue>175.00</totalGrossValue>
    <totalEntries>1</totalEntries>
    <mark>400001887784794</mark>
    <uid>FA8B73EAD4038B02E4C95802E870A42CC43B206A</uid>
    <selfPricing>false</selfPricing>
  </invoice>
</invoices>

Τα αποτελέσματα της αναζήτησης, αποθηκεύονται στον φάκελο υπογραφών, στον υποφάκελο exports.

Η ονομασία του αρχείου είναι <type>export<mark>, για παράδειγμα 0export400001850000000.xml