# Szállítási adatok

A `ShippingData` objektum a szállítási adatokat tartalmazza, átadása kötelező postázás vagy futárszolgálat igénybevétele esetén. Ugyanakkor a szállítási adatokhoz kapcsolódó kiegészítő elemek opcionálisak (pl. a cím megadása kötelező, viszont a cím 2. és 3. sorának megadása opcionális).

{% hint style="warning" %}
Személyes átvételnél és digitális kézbesítés esetén a szállítási adatok megadására nincs szükség. Ilyenkor jelezze a szállítás módját vagy a kézbesítés jellegét a `General` objektum `ShippingMethod` paraméterében.<br>

Az átadható értékek ilyen esetekben:

* 04 (termék személyes, bolti átvétel)
* 05 (termék digitális kézbesítése (szolgáltatások, szoftverek, ajándékkártyák, utalványok, stb.))
  {% endhint %}

#### **Kötelező paraméterek**

<table data-full-width="true"><thead><tr><th>Paraméter</th><th>Típus</th><th>Érték</th><th>Leírás</th></tr></thead><tbody><tr><td><code>FirstName</code></td><td><p>string</p><p>(45 karakter)</p></td><td>egyedi értékek</td><td>Keresztnév.</td></tr><tr><td><code>LastName</code></td><td><p>string</p><p>(45 karakter)</p></td><td>egyedi értékek</td><td>Vezetéknév.</td></tr><tr><td><code>Email</code></td><td><p>string</p><p>(254 karakter)</p></td><td><p>szabványos email formátum</p><p>(maximum 1 db)</p></td><td>Email cím.</td></tr><tr><td><code>Phone</code></td><td><p>string</p><p>(18 karakter)</p></td><td>számokek</td><td>Telefonszám.</td></tr><tr><td><code>City</code></td><td><p>string</p><p>(50 karakter)</p></td><td>egyedi értékek</td><td>Város.</td></tr><tr><td><code>Country</code></td><td><p>string</p><p>(50 karakter)</p></td><td>egyedi értékek</td><td>Ország vagy állam.</td></tr><tr><td><code>CountryCode2</code></td><td><p>string</p><p>(2 karakter)</p></td><td><p>Alpha-2 formátum</p><p>(ISO 3166-1 alapján)</p></td><td><p>Országkód.<br></p><p>(pl. Magyarország kódja “HU”)</p></td></tr><tr><td><code>Line1</code></td><td><p>string</p><p>(50 karakter)</p></td><td>egyedi értékek</td><td><p>A cím első sora.<br></p><p>(közterület neve, típusa, házszám, emelet, ajtó, helyrajzi szám, stb.)</p></td></tr><tr><td><code>PostalCode</code></td><td><p>string</p><p>(16 karakter)</p></td><td>egyedi értékek</td><td>Irányítószám.</td></tr></tbody></table>

#### **Opcionális paraméterek**

<table data-full-width="true"><thead><tr><th>Paraméter</th><th>Típus</th><th>Érték</th><th>Leírás</th></tr></thead><tbody><tr><td><code>PhoneCc</code></td><td><p>string</p><p>(3 karakter)</p></td><td><p>kizárólag számok</p><p>(ITU-E.164 alapján)</p></td><td>Országkód.</td></tr><tr><td><code>CountryCode1</code></td><td><p>string</p><p>(3 karakter)</p></td><td><p>numerikus formátum<br></p><p>(ISO 3166-1 alapján)</p></td><td><p>Országkód.<br></p><p>(pl. Magyarország kódja “348”)</p></td></tr><tr><td><code>CountryCode3</code></td><td><p>string</p><p>(6 karakter)</p></td><td><p>földrajzi kód<br></p><p>(ISO 3166-2 alapján)</p></td><td><p>Országkód.<br></p><p>(pl. Budapest kódja Magyaroszgágon “HU-BU”)</p></td></tr><tr><td><code>Line2</code></td><td><p>string</p><p>(50 karakter)</p></td><td>egyedi értékek</td><td>A cím második sora.</td></tr><tr><td><code>Line3</code></td><td><p>string</p><p>(50 karakter)</p></td><td>egyedi értékek</td><td>A cím harmadik sora.</td></tr></tbody></table>

#### **Mintakód**

{% code overflow="wrap" %}

```php
{
    "Info": 
    {
        "Order":
        { 
            "ShippingData":
            {
                "FirstName":"",
                "LastName":"",
                "Email":"",
                "PhoneCc":"",
                "Phone":"",
                "City":"",
                "Country":"",
                "CountryCode1":"",
                "CountryCode2":"",
                "CountryCode3":"",
                "Line1":"",
                "Line2":"",
                "Line3":"",
                "PostalCode":""
            },
            ...
        }
    }
}
```

{% endcode %}