通用錯誤代碼
| code | 描述 |
|---|---|
| 0 | 成功 |
| 11 | invoice(統編)不可為空 |
| 12 | invoice(統編)錯誤 |
| 13 | status 未啟用 |
| 14 | IP 錯誤 |
| 15 | Time 錯誤 |
| 16 | 簽名驗證錯誤 |
| 17 | 資料不可為空 |
| 18 | 無法建立資料庫連線 |
| 19 | 公司停權，無法使用 API 開立發票 |
| 20 | data 非 JSON 字串格式 |
| 21 | 人數過多，請稍後 |
| 22 | 尚未申請 API 串接 |
| 23 | 此 API 支援傳輸多筆資料，data 欄位資料應為陣列字串 |
API 補充說明
※每張圖片都可以點擊放大喔！
API 錯誤代碼
[發票 - 開立發票(自動配號)]錯誤代碼
| code | 描述 |
|---|---|
| 3040111 | 字軌不足 |
| 3040112 | 此 API 只支援傳輸單張發票，data 欄位資料應為物件字串 |
| 3040121 | BuyerIdentifier 字數錯誤 |
| 3040122 | BuyerIdentifier 格式錯誤 |
| 3040123 | BuyerName 不可為空或過長 |
| 3040124 | BuyerAddress 過長 |
| 3040125 | BuyerTelephoneNumber 過長 |
| 3040126 | BuyerEmailAddress 過長 |
| 3040127 | MainRemark 過長 |
| 3040128 | CarrierType 過長 |
| 3040129 | CarrierId1 過長 |
| 3040130 | CarrierId2 過長 |
| 3040131 | 載具明碼、隱碼不相符 |
| 3040132 | 載具號碼不存在 |
| 3040133 | 載具明碼、隱碼不相符 |
| 3040134 | CarrierId1 載具明碼錯誤 |
| 3040135 | 載具明碼或隱碼不可為空 |
| 3040136 | NPOBAN 格式錯誤 |
| 3040137 | NPOBAN 不存在 |
| 3040138 | ProductItem 不可為空或過多 |
| 3040139 | 第n品項 Description 不可為空或過長 |
| 3040140 | 第n品項 Quantity 格式錯誤 |
| 3040141 | 第n品項 UnitPrice 格式錯誤 |
| 3040142 | 第n品項 Amount 格式錯誤 |
| 3040143 | 第n品項 Remark 過長 |
| 3040144 | 第n品項 TaxType 錯誤 |
| 3040145 | SalesAmount 格式錯誤 |
| 3040146 | FreeTaxSalesAmount 格式錯誤 |
| 3040147 | ZeroTaxSalesAmount 格式錯誤 |
| 3040148 | TaxType 格式錯誤 |
| 3040149 | TaxRate 格式錯誤 |
| 3040150 | TaxAmount 格式錯誤 |
| 3040151 | TotalAmount 格式錯誤 |
| 3040152 | TotalAmount 不可為負數 |
| 3040153 | OrderId 不可為空或過長 |
| 3040154 | 載具類別不可為空 |
| 3040160 | BrandName 不可為空或過長 |
| 3040161 | DetailVat 格式錯誤 |
| 3040162 | 只有打統編發票， 才可以用未稅單價及小計 |
| 3040163 | DetailAmountRound 格式錯誤 |
| 3040171 | OrderId 重複 |
| 3040171 | OrderId 重複，該訂單編號正在註銷重開中 |
| 3040172 | 第n品項 Amount 金額錯誤 |
| 3040173 | TaxType 設定錯誤 |
| 3040174 | SalesAmount 計算錯誤 |
| 3040175 | ZeroTaxSalesAmount 計算錯誤 |
| 3040176 | FreeTaxSalesAmount 計算錯誤 |
| 3040177 | TaxAmount 計算錯誤 |
| 3040178 | TotalAmount 計算錯誤 |
| 3040179 | 若為零稅率發票，通關方式註記必填 |
| 3040180 | 通關方式註記錯誤 |
| 3040181 | SalesAmount 不應該為負數 |
| 3040182 | ZeroTaxSalesAmount 不應該為負數 |
| 3040183 | FreeTaxSalesAmount 不應該為負數 |
| 3040184 | TotalAmount 不應該為負數 |
| 3040191 | 無法取得下一張發票 |
| 3040192 | 取得發票列印格式錯誤 |
[發票 - 作廢發票]錯誤代碼
| code | 描述 |
|---|---|
| 3050111 | 第n筆 CancelInvoiceNumber 錯誤 |
| 3050112 | 此 API 支援傳輸多張發票，data 欄位資料應為陣列字串 |
| 3050121 | 指定發票號碼 開立中 |
| 3050122 | 指定發票號碼 已存在開立作廢 |
| 3050123 | 指定發票號碼 已存在註銷 |
| 3050124 | 指定發票號碼 發票類型錯誤 |
| 3050125 | 指定發票號碼 發票不存在 |
| 3050126 | 指定發票號碼 已超過修改期限 |
| 3050131 | 指定發票號碼 等待 開立/作廢/註銷 |
| 3050141 | 指定發票號碼 已存在折讓單 |
[發票 - 發票狀態]錯誤代碼
| code | 描述 |
|---|---|
| 99 | 第n筆 InvoiceNumber 錯誤 |
[發票 - 發票查詢]錯誤代碼
| code | 描述 |
|---|---|
| 31 | type 查詢類型不存在 |
| 32 | order_id 不可為空或過長 |
| 33 | invoice_number 不可為空或格式錯誤 |
| 34 | type 查詢類型錯誤 |
| 51 | 該發票超過查詢期限 |
| 71 | 查無資料 |
[發票 - 發票列表]錯誤代碼
| code | 描述 |
|---|---|
| 31 | date_select 參數錯誤 |
| 32 | date_start 不是 YYYYMMDD 格式 |
| 33 | date_end 不是 YYYYMMDD 格式 |
| 34 | limit 只能帶入 20 ~ 500 |
| 35 | page 必須 >= 1 |
| 36 | date_start 不可大於 date_end |
[發票 - 發票檔案]錯誤代碼
| code | 描述 |
|---|---|
| 31 | type 查詢類型不存在 |
| 32 | order_id 不可為空或過長 |
| 33 | invoice_number 不可為空或格式錯誤 |
| 34 | type 查詢類型錯誤 |
| 51 | 該發票超過查詢期限 |
| 52 | 該發票有等待異動的排程 |
| 53 | 載具發票，中獎後才可以下載 |
| 55 | 該發票不符合下載條件 |
| 53 | 該發票類型不可下載 |
| 71 | 查無資料 |
[發票 - 發票列印]錯誤代碼
| code | 描述 |
|---|---|
| 31 | type 查詢類型不存在 |
| 32 | order_id 不可為空或過長 |
| 33 | invoice_number 不可為空或格式錯誤 |
| 34 | type 查詢類型錯誤 |
| 36 | Star mC-Print3 不支援單印明細 |
| 35 | printer_type 熱感應機型號代碼錯誤 |
| 51 | 該發票超過查詢期限 |
| 56 | 0元發票，無法列印發票正本及發票補印 |
| 52 | 該發票有等待異動的排程 |
| 53 | 載具發票，中獎後才可以列印 |
| 55 | 該發票不符合列印條件 |
| 53 | 該發票類型不可列印 |
| 55 | 該發票不符合列印條件 |
| 55 | 該發票不符合列印條件 |
| 53 | 該發票類型不可列印 |
| 71 | 查無資料 |
| 72 | 取得發票列印格式錯誤 |
[折讓 - 開立折讓]錯誤代碼
| code | 描述 |
|---|---|
| 4040112 | 此 API 支援傳輸多張發票，data 欄位資料應為陣列字串 |
| 4040121 | 第n筆 AllowanceNumber 不可為空值或超過16字 |
| 4040122 | 第n筆 AllowanceDate 錯誤 |
| 4040123 | 第n筆 AllowanceType 錯誤 |
| 4040124 | 第n筆 OriginalInvoiceNumber 錯誤 |
| 4040125 | 第n筆 OriginalInvoiceDate 錯誤 |
| 4040126 | 第n筆 BuyerIdentifier 錯誤 |
| 4040127 | 第n筆 BuyerName 錯誤 |
| 4040128 | 第n筆 BuyerAddress 錯誤 |
| 4040129 | 第n筆 BuyerTelephoneNumber 錯誤 |
| 4040130 | 第n筆 BuyerEmailAddress 錯誤 |
| 4040131 | 第n筆 ProductItem 錯誤 |
| 4040132 | 第n筆 第n品項 目前僅支援一張折讓單折讓同一張發票 |
| 4040133 | 第n筆 第n品項 目前僅支援一張折讓單折讓同一張發票 |
| 4040134 | 第n筆 第n品項 OriginalDescription 錯誤 |
| 4040135 | 第n筆 第n品項 Quantity 錯誤 |
| 4040136 | 第n筆 第n品項 UnitPrice 錯誤 |
| 4040137 | 第n筆 第n品項 Amount 錯誤 |
| 4040138 | 第n筆 第n品項 Tax 錯誤 |
| 4040139 | 第n筆 第n品項 Tax 必須為整數 |
| 4040140 | 第n筆 TaxType 錯誤 |
| 4040141 | 第n筆 TaxAmount 錯誤 |
| 4040142 | 第n筆 TotalAmount 錯誤 |
| 4040151 | 指定發票號碼 原發票日期錯誤 |
| 4040152 | 指定發票號碼 開立中 |
| 4040153 | 指定發票號碼 已存在開立作廢 |
| 4040154 | 指定發票號碼 已註銷 |
| 4040155 | 指定發票號碼 原發票類型錯誤 |
| 4040156 | 指定發票號碼 原發票不存在 |
| 4040161 | 指定折讓單號 已存在折讓開立 |
| 4040162 | 指定折讓單號 已存在作廢折讓 |
| 4040163 | 指定折讓單號 折讓類型錯誤 |
[折讓 - 作廢折讓]錯誤代碼
| code | 描述 |
|---|---|
| 4050112 | 此 API 支援傳輸多張發票，data 欄位資料應為陣列字串 |
| 4050121 | 第n筆 CancelAllowanceNumber 錯誤 |
| 4050131 | 指定折讓單號 折讓開立中 |
| 4050132 | 指定折讓單號 已存在已存在作廢折讓 |
| 4050133 | 指定折讓單號 折讓類型錯誤 |
| 4050134 | 指定折讓單號 折讓單不存在 |
| 4050135 | 指定折讓單號 已超過修改期限 |
| 4050141 | 指定折讓單號 等待 折讓開立/作廢折讓 |
[折讓 - 折讓狀態]錯誤代碼
| code | 描述 |
|---|---|
| 99 | 第n筆 AllowanceNumber 錯誤 |
[折讓 - 折讓檔案]錯誤代碼
| code | 描述 |
|---|---|
| 33 | allowance_number 不可為空 |
| 34 | download_style 參數錯誤 |
| 52 | 該折讓單有等待異動的排程 |
| 53 | 該折讓單類型不可下載 |
| 71 | 查無資料 |
[其他 - 手機條碼查詢]錯誤代碼
| code | 描述 |
|---|---|
| 9000111 | 手機條碼不可為空 |
| 9000112 | 手機條碼格式錯誤 |
| 9000113 | 手機條碼不存在 |
[其他 - 公司名稱查詢]錯誤代碼
| code | 描述 |
|---|---|
| 99 | 第 n 筆 統一編號長度錯誤 |
| 99 | 第 n 筆 統一編號格式錯誤 |
[其他 - 所有字軌資料]錯誤代碼
| code | 描述 |
|---|---|
| 99 | Period 錯誤 |
[自行配號專用 - 字軌取號]錯誤代碼
| code | 描述 |
|---|---|
| 99 | Period 錯誤 |
| 99 | Book 錯誤 |
| 99 | 無字軌可取 |
| 99 | 剩餘字軌本數不足 |
| 99 | 字軌取號錯誤，請聯絡客服人員 |
| 99 | 字軌取號的訖號錯誤，請聯絡客服人員 |
| 99 | 資料庫更新資料錯誤，請稍後重試 |
[自行配號專用 - 字軌狀態]字軌狀態
| code | 描述 |
|---|---|
| 99 | Period 錯誤 |
[自行配號專用 - 開立發票(API配號)]錯誤代碼
| code | 描述 |
|---|---|
| 99 | 此 API 支援傳輸多張發票，data 欄位資料應為陣列字串 |
| 99 | 有指定熱感應機型號代碼，只能一次傳輸一張 |
| 99 | 第n筆 InvoiceNumber 錯誤 |
| 99 | 第n筆 InvoiceDate 錯誤 |
| 99 | 第n筆 InvoiceTime 錯誤 |
| 99 | 第n筆 InvoiceNumber 非當期字軌 |
| 99 | 第n筆 InvoiceNumber 超過開立期限 |
| 99 | 第n筆 InvoiceNumber 號碼不在字軌起訖內 |
| 99 | 第n筆 InvoiceNumber 字軌類別設定錯誤 |
| 99 | 第n筆 InvoiceNumber 字軌類型設定錯誤 |
| 99 | 第n筆 BuyerIdentifier 錯誤 |
| 99 | 第n筆 BuyerIdentifier 錯誤 |
| 99 | 第n筆 BuyerName 錯誤 |
| 99 | 第n筆 BuyerAddress 錯誤 |
| 99 | 第n筆 BuyerTelephoneNumber 錯誤 |
| 99 | 第n筆 BuyerEmailAddress 錯誤 |
| 99 | 第n筆 MainRemark 錯誤 |
| 99 | 第n筆 CarrierType 錯誤 |
| 99 | 第n筆 CarrierId1 錯誤 |
| 99 | 第n筆 CarrierId2 錯誤 |
| 99 | 第n筆 PrintMark 錯誤 |
| 99 | 第n筆 載具明碼、隱碼不相符 |
| 99 | 第n筆 載具號碼不存在 |
| 99 | 第n筆 載具明碼、隱碼不相符 |
| 99 | 第n筆 CarrierId1 載具明碼錯誤 |
| 99 | 第n筆 NPOBAN 錯誤 |
| 99 | 第n筆 NPOBAN 錯誤 |
| 99 | 第n筆 RandomNumber 錯誤 |
| 99 | 第n筆 ProductItem 錯誤 |
| 99 | 第n筆 第n品項 Description 錯誤 |
| 99 | 第n筆 第n品項 Quantity 錯誤 |
| 99 | 第n筆 第n品項 UnitPrice 錯誤 |
| 99 | 第n筆 第n品項 Amount 錯誤 |
| 99 | 第n筆 第n品項 Remark 錯誤 |
| 99 | 第n筆 第n品項 TaxType 錯誤 |
| 99 | 第n筆 若為零稅率發票，通關方式註記必填 |
| 99 | 第n筆 通關方式註記錯誤 |
| 99 | 第n筆 SalesAmount 錯誤 |
| 99 | 第n筆 FreeTaxSalesAmount 錯誤 |
| 99 | 第n筆 ZeroTaxSalesAmount 錯誤 |
| 99 | 第n筆 TaxType 錯誤 |
| 99 | 第n筆 TaxRate 錯誤 |
| 99 | 第n筆 TaxAmount 錯誤 |
| 99 | 第n筆 TotalAmount 錯誤 |
| 99 | 第n筆 order_id 錯誤 |
| 99 | 第n筆 列印發票不可設定載具 |
| 99 | 第n筆 列印發票不可設定捐贈碼 |
| 99 | 第n筆 捐贈發票不可設定載具 |
| 99 | 第n筆 載具類型錯誤 |
| 99 | 第n筆 載具明碼錯誤 |
| 99 | 第n筆 載具隱碼錯誤 |
| 99 | 指定發票號碼 已存在開立 |
| 99 | 指定發票號碼 已存在開立作廢 |
| 99 | 指定發票號碼 註銷中 |
| 99 | 指定發票號碼 發票類型錯誤 |