> For the complete documentation index, see [llms.txt](https://docs.a1erp.digiwin.com/a1ordermanual/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.a1erp.digiwin.com/a1ordermanual/04.91app/04.01-shang-dian-she-ding.md).

# 04.01商店設定

請先和您的91APP窗口發信申請開通API KEY，以取得APIKey及商店序號，核發後即可在A1的商店設定進行設定作業。

## 一、申請91APP 的APIKey

需發信向91APP申請API KEY，以取得APIKey 、商店序號的資訊

申請APIKey及商店序號需發信申請，下列為信件範例及需填寫的內容的參考：

\------------------------------------信件開始 (此部份是說明文字，請參閱後刪除)

Dear XXX，您好：

敝司的91APP要與鼎新【A1商務應用雲】系統串接API KEY，以利帳務管理，麻煩您協助開通，提供以下資訊&#x20;

1、需要收到X-API-KEY 的Email： (請填妥資料)&#x20;

2、需要收到X-API-KEY開啟密碼寄發的手機門號： (請填妥資料)&#x20;

3、附件提供鼎新存取API範圍文件： (請在系統右上方【我要發問】和客服索取資料再夾於於附件)

&#x20;4、限制IP位置：鼎新已提供給91APP，請您再確認，謝謝 (固定文字)&#x20;

申請人姓名：&#x20;

申請人連絡電話：&#x20;

申請公司：

\---------------------------------------信件結束

## 二、91APP商店設定

申請APIKey及商店序號核發後，可進行商店設定囉！

![](https://3741211229-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LIKjbHpTK_xLF7VhdDL%2F-Mdoe3fboWQpGDgRXTVI%2F-Mdoebni1WZwg2dDZuKB%2F2021-07-05_111545.png?alt=media\&token=b6c316cd-91e4-4d03-910c-7294431c0a43)

### 1、在【APIKey】及【商店序號】

【APIKey】及【商店序號】為必填，請填入91APP核發的資料

![](https://3741211229-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LIKjbHpTK_xLF7VhdDL%2F-Mdoe3fboWQpGDgRXTVI%2F-Mdog8EMiPEp9EJmmkSd%2F2021-07-05_112227.png?alt=media\&token=6f67a4f8-f651-4415-85e2-2ec71f60e116)

### 2、【商店名稱】

【商店名稱】為必填。會出現在列印裝箱單及寄件單的抬頭名稱

### 3、【銷貨客戶】

【銷貨客戶】為必填。待出貨訂單(電商訂單模組)轉至銷貨單(進銷存模組)後，產生的【銷貨單】上對應的客戶

![](https://3741211229-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LIKjbHpTK_xLF7VhdDL%2F-MdojVZJ4Ffq8gbC7ob6%2F-MdomQ1Gl8aEkgAFn1hn%2F2021-07-05_114831.png?alt=media\&token=6318dfa8-eea7-4e8b-83d8-4da7a1509a00)

請按【+】快速建立或在進銷存模組的「客戶資料」建立一個91APP的對應客戶後選入&#x20;

![](https://3741211229-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LIKjbHpTK_xLF7VhdDL%2F-MdojVZJ4Ffq8gbC7ob6%2F-MdomhOKgwBn78TQNI1k%2F2021-07-05_115109.png?alt=media\&token=f6ecc4f2-8a55-49a8-8910-ff7776fbd0d1)

(1)資料是連結「進銷存模組」的「基本資料-客戶資料」&#x20;

(2)客戶代號一經存檔就不能變更

(3)客戶簡稱為必填，之後可修改

(4)客戶類型請選擇為正式客戶

新增一個91APP商店的客戶該如何編客戶代號？

一般來說可編A101，詳細請參考下列【客戶代號編碼建議】 說明：

#### 目前編碼有提供二種方式：&#x20;

#### 第一種用預設的六碼數字流水&#x78BC;***\****&#x20;

優點：下次新增新客系統會預帶下一碼，例如第一家 000001，第二家即000002 不用花時間記住編碼規則及想下一號要編幾號

&#x20;缺點：同類型的客戶不會排序在一起，建立單據客戶下拉會先用客戶代號排序，或某些報表用客戶代號排序就顯得沒這麼整齊，或無法用某一碼查詢出同類客戶縮小範圍後，再點選要選的客戶這樣的操作

![](https://3741211229-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LIKjbHpTK_xLF7VhdDL%2F-MdojVZJ4Ffq8gbC7ob6%2F-Mdok9IbhUhABHT1Y2uZ%2F2020-10-14_102453.png?alt=media\&token=fb23d0eb-77c4-4501-89a2-b46e1ebba5f0)

#### 第二種：採用有意義的編碼規則：&#x20;

例如：第一碼編A=>指電商平台，

公司有經營多平台故第二碼編  1=>91APP，2==>蝦皮，3=>指露天，

一個平台可能會開立多個商店，流水碼流2碼=>01&#x20;

所以91APP的客戶代號是：A101，91APP的另一間店的客戶代號是A102&#x20;

蝦皮的客戶代號就會是：A201&#x20;

公司也會賣東西給實體通路的客戶，所以第一碼B=>指實體散客，

第二碼1是散客，若擔心碼數不夠未來會一直增加，就可以設定流水碼流6碼&#x20;

這樣客戶林小美的編號就是：B1000001 ；

王小川的編號是：B1000002&#x20;

公司也會賣商品給內部員工，但員工我們可以選擇編後面的點的碼，

例如BZ，流水碼一樣維持5碼方便記憶

故員工 陳小新 BZ000001&#x20;

員工張威威 BZ00002&#x20;

以上建議給您參考喔\~

請找出適合貴司的編碼原則，只要是具有排序佳、延展性好(有新客時就可加入排序在一起)，這樣就是很好的編碼囉！

客戶編碼還可觀看這些章節：[客戶代號編碼建議](https://docs.a1erp.digiwin.com/a1usermanual/02-ji-ben-zi-liao/010-ke-hu-zi-liao/011-ke-hu-dai-hao-bian-ma-jian-yi)、[品編、客編、廠編怎麼編較好？](https://docs.a1erp.digiwin.com/a1stockvideo/01-ji-ben-zi-liao/1.02-pin-bian-ke-bian-chang-bian-zen-mo-bian-jiao-hao)

### 4、【買方運費納入銷貨明細】

【買方運費納入銷貨明細】非必勾選

打勾後從91APP轉入的銷貨單，裡面會有運費金額帶入，

若您希望銷貨收入"不要"含有運費(買方消費者支付的運費，實際上並未收到這筆款，是91APP收走的)，且未使用發票模組，這個選項您可以選擇不要打勾；

但若您有租用系統的電子發票模組，發票實施要點規定開立的發票金額要等於客戶支付的金額，或是您有在91APP開立發票，此時運費需計入銷貨單一起開立發票或需將運費收入也認列為銷貨收入，之後91APP會開立運費發票給您，您就可在申報時折抵這項收入。

### 5、【運費商品代號】

若有勾選【買方運費納入銷貨明細】，

則需建立運費金額到時要產生的商品，不用一種金額建立一個運費，只要建一個運費商品就可以了，金額的部份系統會自動帶入91APP發生的金額

![](https://3741211229-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LIKjbHpTK_xLF7VhdDL%2F-Mdonutm5n4rBHzsQzvi%2F-Mdoq0TU-NNH2wZ-Xh3E%2F2021-07-05_120549.png?alt=media\&token=719d35bf-3fc6-4153-9b84-c0960f4f0732)

【運費】...開窗後，按【新增】可快速建立對應商品

![](https://3741211229-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LIKjbHpTK_xLF7VhdDL%2F-Mdonutm5n4rBHzsQzvi%2F-MdoqKc7MJaPC3iWfAHL%2F2021-07-05_112704.png?alt=media\&token=a0591fa5-7797-4e65-bd3d-b0b3cd09ed40)

此商品建議品編應在費用性商品內外，

另外要記得將【計算庫存數量與成本】"勾消"，才可以選入

![](https://3741211229-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LIKjbHpTK_xLF7VhdDL%2F-Mdonutm5n4rBHzsQzvi%2F-MdoqPZb1veIVZO_UwIY%2F2021-07-05_112743.png?alt=media\&token=95c99443-ca35-4619-b6b5-eab103fa1173)

建立內容後如下

![](https://3741211229-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LIKjbHpTK_xLF7VhdDL%2F-Mdonutm5n4rBHzsQzvi%2F-MdoqczB2pgLvVmX-Kk4%2F2021-07-05_112632.png?alt=media\&token=8a57e726-e3c7-4a75-965f-7970807a424a)

要勾消【計算庫存數量與成本】欄位有管制的原因是不計算庫存數量與成本，當運費一直發生時才不會在庫存彙總表形成很多負數庫存&#x20;

設定好後要勾選再按【確認】才會帶入喔！

![](https://3741211229-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LIKjbHpTK_xLF7VhdDL%2F-Mdot3YjXtpflup3HDzQ%2F-MdotVOFZr4stOnaMVCT%2F2021-07-05_112800.png?alt=media\&token=37ece106-b132-4829-8e48-09003c72d6ea)

品編建議例如可編為：S101 91APP運費 (編碼定義：S費用類,  1是91APP ,  01費用流水號)

關於品號編碼可參考的章節：[品號編碼建議](https://docs.a1erp.digiwin.com/a1usermanual/02-ji-ben-zi-liao/030-shang-pin-zi-liao/031-pin-hao-bian-ma-jian-yi)、[品編、客編、廠編怎麼編較好？](https://docs.a1erp.digiwin.com/a1stockvideo/01-ji-ben-zi-liao/1.02-pin-bian-ke-bian-chang-bian-zen-mo-bian-jiao-hao)、[商品編碼Excel操作實例](https://docs.a1erp.digiwin.com/a1stockvideo/01-ji-ben-zi-liao/1.03-shang-pin-bian-ma-excel-cao-zuo-shi-li)

### 6、【活動折扣】【紅利點數】【折價卷】

【活動折扣】【紅利點數】【折價卷】的欄位皆為賣家負擔的折扣，這些都是必填欄位喔！不論您的賣場有沒有發生這些活動或內容，都需預設進來，避免未來有相關內容時，造成資料不對應狀況，因此有規定都需填入喲！

![](https://3741211229-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LIKjbHpTK_xLF7VhdDL%2F-Mdonutm5n4rBHzsQzvi%2F-MdopoMZ8gZRa93JDS2I%2F2021-07-05_120424.png?alt=media\&token=a1376901-37da-409d-9597-c8732cbafc38)

### 7、【7-11子代碼】

寄件標籤必須輸入的欄位

![](https://3741211229-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LIKjbHpTK_xLF7VhdDL%2F-Mdou22_XZsXFOo27ee5%2F-MdtpdNLTYBPLIPV0D9X%2F2021-07-06_112138-1.png?alt=media\&token=eb0d26d3-a3e5-4e15-a102-d8570c21d064)

7-11子代號，為7-11大宗物流 標籤列印之必要資訊。可至91APP- OSM後台 ＞ OSM設定 ＞ 超商取貨服務申請及資料異動，查詢到商店的7-11子代碼

![](https://3741211229-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LIKjbHpTK_xLF7VhdDL%2F-Mdou22_XZsXFOo27ee5%2F-MdtojZDgoEIWbR-idRn%2F2021-07-06_111004.png?alt=media\&token=c11c35e3-8d44-479c-b669-3197cd9af5bb)

選擇後即可查看711的子代碼

![](https://3741211229-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LIKjbHpTK_xLF7VhdDL%2F-Mdou22_XZsXFOo27ee5%2F-MdtpAa2TTakAiuO73tY%2F2021-07-06_111938-1.png?alt=media\&token=8c5b2eca-52e2-4d99-904c-69c1e75f2767)

### 8、裝箱單列印商品圖 (僅支援裝箱單A4不分頁)

#### 裝箱單列印商品圖 (僅支援裝箱單A4不分頁)，勾選後列印這格式的裝箱單會帶出商品資料的第一張圖片

### 9、【課稅別】

開立發票否的欄位，預設是不開，例如交易金額是100元，若選不開，則銷貨收入會認列100元收入在收支結餘表(損益表)，

一般來說交易100元，會認列95元銷貨收入，因此大部份應需設定【應稅內含】

另一個選項是【免稅】，若您的商品是免稅品，可選此項，這樣轉入的銷貨單課稅別會預設為免稅喔！

轉入的銷貨單發票聯式會預設為電子發票，如有租用電子發票模組記得要選為【應稅內含】喲，這樣才不會每次轉入的銷貨單都要修改

以上，設定後儲存就綁定完成囉！
