訂單建立 /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
CarrierType 載具類別 S(6) O 如需輸入載具,此欄位必填
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": []
                }