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.