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.