Fuvar módosítása

Általános leírás

Az update-transport végpont lehetővé teszi egy már meglévő fuvar módosítását a rendszerben. Frissítheted például az időszakot, helyszíneket, megjegyzéseket vagy a pótkocsik adatait.

A Rate Limit korlátozásai érvényesek.

⚠️ Minden kéréshez kötelező az api-version=2.0 paramétert megadni az URL-ben.
URL: POST https://api.trackgps.ro/api/eTransport/update-transport?api-version=2.0

Kérés paraméterei

A végponthoz POST típusú kérést kell küldeni az alábbi paraméterekkel:

  • Query paraméter:

    • api-version (string, kötelező) – Az API verziója. Ajánlott érték: 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"
}
Paraméter Típus Kötelező Leírás
transportUId string Igen A módosítandó fuvar azonosítója.
vehicleUId string Igen A fuvarhoz tartozó jármű azonosítója.
startDate string Nem Az adatszolgáltatás kezdő dátuma és ideje az ANAF platformon (ISO 8601, UTC formátum).
endDate string Nem Az adatszolgáltatás befejező dátuma és ideje az ANAF platformon (ISO 8601, UTC formátum).
validityStartDate string Igen A UIT kód érvényességének kezdete. Az ANAF platform generálja (ISO 8601, UTC formátum).
validityEndDate string Igen A UIT kód érvényességének vége. Az ANAF platform generálja (ISO 8601, UTC formátum).
notes string Nem További megjegyzések.
startLocation string Nem Indulási helyszín.
endLocation string Nem Érkezési helyszín.
vatNumber string Igen A fuvarozó adószáma (CIF).
trailer1Code string Nem Az első pótkocsi rendszáma.
trailer2Code string Nem A második pótkocsi rendszáma.

🕒 Fontos: A dátum típusú mezőket (startDate, endDate, validityStartDate, validityEndDate) UTC formátumban kell megadni.

Válasz szerkezete

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

Tulajdonságok leírása

Tulajdonság Típus Leírás
payload boolean Jelzi, hogy a fuvar módosítása sikeres volt-e.
correlationId string A kérés egyedi azonosítója (nyomon követéshez, hibakereséshez).
failureReasons array Hibák listája (ha van), kódokkal és paraméterekkel.
isSuccess boolean Jelzi, hogy a kérés hibamentesen feldolgozásra került-e (true/false).

Hibaválaszok

HTTP kód Leírás
400 Hiányzó paraméter vagy hibás szerkezet.
401 Hibás hitelesítő adatok vagy jogosulatlan felhasználó.
429 A felhasználó túllépte a lekérési limitet.