Hava Yolu Sipariş Oluştur - createAirOrder()

Hava Yolu Sipariş Oluştur

Horoz Lojistik E-İhracat Entegrasyonu üzerinde bulunan createAirOrder metodu, hava yolu taşımacılığında yer alacak yurt içinden yurtdışına yapılacak Doküman, Bedelsiz Numune, Mikro İhracat ve Gümrüklü/Makro İhracat gönderi tipleri için Horoz sisteminde iletilmesi gereken siparişlerin verisini oluşturmak için kullanılmalıdır. createAirOrder() metodu ile ilgili önemli bilgiler ve Horoz sisteminde hava yolu ihracat siparişi oluşturulurken dikkat edilmesi gerekenler liste halinde aşağıda istemcilerin bilgisine sunulmuştur.

Sipariş oluşturma yapısının içerisinde yer alan gönderi tiplerinden Micro İhracat ve Gümrüklü/ Makro İhracat gönderi tiplerinin bağlı belgelerinin FTP üzerinden öncelikle gönderilmiş olması sipariş kaydının sisteme eklenmesinde yapılacak ilk kontroldür.
Horoz Lojistik sistemine belgeleri ve sipariş isteği başarılı olarak gönderilmiş bir kayıt için herhangi bir nedenden dolayı siparişin iptal edilmesi gereken durumda satıcının Horoz Lojistik e-ihracat müşteri temsilcisi görevlisiyle iletişime geçerek iptal işlemini manuel olarak ilerletmesi gerekir.
Başarılı olarak gönderilmiş bir siparişin kayıtlı bilgilerinden herhangi biri değiştirilmek istenirse önce üstte bildirilen iptal sürecinin tamamlanması ardından bu metotla yeni bir sipariş olarak o siparişe bağlı olan belgelerin de gerekli ise FTP üzerinden gönderilmesi ile yeni bir sipariş olarak açılması gerekmektedir.
Siparişte gönderi tipleri arasındaki Mikro İhracat gönderi tipinde sipariş ağırlığı, 300 kg sipariş toplam ağırlığına eşit veya altında olması koşulu bulunmaktadır. Diğer seçimler bir kurala tabi değildir.
Her bir sipariş alıcı bazında tekil olmak zorundadır. Sipariş içerisindeki Alıcı Tipi, Alım Tipi, Incoterms, Alıcı Ülke ve Kap bilgileri siparişin fiyatlamasının belirlenmesi için önemli bilgilerdir. Sipariş Amazon gönderisi mi seçimi yapılırken eğer Amazon gönderisi ise EORI Numarası geçilmesi zorunludur. Amazon gönderisi olan siparişler için Paket bilgileri oluşturulurken FBA (Amazon Dış Koli Barkod Numarası) bilgisi girilebilir ancak zorunlu değildir.
Fiziki olarak taşınacak Paket bilgileri her bir paket için ayrı ayrı satırlar halinde metod içerisine eklenmesi gerekmektedir. Bu kaplar siparişin ürün detayı gibi ve ancak adet kadar item (detay) içerecek şekilde sisteme eklenecektir bunun temel nedeni hava yolu taşımasına özgü bir durum olarak sipariş içindeki her adetin takibi ve teslim ya da sorun durumlarında farklılaşma imkânı vardır. Parça bazlı takip sağlanacaktır. Siparişte örneğin 3 tane aynı paket olsun. Özetle üç paketin her biri ayrı ayrı gönderilmesi gerekmektedir. Bu talep datanın çoklanması anlamına geleceği için containerCode değeri her bir satır için sonuna bir sequence eklenerek farklılaştırılabilir.
Fiyat şu an için bu servise veri geçecek olan pazaryeri tarafında, Horoz tarafından gönderilen listeden satıcıya gösterilip ve Horoz’a Nakliye fiyatı olarak iletilmesi gerekmektedir. Horoz’a gönderilen fiyat tahmini fiyat olacaktır. Horoz tarafında güncelleme yapılabilmektedir.
Entegrasyon üzerinden Horoz sistemine iletilecek hava yolu siparişleri için gönderilecek kap birim fiyatı para birimi bilgilerinin; TRY (Türk Lirası), EUR (Avrupa Birliği Para Birimi), USD (Amerikan Doları) ve GBP (İngiliz Sterlini) olarak gönderilmesi beklenir. Aksi halde istemciye hata dönülür.
Alım tipi kendisi getirecek olduğunda gönderici; Horoz tarafından belirlenen toplama adresine ürünleri getirmesi gerekecektir. Satıcıya ürünü getirmesi gereken toplama adresi mail yoluyla sistem tarafından iletilecektir.
Alım tipi adresten alınacak olduğunda ve gönderici şehir bilgisi İstanbul ise; Kurye Çağır durumu oluşacaktır. Kurye sürecinde; Saat 14:00'e kadar girilen siparişler için gün içerisinde, 14:00 sonrası girilen siparişler için bir sonraki iş günü kurye hizmeti sağlanacaktır.
Gönderici adresi İstanbul dışında bir adres ise; sipariş CW 30 ve altında olan siparişlerde Yurtiçi Kargo şubesine gerekli dokümanlarla kendisi götürmeli, sipariş CW 30’un üstünde olan siparişlerde ürünler Horoz tarafından alınıp toplama adresine götürülecektir.
Kap detaylarındaki bilgiler siparişin paketlerinin içinde olan ürünleri ifade etmektedir. Örneğin 3 paket olsun. Bu 3 paketin içerisindeki 10 gömlek, 20 kemer, 50 düğme olduğu bir senaryoda; paket detaylarında bu ürünler ayrı ayrı tanımlanmalıdır. Tanım yapılırken Açıklama alanına ürünün İngilizce ismi geçilmesi gerekmektedir.

Hava Yolu Sipariş Oluşturma Metodunun Mantıksal Koşulları ve Formülasyonları

API içerisinde yer almayan ancak fiyatlama aşamasında gerekli olacak bazı düzenlemelere ait bilgiler alttaki detayda görülebilir.

DESİ: Hacimsel ağırlık anlamına gelmektedir. DESİ hesaplanırken sağlıklı sonuçlar elde edilebilmesi için kullanılan özel bir formül vardır. Bu formülde kolinin eni, boyu ve yüksekliği sırasıyla birbiriyle çarpılmakta, ardından çıkan sonuç karayolu gönderileri için 3000’e hava yolu gönderileri için 5000’e bölünerek belirlenmektedir.

• Eni 50 cm, boyu 30 cm, yüksekliği ise 40 cm olan bir paket, 20 desidir. (50 x 40 x 30 /3000= 20)
• Eni 10 cm, boyu 10 cm, yüksekliği ise 30 cm olan bir paket, 1 desidir. (10 x 10 x 30 / 3000= 1)
• Eni 20 cm, boyu 30 cm, yüksekliği ise 40 cm olan bir paket, 8 desidir. (20 x 30 x 40 /3000= 8)

CW: Chargable weight yani fiyatlandırılabilir ağırlık anlamına gelmektedir. Herhangi bir paketin DESİ değeri ile AĞIRLIK değerinin karşılaştırılması sonucu büyük olan değeri ifade etmektedir.

• Eni 50 cm, boyu 30 cm, yüksekliği ise 40 cm olan bir paketin ağırlığı 30 kg olsun. DESİ: 20; AĞIRLIK: 30 olduğundan CW değeri 30 olarak tanımlanır.
Ürünlerin ayrı ayrı CW değerleri toplanarak sipariş CW değeri bulunur.
ÇEVRE: Bir paketin çevre değeri hesaplamasını ifade etmek için kullanılan tanımdır. Çevre hesabının formülü: Bir paketin, En uzun boyutu + 2 * (Diğer boyutların toplamı) olarak ifade edilir.

• Eni 50 cm, boyu 30 cm, yüksekliği ise 40 cm olan bir paketin çevresi 190’dır. (50 + 2 * (30 + 40))
BÜYÜK PAKET Büyük paket tanımı, fiyatlamada oluşan bir ek bedelin uygulanması için kullanılmaktadır. 
Bir paketin büyük paket sayılabilmesi için çevre değerinin belirli değerler arasında olması gerekmektedir. 
Formül = 300<= ÇEVRE< 400

• Eni 120 cm, boyu 60 cm, yüksekliği ise 70 cm olan bir paketin çevresi 380’dir. (120 + 2 * (60 + 70))
  Değer; 300 <= 380 < 400 olduğundan paket Büyük paket olarak adlandırılır. Büyük paket olarak tespit edilen bir paketin CW değeri için kontrol yapılır. CW < 40 ise CW değeri 40 olarak güncellenir, değilse CW değeri aynı kalır.

 • Eni 230 cm, boyu 20 cm, yüksekliği ise 20 cm olan bir paketin ağırlığı 25 kg olsun. 
   ÇEVRE = 230 + 2*(20+20) = 310 300 <= 310 < 400 olduğundan paket büyük paket olarak adlandırılır.
   DESİ = 230*20*20 / 3000 = 30,67 , AĞIRLIK = 25 olduğunda göre;
   DESİ > AĞIRLIK olduğundan CW değeri = 30,67 olarak alınır.
   Paket büyük paket olduğu için CW kontrolü yapılır.
   CW(30,67) < 40 olduğundan dolayı CW değeri, FCW alanına yazılmak için 40 olarak güncellenir.

FCW = Büyük paket kuralı için fiyatlamada kullanılacak CW değerini ifade etmektedir. 
Sipariş içerisindeki her paketin büyük paket kontrolünden geçmesi sonucu değişen/değişmeyen CW değerleri değiştirilmez ve belirlenen değer FCW alanına yazılır. 
Ürünlerin FCW alanına yazılan değerleri toplanarak sipariş FCW değeri bulunur. Fiyat sirkülerinde büyük paket kuralı seçimine göre kullanılacak CW değeri sipariş FCW değeri olacaktır.

OVER MAX PAKET = Over Max Paket bir limit değerinin üstündeki paketleri ifade etmektedir. Bir paketin Over Max Paket sayılabilmesi için Over Max Limit kuralına uyması gerekmektedir. 
Formülü: Bir paketin; öz ağırlığı > 70 kg veya herhangi bir boyutu > 274 cm veya Çevre değeri >= 400 cm olmasıdır.

• Eni 130 cm, boyu 70 cm, yüksekliği ise 100 cm olan bir paketin ağırlığı 50 kg olsun.
  Over Max Limit kuralı içindeki;
  • Öz ağırlık kuralına uymaz. 
  • Boyut kuralına uymaz. 
  • Çevre kuralına uyar.
Çevre = 130 + 2 * (70 + 100) = 490 cm 
Çevre ( 490 cm ) >= 400 olduğundan dolayı paket Over Max Paket olarak adlandırılır.

Entegrasyon üzerinden gelen her sipariş için veri sisteme eklendikten sonra yukarıda yer alan formüllere göre bazı işlemler yapılır ve bu ek alanlarda fiyatlama için kullanıma hazır hale getirilir.
Siparişe ek olarak eklenmesi gereken bilgiler içerisinde Referans No, IOSS/OSS No (koşula bağlı), EORI No(koşula bağlı), ATR No, E-Arşiv No, Ek sigorta bilgileri bulunmaktadır. Bu bilgilerin bazıları koşullara göre zorunlu bazıları zorunlu değildir. Kullanımı satıcının sipariş oluşturma aşamasında satıcının inisiyatifindedir. Sistemde fatura değeri 150 € altında olan ve B2C Avrupa gönderilerinde (İngiltere Hariç) IOSS/IOSS No bilgisinin girilmesi zorunludur. EORI No, alıcı ülke Avrupa ülkeleri ve İngiltere ise veya Amazon gönderi seçimi yapılmış ise girilmesi zorunlu bilgidir.
ATR No, ATR Dolaşım belgesi üzerindeki numaradır. E-Arşiv No gönderi tipi mikro ihracat olduğu durumda bir başka deyişle e-arşiv belgesi yüklendiğinde tanımlanması gereken bir numaradır. Ek sigorta bilgisi seçime bağlı bir bilgidir. Ek sigorta seçimi, satıcının ek sigorta istiyorum bildirisi yaptığı anlamına gelir.
Sipariş oluşturulurken yüklenecek evraklar ve sipariş oluştuktan sonra gönderilecek evraklar hakkında; gümrüklü dışında tüm gönderi tipleri için Horoz tarafından pazaryerine şablonları gönderilmiş Proforma belgesi, gönderi tipi Gümrüklü olan sipariş için satıcının özel olarak oluşturduğu Proforma belgesi ve Packing List belgeleri ve gönderi tipi Micro ihracat gönderi tipi için ise E-Arşiv belgesi sipariş için zorunlu belgelerdir. Bu belgeler ihracat entegrasyon yapısında kurulmuş olan sipariş gelmeden önce zorunlu belgenin FTP üzerinden iletilmesi sürecine dahildir. Satıcı isteğine bağlı olarak ATR, MSDS, FDA, Menşe Şahadetnamesi, Eur.1 Dolaşım Belgesi, TSCA belgeleri sipariş ile gönderilmesi gerekiyorsa FTP sürecine dahil olur. İsteğe bağlı olan bu belgeler siparişin sisteme alınmasında kontrol edilmez.

SATICI TARAFINDAN GÖNDERİLMESİ GEREKEN BELGELER;

BELGE ADI	İHRACAT TİPİ	ZORUNLULUK DURUMU
`E-ARŞİV`	MİKRO İHRACAT	ZORUNLU
`PACKING LIST`	GÜMRÜKLÜ	ZORUNLU
`PROFORMA`	TÜM GÖNDERİ TİPLERİ	ZORUNLU (GÜMRÜKLÜ GÖNDERİ TİPİ İÇİN SATICININ ÖZEL PROFORMASI; MİCRO İHRACAT, DOKÜMAN VE BEDELSİZ NUMUNE GÖNDERİ TİPLERİ İÇİN ŞABLONLARI PAZARYERİNE GÖNDERİLEN PROFORMA)
`ATR`	TÜM GÖNDERİ TİPLERİ	ZORUNLU DEĞİL (SATICI İNİSİYATİFİNE BAĞLI)
`MSDS`	TÜM GÖNDERİ TİPLERİ	ZORUNLU DEĞİL (SATICI İNİSİYATİFİNE BAĞLI)
`FDA`	TÜM GÖNDERİ TİPLERİ	ZORUNLU DEĞİL (SATICI İNİSİYATİFİNE BAĞLI)
`MENŞE ŞEHADETNAMESİ`	TÜM GÖNDERİ TİPLERİ	ZORUNLU DEĞİL (SATICI İNİSİYATİFİNE BAĞLI)
`EUR 1.DOLAŞIM BELGESİ`	TÜM GÖNDERİ TİPLERİ	ZORUNLU DEĞİL (SATICI İNİSİYATİFİNE BAĞLI)
`TSCA`	TÜM GÖNDERİ TİPLERİ	ZORUNLU DEĞİL (SATICI İNİSİYATİFİNE BAĞLI)

Sipariş oluştuktan sonra Horoz sistemleri, pazaryerlerine konşimento Barkod belgesi; gönderi tipi doküman, bedelsiz numune ve mikro ihracat olduğunda siparişe doküman olarak eklenip pazaryerlerine FTP üzerinden gönderilmesi gerekmektedir. CW, 30 ve altındaki siparişlerde YK TESLİM Belgesi, satıcının en yakın Yurtiçi Kargo Adresine ürün ile götürmesi gereken belgedir.

HOROZ TARAFINDAN SATICIYA GÖNDERİLMESİ GEREKEN BELGELER;

BELGE ADI	İHRACAT TİPİ	ZORUNLULUK DURUMU
`KONŞİMENTO`	DOKÜMAN, BEDELSİZ NUMUNE, MİCRO İHRACAT	ZORUNLU (HER SİPARİŞ BİLGİSİNDEN SONRA SATICI FİRMAYA GÖNDERİLMESİ GEREKEN BARKODDUR.)
`YK TESLİM BELGESİ`	TÜM GÖNDERİ TİPLERİ	ZORUNLU (YURTICI KARGO ürün tesliminde kullanılacak teslim belgesi)

E-ARŞİV Micro ihracat gönderi tipinde satıcı tarafından satışa istinaden alıcıya kesilen faturayı temsil eder.
PACKING LIST Gümrüklü gönderi tipinde toplama listesi anlamına gelir ve satıcı tarafından oluşturulur.
PROFORMA (HOROZ ŞABLONLARI) ihracat yapılacak yüklerin gümrük işlemlerinde kullanılan satıcı tarafından kaşeli imzalı bir şekilde ürün ceplerinde bulundurulması gereken taşınan ürünün bedelini, kimin fatura kestiğini, göndericisi ve alıcısını, siparişin toplam değerlerini barındıran ETGB benzeri evraktır. Bu proforma şablonu HOROZ tarafından oluşturulur ve pazaryerlerinden gümrüklü gönderi tipi dışındaki tüm gönderi tipleri için imzalı ve kaşeli halinin gönderilmesi beklenir.
PROFORMA (SATICININ ÖZEL PROFORMASI) gümrüklü gönderi tipi için satıcı tarafında haricen oluşturulan ve FTP üzerinden Horoz sistemine gönderilen belgedir.
Konşimento taşınacak kolilerin üzerine yapıştırılacak barkod olarak düşünülebilir.
YK TESLİM BELGESİ, 30 kg altındaki siparişlerde alım tipi adresten alınacak olarak seçilmiş durumda satıcının en yakın Yurtiçi Kargo şubesine ürün ile birlikte teslim etmesi gereken belgedir.
ATR Dolaşım Belgesi Avrupa Birliği üye ülkeleri ile Türkiye arasında gerçekleştirilen ticaret faaliyetlerine konu olan ürünlerin gümrük vergilerindeki indirimlerden yararlanmasını sağlayan bir belgedir. ATR belgesinin kapsadığı ürünler sanayi ürünleri ve işlenmiş tarım ürünleridir.
MSDS Belgesinin Türkçe anlamı; Malzeme Güvenlik Bilgi Formu veya Güvenlik Bilgi Formu‘ dur. Malzeme güvenlik bilgi formu veya MSDS, kimyasalların kullanım ve depolanması sırasında meydana gelebilecek sağlık ve güvenlik açısından risk oluşturabilecek durumları ortadan kaldırmak veya en aza indirmek için hazırlanan bilgilendirme dokümanıdır. MSDS, ilgili kimyasal maddelerin tehlike ve riskleri ile ilkyardım yöntemleri hakkında detaylı bilgi içermelidir.
FDA Belgesi, ABD pazarına gıda, ilaç, medikal cihaz vb gibi ürünleri sunan yabancı firmaların alması gereken bir belgedir. ABD hükümetinin dışarıdan gelecek ürünlerin iç pazara girebilmesi için talep ettiği 55 belgelerin başında FDA Sertifikası gelmektedir. FDA tarafından onaylanmayan ürünlerin ABD’ye satılması mümkün değildir. Bu nedenle, üretici ve ihracatçı firmaların, faaliyetlerini FDA tarafından yayınlanan prosedürlere ve ürünlerinin içeriğini FDA gerekliliklerine uygun hale getirmesi; daha sonra FDA Belgesi alması gerekmektedir.
Menşe Şehadetnamesi, uluslararası ticarette, ihracata konu olan malın tamamen bir ülke sınırları içerisinde elde edildğini veya imal edildiğini veya kısmen bir ülkede işlem görerek nihai halini aldığını belgelendirmek amacıyla kullanılan önemli bir dış ticaret dokümanıdır.
Eur.1 Dolaşım Belgesi, EFTA ülkeleri ve Avrupa Serbest Bölge Birliği ülkeleri, Avrupa Kömür Çelik Topluluğu ürünleri ve işlenmemiş tarım ürünleri söz konusu olduğunda Avrupa Birliği ülkelerine yapılan ihracatlarda kullanılan belgedir.
TSCA belgesi; Bazı Kırtasiye ürünleri için istenir toksit içerik olmadığını belirten belgedir. (Örnek Mürekkep)
Oluşan her sipariş kaydı için Ödeme Şekli olarak Freight Prepaid (Gönderici tüm taşıma masraflarını öder) şeklindedir. Genel değerlendirmelerde gelen bilgilere göre Freight collect (Alıcı tüm taşıma masraflarını öder) durumları da oluşabilmektedir ancak mevcut yapımız bu durumu desteklememektedir. İlerleyen aşamalarda ihtiyaç duyulduğunda bu konu ile ilgili geliştirmelere yapılabilir. Sistem tarafından siparişler üzerine ödeme şekli Freight Prepaid olarak eklenecektir. Bu bilgi sipariş detayında ödeme şekli başlığı altında gösterilmesi gerekmektedir.
Incoterms içerisinde iki seçim yer almaktadır. Bu seçimler DAP ve DDP ‘ dir. Açıklamaları aşağıdaki gibidir. Incoterms seçimi zorunludur ve fiyatlama açısından önem arzetmektedir.
DDP Varış Ülkesi Vergileri : (Delivery Duty Paid (Gümrük Resmi Ödenmiş Olarak Teslim)) : İhracatçı malları genellikle alıcının deposuna kadar teslim etmekte, teslim gerçekleşene kadar oluşan tüm maliyetleri karşılamaktadır. İhracatçı teslim yükümlülüğünü, ithalatçı ülkede belirlenen yerde mallarını hazır bulundurmasıyla yerine getirmektedir. İhracatçı; malların hazırlanması, paketlenmesi, evrakların hazırlanması, navlun bedeli ve sigortanın ödenmesi gümrük giriş ve çıkış işlemlerinin yapılması, malların yüklenmesi/boşaltılması, iç nakliye ve sigorta ve bu süreçteki tüm risk ve sorumluluklar ihracatçıya aittir.
DAP Varış Ülkesi Vergileri : (Delivered AT Place (Berlirlenen Yerde Teslim)) : Teslimat alıcının ülkesinde ve genellikle alıcının deposunda gerçekleşmektedir. Satıcı, malları taşıma aracından tahliye etmeden varış yerinde alıcının emrine hazır bulundurmakla teslim yükümlülüğünü yerine getirmiş olacaktır. Malların tesliminden sonra hasar ve kayıp riski alıcıya geçmektedir.

POST createAirOrder()

ENDPOINT

http://b2btest.horoz.com.tr:7801/eexport_test/v1/createAirOrder

Parametre Açıklamaları & Kuralları

Aşağıdaki tabloda createAirOrder() işleminin giriş ve çıkış parametreleri ve bu parametrelerin tür ve formatları listelenmiştir.

Alanlar
Örnek İstek
Örnek Cevap

Parametre	Açıklama	Veri Tipi	Uzunluk	Alan Yeri	Zorunluluk
`processKey`	İstemci için tanımlanan `processKey` bilgisi	string	100	Header	Zorunlu
`customerOrderNumber`	Müşteri sipariş numarası	String	50	inBody Request	Zorunlu
`senderName`	Gönderen adı bilgisi	String	50	inBody Request	Zorunlu
`senderSurName`	Gönderen soyadı bilgisi	String	50	inBody Request	Zorunlu
`senderCompanyName`	Gönderen şirket adı bilgisi	String	50	inBody Request	Opsiyonel
`senderEmail`	Gönderen email bilgisi	String	200	inBody Request	Zorunlu
`senderPhoneAreaCode`	Gönderen telefon kodu bilgisi	String	3	inBody Request	Zorunlu
`senderPhone`	Gönderen telefon bilgisi	String	13	inBody Request	Zorunlu
`senderAddress`	Gönderen adres bilgisi	String	500	inBody Request	Zorunlu
`senderPostCode`	Gönderen posta kodu bilgisi	String	20	inBody Request	Zorunlu
`senderCity`	Gönderen il adı bilgisi	String	100	inBody Request	Zorunlu
`senderCounty`	Gönderen ilçe adı bilgisi	String	100	inBody Request	Zorunlu
`senderCountry`	Gönderen ülke bilgisi	String	100	inBody Request	Zorunlu
`senderTaxNumber`	Gönderen vergi numarası bilgisi	String	11	inBody Request	Zorunlu
`senderIdentityNumber`	Gönderen kimlik numarası bilgisi	String	11	inBody Request	Zorunlu
`senderBuildingNumber`	Gönderen bina numarası bilgisi	Integer	-	inBody Request	Zorunlu
`recipientName`	Alıcı adı bilgisi	String	50	inBody Request	Zorunlu
`recipientSurname`	Alıcı soyadı bilgisi	String	50	inBody Request	Zorunlu
`recipientCompanyName`	Alıcı şirket adı bilgisi	String	50	inBody Request	Opsiyonel
`recipientEmail`	Alıcı email bilgisi	String	200	inBody Request	Zorunlu
`recipientPhoneAreaCode`	Alıcı telefon kodu bilgisi	String	3	inBody Request	Zorunlu
`recipientPhone`	Alıcı telefon bilgisi	String	13	inBody Request	Zorunlu
`recipientAddress`	Alıcı adres bilgisi	String	500	inBody Request	Zorunlu
`recipeintStreet`	Alıcı sokak bilgisi	String	50	inBody Request	Zorunlu
`recipientPostCode`	Alıcı posta kodu bilgisi	String	20	inBody Request	Zorunlu
`recipientCity`	Alıcı il adı bilgisi	String	100	inBody Request	Zorunlu
`recipientState`	Alıcı eyalet adı bilgisi	String	100	inBody Request	Zorunlu
`recipientCountry`	Alıcı ülke bilgisi	String	100	inBody Request	Zorunlu
`recipientBuildingNumber`	Alıcı bina numarası bilgisi	Integer	-	inBody Request	Zorunlu
`deliveryNotes`	Teslimat notu	String	1000	inBody Request	Opsiyonel
`amountType`	Tutar tipi bilgisi	String	10	inBody Request	Zorunlu
`shipmentType`	Gönderi tipi bilgisi	String	20	inBody Request	Zorunlu
`recipientType`	Alıcı tipi bilgisi	String	5	inBody Request	Zorunlu
`isAmazonPost`	Amazon gönderisi mi	String	3	inBody Request	Zorunlu
`invoicePrice`	Toplam fatura tutarı bilgisi	Float	-	inBody Request	Zorunlu
`invoiceCurrency`	Fatura para birimi	String	5	inBody Request	Zorunlu
`shippingPrice`	Nakliye tutar bilgisi	Float	-	inBody Request	Zorunlu
`receptionType`	Alım tipi bilgisi	String	30	inBody Request	Zorunlu
`incoterms`	İncoterm bilgisi	String	5	inBody Request	Zorunlu
`referenceNo`	Referans numarası bilgisi	String	1000	inBody Request	Opsiyonel
`IOSSNumber`	IOSS numarası bilgisi	String	50	inBody Request	Zorunlu
`EORINumber`	EORI numarası bilgisi	String	50	inBody Request	Zorunlu
`ATRNumber`	ATR numarası bilgisi	String	50	inBody Request	Opsiyonel
`EArchiveNumber`	E-Arşiv numarası bilgisi	String	50	inBody Request	Zorunlu
`additionalInsurance`	Ek sigorta bedeli bilgisi	String	5	inBody Request	Zorunlu
`paymentMethod`	Ödeme yöntemi bilgisi	String	20	inBody Request	Zorunlu
`containerInfo`	Kap bilgileri	Array	-	inBody Request	Zorunlu
`containerCode`	Kap kodu bilgisi	String	50	inBody Request	Zorunlu
`containerWeightInKg`	Kap ağırlık bilgisi	Float	-	inBody Request	Zorunlu
`containerLength`	Kap uzunluğu bilgisi	Float	-	inBody Request	Zorunlu
`containerWidth`	Kap genişliği bilgisi	Float	-	inBody Request	Zorunlu
`containerHeight`	Kap yüksekliği bilgisi	Float	-	inBody Request	Zorunlu
`containerFBA`	Kap FBA kodu bilgisi	String	50	inBody Request	Opsiyonel
`containerDetails`	Kap detayları	Array	-	inBody Request	Zorunlu
`currency`	Para birimi bilgisi	String	3	inBody Request	Zorunlu
`quantity`	Adet bilgisi	Integer	-	inBody Request	Zorunlu
`unitPrice`	Birim tutar bilgisi	Float	-	inBody Request	Zorunlu
`totalPrice`	Toplam tutar bilgisi	Float	-	inBody Request	Opsiyonel
`gtipCode`	GTIP kodu bilgisi	String	50	inBody Request	Zorunlu
`origin`	Menşei bilgisi	String	50	inBody Request	Zorunlu
`productNameEn`	Ürün adı bilgisi (İngilizce)	String	200	inBody Request	Zorunlu

  {
    "customerOrderNumber": "20230407-1",
    "senderName": "MEHMET",
    "senderSurname": "ÖZTÜRK",
    "senderCompanyName": null,
    "senderEmail": "mehmet.ozturk@horoz.com.tr",
    "senderPhoneAreaCode": "+90",
    "senderPhone": "542619785",
    "senderAddress": "KUMLUCA MAHALLESİ TAŞKIN SOKAK NO:22/1 GEBZE/İSTANBUL",
    "senderPostCode": "41400",
    "senderCity": "KOCAELİ",
    "senderCounty": "GEBZE",
    "senderCountry": "TÜRKİYE",
    "senderTaxNumber": null,
    "senderIdentityNumber": "123456789",
    "senderBuildingNumber": 22,
    "recipientName": "CLAUS",
    "recipientSurname": "DINGER",
    "recipientCompanyName": "DINGER EXPO",
    "recipientEmail": "claus.dinger@dingerexpo.com",
    "recipientPhoneAreaCode": "+49",
    "recipientPhone": "1716824946",
    "recipientAddress": "78144 SCHRAMBERG-TENNENBRONN",
    "recipientStreet": "WIESENSTRASSE 5",
    "recipientPostCode": "78144",
    "recipientCity": "SCHRAMBERG",
    "recipientState": "BADEN-VÜRTEMBERG",
    "recipientCountry": "ALMANYA",
    "recipientBuildingNumber": 2,
    "deliveryNotes": "TESLİM NOTU",
    "amountType": "ECONOMY",
    "shipmentType": "MACROEXPORT",
    "recipientType": "B2B",
    "isAmazonPost": "no",
    "invoicePrice": 3000,
    "invoiceCurrency": "EUR",
    "shippingPrice": 500,
    "receptionType": "ITWILLBRING",
    "incoterms": "DDP",
    "referenceNo": "MÜŞTERİ NOTU",
    "IOSSNumber": "IOSS123456",
    "EORINumber": "EORI123456",
    "ATRNumber": "ATR123456",
    "EArchiveNumber": "EA123456",
    "additionalInsurance": "no",
    "paymentMethod": "FREIGHTPREPAID",
    "containerInfos": [
      {
        "containerCode": "CONTAINERCODE-1",
        "containerWeightInKg": 1050.1,
        "containerLength": 100.1,
        "containerWidth": 200.2,
        "containerHeight": 300.3,
        "containerFBA": "FBA123456"
      },
      {
        "containerCode": "CONTAINERCODE-2",
        "containerWeightInKg": 1050.1,
        "containerLength": 100.1,
        "containerWidth": 200.2,
        "containerHeight": 300.3,
        "containerFBA": "FBA123456"
      }
    ],
    "containerDetails": [
      {
        "currency": "EUR",
        "quantity": 1,
        "unitPrice": 1000,
        "totalPrice": 1000,
        "gtipCode": "GTIPCODE-1",
        "origin": "ALMANYA",
        "productNameEn": "PRODUCT NAME EN-1"
      },
      {
        "currency": "EUR",
        "quantity": 1,
        "unitPrice": 2000,
        "totalPrice": 2000,
        "gtipCode": "GTIPCODE-2",
        "origin": "ALMANYA",
        "productNameEn": "PRODUCT NAME EN-2"
      }
    ]
  }

 {
    " response ": {
    "responseCode": "STA-100",
    "responseMessage": "Basarili"
    }
  }

createAirOrder() metodu içerisinde beklenen enum değerler için aşağıda detaylı bilgi verilmiştir.

ENUM ALAN	ALAN ADI	Açıklama
amountType	Tutar tipi	ECONOMY, EXPRESS değerlerinden sipariş için uygun olan değer geçilerek tutar tipi bildirilebilir. (ECONOMY : ekonomi, EXPRESS : ekspres)
shipmentType	Gönderim tipi	DOCUMENT, FREESAMPLE, MICROEXPORT, MACROEXPORT değerlerinden sipariş için uygun olan değer geçilerek gönderim tipi bildirilebilir. (DOCUMENT:doküman, FREESAMPLE:ücretsiz numune, MICROEXPORT: mikro ihracat, MACROEXPORT:makro ihracat)
receptionType	Alım tipi	RECEIVEDFROMADDRESS, ITWILLBRING değerlerinden sipariş için uygun olan değer geçilerek alım tipi bildirilebilir. (RECEIVEDFROMADDRESS : adresten alınacak, ITWILLBRING : kendisi getirecek)
recipientType	Alıcı tipi	B2B, B2C değerlerinden sipariş için uygun olan değer geçilerek alıcı tipi bildirilebilir.
incoterms	Incoterm	DDP, DAP değerlerinden sipariş için uygun olan değer geçilerek incoterms bildirilebilir.
isAmazonPost	Amazon gönderisi mi ?	yes, no değerlerinden biri geçilerek sipariş için uygun olan Amason gönderisi durumu bildirilebilir.
additionalInsurance	Ek sigortalı mı ?	yes, no değerlerinden biri geçilerek sipariş için uygun olan ek sigortalı mı durumu bildirilebilir.
paymentMethod	Ödeme tipi	FREIGHTPREPAID, değeri geçilerek sipariş için sigortalı olup/olmama durumu bildirilebilir. (FREIGHTPREPAID : ön ödemeli nakliye)
senderCountry / recipientCountry	Gönderen ülke / Alıcı ülke	listCounties metodu kullanılarak sipariş için uygun olan değer geçilerek senderCountry ve recipientCountry değerleri belirlenebilir.
senderCity / recipientCity	Gönderen il / Alıcıil	listCounties metodu kullanılarak sipariş çin uygun olan değer (bazı AVRUPA ülkeleri için) geçilerek senderCity ve recipientCity değerleri belirlenebilir.
senderCounty	Gönderen ilçe	listCounties metodu kullanılarak sipariş için uygun olan değer (bazı AVRUPA ülkeleri için) geçilerek senderCounty değerleri belirlenebilir.

Servis Cevapları

Servise ait başarılı/başarısız servis cevaplarına buradan erişebilirsiniz.