Sipariş Paketlerini Çekme

Sipariş Paketlerini Çekme

Siparişin paket bilgileri Trendyol sisteminden alınırken bu metod kullanılmaktadır.

20 Temmuz 2022 tarihinden itibaren sipariş paketlerini çekme servisinde dönen "id" (packageId) değeri 64 karakter alfa numeric olarak dönecektir. Sipariş akışlarınızın etkilenmemesi için sisteminizi buna uygun hale getirmeniz gerekmektedir. İlgili geliştirme stage ortamında aktif durumdadır, aşağıda yer alan örnek response içerisinde de örnek olarak gösterilmiştir.

30 Haziran 2022 tarihinden itibaren Sipariş Paketlerini çekme servisinden Model 2 (trendyol kuryesi ile teslimat yapan satıcılar) için "address" alanı altındaki fieldlar boş ( null ) dönecektir. Örnek response aşağıda belirtilmiştir. ( Model 2 için örnek response )

lines altındaki lineItemId değerlerinin sayısını alarak sipariş içerisinde kaç adet ürün olduğunu tespit edebilirsiniz.

[GET] https://api.trendyol.com/mealgw/suppliers/{supplierid}/packages

[GET] https://api.trendyol.com/mealgw/suppliers/{supplierid}/packages/{packageId}

Header Parametreleri

Parametre Açıklama Tip Zorunluluk
x-agentname Entegratör ismi string Evet
x-executor-user İşlemi yapan kişinin email bilgisi string Evet

Giriş Parametreleri

Parametre Açıklama Tip Zorunluluk
supplierId Restaurant zincir id int Evet
storeId Restauran şube id string Hayır
packageStatuses Paket statüsü (Created, Picking, Invoiced, Cancelled, Unsupplied, Shipped, Delivered) string Hayır
packageModificationStartDate Paket güncelleme başlangıç zamanı (Epoch timestamp milliseconds) int Hayır
packageModificationEndDate Paket güncelleme bitiş zamanı (Epoch timestamp milliseconds) int Hayır
page Sadece belirtilen sayfadaki bilgileri döndürür. int Hayır
size Bir sayfada listelenecek maksimum adeti belirtir. (Maksimum 50 değerini alabilir) int Hayır

Model 1 için örnek response :

{
    "page": 0,
    "size": 50,
    "totalPages": 1,
    "totalCount": 1,
    "content": [
              {
            "id": "1000000023261", // Picking, Invoiced, Unsupplied servisinde kullanılacak "packageId" 
            // 20 Temmuzdan itibaren "id":"3df7ae0ef629c6661ac0c4c7bce0d41a2c7666009814645df120a77679c36677" şeklinde dönecektir.
            "supplierId": 107385,
            "storeId": 330,
            "orderCode": "007",
            "orderId": "1000000017209",
            "orderNumber": "1221047877",
            "packageCreationDate": 1631014650126,
            "packageModificationDate": 1631015071040,
            "preparationTime": 0,
            "totalPrice": 40.99,
            "callCenterPhone": "0850 241 9090",
            "deliveryType": "GO", // Restoran kuryesiyle çalışan satıcılar için "STORE" dönecektir.
            "customer": {
                "id": 25039720,
                "firstName": "Ahmet",
                "lastName": "Y"
            },
            "address": {
                "firstName": "Ahmet",
                "lastName": "Yılmaz",
                "company": "",
                "address1": "Cumhuriyet Mahallesi Selimiye Caddesi",
                "address2": "On Kasım Sokak",
                "city": "İstanbul",
                "cityCode": 34,
                "cityId": 133,
                "district": "Adalar",
                "districtId": 33,
                "neighborhoodId": 21734,
                "neighborhood": "Burgazada Mah",
                "apartmentNumber": "9",
                "floor": "2",
                "doorNumber": "2",
                "addressDescription": "2",
                "postalCode": "34000",
                "countryCode": "TR",
                "latitude": "41.00432",
                "longitude": "29.091809",
                "phone": "5555555555"
            },
            "packageStatus": "Created",
            "lines": [
                {
                    "price": 34.99,
                    "unitSellingPrice": 40.99,
                    "productId": 161162,
                    "name": "İkili Hamburger Menü",
                    "items": [
                        {
                            "packageItemId": "1000000021680", // Unsupplied servisinde kullanılacak 
                            "lineItemId": 1000000069963,
                            "isCancelled": false,
                            "promotions": [
                            {
                             "promotionId": 1949565,
                             "discountType": "INSTANT_DISCOUNT", // İndirim tipi
                             "sellerCoverageRatio": 0.0, // Satıcı tarafından karşılanan oran
                             "amount": {
                             "seller": 0.0 // Satıcı tarafından karşılanan tutar
                              }
                             }
                            ],
                             "coupons": [
                             {
                              "couponId": "f61369c8-55fa-4d42-ad20-2c71e6b3646d",
                              "sellerCoverageRatio": 0.0, // Satıcı tarafından karşılanan oran
                              "amount": { 
                              "seller": 0.0 // Satıcı tarafından karşılanan tutar
                               }
                              }
                             ]
                        }
                    ],

                    "modifierProducts": [
                        {
                            "name": "Et Burger",
                            "price": 0.0,
                            "productId": 161167,
                            "modifierGroupId": 19900,
                            "modifierProducts": [
                                {
                                    "name": "3 Ekstra Peynir",
                                    "price": 6.0,
                                    "productId": 161463,
                                    "modifierGroupId": 19926,
                                    "modifierProducts": [],
                                    "extraIngredients": [],
                                    "removedIngredients": []
                                }
                            ],
                            "extraIngredients": [
                                {
                                    "id": 25720,
                                    "name": "Domates",
                                    "price": 0.0
                                }
                            ],
                            "removedIngredients": [
                                {
                                    "id": 25730,
                                    "name": "Soğan"
                                }
                            ]
                        },
                        {
                            "name": "Tavuk Burger",
                            "price": 0.0,
                            "productId": 160933,
                            "modifierGroupId": 19899,
                            "modifierProducts": [
                                {
                                    "name": "60 gr.",
                                    "price": 0.0,
                                    "productId": 789,
                                    "modifierGroupId": 212,
                                    "modifierProducts": [],
                                    "extraIngredients": [],
                                    "removedIngredients": []
                                }
                            ],
                            "extraIngredients": [
                                {
                                    "id": 25728,
                                    "name": "Tursu",
                                    "price": 0.0
                                }
                            ],
                            "removedIngredients": [
                                {
                                    "id": 25721,
                                    "name": "Göbek Salata"
                                }
                            ]
                        },
                        {
                            "name": "Patates Kızartması (Büyük Boy)",
                            "price": 0.0,
                            "productId": 160946,
                            "modifierGroupId": 19852,
                            "modifierProducts": [
                                {
                                    "name": "Acı Sos",
                                    "price": 0.0,
                                    "productId": 160973,
                                    "modifierGroupId": 19949,
                                    "modifierProducts": [],
                                    "extraIngredients": [],
                                    "removedIngredients": []
                                }
                            ],
                            "extraIngredients": [],
                            "removedIngredients": []
                        }
                    ],
                    "extraIngredients": [],
                    "removedIngredients": []
                }
            ],
            "customerNote": "",
            "lastModifiedDate": 1631015072000,
            "isCourierNearby": false,
            "cancelInfo": {
                "reasonCode": 625
            },
            "eta": "32 - 47 dk"
        }
    ]
  }
  

Model 2 için örnek response

{
    "page": 0,
    "size": 50,
    "totalPages": 1,
    "totalCount": 1,
    "content": [
              {
            "id": "1000000023261", // Picking, Invoiced, Unsupplied servisinde kullanılacak "packageId" // 
             // 20 Temmuzdan itibaren "id":"3df7ae0ef629c6661ac0c4c7bce0d41a2c7666009814645df120a77679c36677" şeklinde dönecektir.
            "supplierId": 107385,
            "storeId": 330,
            "orderCode": "007",
            "orderId": "1000000017209",
            "orderNumber": "1221047877",
            "packageCreationDate": 1631014650126,
            "packageModificationDate": 1631015071040,
            "preparationTime": 0,
            "totalPrice": 40.99,
            "callCenterPhone": "0850 241 9090",
            "deliveryType": "GO", // Restoran kuryesiyle çalışan satıcılar için "STORE" dönecektir.
            "customer": {
                "id": 25039720,
                "firstName": "Ahmet",
                "lastName": "Y"
            },
            "address": {
                "firstName": "Ahmet",
                "lastName": "Yılmaz",
                "company": null,
                "address1": null,
                "address2": null,
                "city": null,
                "cityCode": null,
                "cityId": null,
                "district": null,
                "districtId": null,
                "neighborhoodId": null,
                "neighborhood": null,
                "apartmentNumber": null,
                "floor": null,
                "doorNumber": null,
                "addressDescription": null,
                "postalCode": null,
                "countryCode": null,
                "latitude": null,
                "longitude": null,
                "phone": "5555555555"
            },
            "packageStatus": "Created",
            "lines": [
                {
                    "price": 34.99,
                    "unitSellingPrice": 40.99,
                    "productId": 161162,
                    "name": "İkili Hamburger Menü",
                    "items": [
                        {
                            "packageItemId": "1000000021680", // Unsupplied servisinde kullanılacak 
                            "lineItemId": 1000000069963,
                            "isCancelled": false,
                            "promotions": [
                            {
                             "promotionId": 1949565,
                             "discountType": "INSTANT_DISCOUNT", // İndirim tipi
                             "sellerCoverageRatio": 0.0, // Satıcı tarafından karşılanan oran
                             "amount": {
                             "seller": 0.0 // Satıcı tarafından karşılanan tutar
                              }
                             }
                            ],
                             "coupons": [
                             {
                              "couponId": "f61369c8-55fa-4d42-ad20-2c71e6b3646d",
                              "sellerCoverageRatio": 0.0, // Satıcı tarafından karşılanan oran
                              "amount": { 
                              "seller": 0.0 // Satıcı tarafından karşılanan tutar
                               }
                              }
                             ]
                        }
                    ],

                    "modifierProducts": [
                        {
                            "name": "Et Burger",
                            "price": 0.0,
                            "productId": 161167,
                            "modifierGroupId": 19900,
                            "modifierProducts": [
                                {
                                    "name": "3 Ekstra Peynir",
                                    "price": 6.0,
                                    "productId": 161463,
                                    "modifierGroupId": 19926,
                                    "modifierProducts": [],
                                    "extraIngredients": [],
                                    "removedIngredients": []
                                }
                            ],
                            "extraIngredients": [
                                {
                                    "id": 25720,
                                    "name": "Domates",
                                    "price": 0.0
                                }
                            ],
                            "removedIngredients": [
                                {
                                    "id": 25730,
                                    "name": "Soğan"
                                }
                            ]
                        },
                        {
                            "name": "Tavuk Burger",
                            "price": 0.0,
                            "productId": 160933,
                            "modifierGroupId": 19899,
                            "modifierProducts": [
                                {
                                    "name": "60 gr.",
                                    "price": 0.0,
                                    "productId": 789,
                                    "modifierGroupId": 212,
                                    "modifierProducts": [],
                                    "extraIngredients": [],
                                    "removedIngredients": []
                                }
                            ],
                            "extraIngredients": [
                                {
                                    "id": 25728,
                                    "name": "Tursu",
                                    "price": 0.0
                                }
                            ],
                            "removedIngredients": [
                                {
                                    "id": 25721,
                                    "name": "Göbek Salata"
                                }
                            ]
                        },
                        {
                            "name": "Patates Kızartması (Büyük Boy)",
                            "price": 0.0,
                            "productId": 160946,
                            "modifierGroupId": 19852,
                            "modifierProducts": [
                                {
                                    "name": "Acı Sos",
                                    "price": 0.0,
                                    "productId": 160973,
                                    "modifierGroupId": 19949,
                                    "modifierProducts": [],
                                    "extraIngredients": [],
                                    "removedIngredients": []
                                }
                            ],
                            "extraIngredients": [],
                            "removedIngredients": []
                        }
                    ],
                    "extraIngredients": [],
                    "removedIngredients": []
                }
            ],
            "customerNote": "",
            "lastModifiedDate": 1631015072000,
            "isCourierNearby": false,
            "cancelInfo": {
                "reasonCode": 625
            },
            "eta": "32 - 47 dk"
        }
    ]
  }
  
Status Code Açıklama
200 Gönderilen istek başarılı olmuştur. Paketleri response'da bulabilirsiniz.
400 İstek içerisinde eksik veya hatalı paremetre kullanılmaktadır. Dokümanı tekrar inceleyiniz.
401 İstek gönderirken kullandığınız supplierID, API Key, API Secure Key bilgilerinden birisi eksik ya da yanlıştır. Mağazanız için doğru bilgilere Trendyol Satıcı Paneli üzerinden ulaşabilirsiniz.
5xx Anlık bir hata yaşanmış olabilir. Bir kaç dakika bekleyerek durumun düzelmemesi durumunda kullanılan endpoint, gönderilen istek ve cevap ile beraber "API Entegrasyon Destek Talebi" başlığından talep oluşturunuz.