Login

Descriere Generală

Endpoint-ul login este utilizat pentru autentificarea utilizatorilor în cadrul API-ului. Acesta primește în corpul cererii un username și o parolă, iar în cazul în care autentificarea este validă, returnează un token de acces (JWT) împreună cu un token de reîmprospătare. Aceste token-uri trebuie utilizate pentru autorizarea cererilor către resurse protejate din API.

⚠️ Toate cererile către acest endpoint trebuie să includă parametrul api-version=2.0 în URL.
URL: POST https://api.trackgps.ro/api/authentication/login?api-version=2.0

Parametri Cerere

Cererile către acest endpoint trebuie să fie de tip POST și să includă:

• Parametru de query:

  • api-version: versiunea API-ului. Valoare recomandată: 2.0.

• Payload-ul trebuie trimis în corpul cererii ca form data cu următoarea structură:

{
  "username": "utilizator@example.com",
  "password": "parolaSecreta123"
}

Descrierea Parametrilor

• username: Numele de utilizator sau adresa de email utilizată la autentificare.
• password: Parola asociată contului.

Structura Răspunsului

Un răspuns de succes (HTTP 200) va avea următorul format:

{
    "access_token": "eyJhbGciOavJZdtmkv3s9OW4ljE2V225_uTkntrDo-SDYwFGgYLbpQ",
    "expires_in": 28800,
    "token_type": "Bearer",
    "refresh_token": "8E65181908146821C79E26259683DF6F-1",
    "scope": "CarPoolingAPI IdentityServerApi offline_access openid profile TrackGPSV4Api"
}

Descrierea Proprietăților

• access_token: Tokenul JWT utilizat pentru autorizarea cererilor ulterioare către API.
• expires_in: Durata de valabilitate a tokenului (în secunde).
• token_type: Tipul tokenului, în general “Bearer”.
• refresh_token: Token ce poate fi utilizat pentru reîmprospătarea sesiunii fără reautentificare.
• scope: Lista de permisiuni asociate tokenului.

Răspunsuri de Eroare

• 400 Bad Request – Parametri lipsă sau structură incorectă a cererii.
• 401 Unauthorized – Credențiale invalide sau utilizator inactiv.
• 429 Too Many Requests – Limită de rată depășită pentru utilizatorul curent.

Vehiculele companiei

Descriere Generală

Metoda CompanyVehicles returnează lista cu vehicule și detaliile acestora. Aceasta returnează doar vehiculele la care utilizatorul are acces.
Din răspunsul acestei metode se pot reține vehicleId-urile vehiculelor, care pot fi folosite ulterior la apelul celorlalte metode din API.

Este supus restricțiilor din Rate Limit

⚠️ Toate cererile către acest endpoint trebuie să includă parametrul api-version=2.0 în URL.
URL: GET https://api.trackgps.ro/api/carriers/company-vehicles?api-version=2.0

⚠️ Notă: Toate datele calendaristice transmise sau returnate de acest endpoint sunt în fusul orar local al companiei.

Structura Răspunsului

{
  "payload": [
    {
      "vehicleId": 0,
      "vehicleUId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "vehicleName": "string",
      "vehicleRegistrationNumber": "string",
      "latitude": 0,
      "longitude": 0,
      "gpsDate": "2024-09-09T08:52:55.005",
      "address": "string",
      "speed": 0,
      "course": 0,
      "engineEvent": 0,
      "engineRpm": 0,
      "engineEventDate": "2024-09-09T08:52:55.005",
      "serverDate": "2024-09-09T08:52:55.005",
      "isPrivate": true,
      "vehicleIdentificationNumber": "string",
      "externalPowerVoltage": 0,
      "vehicleManufacturer": "string",
      "vehicleModel": "string",
      "manufactureYear": 0
    }
  ],
  "correlationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "failureReasons": [
    {
      "errorCode": "string",
      "errorParameters": [
        "string"
      ]
    }
  ],
  "isSuccess": true
}

Descrierea Proprietăților

• payload: Lista vehiculelor și detaliile acestora.
  • vehicleId: ID-ul unic al vehiculului.
  • vehicleUId: ID-ul unic universal al vehiculului.
  • vehicleName: Numele vehiculului.
  • vehicleRegistrationNumber: Numărul de înmatriculare al vehiculului.
  • latitude: Latitudinea locației vehiculului.
  • longitude: Longitudinea locației vehiculului.
  • gpsDate: Data și ora ultimei actualizări GPS.
  • address: Adresa locației vehiculului.
  • speed: Viteza vehiculului.
  • course: Direcția de deplasare a vehiculului.
  • engineEvent: Evenimentul motorului.
  • engineRpm: Turația motorului.
  • engineEventDate: Data și ora evenimentului motorului.
  • serverDate: Data și ora serverului la momentul răspunsului.
  • isPrivate: Indicator dacă vehiculul este în mod privat.
  • vehicleIdentificationNumber: Numărul de identificare al vehiculului (VIN).
  • externalPowerVoltage: Tensiunea de alimentare.
  • vehicleManufacturer: Producătorul vehiculului.
  • vehicleModel: Modelul vehiculului.
  • manufactureYear: Anul de fabricație al vehiculului.
• correlationId: ID-ul unic pentru corelarea cererii și răspunsului.
• failureReasons: Lista motivelor de eșec, dacă există.
  • errorCode: Codul de eroare.
  • errorParameters: Parametrii suplimentari pentru eroare.
• isSuccess: Indicator dacă cererea a fost procesată cu succes.

Traseu

Descriere Generală

Metoda Way returnează lista cu locațiile vehiculelor din perioada transmisă ca parametru. Aceasta returnează doar vehiculele la care utilizatorul are acces. Metoda acceptă ca parametri o listă de maxim 10 vehicleId și o perioadă de maxim 31 de zile.

Este supus restricțiilor din Rate Limit

⚠️ Toate cererile către acest endpoint trebuie să includă parametrul api-version=2.0 în URL.
URL: POST https://api.trackgps.ro/api/carriers/way?api-version=2.0

⚠️ Notă: Toate datele calendaristice transmise sau returnate de acest endpoint sunt în fusul orar local al companiei.

Parametri Request

{
  "vehiclesList": [
    0
  ],
  "startDate": "2024-09-09T09:21:50.133",
  "endDate": "2024-09-09T09:21:50.133"
}

• vehiclesList: Lista de vehicleId-uri pentru care se dorește obținerea locațiilor.
• startDate: Data și ora de început a perioadei pentru care se solicită locațiile.
• endDate: Data și ora de sfârșit a perioadei pentru care se solicită locațiile.

Structura Răspunsului

{
  "payload": [
    {
      "vehicleId": 0,
      "gpsDate": "2024-09-09T09:21:50.134~~~~",
      "latitude": 0,
      "longitude": 0,
      "speed": 0,
      "course": 0
    }
  ],
  "correlationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "failureReasons": [
    {
      "errorCode": "string",
      "errorParameters": [
        "string"
      ]
    }
  ],
  "isSuccess": true
}

Descrierea Proprietăților

• payload: Lista locațiilor vehiculelor.
  • vehicleId: ID-ul unic al vehiculului.
  • gpsDate: Data și ora ultimei actualizări GPS.
  • latitude: Latitudinea locației vehiculului.
  • longitude: Longitudinea locației vehiculului.
  • speed: Viteza vehiculului.
  • course: Direcția de deplasare a vehiculului.
• correlationId: ID-ul unic pentru corelarea cererii și răspunsului.
• failureReasons: Lista motivelor de eșec, dacă există.
  • errorCode: Codul de eroare.
  • errorParameters: Parametrii suplimentari pentru eroare.
• isSuccess: Indicator dacă cererea a fost procesată cu succes.

Staționări

Descriere Generală

Metoda Stops returnează o listă cu staționările vehiculelor în perioada pentru care se face apelul. Aceasta returnează doar datele pentru vehiculele la care utilizatorul are acces. În cazul în care lista conține cel puțin un vehicul la care utilizatorul nu are acces, se va returna un răspuns cu cod de eroare 401.

Este supus restricțiilor din Rate Limit

⚠️ Toate cererile către acest endpoint trebuie să includă parametrul api-version=2.0 în URL.
URL: POST https://api.trackgps.ro/api/carriers/stops?api-version=2.0

⚠️ Notă: Toate datele calendaristice transmise sau returnate de acest endpoint sunt în fusul orar local al companiei.

Parametri Request

{
  "vehiclesList": [
    0
  ],
  "startDate": "2024-09-09T09:49:19.549",
  "endDate": "2024-09-09T09:49:19.549",
  "stationaryMargin": 0
}

• vehiclesList: Lista de ID-uri ale vehiculelor pentru care se solicită staționările (maxim 10 vehicule).
• startDate: Data și ora de început a perioadei pentru care se solicită staționările.
• endDate: Data și ora de sfârșit a perioadei pentru care se solicită staționările.
• stationaryMargin: Timpul de staționare exprimat în minute (nu poate fi mai mic de 1 minut).

Structura Răspunsului

{
  "payload": [
    {
      "results": {
        "additionalProp1": [
          {
            "vehicleId": 0,
            "startDate": "2025-04-11T14:33:30.175",
            "endDate": "2025-04-11T14:33:30.175",
            "latitude": 0,
            "longitude": 0,
            "stationaryEngineOnTime": 0,
            "distance": 0,
            "maxSpeed": 0,
            "averageSpeed": 0,
            "speedCount": 0,
            "indexKm": 0,
            "indexHours": 0,
            "address": "string",
            "stopDuration": 0,
            "engineOnStops": [
              {
                "startDate": "2025-04-11T14:33:30.175",
                "endDate": "2025-04-11T14:33:30.175",
                "duration": 0
              }
            ],
            "hotSpot": "string",
            "functioningTime": 0,
            "isPrivate": true,
            "drivers": [
              {
                "firstName": "string",
                "lastName": "string"
              }
            ],
            "fuelConsumption": 0
          }
        ],
        "additionalProp2": [
          {
            "vehicleId": 0,
            "startDate": "2025-04-11T14:33:30.175",
            "endDate": "2025-04-11T14:33:30.175",
            "latitude": 0,
            "longitude": 0,
            "stationaryEngineOnTime": 0,
            "distance": 0,
            "maxSpeed": 0,
            "averageSpeed": 0,
            "speedCount": 0,
            "indexKm": 0,
            "indexHours": 0,
            "address": "string",
            "stopDuration": 0,
            "engineOnStops": [
              {
                "startDate": "2025-04-11T14:33:30.175",
                "endDate": "2025-04-11T14:33:30.175",
                "duration": 0
              }
            ],
            "hotSpot": "string",
            "functioningTime": 0,
            "isPrivate": true,
            "drivers": [
              {
                "firstName": "string",
                "lastName": "string"
              }
            ],
            "fuelConsumption": 0
          }
        ],
        "additionalProp3": [
          {
            "vehicleId": 0,
            "startDate": "2025-04-11T14:33:30.175",
            "endDate": "2025-04-11T14:33:30.175",
            "latitude": 0,
            "longitude": 0,
            "stationaryEngineOnTime": 0,
            "distance": 0,
            "maxSpeed": 0,
            "averageSpeed": 0,
            "speedCount": 0,
            "indexKm": 0,
            "indexHours": 0,
            "address": "string",
            "stopDuration": 0,
            "engineOnStops": [
              {
                "startDate": "2025-04-11T14:33:30.175",
                "endDate": "2025-04-11T14:33:30.175",
                "duration": 0
              }
            ],
            "hotSpot": "string",
            "functioningTime": 0,
            "isPrivate": true,
            "drivers": [
              {
                "firstName": "string",
                "lastName": "string"
              }
            ],
            "fuelConsumption": 0
          }
        ]
      }
    }
  ],
  "correlationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "failureReasons": [
    {
      "errorCode": "string",
      "errorParameters": [
        "string"
      ]
    }
  ],
  "isSuccess": true
}

Descrierea Proprietăților

• payload: Lista staționărilor vehiculelor.
  • results: Rezultatele staționărilor pentru fiecare vehicul.
    • vehicleId: ID-ul vehiculului.
    • startDate: Data și ora de început a staționării.
    • endDate: Data și ora de sfârșit a staționării.
    • latitude: Latitudinea locației staționării.
    • longitude: Longitudinea locației staționării.
    • stationaryEngineOnTime: Timpul de staționare cu motorul pornit.
    • distance: Distanța parcursă.
    • maxSpeed: Viteza maximă atinsă.
    • averageSpeed: Viteza medie.
    • speedCount: Numărul de măsurători de viteză.
    • indexKm: Indexul de kilometri.
    • indexHours: Indexul de ore.
    • address: Adresa locației staționării.
    • stopDuration: Durata staționării.
    • engineOnStops: Lista evenimentelor cu motorul pornit.
      • startDate: Data și ora de început a staționării cu motorul pornit.
      • endDate: Data și ora de sfârșit a staționării cu motorul pornit.
      • duration: Durata staționării cu motorul pornit.
    • hotSpot: Numele hotspotului daca stationarea s-a produs în unul din hotspoturile definite.
    • functioningTime: Timpul de funcționare.
    • isPrivate: Indicator dacă staționarea este privată.
    • drivers: Lista șoferilor.
      • firstName: Prenumele șoferului.
      • lastName: Numele de familie al șoferului.
    • fuelConsumption: Consumul de combustibil pe deplasarea anterioară şi staţionarea curentă (dacă s-a staţionat cu motorul pornit).
• correlationId: ID-ul unic pentru corelarea cererii și răspunsului.
• failureReasons: Lista motivelor de eșec, dacă există.
  • errorCode: Codul de eroare.
  • errorParameters: Parametrii suplimentari pentru eroare.
• isSuccess: Indicator dacă cererea a fost procesată cu succes.

Consum

Descriere Generală

Metoda Consumption returnează informații despre consumul, distanța, orele de funcționare, cât și consumul mediu la 100 km al unui vehicul în perioada pentru care se face apelul la metodă. Metoda poate fi apelată pentru o listă de maximum 10 vehicule și o perioadă de maximum 31 zile. Dacă vehiculul este echipat cu GPL, vor fi returnate date pentru ambele surse.

Este supus restricțiilor din Rate Limit

⚠️ Toate cererile către acest endpoint trebuie să includă parametrul api-version=2.0 în URL.
URL: POST https://api.trackgps.ro/api/carriers/consumption?api-version=2.0

⚠️ Notă: Toate datele calendaristice transmise sau returnate de acest endpoint sunt în fusul orar local al companiei.

Structura JSON a Cererii

{
  "vehiclesList": [
    0
  ],
  "startDate": "2024-09-09T07:15:14.124",
  "endDate": "2024-09-09T07:15:14.124"
}

Proprietăți ale Cererii

• vehiclesList: Listă de vehicule pentru care se face apelul (tip array de vehicleId).
• startDate: Data de început a perioadei pentru care se face apelul.
• endDate: Data de sfârșit a perioadei pentru care se face apelul.

Structura JSON a Răspunsului

{
  "payload": [
    {
      "vehicleName": "string",
      "licensePlate": "string",
      "distance": 0,
      "hours": "string",
      "consumptionValue": 0,
      "averageConsumption100Km": 0,
      "secondarySource": {
        "distance": 0,
        "hours": "string",
        "consumptionValue": 0,
        "averageConsumption100Km": 0
      }
    }
  ],
  "correlationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "failureReasons": [
    {
      "errorCode": "string",
      "errorParameters": [
        "string"
      ]
    }
  ],
  "isSuccess": true
}

Proprietăți ale Răspunsului

Proprietăți Primare

• vehicleName: Numele vehiculului (tip string).
• licensePlate: Numărul de înmatriculare (tip string).
• distance: Distanța parcursă în km (tip numeric).
• hours: Orele de funcționare în format timespan ore:minute:secunde (tip string).
• consumptionValue: Valoarea consumului în litri (tip numeric).
• averageConsumption100Km: Consum mediu la 100 km în l/100km (tip numeric).

Proprietăți Sursă Secundară

• secondarySource.distance: Distanța parcursă de sursa secundară în km (tip numeric).
• secondarySource.hours: Orele de funcționare ale sursei secundare în format timespan ore:minute:secunde (tip string).
• secondarySource.consumptionValue: Valoarea consumului pentru sursa secundară în litri (tip numeric).
• secondarySource.averageConsumption100Km: Consum mediu la 100 km pentru sursa secundară în l/100km (tip numeric).

Calcularea Totalurilor

În cazul în care sursa secundară conține date, pentru obținerea totalurilor trebuie însumate datele din sursa primară și sursa secundară. De exemplu:

{
  "payload": [
    {
      "vehicleName": "Vehicul A",
      "licensePlate": "AB-12-BCD",
      "distance": 100,
      "hours": "10:00:00",
      "consumptionValue": 50,
      "averageConsumption100Km": 5,
      "secondarySource": {
        "distance": 50,
        "hours": "5:00:00",
        "consumptionValue": 20,
        "averageConsumption100Km": 4
      }
    }
  ],
  "correlationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "isSuccess": true
}

Totaluri:

• distance: 100 + 50 = 150 km
• hours: 10:00:00 + 5:00:00 = 15:00:00
• consumptionValue: 50 + 20 = 70 litri
• averageConsumption100Km: (5 + 4) / 2 = 4.5 l/100km

Alimentări

Descriere Generală

Metoda Refills returnează o listă cu evenimentele de alimentare sau scădere a nivelului de carburant detectate în perioada pentru care se face apelul. Aceasta returnează doar datele pentru vehiculele la care utilizatorul are acces.
În cazul în care lista conține cel puțin un vehicul la care utilizatorul nu are acces, se va returna un răspuns cu cod de eroare 401.

Este supus restricțiilor din Rate Limit

⚠️ Toate cererile către acest endpoint trebuie să includă parametrul api-version=2.0 în URL.
URL: POST https://api.trackgps.ro/api/carriers/refills?api-version=2.0

⚠️ Notă: Toate datele calendaristice transmise sau returnate de acest endpoint sunt în fusul orar local al companiei.

Parametri Request

{
  "carrierId": 0,
  "startDate": "2024-09-09T09:42:51.835",
  "endDate": "2024-09-09T09:42:51.835"
}

• carrierId: ID-ul unic al vehiculului pentru care se dorește obținerea evenimentelor de alimentare sau scădere a nivelului de carburant.
• startDate: Data și ora de început a perioadei pentru care se solicită evenimentele.
• endDate: Data și ora de sfârșit a perioadei pentru care se solicită evenimentele.

Structura Răspunsului

{
  "payload": [
    {
      "date": "string",
      "event": "string",
      "location": "string",
      "estimation": 0,
      "isPrivate": true
    }
  ],
  "correlationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "failureReasons": [
    {
      "errorCode": "string",
      "errorParameters": [
        "string"
      ]
    }
  ],
  "isSuccess": true
}

Descrierea Proprietăților

• payload: Lista evenimentelor de alimentare sau scădere a nivelului de carburant.
  • date: Data și ora evenimentului.
  • event: Tipul evenimentului (alimentare sau scădere a nivelului de carburant).
  • location: Locația unde a avut loc evenimentul.
  • estimation: Estimarea cantității de carburant implicate în eveniment.
  • isPrivate: Indicator dacă evenimentul s-a efectuat în mod privat.
• correlationId: ID-ul unic pentru corelarea cererii și răspunsului.
• failureReasons: Lista motivelor de eșec, dacă există.
  • errorCode: Codul de eroare.
  • errorParameters: Parametrii suplimentari pentru eroare.
• isSuccess: Indicator dacă cererea a fost procesată cu succes.

Lista Posibile Evenimente

• FuelStart: Nivel început
• Fueling: Alimentare
• PossibleFuelTheft: Posibil furt de carburant
• TotalRefill: Total alimentări
• TotalPossibleTheft: Total posibile furturi de carburant
• RemainingFuel: Carburant rămas
• TotalFuelConsumption: Consum total de carburant
• FuelStartSecondarySource: Începutul alimentării din sursă secundară
• FuelingSecondarySource: Alimentare din sursă secundară
• PossibleFuelTheftSecondarySource: Posibil furt de carburant din sursă secundară
• TotalRefillSecondarySource: Total alimentări din sursă secundară
• TotalPossibleTheftSecondarySource: Total posibile furturi din sursă secundară
• RemainingFuelSecondarySource: Carburant rămas din sursă secundară
• TotalFuelConsumptionSecondarySource: Consum total de carburant din sursă secundară

Temperaturi

Descrierea Metodei Generale

Metoda Temperatures returnează o listă de temperaturi înregistrate pentru perioada pentru care se face apelul. Returnează date doar pentru vehiculele la care utilizatorul are acces. Dacă lista conține cel puțin un vehicul la care utilizatorul nu are acces, se va returna un răspuns cu codul de eroare 401.

Este supus restricțiilor din Rate Limit

⚠️ Toate cererile către acest endpoint trebuie să includă parametrul api-version=2.0 în URL.
URL: POST https://api.trackgps.ro/api/carriers/temperatures?api-version=2.0

⚠️ Notă: Toate datele calendaristice transmise sau returnate de acest endpoint sunt în fusul orar local al companiei.

Parametri Cererii

{
  "vehiclesList": [
    0
  ],
  "startDate": "2024-09-09T09:49:19.549",
  "endDate": "2024-09-09T09:49:19.549"
}

• vehiclesList: Lista vehiculelor pentru care se solicită datele de temperatură.
• startDate: Data de început a perioadei pentru care se solicită datele.
• endDate: Data de sfârșit a perioadei pentru care se solicită datele.

Structura Răspunsului

{
  "payload": [
    {
      "temperature": [
        {
          "vehicleId": 0,
          "date": "2025-04-11T12:33:11.817",
          "value": 0,
          "sensorNumber": 0
        }
      ],
      "humidity": [
        {
          "vehicleId": 0,
          "date": "2025-04-11T12:33:11.817",
          "value": 0,
          "sensorNumber": 0
        }
      ]
    }
  ],
  "correlationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "failureReasons": [
    {
      "errorCode": "string",
      "errorParameters": [
        "string"
      ]
    }
  ],
  "isSuccess": true
}

• payload: Conține rezultatele cu datele de temperatură.
• correlationId: Un identificator unic pentru corelarea cererii și răspunsului.
• failureReasons: Motivele pentru care cererea a eșuat, dacă există.
• isSuccess: Indică dacă cererea a fost de succes.

Adăugare transport

Descriere Generală

Endpoint-ul add-transport permite adăugarea unui transport nou în sistem. Utilizatorul poate specifica toate detaliile legate de transport, inclusiv vehiculul asociat, datele de început și sfârșit, locațiile și informațiile suplimentare precum trailerul asociat.

Este supus restricțiilor din Rate Limit

⚠️ Toate cererile către acest endpoint trebuie să includă parametrul api-version=2.0 în URL.
URL: POST https://api.trackgps.ro/api/eTransport/add-transport?api-version=2.0

Parametri Cerere

Cererile către acest endpoint trebuie să fie de tip POST și să includă următorii parametri:

• Parametru de query:

  • api-version (string, obligatoriu) – Versiunea API-ului. Valoare recomandată: 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"
}

🕒 Important: Toate câmpurile de tip dată (ex. startDate, endDate, validityStartDate, validityEndDate) trebuie trimise în format UTC.

Structura Răspunsului

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

Descrierea Proprietăților

Răspunsuri de Eroare

Modificare transport

Descriere Generală

Endpoint-ul update-transport permite modificarea unui transport deja existent în sistem. Poți actualiza detalii precum perioada de desfășurare, locațiile, observațiile sau informațiile despre remorci.

Este supus restricțiilor din Rate Limit

⚠️ Toate cererile către acest endpoint trebuie să includă parametrul api-version=2.0 în URL.
URL: POST https://api.trackgps.ro/api/eTransport/update-transport?api-version=2.0

Parametri Cerere

Cererile către acest endpoint trebuie să fie de tip POST și să includă următorii parametri:

• Parametru de query:

  • api-version (string, obligatoriu) – Versiunea API-ului. Valoare recomandată: 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"
}

🕒 Important: Câmpurile de tip dată (startDate, endDate, validityStartDate, validityEndDate) trebuie transmise în format UTC.

Structura Răspunsului

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

Descrierea Proprietăților

Răspunsuri de Eroare

Listă transporturi

Descriere Generală

Endpoint-ul load-transports este utilizat pentru a extrage lista transporturilor disponibile în contul unui utilizator, pe baza drepturilor de acces la vehicule. Utilizatorul poate specifica parametri pentru filtrarea transporturilor, precum statutul acestora sau o valoare de căutare specifică.

Este supus restricțiilor din Rate Limit

⚠️ Toate datele calendaristice ale transporturilor, afișate în răspuns, sunt înregistrate în fusul orar al companiei, nu în UTC. Asigurați-vă că transporturile sunt gestionate conform setărilor fusului orar al companiei atunci când sunt preluate din sistem.

⚠️ Toate cererile către acest endpoint trebuie să includă parametrul api-version=2.0 în URL.
URL: POST https://api.trackgps.ro/api/eTransport/load-transports?api-version=2.0

⚠️ Transporturile aflate în statusul “Eroare” afișate în aplicația mobilă și web nu sunt returnate de acest endpoint.

Parametrii Cerere

Cererile către acest endpoint trebuie să fie de tip POST și să includă următorii parametri:

• Parametru de query:

  • api-version (string, obligatoriu) – Versiunea API-ului. Valoare recomandată: 2.0

• Body (JSON):

{
  "pageSize": 0,
  "pageIndex": 0,
  "statusIds": [
    1
  ],
  "searchValue": "string"
}

Lista Statusurilor transportului

Structura Răspunsului

{
  "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
}

Descrierea Proprietăților

Lista statusurilor de transmisie a datelor GPS in platforma ANAF

Lista statusurilor pentru cererile de modificare a datelor transportului

Răspunsuri de Eroare

Ștergere transporturi

Descriere Generală

Endpoint-ul remove-transports permite ștergerea unuia sau mai multor transporturi din sistem, pe baza identificatorilor unici (transportUId). Această acțiune este ireversibilă și necesită drepturi de acces corespunzătoare asupra transporturilor vizate.

Este supus restricțiilor din Rate Limit

⚠️ Toate cererile către acest endpoint trebuie să includă parametrul api-version=2.0 în URL.
URL: POST https://api.trackgps.ro/api/eTransport/remove-transports?api-version=2.0

Parametri Cerere

Cererile către acest endpoint trebuie să fie de tip POST și să includă următorii parametri:

• Parametru de query:

  • api-version (string, obligatoriu) – Versiunea API-ului. Valoare recomandată: 2.0

• Body (JSON):

{
  "transportsUids": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  ]
}

Structura Răspunsului

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

Descrierea Proprietăților

Răspunsuri de Eroare

Start sesiune date

Descriere Generală

Endpoint-ul start-transports permite pornirea (activarea) unuia sau mai multor transporturi deja create. Această acțiune setează data de început a transportului și îl marchează ca fiind activ în sistem.

Este supus restricțiilor din Rate Limit

⚠️ Toate cererile către acest endpoint trebuie să includă parametrul api-version=2.0 în URL.
URL: POST https://api.trackgps.ro/api/eTransport/start-transports?api-version=2.0

Parametri Cerere

Cererile către acest endpoint trebuie să fie de tip POST și să includă următorii parametri:

• Parametru de query:

  • api-version (string, obligatoriu) – Versiunea API-ului. Valoare recomandată: 2.0

• Body (JSON):

{
  "transports": [
    {
      "codeUit": "string"
    }
  ]
}

🕒 Important: Toate datele (startDate) trebuie trimise în format UTC.

Structura Răspunsului

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

Descrierea Proprietăților

Răspunsuri de Eroare

Stop sesiune date

Descriere Generală

Endpoint-ul end-transports permite oprirea unuia sau mai multor transporturi active, pe baza codului UIT. Prin această acțiune, transporturile sunt marcate ca încheiate în sistem și nu mai pot fi modificate ulterior.

Este supus restricțiilor din Rate Limit

⚠️ Toate cererile către acest endpoint trebuie să includă parametrul api-version=2.0 în URL.
URL: POST https://api.trackgps.ro/api/eTransport/end-transports?api-version=2.0

Parametri Cerere

Cererile către acest endpoint trebuie să fie de tip POST și să includă următorii parametri:

• Parametru de query:

  • api-version (string, obligatoriu) – Versiunea API-ului. Valoare recomandată: 2.0

• Body (JSON):

{
  "transports": [
    {
      "codeUit": "string"
    }
  ]
}

🕒 Important: Toate datele (endDate) trebuie trimise în format UTC.

Structura Răspunsului

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

Descrierea Proprietăților

Răspunsuri de Eroare

Pauză sesiune date

Descriere Generală

Endpoint-ul pause-transports permite întreruperea transmiterii poziţiei unui transport activ, pe baza codului UIT. Similar cu start și stop, transporturile sunt întrerupte temporar.

Este supus restricțiilor din Rate Limit.

⚠️ Toate cererile către acest endpoint trebuie să includă parametrul api-version=2.0 în URL.
URL: POST https://api.trackgps.ro/api/eTransport/pause-transports?api-version=2.0

Parametrii Cerere

Cererile către acest endpoint trebuie să fie de tip POST și să includă următorii parametri:

• Parametru de query:

  • api-version (string, obligatoriu) – Versiunea API-ului. Valoare recomandată: 2.0

• Body (JSON):

{
  "transports": [
    {
      "codeUit": "string"
    }
  ]
}

Structura Răspunsului

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

Descrierea Proprietăților

Răspunsuri de Eroare