Order API

Rendelésekkel kapcsolatos API funkciók

Rendelések lekérdezése
Szűrési feltétel
Leírás
page
A lekérdezendő oldal sorszáma.
(Alapértelmezett: 0.)
limit
Az egy oldalon szereplő találatok száma.
(Alapértelmezett: 100, maximum: 1000.)
wspyId
Belső azonosító.
A rendelés létrehozásakor az API visszaadja válaszban.
referenceId
Külső azonosító.
A rendelés létrehozásakor megadott azonosító.
referenceName
A rendelés neve.
A rendelés létrehozásakor megadott név.
paymentStatus
A fizetési státusz, lehetséges értékek:
paid, 
pending, 
stb.
paymentGateway
A fizetés módja, lehetséges értékek:
cod, 
card, 
stb.
lastMod
Az utolsó módosítás dátuma.
A megadott dátum után létrehozott vagy módosított rendeléseket listázza ki, akár egyszerre többet is.
A táblázatban megadott szűrési feltételek ÉS kapcsolatban állnak egymással, csak azokat a szűrőket kell megadni, amelyekre szűrni szeretnénk.
XML esetén:
Url: https://app.webshippy.com/wspyapi/GetOrder/xml
Kérés:
<?xml version="1.0" encoding="utf-8"?>
<request>  
  <apiKey>api-key-comes-here</apiKey>  
  <page>0</page>  
  <limit>10</limit>  
  <filters>    
    <wspyId></wspyId>    
    <referenceId></referenceId>    
    <referenceName></referenceName>    
    <paymentStatus></paymentStatus>    
    <paymentGateway></paymentGateway>    
    <lastMod>2018-01-01 00:00:00</lastMod>  
  </filters>
</request>
Válasz (példa):
<?xml version="1.0" encoding="utf-8"?>
<response>  
  <status>success</status>  
  <message/>  
  <result>    
    <elem>      
      <wspyId>176</wspyId>      
      <status>fulfilled</status>      
      <referenceId>87962-110037</referenceId>      
      <referenceName>87962-110037</referenceName>      
      <createdAt>2018-02-14 13:04:33</createdAt>      
      <fulfilledAt>2018-02-20 16:27:17</fulfilledAt>      
      <paymentGateway>cod</paymentGateway>      
      <paymentStatus>pending</paymentStatus>      
      <paymentTotalPrice>8940.00</paymentTotalPrice>      
      <paymentTotalDiscounts>1000.00</paymentTotalDiscounts>      
      <paymentCurrency>HUF</paymentCurrency>      
      <shippingMode>GLS-HU</shippingMode>   
      <packPoint>GLS</packPoint>
      <packPointId>123</packPointId>
      <shippingPrice>1290.00</shippingPrice>      
      <shippingVat>0.27</shippingVat>      
      <paidAt/>      
      <codAmount>1500.00</codAmount>      
      <codCurrency>HUF</codCurrency>      
      <codStatus/>      
      <codReceivedAt/>      
      <trackingCode>WSHPY176</trackingCode>      
      <invoiceStatus/>      
      <invoiceCreatedAt>2018-02-16 00:00:00</invoiceCreatedAt>      
      <invoiceNo>inv#00001</invoiceNo>      
      <refusedInvoiceNo/>      
      <invoiceUrl/>      
      <refusedDate/>      
      <updatedAt>2018-02-26 12:18:17</updatedAt>      
      <products>        
        <elem>          
          <sku>szuperhos-polo-piros-xl</sku>          
          <productName>Szuperhős Póló</productName>          
          <variantName>Piros, XL</variantName>          
          <priceGross>1890.00</priceGross>          
          <vat>0.27</vat>          
          <quantity>3</quantity>        
        </elem>        
        <elem>          
          <sku>cicanaci-one-size</sku>          
          <productName>CicaNaci - One Size</productName>          
          <variantName/>          
          <priceGross>990.00</priceGross>          
          <vat>0.27</vat>          
          <quantity>1</quantity>        
        </elem>        
        <elem>          
          <sku>akcios-sapka</sku>          
          <productName>Akciós sapka</productName>          
          <variantName>Fekete</variantName>          
          <priceGross>1990.00</priceGross>          
          <vat>0.27</vat>          
          <quantity>1</quantity>        
        </elem>      
      </products>    
    </elem>    
    <elem>      
      [ ... ]    
    </elem>    
      [ ... ]  
  </result>
</response>
Hibás kérés esetén (példa):
<?xml version="1.0" encoding="utf-8"?>
<response>  
  <status>error</status>  
  <message>    
    <elem>[field: lastMod]The field must be a valid datetime (eg. yyyy-mm-dd hh:ii:ss)</elem>  
  </message>
</response>
JSON esetén:
Url: https://app.webshippy.com/wspyapi/GetOrder/json
Kérés:
{
  "apiKey": "api-key-comes-here",
  "page": "0",
  "limit": "10",
  "filters": {
    "wspyId": "",
    "referenceId": "",
    "referenceName": "",
    "paymentStatus": "",
    "paymentGateway": "",
    "lastMod": "2018-01-01 00:00:00"
  }
}
Válasz (példa):
{
   "status": "success",
   "message": [],
   "result": [
     {
       "wspyId": 176,
       "status": "fulfilled",
       "referenceId": "87962-110037",
       "referenceName": "87962-110037",
       "createdAt": "2018-02-14 13:04:33",
       "fulfilledAt": "2018-02-20 16:27:17",
       "paymentGateway": "cod",
       "paymentStatus": "pending",
       "paymentTotalPrice": 8940,
       "paymentTotalDiscounts": 1000,
       "paymentCurrency": "HUF",
       "shippingMode": "GLS-HU",
       "packPoint": "GLS",
       "packPointId": "123",
       "shippingPrice": 1290,
       "shippingVat": 0.27,
       "paidAt": "",
       "codAmount": 1500,
       "codCurrency": "HUF",
       "codStatus": "",
       "codReceivedAt": "",
       "trackingCode": "WSHPY176",
       "invoiceStatus": "",
       "invoiceCreatedAt": "2018-02-16 00:00:00",
       "invoiceNo": "inv#00001",
       "refusedInvoiceNo": "",
       "invoiceUrl": "",
       "refusedDate": "",
       "updatedAt": "2018-02-26 12:18:17",
       "products": [
         {
           "sku": "szuperhos-polo-piros-xl",
           "productName": "Szuperhős Póló",
           "variantName": "Piros, XL",
           "priceGross": 1890,
           "vat": 0.27,
           "quantity": 3
         },
         {
           "sku": "cicanaci-one-size",
           "productName": "CicaNaci - One Size",
           "variantName": "",
           "priceGross": 990,
           "vat": 0.27,
           "quantity": 1
         },
         {
           "sku": "akcios-sapka",
           "productName": "Akciós sapka",
           "variantName": "Fekete",
           "priceGross": 1990,
           "vat": 0.27,
           "quantity": 1
         }
       ]
     }
   ]
 }
Hibás kérés esetén (példa):
{  
  "status": "error",
  "message": [
     "[field: lastMod]The field must be a valid datetime (eg. yyyy-mm-dd hh:ii:ss)"  
  ]
}
Mező
Leírás
status
A művelet eredménye, lehetséges értékek: 
success: sikeres,
error: hiba.
message
Hibás kérés esetén ebbe a mezőbe kerülnek a hibaüzenetek.
result
Sikeres kérés esetén ebbe a mezőbe kerül a lekérdezés eredménye, minden esetben tömbként kerül a válaszba.
wspyId
Belső azonosító.
A rendelés létrehozásakor az API visszaadja válaszban.
status
A rendelés státusza, lehetséges értékek:
new: új,
draft: piszkozat,
ready: kész,
packing: csomagolás alatt,
fulfilled: teljesített,
refused: visszautasított.
referenceId
Külső azonosító.
A rendelés létrehozásakor megadott azonosító.
referenceName
A rendelés neve.
A rendelés létrehozásakor megadott név.
createdAt
A rendelés létrehozásának (eredeti) ideje.
fulfilledAt
A rendelés csomagolt állapotba kerülésének ideje.
paymentStatus
A fizetési státusz, lehetséges értékek:
paid, 
pending, 
stb.
paidAt
Amennyiben paid (fizetve), a kifizetés ideje.
codAmount
Az utánvét összege.
codCurrency
Az utánvét pénzneme.
codStatus
Az utánvét státusza.
codReceivedAt
Az utánvét beérkezésének ideje.
trackingCode
A futárszolgálat nyomon követő kódja. Több csomagos megrendelés esetén a főcsomag kódja. 
invoiceUrl
Számla link a letöltéshez.
​https://example.com/invoice.pdf​
invoiceStatus
A számlázási állapot, lehetséges értékek:
uninvoiced: nincs számlázva,
invoiced: számlázva,
storno: sztornózva.
invoiceCreatedAt
A számla létrehozásának ideje.
invoiceNo
A számla azonosítója.
refusedInvoiceNo
A sztornó számla azonosítója.
refusedDate
A csomag visszaérkezésének ideje, és a sztornó számla kelte.
updatedAt
A rendszerünkben történt utolsó módosítás dátuma.
products
A rendelés termékei, minden esetben tömb.
sku
A termék SKU-ja (cikkszáma).
productName
A termék neve.
variantName
A termékvariáns neve.
priceGross
A termék bruttó ára.
vat
Az ÁFA kulcs.
quantity
A rendelt mennyiség.
serial
A termékhez csomagoláskor rögzített egyedi azonosító.
(Opcionális.)
Rendelések létrehozása, módosítása
Ezzel a funkcióval egyszerre lehet létrehozni és módosítani rendeléseket. Amennyiben a megadott referenceId-val még nem szerepel nálunk rendelés, akkor az API létrehozza. Amennyiben már szerepel, és a létező rendelés státusza új vagy piszkozat, valamint még nem történt rajta manuális módosítás, akkor módosítja azt. Sikeres létrehozás, vagy módosítás esetén az API visszaadja a rendelés belső azonosítóját.
Mező
Kötelező?
Leírás
apiKey
Igen
Az API kulcs.
order
Igen
A létrehozandó vagy módosítandó rendelés adatai.
referenceId
Igen
Külső azonosító. 
Szabadszavas, ajánlott a megrendelés azonosítójának használata.
referenceName
Nem
A rendelés neve.
A rendelés létrehozásakor megadott név.
Szabadszavas, ajánlott a megrendelés azonosítójának használata, vagy egy abból képzett név.
(pl.:RENDELES#1221)
createdAt
Igen
A rendelés létrejöttének ideje.
shipping
Igen
A szállítási adatai.
shipping.name
Igen
A címzett neve.
shipping.company
Nem
Cég esetén, a cégnév.
shipping.email
Nem
E-mail cím.
shipping.phone
Nem
Telefonszám.
shipping.countryCode
Igen
Kétjegyű országkód. 
(pl.: HU)
shipping.stateOrProvinceCode
Nem
Állam, tartomány.
(Főleg külföldi címzés esetén fontos.)
shipping.zip
Igen
Irányítószám.
shipping.city
Igen
Város.
shipping.address1
Igen
A cím első sora.
shipping.address2
Nem
A cím második sora.
shipping.note
Nem
A címhez tartozó megjegyzés, <![CDATA[]]>.
(Használata ajánlott.)
shipping.mode
Nem
A szállítási mód, lehetséges értékek:
GLS-HU,
FOXPOST-HU,
PRIO, 
DHL,
SPRINTER,
GLS-SK,
MPL.
shipping.packPoint
Nem
A csomagpont fajtája, lehetséges értékek: 
GLS,
FOXPOST-HU,
CSOMAGKULDO,
MPL.
shipping.packPointId
Nem
A csomagpont azonosító Id-je.
billing
Nem*
A számlázás adatok.
(Kiszervezett számlázás esetén kötelező.)
billing.name
Igen
A számlázási név.
billing.company
Nem
Cég esetén, a cégnév.
billing.phone
Nem
Telefonszám.
billing.taxNumber
Nem
Adószám.
billing.countryCode
Igen
Kétjegyű országkód. 
(pl.: HU)
billing.zip
Igen
Irányítószám.
billing.city
Igen
Város.
billing.address1
Igen
A cím első sora.
billing.address2
Nem
A cím második sora.
payment
Igen
A fizetéssel kapcsolatos információk.
payment.paymentMode
Igen
A fizetési mód, szabadszavas, intelligens felismerést használ, azonban az ajánlott értékek:
 cod, 
card, 
paypal, 
stb.
payment.codAmount
Nem
Az utánvét összege. 
A végösszegtől eltérhet, ez az érték kerül a futárhoz utánvét összegeként.
payment.paymentStatus
Igen
A fizetés státusza, lehetséges értékek: 
paid, 
pending. 
Egyéb esetben egyeztetés szükséges.
payment.paidDate
Nem*
A fizetés ideje. 
paid (fizetve) státusz esetén kötelező. 
payment.shippingPrice
Nem
A szállítási költség összege.
(Bruttó összeg, ami a vevői számlán szerepelni fog.)
payment.shippingVat
Nem
A szállítási költség ÁFA kulcsa.
payment.currency
Igen
A rendelés pénzneme, 3 karakteres (ISO) azonosító.
(pl.: HUF)
payment.discount
Nem
Kedvezmény a megrendelés végösszegéből.
products
Nem
A rendelés termékei.
products.sku
Igen
A termék SKU-ja (cikkszáma).
products.productName
Igen
A termék neve.
products.variantName
Nem
A termékvariáns neve.
products.priceGross
Igen
A termék bruttó egységára.
products.vat
Igen
A termék ÁFA kulcsa.
products.quantity
Igen
A termékből rendelt mennyiség.
invoiceUrl
Nem
Számla link a letöltéshez.
​https://example.com/invoice.pdf​
Csak akkor van jelentősége, ha van Manuális PDF számlafeltöltő beállítva az API kapcsolathoz, mert ebben az esetben használja fel a rendszer.
attachmentUrl
Nem
Csatolmány link a letöltéshez.
​https://example.com/attachment.pdf​
Egy rendeléshez 1 pdf melléklet csatolható és minden esetben nyomtatásra kerül.
(pl. A használati útmutató a termékhez.)
pdfSource
Nem
Pdf formátumú számla fájl base64 kódolással.
Csak akkor van jelentősége, ha van Manuális PDF számlafeltöltő beállítva az API kapcsolathoz, mert ebben az esetben használja fel a rendszer.
XML esetén:
Url: https://app.webshippy.com/wspyapi/CreateOrder/xml
Kérés:
<?xml version="1.0" encoding="utf-8"?>
<request>  
  <apiKey>api-key-comes-here</apiKey>  
  <order>    
    <referenceId>87962-110037</referenceId>    
    <referenceName>87962-110037</referenceName>    
    <createdAt>2018-02-14 13:04:33</createdAt>    
    <shipping>      
      <name>Kováts Béla</name>      
      <company>Virág Bt.</company>      
      <email>[email protected]</email>      
      <phone>+36301234567</phone>      
      <countryCode>HU</countryCode>      
      <stateOrProvinceCode></stateOrProvinceCode>      
      <zip>1234</zip>      
      <city>Budapest</city>      
      <address1>Virág utca 25.</address1>      
      <address2></address2>      
      <note>
        <![CDATA[Szállításkor kérem a futárt, hogy ne csengessen!!!]]>
      </note>      
      <mode>GLS-HU</mode>    
    </shipping>    
    <billing>      
      <name>Kováts Béla</name>      
      <company>Virág Bt.</company>      
      <phone>+36301234567</phone>      
      <countryCode>HU</countryCode>      
      <zip>1234</zip>      
      <city>Budapest</city>      
      <address1>Virág utca 25.</address1>      
      <address2></address2>    
    </billing>    
    <payment>      
      <paymentMode>COD</paymentMode>      
      <codAmount>1500.00</codAmount>      
      <paymentStatus>pending</paymentStatus>      
      <paidDate></paidDate>      
      <shippingPrice>1290.00</shippingPrice>      
      <shippingVat>0.27</shippingVat>      
      <currency>HUF</currency>      
      <discount>1000.00</discount>    
    </payment>    
    <products>      
      <elem>        
        <sku>szuperhos-polo-piros-xl</sku>        
        <productName>Szuperhős Póló</productName>        
        <variantName>Piros, XL</variantName>        
        <priceGross>1890.00</priceGross>        
        <vat>0.27</vat>        
        <quantity>3</quantity>      
      </elem>      
      <elem>        
        <sku>cicanaci-one-size</sku>        
        <productName>CicaNaci - One Size</productName>       
        <priceGross>990.00</priceGross>        
        <vat>0.27</vat>        
        <quantity>1</quantity>      
      </elem>      
      <elem>        
        <sku>akcios-sapka</sku>        
        <productName>Akciós sapka</productName>        
        <variantName>Fekete</variantName>        
        <priceGross>1990.00</priceGross>        
        <vat>0.27</vat>        
        <quantity>1</quantity>      
      </elem>    
    </products>  
  </order>
</request>
Válasz (példa):
<?xml version="1.0" encoding="utf-8"?>
<response>  
  <status>success</status>  
  <message>    
    <elem>The order creation was successful</elem>  
  </message>  
  <wspyId>176</wspyId>
</response>
JSON esetén
Url: https://app.webshippy.com/wspyapi/CreateOrder/json
Kérés:
{  
"apiKey": "api-key-comes-here",
  "order": {    
    "referenceId": "87962-110037",    
    "referenceName": "87962-110037",    
    "createdAt": "2018-02-14 13:04:33",    
    "shipping": {
      "name": "Kov\u00e1ts B\u00e9la",      
      "company": "Vir\u00e1g Bt.",      
      "email": "[email protected]",      
      "phone": "+36301234567",      
      "countryCode": "HU",      
      "stateOrProvinceCode": "",      
      "zip": "1234",      
      "city": "Budapest",      
      "address1": "Vir\u00e1g utca 25.",      
      "address2": "",      
      "note": "",      
      "mode": "GLS-HU"    
    },    
    "billing": {      
      "name": "Kov\u00e1ts B\u00e9la",      
      "company": "Vir\u00e1g Bt.",      
      "phone": "+36301234567",      
      "countryCode": "HU",      
      "zip": "1234",      
      "city": "Budapest",      
      "address1": "Vir\u00e1g utca 25.",      
      "address2": ""    
    },    
    "payment": {      
      "paymentMode": "COD",      
      "codAmount": "1500.00",      
      "paymentStatus": "pending",      
      "paidDate": "",      
      "shippingPrice": "1290.00",      
      "shippingVat": "0.27",      
      "currency": "HUF",      
      "discount": "1000.00"    
    },    
    "products": [      
      {        
        "sku": "szuperhos-polo-piros-xl",        
        "productName": "Szuperh\u0151s P\u00f3l\u00f3",        
        "variantName": "Piros, XL",        
        "priceGross": "1890.00",        
        "vat": "0.27",        
        "quantity": "3"      
      },      
      {        
        "sku": "cicanaci-one-size",        
        "productName": "CicaNaci - One Size",        
        "priceGross": "990.00",        
        "vat": "0.27",        
        "quantity": "1"      
      },      
      {        
        "sku": "akcios-sapka",        
        "productName": "Akci\u00f3s sapka",        
        "variantName": "Fekete",        
        "priceGross": "1990.00",        
        "vat": "0.27",        
        "quantity": "1"      
      }    
    ]  
  }
}
Válasz (példa):
{
  "status": "success",
  "message": [
    "The order creation was successful"
  ],
  "wspyId": 176
}
További válaszlehetőségek:
The order creation was successful
The order modification was successful
Rendelés törlése
XMLesetén:
Url: https://app.webshippy.com/wspyapi/deleteOrder/xml
Kérés:
<?xml version="1.0" encoding="utf-8"?>
<request> 
  <apiKey>api-key-comes-here</apiKey> 
  <filters>    
    <wspyId>917872738</wspyId>  
  </filters>
</request>
Válasz:
<?xml version="1.0" encoding="utf-8"?>
<response>
  <status>error</status>
  <message>
    <elem>Error: Order is already modified!</elem>
  </message>
  <wspyId>12345678</wspyId>
  <referenceId/>
  <referenceName>WSP#12345678</referenceName>
</response>
JSON esetén:
Url: https://app.webshippy.com/wspyapi/deleteOrder/json
Kérés:
{  
"apiKey": "api-key-comes-here",  
  "filters": {    
    "wspyId": "917872738"  
  }
}
Válasz (példa):
{
    "status": "error",
    "message":  [
        {
          "Error": "Order is already modified!"
        }
    ]
}
Szűrési feltétel
Leírás
wspyId
Belső azonosító.
A rendelés létrehozásakor az API visszaadja válaszban.
referenceId
Külső azonosító. 
A rendelés létrehozásakor megadott azonosító.
referenceName
A rendelés neve. 
A rendelés létrehozásakor megadott név.
Egyszerre csak egy rendelés törölhető! Olyan rendelést, amit a Webshippy rendszer felületén a felhasználó manuálisan módosított, API hívással nem lehet törölni. 
Csak "new" vagy "draft" státusszal rendelkező megrendelések törölhetőek.

Bevezetés

Next - WEBSHIPPY API SEGÉDLET

Product API

Last modified 6mo ago

Szűrési feltétel	Leírás
`page`	A lekérdezendő oldal sorszáma. (Alapértelmezett: 0.)
`limit`	Az egy oldalon szereplő találatok száma. (Alapértelmezett: 100, maximum: 1000.)
`wspyId`	Belső azonosító. A rendelés létrehozásakor az API visszaadja válaszban.
`referenceId`	Külső azonosító. A rendelés létrehozásakor megadott azonosító.
`referenceName`	A rendelés neve. A rendelés létrehozásakor megadott név.
`paymentStatus`	A fizetési státusz, lehetséges értékek: `paid`, `pending`, stb.
`paymentGateway`	A fizetés módja, lehetséges értékek: `cod`, `card`, stb.
`lastMod`	Az utolsó módosítás dátuma. A megadott dátum után létrehozott vagy módosított rendeléseket listázza ki, akár egyszerre többet is.

Mező	Leírás
`status`	A művelet eredménye, lehetséges értékek: `success`: sikeres, `error`: hiba.
`message`	Hibás kérés esetén ebbe a mezőbe kerülnek a hibaüzenetek.
`result`	Sikeres kérés esetén ebbe a mezőbe kerül a lekérdezés eredménye, minden esetben tömbként kerül a válaszba.
`wspyId`	Belső azonosító. A rendelés létrehozásakor az API visszaadja válaszban.
`status`	A rendelés státusza, lehetséges értékek: `new`: új, `draft`: piszkozat, `ready`: kész, `packing`: csomagolás alatt, `fulfilled`: teljesített, `refused`: visszautasított.
`referenceId`	Külső azonosító. A rendelés létrehozásakor megadott azonosító.
`referenceName`	A rendelés neve. A rendelés létrehozásakor megadott név.
`createdAt`	A rendelés létrehozásának (eredeti) ideje.
`fulfilledAt`	A rendelés csomagolt állapotba kerülésének ideje.
`paymentStatus`	A fizetési státusz, lehetséges értékek: `paid`, `pending`, stb.
`paidAt`	Amennyiben `paid` (fizetve), a kifizetés ideje.
`codAmount`	Az utánvét összege.
`codCurrency`	Az utánvét pénzneme.
`codStatus`	Az utánvét státusza.
`codReceivedAt`	Az utánvét beérkezésének ideje.
`trackingCode`	A futárszolgálat nyomon követő kódja. Több csomagos megrendelés esetén a főcsomag kódja.
`invoiceUrl`	Számla link a letöltéshez. https://example.com/invoice.pdf
`invoiceStatus`	A számlázási állapot, lehetséges értékek: `uninvoiced`: nincs számlázva, `invoiced`: számlázva, `storno`: sztornózva.
`invoiceCreatedAt`	A számla létrehozásának ideje.
`invoiceNo`	A számla azonosítója.
`refusedInvoiceNo`	A sztornó számla azonosítója.
`refusedDate`	A csomag visszaérkezésének ideje, és a sztornó számla kelte.
`updatedAt`	A rendszerünkben történt utolsó módosítás dátuma.
`products`	A rendelés termékei, minden esetben tömb.
`sku`	A termék SKU-ja (cikkszáma).
`productName`	A termék neve.
`variantName`	A termékvariáns neve.
`priceGross`	A termék bruttó ára.
`vat`	Az ÁFA kulcs.
`quantity`	A rendelt mennyiség.
`serial`	A termékhez csomagoláskor rögzített egyedi azonosító. (Opcionális.)

Mező	Kötelező?	Leírás
`apiKey`	Igen	Az API kulcs.
`order`	Igen	A létrehozandó vagy módosítandó rendelés adatai.
`referenceId`	Igen	Külső azonosító. Szabadszavas, ajánlott a megrendelés azonosítójának használata.
`referenceName`	Nem	A rendelés neve. A rendelés létrehozásakor megadott név. Szabadszavas, ajánlott a megrendelés azonosítójának használata, vagy egy abból képzett név. (pl.:`RENDELES#1221`)
`createdAt`	Igen	A rendelés létrejöttének ideje.
`shipping`	Igen	A szállítási adatai.
`shipping.name`	Igen	A címzett neve.
`shipping.company`	Nem	Cég esetén, a cégnév.
`shipping.email`	Nem	E-mail cím.
`shipping.phone`	Nem	Telefonszám.
`shipping.countryCode`	Igen	Kétjegyű országkód. (pl.: `HU`)
`shipping.stateOrProvinceCode`	Nem	Állam, tartomány. (Főleg külföldi címzés esetén fontos.)
`shipping.zip`	Igen	Irányítószám.
`shipping.city`	Igen	Város.
`shipping.address1`	Igen	A cím első sora.
`shipping.address2`	Nem	A cím második sora.
`shipping.note`	Nem	A címhez tartozó megjegyzés, `<![CDATA[]]>`. (Használata ajánlott.)
`shipping.mode`	Nem	A szállítási mód, lehetséges értékek: `GLS-HU`, `FOXPOST-HU`, `PRIO`, `DHL`, `SPRINTER`, `GLS-SK`, `MPL.`
`shipping.packPoint`	Nem	A csomagpont fajtája, lehetséges értékek: `GLS`, `FOXPOST-HU`, `CSOMAGKULDO`, `MPL`.
`shipping.packPointId`	Nem	A csomagpont azonosító Id-je.
`billing`	Nem*	A számlázás adatok. (Kiszervezett számlázás esetén kötelező.)
`billing.name`	Igen	A számlázási név.
`billing.company`	Nem	Cég esetén, a cégnév.
`billing.phone`	Nem	Telefonszám.
`billing.taxNumber`	Nem	Adószám.
`billing.countryCode`	Igen	Kétjegyű országkód. (pl.: `HU`)
`billing.zip`	Igen	Irányítószám.
`billing.city`	Igen	Város.
`billing.address1`	Igen	A cím első sora.
`billing.address2`	Nem	A cím második sora.
`payment`	Igen	A fizetéssel kapcsolatos információk.
`payment.paymentMode`	Igen	A fizetési mód, szabadszavas, intelligens felismerést használ, azonban az ajánlott értékek: `cod`, `card`, `paypal`, stb.
`payment.codAmount`	Nem	Az utánvét összege. A végösszegtől eltérhet, ez az érték kerül a futárhoz utánvét összegeként.
`payment.paymentStatus`	Igen	A fizetés státusza, lehetséges értékek: `paid`, `pending`. Egyéb esetben egyeztetés szükséges.
`payment.paidDate`	Nem*	A fizetés ideje. `paid` (fizetve) státusz esetén kötelező.
`payment.shippingPrice`	Nem	A szállítási költség összege. (Bruttó összeg, ami a vevői számlán szerepelni fog.)
`payment.shippingVat`	Nem	A szállítási költség ÁFA kulcsa.
`payment.currency`	Igen	A rendelés pénzneme, 3 karakteres (ISO) azonosító. (pl.: `HUF`)
`payment.discount`	Nem	Kedvezmény a megrendelés végösszegéből.
`products`	Nem	A rendelés termékei.
`products.sku`	Igen	A termék SKU-ja (cikkszáma).
`products.productName`	Igen	A termék neve.
`products.variantName`	Nem	A termékvariáns neve.
`products.priceGross`	Igen	A termék bruttó egységára.
`products.vat`	Igen	A termék ÁFA kulcsa.
`products.quantity`	Igen	A termékből rendelt mennyiség.
`invoiceUrl`	Nem	Számla link a letöltéshez. https://example.com/invoice.pdf Csak akkor van jelentősége, ha van Manuális PDF számlafeltöltő beállítva az API kapcsolathoz, mert ebben az esetben használja fel a rendszer.
`attachmentUrl`	Nem	Csatolmány link a letöltéshez. https://example.com/attachment.pdf Egy rendeléshez 1 pdf melléklet csatolható és minden esetben nyomtatásra kerül. (pl. A használati útmutató a termékhez.)
`pdfSource`	Nem	Pdf formátumú számla fájl base64 kódolással. Csak akkor van jelentősége, ha van Manuális PDF számlafeltöltő beállítva az API kapcsolathoz, mert ebben az esetben használja fel a rendszer.