Acumatica REST API 介紹

越來越多人問到,假如要將客戶的聯絡人資訊從自家開發或維護的系統傳遞到 Acumatica 雲端 ERP 系統中,進行統一管理,是否做得到。答案當然是沒問題的,只要透過 Acumatica 雲端 ERP 提供的兩種介接方式,Web Service 與 REST API 中的其中一種,就可以達到這樣的目的。

接下來,讓我們說明如何透過 REST API 的方式,將資料寫進 Acumatica 雲端 ERP 的 Contacts(聯絡人)中。開始前,請先下載 Postman 工具,因為在接下來的說明過程中,都將透過該工具來模擬執行 Acumatica 的 REST API。

首先,下載並安裝完畢 Postman 後,啟動該工具。

啟動 Postman

將外部系統的聯絡人資訊寫進 Acumatica 雲端 ERP 系統中,主要有三個步驟:

    
  1. 透過 API 登入 Acumatica 系統,
  2. 將資料透過 API 寫入 Acumatica 系統,
  3. 透過 API 登出 Acumatica 系統。

步驟一: 透過 API 登入 Acumatica 系統。

準備登入 Acumatica 系統前,首先將登入資訊用 JSON 格式準備好,然後透過 POST 的方式,執行 API: https:/{Acumatica 的位置}/entity/auth/login

登入成功時,我們將在 Postman 的畫面中,看到如下成功的訊息:

步驟二: 將資料透過 API 寫入 Acumatica 系統。

首先,我們需要準備欲存進 Acumatica 系統中的聯絡人資料,並將其存成 JSON 格式。接著,透過 PUT 的方式,執行 API: https:/{Acumatica 的位置}/entity/Default/20.200.001/Contact

步驟三: 透過 API 登出 Acumatica 系統。

登出 Acumatica 系統,我們只需透過 POST 的方式,執行 API: https:/{Acumatica 的位置}/entity/auth/logout

登出成功時,我們將在 Postman 的畫面中,看到如下成功的訊息:

登出 Acumatica

完成上述步驟後,登入 Acumatica 雲端 ERP 系統並進入 Contacts(聯絡人)功能中,透過查詢查看剛剛新增的資料,即可發現該筆新資料已經成功寫入 Acumatica 系統中。

資料進 Acumatica Contact 結果