折讓開立 /Invoice/SufferAdd

Request 請求內容

根節點
參數 名稱 型態 必要性 說明
ProNum 廠商代號 S(10) M
Option 設定檔 組合 M
Main 主檔 組合 M
Details 明細檔 組合 M

設定檔(Option)

參數 名稱 型態 必要性 說明
SelectInvoiceCompany 發票公司 S(6) M 選擇發票公司的代號, 可於發票系統的J 銷項發票設定作業查看
SelectMSPaperCodeCheck 檢查主檔單據編號是否重複,重複則不匯入 S(1) 0:不檢查(預設) 1:檢查
SCODE 操作員代號 S(4) M 請指定業務代號做為系統紀錄

主檔(Main)

參數 名稱 型態 必要性 說明
SUDAY 折讓單日期 S(20) 必填,格式為西元日期, yyyy/MM/dd 請輸入ex. 2024/11/22
Ccode 客戶代號 S(6) 請輸入TMS客戶代號,如果沒使用到可不填
Cnam2 客戶簡稱 S(12)
Cnam1 客戶抬頭 S(100)
CTCOD 統一編號 S(8)
MSPaperCode 主檔單據編號 S(40) 可用來避免重複匯入的判斷號碼

發票明細(Details)

參數 名稱 型態 必要性 說明
InvoiceNo 發票完整號碼 S(10) M ex.AA00000123
InvoiceDate 發票日期 S(17) M
ICODE 產品代號 S(17) M
INAME 產品名稱 S(40) M 必填
Qty 數量 D(28,7) M
IPOIN 單位 S(6) O
PRICE 明細-單價 D(28,7) M
TOTAL 明細-銷售額小計(稅前) Int M 整數,不可負號
STAXM 明細-營業稅額 Int M 整數,不可負號
TaxType 明細-稅別 S(1) M 1:應稅 2:零稅 3:免稅

回覆結果(Response)

參數 名稱 型態 說明
Status 處理狀態 S(1) S:正確 E:錯誤
SufferNo 折讓單號 S(11) 正確才會回傳
MSPaperCode 主檔單據編號 S(40)
ErrorCode 錯誤碼 S(4)
ErrorMessage 主要錯誤訊息 S(300)
ErrorDetail 錯誤明細 陣列:S(MAX) 初步建置時可用來參考
Request範例
        
//請求Header內容
api-pno:TMSDEMOWEB
api-timestamp:1560964522
api-ClientSign:C2AF4854A4623B07BD460A17EBA281BDA9759EA2F2ED92373A044F41FFD1011EF6B07B3945084D74F88816057BFC5C98EE7BE3C8C5099C06F840F10D20E2D9AD

//請求Body內容
{
   "Option":{
    "SelectInvoiceCompany":"1",
    "SelectProductSaleWithTax":"1",
    "SelectMSPaperCodeCheck":"0",
    "SCODE":"TMS"
   },
   "Main":{
        "SUDAY": "2019/06/19",
        "CCODE": "",
        "CNAM2": "廣鐸企業",
        "CNAM1": "廣鐸企業有限公司",
        "CTCOD": ""
   },
   "Details":[
    { "InvoiceNo":"RM10000010","InvoiceDate":"108.06.12","INAME": "AAAAAAAAA", "TaxType": "1", "IPOIN":"個", "Qty":1, "Price": 30, "Total": 40, "STAXM": 2},
    { "InvoiceNo":"RM10000010","InvoiceDate":"108.06.12","INAME": "BBBBBBBBB", "TaxType": "1", "IPOIN":"個", "Qty":1, "Price": 30, "Total": 50, "STAXM": 2},
    { "InvoiceNo":"RM10000010","InvoiceDate":"108.06.12","INAME": "CCCCCCCCC", "TaxType": "1", "IPOIN":"個", "Qty":1, "Price": 40, "Total": 60, "STAXM": 2}
   ]
   
}

Response 回覆結果

Response範例
        
        成功
        {
            "Status": "S",
            "SufferNo": "10806210001",
            "MSPaperCode": "10806190002",
            "ErrorCode": "0000",
            "ErrorMessage": "",
            "ErrorDetail": []
        }
    
        
        
        失敗
        {
            "Status": "E",
            "SufferNo": "",
            "MSPaperCode": "10806190002",
            "ErrorCode": "9003",
            "ErrorMessage": "Timestamp已過期",
            "ErrorDetail": []
        }
    
        
        
        失敗
        {
            "Status": "E",
            "SufferNo": "",
            "MSPaperCode": "XX10609270010",
            "ErrorCode": "2006",
            "ErrorMessage": "單號重複:XX10609270010",
            "ErrorDetail": []
        }