Fuvar hozzáadása

Általános leírás

Az add-transport végpont lehetővé teszi egy új fuvar hozzáadását a rendszerhez. A felhasználó megadhatja a fuvarhoz kapcsolódó összes részletet, beleértve a hozzárendelt járművet, a kezdő és záró dátumokat, a helyszíneket, valamint további információkat, például a kapcsolódó pótkocsit.

A végpont a Rate Limit korlátozásai alá tartozik.

⚠️ 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/add-transport?api-version=2.0

Kérés paraméterei

A végponthoz küldött kéréseknek POST típusúnak kell lenniük, és a következő paramétereket kell tartalmazniuk:

  • Query paraméter:

    • api-version (string, kötelező) – Az API verziója. Ajánlott érték: 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"
}
Paraméter Típus Kötelező Leírás
vehicleUId string Igen A fuvarhoz tartozó jármű egyedi azonosítója.
startDate string Nem Az adatok ANAF platformára történő továbbításának kezdő dátuma és ideje (ISO 8601, UTC formátum).
endDate string Nem Az adatok ANAF platformára történő továbbításának záró dátuma és ideje (ISO 8601, UTC formátum).
codeUit string Igen Az ANAF által generált UIT kód.
notes string Nem További megjegyzések a fuvarhoz.
startLocation string Nem A fuvar kezdő helyszíne.
endLocation string Nem A fuvar végső helyszíne.
vatNumber string Igen A fuvarozó adószáma (CIF).
validityStartDate string Igen Az UIT kód érvényességének kezdő dátuma. Ezt az ANAF platform generálja (ISO 8601, UTC formátum).
validityEndDate string Igen Az UIT kód érvényességének záró dátuma. Ezt az ANAF platform generálja (ISO 8601, UTC formátum).
trailer1Code string Nem Az első pótkocsi rendszáma.
trailer2Code string Nem A második pótkocsi rendszáma.

🕒 Fontos: Minden dátum típusú mezőt (pl. 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 sikeresen hozzá lett-e adva (true vagy false).
correlationId string A kérés azonosítója a válaszok összekapcsolásához.
failureReasons array Hibák listája (ha van), további részletekkel.
isSuccess boolean Jelzi, hogy a kérés sikeresen feldolgozásra került-e (true) vagy sem (false).

Hibaválaszok

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