OpenCart EC-Ship (香港郵政投寄易) API 教學

EC-Ship(香港郵政)的送貨方式是從 OpenCart 3 開始預設到系統中,如果身處香港的你想送貨到不同

建立你的EC-SHIP API帳號

進入香港郵政的投寄易的網站,點擊最右方的「投寄易API」可以看見如上圖的畫面。想使用這個功能必須先申請一個帳戶,如何申請帳號就不作詳盡解釋了,因為都不是太難和複雜的步驟。只是完成登記後,系統會要求申請者等待電郵並激活帳戶。


登入EC-SHIP API帳號

成功登入後,可以看見以上的版面,在這裡我將相關要填寫入OpenCart的資料標籤出來,接下來就要登入你的OpenCart Admin。


OpenCart Admin

將在圖二中被標籤的位置填寫到相對應的欄位內,然後按右上方的儲存按鈕就完成基本步驟。別忘了要選擇「啟用」此送貨方式!


此案例及部份圖片,感謝J小姐提供。


由於API於最近更新了,所以這裡更提供了相關的更新PATCH給OpenCart 3的使用者。另外,由於經過測試後,Test Mode跟非Test Mode的作用不大,最終只是為運費報價,然後都可以將運費加到帳單內,所以更新了以下的PATCH後就選那一個也沒有所謂。

適用版本 OpenCart 3.0 或以上

API更新包下載(PHP版本5.5)

API更新包下載(PHP版本5.6)


關於PHP版本的問題,從網路中看到有編程師說PHP版本於5.5跟5.6是有個少許的差別,(就是說如果你的PHP是5.4或以下的版本是用不到這個插件功能的),就是更新了API後,5.6的版本會有一個關於 SoapClient PHP功能上的問題,所以如果你得知你的PHP版本是5.6就請使用第二個下載包

2018-04-16 4:54:31 - PHP Warning: SoapClient::__doRequest(): SSL operation failed with code 1. OpenSSL Error messages: error:14090086:SSL routines:SSL3_GET_SERVER_CERTIFICATE:certificate verify failed in /home/xxx/storage/modification/catalog/model/extension/shipping/ec_ship.php on line 491
2018-04-16 4:54:31 - PHP Warning: SoapClient::__doRequest(): Failed to enable crypto in /home/xxx/storage/modification/catalog/model/extension/shipping/ec_ship.php on line 491
2018-04-16 4:54:31 - PHP Warning: SoapClient::__doRequest(): connect() failed: Unspecified error in /home/xxx/storage/modification/catalog/model/extension/shipping/ec_ship.php on line 491

雖然經已跟伺服器供應商相討,但暫時還未有任何結果。若果有任何更新,我會在這裡繼續發表。


如果你已經是直接從 OpenCart 3 中修改了 API 就請不要下載以上的PATCH檔,因為PATCH會自動尋找系統中未被修改的位置,所以如果有任何問題時,官方人員的技術支援也會難以找到問題根源。