Trendyol Partner Programı 2017

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

v.2.1 13.10.2017

2

İÇİNDEKİLER TRENDYOL PARTNER (MARKETPLACE) API REFERANS DÖKÜMANI 1

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 AKTARILMIŞ ÜRÜN BİLGİSİ GÜNCELLEME 10 ONAYLANMAMIŞ ÜRÜNLERİN ALINMASI 10 ONAYLANAN ÜRÜNLERİN ALINMASI 10 ÜRÜN STOK VE FİYAT BİLGİSİ GÜNCELLEME 12 TOPLU İŞLEM KONTROLÜ YAPILMASI 13 SİPARİŞ PAKETLERİNİN ALINMASI 14 FATURA KESME BİLDİRİMİ 20 TEDARİK EDEMEME BİLDİRİMİ 21

3

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.

4

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. Authorization: Basic {base64 encoded username:password}

Örnek: Username: test@trendyol.com Şifre: trendyol123 Authorization: Basic dGVzdEB0cmVuZHlvbC5jb206dHJlbmR5b2wxMjM=

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.comadresine 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.comadresine eposta gönderiniz.

5

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

6

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

{ "items": [ { "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":"TRY", "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":[

7

{ "attributeName":"Beden", "attributeValue":"M" }, { "attributeName":"Renk", "attributeValue":"Kırmızı" } ], "vatRate":18 } ], "supplierId": 1000 }

POST createProducts (Tek Ürün 2 Variant Örnek) http://{envurl}/suppliers/{supplierId}/products

Content-Type

application/json

İSTEK

{ "items": [ { "attributes": [ { "attributeName": "Yas Gurubu", "attributeValue": "16-26" }, { "attributeName": "Malzeme", "attributeValue": "Kauçuk" }, { "attributeName": "Theme", "attributeValue": "İlk Bahar Teması" } ], "barcode":"1122338588994", "brand":"Nike", "cargoCompany":"YK", "categoryName":"Ayakkabı", "currencyType":"TRY", "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":"a11b2c3d3", "title":"TrendyolMilla Siyah Ayakkabi", "variantAttributes":[

8

{ "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.

9

Hatalı gönderim örneği : "variantAttributes":[ { "attributeName":"Renk", "attributeValue":"Kırmızı" }, { "attributeName":"Renk", "attributeValue":"Mavi" }

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. Hatalı gönderim örneği : "variantAttributes":[ { "attributeName":"Color", "attributeValue":"Kırmızı" } ]

Parametre Açıklamaları *Koyu renkli belirtilmiş alanlar zorunlu alan olarak istekte gönderilmelidir

Parameters Description

product.brand Ürün markası

product.barcode Ürün Barkodu

product.title Ürün başlığı

product.description Ürün açıklama bilgileri (HTML olabilir)

product.category.name Ürün kategori adı

product.Listprice Ürün liste fiyatı(Satış fiyatı düşük olunca üstü çizilen fiyat) PSF

product.Saleprice Ürün satış fiyatı TSF

product.currencyType Ürün liste fiyatı para birimi (TRY olacaktır.)

product.images. [List] Ürün resmi URL adresi Listesi/adresleri

product.vatRate Ürün KDV oranı 0,1,8,18 gibi olmalı

product.shipmentFirm Ürün gönderileceği kargo firması

product.quantity Stok miktarı

product.productMainId Ana Ürün Kodu

10

product.attributes.designer Tasarımcı

product.attributes.modelsize Manken Ölçüsü

product.attributes.project Proje

product.attributes.theme Tema

product.attributes.trendlevel Trend Seviye

product.gender Cinsiyet

product.variantAttributes.Beden Ürün beden bilgileri, L,XL,M, W32/L23 etc.

product.variantAttributes.Renk Ürün rengi gönderilecektir.

NOT: Trendyol Partner API sistemi için Barkod bilgisi ürün varyantını tekil olarak tanımlayan bir öneme sahiptir. Sistem üzerine gönderilen barkodlar üzerinden siparişler çekilir ve sonra yapılacak bütün Ürün,Stok,Fiyat güncelleme operasyonları barkod üzerinden ilerletilecektir.

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.

ONAYLANMAMIŞ ÜRÜNLERİN ALINMASI Sisteme createProducts ile aktarılan ürünler Onaysız statüde beklemektedir. createProducts methodunun başarılı olup olmadığı ve ürün kontrolleri filterProducts kullanılarak yapılabilmektedir. GET filterProducts http://{envurl}/suppliers/{supplierId}/products?approved=false

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

11

DÖNÜŞ

{ "totalElements": 5, "totalPages": 3, "page": 0, "size": 2, "content": [ { "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": "",

12

"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": [ { "url": "http://www.trendyol.com/ProductImages/107621/big/101a02089_ekru.jpg" }, { "url": "http://www.trendyol.com/ProductImages/107621/big/101a02089_ekru-1.jpg" }, { "url": "http://www.trendyol.com/ProductImages/107621/big/101a02089_ekru-2.jpg" }, { "url": "http://www.trendyol.com/ProductImages/107621/big/101a02089_ekru-3.jpg" } ], "attributes": [ {} ], "variantAttributes": [ { "attributeName": "Renk", "attributeValue": "Ekru" }, { "attributeName": "Beden", "attributeValue": "STD" } ] } ] }

Ü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

13

{ "items": [ { "barcode": "BARKODSTRING", "quantity": 12, "salePrice": 69.90 } ] }

DÖNÜŞ – HTTP 200

{ " "batchRequestId": "1541ee80-93ee-40b9-b8e5-b827458968cd" }

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ÜŞ

{ "batchRequestId": "b63b62f5-8190-4c48-8964-42c4b5738ba0", "items": [ { "requestItem": { "product": { "brand": "TrendyolMilla", "barcode": "1122334455667", "title": "TrendyolBluz", "description": "Açıklama", "categoryName": "Üst Giyim", "listPrice": 299.9, "salePrice": 209.9,

14

"currencyType": "TRY", "vatRate": 18, "cargoCompany": "YK", "quantity": 5, "stockCode": "a11b2c3d4", "images": [ { "url": "\"https://sitecontent.com/wp-content/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}/suppliers/{supplierId}/orders

DÖNÜŞ

{ "size": 50, "totalPages": 1, "page": 0, "content": [{ "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" },

15

"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": 2, "cargoTrackingNumber": null, "lines": [{ "quantity": 2, "productId": 37311, "salesCampaignId": 15, "productSize": "M", "productName": "Awesome Concrete Tuna", "productCode": 121635, "merchantId": 1024, "price": 931.0, "productColor": "#7a184e", "id": 1, "sku": "182163", "vatBaseAmount": 14.0, "barcode": "5502805140", "orderLineItemStatusName": "Cancelled" }, { "quantity": 1, "productId": 168855, "salesCampaignId": 15, "productSize": "M", "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", "productName": "Unbranded Concrete Pants", "productCode": 94022, "merchantId": 1024, "price": 167.0, "productColor": "#7d4f4a", "id": 3, "sku": "119189", "vatBaseAmount": 17.0,

16

"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", "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",

17

"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, "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, "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": {

18

"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, "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, "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,

19

"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", "productName": "Intelligent Frozen Table", "productCode": 17583, "merchantId": 1024, "price": 289.0, "productColor": "#0c0d76", "id": 57, "sku": "47178", "vatBaseAmount": 14.0, "barcode": "11940273720",

20

"orderLineItemStatusName": "ReadyToShip" }, { "quantity": 3, "productId": 165706, "salesCampaignId": 15, "productSize": "M", "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.

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

{ "lines": [ { "lineId": 0,

21

"quantity": 0 } ], "params": { "invoiceNumber" :"FTRNUMBER53253434" }, "status": "Invoiced" }

DÖNÜŞ – HTTP 200

NO CONTENT

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

{ "lines": [ { "lineId": 1, "quantity": 1 } ], "params": {}, "status": "Unsupplied" }

DÖNÜŞ – HTTP 200

NO CONTENT

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.

22

Bu sebeple Orders method çağırılarak yeni oluşan id değerine göre paket operasyonları yapılmalıdır.