Genel Bakış
Douwebsoft API Entegrasyonu, Douwebsoft'a katılan firmaların Douwebsoft API servisleri aracılığıyla Douwebsoft mağazalarını kendi e-ticaret sistemlerine bağlayarak ürün aktarımı, stok ve fiyat güncellemesi, sipariş işlemleri gibi bir çok işlemi yapmasına olanak sağlar.
Görüş ve Sorunlarınız için info@douwebsoft.com adresinden bizlere ulaşabilirsiniz.
Test Url :
https://stageapi.douwebsoft.com
Canlı Url :
https://api.douwebsoft.com
API Bağlantısının Kurulması (Authorization)
Entegrasyon servislerine istekler basic authentication yöntemiyle authorization yapılarak atılmalıdır.
Basic Authentication için kullanılan Api Username, Api Password bilgilerini satıcı panelinde yer alan "Üyelik Bİlgilerim" altında "Entegrasyon Bilgileri" sayfasından alınmalıdır.
Authentication bilgileri PROD ve STAGE ortamda değişmektedir. Kullanılan endpoint ve ortama göre bilgiler revize edilmelidir.
Headers
| Key | Value |
|---|---|
| X-API-KEY | xxxxxxxxxx |
Marka Bilgileri
Sorgu parametreleri
GET
/api/brand_list?page=1&limit=10
| Parametre | Tip | Açıklama |
|---|---|---|
| page | Int | Servis cevabınında hangi sayfadaki markaların getirileceği bilgisi |
| limit | Int | Bir sayfada listelenecek maksimum adeti belirtir. |
Örnek Servis Cevabı
{
"status": true,
"page": "1",
"limit": "10",
"total_manufacturer": "5",
"total_page": 1,
"data": [
{
"manufacturer_id": "a87ff679a2f3e71d9181a67b7542122c",
"name": "Cross Time"
},
{
"manufacturer_id": "c4ca4238a0b923820dcc509a6f75849b",
"name": "Asena Mila"
},
{
"manufacturer_id": "c81e728d9d4c2f636f067f89cc14862c",
"name": "Espa"
},
{
"manufacturer_id": "e4da3b7fbbce2345d7772b0674a318d5",
"name": "Basic And Casual"
},
{
"manufacturer_id": "eccbc87e4b5ce2fe28308fd9f2a7baf3",
"name": "Hadara"
}
]
}
Ürün Listesi
Sorgu parametreleri
GET
/api/product_list?page=1&limit=10
| Parametre | Tip | Açıklama |
|---|---|---|
| page | Int | Servis cevabınında hangi sayfadaki markaların getirileceği bilgisi |
| limit | Int | Bir sayfada listelenecek maksimum adeti belirtir. |
Örnek Servis Cevabı
{
"status": true,
"page": "1",
"limit": "10",
"total_product": "23",
"total_page": 3,
"data": [
{
"model": "1712558510CD416CB75AC257244925D8",
"sku": "1712558510CD416CB75AC257244925D8",
"barcode": "2491312423126",
"group_code": "1712558510CD416CB75AC257244925D8",
"quantity": "13",
"price": "299.9900",
"name": "ORİJİNAL ATTACK ON TITAN JAPON DİZAYN ERKEK TSHIRT-1230478-GRİ",
"description": "Açıklama",
"manufacturer_id": "e4da3b7fbbce2345d7772b0674a318d5",
"manufacturer_name": "Basic And Casual",
"categories": [
{
"category_id": "218a0aefd1d1a4be65601cc6ddc1520e",
"category_name": "Lisanslı Ürünler > Erkek > Tişört"
}
],
"image": [
"https://stageapi.douwebsoft.com/image/mpseller/customer-2/1712558510CD416CB75AC257244925D8_1.jpg",
"https://stageapi.douwebsoft.com/image/mpseller/customer-2/1712558510CD416CB75AC257244925D8_2.jpg",
"https://stageapi.douwebsoft.com/image/mpseller/customer-2/1712558510CD416CB75AC257244925D8_3.jpg",
"https://stageapi.douwebsoft.com/image/mpseller/customer-2/1712558510CD416CB75AC257244925D8_4.jpg",
"https://stageapi.douwebsoft.com/image/mpseller/customer-2/1712558510CD416CB75AC257244925D8_5.jpg"
],
"special": 0,
"options": [
{
"name": "Beden",
"required": "1",
"product_option_value": [
{
"name": "S",
"quantity": "12"
},
{
"name": "M",
"quantity": "25"
},
{
"name": "L",
"quantity": "26"
},
{
"name": "XL",
"quantity": "12"
},
{
"name": "XXL",
"quantity": "14"
}
]
}
]
},
{
"model": "ABBF76B96E724E94A16A60EBE7C17A06",
"sku": "ABBF76B96E724E94A16A60EBE7C17A06",
"barcode": "2491312423072",
"group_code": "ABBF76B96E724E94A16A60EBE7C17A06",
"quantity": "4",
"price": "299.9900",
"name": "ORİJİNAL ATTACK ON TITAN JAPON DİZAYN ERKEK TSHIRT-1230478-SARI",
"description": "Açıklama",
"manufacturer_id": "e4da3b7fbbce2345d7772b0674a318d5",
"manufacturer_name": "Basic And Casual",
"categories": [
{
"category_id": "218a0aefd1d1a4be65601cc6ddc1520e",
"category_name": "Lisanslı Ürünler > Erkek > Tişört"
}
],
"image": [
"https://stageapi.douwebsoft.com/image/mpseller/customer-2/ABBF76B96E724E94A16A60EBE7C17A06_1.jpg",
"https://stageapi.douwebsoft.com/image/mpseller/customer-2/ABBF76B96E724E94A16A60EBE7C17A06_2.jpg",
"https://stageapi.douwebsoft.com/image/mpseller/customer-2/ABBF76B96E724E94A16A60EBE7C17A06_3.jpg",
"https://stageapi.douwebsoft.com/image/mpseller/customer-2/ABBF76B96E724E94A16A60EBE7C17A06_4.jpg",
"https://stageapi.douwebsoft.com/image/mpseller/customer-2/ABBF76B96E724E94A16A60EBE7C17A06_5.jpg"
],
"special": 0,
"options": [
{
"name": "Beden",
"required": "1",
"product_option_value": [
{
"name": "S",
"quantity": "5"
},
{
"name": "M",
"quantity": "8"
},
{
"name": "L",
"quantity": "8"
},
{
"name": "XL",
"quantity": "5"
},
{
"name": "XXL",
"quantity": "4"
}
]
}
]
}
]
}
Kategori Bilgileri
Sorgu parametreleri
GET
/api/category_list?page=1&limit=100
| Parametre | Tip | Açıklama |
|---|---|---|
| page | Int | Servis cevabınında hangi sayfadaki markaların getirileceği bilgisi |
| limit | Int | Bir sayfada listelenecek maksimum adeti belirtir. |
Örnek Servis Cevabı
{
"status": true,
"page": "1",
"limit": "100",
"total_category": "210",
"total_page": 3,
"data": [
{
"category_id": "c24cd76e1ce41366a4bbe8a49b02a028",
"name": "Kadın > Giyim > Elbise"
},
{
"category_id": "c52f1bd66cc19d05628bd8bf27af3ad6",
"name": "Kadın > Giyim > Tişört"
},
{
"category_id": "fe131d7f5a6b38b23cc967316c13dae2",
"name": "Kadın > Giyim > Şort"
}
]
}
Sipari Bilgileri
Sorgu parametreleri
GET
/api/order_status_list
Örnek Servis Cevabı
{
"status": true,
"data": [
{
"order_status_id": "17",
"name": "İade Kargoya Verildi"
},
{
"order_status_id": "19",
"name": "Tamamlandı"
},
{
"order_status_id": "20",
"name": "Onay Bekliyor"
},
{
"order_status_id": "22",
"name": "Kargoya Verildi"
},
{
"order_status_id": "23",
"name": "Teslim Edildi"
},
{
"order_status_id": "25",
"name": "İptal Edildi"
},
{
"order_status_id": "26",
"name": "Kargo Bekleniyor"
},
{
"order_status_id": "27",
"name": "İade Kargo Bekleniyo"
},
{
"order_status_id": "28",
"name": "İade Kargo Teslim Edildi"
},
{
"order_status_id": "29",
"name": "İade Tamamlandı"
},
{
"order_status_id": "32",
"name": "Alıcı Kargoyu Kabul Etmedi"
}
]
}
Sipari Bilgileri
Sorgu parametreleri
GET
/api/order_list?page=1&limit=10&order_status_id=20
| Parametre | Tip | Açıklama |
|---|---|---|
| page | Int | Servis cevabınında hangi sayfadaki markaların getirileceği bilgisi |
| limit | Int | Bir sayfada listelenecek maksimum adeti belirtir. |
| order_status_id | Int | Çekilecek sipariş durumunu belirtir. |
Örnek Servis Cevabı
{
"status": true,
"page": "1",
"limit": "10",
"total_order": 13,
"total_page": 2,
"data": [
{
"order_id": "f7177163c833dff4b38fc8d2872f1ec6",
"firstname": "Recep",
"lastname": "Soyad",
"email": "dsada@douwebsoftmail.com",
"telephone": "0 (544) 444-44-44",
"payment_firstname": "Recep",
"payment_lastname": "Soyad",
"payment_company": "dsdadasd",
"payment_address_1": "Kaş Antalya",
"payment_address_2": "",
"payment_district": "Kahta",
"payment_country": "Türkiye",
"payment_city": "Adıyaman",
"payment_custom_field": "{\"1\":\"\",\"2\":\"\",\"3\":\"\"}",
"shipping_firstname": "Recep",
"shipping_lastname": "Soyad",
"shipping_address_1": "Kaş Antalya",
"shipping_address_2": "",
"shipping_district": "Kahta",
"shipping_country": "Türkiye",
"shipping_city": "Adıyaman",
"shipping_company": "dsdadasd",
"shipping_custom_field": "{\"1\":\"\",\"2\":\"\",\"3\":\"\"}",
"product": [
{
"order_product_id": "38b3eff8baf56627478ec76a704e9b52",
"name": "ORİJİNAL ATTACK ON TITAN JAPON DİZAYN ERKEK TSHIRT-1230478-SARI",
"model": "ABBF76B96E724E94A16A60EBE7C17A06",
"variant": {
"Beden": "XXL"
},
"quantity": "1",
"order_status": "Onay Bekliyor",
"cargo_barcode": null,
"cargo_name": null,
"price": "299.9900",
"tax": "27.2718",
"total": "299.9900",
"date_added": "2023-12-10 15:31:56"
}
]
},
{
"order_id": "17e62166fc8586dfa4d1bc0e1742c08b",
"firstname": "Recep",
"lastname": "Soyad",
"email": "dsadasd@douwebsoftmail.com",
"telephone": "0 (555) 555-55-55",
"payment_firstname": "Recep",
"payment_lastname": "Soyad",
"payment_company": "dsdadasd",
"payment_address_1": "Kaş Antalya",
"payment_address_2": "",
"payment_district": "Kahta",
"payment_country": "Türkiye",
"payment_city": "Adıyaman",
"payment_custom_field": "{\"1\":\"\",\"2\":\"\",\"3\":\"\"}",
"shipping_firstname": "Recep",
"shipping_lastname": "Soyad",
"shipping_address_1": "Kaş Antalya",
"shipping_address_2": "",
"shipping_district": "Kahta",
"shipping_country": "Türkiye",
"shipping_city": "Adıyaman",
"shipping_company": "dsdadasd",
"shipping_custom_field": "{\"1\":\"\",\"2\":\"\",\"3\":\"\"}",
"product": [
{
"order_product_id": "f899139df5e1059396431415e770c6dd",
"name": "ORİJİNAL POKEMON PIKACHU SİMLİ BASKILI PAMUK COCUK T-SHIRT- 54938-BEYAZ",
"model": "8BC424FD793A4C1088328F72C86F5732",
"variant": {
"Beden": "12 Yaş"
},
"quantity": "1",
"order_status": "Onay Bekliyor",
"cargo_barcode": null,
"cargo_name": null,
"price": "269.9900",
"tax": "24.5445",
"total": "269.9900",
"date_added": "2023-12-10 15:27:53"
}
]
}
]
}
Ürün Ekleme Bilgileri
Ürünleriniz Douwebsoft sistemine yüklenirken bu metod kullanılmaktadır. Tekli ve çoklu ürün gönderimini desteklemektedir.
Bu method ile ürün aktarımı sağlanmadan önce Douwebsoft Marka Liste ve Kategori/Kategori Özellik bilgileri servisleri üzerinden ilgili detaylar alınmalıdır.
Sorgu parametreleri
POST
/api/add_product
| Parametre | Tip | Açıklama |
|---|---|---|
| name | string | Ürün adı |
| description | string | Uzun ürün açıklaması |
| sku | string | Stok kodu |
| model | string | Ürün kodu |
| group_code | string | Ürün ortak irleştirici kod. Bu kod aynı modeldeki ürünlerin ürün sayfasında birleşmesini sağlamaktadır |
| barcode | string | Ürün barkodu |
| price | double | Ürün Liste Fiyatı. |
| special_price | double | Ürün İndirimli Fiyatı. |
| quantity | Int | Ürün Adeti |
| tax | Int | KDV değeri (1,10,20) |
| brandId | string | Markalar servisinden çekilen marka id'si. |
| categoryId | string | Markalar servisinden çekilen kategori id'si. |
| attributes | array | Özellik listesi |
| attributes.attribute_id | string | Kategori Özellik servisinden çekilen özellik id'si. |
| attributes.preset | string | Özellik değeri |
| image | array | Resim listesi |
| image.url | string | Resim urlsi |
| option | Array | Seçenek Listesi |
| option.ean | string | Seçenek barkodu |
| option.sku | string | Seçenek stok kodu |
Örnek Servis İsteği
[
{
"name": "PUANTİYE DESENLİ DİZALTI PANTOLON",
"description": "ÜRÜN UZUN AÇIKLAMASI",
"sku": "SSRT0041-L",
"model": "dnm011",
"group_code": "SRT0010",
"barcode": "ASM0000001108-ABGs",
"price": 120,
"special_price": 60,
"tax": 8,
"brandId": "c4ca4238a0b923820dcc509a6f75849b",
"categoryId": "c24cd76e1ce41366a4bbe8a49b02a028",
"attributes":[
{
"attribute_id":1,
"preset":"Kırmızı"
},{
"attribute_id":2,
"preset": "Erkek"
}
],
"image": [
{
"url": "https://www.asenamila.com/image/catalog/KAPRİ/7d.jpg"
},
{
"url": "https://www.asenamila.com/image/catalog/KAPRİ/7b.jpg"
},
{
"url": "https://www.asenamila.com/image/catalog/KAPRİ/7c.jpg"
},
{
"url": "https://www.asenamila.com/image/catalog/KAPRİ/7a.jpg"
}
],
"quantity": 20,
"option": [
{
"Beden":"M",
"quantity":49,
"ean" : "barkod1",
"sku" : "sku1"
},
{
"Beden":"L",
"quantity":50,
"ean" : "barkod2",
"sku" : "sku2"
},
{
"Beden":"S",
"quantity":50,
"ean" : "barkod3",
"sku" : "sku3"
},
{
"Beden":"XL",
"quantity":50,
"ean" : "barkod4",
"sku" : "sku4"
}
]
}
]
Ürün Güncelleme Bilgileri
Ürünleriniz Douwebsoft sistemine güncelleme gönderirken bu metod kullanılmaktadır. Tekli ve çoklu ürün güncellemesi desteklemektedir.
Bu method ile ürün aktarımı sağlanmadan önce Douwebsoft Marka Liste ve Kategori/Kategori Özellik bilgileri servisleri üzerinden ilgili detaylar alınmalıdır.
Sorgu parametreleri
POST
/api/update_product
| Parametre | Tip | Açıklama |
|---|---|---|
| sku | string | Stok kodu |
| group_code | string | Ürün ortak irleştirici kod. Bu kod aynı modeldeki ürünlerin ürün sayfasında birleşmesini sağlamaktadır |
| barcode | string | Ürün barkodu |
| price | double | Ürün Liste Fiyatı. |
| special_price | double | Ürün İndirimli Fiyatı. |
| quantity | Int | Ürün Adeti |
| tax | Int | KDV değeri (1,10,20) |
| option | Array | Seçenek Listesi |
| option.ean | string | Seçenek barkodu |
| option.sku | string | Seçenek stok kodu |
Örnek Servis İsteği
[
{
"sku": "SSRT0041-L",
"group_code": "SRT0010",
"barcode": "dsdadasdsa",
"price": 120,
"special_price": 0,
"tax": 8,
"quantity": 20,
"option": [
{
"Beden":"M",
"quantity":49,
"ean" : "barkod1",
"sku" : "sku1"
},
{
"Beden":"L",
"quantity":50,
"ean" : "barkod2",
"sku" : "sku2"
},
{
"Beden":"S",
"quantity":50,
"ean" : "barkod3",
"sku" : "sku3"
},
{
"Beden":"XL",
"quantity":50,
"ean" : "barkod4",
"sku" : "sku4"
}
]
},
{
"sku": "guncel2",
"group_code": "guncel1",
"barcode": "ASM0000001108-SS",
"price": 50,
"special_price": 30,
"quantity": 20,
"option": [
{
"Beden":"M",
"quantity":8,
"ean" : "barkod14",
"sku" : "sku1"
},
{
"Beden":"L",
"quantity":5,
"ean" : "barkod2",
"sku" : "sku2"
},
{
"Beden":"S",
"quantity":3,
"ean" : "barkod3",
"sku" : "sku3"
},
{
"Beden":"XL",
"quantity":0,
"ean" : "barkod4",
"sku" : "sku4"
}
]
}
]
Ürün Adet Fiyat Güncelleme Bilgileri
Ürünleriniz adet fiyat güncellenirken bu metod kullanılmaktadır.
Sorgu parametreleri
POST
/api/update_stock_price
| Parametre | Tip | Açıklama |
|---|---|---|
| barcode | string | Stok kodu |
| price | double | Ürün Liste Fiyatı. |
| special_price | double | Ürün İndirimli Fiyatı. |
| quantity | Int | Ürün Adeti |
Örnek Servis İsteği
[
{
"barcode" : "ASM0000000266",
"price" : 1000,
"special" : 500,
"quantity" : 2
}
]