Το ARBITRANS4U δίνει την δυνατότητα στον χρήστη να αντλήσει κάνει άντληση των δεδομένων προσυμπλήρωσης του εντύπου Φ2 από τα myDATA, μέσω αρχείου διεπαφής. Η άντληση αυτή μπορεί να χρησιμοποιηθεί για την προβολή των δεδομένων σε εφαρμογή τρίτου.



ΔΟΜΗ ΑΡΧΕΙΟΥ

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

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

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


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

entityVAT:

pages:

searchItems:

pageKeys:

export:

encode:

unclassOnly:

sumsOnly:



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

ΠΕΔΙΟ

ΠΕΡΙΓΡΑΦΗ

ΔΟΜΗ

ΥΠΟΧΡΕΩΤΙΚΟ

entityVAT

ΑΦΜ ΟΝΤΟΤΗΤΑΣ


NAI

pages

ΣΕΛΙΔΕΣ ΑΝΤΛΗΣΗΣ

1-10

(10 σελίδες, αντιστοιχούν σε μέχρι και 10.000 παραστατικά)

ΟΧΙ

searchItems

ΚΡΙΤΗΡΙΑ ΑΝΑΖΗΤΗΣΗΣ

<Ημερομηνία_Από>;<Ημερομηνία_Έως>;

πχ 1/1/2022;31/3/2022;

πχ 1/1/2022;

NAI

pageKeys

ΚΛΕΙΔΙΑ ΕΠΟΜΕΝΗΣ ΣΕΛΙΔΑΣ

<Πρωτεύον_Κλειδί>;<Κλειδί_Σελίδας>;

Παράδειγμα: 555777003;400001895368682;


export

ΤΥΠΟΣ ΕΞΑΓΩΓΗΣ

0 = xml (default)
1 = csv διαχωρισμός με ερωτηματικά (;)
2 = csv διαχωρισμός με tabs

ΟΧΙ

encode

ΤΥΠΟΣ ΚΩΔΙΚΟΠΟΙΗΣΗΣ

UTF ή ANSI

ΟΧΙ

unclassOnly

ΕΞΑΓΩΓΗ ΜΟΝΟ ΤΩΝ ΜΗ ΧΑΡΑΚΤΗΡΙΣΜΕΝΩΝ ΜΑΡΚ

true/false

OXI

sumsOnly

ΣΥΝΟΠΤΙΚΗ ΕΞΑΓΩΓΗ ΜΟΝΟ ΤΩΝ ΣΥΝΟΛΩΝ

true/false

ΟΧΙ


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

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

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

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

  1. pageKeys: Τα κλειδιά της επόμενης σελίδας χρησιμοποιούνται στην περίπτωση που τα παραστατικά είναι πάρα πολλά στο διάστημα αναζήτησης. Όταν δηλωθούν, συνεχίζεται η αναζήτηση από το σημείο που σταμάτησε.
  2. export: Ο τύπος εξαγωγής των δεδομένων. Εάν δεν δηλωθεί, επιστρέφει τα δεδομένα σε xml.
  3. encode: Εάν δεν οριστεί κωδικοποίηση, χρησιμοποιείται η προεπιλογή κωδικοποίησης αρχείων του συστήματος.
  4. unclassOnly: Εάν true, επιστρέφει μόνο τα δεδομένα εκείνα που υπάρχουν στα myDATA αλλά δεν έχουν χαρακτηριστεί.
  5. sumsOnly: Εάν true, επιστρέφει συνοπτικά μόνο τα σύνολα ανα κωδικό εντύπου Φ2.




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


entityVAT:555777003

pages:10

searchItems:01/10/2025;31/12/2025;

pageKeys:

export:0

encode:UTF

unclassOnly:false

sumsOnly:true


Το παραπάνω παράδειγμα, θα περιστρέψει όλα τα δεδομένα προσυμπλήρωσης, για το 4ο τρίμηνο 2025 (searchItems:01/10/2025;31/12/2025;) σε επίπεδο συνόλων κωδικών εντύπου Φ2 (sumsOnly:true). Στο τρίμηνο, αντλεί μέχρι 10.000 παραστατικά (pages:10) και η εξαγωγή γίνεται σε μορφή xml (export:0), με κωδικοποίηση UTF (encode:UTF).


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


<?xml version="1.0" standalone="yes"?>
<invoices>
  <vatInfoSumsOnly>
    <vatCode>301</vatCode>
    <amount>0,00</amount>
  </vatInfoSumsOnly>
  <vatInfoSumsOnly>
    <vatCode>331</vatCode>
    <amount>0,00</amount>
  </vatInfoSumsOnly>
  <vatInfoSumsOnly>
    <vatCode>302</vatCode>
    <amount>0,00</amount>
  </vatInfoSumsOnly>
  <vatInfoSumsOnly>
    <vatCode>332</vatCode>
    <amount>0,00</amount>
  </vatInfoSumsOnly>
  <vatInfoSumsOnly>
    <vatCode>303</vatCode>
    <amount>756,04</amount>
  </vatInfoSumsOnly>
  <vatInfoSumsOnly>
    <vatCode>333</vatCode>
    <amount>181,43</amount>
  </vatInfoSumsOnly>
  ...
  <vatInfoSumsOnly>
    <vatCode>308</vatCode>
    <amount>0,00</amount>
  </vatInfoSumsOnly>
  <vatInfoSumsOnly>
    <vatCode>338</vatCode>
    <amount>0,00</amount>
  </vatInfoSumsOnly>
  <vatInfoSumsOnly>
    <vatCode>304</vatCode>
    <amount>0,00</amount>
  </vatInfoSumsOnly>
  <vatInfoSumsOnly>
    <vatCode>334</vatCode>
    <amount>0,00</amount>
  </vatInfoSumsOnly>
  <vatInfoSumsOnly>
    <vatCode>305</vatCode>
    <amount>0,00</amount>
  </vatInfoSumsOnly>
  <vatInfoSumsOnly>
    <vatCode>335</vatCode>
    <amount>0,00</amount>
  </vatInfoSumsOnly>
</invoices>
<pageKeys>
  <primary></primary>
  <pageKey></pageKey>
</pageKeys>




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

Η ονομασία του αρχείου είναι <entityVAT>_VATexport, για παράδειγμα 555777040_VATexport.xml