e-Transport

În acest moment, API-ul pus la dispoziție de AROBS TrackGPS permite folosirea a 7 endpoint-uri pentru a putea face management la transporturile din contul companiei:

Metodă URL Descriere
POST https://api.trackgps.ro/api/eTransport/add-transport?api-version=2.0 Adăugare transport
POST https://api.trackgps.ro/api/eTransport/update-transport?api-version=2.0 Actualizare transport
POST https://api.trackgps.ro/api/eTransport/load-transports?api-version=2.0 Listare transporturi
POST https://api.trackgps.ro/api/eTransport/remove-transports?api-version=2.0 Ștergere transporturi
POST https://api.trackgps.ro/api/eTransport/start-transports?api-version=2.0 Pornire transporturi
POST https://api.trackgps.ro/api/eTransport/end-transports?api-version=2.0 Finalizare transporturi
POST https://api.trackgps.ro/api/eTransport/pause-transports?api-version=2.0 Pauză transporturi

Intervalul de timp dintre 2 request-uri succesive poate fi de minim 30 de secunde.

Subsecțiuni ale e-Transport

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"
}
Parametru Tip Obligatoriu Descriere
vehicleUId string Da Identificatorul unic al vehiculului asociat transportului.
startDate string Nu Data și ora de început a transmisiei datelor gps în platforma ANAF (format ISO 8601, UTC).
endDate string Nu Data și ora de sfârșit a transmisiei datelor gps în platforma ANAF (format ISO 8601, UTC).
codeUit string Da Codul UIT generat de ANAF.
notes string Nu Observații suplimentare despre transport.
startLocation string Nu Locația de început a transportului.
endLocation string Nu Locația de final a transportului.
vatNumber string Da Codul fiscal al transportatorului (CIF).
validityStartDate string Da Data de început a validității codului UIT. Această dată este generată de platforma ANAF (format ISO 8601, UTC).
validityEndDate string Da Data de sfârșit a validității codului UIT. Această dată este generată de platforma ANAF (format ISO 8601, UTC).
trailer1Code string Nu Numărul de înmatriculare pentru prima remorcă.
trailer2Code string Nu Numărul de înmatriculare pentru a doua remorcă.

🕒 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

Proprietate Tip Descriere
payload boolean Indică dacă transportul a fost adăugat cu succes (true sau false).
correlationId string Identificatorul cererii pentru corelarea răspunsurilor.
failureReasons array Lista motivelor de eroare (dacă există), cu detalii suplimentare.
isSuccess boolean Indică dacă cererea a fost procesată cu succes (true) sau nu (false).

Răspunsuri de Eroare

Cod HTTP Descriere
400 Parametri lipsă sau structură invalidă.
401 Credențiale incorecte sau utilizator neautorizat.
429 Limită de rată depășită pentru utilizator.

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"
}
Parametru Tip Obligatoriu Descriere
transportUId string Da Identificatorul transportului ce urmează să fie actualizat.
vehicleUId string Da Identificatorul vehiculului asociat transportului.
startDate string Nu Data și ora de început a transmisiei datelor gps în platforma ANAF (format ISO 8601, UTC).
endDate string Nu Data și ora de sfârșit a transmisiei datelor gps în platforma ANAF (format ISO 8601, UTC).
validityStartDate string Da Data de început a validității codului UIT. Această dată este generată de platforma ANAF (format ISO 8601, UTC).
validityEndDate string Da Data de sfârșit a validității codului UIT. Această dată este generată de platforma ANAF (format ISO 8601, UTC).
notes string Nu Observații adiționale.
startLocation string Nu Locația de început.
endLocation string Nu Locația de sfârșit.
vatNumber string Da Codul fiscal al transportatorului (CIF).
trailer1Code string Nu Numărul de înmatriculare pentru prima remorcă.
trailer2Code string Nu Numărul de înmatriculare pentru a doua remorcă.

🕒 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

Proprietate Tip Descriere
payload boolean Indică dacă actualizarea transportului a fost efectuată cu succes.
correlationId string Identificatorul unic al cererii (pentru trasabilitate și debugging).
failureReasons array Lista motivelor de eroare (dacă există), cu coduri și parametri.
isSuccess boolean Indică dacă cererea a fost procesată fără erori (true sau false).

Răspunsuri de Eroare

Cod HTTP Descriere
400 Parametri lipsă sau structură invalidă.
401 Credențiale incorecte sau utilizator neautorizat.
429 Limită de rată depășită pentru utilizator.

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"
}
Parametru Tip Obligatoriu Descriere
pageSize number Nu Numărul de elemente pe care le returnează pagina.
pageIndex number Nu Indexul paginii pentru cererea efectuată.
statusIds array Da Lista de ID-uri ale statusurilor transporturilor căutate.
searchValue string Nu Cuvântul sau fraza pentru căutare în lista transporturilor.

Lista Statusurilor transportului

Id Descriere
1 În așteptare
2 În desfășurare
3 Finalizat
4 Finalizat automat
5 Eroare
6 Pauză

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

Proprietate Tip Descriere
payload object Obiect care conține transporturile returnate și alte informații relevante.
totalRecords number Numărul total de transporturi disponibile.
transports array Lista transporturilor disponibile, fiecare cu detaliile specifice.
uId string Identificatorul unic al transportului.
carrierCode string Numărul de înmatriculare al vehiculului folosit pentru transmiterea datelor de localizare către ANAF.
carrierName string Numele vehiculului folosit pentru transmiterea datelor de localizare către ANAF.
carrierUId string Identificatorul unic al vehiculului.
trailer1Code string Numărul de înmatriculare pentru prima remorcă.
trailer2Code string Numărul de înmatriculare pentru a doua remorcă.
codeUit string Codul UIT generat de ANAF.
statusId number Statusul transportului.
startDate string Data și ora de inceput a transmisiei datelor gps în platforma ANAF.
endDate string Data și ora de sfârșit a transmisiei datelor gps în platforma ANAF.
validityStartDate string Data de început a validității codului UIT. Această dată este generată de platforma ANAF.
validityEndDate string Data de sfârșit a validității codului UIT. Această dată este generată de platforma ANAF.
notes string Observații suplimentare despre transport.
startLocation string Locația de început a transportului.
endLocation string Locația de sfărșit a transportului.
externalId number Identificatorul răspunsului transportului din platforma ANAF.
externalResponse string Mesajul de răspuns al transportului din platforma ANAF.
lastSyncDate string Data preluării transportului din platforma ANAF.
transmissionStatusCode string Status transmisie date GPS către platforma ANAF.
transmissionStatusErrorDescription string Descriere status eroare al transmisiei datelor GPS către platforma ANAF.
lastTransmissionDate string Data ultimei coordonate GPS transmise către platforma ANAF.
lastGpsDate string Data ultimei coordonate GPS recepționată de la vehicul.
changeRequestMessage string Mesajul de răspuns pentru crearea cererii de modificare a datelor transportului.
changeRequestStatusCode string Statusul cererii de modificare a datelor transportului.
changeRequestCreatedAt string Data creării cererii de modificare date ale transportului.
changeRequestDate string Data recepționării răspunsului din platforma ANAF pentru cererea de modificare date transport.
changeRequestAnafStatus string Statusul cerererii de modificare date transport primit de la plaforma ANAF.
changeRequestAnafMessage string Mesajul de răspuns pentru procesarea cererii de modificare date transport primit de la platforma ANAF.
changeRequestAnafDate string Data recepționării răspunsului din platforma ANAF pentru procesarea cererii de modificare date transport.
correlationId string Identificatorul cererii pentru corelarea răspunsurilor.
failureReasons array Lista motivelor de eroare (dacă există), cu detalii suplimentare.
isSuccess boolean Indică dacă cererea a fost procesată cu succes (true) sau nu (false).

Lista statusurilor de transmisie a datelor GPS in platforma ANAF

Cod Descriere
Active Transmisie activă
Finalized Transmisie finalizată
NotInRomania Nu este pe teritoriul României
NotStarted Transmisie în aşteptare
Error Eroare transmisie date
MissingETransportConfiguration Eroare configurare e-Transport, vă rugăm apelați echipa de suport
OldData Date mai vechi de 6 ore
NoGPSCoordinates Fără semnal GPS
WithoutTransmission Fără transmisie GPS activă

Lista statusurilor pentru cererile de modificare a datelor transportului

Cod Descriere
RequestCreated Cerere creata
RequestSent Cerere trimisa cu succes
RequestErrorSent Eroare la trimiterea cererii
ResponseSuccess Cerere finalizata cu succes
ResponseError Cerere finalizata cu eroare

Răspunsuri de Eroare

Cod HTTP Descriere
400 Parametri lipsă sau structură invalidă.
401 Credențiale incorecte sau utilizator neautorizat.
429 Limită de rată depășită pentru utilizator.

Ș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"
  ]
}
Parametru Tip Obligatoriu Descriere
transportsUids array Da Lista de identificatori unici (GUID) ai transporturilor ce urmează a fi șterse.

Structura Răspunsului

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

Descrierea Proprietăților

Proprietate Tip Descriere
payload boolean Rezultatul operației de ștergere (true dacă a reușit).
correlationId string Identificator unic al cererii, util pentru trasabilitate.
failureReasons array Lista cu erori apărute (dacă există), fiecare cu cod și parametri.
isSuccess boolean Indică dacă cererea a fost procesată cu succes (true sau false).

Răspunsuri de Eroare

Cod HTTP Descriere
400 Parametri lipsă, invalidi sau format incorect.
401 Utilizator neautentificat sau fără permisiuni.
429 A fost depășit rate limit-ul pentru utilizator.

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"
    }
  ]
}
Parametru Tip Obligatoriu Descriere
transports array Da Lista transporturilor ce urmează să fie pornite.
codeUit string Da Codul unic de identificare UIT al transportului.

🕒 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

Proprietate Tip Descriere
payload boolean Rezultatul operației de pornire (true dacă a reușit).
correlationId string Identificator unic al cererii, util pentru trasabilitate.
failureReasons array Lista cu erori apărute (dacă există), fiecare cu cod și parametri.
isSuccess boolean Indică dacă cererea a fost procesată cu succes (true sau false).

Răspunsuri de Eroare

Cod HTTP Descriere
400 Parametri lipsă, invalidi sau format incorect.
401 Utilizator neautentificat sau fără permisiuni.
429 A fost depășit rate limit-ul pentru utilizator.

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"
    }
  ]
}
Parametru Tip Obligatoriu Descriere
transports array Da Lista transporturilor ce urmează să fie oprite.
codeUit string Da Codul unic de identificare UIT al transportului.

🕒 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

Proprietate Tip Descriere
payload boolean Rezultatul operației de oprire (true dacă a reușit).
correlationId string Identificator unic al cererii, util pentru trasabilitate.
failureReasons array Lista cu erori apărute (dacă există), fiecare cu cod și parametri.
isSuccess boolean Indică dacă cererea a fost procesată cu succes (true sau false).

Răspunsuri de Eroare

Cod HTTP Descriere
400 Parametrii lipsă, invalizi sau format incorect.
401 Utilizator neautentificat sau fără permisiuni.
429 A fost depășit rate limit-ul pentru utilizator.

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"
    }
  ]
}
Parametru Tip Obligatoriu Descriere
transports array Da Lista transporturilor ce urmează să fie puse pe pauză.
codeUit string Da Codul unic de identificare UIT al transportului.

Structura Răspunsului

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

Descrierea Proprietăților

Proprietate Tip Descriere
payload boolean Rezultatul operației de pauză (true dacă a reușit).
correlationId string Identificator unic al cererii, util pentru trasabilitate.
failureReasons array Lista cu erori apărute (dacă există), fiecare cu cod și parametrii.
isSuccess boolean Indică dacă cererea a fost procesată cu succes (true sau false).

Răspunsuri de Eroare

Cod HTTP Descriere
400 Parametri lipsă, invalizi sau format incorect.
401 Utilizator neautentificat sau fără permisiuni.
429 A fost depășit rate limit-ul pentru utilizator.