Other endpoints¶

Every call needs the API-KEY header, except the three public document links.

On this page: RequestTransmittedDocs · CancelDeliveryNote · CancelReceivingNote · GetCreditsBalance · GetInvoicePdf · GetInvoice · GetInvoicePdfByAuthenticationCode · CompletionPosInvoices · AskSignatureForOldInvoice · CompletionAskSignatureForOldInvoice · GetOpenTables · GetOpenOrdersForTable

Invoices¶

RequestTransmittedDocs¶

GET /api/v1/Provider/RequestTransmittedDocs

Search the documents you have issued. Use it to find a MARK (e.g. after Offline) or for reconciliation. For an Offline document you see, with the same uid, one record with mark 0 and, once it is transmitted, a second one with AADE's MARK (checking Offline).

Query	Required	Description
`issuerVatNumber`	yes	VAT number (ΑΦΜ) of the issuer.
`issuedFrom`, `issuedTo`	yes	Issue date range, `yyyy-MM-dd`.
`uid`, `invoiceMark`, `authenticationcode`		For one specific document.
`series`, `aa`, `invoiceType`, `branch`, `counterpartVatNumber`		Filters.
`resultNumber`		Maximum number of results.
`nextPageKey`		The page you request. Results come in pages of 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"
    }
  ]
}

In the sandbox, documents are deleted after 30 days.

CancelDeliveryNote¶

POST /api/v1/Provider/CancelDeliveryNote

Cancel a delivery note (9.x) without issuing a new one. Costs 0.25 credits.

Body

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

The response has the same format as SendInvoices. On success, statusCode is Success and cancellationMark holds the MARK of the cancellation.

CancelReceivingNote¶

POST /api/v1/Provider/CancelReceivingNote

The same, for quantitative receiving notes (10.x, myDATA 2.0.2).

GetCreditsBalance¶

GET /api/v1/Provider/GetCreditsBalance

200 OK

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

Documents (public, no API key)¶

GetInvoicePdf¶

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

The PDF behind invoiceUrl / qrUrl. Returns application/pdf.

GetInvoice¶

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

The document by UID. This is the downloadingInvoiceUrl that the provider sends to AADE for the recipient (A.1128/2025).

`fileType`	Returns
`pdf` (default, or no value)	`application/pdf`
`myDATA`	The detailed myDATA XML (`InvoicesDoc_detailed`)

GetInvoicePdfByAuthenticationCode¶

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

The PDF by Authentication Code.

POS payments¶

The flow, with diagrams: Card / IRIS payment.

CompletionPosInvoices¶

POST /api/v1/Provider/CompletionPosInvoices

Completes the documents sent with SendInvoices?skipSignature=false, after the terminal has charged the card or IRIS. The body is an array:

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

Field	Required	Description
`signatureToken`	yes	The `providerSignature[].signatures[].token` from SendInvoices.
`transactionId`	yes	From the POS / NSP.
`paymentAmount`	yes	Greater than 0 and up to the `paymentBalance` of the signature.
`tipAmount`		Tip.
`paymentType`		The final type from the terminal: `7` card or `8` IRIS. Default `7`.

Returns the SendInvoices response.

AskSignatureForOldInvoice¶

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

Provider signature to pay, through a POS terminal, a document issued earlier (e.g. on credit).

Unusual body

The body is just the MARK of the document, as a JSON number, e.g. 400001930000001, not an object. terminalId and posNspId go in the 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: just the MARK of the document, as a JSON number. paymentType is optional (7 or 8, default 7).

Food service (8.6)¶

The guide: Food service.

GetOpenTables¶

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

Returns the tables (tableAA, GUID) that still have open order slips.

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 } ]

Returns 404 when the table has no open order slips.