Sipariş Sorgulama V2
GET
https://marketplace-stg.modanisa.com/api/marketplace/orderListV2
| Parametre | Açıklama | Veri Tipi | Zorunlu |
|---|---|---|---|
| startDateTime | Sipariş oluşma tarihi (başlangıç) | Datetime (Y-m-d H:i:s) | Evet |
| endDateTime | Sipariş oluşma tarihi (bitiş) | Datetime (Y-m-d H:i:s) | Evet |
| paymentStatus | Sipariş ödeme durumu | - approved (onaylanan) - pending (onay bekleyen) - rejected (iptal edilen) |
Hayır |
| dateType | Sipariş tarih tipi | - order (Sipariş oluşma tarihine göre) - payment (Sipariş ödeme tarihine göre) |
Hayır |
| orderId | Sipariş numara bilgisi | integer | Hayır |
| page | Hangi sayfadaki siparişlerin getirileceği bilgisi | integer | Evet |
| size | Bir sayfada kaç adet siparişin getireleceği bilgisi | integer | Evet |
| sort | Siparişlerin tarihe göre sıralanma bilgisi | - ASC (eskiden yeniye) - DESC (yeniden eskiye) |
Hayır |
paymentStatus Açıklamaları:
- approved: Siparişe ait ödeme başarıyla alınmış olup, sipariş altındaki ürünlerden durumu "pending" olarak işaretlenen ürünlerin gönderilmesi gerekmektedir.
- pending: Sipariş ödeme onayı bekliyor. Bu durumda olan sipairşlerin durumları "approved" veya "rejected" olana kadar sorgulanması gerekiyor.
- rejected: Siparişe ait ödeme alınamamış, sipariş iptal edilmiştir.
dateType Açıklamaları:
- order : Sipariş tarihine göre sorgulama yapılıyorsa ödeme onayı gelene kadar siparişteki ürünü rezerve etmeniz beklenir böylece ödeme onayı ile sipariş kesinleştiğinde stock out olma durumu önlenmiş olur. Bu durumda birkaç dakikada bir son 48 saat için sorgulama yapılmalıdır.
- payment: Ödeme tarihine göre sorgulama yapıldığında sadece ödemesi kesinleşmiş siparişlerden haberdar olunup ürün rezerve edilir. Bu durumda birkaç dakikada bir son 48 saat için sorgulama yapılmalıdır.
Sipariş sorgulama servisine iki şekilde istekte bulunabilirsiniz.
1- Request ( raw body ):
{
"startDateTime": "2020-08-10 00:00:00",
"endDateTime": "2020-08-17 00:00:00",
"page": "1",
"size": "100"
}
2- Request ( url parameter ):
/orderList?startDateTime=2019-06-29T00:00:00&endDateTime=2019-06-30T23:59:59
Response:
{
"success": true,
"message": "success",
"status_code": 200,
"data": {
"dateTimeRange": {
"startDateTime": "2020-08-10 00:00:00",
"endDateTime": "2020-08-17 00:00:00"
},
"orders": {
"totalCount": 2,
"details": [
{
"orderId": "612348912365",
"paymentStatus": "approved",
"date": "2020-08-12 16:03:43",
"products": [
{
"productName": "Beyaz Tunik",
"productId": "12345-Beyaz",
"variantId": "645234",
"categoryId": "64523",
"brandId": "64522",
"modanisaProductId": "97654",
"modanisaVariantId": "765543",
"modanisaOrderProductId" : "2234765543",
"price": "48.993",
"quantity": 1,
"barcode": "1BARCODE1",
"alternative_barcode": "8682446256221",
"currency": "TRY",
"status": "Pending",
"optionNane": "38 Numara",
"optionId": "440",
"colorName": "Kırmızı",
"colorId": "849"
}
]
},
{
"orderId": "4912304983",
"paymentStatus": "pending",
"date": "2020-08-12 19:45:31",
"products": [
{
"productName": "Kırmızı Tunik",
"productId": "12345-Kırmızı",
"variantId": "13252",
"categoryId": "64523",
"brandId": "64522",
"modanisaProductId": "6543123",
"modanisaVariantId": "345346",
"modanisaOrderProductId" : "2234765544",
"price": "27.993",
"quantity": 1,
"barcode": "123BARCODE123",
"alternative_barcode": null,
"currency": "TRY",
"status": "Completed",
"optionNane": "40 Numara",
"optionId": "442",
"colorName": "Kırmızı",
"colorId": "849"
}
]
},
{
"orderId": "4912304983",
"paymentStatus": "rejected",
"date": "2020-098-12 19:45:31",
"products": [
{
"productName": "Çizgili Tunik",
"productId": "12345-Yeşil",
"variantId": "132521",
"categoryId": "64523",
"brandId": "64522",
"modanisaProductId": "65423123",
"modanisaVariantId": "3453346",
"modanisaOrderProductId" : "22334765544",
"price": "127.993",
"quantity": 1,
"barcode": "123BARCODEWE3",
"alternative_barcode": null,
"currency": "TRY",
"status": "Completed",
"optionNane": "42 Numara",
"optionId": "443",
"colorName": "Kırmızı",
"colorId": "849"
}
]
}
]
},
"pagination": {
"page": 1.0,
"totalPage": 1.0,
"count": 2.0,
"limit": 100.0
},
"companyInfo": {
"name": "MODANİSA ELEKTRONİK MAĞAZACILIK ve TİC A.Ş.",
"address": "Tepeören Mahallesi, Eski Ankara Asfaltı Cd. No:177",
"district": "Tuzla",
"city": "İstanbul",
"zip": "34959",
"email": "tedarik@modanisa.com",
"phoneNumber": "+902164747473",
"invoiceInfo": {
"address": "Altunizade Mahallesi Kuşbakışı Caddesi No:27/1",
"district": "Üsküdar",
"city": "İstanbul",
"zip": "34662",
"phoneNumber": "+902164747473",
"taxAdministration": "Üsküdar",
"taxNumber": "6220586224"
}
}
}
}