2015.02.17 T.K A ReasonCodeType bővült a TCI_VALUE_MISSING elemmel. 2015.03.17 T.K A ReasonCodeType bővült a TC_MOD_REASON_MISSING elemmel. 2015.03.18 - TCDEV-182 new ReasonCodeType: TC_SELLER_DELIVERY_NOT_ALLOWED_WITH_TRADETYPE, TC_SELLER_VATNUMBER_MUST_BE_CUSTOMERS, TCI_RISKY_TRADECARD_ITEM_ONLY_ALLOWED_WITH_SELLER_DELIVERY, TC_SELLER_DELIVERY_MOD_NOT_ALLOWED - isDestinationCompanyIdentical flag. Import esetén kockázatos terméknél használható 2015.03.23 - TCDEV-209 new ReasonCodeType: TC_UNLOAD_LOCATION_COMPANY_INFO_MISSING - TCDEV-208 new ReasonCodeType: TC_DESTINATION_VATNUMBER_MUST_BE_CUSTOMERS 2015.03.25 - TCDEV-220 new ReasonCodeType: TC_IS_DESTINATION_COMPANY_IDENTICAL_MISSING - TCDEV-220 new ReasonCodeType: TC_IS_DESTINATION_COMPANY_REQUIRED - TCDEV-220 new ReasonCodeType: TC_NOT_ALLOWED_DATA_MODIFICATION 2015.03.26 - TCDEV-182 TC_SELLER_DELIVERY_NOT_ALLOWED_WITH_TRADETYPE -> TC_ONLY_SELLER_DELIVERY_ALLOWED_WITH_TRADETYPE 2015.04.17 -TCDEV-296 BasicInfoElementsGroup bővült az insUser és a modUser elemmel. 2015.05.06 -TCDEV-335 új complexType-ok: DeliveryPlanType és DeliveryPlanListType - A TradeCardType bővült a deliveryPlans elemmel. - A TradeCardType items eleme opcionális lett. 2015.05.14 - TCDEV-352 new ReasonCodeType: INVALID_TRANSACTION_STATE - TCDEV-362 new ReasonCodeType: TC_DELIVERY_PLAN_MISSING 2015.05.18 - TCDEV-352 new ReasonCodeType: TCI_STATUS_MOD_REASON_MISSING - TCDEV-352 new ReasonCodeType: TCI_PRODUCT_MOD_REASON_MISSING 2015.06.04 -TCDEV-394 A TradeCardItemGroup value eleme a korábbi maximum 9-ről 11 számjegyre növekedett. 2015.06.08 - TCDEV-393 new ReasonCodeType: TC_UNKNOWN_LICENCE_PLATE_COUNTRY_CODE - TCDEV-396 new ReasonCodeType: NO_VALID_MASTER_USER 2015.06.16 - TCDEV-412 új complexType: ItemOperationType - A TradeCardItemType bővült az itemOperation elemmel. 2015.06.18 - TCDEV-413 new ReasonCodeType: TCI_ITEM_OPERATION_MISSING 2015.07.03 - TCDEV-433 new ReasonCodeType: TCI_PRODUCT_MOD_NOT_ALLOWED - TCDEV-433 new ReasonCodeType: TCI_CREATE_NOT_ALLOWED - TCDEV-433 new ReasonCodeType: TCI_DELETE_NOT_ALLOWED 2015.07.06 - TCDEV-448 new ReasonCodeType: LOW_BALANCE 2015.07.03 - TCDEV-526 Az unloadReporter elementhez tartozó dokumentáció korrigálva lett. 2016.01.04 - TCDEV-542 new ReasonCodeType: TC_INACTIVE_CPA_FOUND 2016.03.30 - TCDEV-619 Új complexType-ok: NAVValidationType, NAVValidationListType, NAVValidationCodeType A TradeCardOperationType bővült a NAVValidations elemmel. 2016.05.11 - TCDEV-641 new ReasonCodeType: TC_SELLER_VAT_NUMBER_CDV_ERROR - TCDEV-641 new ReasonCodeType: TC_DESTINATION_VAT_NUMBER_CDV_ERROR 2016.05.25 - TCDEV-712 new ReasonCodeType: TC_LOAD_AND_UNLOAD_LOCATION_ERROR, TC_UNLOAD_LOCATION_ERROR, TC_LOAD_AND_UNLOAD_LOCATION_ERROR 2016.05.30 - TCDEV-657 new NAVValidationCodeType: TC_WRONG_ZIP_CITY_WARN - TCDEV-703 new ReasonCodeType: TC_REQUEST_VERSION_ERROR 2016.05.31 - TCDEV-641 new ReasonCodeType: TC_FOREIGN_VAT_NUMBER_COUNTRY_CODE_MISMATCH 2016.06.27 - TCDEV-753 A ReasonCodeType simpleType az importban használt common.xsd-be lett átemelve. 2016.07.12 - TCDEV-872 Új simpleType: ManagementVersionType, a requestVersion kötelező lett, default 1.0 érték megszűnt, a típusa ManagementVersionType lett 2016.07.28 - TCDEV-966 A BasicTradeCardDetailsGroup bővült az isPrivateDelivery elemmel. 2016.12.08 - TCDEV-1291 new NAVValidationCodeType: TC_INACTIVE_CPA_FOUND 2017.02.28 - TCDEV-1562 add to QueryParamsType sellerVatNumber and destinationVatNumber 2019.03.07 - TCDEV-3696 TradeCardOperationResultType bővült - warning opcionális mező (v 1.10) 2019.03.19 - TCDEV-3773 loadDate és arrivalDate szigorítás - TCDEV-3773 2.0 verzió felvétele 2020.12.01 - TCDEV-6769 2.1 verzió felvétele - TCDEV-6769 TradeCardItemGroup bővült vatRateAssuranceExemption elemmel. 1.0 1.1 1.2 1.3 1.4 1.5 1.6 1.7 1.8 1.9 1.10 2.0 2.1 OK Warning Error Rakodási hely üzemeltetőjének neve. opcionális, csak magyar cím esetén kötelező Rakodási hely üzemeltetőjének adószáma. Opcionális, csak magyar cím esetén kötelező opcionális, csak magyar cím esetén kötelező opcionális, csak magyar cím esetén kötelező Közterület neve. Közterület jellege, opcionális Házszám Helyrajzi szám, ha nem létezik házszám GPS pozíció. WGS84! A kérés/válasz azonosítója, minden üzenetnél más A kérés/válasz keletkezésének ideje A kérés/válasz verziószáma, a request struktúra verziója A header verziószáma! Felhasznólnév Jelszó. SHA-512 hash-e a jelszónak! UPPER CASE! Az EKAER-ben regisztrált adóalany akinek a bejelentéseinek kezelése a cél! A requestId + timestamp yyyyMMddHHmmss + user titkos aláíró kulcsa összefűzésének az SHA-512 hash értéke. UPPER CASE! Authentikációs adatok. Ugyan azok az azonosító adatok kellenek, amiket a WEB-es felületen is használni kell! Figyelem! A bejelentésében irreálisan alacsony értéket jelölt meg! Figyelem! A bejelentésben irreálisan magas értéket jelölt meg! Figyelem! A bejelentésben irreálisan magas össztömeget jelentett be! Figyelem! A bejelentésben túl alacsony össztömeget jelentett be! Figyelem! A bejelentésben nem megfelelő zip és város pár található! Figyelem! Érvénytelen vtsz szám miatti hiba! Sikeresség: OK, hiba ERROR, vagy WARNING Végrehajtási eredmény kódja! A végrehajtással kapcsolatos szöveges leírás ha szükséges. Általában akkor van töltve ha a funcCode nem SUCCESS Szállítmányhoz tartozó EKAER szám. Új bejelentésnél NEM kell megadni! Bejelentés módosításnál kötelező. Megrendelés szám. A bejelentő saját rendszerében, a bejelentéssel kapcsolatos rendelés/fuvar azonosítója! Fuvar jellege, E: Beflöldről közösségbe, I: Közösségből belföldre, D:Belfold - belföld. A fuvar jellegét/irányát mutatja Eladó végzi-e a szállítást. Címzetti bejelentés rögzítése esetén false (tehát nem az eladó végzi)! Szállítmányozó módosíthatja a bejelentő lapon a jármű adatokat? Szállítmányozó azonosítója EKAER-ben. Ha ismert a szállító azonosítója az EKAER-ben akkor az itt adható meg! Akkor tudja a szállító módosítani a bejelentést, ha ez az adat meg van adva és a modByCarrierEnabled = true Szállítmányozó szöveges megjelölése Intermodális szállítmány esetén ezt igen-re kell állítani. Ha ez az érték igaz, akkor mind a fel mind a lerakodási cím Magyarországon kell hogy legyen. Bármely típusú fuvar esetén megadható! Default false-ként van kezelve! címzett (vevő) megegyezik-e a kirakodás címzettjével? amennyiben a címzettől eltérő cég szerepel a kirakodás címnél, értéke 'false' csak import relációban, kockázatos termék esetén szükséges megadni. A feladó/eladó neve A feladó/eladó adószáma A feladó/eladó országának kódja A feladó/eladó Címe, egybe írva. Az átvevő/vevő, címzett neve Az átvevő/vevő, címzett adószáma A átvevő/vevő országának kódja A átvevő/vevő Címe, egybe írva. Lerakodás bejelentést szabályozó Flag. A címzett által történő lejelentés megszűnése miatt, a megadott értéktől függetlenül, minden esetben S értéket kap! Felrakodás helye A kedvenc címekhez automatikusan mentődik a beküldött cím, ha még nem létezik! Első lerakodási/raktározási hely A kedvenc címekhez automatikusan mentődik a beküldött cím, ha még nem létezik! Ha módosítják a járművet, akkor a módosítás okát meg kell adni, ha a bejelentés Aktív státuszba van! Vonó jármű Vontatmány ha van Felrakodás, indulás időpontja! Felrakodás, indulás dátuma! Lerakodás, érkezés időpontja! Lerakodás, érkezés dátuma! Bejelentés típusa (N)ormál vagy (S)imple. 1.7 verziótól! Státusz váltás oka, csak lekérdezésben / csomag átadásban van használva! Csak akkor kell megadni, ha export esetén külföldi magánszemély részére történik az értékesítés, illetve import esetén, ha a beszerzést külföldi magánszemélytől eszközlik. Belföldi bejelentés esetén nincs figyelembe véve. Felrakodás helye Első lerakodási/raktározási hely címzett (vevő) megegyezik-e a kirakodás címzettjével? amennyiben a címzettől eltérő cég szerepel a kirakodás címnél, értéke 'false' csak import relációban, kockázatos termék esetén szükséges megadni. A kedvenc címekhez automatikusan mentődik a beküldött cím, ha még nem létezik! A kedvenc címekhez automatikusan mentődik a beküldött cím, ha még nem létezik! Menetlevélen belüli tetszőleges azonosító! Ez alapján lehet a kérésben küldött menetleveleket összehozni a válaszban érkező menetlevelekkel! Tétel beszerzési oka: S: Értékesítés A: Beszerzés W: Bérmunka O: Egyéb Termék VTSZ száma! Termék user által megadható neve. pl.: Málnás joghurt :) VTSZ csoport neve! Csak 1.10 verziótól van használva! BVeszélyességi BÁRCA szám. Veszélyes áru esetén kitöltendő. Veszélyes áru esetén a fuvar engedély azonosítója, amit kiadtak a szállításhoz Súly, tömeg Kg-ban. HUF-ban az érték Érték módosítás oka szövegesen. Csak akkor kell, ha az értéket módosítja a hívó! Súly módosítás oka szövegesen. Csak akkor kell, ha a súlyt módosítja a hívó! A termék gyári száma Bejelentő által használt cikkszám, amin kezeli, raktárnyilvántartja. Lejárati dátum, szavatossági idő SARZS szám (batch number), amit a gyártó ad! Ami alapján azonosítani lehet a gyártási paramétereket, gyártó sort. Státusz váltás oka szövegesen. Termék módosítás oka szövegesen. A termék biztosíték mentes áfakulcs alá tartozik? Tétel bejelentésen belüli tetszőleges azonosítója! Ez alapján lehet a kérésben küldött tételeket összehozni a válaszban érkező tételekkel! 1.6 requestVersion es nagyobbtól Művelet típusa: create: Új tétel létrehozása, modify: Meglévő módosítása, delete: Meglévő tétel törlése! Létrehozó user! EKAER felhasználó user azonosító. Módosítást végző user! EKAER felhasználó user azonosító. Csak módosítási kérés esetén kell tölteni, ha az adott elem már létezik és módosítani akarja a hívó. Ha az operation módosítás de a tétel új akkor nem kell megadni, kitölteni! Egyszerű bejelentés esetén nem lesz tétel a bejelentéshez! Bejelentés tételek Csak módosítási kérés esetén kell tölteni, ha az adott elem már létezik és módosítani akarja a hívó. A kiszabott pótlék összege A kiszabott pótlék esedékessége Adószám, a bejelentéskor, server állítja be! Adóazonosító jel! Bejelentés rögzítésnél Bejelentési lap státusza Teljes tömeg KG-ban. Out paraméter Teljes érték HUF-ban. Out paraméter Teljes zárolási érték HUF-ban, ami az adott bejelentőhöz köthető Véglegesítés időpontja. Csak ha véglegesítve van a bejelentő. Rekord beszúrásának időpontja! Az EKAER szám érvényességének kezdete! Az EKAER szám érvényességének vége Létrehozó user! EKAER felhasználó user azonosító. Módosítást végző user! EKAER felhasználó user azonosító. Bejelentéshez tartozó TCN szám! Új bejegyzés létrehozása! Meglévő bejelentés módosítása! tradeCard/tcn megadása kötelező! Delete operation esetén a tcn element-et kell csak a listán megadni. A bejelentés végleges állapotba hozatala. Ettől a ponttól a bejelentésben közölt adatok véglegesek, többet nem lehet rajtuk módosítani. A bejelentés utólagos módosítása. Módosítható adatok: felségjel, rendszám, termékek értéke, termékek súlya Új tétel létrehozása! Meglévő tétel módosítása! Meglévő tétel törlése! A tradeCard operation sorszáma a request-en belül. Ezzel azonosítható a tétel egy adott requestben! A válaszban is megtalálható, az egyértelmű request elem és válasz elem összeköttetésének. Művelet típusa Az operation alapján feldolgozandó bejelentés objektum Ha delete az operation akkor csak ide kell megadni az EKAER számot, nem kell az objektumot feltölteni! Lerakodás, érkezés időpontja! Lerakodás, érkezés dátuma! Ha delete az operation és S a státusz, akkor kötelező, legalább 1 karakter hosszú érték! A tradeCardoperation sorszáma a request-en belül. Ezzel azonosítható a tétel egy adott requestben! A válaszban is megtalálható, az egyértelmű request elem és válasz elem összeköttetésének. A kérésben küldött művelet operation-je!, aminek az eredményét tartalmazza az elemenet A server oldalon aktuális adatok a bejelentésről. Ha create volt az operation és nem sikerült a végrehajtás akkor ez az elem nem fog létezni a váalszban! POST /manageTradeCards operation! Request element structure /manageTradeCards response structure Rögzítés időpontja, intervallum alja, keződ időpont Rögzítés időpontja, intervallum felső határa Megrendelés szám. A bejelentő saját rendszerében, a bejelentéssel kapcsolatos rendelés/fuvar azonosítója! Ha meg van adva akkor csak az adott irányultság lesz lekérdezve! Ha nincs megadva akkor minden irányultságot vissz ada a rendszer! Bejelentés státusza Rendszám Feladó adószáma. Címzett adószáma. A maximálisan lekérdezhető rekordok száma! A hívó megadhatja mennyi rekordot szeretne maximum lekérdezni, ez a szám 1000-ben van maximalizálva. Opcionális, ha nincs megadva a szerver 1000-el fog dolgozni! Ha konkrét EKAER számra történik a lekérdezés akkor csak azt kell megadni Ha bejelentés listára szűrünk akkor ebben kell megadni a szűrési feltételeket!