經濟部商工行政資料開放平臺開發指引


本平臺開放資料提供原始檔案下載系統介接API兩種方式供開發人員取得及使用。

一、原始檔案下載

建議適用對象:欲取得「公司登記」或「商業登記」之民眾。
詳見上排選單的「資料目錄」內點選 「公司登記資料」或「商業登記資料」。由各資料集頁面內下載原始檔案資料(資料格式皆為csv檔案)。

二、系統介接API

建議適用對象:欲取得「公司登記」或「商業登記」之程式開發者。
詳見上排選單的「資料目錄」內點選 「公司登記介接」或「商業登記介接」。由各資料集頁面內點選Json或XML,以檢視該API介接指引說明。


以下提供本平臺之公開資料清單下載:

1.經濟部商業司開放資料清單
2.經濟部商業司開放資料清單(僅含API)

 

 

系統介接API介接指引



一、申請流程說明

1.可於上排選單的「資料目錄」內點選 「公司登記介接」或「商業登記介接」查看,或下載經濟部商業司開放資料清單(僅含API)比對各項API,挑選出適合介接使用者之API項目。
2.為確保平臺服務品質與維持系統效能,使用系統介接API之單位或個人請填寫使用告知書。[doc格式下載][odt格式下載]
3.填寫完告知書,請向計畫維運團隊遞件。聯絡信箱為:data.gcis@gmail.com。
4.本平臺在收到告知信件確認資料無誤後(*註一),會進行介接設定並發信通知告知者該介接設定已完成。

*註一: 本平臺系統介接API係透過來源IP進行白名單管控,請告知者務必於告知書內填寫外部IP,而非內部IP。


二、為提供穩定之服務環境,維持各項服務之可用性,本平臺針對系統介接API進行使用量管制。管制內容如下:
檢查項目 超出限制時,回應之異常訊息
本平臺最大總連線數量 本平臺介接服務達上限,請稍候再試。
介接使用者同時最大連線數量 超出同時最大連線數量。
介接使用者每日最大介接次數 超出本日最大介接次數。
三、本平臺針對系統介接API(以下簡稱API)使用的常見問題,進行錯誤處理。以下為回應之訊息:
檢查項目 API使用方式之回應異常訊息
此API不存在 識別值參數錯誤,請查明後繼續。
未向維運團隊提出告知或提出告知之IP不正確 非授權介接之IP(xxx.xxx.xxx.xxx),請查明後繼續。
$format格式輸入錯誤 格式參數錯誤,請查明後繼續。
$filter格式輸入錯誤 $filter格式輸入錯誤,請重新輸入。
此API不開放使用 此資料不開放。

 

 

各項API介接使用說明

API公式 http://data.gcis.nat.gov.tw/od/data/api/FCB90AB1-E382-45CE-8D4F-394861851E28?$format={format}&$filter=Business_Item eq {Business_Item}

使用參數
{format} :資料格式 :為必要條件: 請填入json或xml。
{Business_Item} :營業項目代碼 :為可選條件: 請參考營業項目代碼對照表

範例 XML範例

JSON範例
API公式 http://data.gcis.nat.gov.tw/od/data/api/5F64D864-61CB-4D0D-8AD9-492047CC1EA6?$format={format}&$filter=Business_Accounting_NO eq {Business_Accounting_NO}

使用參數
{format} :資料格式 :為必要條件: 請填入json或xml。
{Business_Accounting_NO} :公司統一編號 :為必要條件: 公司登記之下的公司統一編號。

範例 XML範例

JSON範例
API公式 http://data.gcis.nat.gov.tw/od/data/api/F05D1060-7D57-4763-BDCE-0DAF5975AFE0?$format={format}&$filter=Business_Accounting_NO eq {Business_Accounting_NO}

使用參數
{format} :資料格式 :為必要條件: 請填入json或xml。
{Business_Accounting_NO} :公司統一編號 :為必要條件: 公司登記之下的公司統一編號。

範例 XML範例

JSON範例
API公式 http://data.gcis.nat.gov.tw/od/data/api/236EE382-4942-41A9-BD03-CA0709025E7C?$format={format}&$filter=Business_Accounting_NO eq {Business_Accounting_NO}

使用參數
{format} :資料格式 :為必要條件: 請填入json或xml。
{Business_Accounting_NO} :公司統一編號 :為必要條件: 公司登記之下的公司統一編號。

範例 XML範例

JSON範例
API公式 http://data.gcis.nat.gov.tw/od/data/api/6BBA2268-1367-4B42-9CCA-BC17499EBE8C?$format={format}&$filter=Company_Name like {Company_Name} and Company_Status eq {Company_Status}

使用參數
{format} :資料格式 :為必要條件: 請填入json或xml。
{Company_Name} :公司名稱 :為必要條件: 公司登記之下公司名稱。
{Company_Status} :公司狀態代碼 :為必要條件: 請參考公司登記_公司狀態代碼對照表。

範例 XML範例

JSON範例
API公式 http://data.gcis.nat.gov.tw/od/data/api/F0E8FB8D-E2FD-472E-886C-91C673641F31?$format={format}&$filter=Company_Status eq {Company_Status} and Company_Location like {Company_Location} and Capital_Stock_Amount eq {Capital_Stock_Amount}

使用參數
{format} :資料格式 :為必要條件: 請填入json或xml。
{Company_Status} :公司狀態代碼 :為必要條件: 請參考公司登記_公司狀態代碼對照表。
{Company_Location} :公司地址 :為必要條件: 公司登記之下的登記地址,非營業地址。
{Capital_Stock_Amount} :公司資本額範圍代碼 :為必要條件: A: 5千元以下 1~4,999
B: 1萬元以下 5,000~9,999
C: 10萬元以下 10,000~99,999
D: 100萬元以下 100,000~999,999
E: 1千萬元以下 1,000,000~9,999,999
F: 1億元以下 10,000,000~99,999,999
G: 1億元以上 100,000,000以上

範例 XML範例

JSON範例
API公式 http://data.gcis.nat.gov.tw/od/data/api/8813AADD-D020-4C55-A703-FC15B49F4262?$format={format}&$filter=Company_Name like {Company_Name} and Company_Status eq {Company_Status}

使用參數
{format} :資料格式 :為必要條件: 請填入json或xml。
{Company_Name} :八大行業公司名稱 :為必要條件: 公司登記之下公司名稱。
{Company_Status} :公司狀態代碼 :為必要條件: 請參考公司登記_公司狀態代碼對照表。

範例 XML範例

JSON範例
API公式 http://data.gcis.nat.gov.tw/od/data/api/7E6AFA72-AD6A-46D3-8681-ED77951D912D?$format={format}&$filter=President_No eq {President_No} and Agency eq {Agency}

使用參數
{format} :資料格式 :為必要條件: 請填入json或xml。
{President_No} :商業統一編號 :為必要條件: 商業登記之下的商業統一編號。
{Agency} :商業申登機關代碼 :為必要條件: 請參考商業登記_申登機關代碼對照表。

範例 XML範例

JSON範例
API公式 http://data.gcis.nat.gov.tw/od/data/api/F570BC9A-DA4C-4813-8087-FB9CE95F9D38?$format={format}&$filter=President_No eq {President_No} and Agency eq {Agency}

使用參數
{format} :資料格式 :為必要條件: 請填入json或xml。
{President_No} :商業統一編號 :為必要條件: 商業登記之下的商業統一編號。
{Agency} :商業申登機關代碼 :為必要條件: 請參考商業登記_申登機關代碼對照表。

範例 XML範例

JSON範例
API公式 http://data.gcis.nat.gov.tw/od/data/api/A1B4CBFF-2D3A-409B-8A78-2AD94F63AE4A?$format={format}&$filter=Business_Name like {Business_Name} and Business_Current_Status eq {Business_Current_Status} and Agency eq {Agency}

使用參數
{format} :資料格式 :為必要條件: 請填入json或xml。
{Business_Name} :商業名稱 :為{Agency}或{Business_Current_Status}兩者擇一: 商業登記之下的商業名稱。
{Business_Current_Status} :商業狀態代碼 :為{Agency}或{Business_Current_Status}兩者擇一: 請參考商業登記_商業狀態代碼對照表。
{Agency} :商業申登機關代碼 :為必要條件: 請參考商業登記_申登機關代碼對照表。

範例 XML範例

JSON範例
API公式 http://data.gcis.nat.gov.tw/od/data/api/9D17AE0D-09B5-4732-A8F4-81ADED04B679?$format={format}&$filter=Business_Accounting_NO eq {Business_Accounting_NO}

使用參數
{format} :資料格式 :為必要條件: 請填入json或xml。
{Business_Accounting_NO} :公司統一編號 :為必要條件: 公司登記之下的公司統一編號。

範例 XML範例

JSON範例
API公式 http://data.gcis.nat.gov.tw/od/data/api/855A3C87-003A-4930-AA4B-2F4130D713DC?$format={format}&$filter=President_No eq {President_No}

使用參數
{format} :資料格式 :為必要條件: 請填入json或xml。
{President_No} :商業統一編號 :為必要條件: 商業登記之下的商業統一編號。

範例 XML範例

JSON範例
API公式 http://data.gcis.nat.gov.tw/od/data/api/902805B2-A8FB-4383-8D80-4C8E005560A9?$format={format}&$filter=Business_Name like {Business_Name} and Business_Register_Funds eq {Business_Register_Funds}

使用參數
{format} :資料格式 :為必要條件: 請填入json或xml。
{Business_Name} :商業名稱 :為必要條件: 商業登記之下的商業名稱。
{Business_Register_Funds} :商業資本額範圍代碼 :為必要條件: A: 5千元以下 1~4,999
B: 1萬元以下 5,000~9,999
C: 10萬元以下 10,000~99,999
D: 100萬元以下 100,000~999,999
E: 1千萬元以下 1,000,000~9,999,999
F: 1億元以下 10,000,000~99,999,999
G: 1億元以上 100,000,000以上

範例 XML範例

JSON範例
API公式 http://data.gcis.nat.gov.tw/od/data/api/0EAB3547-13B7-41D4-9AFB-F7221CF461C2?$format={format}&$filter=Business_Name like {Business_Name}

使用參數
{format} :資料格式 :為必要條件: 請填入json或xml。
{Business_Name} :商業名稱 :為必要條件: 商業登記之下的商業名稱。

範例 XML範例

JSON範例
API公式 http://data.gcis.nat.gov.tw/od/data/api/4E5F7653-1B91-4DDC-99D5-468530FAE396?$format={format}&$filter=Business_Accounting_NO eq {Business_Accounting_NO}

使用參數
{format} :資料格式 :為必要條件: 請填入json或xml。
{Business_Accounting_NO} :公司統一編號 :為必要條件: 公司登記之下的公司統一編號。

範例 XML範例

JSON範例
API公式 http://data.gcis.nat.gov.tw/od/data/api/C85A7BF4-4217-4E9A-9CB0-59FBBE9AB9BC?$format={format}&$filter=Branch_Office_Name like {Branch_Office_Name} and Branch_Office_Status eq {Branch_Office_Status}

使用參數
{format} :資料格式 :為必要條件: 請填入json或xml。
{Branch_Office_Name} :分公司名稱 :為必要條件: 此分公司名稱並非完整公司名稱,例:oo公司xx分公司,請使用xx分公司輸入查詢,而非oo公司xx分公司當作輸入參數。
{Branch_Office_Status} :分公司狀態代碼 :為必要條件: 請參考公司登記_公司狀態代碼對照表。

範例 XML範例

JSON範例
API公式 http://data.gcis.nat.gov.tw/od/data/api/4347A009-6489-4F19-AC79-78F366BE7976?$format={format}&$filter=Change_Of_Approval_Data eq {Change_Of_Approval_Data}

使用參數
{format} :資料格式 :為必要條件: 請填入json或xml。
{Change_Of_Approval_Data} :最後核准變更日期 :為必要條件: 民國年月日(共7碼);不足7碼請補零。

範例 XML範例

JSON範例
API公式 http://data.gcis.nat.gov.tw/od/data/api/F0CAB3B6-7A39-46DD-B490-0EED944783BD?$format={format}&$filter=CHG_APP_DATE eq {CHG_APP_DATE}

使用參數
{format} :資料格式 :為必要條件: 請填入json或xml。
{CHG_APP_DATE} :最後核准變更日期 :為必要條件: 民國年月日(共7碼);不足7碼請補零。

範例 XML範例

JSON範例
API公式 http://data.gcis.nat.gov.tw/od/data/api/4526A764-A491-49FA-8509-21DCF53BDF9D?$format={format}&$filter=CHG_APP_DATE eq {CHG_APP_DATE}

使用參數
{format} :資料格式 :為必要條件: 請填入json或xml。
{CHG_APP_DATE} :最後核准變更日期 :為必要條件: 民國年月日(共7碼);不足7碼請補零。

範例 XML範例

JSON範例
API公式 http://data.gcis.nat.gov.tw/od/data/api/9B84E7EF-7DEE-4426-A53D-059113F6B1E3?$format={format}&$filter=Business_Last_Change_Date eq {Business_Last_Change_Date}

使用參數
{format} :資料格式 :為必要條件: 請填入json或xml。
{Business_Last_Change_Date} :最近異動日期 :為必要條件: 民國年月日(共7碼);不足7碼請補零。

範例 XML範例

JSON範例
API公式 http://data.gcis.nat.gov.tw/od/data/api/63889EA2-6159-494D-9A00-48FA29DCB4D6?$format={format}&$filter=Cmpy_name like {Cmpy_name}

使用參數
{format} :資料格式 :為必要條件: 請填入json或xml。
{Cmpy_name} :外國公司名稱 :為必要條件: 公司登記之下外國公司名稱。

範例 XML範例

JSON範例
API公式 http://data.gcis.nat.gov.tw/od/data/api/4B61A0F1-458C-43F9-93F3-9FD6DA5E1B08?$format={format}&$filter=Responsible_Name eq {Responsible_Name}

使用參數
{format} :資料格式 :為必要條件: 請填入json或xml。
{Responsible_Name} :公司負責人姓名 :為必要條件: 公司登記之下公司的負責人姓名。

範例 XML範例

JSON範例
API公式 http://data.gcis.nat.gov.tw/od/data/api/35BCAB6C-9876-4356-B674-538E4F1DED5E?$format={format}&$filter=Business_Current_Status_Desc eq {Business_Current_Status_Desc} and Responsible_Name eq {Responsible_Name}

使用參數
{format} :資料格式 :為必要條件: 請填入json或xml。
{Business_Current_Status_Desc} :商業狀態說明 :為必要條件: 請參考商業登記_商業狀態代碼對照表。
{Responsible_Name} :商業負責人姓名 :為必要條件: 公司登記之下公司的負責人姓名。

範例 XML範例

JSON範例
API公式 http://data.gcis.nat.gov.tw/od/data/api/955A9F2C-8703-4550-A280-E6506B781A3B?$format={format}&$filter=Business_Item eq {Business_Item_C} and Register_Organization eq {Register_Organization} and Capital_Stock_Amount eq {Capital_Stock_Amount}

使用參數
{format} :資料格式 :為必要條件: 請填入json或xml。
{Business_Item_C} :營業項目代碼(C大類) :為必要條件: 請參考營業項目代碼對照表,必須為C大類下細類代碼。
{Register_Organization} :公司申登機關代碼 :為必要條件: 請參考公司登記_申登機關代碼對照表。
{Capital_Stock_Amount} :公司資本額範圍代碼 :為必要條件: A: 5千元以下 1~4,999
B: 1萬元以下 5,000~9,999
C: 10萬元以下 10,000~99,999
D: 100萬元以下 100,000~999,999
E: 1千萬元以下 1,000,000~9,999,999
F: 1億元以下 10,000,000~99,999,999
G: 1億元以上 100,000,000以上

範例 XML範例

JSON範例
API公式 http://data.gcis.nat.gov.tw/od/data/api/85F5E823-A0D5-4C2C-B7FA-765D80050ABA?$format={format}&$filter=Business_Item eq {Business_Item_I} and Register_Organization eq {Register_Organization} and Capital_Stock_Amount eq {Capital_Stock_Amount}

使用參數
{format} :資料格式 :為必要條件: 請填入json或xml。
{Business_Item_I} :營業項目代碼(I大類) :為必要條件: 請參考營業項目代碼對照表,必須為I大類下細類代碼。
{Register_Organization} :公司申登機關代碼 :為必要條件: 請參考公司登記_申登機關代碼對照表。
{Capital_Stock_Amount} :公司資本額範圍代碼 :為必要條件: A: 5千元以下 1~4,999
B: 1萬元以下 5,000~9,999
C: 10萬元以下 10,000~99,999
D: 100萬元以下 100,000~999,999
E: 1千萬元以下 1,000,000~9,999,999
F: 1億元以下 10,000,000~99,999,999
G: 1億元以上 100,000,000以上

範例 XML範例

JSON範例
API公式 http://data.gcis.nat.gov.tw/od/data/api/424C33E1-BB11-48D1-94D5-D4DD89DC940D?$format={format}&$filter=Business_Item eq {Business_Item_C} and Agency eq {Agency} and Business_Register_Funds eq {Business_Register_Funds}

使用參數
{format} :資料格式 :為必要條件: 請填入json或xml。
{Business_Item_C} :營業項目代碼(C大類) :為必要條件: 請參考營業項目代碼對照表,必須為C大類下細類代碼。
{Agency} :商業申登機關代碼 :為必要條件: 請參考商業登記_申登機關代碼對照表。
{Business_Register_Funds} :商業資本額範圍代碼 :為必要條件: A: 5千元以下 1~4,999
B: 1萬元以下 5,000~9,999
C: 10萬元以下 10,000~99,999
D: 100萬元以下 100,000~999,999
E: 1千萬元以下 1,000,000~9,999,999
F: 1億元以下 10,000,000~99,999,999
G: 1億元以上 100,000,000以上

範例 XML範例

JSON範例
API公式 http://data.gcis.nat.gov.tw/od/data/api/5639EDFF-87B0-4DDB-9936-41AB15DE58D5?$format={format}&$filter=Business_Item eq {Business_Item_F} and Agency eq {Agency} and Business_Register_Funds eq {Business_Register_Funds}

使用參數
{format} :資料格式 :為必要條件: 請填入json或xml。
{Business_Item_F} :營業項目代碼(F大類) :為必要條件: 請參考營業項目代碼對照表,必須為F大類下細類代碼。
{Agency} :商業申登機關代碼 :為必要條件: 請參考商業登記_申登機關代碼對照表。
{Business_Register_Funds} :商業資本額範圍代碼 :為必要條件: A: 5千元以下 1~4,999
B: 1萬元以下 5,000~9,999
C: 10萬元以下 10,000~99,999
D: 100萬元以下 100,000~999,999
E: 1千萬元以下 1,000,000~9,999,999
F: 1億元以下 10,000,000~99,999,999
G: 1億元以上 100,000,000以上

範例 XML範例

JSON範例
API公式 http://data.gcis.nat.gov.tw/od/data/api/8342199E-C41B-4DBB-BF58-2F0FB7BBCBCF?$format={format}&$filter=Business_Item eq {Business_Item_I} and Agency eq {Agency} and Business_Register_Funds eq {Business_Register_Funds}

使用參數
{format} :資料格式 :為必要條件: 請填入json或xml。
{Business_Item_I} :營業項目代碼(I大類) :為必要條件: 請參考營業項目代碼對照表,必須為I大類下細類代碼。
{Agency} :商業申登機關代碼 :為必要條件: 請參考商業登記_申登機關代碼對照表。
{Business_Register_Funds} :商業資本額範圍代碼 :為必要條件: A: 5千元以下 1~4,999
B: 1萬元以下 5,000~9,999
C: 10萬元以下 10,000~99,999
D: 100萬元以下 100,000~999,999
E: 1千萬元以下 1,000,000~9,999,999
F: 1億元以下 10,000,000~99,999,999
G: 1億元以上 100,000,000以上

範例 XML範例

JSON範例
API公式 http://data.gcis.nat.gov.tw/od/data/api/426D5542-5F05-43EB-83F9-F1300F14E1F1?$format={format}&$filter=President_No eq {President_No}

使用參數
{format} :資料格式 :為必要條件: 請填入json或xml。
{President_No} :商業統一編號 :為必要條件: 商業登記之下的商業統一編號。

範例 XML範例

JSON範例
API公式 http://data.gcis.nat.gov.tw/od/data/api/FDB8D2C8-573D-4276-BFA4-8D3925ABE1CB?$format={format}&$filter=Business_Accounting_NO eq {Business_Accounting_NO}

使用參數
{format} :資料格式 :為必要條件: 請填入json或xml。
{Business_Accounting_NO} :公司統一編號 :為必要條件: 公司登記之下的公司統一編號。

範例 XML範例

JSON範例
API公式 http://data.gcis.nat.gov.tw/od/data/api/C8782705-DA48-4897-8537-9F7B0FC463EF?$format={format}&$filter=Business_Item eq {Business_Item_F} and Register_Organization eq {Register_Organization} and Capital_Stock_Amount eq {Capital_Stock_Amount}

使用參數
{format} :資料格式 :為必要條件: 請填入json或xml。
{Business_Item_F} :營業項目代碼(F大類) :為必要條件: 請參考營業項目代碼對照表,必須為F大類下細類代碼。
{Register_Organization} :公司申登機關代碼 :為必要條件: 請參考公司登記_申登機關代碼對照表。
{Capital_Stock_Amount} :公司資本額範圍代碼 :為必要條件: A: 5千元以下 1~4,999
B: 1萬元以下 5,000~9,999
C: 10萬元以下 10,000~99,999
D: 100萬元以下 100,000~999,999
E: 1千萬元以下 1,000,000~9,999,999
F: 1億元以下 10,000,000~99,999,999
G: 1億元以上 100,000,000以上

範例 XML範例

JSON範例