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.