e-Transport

Jelenleg az AROBS TrackGPS által biztosított API lehetővé teszi, hogy 7 végpontot használjon a vállalat fiókjában lévő fuvarok kezeléséhez:

Módszer URL Leírás
POST https://api.trackgps.ro/api/eTransport/add-transport?api-version=2.0 Új fuvar hozzáadása
POST https://api.trackgps.ro/api/eTransport/update-transport?api-version=2.0 Fuvar frissítése
POST https://api.trackgps.ro/api/eTransport/load-transports?api-version=2.0 Fuvar lekérése
POST https://api.trackgps.ro/api/eTransport/remove-transports?api-version=2.0 Fuvar törlése
POST https://api.trackgps.ro/api/eTransport/start-transports?api-version=2.0 Fuvar indítása
POST https://api.trackgps.ro/api/eTransport/end-transports?api-version=2.0 Fuvar befejezése
POST https://api.trackgps.ro/api/eTransport/pause-transports?api-version=2.0 Fuvar szüneteltetése

Két egymást követő kérés között legalább 30 másodpercnek kell eltelnie.

e-Transport alfejezet

Fuvar hozzáadása

Általános leírás

Az add-transport végpont lehetővé teszi egy új fuvar hozzáadását a rendszerhez. A felhasználó megadhatja a fuvarhoz kapcsolódó összes részletet, beleértve a hozzárendelt járművet, a kezdő és záró dátumokat, a helyszíneket, valamint további információkat, például a kapcsolódó pótkocsit.

A végpont a Rate Limit korlátozásai alá tartozik.

⚠️ Minden kéréshez kötelező az api-version=2.0 paramétert megadni az URL-ben.
URL: POST https://api.trackgps.ro/api/eTransport/add-transport?api-version=2.0

Kérés paraméterei

A végponthoz küldött kéréseknek POST típusúnak kell lenniük, és a következő paramétereket kell tartalmazniuk:

  • Query paraméter:

    • api-version (string, kötelező) – Az API verziója. Ajánlott érték: 2.0

  • Body (JSON):

{
  "vehicleUId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "startDate": "2025-04-09T07:38:24.380Z",
  "endDate": "2025-04-09T07:38:24.380Z",
  "codeUit": "string",
  "notes": "string",
  "startLocation": "string",
  "endLocation": "string",
  "vatNumber": "string",
  "validityStartDate": "2025-04-09T07:38:24.380Z",
  "validityEndDate": "2025-04-09T07:38:24.380Z",
  "trailer1Code": "string",
  "trailer2Code": "string"
}
Paraméter Típus Kötelező Leírás
vehicleUId string Igen A fuvarhoz tartozó jármű egyedi azonosítója.
startDate string Nem Az adatok ANAF platformára történő továbbításának kezdő dátuma és ideje (ISO 8601, UTC formátum).
endDate string Nem Az adatok ANAF platformára történő továbbításának záró dátuma és ideje (ISO 8601, UTC formátum).
codeUit string Igen Az ANAF által generált UIT kód.
notes string Nem További megjegyzések a fuvarhoz.
startLocation string Nem A fuvar kezdő helyszíne.
endLocation string Nem A fuvar végső helyszíne.
vatNumber string Igen A fuvarozó adószáma (CIF).
validityStartDate string Igen Az UIT kód érvényességének kezdő dátuma. Ezt az ANAF platform generálja (ISO 8601, UTC formátum).
validityEndDate string Igen Az UIT kód érvényességének záró dátuma. Ezt az ANAF platform generálja (ISO 8601, UTC formátum).
trailer1Code string Nem Az első pótkocsi rendszáma.
trailer2Code string Nem A második pótkocsi rendszáma.

🕒 Fontos: Minden dátum típusú mezőt (pl. startDate, endDate, validityStartDate, validityEndDate) UTC formátumban kell megadni.

Válasz szerkezete

{
  "payload": true,
  "correlationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "failureReasons": [
    {
      "errorCode": "string",
      "errorParameters": [
        "string"
      ]
    }
  ],
  "isSuccess": true
}

Tulajdonságok leírása

Tulajdonság Típus Leírás
payload boolean Jelzi, hogy a fuvar sikeresen hozzá lett-e adva (true vagy false).
correlationId string A kérés azonosítója a válaszok összekapcsolásához.
failureReasons array Hibák listája (ha van), további részletekkel.
isSuccess boolean Jelzi, hogy a kérés sikeresen feldolgozásra került-e (true) vagy sem (false).

Hibaválaszok

HTTP kód Leírás
400 Hiányzó paraméterek vagy érvénytelen szerkezet.
401 Hibás hitelesítő adatok vagy jogosulatlan felhasználó.
429 A felhasználó túllépte a lekérdezési limitet.

Fuvar módosítása

Általános leírás

Az update-transport végpont lehetővé teszi egy már meglévő fuvar módosítását a rendszerben. Frissítheted például az időszakot, helyszíneket, megjegyzéseket vagy a pótkocsik adatait.

A Rate Limit korlátozásai érvényesek.

⚠️ Minden kéréshez kötelező az api-version=2.0 paramétert megadni az URL-ben.
URL: POST https://api.trackgps.ro/api/eTransport/update-transport?api-version=2.0

Kérés paraméterei

A végponthoz POST típusú kérést kell küldeni az alábbi paraméterekkel:

  • Query paraméter:

    • api-version (string, kötelező) – Az API verziója. Ajánlott érték: 2.0

  • Body (JSON):

{
  "transportUId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "vehicleUId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "startDate": "2025-04-09T07:38:24.380Z",
  "endDate": "2025-04-09T07:38:24.380Z",
  "notes": "string",
  "startLocation": "string",
  "endLocation": "string",
  "vatNumber": "string",
  "validityStartDate": "2025-04-09T07:38:24.380Z",
  "validityEndDate": "2025-04-09T07:38:24.380Z",
  "trailer1Code": "string",
  "trailer2Code": "string"
}
Paraméter Típus Kötelező Leírás
transportUId string Igen A módosítandó fuvar azonosítója.
vehicleUId string Igen A fuvarhoz tartozó jármű azonosítója.
startDate string Nem Az adatszolgáltatás kezdő dátuma és ideje az ANAF platformon (ISO 8601, UTC formátum).
endDate string Nem Az adatszolgáltatás befejező dátuma és ideje az ANAF platformon (ISO 8601, UTC formátum).
validityStartDate string Igen A UIT kód érvényességének kezdete. Az ANAF platform generálja (ISO 8601, UTC formátum).
validityEndDate string Igen A UIT kód érvényességének vége. Az ANAF platform generálja (ISO 8601, UTC formátum).
notes string Nem További megjegyzések.
startLocation string Nem Indulási helyszín.
endLocation string Nem Érkezési helyszín.
vatNumber string Igen A fuvarozó adószáma (CIF).
trailer1Code string Nem Az első pótkocsi rendszáma.
trailer2Code string Nem A második pótkocsi rendszáma.

🕒 Fontos: A dátum típusú mezőket (startDate, endDate, validityStartDate, validityEndDate) UTC formátumban kell megadni.

Válasz szerkezete

{
  "payload": true,
  "correlationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "failureReasons": [
  {
    "errorCode": "string",
    "errorParameters": [
    "string"
    ]
  }
  ],
  "isSuccess": true
}

Tulajdonságok leírása

Tulajdonság Típus Leírás
payload boolean Jelzi, hogy a fuvar módosítása sikeres volt-e.
correlationId string A kérés egyedi azonosítója (nyomon követéshez, hibakereséshez).
failureReasons array Hibák listája (ha van), kódokkal és paraméterekkel.
isSuccess boolean Jelzi, hogy a kérés hibamentesen feldolgozásra került-e (true/false).

Hibaválaszok

HTTP kód Leírás
400 Hiányzó paraméter vagy hibás szerkezet.
401 Hibás hitelesítő adatok vagy jogosulatlan felhasználó.
429 A felhasználó túllépte a lekérési limitet.

Fuvarok listája

Általános leírás

A load-transports végpont arra szolgál, hogy a felhasználó fiókjában elérhető fuvarok listáját lekérje, a járművekhez való hozzáférési jogosultságok alapján. A felhasználó szűrő paramétereket is megadhat, például a fuvar státuszát vagy egy keresési kifejezést.

A végpont a Rate Limit korlátozásai alá esik.

⚠️ A fuvarok minden dátumadata, amely a válaszban megjelenik, a vállalat időzónájában van rögzítve, nem UTC-ben. Győződjön meg róla, hogy a fuvarokat a vállalat időzóna beállításainak megfelelően kezeli, amikor az adatokat lekéri a rendszerből.

⚠️ Minden kéréshez kötelező az api-version=2.0 paramétert megadni az URL-ben.
URL: POST https://api.trackgps.ro/api/eTransport/load-transports?api-version=2.00

⚠️ Azok a fuvarok, amelyek státusza “Hiba” és a mobil vagy webes alkalmazásban láthatók, ebből a végpontból nem kerülnek visszaadásra.

Kérés paraméterei

A végponthoz POST típusú kérést kell küldeni, az alábbi paraméterekkel:

  • Query paraméter:

    • api-version (string, kötelező) – Az API verziója. Ajánlott érték: 2.0

  • Body (JSON):

{
  "pageSize": 0,
  "pageIndex": 0,
  "statusIds": [
  1
  ],
  "searchValue": "string"
}
Paraméter Típus Kötelező Leírás
pageSize number Nem Az oldalon visszaadott elemek száma.
pageIndex number Nem Az oldal indexe a lekérdezéshez.
statusIds array Igen A keresett fuvar státuszok azonosítóinak listája.
searchValue string Nem Keresési szó vagy kifejezés a fuvarok listájában.

Fuvar státuszok listája

Id Leírás
1 Függőben
2 Folyamatban
3 Befejezett
4 Automatikusan lezárt
5 Hiba
6 Szünet

Válasz szerkezete

{
  "payload": {
  "totalRecords": 0,
  "transports": [
    {
    "uId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "carrierCode": "string",
    "carrierName": "string",
    "carrierUId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "trailer1Code": "string",
    "trailer2Code": "string",
    "codeUit": "string",
    "statusId": 0,
    "startDate": "2025-05-16T14:35:04.862Z",
    "endDate": "2025-05-16T14:35:04.862Z",
    "validityStartDate": "2025-05-16T14:35:04.862Z",
    "validityEndDate": "2025-05-16T14:35:04.862Z",
    "notes": "string",
    "startLocation": "string",
    "endLocation": "string",
    "externalId": 0,
    "externalResponse": "string",
    "lastSyncDate": "2025-05-16T14:35:04.862Z",
    "transmissionStatusCode": "string",
    "transmissionStatusErrorDescription": "string",
    "lastTransmissionDate": "2025-05-16T14:35:04.862Z",
    "lastGpsDate": "2025-05-16T14:35:04.862Z",
    "changeRequestMessage": "string",
    "changeRequestStatusCode": "string",
    "changeRequestCreatedAt": "2025-05-16T14:35:04.862Z",
    "changeRequestDate": "2025-05-16T14:35:04.862Z",
    "changeRequestAnafStatus": "string",
    "changeRequestAnafMessage": "string",
    "changeRequestAnafDate": "2025-05-16T14:35:04.862Z"
    }
  ]
  },
  "correlationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "failureReasons": [
  {
    "errorCode": "string",
    "errorParameters": [
    "string"
    ]
  }
  ],
  "isSuccess": true
}

Tulajdonságok leírása

Tulajdonság Típus Leírás
payload object Az objektum tartalmazza a visszaadott fuvarokat és egyéb releváns információkat.
totalRecords number Az elérhető fuvarok teljes száma.
transports array Az elérhető fuvarok listája, mindegyik saját részletes adatokkal.
uId string A fuvar egyedi azonosítója.
carrierCode string A jármű rendszáma, amelyet az ANAF-hoz történő helyadat-továbbításhoz használnak.
carrierName string A jármű neve, amelyet az ANAF-hoz történő helyadat-továbbításhoz használnak.
carrierUId string A jármű egyedi azonosítója.
trailer1Code string Az első pótkocsi rendszáma.
trailer2Code string A második pótkocsi rendszáma.
codeUit string Az ANAF által generált UIT kód.
statusId number A fuvar státusza.
startDate string Az ANAF platformján a GPS adatok továbbításának kezdete (dátum és idő).
endDate string Az ANAF platformján a GPS adatok továbbításának vége (dátum és idő).
validityStartDate string Az UIT kód érvényességének kezdete (ANAF generálja).
validityEndDate string Az UIT kód érvényességének vége (ANAF generálja).
notes string További megjegyzések a fuvarhoz.
startLocation string A fuvar indulási helye.
endLocation string A fuvar érkezési helye.
externalId number Az ANAF platformján a fuvar válaszának azonosítója.
externalResponse string Az ANAF platformjáról érkező válaszüzenet.
lastSyncDate string Az ANAF platformjáról történő fuvar átvételének dátuma.
transmissionStatusCode string GPS adatok ANAF platformra történő továbbításának státusza.
transmissionStatusErrorDescription string A GPS adatok továbbítási hibájának leírása az ANAF platformra.
lastTransmissionDate string Az utolsó GPS koordináta továbbításának dátuma az ANAF felé.
lastGpsDate string Az utolsó GPS koordináta fogadásának dátuma a járműtől.
changeRequestMessage string A fuvaradat-módosítási kérelem válaszüzenete.
changeRequestStatusCode string A fuvaradat-módosítási kérelem státusza.
changeRequestCreatedAt string A fuvaradat-módosítási kérelem létrehozásának dátuma.
changeRequestDate string Az ANAF platformról érkező válasz fogadásának dátuma a módosítási kérelemre.
changeRequestAnafStatus string Az ANAF platformról érkező fuvaradat-módosítási kérelem státusza.
changeRequestAnafMessage string Az ANAF platformról érkező fuvaradat-módosítási kérelem feldolgozásának válaszüzenete.
changeRequestAnafDate string Az ANAF platformról érkező fuvaradat-módosítási kérelem feldolgozásának dátuma.
correlationId string A kérés azonosítója a válaszok összekapcsolásához.
failureReasons array Hibák listája (ha van), további részletekkel.
isSuccess boolean Jelzi, hogy a kérés sikeresen feldolgozásra került-e (true) vagy sem (false).

GPS adatok ANAF platformra történő továbbításának státuszai

Kód Leírás
Active Aktív továbbítás
Finalized Lezárt továbbítás
NotInRomania Nincs Románia területén
NotStarted Továbbításra vár
Error Továbbítási hiba
MissingETransportConfiguration e-Transport konfigurációs hiba, kérjük, forduljon a támogatáshoz
OldData 6 óránál régebbi adatok
NoGPSCoordinates Nincs GPS jel
WithoutTransmission Nincs aktív GPS továbbítás

Fuvaradat-módosítási kérelmek státuszai

Kód Leírás
RequestCreated Kérelem létrehozva
RequestSent Kérelem sikeresen elküldve
RequestErrorSent Kérelem küldése sikertelen
ResponseSuccess Kérelem sikeresen lezárva
ResponseError Kérelem hibával lezárva

Hibaválaszok

HTTP kód Leírás
400 Hiányzó paraméterek vagy érvénytelen szerkezet.
401 Hibás hitelesítő adatok vagy jogosulatlan felhasználó.
429 A felhasználó túllépte a lekérdezési limitet.

Fuvarok törlése

Általános leírás

A remove-transports végpont lehetővé teszi egy vagy több fuvar törlését a rendszerből az egyedi azonosítók (transportUId) alapján. Ez a művelet visszavonhatatlan, és megfelelő jogosultságokat igényel az érintett fuvarokra.

A Rate Limit korlátozásai érvényesek.

⚠️ Minden kéréshez ehhez a végponthoz kötelező az api-version=2.0 paramétert megadni az URL-ben.
URL: POST https://api.trackgps.ro/api/eTransport/remove-transports?api-version=2.0

Kérés paraméterei

A végponthoz küldött kéréseknek POST típusúnak kell lenniük, és a következő paramétereket kell tartalmazniuk:

  • Query paraméter:

    • api-version (string, kötelező) – Az API verziója. Ajánlott érték: 2.0

  • Body (JSON):

{
  "transportsUids": [
  "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  ]
}
Paraméter Típus Kötelező Leírás
transportsUids tömb Igen Az egyedi fuvar azonosítók (GUID) listája, amelyeket törölni kell.

Válasz szerkezete

{
  "payload": true,
  "correlationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "failureReasons": [
  {
    "errorCode": "string",
    "errorParameters": [
    "string"
    ]
  }
  ],
  "isSuccess": true
}

Tulajdonságok leírása

Tulajdonság Típus Leírás
payload logikai A törlési művelet eredménye (true, ha sikeres volt).
correlationId string Egyedi kérésazonosító, nyomon követéshez hasznos.
failureReasons tömb Hibák listája (ha vannak), mindegyik tartalmaz kódot és paramétereket.
isSuccess logikai Jelzi, hogy a kérés sikeresen feldolgozásra került-e (true vagy false).

Hibaválaszok

HTTP kód Leírás
400 Hiányzó, érvénytelen vagy hibás formátumú paraméterek.
401 Nincs hitelesítve a felhasználó vagy nincs jogosultsága.
429 A felhasználó túllépte a rate limit-et.

Adatküldési munkamenet indítása

Általános leírás

A start-transports végpont lehetővé teszi egy vagy több már létrehozott fuvar indítását (aktiválását). Ez a művelet beállítja a fuvar kezdő dátumát, és aktívként jelöli a rendszerben.

A Rate Limit korlátozásai érvényesek.

⚠️ Minden kéréshez ehhez a végponthoz kötelező az api-version=2.0 paramétert megadni az URL-ben.
URL: POST https://api.trackgps.ro/api/eTransport/start-transports?api-version=2.0

Kérés paraméterei

A végponthoz küldött kéréseknek POST típusúnak kell lenniük, és a következő paramétereket kell tartalmazniuk:

  • Query paraméter:

    • api-version (string, kötelező) – Az API verziója. Ajánlott érték: 2.0

  • Body (JSON):

{
  "transports": [
    {
      "codeUit": "string"
    }
  ]
}
Paraméter Típus Kötelező Leírás
transports array Igen Az indítandó fuvarok listája.
codeUit string Igen A fuvar egyedi UIT azonosító kódja.

🕒 Fontos: Minden dátumot (startDate) UTC formátumban kell megadni.

Válasz szerkezete

{
  "payload": {
    "codeUit": "string",
    "isSuccess": true,
    "errors": [
      "string"
    ]
  },
  "correlationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "failureReasons": [
    {
      "errorCode": "string",
      "errorParameters": [
        "string"
      ]
    }
  ],
  "isSuccess": true
}

Tulajdonságok leírása

Tulajdonság Típus Leírás
payload boolean Az indítás eredménye (true, ha sikeres volt).
correlationId string Egyedi kérésazonosító, nyomon követéshez hasznos.
failureReasons array Hibák listája (ha vannak), mindegyik tartalmaz kódot és paramétereket.
isSuccess boolean Jelzi, hogy a kérés sikeresen feldolgozásra került-e (true vagy false).

Hibaválaszok

HTTP kód Leírás
400 Hiányzó, érvénytelen vagy hibás formátumú paraméterek.
401 Nem hitelesített vagy jogosulatlan felhasználó.
429 A felhasználó túllépte a rate limit-et.

Adatküldési szakasz leállítása

Általános leírás

Az end-transports végpont lehetővé teszi egy vagy több aktív fuvarok leállítását UIT kód alapján. Ezzel a művelettel a fuvarok lezárásra kerülnek a rendszerben, és később már nem módosíthatók.

A Rate Limit korlátozásai érvényesek.

⚠️ Minden kéréshez kötelező az api-version=2.0 paramétert megadni az URL-ben.
URL: POST https://api.trackgps.ro/api/eTransport/end-transports?api-version=2.0

Kérés paraméterei

A végponthoz POST típusú kérést kell küldeni az alábbi paraméterekkel:

  • Query paraméter:

    • api-version (string, kötelező) – Az API verziója. Ajánlott érték: 2.0

  • Body (JSON):

{
  "transports": [
    {
      "codeUit": "string"
    }
  ]
}
Paraméter Típus Kötelező Leírás
transports array Igen A leállítandó fuvarok listája.
codeUit string Igen A fuvar egyedi UIT azonosítója.

🕒 Fontos: Minden dátum (endDate) UTC formátumban legyen megadva.

Válasz szerkezete

{
  "payload": {
    "codeUit": "string",
    "isSuccess": true,
    "errors": [
      "string"
    ]
  },
  "correlationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "failureReasons": [
    {
      "errorCode": "string",
      "errorParameters": [
        "string"
      ]
    }
  ],
  "isSuccess": true
}

Tulajdonságok leírása

Tulajdonság Típus Leírás
payload boolean A leállítás eredménye (true, ha sikeres volt).
correlationId string Egyedi azonosító a kéréshez, nyomon követéshez.
failureReasons array Hibák listája (ha vannak), mindegyik tartalmaz kódot és paramétereket.
isSuccess boolean Jelzi, hogy a kérés sikeresen feldolgozásra került-e (true vagy false).

Hibaválaszok

HTTP kód Leírás
400 Hiányzó, érvénytelen vagy hibás formátumú paraméterek.
401 Nincs hitelesítés vagy jogosultság.
429 Felhasználó túllépte a rate limit-et.

Adatküldési szüneteltetés

Általános leírás

A pause-transports végpont lehetővé teszi egy aktív fuvar pozíciójának továbbításának szüneteltetését UIT kód alapján. Hasonlóan a start és stop végpontokhoz, a fuvarok ideiglenesen szüneteltethetők.

A Rate Limit korlátozásai érvényesek.

⚠️ Minden kéréshez kötelező az api-version=2.0 paramétert megadni az URL-ben.
URL: POST https://api.trackgps.ro/api/eTransport/pause-transports?api-version=2.0

Kérelem paraméterei

A végponthoz küldött kéréseknek POST típusúnak kell lenniük, és a következő paramétereket kell tartalmazniuk:

  • Query paraméter:

    • api-version (string, kötelező) – Az API verziója. Ajánlott érték: 2.0

  • Törzs (JSON):

{
  "transports": [
    {
      "codeUit": "string"
    }
  ]
}
Paraméter Típus Kötelező Leírás
transports tömb Igen A szüneteltetendő fuvarok listája.
codeUit string Igen A fuvar egyedi UIT azonosító kódja.

Válasz szerkezete

{
  "payload": true,
  "correlationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "failureReasons": [
    {
      "errorCode": "string",
      "errorParameters": [
        "string"
      ]
    }
  ],
  "isSuccess": true
}

Tulajdonságok leírása

Tulajdonság Típus Leírás
payload boolean A szüneteltetés művelet eredménye (true, ha sikeres volt).
correlationId string Egyedi azonosító a kéréshez, nyomon követéshez hasznos.
failureReasons tömb Hibák listája (ha vannak), mindegyik kóddal és paraméterekkel.
isSuccess boolean Jelzi, hogy a kérés sikeresen feldolgozásra került-e (true vagy false).

Hibaválaszok

HTTP kód Leírás
400 Hiányzó, érvénytelen vagy hibás formátumú paraméterek.
401 Nem hitelesített vagy jogosulatlan felhasználó.
429 A felhasználó túllépte a rate limit-et.