eVIR tudásbázis

Ez az oldal csak olvasható. Megtekintheted a forrását, de nem változtathatod meg. Ha úgy gondolod, hogy ez helytelen, kérdezd az Adminisztrátorokat!
====== Szállítmánykezelés ======
[[https://devportal.posta.hu/api/7#/Shipment/post_shipments]]\\
[[https://devportal.posta.hu/sites/default/files/2021-10/MPLAPI_technikai_leiras_v23.pdf]]\\
[[https://devportal.posta.hu/dokumentacio]]\\


===== Folyamata =====

==== Napi folyamat ====
{{ :spec:mplapi.png?direct&600 |}}


=== Csomagfeladás folyamata ===

Függetlenül attól, hogy belföldi és/vagy nemzetközi csomagokat adnak fel, a csomagok adatainak 
beküldése végén ún. zárást kell végrehajtani. Enélkül a csomagok nem adhatók fel. A csomagadatok 
beküldhetők egyesével szekvenciálisan, egy kérésben több csomag egyszerre, illetve nagyobb 
mennyiség esetén párhuzamosan is. Ez utóbbi esetben 5 szálnál többet ne használjanak a beküldés 
során. 

=== eVIRben történő folyamat form-ról ===

  * Szállítámy létrehozása
    * Sikeres küldés esetén:
      * Warningok kiírása a képernyőre
      * Küldeményazonosító(TrackingNumber) lementése.
      * TrackingNumberrel rendelkező, nem lezárt csomagok módosítása
        * Apin keresztül kitöröljük a régit, és újként felvesszük.
  * Véglegesítés
    * Összes függőben lévő szállítmány lezárása
    * Felvétel után közvetlenül lezárjuk
      * Ekkor a címiratot visszaadjuk
  
===== Kérések =====


==== Csomagadatok beküldése (belföld) ====

=== Címzett adatai===

  * Címzett neve (kötelező)
  * Irányítószám (kötelező)
  * Település (kötelező)
  * Címe (Kötelező, egy mezőbe irandó):
    * Közterület neve 
    * Közterület jellege
    * Házszám
  * Ügyféladat 1 (opcionális): szabadon megadható információ
  * Ügyféladat 2 (opcionális): szabadon megadható információ
  * Kézbesítés módja (kötelező választani) alapértelmezetten: Házhoz kézbesítés.
    

  * Amennyiben a választás: **Házhoz kézbesítés**
    * Megjegyzés (opcionális)
    * Email cím (opcionális): a címzett e-mailben történő értesítéséhez nélkülözhetetlen
    * Telefonszám (opcionális) : a címzett SMS-ben történő értesítéséhez nélkülözhetetlen
  
  * Amennyiben a választás: **PostaPonti kézbesítés**
      * Postapont neve (kötelező)
      * Megjegyzés (opcionális)
      * Email cím (kötelező) e-mail cím és címzett telefonszám közül az egyik kitöltése kötelező. A címzett e-mailben történő értesítéséhez nélkülözhetetlen.
      * Telefonszám (opcionális) e-mail cím és címzett telefonszám közül az egyik kitöltése kötelező. A címzett SMS-ben történő értesítéséhez nélkülözhetetlen.

  *  Amennyiben a választás: ** Postán maradó**
      * Postapont neve (kötelező):
      * Megjegyzés (opcionális)
      * Email cím (kötelező) e-mail cím és címzett telefonszám közül az egyik kitöltése kötelező. A címzett e-mailben történő értesítéséhez nélkülözhetetlen.
      * Telefonszám (opcionális) e-mail cím és címzett telefonszám közül az egyik kitöltése kötelező. A címzett SMS-ben történő értesítéséhez nélkülözhetetlen.

  * Amennyiben a választás: **Csomagautomata**
    * Csomagautomata (kötelező)
    * Megjegyzés (opcionális)
    * Email cím (kötelező): A címzett e-mail-ben történő értesítéséhez nélkülözhetetlen.
    * Telefonszám (kötelező): A címzett SMS-ben történő értesítéséhez nélkülözhetetlen.


=== Küldemény adatok ===

  * Tömeg (kötelező): a kézbesítendő csomag tömegét kell megadni grammban. (Ha a megadott érték meghaladja a kézbesítés mód és a megállapodás által meghatározott maximum értéket, nem engedjük elküldeni.)
  * Méret (opcionális, Csomagautomata kézbesítési mód esetén kötelező): S Kicsi (31x7x25 cm) , M Közepes (50x16x31 cm) , L Nagy (50x35x31 cm)
  * Értéknyilvánítás (opcionális):  kitöltése az értéknyilvánítás többletszolgáltatás igénybevételét jelenti.
  * Árufizetés (opcionális): kitöltése az árufizetés (utánvétel) többletszolgáltatás igénybevételét jelenti
  * (Szállítási díj hozzáadása: a jelölő négyzettel határozható meg, hogy az árufizetés (utánvétel) összege tartalmazza-e a szállítási díjat. )
    * //Megj: ilyet nem találtam az apiban//
  * Őrzési idő: „**Házhoz kézbesítés**” kézbesítési mód esetén 0-5-10 érték választható, alapértelmezetten 10 nap. Sikertelen kézbesítést követően ennyi ideig vehető át a csomag a postán. „**Postán maradó**”, „**PostaPonti kézbesítés**” és „**Csomagautomata**” kézbesítési mód esetén 5-10 nap választható, alapértelmezetten 10 nap.
  * Fix kézbesítés dátuma (opcionális): a többletszolgáltatással a feladó meghatározhatja azt a fix napot, melyen a küldemény első kézbesítését megkísérli a Posta. A meghatározott nap legkorábban a feladást követő második, míg a legkésőbbi a tizedik munkanap lehet. 
  * Időablak (opcionális): értéke „Házhoz kézbesítés” kézbesítési mód esetén választható, választása az időablak többletszolgáltatás igénybevételét jelenti.
  * Többletszolgáltatások (Csomagtípusonként váltózó mi vehető igénybe, lásd lentebb):
    *  Garantált 1 munkanap / 1 munkanapos átfutási idő
    *  Tértivevény: bármilyen csomagra igényelhető.
    * Saját kezébe: bármilyen csomagra igényelhető. Kizárja az alkalmi átvevő többletszolgáltatást.
    * Terjedelmes: Amennyiben a küldemény valamelyik mérete meghaladja a 100 cm-t vagy az összméret (hosszúság + szélesség + magasság) meghaladja a 180 cm-t, automatikusan kiválasztásra kerül a terjedelmes többletszolgáltatás.
    * Időablak: kizárja a szombati kézbesítés többletszolgáltatást. Használata együtt jár az 1 munkanapos időgarancia igénybevételével.
    *  Alkalmi átvevő: kizárja a saját kezébe többletszolgáltatást.
    *  Szombati kézbesítés: kizárja az időablakos és a fix napi kézbesítést.
    *  Törékeny kezelés: bármilyen csomagra igényelhető.
    *  Címzett fizet
    *  Mérgek, halotti hamvak: különleges tartalom, halotti hamvak és mérgező anyagok szállítása, ÁSZF-ben meghatározott esetekben.


=== MPL Posta Csomag ===

  * Tömeghatár: 20 Kg
  * Mérethatár:
    * legkisebb: 120x175 mm
    * legnagyobb: 
        * hosszúság 2 400 mm
        * összmérete: 3 000 mm
  * Jellemző átfutási idő (munkanap): 2
  * Időgarancia (munkanap): nincs
  * Választható többletszolgáltatások:
    * Értéknyilvánítás
    * Terjedelmes
    * Tértivevény
    * Törékeny

=== MPL Üzleti Csomag ===

  * Tömeghatár: 
      * max 40 kg
      * Postán maradóként: max 30 kg
      * Csomagautomatára és PostaPontra címezve: max 20 kg
  * Mérethatár:
    * legkisebb: 120x175 mm
    * legnagyobb: 
        * hosszúság 2 400 mm
        * összmérete: 3 000 mm
  * Jellemző átfutási idő (munkanap): 1
  * Időgarancia (munkanap): 1 (többletszolgáltatásként igénybe vehető)
  * Választható többletszolgáltatások:
    * Összes kivéve: Kézbesítési igazolás
  




----

==== Csomagok lekérése ====
Visszaadja, hogy az adott ügyfél milyen csomagjairól mit tud opcionálisan csak a megadott időpontok között és megadott darabszámig.

Az ''MPL függőben lévő szállítmányok listájánál'' használjuk, paraméterezés nélkül. Ekkor az összes függőben lévő szállítmányt visszakapjuk. A lezártakat nem lehet lekérni újból, csak a címiratát.

=== Paraméterek ===


  * fromDate
  * Mettől szűrjön a lekérdezés. / Filter the query from.
    * string
    * (query)
 
  * toDate
  * Meddig szűrjön a lekérdezés. / Filter the query to.
    * string
    * (query)

  * trackingNumbers
  * A kiválasztott postai azonosítók (ragszámok) / Selected postal IDs
    * array[string]
    * (query)

  * tag
  * Küldemény cimkéje / Mail item label
    * string
    * (query)
	


----

==== Csomag törlése ====

Ragszám szerinti tétel törlése

Egyelőre csomagot csak módosításkor törlünk, külön nem. 


=== Paraméterek ===
TrackingNumber


----

==== Csomag Véglegesítése (lezárás) ====
/shipments/close
Csomag feladásának lezárása, szállítólevél igénylése. 

A ''MPL függőben lévő szállítmányok listája'' listában lévő ''Összes véglegesítése'' linkkel az összes függőben lévő csomagot véglegesíteni tudjuk. Ha a lista egy elemére kattintunk, bejön a felvétel Form, ahol módosítani tudjuk a szállítmányt. 

=== Paraméterek ===

  * fromDate
  * toDate
  * [trackingNumbers]
  * checkList
  * checkListWithPrice
  * tag