MYDIESEL
  1. Diff
  • specs
    • Batch
      • Πλήρης λήψη εγγραφών ενός έτους
    • Diff
      • Λήψη μεταβολών σε χρονικό διάστημα
        GET
    • Schemas
      • TaxId
      • DieselTotal
      • DieselTotalChange
      • Pagination
      • Control
      • ChangesControl
      • TotalsResponse
      • ChangesResponse
      • Error
  1. Diff

Λήψη μεταβολών σε χρονικό διάστημα

GET
/diesel/totals/changes
Επιστρέφει μόνο τις εγγραφές των οποίων η ημερομηνία τελευταίας μεταβολής
(lastModifiedAt) εμπίπτει στο διάστημα modifiedFrom (συμπεριλαμβανομένου)
έως modifiedTo (μη συμπεριλαμβανομένου).
Κάθε εγγραφή φέρει πεδίο changeType με τιμές:
CREATED — νέα εγγραφή
UPDATED — μεταβολή λίτρων
DELETED — ακύρωση/διαγραφή. Το σύστημα-αποδέκτης οφείλει να αφαιρέσει
ή να απενεργοποιήσει την αντίστοιχη τοπική εγγραφή.
Στην κανονική λειτουργία το modifiedFrom είναι η τιμή generatedAt του
τελευταίου επιτυχούς συγχρονισμού. Το modifiedTo επιτρέπει επανάληψη
αποτυχημένης λήψης για ακριβώς το ίδιο διάστημα.
Το μέγιστο επιτρεπτό εύρος διαστήματος είναι 31 ημέρες. Για μεγαλύτερα
διαστήματα συνιστάται η χρήση της υπηρεσίας πλήρους λήψης.

Request

Authorization
JWT Bearer
Add the parameter
Authorization
to Headers
Example:
Authorization: ********************
or
Query Params

Responses

🟢200
application/json
Επιτυχής λήψη μεταβολών
Bodyapplication/json

🟠422
🟠400BadRequest
🟠401Unauthorized
🟠403Forbidden
🟠429TooManyRequests
🔴500InternalError
🔴503ServiceUnavailable
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/diesel/totals/changes?modifiedFrom=&modifiedTo=&year=&page=&pageSize=' \
--header 'Authorization: Bearer <token>'
Response Response Example
200 - Μεταβολές ημέρας
{
    "requestId": "9f2a1b3c-7d8e-4f01-a2b3-c4d5e6f70819",
    "generatedAt": "2026-09-10T15:00:02Z",
    "modifiedFrom": "2026-09-10T07:00:03Z",
    "modifiedTo": "2026-09-10T15:00:00Z",
    "year": null,
    "pagination": {
        "page": 1,
        "pageSize": 5000,
        "totalPages": 1,
        "totalRecords": 3,
        "hasNext": false
    },
    "control": {
        "totalRecords": 3,
        "sumLitres": 8973.62,
        "created": 1,
        "updated": 1,
        "deleted": 1
    },
    "data": [
        {
            "taxId": "333333333",
            "year": 2026,
            "litres": 2159.25,
            "changeType": "CREATED",
            "lastModifiedAt": "2026-09-10T09:12:44Z"
        },
        {
            "taxId": "444444444",
            "year": 2026,
            "litres": 6814.37,
            "changeType": "UPDATED",
            "lastModifiedAt": "2026-09-10T11:35:07Z"
        },
        {
            "taxId": "555555555",
            "year": 2025,
            "litres": 0,
            "changeType": "DELETED",
            "lastModifiedAt": "2026-09-10T13:48:20Z"
        }
    ]
}
Modified at 2026-09-10 10:45:40
Previous
Πλήρης λήψη εγγραφών ενός έτους
Next
TaxId
Built with