Askıdaki Sipariş Paketlerini Çekme (getShipmentPackages)
Ödeme güvenliğinden geçmekte olan ve kargo firmasından kargo bilgisi beklenen siparişlerinizi, bu method yardımıyla alabilirsiniz.Sistem tarafından ödeme kontrolünden ve kargo bilgileri tamamlandıktan sonra otomatik paketlenerek sipariş paketleri oluşturulur.
- Awaiting statüsündeki siparişleri sadece stok kontrolleriniz için kullanabilirsiniz.
- Ödeme kontrolünden geçen siparişler artık Created statüsünde sizlere dönecektir.
- Ödeme kontrolünden geçmeyen siparişler ise Cancelled statüsünde sizlere dönecektir.
GET getShipmentPackages
Servis Parametreleri
| Parametre | Parametre Değer | Açıklama | Tip |
|---|---|---|---|
| startDate | Belirli bir tarihten sonraki siparişleri getirir. Timestamp olarak gönderilmelidir. | long | |
| endDate | Belirtilen tarihe kadar olan siparişleri getirir. Timestamp olarak gönderilmelidir. | long | |
| page | Sadece belirtilen sayfadaki bilgileri döndürür | int | |
| size | Maksimum 200 | Bir sayfada listelenecek maksimum adeti belirtir. | int |
| supplierId | İlgili tedarikçinin ID bilgisi gönderilmelidir | long | |
| orderNumber | Sadece belirli bir sipariş numarası verilerek o siparişin bilgilerini getirir | string | |
| orderByField | LastModifiedDate | Son güncellenme tarihini baz alır. | string |
| orderByField | CreatedDate | Siparişin oluşma tarihini baz alır | string |
| orderByDirection | ASC | Eskiden yeniye doğru sıralar. | string |
| orderByDirection | DESC | Yeniden eskiye doğru sıralar. | string |
| shipmentPackagesId | Paket numarasıyla sorgu atılır. | long |
Sipariş Statüleri
| Statü | Açıklama |
|---|---|
| orderDate | Müşterinin trendyol.com üzerinde siparişi oluşturduğu zaman dönmektedir. |
| Awaiting | Müşterinin trendyol.com üzerinde siparişi oluşturduktan sonra ödeme onayından bekleyen siparişler için bu statü dönmektedir. (Bu statüdeki siparişler "Created" statüsüne geçene kadar herhangi bir işlem yapmamanız gerekmektedir. Sadece stok güncellemeleri için bu statüyü kullanabilirsiniz.) |
Örnek Servis Cevabı
{
"totalElements": 1,
"totalPages": 1,
"page": 0,
"size": 1,
"content": [
{
"shipmentAddress": {
"id": 11111111,
"firstName": "Trendyol",
"lastName": "Customer",
"company": "",
"address1": "DSM Grup Danışmanlık İletişim ve Satış Ticaret A.Ş. Maslak Mahallesi Saat Sokak Spine Tower No:5 İç Kapı No:19 Sarıyer/İstanbul",
"address2": "",
"city": "İstanbul",
"cityCode": 34,
"district": "Sarıyer",
"districtId": 54,
"countyId": 0, // CEE bölgesi için gelecektir.
"countyName": "", // CEE bölgesi için gelecektir.
"shortAddress": "", // GULF bölgesi için gelecektir.
"stateName": "", // GULF bölgesi için gelecektir.
"addressLines": {
"addressLine1": "",
"addressLine2": ""
},
"postalCode": "34200",
"countryCode": "TR",
"neighborhoodId": 21111,
"neighborhood": "Maslak Mahallesi",
"phone": null,
"fullAddress": "DSM Grup Danışmanlık İletişim ve Satış Ticaret A.Ş. Maslak Mahallesi Saat Sokak Spine Tower No:5 İç Kapı No:19 Sarıyer/İstanbul",
"fullName": "Trendyol Customer"
},
"orderNumber": "10654411111",
"packageGrossAmount": 498.90, // Paketin toplam brüt tutarı (indirimsiz)
"packageSellerDiscount": 0.00, // Satıcı indirim tutarı
"packageTyDiscount": 0.00, // commercial true olduğu durumda dolu gelebilir, false olduğu durumda 0 dönecektir.
"packageTotalDiscount": 0.00, // Toplam indirim tutarı (packageSellerDiscount + packageTyDiscount)
"discountDisplays": [
{
"displayName": "Sepette %20 İndirim",
"discountAmount": 100
}
],
"taxNumber": null,
"invoiceAddress": {
"id": 11111112,
"firstName": "Trendyol",
"lastName": "Customer",
"company": "", // GULF bölgesi siparişlerinde boş gelebilir.
"address1": "DSM Grup Danışmanlık İletişim ve Satış Ticaret A.Ş. Maslak Mahallesi Saat Sokak Spine Tower No:5 İç Kapı No:19 Sarıyer/İstanbul",
"address2": "",
"city": "İstanbul",
"cityCode": 0,
"district": "Sarıyer", // GULF bölgesi siparişlerinde boş gelebilir.
"districtId": 54,
"countyId": 0, // CEE bölgesi için gelecektir.
"countyName": "", // CEE bölgesi için gelecektir.
"shortAddress": "", // GULF bölgesi için gelecektir.
"stateName": "", // GULF bölgesi için gelecektir.
"addressLines": {
"addressLine1": "",
"addressLine2": ""
},
"postalCode": "", // GULF bölgesi siparişlerinde boş gelebilir.
"countryCode": "TR",
"neighborhoodId": 0,
"phone": null,
"latitude": "11.111111",
"longitude": "22.222222",
"fullAddress": "DSM Grup Danışmanlık İletişim ve Satış Ticaret A.Ş. Maslak Mahallesi Saat Sokak Spine Tower No:5 İç Kapı No:19 Sarıyer/İstanbul",
"fullName": "Trendyol Customer",
"taxOffice": "Company of OMS's Tax Office", // Kurumsal fatura olmadığı durumda (commercial=false ise) body içerisinde dönmeyecektir.
"taxNumber": "Company of OMS's Tax Number" // Kurumsal fatura olmadığı durumda (commercial=false ise) body içerisinde dönmeyecektir.
},
"customerFirstName": "Trendyol",
"customerEmail": "[email protected]",
"customerId": 1451111111,
"supplierId": 2738,
"customerLastName": "Customer",
"shipmentPackageId": 3330111111, // Paket ID'si
"cargoTrackingNumber": 7280027504111111,
"cargoTrackingLink": "https://tracking.trendyol.com/?id=111111111-1111-1111-1111-11111111",
"cargoSenderNumber": "210090111111",
"cargoProviderName": "Trendyol Express",
"lines": [
{
"quantity": 1,
"salesCampaignId": 11,
"productSize": "Tek Ebat",
"stockCode": "111111", // Satıcı stok kodu
"productName": "Kuş ve Çiçek Desenli Tepsi - Yeşil / Altın Sarısı - 49 cm, 01SYM134, Tek Ebat",
"contentId": 1239111111,
"productOrigin": "TR",
"sellerId": 2738, // Satıcı ID'si
"lineGrossAmount": 498.90, // Ürünün birim brüt fiyatı (indirimsiz)
"lineTotalDiscount": 0.00, // Birim toplam indirim (lineSellerDiscount + lineTyDiscount)
"lineSellerDiscount": 0.00, // Birim satıcı indirimi (item'ların ortalaması)
"lineTyDiscount": 0.00, // Birim Trendyol indirimi (item'ların ortalaması)
"discountDetails": [ // Her bir adet (item) için ayrı indirim detayı
{
"lineItemPrice": 498.90, // İndirimli birim fiyat (lineGrossAmount - lineItemSellerDiscount - lineItemTyDiscount)
"lineItemSellerDiscount": 0.00, // Bu item'a uygulanan satıcı indirimi
"lineItemTyDiscount": 0.00 // Bu item'a uygulanan Trendyol indirimi
}
],
"currencyCode": "TRY",
"productColor": "Yeşil",
"lineId": 4765111111, // Sipariş satır ID'si
"vatRate": 20.00, // KDV oranı
"barcode": "8683772071724",
"orderLineItemStatusName": "Delivered",
"lineUnitPrice": 498.90, // Net birim fiyat (lineGrossAmount - lineSellerDiscount - lineTyDiscount)
"fastDeliveryOptions": [],
"productCategoryId": 2710,
"commission": 13, // Komisyon oranı
"businessUnit": "Sports Shoes",
"cancelledBy": "", // İptal eden taraf
"cancelReason": "", // İptal nedeni
"cancelReasonCode": 0 // İptal neden kodu
}
],
"orderDate": 1762253333685,
"identityNumber": "11111111111",
"currencyCode": "TRY",
"packageHistories": [
{
"createdDate": 1762242537624,
"status": "Created"
}
],
"shipmentPackageStatus": "Delivered",
"status": "Delivered",
"whoPays": 1, // Eğer satıcı anlaşması ise 1 gelir, trendyol anlaşması ise alan gelmez
"deliveryType": "normal",
"timeSlotId": 0,
"estimatedDeliveryStartDate": 1762858136000,
"estimatedDeliveryEndDate": 1763030936000,
"packageTotalPrice": 498.90, // Paketin toplam net fiyatı (indirimli)
"deliveryAddressType": "Shipment",
"agreedDeliveryDate": 1762376340000,
"fastDelivery": false,
"originShipmentDate": 1762242537619,
"lastModifiedDate": 1762865408581,
"commercial": false,
"fastDeliveryType": "",
"deliveredByService": false,
"warehouseId": 372389,
"invoiceLink": "https://efatura01.evidea.com/11111111111",
"micro": true,
"giftBoxRequested": false,
"3pByTrendyol": false,
"etgbNo": "25341453EX025864", // micro true olduğunda etgbNo alanı için bilgi dönecektir.
"etgbDate": 1762646400000, // micro true olduğunda etgbDate alanı için bilgi dönecektir.
"containsDangerousProduct": false, // micro ihracat siparişlerinde satıcıya gelen siparişte paket içerisinde herhangi bir tehlikeli ürün varsa pil, parfüm vb. gibi, true dönecektir.
"cargoDeci": 10,
"isCod": false,
"createdBy": "order-creation", // Paketin nasıl oluşturulduğunu gösterir, "order-creation", "split", "cancel" veya "transfer" olabilir
"originPackageIds": null, // Bu alan iptal veya bölme işlemlerinden sonra doldurulur ve bu işlemlerden sonra ilk paketin packageid'sini verir.
"hsCode": "711111000000", // Bu alan mikro siparişler için string olarak dönecektir.
"shipmentNumber": 606404425
}
]
}
Updated 7 days ago