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.