Υπόλοιπες κλήσεις¶

Όλες οι κλήσεις θέλουν το header API-KEY, εκτός από τα τρία δημόσια links των εγγράφων.

Σε αυτή τη σελίδα: RequestTransmittedDocs · CancelDeliveryNote · CancelReceivingNote · GetCreditsBalance · GetInvoicePdf · GetInvoice · GetInvoicePdfByAuthenticationCode · CompletionPosInvoices · AskSignatureForOldInvoice · CompletionAskSignatureForOldInvoice · GetOpenTables · GetOpenOrdersForTable

Παραστατικά¶

RequestTransmittedDocs¶

GET /api/v1/Provider/RequestTransmittedDocs

Αναζήτηση στα παραστατικά που εκδώσατε. Τη χρησιμοποιείτε για να βρείτε ένα MARK (π.χ. μετά από Offline) ή για συμφωνία.

Query	Υποχρεωτικό	Περιγραφή
`issuerVatNumber`	ναι	ΑΦΜ εκδότη.
`issuedFrom`, `issuedTo`	ναι	Διάστημα ημερομηνιών έκδοσης, `yyyy-MM-dd`.
`uid`, `invoiceMark`, `authenticationcode`		Για ένα συγκεκριμένο παραστατικό.
`series`, `aa`, `invoiceType`, `branch`, `counterpartVatNumber`		Φίλτρα.
`resultNumber`		Μέγιστος αριθμός αποτελεσμάτων.
`nextPageKey`		Η σελίδα που ζητάτε. Τα αποτελέσματα έρχονται ανά 100.

200 OK

{
  "providerTransmittedDocs": [
    {
      "uid": "15B0B6AEB08979B44EE68110CD734458F22ED6DE",
      "mark": 400001939575310,
      "authenticationCode": "904E2E03B5C4B0B0826BB2B8375F61E5F73118AD",
      "issuer": { "vatNumber": "123456789", "branch": 0 },
      "counterpart": { "vatNumber": "987654324" },
      "invoiceHeader": { "series": "A", "aa": "1001", "issueDate": "2026-09-24T00:00:00Z", "invoiceType": "1.1" },
      "invoiceSummary": { "totalNetValue": 100, "totalVatAmount": 24, "totalGrossValue": 124 },
      "cost": 1,
      "pdfUrl": "https://provider-dev.timologisi.online/api/v1/Provider/GetInvoicePdf/671893b51d6d0b3d947bc4b9.pdf",
      "insertedDateTime": "2026-09-24T06:12:05.55Z"
    }
  ]
}

Στο δοκιμαστικό περιβάλλον τα παραστατικά σβήνονται μετά από 30 ημέρες.

CancelDeliveryNote¶

POST /api/v1/Provider/CancelDeliveryNote

Ακύρωση δελτίου αποστολής (9.x) χωρίς να εκδοθεί νέο. Χρεώνει 0,25 credits.

Body

{ "mark": "400001958007000", "entityVatNumber": "123456789" }

Η απάντηση έχει την ίδια μορφή με το SendInvoices. Με επιτυχία, το statusCode είναι Success και το cancellationMark έχει το MARK της ακύρωσης.

CancelReceivingNote¶

POST /api/v1/Provider/CancelReceivingNote

Το ίδιο, για δελτία ποσοτικής παραλαβής (10.x, myDATA 2.0.2).

GetCreditsBalance¶

GET /api/v1/Provider/GetCreditsBalance

200 OK

{ "userId": "…", "creditsBalance": 1520.5 }

Έγγραφα (δημόσια, χωρίς API key)¶

GetInvoicePdf¶

GET /api/v1/Provider/GetInvoicePdf/{fileName}

Το PDF πίσω από το invoiceUrl / qrUrl. Επιστρέφει application/pdf.

GetInvoice¶

GET /api/v1/Provider/GetInvoice/{uid}/{fileType}

Το παραστατικό με βάση το UID. Είναι το downloadingInvoiceUrl που στέλνει ο Πάροχος στην ΑΑΔΕ για τον λήπτη (Α.1128/2025).

`fileType`	Επιστρέφει
`pdf` (προεπιλογή, ή χωρίς τιμή)	`application/pdf`
`myDATA`	Το αναλυτικό XML του myDATA (`InvoicesDoc_detailed`)

GetInvoicePdfByAuthenticationCode¶

GET /api/v1/Provider/GetInvoicePdfByAuthenticationCode/{authenticationCode}

Το PDF με βάση το Authentication Code.

Πληρωμές μέσω POS¶

Η ροή με διαγράμματα: Πληρωμή με κάρτα / IRIS.

CompletionPosInvoices¶

POST /api/v1/Provider/CompletionPosInvoices

Ολοκληρώνει τα παραστατικά που στάλθηκαν με SendInvoices?skipSignature=false, αφού το τερματικό χρέωσε την κάρτα ή το IRIS. Το body είναι πίνακας:

[
  {
    "signatureToken": "<providerSignature[0].signatures[0].token από το SendInvoices>",
    "transactionId": "123456788555",
    "paymentAmount": 124,
    "tipAmount": 0,
    "paymentType": 7
  }
]

Πεδίο	Υποχρεωτικό	Περιγραφή
`signatureToken`	ναι	Το `providerSignature[].signatures[].token` από το SendInvoices.
`transactionId`	ναι	Από το POS / NSP.
`paymentAmount`	ναι	Μεγαλύτερο από 0 και έως το `paymentBalance` της υπογραφής.
`tipAmount`		Φιλοδώρημα.
`paymentType`		Ο τελικός τύπος από το τερματικό: `7` κάρτα ή `8` IRIS. Προεπιλογή `7`.

Επιστρέφει την απάντηση του SendInvoices.

AskSignatureForOldInvoice¶

POST /api/v1/Provider/AskSignatureForOldInvoice?terminalId={tid}&posNspId={id}

Υπογραφή Παρόχου για να εξοφληθεί μέσω POS ένα παραστατικό που εκδόθηκε νωρίτερα (π.χ. επί πιστώσει).

Ασυνήθιστο body

Το body είναι σκέτο το MARK του παραστατικού, ως αριθμός JSON, π.χ. 400001930000001, όχι αντικείμενο. Τα terminalId και posNspId πηγαίνουν στο query string.

200 OK

{ "token": "…", "data": "…", "createdDate": "…", "expiryDate": "…", "paymentBalance": 124.00, "issuerVatNumber": "123456789" }

CompletionAskSignatureForOldInvoice¶

POST /api/v1/Provider/CompletionAskSignatureForOldInvoice?signatureToken=…&transactionId=…&paymentAmount=…&tipAmount=0&paymentType=7

Body: σκέτο το MARK του παραστατικού, ως αριθμός JSON. Το paymentType είναι προαιρετικό (7 ή 8, προεπιλογή 7).

Εστίαση (8.6)¶

Ο οδηγός: Εστίαση.

GetOpenTables¶

GET /api/v1/Provider/GetOpenTables?VatNumber=123456789&Branch=0

Επιστρέφει τα τραπέζια (tableAA, GUID) που έχουν ακόμη ανοιχτά δελτία παραγγελίας.

200 OK

[ "A98EFBDE-5FBB-4128-BBD8-B6DDA701AB20" ]

GetOpenOrdersForTable¶

GET /api/v1/Provider/GetOpenOrdersForTable?TableId={guid}&VatNumber=123456789&Branch=0

200 OK

[ { "mark": "400001930000011", "uid": "…", "quantityProducts": 2, "totalNet": 15.00 } ]

Επιστρέφει 404 όταν το τραπέζι δεν έχει ανοιχτά δελτία.