TRENDYOL PARTNER (MARKETPLACE) API REFERANS DÖKÜMANI

Benzer belgeler
TRENDYOL PARTNER (MARKETPLACE) API REFERANS DÖKÜMANI

TRENDYOL PARTNER (MARKETPLACE) API REFERANS DÖKÜMANI

StockMount API Servisi Uygulama Kılavuzu Sürüm

MOBILEPAX XML PRODUCT API KULLANIM ŞEKLİ

MOBILEPAX SOAP PRODUCT API KULLANIM ŞEKLİ

BAUHAUS B2B Web Servis Dökümantasyonu

Tel : 0(532) Web : E-Posta : info@kayikcioglugrup.com. İLETİ PAKETİ API (Entegrason) Dökümanı

Doküman JETSMS XML Mesaj Đşlemleri Yardım Dokümanı Tarih Sürüm 1.1.0

MOKA ÖDEME SERVİSİ BAYİ İŞLEMLERİ ENTEGRASYON DOKÜMANI

Kargo Modülü. Diğer modüller ile entegre çalışan Kargo modülü ile satış irsaliyesifaturasıoluşturduktan

Submit metodu birden fazla numaraya aynı içerikli kısa mesaj gönderimi için kullanılmaktadır.

REST API Dokümanı Versiyon Tarih Oluşturan/Düzenleyen

COM API v.1.1 BELGE SÜRÜMÜ : 1.1

3G Sms&MMS GateWay Xml Interface

%20dolor%20sit%20amet&receipents= , &sender=PROAKTIF

um%20dolor%20sit%20amet&receipents= , &sender=ILETICELL İstekte gönderilen parametrelerin açıklamaları aşağıdaki gibidir:

BSOFTefat E-FATURA ÇÖZÜMÜ

MOBILEPAX ENTERPRISE API (WEB SERVİS)

YENİ NESİL ÖDEME KAYDEDİCİ CİHAZLARA AİT ELEKTRONİK KAYIT, AKTİVASYON VE YETKİLİ SERVİS LİSTELERİ TEKNİK KILAVUZU

Bu dökümantasyon DomainNameAPI bayiliğinize ait alanadı işlemlerinizi, PHP ile API yi nasıl kullanmanız gerektiğini anlatmaktadır.

VIDEOCELL API. Versiyon 1.0.0

ICE BİLİŞİM TEKNOLOJİLERİ WEB SERVİS KILAVUZU. SERVİS LİNK: DÜZENLEME TABLOSU

IdeaSoft E-Ticaret ile LOGO Ticari Yazılım Entegrasyon Kullanım Kılavuzu

Global Haberleşme API Kullanıcı Notları

Xml Arayüzleri. 6. Sms To Multisenders (Farklı Mesajların Farklı Numaralara Yollanması)

MOKA ÖDEME SERVİSİ KART SAKLAMA VE TEKRARLI İŞLEM BAYİ ENTEGRASYON DOKÜMANI

COM API v2.0 Belge sürümü : 2.0.3

SMSEXPLORER XML API. XML API KILAVUZU v.1.0

MOKA ÖDEME SERVİSİ ÖDEME İSTEĞİ GÖNDERME BAYİ ENTEGRASYON DOKÜMANI

E-Fatura Entegratör Paketi V Kullanım Kılavuzu

JETSMS XML Mesaj İşlemleri Yardım Dokümanı Tarih Sürüm XML ile Mesaj İşlemleri

JAVA API v2.0 Belge sürümü: 2.0.2

Veritabanı Yönetim Sistemleri (Veritabanı Tasarımı) SQL (Structured Query Language)

Tiger2 EK ÖZELLİK PAKETİ 3

Sanal Santral A.Ş. Çözümleri

IdeaSoft E-Ticaret ile LOGO Ticari Yazılım Entegrasyon Kullanım Kılavuzu


Smart Commerce Proje Teklifi

HTTP/HTTPS API v2.0 Belge sürümü : 2.0.0

ile LOGO Ticari Yazılım Entegrasyon Kullanım Kılavuzu

Veritabanı Yönetim Sistemleri (Veritabanı Tasarımı) İlişkisel Veritabanı Modeli

TC KİMLİK NO SMS GÖNDERİM XML API

AJANS İLETİŞİM API XML API v İçindekiler. 1. AMAÇ - Sayfa 2

EDI MIGROS (Sipariş) LOGO ENTEGRASYONU

6 Ocak İlgili Versiyon/lar : ETA:SQL, ETA:V.8-SQL. İlgili Modül/ler : E-Fatura

BOTAŞ EBT BİLGİ YÖNETİM SİSTEMİ WEB SERVİSLERİ

Arena ConnAct. XML Servisi Entegrasyon Dokümantasyonu API Versiyon 1.0 Dokümantasyon Versiyon 0.1

TURKCELL HİZMETLERİ. Kullanım Bilgileri. LOGO Kasım 2014

BOTAN SMS APİ DÖKÜMANI. Versiyon 1.0

TARİHÇE. Versiyon Tarih Düzenleyen Açıklama Engin DURMAZ İlk versiyon

e-müstahsil Makbuzu Nedir?

Netsis İhracat e-fatura Uygulaması

3G SMS & MMS GateWay Xml Interface

E-FATURA SÜRECİ VE IFS ADAPTÖR YAZILIMI KULLANIMI

Misafir Anne Web Servisi Projesi

T.C.SOSYAL GÜVENLİK KURUMU. Genel Sağlık Sigortası Medula Optik E-rapor Web Servisleri Kullanım Kılavuzu

XML API v2.0 Belge sürümü : 2.0.2

PAKET TRANSFER SİSTEMİ

AÇIKLAMALARI SEBEP ÇÖZÜM

e-logo e-fatura Özel Entegratör Sistemi

Yayınlanma Tarihi: soru ve sorunlarınız için;

LOGO TURKCELL AKILLI FAKS ENTEGRASYONU BİLGİ DOKÜMANI

AKM SMS APİ DÖKÜMANI. VER:6.4.2 BETA ~ 1 ~

Veri Tabanı Hafta Dersi

PAKET TRANSFER SİSTEMİ

SANAL POS ENTEGRASYON DOKÜMANI. Versiyon Temmuz 2014 NESTPAY SANAL POS ENTEGRASYON DOKÜMANI

BOTAŞ EBT BİLGİ YÖNETİM SİSTEMİ WEB SERVİSLERİ

SOAP API. Mobildev Toplu Mesajlaşma API

ÖZEL ENTEGRASYON MÜŞTERİSİ OLUŞTURMA


VADELİ İŞLEM VE OPSİYON PİYASASI BISTECH FIX SERTİFİKASYON PROGRAMI REFERANS DATA AŞAMASI

SMS interconnecion APi S DOKÜMANI

İHRACAT E-FATURA KULLANIMI

E-Pazaryeri yazılımı ile sınırsız mağazalar oluşturabilir ve sınırsız ürün sa şı yaparak komisyon ve reklam geliri elde edebilirsin. C2C 6.

MOKA ÖDEME SERVİSİ IFRAME ENTEGRASYON DOKÜMANI

SMS API. KobiKom Telekomunikasyon A.Ş. SMS API Kullanım Bilgilerini İçerir. Tel: Fax:

*1000 *1100 ZARF İŞLENİYOR. İlgili hata sonucunda yapılması gereken GIB DURUM KODLARI AÇIKLAMALARI SEBEP ÇÖZÜM

E - YENİLİKLER BÜLTENİ

TC KİMLİK NO SMS GÖNDERİM SOAP API

Turkcell Hizmetleri Logo Ocak 2016

T.C.SOSYAL GÜVENLİK KURUMU. Genel Sağlık Sigortası Medula Optik E-rapor Web Servisleri Kullanım Kılavuzu

UBL UBL Türkiye Özelleştirmesi TEMEL BİLGİLER

Dış Kurum Entegrasyonları TURKPOS API. Yardım Dokümanı

EPİAŞ ABONE BİLGİLERİ KAYDI KILAVUZ DOKÜMANI V.2. Kullanıcı. Kapsam. Yasal Dayanak. Veri Kayıt Sorumlusu. Veri kayıt süresi. Ekran Adı.

Nisan 2014-v1.0 KMTP API TEST ve SERTİFİKASYON İŞLEMLERİ

SISOFT HEALTHCARE INFORMATION SYSTEMS SİSOFT SAĞLIK BİLGİ SİSTEMLERİ ÜTS İŞLEMLERİ

Yeni Nesil e-defter Kullanıcı Kılavuzu

MOKA ÖDEME SERVİSİ ORTAK ÖDEME SAYFASI ENTEGRASYON DOKÜMANI V

NovaFortis Yazılım Danışmanlık. E-fatura adaptörü

DESTEK DOKÜMANI ALIM MUHASEBE HESAPLARI PENCERESĐNDE HESAP DAĞITIM DETAYLARI

PAY PİYASASI BISTECH FIX SERTİFİKASYON PROGRAMI REFERANS DATA AŞAMASI İLERİ SEVİYE


İşlem Adımları. 18 Mart 2016

Örnek Excel Formatını Nereden Bulabilirim?

NetPOS REM Yazarkasa Entegrasyonu

Barkomatik. Stok Yönetimi. Ürün Yönetimi. Kullanım Kılavuzu

Merhaba Güncel API Dokümantasyonu.

1- E-defter beratlarında Gelirler İdaresi Başkanlığı (GİB) tarafından yapılan Berat değişikliği sebebiyle programlarımızda güncellemeler yapılmıştır.

MÜŞTERİ KARGO ENTEGRASYONU VE İLGİLİ WEB SERVİS METOTLARI

Transkript:

TRENDYOL PARTNER (MARKETPLACE) API REFERANS DÖKÜMANI v.3.0 18.12.2017

İÇİNDEKİLER DÖKÜMAN REVİZYON BİLGİLERİ... 3 GİRİŞ... 4 API GÜVENLİĞİ... 4 TEST ORTAMI BİLGİLERİ... 4 CANLI ORTAM BİLGİLERİ... 4 METHODLAR... 6 ÜRÜN AKTARMA... 6 POST createproducts (Tekli Örnek)... 6 POST createproducts (Tek Ürün 2 Variant Örnek)... 7 AKTARILMIŞ ÜRÜN BİLGİSİ GÜNCELLEME... 10 ONAYLANAN ÜRÜNLERİN ALINMASI... 10 ÜRÜN STOK VE FİYAT BİLGİSİ GÜNCELLEME... 12 POST updatepriceandinventory... 12 TOPLU İŞLEM KONTROLÜ YAPILMASI... 13 SİPARİŞ PAKETLERİNİN ALINMASI... 15 FATURA KESME BİLDİRİMİ... 21 TEDARİK EDEMEME BİLDİRİMİ... 22 KARGO KODU DEĞİŞTİRME (YURTİÇİ KARGO)... 23

DÖKÜMAN REVİZYON BİLGİLERİ 1.4 Api adresleri düzenlendi 2.0 Canlı ortam bilgileri eklendi. Auth bilgileri eklendi 2.1 Ürün aktarım kontrol bilgileri eklendi. 3.0 Sipariş paketi çekme ile ilgili güncellemeler eklendi. 3.1 Yurtiçi Kargo kod değiştirme eklendi

GİRİŞ Trendyol Partner API, Trendyol Partner Programı na (MARKETPLACE) katılan firmaların yazılımsal olarak Ürün Gönderimi, Ürün Stok ve Fiyat Güncelleme işlemleri, Sipariş Bilgilerinin alınması işlemlerinin yapılmasına imkan sağlar. API GÜVENLİĞİ Trendyol Partner API ye yapılacak bütün isteklerde Basic Auth kullanılacaktır. Gönderilecek her isteğin Header bilgisinde Auth bilgisinin bulunması gerekmektedir. Bkz. Username ve password bilgisini partnerdestek@trendyol.com adresine eposta atarak talep ediniz. TEST ORTAMI BİLGİLERİ Test ortamına erişebilmek için uygulama sunucularının IP bilgileri Trendyol tarafına bildirilerek erişim tanımı yapılmalıdır. Erişim tanımı sonrasında kullanılacak Supplier ID (Tedarikçi ID) bilgisi Trendyol tarafından sağlanacaktır. Bundan sonraki aşamalarda SupplierID olarak bu ID değeri kullanılacaktır. Tanımlama işlemi için partnerdestek@trendyol.com adresine eposta gönderiniz. https://stageapi.trendyol.com/stagesapigw/swagger-ui.html adresi üzerinden Swagger yardımıyla örnek istekte bulunulabilecektir. CANLI ORTAM BİLGİLERİ Canlı ortamına erişebilmek için uygulama sunucularının IP bilgileri Trendyol tarafına bildirilerek erişim tanımı yapılmalıdır. Erişim tanımı sonrasında kullanılacak Supplier ID (Tedarikçi ID) bilgisi Trendyol tarafından sağlanacaktır. Bundan sonraki aşamalarda SupplierID olarak bu ID değeri kullanılacaktır. Tanımlama işlemi için partnerdestek@trendyol.com adresine eposta gönderiniz.

Canlı ortamda yapılacak bütün isteklerin https://api.trendyol.com/sapigw/ adresine yapılması beklenmektedir.

METHODLAR ÜRÜN AKTARMA Ürünler Trendyol sistemine ilk olarak bu method yardımıyla iletilecektir. Tekli ve çoklu ürün gönderimini desteklemektedir. POST createproducts (Tekli Örnek) http://envurl/suppliers/supplierid/products Content-Type application/json İSTEK

POST createproducts (Tek Ürün 2 Variant Örnek) http://envurl/suppliers/supplierid/products Content-Type application/json İSTEK

"attributename":"beden", "attributevalue":"m" "attributename":"renk", "attributevalue":"kırmızı" ], "vatrate":18 "attributes": [ "attributename": "Yas Gurubu", "attributevalue": "16-26" "attributename": "Malzeme", "attributevalue": "Kauçuk" "attributename": "Theme", "attributevalue": "İlk Bahar Teması" ], "barcode":"1122338588995", "brand":"nike", "cargocompany":"yk", "categoryname":"ayakkabı", "currencytype":"mavi", "description":"trendyolmilla Ayakkabı", "gender":"m", "images":[ "url":"https://pbs.twimg.com/profile_images/594056912615841793/rnhn1wcs.jpg" ], "listprice":120, "productmainid":"159357", "quantity":5, "saleprice":100, "stockcode":"a11b2c3d4", "title":"trendyolmilla Siyah Ayakkabi", "variantattributes":[ "attributename":"beden", "attributevalue":"m" "attributename":"renk", "attributevalue":"mavi" ], "vatrate":18 ], "supplierid": 1000 NOT: Bir ürünün birden fazla variant ı olması durumunda (Ürünün XL ve L bedeni gibi) çoklu örnek te olduğu şekliyle isteğin gönderilmesi beklenmektedir. variantattributes altında her bir variantattributes için (Örn: Renk) tek bir tane gönderilmesi gekir.

NOT 2: variantattributes alaninda Renk ve Beden dışında attributename gönderimi yapıldığında gönderilen ürünler Trendyol Ürün Yetkililerince görüntülenmemektedir. Parametre Açıklamaları *Koyu renkli belirtilmiş alanlar zorunlu alan olarak istekte gönderilmelidir Parameters product.brand product.barcode product.title product.description product.category.name product.listprice product.saleprice product.currencytype product.images. [List] product.vatrate product.shipmentfirm product.quantity Description Ürün markası Ürün Barkodu Ürün başlığı Ürün açıklama bilgileri (HTML olabilir) Ürün kategori adı Ürün liste fiyatı(satış fiyatı düşük olunca üstü çizilen fiyat) PSF Ürün satış fiyatı TSF Ürün liste fiyatı para birimi (TRY olacaktır.) Ürün resmi URL adresi Listesi/adresleri Ürün KDV oranı 0,1,8,18 gibi olmalı Ürün gönderileceği kargo firması Stok miktarı

product.productmainid product.attributes.designer product.attributes.modelsize product.attributes.project product.attributes.theme product.attributes.trendlevel product.gender product.variantattributes.beden product.variantattributes.renk Ana Ürün Kodu Tasarımcı Manken Ölçüsü Proje Tema Trend Seviye Cinsiyet Ürün beden bilgileri, L,XL,M, W32/L23 etc. Ürün rengi gönderilecektir. AKTARILMIŞ ÜRÜN BİLGİSİ GÜNCELLEME Create Products methodu upsert olarak çalışmakta ve eğer gönderilen barkod sistem içinde yok ise yaratma, eğer ilgili barkod için daha önceden gönderim yapıldıysa o barkod ile gelen ikinci istek sonrası gelen bilgilere göre diğer değerler güncellenmektedir. NOT: createproducts üzerinde yapılan güncelleme işlemleri Trendyol sistemindeki ham ürün datasını güncellemelektedir. Eğer göndermiş olduğunuz ürünler ile Trendyol üzerinde bir butik açılmış ise createproducts ile yapılan güncellemeler, satışta olan ürünlere yansımamaktadır. NOT: CreateProduct methodunda eğer fiyat ve stok değişimi gönderilirse bu değişiklikler canlı ortama yansımaktadır. ONAYLANAN ÜRÜNLERİN ALINMASI Trendyol a aktarılan ürünler, Trendyol tarafından yayına alınmadan önce kontrol edilerek onaylanır. Onaylanmış ürünler artık real-time stok ve fiyat güncellemelerini alabilecek statüdedir. GET filterproducts http://envurl/suppliers/supplierid/products?approved=true DÖNÜŞ

"id": "00042e917d80bacda81f7637e02365c8", "batchrequestid": "6cdcf370-7285-471f-8e45-92fdf0af924c", "supplierid": 1024, "createdatetime": 1501841091699, "lastupdatedate": 1501843028469, "lastpricechangedate": 1501843028480, "laststockchangedate": 1501841147936, "gender": "", "brand": "TRENDYOLMILLA", "barcode": "86807902889051", "title": "7983 Önü İşlemeli Boyfriend Pantolon-Mavi", "categoryname": "KOLEKSİYON > ALT GİYİM > PANTOLON", "description": "", "stockunittype": "Adet", "quantity": 2, "listprice": 30, "saleprice": 100, "vatrate": 8, "images": [ "url": "http://www.trendyol.com/productimages/98393/big/101a07983_mavi.jpg" "url": "http://www.trendyol.com/productimages/98393/big/101a07983_mavi-1.jpg" "url": "http://www.trendyol.com/productimages/98393/big/101a07983_mavi-2.jpg" "url": "http://www.trendyol.com/productimages/98393/big/101a07983_mavi-3.jpg" ], "attributes": [ ], "variantattributes": [ "attributename": "Renk", "attributevalue": "Mavi" "attributename": "Beden", "attributevalue": "36" ] "id": "4b5caac9a72f15677da077373d0ee393", "batchrequestid": "f0046af1-278f-4a2c-b6ef-ea2a9c4cdd31", "supplierid": 1024, "createdatetime": 1501841204161, "lastupdatedate": 1501846443603, "lastpricechangedate": 1501846443609, "laststockchangedate": 1501846265185, "gender": "", "brand": "TRENDYOLMILLA", "barcode": "8680790286222", "title": "2089 Arkası Fermuarlı Kazak-Ekru", "categoryname": "KOLEKSİYON > ÜST GİYİM > TRİKO", "description": "", "stockunittype": "Adet", "quantity": 20, "listprice": 100, "saleprice": 50, "vatrate": 8, "images": [

NOT: approved=false olarak sisteme yeni aktarılmış ürünler kontrol edilebilir. NOT: /products?approved=true&supplierid=supplierid&barcode=barkodvalue kullanarak TEK BİR barkodun onaylı olup olmadığını sorgulayabilirsiniz. ÜRÜN STOK VE FİYAT BİLGİSİ GÜNCELLEME Trendyol a aktarılan ve onaylanan ürünlerin fiyat ve stok bilgileri eş zamanlı olarak güncellenebilmektedir. POST updatepriceandinventory http://envurl/suppliers/supplierid/products/price-and-inventory Content-Type application/json İSTEK

DÖNÜŞ HTTP 200 TOPLU İŞLEM KONTROLÜ YAPILMASI createproducts, updatepriceandinventory methodları servise yapılan istekler kuyruğa atarak işlendiği için, servise yapılan her başarlı istek sonucunda bir adet batchrequestid bilgisi dönülmektedir. Bu method yardımıyla batchrequestid ile alınan işlemlerin sonucunun kontrolü yapılabilir. Servis dönüşündeki "status" alanı control edilerek toplu işlemin tamamlanıp tamamlanmadığı kontrol edilebilir. Eğer toplu işlem sonucunda bir ya da birden fazla item için hata oluşmuş ise failurereasons alanı control edilerek sebebi bulunabilir. GET getbatchrequestresult http://envurl/suppliers/supplierid/products/batch-requests/batchrequestid DÖNÜŞ

"categoryname": "Üst Giyim", "listprice": 299.9, "saleprice": 209.9, "currencytype": "TRY", "vatrate": 18, "cargocompany": "YK", "quantity": 5, "stockcode": "a11b2c3d4", "images": [ "url": "https://sitecontent.com/wpcontent/uploads/2017/07/9660556476466.jpg" ], "productmainid": "159357", "gender": null, "attributes": [], "variantattributes": [ "attributename": "Beden", "attributevalue": "XL" ] "status": "SUCCESS", "failurereasons": [] ], "status": "COMPLETED"

SİPARİŞ PAKETLERİNİN ALINMASI GET orders http://envurl/supplier-api-gateway/suppliers/supplierid/orders DÖNÜŞ

"vatbaseamount": 14.0, "barcode": "5502805140", "orderlineitemstatusname": "Cancelled" "quantity": 1, "productid": 168855, "salescampaignid": 15, "productsize": "M", "merchantsku": "6984", "productname": "Rustic Rubber Bacon", "productcode": 36407, "merchantid": 1024, "price": 3.0, "productcolor": "#630c21", "id": 2, "sku": "98273", "vatbaseamount": 15.0, "barcode": "7638228450", "orderlineitemstatusname": "Cancelled" "quantity": 3, "productid": 30764, "salescampaignid": 15, "productsize": "M", "merchantsku": "110008", "productname": "Unbranded Concrete Pants", "productcode": 94022, "merchantid": 1024, "price": 167.0, "productcolor": "#7d4f4a", "id": 3, "sku": "119189", "vatbaseamount": 17.0, "barcode": "3604506472", "orderlineitemstatusname": "Invoiced" ], "orderdate": 1502262967385, "tcidentitynumber": "20077949804", "currencycode": "TRY" "shipmentaddress": "id": 4, "firstname": "Buçan", "lastname": "Arıcan", "company": "Beşok, Öztonga and Yıldızoğlu", "address1": "8655 Bulut Groves Apt. 517", "address2": "Apt. 361", "city": "West Beğboğa", "district": "4679 Günçiçek Courts", "postalcode": "29693", "countrycode": "TR", "fulladdress": "8655 Bulut Groves Apt. 517 Apt. 361" "ordernumber": "1155667", "totalprice": 501.00, "taxnumber": "23", "invoiceaddress": "id": 1, "firstname": "Bekbekeç", "lastname": "Yorulmaz", "company": "Ertürk and Sons", "address1": "4422 Akşit Union Apt. 872", "address2": "Apt. 088", "city": "New Baybüre", "district": "8483 Köylüoğlu Point", "postalcode": "12707", "countrycode": "TR",

"fulladdress": "4422 Akşit Union Apt. 872 Apt. 088" "customerfirstname": "Algu", "customerid": 115078, "customerlastname": "Akgül", "id": 3, "cargotrackingnumber": null, "lines": [ "quantity": 3, "productid": 30764, "salescampaignid": 15, "productsize": "M", "merchantsku": "110008", "productname": "Unbranded Concrete Pants", "productcode": 94022, "merchantid": 1024, "price": 167.0, "productcolor": "#7d4f4a", "id": 3, "sku": "119189", "vatbaseamount": 17.0, "barcode": "3604506472", "orderlineitemstatusname": "Invoiced" ], "orderdate": 1502262967385, "tcidentitynumber": "20077949804", "currencycode": "TRY" "shipmentaddress": "id": 54, "firstname": "Bayunçur", "lastname": "Nebioğlu", "company": "Akbulut and Sons", "address1": "30267 Buyançuk Drives Apt. 309", "address2": "Apt. 616", "city": "New Baçaraberg", "district": "string", "postalcode": "35309", "countrycode": "AG", "fulladdress": "30267 Buyançuk Drives Apt. 309 Apt. 616" "ordernumber": "93719371", "totalprice": 0.00, "taxnumber": "29", "invoiceaddress": "id": 52, "firstname": "Güler", "lastname": "Tekelioğlu", "company": "Akman - Limoncuoğlu", "address1": "234 Arnaç View Apt. 224", "address2": "Suite 479", "city": "East Güvercinburgh", "district": "string", "postalcode": "10004", "countrycode": "QA", "fulladdress": "234 Arnaç View Apt. 224 Suite 479" "customerfirstname": "Andarıman", "customerid": 89494, "customerlastname": "Baykam", "id": 4, "cargotrackingnumber": null, "lines": [ "quantity": 8, "productid": 91262, "salescampaignid": 299, "productsize": null,

"merchantsku": "186665", "productname": "Handmade Steel Pants", "productcode": 120368, "merchantid": 1024, "price": 731.0, "productcolor": null, "id": 52, "sku": "151104", "vatbaseamount": 16.0, "barcode": "123123", "orderlineitemstatusname": "Cancelled" "quantity": 8, "productid": 85540, "salescampaignid": 299, "productsize": null, "merchantsku": "109890", "productname": "Generic Frozen Pizza", "productcode": 108003, "merchantid": 1024, "price": 958.0, "productcolor": null, "id": 53, "sku": "186942", "vatbaseamount": 12.0, "barcode": "456789", "orderlineitemstatusname": "Cancelled" ], "orderdate": 1502366528725, "tcidentitynumber": "88212762041", "currencycode": "TRY" "shipmentaddress": "id": 57, "firstname": "Bayunçur", "lastname": "Nebioğlu", "company": "Akbulut and Sons", "address1": "30267 Buyançuk Drives Apt. 309", "address2": "Apt. 616", "city": "New Baçaraberg", "district": "string", "postalcode": "35309", "countrycode": "AG", "fulladdress": "30267 Buyançuk Drives Apt. 309 Apt. 616" "ordernumber": "937188371", "totalprice": 13512.00, "taxnumber": "29", "invoiceaddress": "id": 55, "firstname": "Güler", "lastname": "Tekelioğlu", "company": "Akman - Limoncuoğlu", "address1": "234 Arnaç View Apt. 224", "address2": "Suite 479", "city": "East Güvercinburgh", "district": "string", "postalcode": "10004", "countrycode": "QA", "fulladdress": "234 Arnaç View Apt. 224 Suite 479" "customerfirstname": "Andarıman", "customerid": 89494, "customerlastname": "Baykam", "id": 5, "cargotrackingnumber": 1000001153261, "lines": [

"quantity": 8, "productid": 91262, "salescampaignid": 299, "productsize": null, "merchantsku": "186665", "productname": "Handmade Steel Pants", "productcode": 120368, "merchantid": 1024, "price": 731.0, "productcolor": null, "id": 54, "sku": "151104", "vatbaseamount": 16.0, "barcode": "123123", "orderlineitemstatusname": "ReadyToShip" "quantity": 8, "productid": 85540, "salescampaignid": 299, "productsize": null, "merchantsku": "109890", "productname": "Generic Frozen Pizza", "productcode": 108003, "merchantid": 1024, "price": 958.0, "productcolor": null, "id": 55, "sku": "186942", "vatbaseamount": 12.0, "barcode": "456789", "orderlineitemstatusname": "ReadyToShip" ], "orderdate": 1502366539053, "tcidentitynumber": "88212762041", "currencycode": "TRY" "shipmentaddress": "id": 61, "firstname": "Arı", "lastname": "Akal", "company": "Türkdoğan LLC", "address1": "817 Balakatay Motorway Suite 341", "address2": "Apt. 813", "city": "West Alpyörük", "district": "706 Kulaksızoğlu Street", "postalcode": "10736", "countrycode": "TR", "fulladdress": "817 Balakatay Motorway Suite 341 Apt. 813" "ordernumber": "5632131556", "totalprice": 2741.00, "taxnumber": "31", "invoiceaddress": "id": 58, "firstname": "Engin", "lastname": "Kurutluoğlu", "company": "Taşçı and Sons", "address1": "3457 Atsız Row Apt. 269", "address2": "Apt. 628", "city": "South Çağrıteginfort", "district": "8868 Beğdurmuş Knolls", "postalcode": "18465", "countrycode": "TR", "fulladdress": "3457 Atsız Row Apt. 269 Apt. 628" "customerfirstname": "Ayma", "customerid": 59488,

], "customerlastname": "Durak ", "id": 6, "cargotrackingnumber": 1000001153292, "lines": [ "quantity": 2, "productid": 55829, "salescampaignid": 15, "productsize": "M", "merchantsku": "117415", "productname": "Handmade Plastic Bacon", "productcode": 59528, "merchantid": 1024, "price": 980.0, "productcolor": "#387352", "id": 56, "sku": "194897", "vatbaseamount": 8.0, "barcode": "19380946248", "orderlineitemstatusname": "ReadyToShip" "quantity": 1, "productid": 96622, "salescampaignid": 15, "productsize": "M", "merchantsku": "181862", "productname": "Intelligent Frozen Table", "productcode": 17583, "merchantid": 1024, "price": 289.0, "productcolor": "#0c0d76", "id": 57, "sku": "47178", "vatbaseamount": 14.0, "barcode": "11940273720", "orderlineitemstatusname": "ReadyToShip" ], "quantity": 3, "productid": 165706, "salescampaignid": 15, "productsize": "M", "merchantsku": "11994", "productname": "Incredible Rubber Computer", "productcode": 71928, "merchantid": 1024, "price": 164.0, "productcolor": "#385867", "id": 58, "sku": "136674", "vatbaseamount": 10.0, "barcode": "5377644000", "orderlineitemstatusname": "ReadyToShip" "orderdate": 1502367147140, "tcidentitynumber": "76781559963", "currencycode": "TRY" "totalelements": 5 NOT 1: Sipariş datası alınırken gelen ordernumber değeri o siparişin Trendyol sistemindeki ana sipariş numarasına karşılık gelmektedir. Aynı seviyede yer alan id değeri de o sipariş numarasına karşılık oluşturulmuş Sipariş Paketini temsil etmektedir.

NOT 2: Herhangi bir sipariş paketi içinde bir ya da birden fazla kalem İptal edilir ise, Sistem tarafından otomatik olarak ordernumber aynı kalmak koşuluyla sipariş paketi bozulur ve yeni bir id değeri ve kargo barkodu oluşturulur. NOT 3: Sipariş bilgilerinin çekelerken ürünün createproducts ile gönderilen Barkod değelerine göre paketleme ve işlemler yapılmalıdır. NOT 4: Trendyol.com da bir müşteri birden fazla butikten ürün alır ise aynı ordernumber altında birden fazla paket oluşabilir. Bu sebeple, geliştirme yapılırken bir ordernumber altından her zaman birden fazla id (paketid) gelecek şekilde işlem yapılmalıdır. NOT 5: suppliers/xxxx/orders?status=created gibi bir query ile de paket statülerine göre sorgulama yapılabilir. Kullanılabilinecek statüler: Created, Picking, Invoiced, Shipped, Cancelled, Delivered, UnDelivered, Returned, Repack, UnSupplied (Sistemde paket statüleri ve orderlineitem statüleri birbirinden farklıdır.) Yeni oluşmuş paketleri çekmek için Created olarak sorgulama yapılmalıdır. FATURA KESME BİLDİRİMİ Oluşturularan sipariş paketinin faturasının kesilmesi işleminin Trendyol a bildirilebilmesi için kullanılır. Fatura kesme işleminin bildirilmesi, Trendyol Müşteri Hizmetlerine ulaşan, müşteri kaynaklı iptallerin önlenmesi için bir referanstır. PUT updatepackage http://envurl/suppliers/supplierid/shipment-packages/shipmentpackageid Content-Type application/json İSTEK

DÖNÜŞ HTTP 200 TEDARİK EDEMEME BİLDİRİMİ Tedarikçinin paket içerisindeki ürünlerden bir ya da birkaçını Tedarik Edememe kaynaklı iptal etmesi için kullanılır. Bu method yardımıyla yapılan bir iptal sonrası, iptal edilen paket bozularak yeni ID li bir paket oluşturulacaktır. ÖNEMLİ NOT: Tedarik edememe bildirimi yapıldıktan sonra Trendyol Order Management System tarafından aynı ordernumber üzerinde yeni bir ShipmentPackageID oluşturulmakta ve daha önceki shipmentpackage iptal edilmektedir. Bu durumda Tedarik Edememe kaydı yapıldıktan sonra tekrar Sipariş Paketlerinin Alınması işlemi yapılması gerekmektedir. PUT updatepackage http://<envurl>/suppliers/supplierid/shipment-packages/shipmentpackageid Content-Type application/json İSTEK DÖNÜŞ HTTP 200 NOT : Her tedarik edememe bildirimi sonrasında, Sistem tarafından otomatik olarak ordernumber aynı kalmak koşuluyla sipariş paketi bozulur ve yeni bir id değeri ve kargo barkodu oluşturulur.

Bu sebeple Orders method çağırılarak yeni oluşan id değerine göre paket operasyonları yapılmalıdır. KARGO KODU DEĞİŞTİRME (YURTİÇİ KARGO) Tedarikçinin Yurtiçi Kargo firmasından kendi anlaşması üzerinden gönderdiği ürünün, Trendyol sistemine bildirilmesi için kullanılır. Bu method herhangi bir paket için çağırıldığında, artık Trendyol un Yurtiçi Kargo anlaşması üzerinden olan paket değil, tedarikçinin kendi anlaşması üzerinden yaptığı gönderinin durumu sorgulanmaya başlar ve Yola Çıktı, Teslim Edildi, Teslim Edilemedi bilgileri entegrasyon üzerinden alınır ve takip edilir. ÖNEMLİ NOT: Sadece Yurtiçi Kargo paketleri için bu işlem kullanılabilir olup, Yola Çıkmış, Teslim Edilmiş statüdeki paketler için kargo kodu kullanılamaz. EĞer ÖNEMLİ NOT2: Eğer kargo numarası update edilen bir pakete tedarik edememe bildirimi yapılırsa, yeni bir paket ve kargo kodu oluşacağı için entegrasyon üzerinden yeni oluşacak paketin de tekrar kargo kodunun güncellenmesi beklenir. PUT updatepackage http://<envurl>/suppliers/supplierid/shipmentpackageid/update-tracking-number Content-Type application/json İSTEK DÖNÜŞ HTTP 200 DÖNÜŞ HATA

"timestamp": 1524123368827, "exception": "ClientApiBusinessException", "errors": [ "key": "shipment.package.tracking.number.could.not.updated", "message": "Sipariş kargo paketinin 609766293963 numaralı kargo kodu güncellenemedi. Hata: Gecersiz kargo kodu, Kargo Id: 3554944", ] "args": [ ] "609766293963", Gecersiz kargo kodu, "3554944"