v2.0

寶星停車 電子發票操作教學

鯨躍科技 虛擬多通路 (Cetustek Virtual Multi-Channel)

Odoo 17
→
SOAP API
→
鯨躍平台
→
財政部

使用滾輪或方向鍵瀏覽 ↓

1 / 11
流程總覽

電子發票操作流程

建立應收憑單
→
過帳確認
→
開立電子發票
→
取得發票號碼
作廢發票
/
開立折讓
→
作廢折讓
虛擬通路特點：發票號碼由鯨躍平台即時分配，不需要事先申請號碼區間。 呼叫 CreateInvoice API 後立即回傳發票號碼 + 隨機碼。
操作API 方法成功回應
開立發票CreateInvoice15 字元（號碼;隨機碼）
作廢發票CancelInvoiceC0
開立折讓CreateAllowanceA0
作廢折讓CancelAllowanceC0
2 / 11
Step 0

API 設定

路徑：電子發票 → 設定

  1. 填入 API 連線網址
    https://invoice.cetustek.com.tw/InvoiceMultiChannel/
  2. 填入 店家統一編號（officeid）
    60351927
  3. 填入 通路代碼（posid）
    PARK999
  4. 填入 API 交易密碼（apipasswd）
  5. 點擊 「測試連線」 確認連線正常
  6. 點擊 「儲存」
測試模式：勾選後連線測試機，正式上線時取消勾選。
start_parking.kuch.com.tw/web#action=sp_einvoice.action_sp_einvoice_config_settings
鯨躍科技 API 設定（虛擬多通路）
API 連線網址https://invoice.cetustek.com.tw/InvoiceMultiChannel/
店家統一編號60351927
通路代碼PARK999
API 交易密碼*********
一般設定
測試模式☑ 已啟用
號碼低量警示10
測試連線
✓ 連線測試成功！API 正常回應
3 / 11
Step 1

建立客戶應收憑單

路徑：會計 → 客戶 → 應收憑單

  1. 點擊 「新增」 建立應收憑單
  2. 選擇 客戶（如有統編會自動帶入 B2B 模式）
  3. 在「發票資料行」新增商品明細
    品名、數量、單價
  4. 確認金額正確後，點擊 「確認」 過帳
過帳後才能開立電子發票。草稿狀態的憑單無法開立。
會計 → 客戶 → 應收憑單
發送與列印 登記付款 預覽 開立電子發票
應收憑單/2026/00005
客戶測試客戶
發票日期2026年03月30日
日記帳客戶發票
商品數量單價未稅額
VE-TEST-B 虛擬通路測試23.00200.00NT$ 600
總計：NT$ 600
4 / 11
Step 2

開立電子發票

在已過帳的應收憑單上操作

  1. 開啟已過帳的應收憑單
  2. 點擊頂部的 「開立電子發票」 按鈕
  3. 系統自動呼叫鯨躍 API
    CreateInvoice
  4. API 即時回傳 發票號碼 + 隨機碼
  5. 右上角出現「電子發票」連結，點擊可查看詳情
API 回應（成功範例）
YX00000001;8021
發票號碼: YX00000001  |  隨機碼: 8021
應收憑單/2026/00005
發送與列印 登記付款 ⚡ 開立電子發票
電子發票
YX00000001
✓ 電子發票 YX00000001 已成功開立（隨機碼：8021）
B2C vs B2B：
• 無統編 = B2C，稅額 = 0
• 有統編 = B2B，自動計算 5% 稅額
5 / 11
Step 2b

電子發票記錄

路徑：電子發票 → 發票管理 → 電子發票記錄

開立成功後可在此查看所有電子發票記錄，包含：

  • 發票號碼 — API 回傳的正式號碼
  • 隨機碼 — 4 位驗證碼
  • 訂單號 — 對應的應收憑單編號
  • 買方資訊 — 名稱、統編
  • 金額 — 銷售額、稅額、總金額
  • 狀態 — 已開立 / 已作廢
  • 發票明細 — 商品品名、數量、單價

可用的操作按鈕：

作廢 建立折讓 檢查狀態
電子發票 → 電子發票記錄（Form View）
作廢 建立折讓 檢查狀態
已開立
發票資訊
發票號碼YX00000001
發票日期2026/03/30
發票時間14:39:55
隨機碼8021
訂單號應收憑單/2026/00005
金額 / 載具
銷售額600
稅額0
總金額600
捐贈/載具列印
發票明細
品名數量單位單價金額
VE-TEST-B 虛擬通路測試21.00式200.00600.00
6 / 11
Step 3

作廢電子發票

在電子發票記錄上操作

  1. 開啟狀態為「已開立」的電子發票記錄
  2. 點擊 「作廢」 按鈕
  3. 在彈出的作廢精靈中填寫 作廢原因
    （最多 20 字元）
  4. 點擊 「確認作廢」
  5. 系統呼叫 CancelInvoice API
  6. 成功後狀態變為 「已作廢」
API 回應（成功）
C0
注意：作廢後無法復原！已作廢的發票號碼不可重新使用。
作廢發票精靈
作廢發票
發票號碼YX00000000
作廢原因
虛擬通路測試作廢
確認作廢 取消
作廢後的電子發票記錄
YX00000000
已作廢
API 回應C0
作廢原因虛擬通路測試作廢
作廢時間2026/03/30 14:39
7 / 11
Step 4

開立折讓單

在電子發票記錄上操作

  1. 開啟狀態為「已開立」的電子發票記錄
  2. 點擊 「建立折讓」 按鈕
  3. 在折讓精靈中：
    • 填寫 折讓原因（如：退貨折讓）
    • 系統自動帶入原發票明細
    • 調整折讓品項的 數量 和 單價
  4. 點擊 「確認開立」
  5. 系統呼叫 CreateAllowance API
API 回應（成功）
A0
新增折讓精靈
新增折讓
原始發票YX00000001
買方名稱測試客戶
折讓日期2026/03/30
折讓原因
退貨折讓
折讓明細
品名數量單價金額稅額
VE-TEST-B discount1.00200.0020010
折讓含稅總額：210
確認開立
折讓金額限制：所有折讓的合計不得超過原發票總金額。
8 / 11
Step 5

作廢折讓單

在折讓單記錄上操作

  1. 從電子發票記錄的「折讓單」tab 進入折讓
  2. 開啟狀態為「已開立」的折讓單
  3. 點擊 「作廢」 按鈕
  4. 填寫 作廢原因（最多 20 字元）
  5. 確認後系統呼叫 CancelAllowance API
  6. 成功後狀態變為「已作廢」
API 回應（成功）
C0
時限：折讓一旦申報，超過期限就無法作廢（API 回傳 C2 或 C5）。
作廢折讓單精靈
作廢折讓單
折讓單號AL260330144301
作廢原因
折讓金額錯誤
確認作廢 取消
作廢後的折讓單記錄
AL260330144301
已作廢
API 回應C0
作廢原因VE test void
9 / 11
參考

API 回應碼速查表

CreateInvoice 開立發票

15字元成功（號碼;隨機碼）
M1XML 格式錯誤
D0無明細項目
S4無可用發票號碼
S5發票號碼用完
order訂單號重複
InValidIP 未授權

CancelInvoice 作廢發票

C0成功
C1失敗
C3超過申報期限（需核准文號）
C4發票號碼不存在
C5發票已作廢

CreateAllowance 開立折讓

A0成功
A1失敗
A2折讓累計超過原發票金額
A3發票號碼不存在
A4發票已作廢
A7折讓日期早於發票日期

CancelAllowance 作廢折讓

C0成功
C1失敗
C2已申報，無法作廢
C3折讓單不存在
C4已作廢
M:?欄位錯誤（?=欄位名）
10 / 11
完成

操作摘要

建立應收憑單
→
過帳
→
開立電子發票
→
自動取得號碼
項目值
系統Odoo 17 + sp_einvoice 模組 v2.0
電子發票平台鯨躍科技 虛擬多通路
API 端點InvoiceMultiChannel/InvoiceAPI
認證方式officeid + posid + apipasswd（3 參數）
號碼管理平台自動分配（不需本地管理）
操作重點：
1. 應收憑單必須「已過帳」才能開立電子發票
2. 電子發票號碼由鯨躍平台即時分配
3. 作廢原因和折讓原因不可超過 20 字元
4. 折讓的含稅總額不可超過原發票金額
5. 測試機僅工作日 9:00~18:00 開放

寶星停車 © 2026  |  技術支援：OdooAI

11 / 11