訂單建立 /Order/Add
Request 請求內容
根節點
| 參數 | 名稱 | 型態 | 必要性 | 說明 |
| ProNum | 廠商代號 | S(10) | M | |
| Main | 主檔 | 組合 | M | |
| Details | 明細檔 | 組合 | M | |
| PlatformData | 訂單拋轉紀錄資料 | 組合 | O | 未使用訂單拋轉則無需填寫此節點內容 |
主檔(Main)
| 參數 | 名稱 | 型態 | 必要性 | 說明 |
| ODATE | 訂單日期 | S(20) | M | 可輸入民國年或是西元年 |
| OCCOD | 客戶代號 | S(16) | M | |
| OCOD4 | 客戶訂單號碼 | S(30) | M | 必填,如系統已經有該單號則無法匯入 |
| OPNAM | 聯絡人 | S(40) | O | 空白則帶入客戶預設值 |
| OTEL | 電話 | S(20) | O | 空白則帶入客戶預設值 |
| OFAX | 傳真 | S(20) | O | 空白則帶入客戶預設值 |
| MobileNO | 手機 | S(20) | O | 空白則帶入客戶預設值 |
| OADD1 | 發票地址 | S(50) | O | 空白則帶入客戶預設值 |
| OADD2 | 送貨地址 | S(50) | O | 空白則帶入客戶預設值 |
| OBAK1 | 備註1 | S(200) | O | |
| OBAK2 | 備註2 | S(200) | O | |
| OBAK3 | 備註3 | S(200) | O | |
| InsideNote | 內部備註3 | S(100) | O | |
| OPAY | 付款備註 | S(100) | O | |
| OWAY | 送貨方式 | S(50) | O | |
| OTONO | 付款方式代號 | S(2) | O | 如空白或付款方式代號不存在於系統內則讀取客戶預設值 |
| OSCOD | 業務代號 | S(4) | M | 如空白則讀取客戶預設值 |
| OTax | 產品稅別處理方式 | Int | M | 1.應稅 2.零稅 3.免稅 7.根據明細指定 8.依客戶預設值 9.混稅(根據產品設定), 預設9 |
| UseInvoice | 發票稅別處理方式 | S(1) | O | 1.開發票 0.不開發票 , 預設1 |
| ToSaleOrder | 直接轉銷貨單 | S(1) | O |
1.轉銷貨單 0.不轉銷貨單 , 預設0 回傳會以參數SaleOrderNo帶出銷貨單號 |
| ReceiveName | 收件人姓名 | S(100) | M | 本次訂單的收件人名稱 |
| ReceiveTEL | 收件人電話 | S(20) | O | 本次訂單的收件人電話 |
| ReceiveMobile | 收件人手機 | S(20) | O | 本次訂單的收件人手機 |
| ReceiveZIPCode | 收件人郵遞區號 | S(10) | O | 本次訂單的收件人郵遞區號 |
| ReceiveAddr | 收件人地址 | S(200) | O | 本次訂單的收件人地址 |
| ReceiveCTCOD | 統一編號 | S(8) | O | 本次訂單的發票買方統編 |
| ReceiveComName | 發票抬頭 | S(100) | O | 本次訂單的發票買方抬頭 |
| ReceiveEmail | 發票電子郵件 | S(50) | O | 本次訂單的發票買方電子郵件 |
| NPOBAN | 捐贈碼 | S(10) | O | |
| CarrierMode | 會員載具編碼規則 | Int | O |
有購買廣鐸會員載具才可使用此功能，填入0以外會強制使用會員載具，如果消費者有使用手機條碼，請不要使用此選項，預設值為0 0. 在載具類別填入廣鐸會員載具時，依購買者Email 1.依客戶ID 2.依訂單單號 |
| CarrierType | 載具類別 | S(6) | O |
如需輸入載具，此欄位必填 例:載具是手機條碼時，請輸入3J0002 |
| CarrierId2 | 載具號碼 | S(64) | O | |
| CustomKey1 | 客訂欄位1 | S(10) | O |
產品明細(Details)
| 參數 | 名稱 | 型態 | 必要性 | 說明 |
| ICODE | 產品代號 | S(17) | M | |
| INAME | 產品名稱 | S(40) | O | 當產品是虛料號時才有用 |
| Qty | 數量 | D(28,7) | M | |
| Unit | 單位 | S(6) | O | |
| Price | 單價 | D(28,7) | M | |
| Stock | 倉庫代號 | S(4) | M | |
| DTaxType | 指定稅別 | S(1) | M | 必須主檔OTax指定為7才有效果 |
| Remark | 備註 | S(20) | O | |
| TaxBA | 單價是稅前稅後 | S(1) | O | 表示售價是稅前還是稅後 B:稅前 A:稅後 預設B |
訂單拋轉紀錄資料(PlatformData)
※未使用訂單拋轉則無需填寫此節點內容
| 參數 | 名稱 | 型態 | 必要性 | 說明 |
| FromCode | 網購平台代號 | S(30) | M | |
| BuyerName | 購買人名稱 | S(100) | M | |
| BuyerTel | 購買人電話 | S(50) | O | 此欄位與購買人手機須至少填寫一個 |
| BuyerPhone | 購買人手機 | S(50) | O | 此欄位與購買人電話須至少填寫一個 |
| BuyerAddress | 購買人地址 | S(200) | M | |
| BuyerMail | 購買人電子信箱 | S(50) | O | |
| ReceiveName | 收件人名稱 | S(100) | M | |
| ReceiveTel | 收件人電話 | S(50) | O | 此欄位與收件人手機須至少填寫一個 |
| ReceivePhone | 收件人手機 | S(50) | O | 此欄位與收件人電話須至少填寫一個 |
| ReceiveAddress | 收件人地址 | S(200) | M |
如果為超商取貨則須提供店號+店名 EX: 982454 新嘉門市 |
| OrderDate | 來源訂單日期 | S(50) | M | 西元年格式 EX: 2020/03/01 10:00 |
| OrderNumber | 來源訂單單號 | S(50) | M | |
| OrderNumber2 | 來源訂單單號2 | S(50) | O | 有第二訂單單號時填寫 |
| PayType | 付款方式 | S(50) | O | |
| ShippingType | 送貨方式 | S(50) | O | |
| ShopType | 超商取貨方式 | S(1) | 如超商取貨，則此欄位必填 0:宅配 7:7-11 F:全家 O:OK L:萊爾富 C:超商 (目前不支援全家大宗取貨) | |
| TrackingNum | 配送編號 | S(50) | O | 如超商取貨 此欄位必填 |
| CompleteTrackingNum | 超商取貨完整單號 | S(50) | O | 如超商取貨 此欄位必填 |
| ShopNumber | 母廠編號 | S(3) | O | |
| ShopSubNumber | 子廠編號 | S(3) | O | |
| InvoiceTitle | 發票抬頭 | S(100) | O | |
| InvoiceCTID | 發票統編 | S(20) | O | |
| Total | 來源訂單合計金額 | D(28,7) | M | |
| SiteBak1 | 來源訂單備註1 | S(200) | O | |
| SiteBak2 | 來源訂單備註2 | S(200) | O | |
| Remark | 備註 | S(200) | O |
Request範例
//請求Header內容
api-pno:TMSDEMOWEB
api-timestamp:1509371605
api-ClientSign:B29087C957C3EDD24F8F83E62CD06EE6D2203A35E16696E53850D908AFFDA8272BDE7BC48864A5A218767A522554967E2B036B529DFFA7B980A049FD456551C2
//請求Body內容
{
"ProNum": "TMSWEBDEMO",
"Main": {
"ODATE" : "",
"OCOD4" : "XX10609270021",
"OCCOD" : "000001",
"OSCOD": "TMS1",
"OPNAM": "王小明",
"OTEL": "04-24222299",
"OFAX": "04-99999999",
"MobileNo": "0933555666",
"OBAK1": "OBAK1",
"OBAK2": "OBAK2",
"OBAK3": "OBAK3",
"OADD1": "ADD1",
"OADD2": "ADD2",
"OWAY": "WAY",
"OPAY": "PAY",
"OTONO": "01",
"OTax": "7",
"ReceiveName": "1111",
"ReceiveTEL": "2222",
"ReceiveMobile": "3333",
"ReceiveZIPCode": "444",
"ReceiveAddr": "55555",
"ReceiveCTCOD": "22222224",
"ReceiveComName": "1234567890",
"UseInvoice" : "1",
"ToSaleOrder" :"1"
},
"Details": [
{ "ICODE": "00000041", "INAME" : "A", "Unit" : "", "Qty":1, "Price": 100, "TaxBA": "A", "Stock": "A001", "Remark":"Remark1", "DTaxType":"1"},
{ "ICODE": "00000042", "INAME" : "B", "Unit" : "", "Qty":2, "Price": 100, "TaxBA": "B", "Stock": "A001", "Remark":"Remark2", "DTaxType":"2"},
{ "ICODE": "00000043", "INAME" : "C", "Unit" : "", "Qty":3, "Price": 100, "TaxBA": "A", "Stock": "A001", "Remark":"Remark3", "DTaxType":"3"},
{ "ICODE": "00000044", "INAME" : "D", "Unit" : "", "Qty":4, "Price": 100, "TaxBA": "A", "Stock": "A001", "Remark":"Remark4", "DTaxType":"2"}
],
"PlatformData":{
"FromCode":"TMS",
"BuyerName":"王小明",
"BuyerTel":"1234567890",
"BuyerAddress":"AAAA",
"ReceiveName":"大熊",
"ReceiveTel":"1234567890",
"ReceiveAddress":"982454 新嘉門市",
"OrderDate":"2020/05/11 10:00",
"OrderNumber":"XX10609270021",
"Total":"1000",
}
}
Response 回覆結果
Response範例
成功
{
"Status": "S",
"OrderNo": "10609280008",
"SaleOrderNo":"10609280001",
"ErrorCode": "0000",
"ErrorMessage": "",
"ErrorDetail": []
}
失敗
{
"Status": "E",
"OrderNo": "",
"ErrorCode": "9003",
"SaleOrderNo":"",
"ErrorMessage": "Timestamp已過期",
"ErrorDetail": []
}
失敗
{
"Status": "E",
"OrderNo": "",
"ErrorCode": "2006",
"SaleOrderNo":"",
"ErrorMessage": "訂單單號重複:XX10609270010",
"ErrorDetail": []
}