TreeWin Sipariş REST Servisleri
Sipariş Listeleme
Verilen parametrelere göre siparişleri sayfalamalı olarak listeler. Sipariş tarihi aralığı (startDate / endDate), orderId, orderNo parametrelerden en az biri gönderilmelidir.
Örnek Request
{
"endDate": "01/02/2025 10:30",
"insertDateEnd": "01/02/2025 10:30",
"insertDateStart": "01/01/2025 10:30",
"orderId": 123456789,
"orderNo": "SIP20250109",
"page": 0,
"pageSize": 200,
"startDate": "01/01/2025 10:30",
"updateDateEnd": "01/02/2025 10:30",
"updateDateStart": "01/01/2025 10:30"
}
Örnek Response
{
"code": "1",
"message": "Siparişler başarıyla getirildi.",
"orderList": [
{
"orderId": "123456789",
"orderNo": "SIP20250109",
"orderDate": 1753056000000,
"status": "APPROVED",
"customerFullName": "Ali Veli",
"customerTc": "11111111111",
"customerVkn": null,
"customerPhone": "05000000000",
"customerMail": "mail@example.com",
"shippingFullName": "Ali Veli",
"shippingCountry": "Türkiye",
"shippingCity": "Ankara",
"shippingDistrict": "Çankaya",
"shippingAddress": "123. Sokak No:4 Kat:5",
"shippingPhone": "05000000000",
"shippingMail": "mail@example.com",
"shippingNote": null,
"billingFullName": "Ali Veli",
"billingCountry": "Türkiye",
"billingCity": "Ankara",
"billingDistrict": "Çankaya",
"billingAddress": "123. Sokak No:4 Kat:5",
"billingPhone": "05000000000",
"billingMail": "mail@example.com",
"billingTc": "11111111111",
"billingVkn": "1111111111",
"billingTaxOffice": "Çankaya Vergi Dairesi",
"shippingAmount": 0,
"extraAmount": 0,
"totalAmount": 0,
"installmentAmount": 0,
"cargoCompanyId": "99",
"paymentTypeId": 4,
"installment": 0,
"paymentProvider": "Garanti Bankası",
"cargoCode": "AB123456789",
"cargoTrackingCode": "AB123456789",
"companyVendorNumber": null,
"items": [
{
"itemId": "ITEM123456789",
"sku": "SKU-00123",
"siteSku": "SITESKU98765",
"barcode": "8691234567890",
"groupCode": "GRP-01",
"title": "Kırmızı Kadın Tişört",
"brand": "Marka",
"variantText": "Beden: M, Renk: Kırmızı",
"quantity": 0,
"price": 0,
"totalAmount": 0,
"discountAmount": 0,
"totalAmountWithVat": 0,
"vatRate": 0,
"vatAmount": 0,
"finalTotalAmountWithVat": 0,
"status": "NEW_ORDER"
}
],
"invoiceUrl": "https://example.com/invoice/ORD123456789",
"webSite": "https://www.ornekpazaryeri.com"
}
]
}
Sipariş Kaydetme / Güncelleme
Bu servis, sipariş listesini sisteme kaydetmek veya mevcut siparişleri güncellemek için kullanılır. Aynı orderId veya orderNo ile gelen sipariş sistemde varsa güncellenir, yoksa yeni olarak eklenir. İşlem sonucu dönen trackingId ile siparişin başarılı bir şekilde kaydedilip kaydedilmediği kontrol edilmelidir.
Örnek Request
[
{
"billingAddress": "123. Sokak No:4 Kat:5",
"billingCity": "Ankara",
"billingCountry": "Türkiye",
"billingDistrict": "Çankaya",
"billingFullName": "Ali Veli",
"billingMail": "mail@example.com",
"billingPhone": "05000000000",
"billingTaxOffice": "Çankaya Vergi Dairesi",
"billingTc": 11111111111,
"billingVkn": 1111111111,
"cargoCode": "AB123456789",
"cargoCompanyId": 99,
"cargoTrackingCode": "AB123456789",
"companyVendorNumber": "00",
"customerFullName": "Ali Veli",
"customerMail": "mail@example.com",
"customerPhone": "05000000000",
"customerTc": 11111111111,
"customerVkn": 1111111111,
"extraAmount": 0,
"installment": 0,
"installmentAmount": 0,
"invoiceUrl": "https://example.com/invoice/ORD123456789",
"items": [
{
"barcode": 8691234567890,
"brand": "Marka",
"discountAmount": 0,
"finalTotalAmountWithVat": 0,
"groupCode": "GRP-01",
"itemId": "ITEM123456789",
"price": 0,
"quantity": 0,
"siteSku": "SITESKU98765",
"sku": "SKU-00123",
"status": 2,
"title": "Kırmızı Kadın Tişört",
"totalAmount": 0,
"totalAmountWithVat": 0,
"variantText": "Beden: M, Renk: Kırmızı",
"vatAmount": 0,
"vatRate": 0
}
],
"orderDate": "2025-07-17T15:03:40.145Z",
"orderId": 123456789,
"orderNo": "SIP20250716",
"paymentProvider": "Garanti Bankası",
"paymentTypeId": 4,
"shippingAddress": "123. Sokak No:4 Kat:5",
"shippingAmount": 0,
"shippingCity": "Ankara",
"shippingCountry": "Türkiye",
"shippingDistrict": "Çankaya",
"shippingFullName": "Ali Veli",
"shippingMail": "mail@example.com",
"shippingNote": "Lütfen kapıya dikkatli bırakın",
"shippingPhone": "05000000000",
"status": 2,
"totalAmount": 0,
"webSite": "https://www.ornekpazaryeri.com"
}
]
Örnek Response
{
"code": "1",
"message": "Sipariş kaydetme işlemi başlatıldı.",
"trackingId": 12345678,
"resultType": {
"id": "1",
"desc": "Siparişler alındı ve kaydetme işlemi başladı, işlem durumunu trackingId ile takip edebilirsiniz."
}
}
Sipariş Kaydetme Durum Kontrol
Bu servis, daha önce kaydedilen sipariş listesinin durumunu kontrol eder. İlgili trackingId (yani trackRetriveId) kullanılarak işlem sonucu sorgulanır. Eğer işlem tamamlandıysa, siparişlerin durum bilgileri liste olarak döner.
Örnek Request
12345678
Örnek Response
{
"code": "1",
"message": "Siparişler başarı ile kaydedildi.",
"responseList": [
{
"orderNo": "123456789",
"orderId": "SIP20250716",
"items": [],
"message": "Sipariş eklendi.",
"resultType": {
"id": "1",
"desc": "Başarılı"
}
}
],
"resultType": {
"id": "3",
"desc": "Siparişler başarı ile kaydedildi"
}
}