應用市集

DHL Shipping

v1.0.0

附加元件 由 Adminium 發佈 · 配送

總覽

給工坊用的貨運業者。工作做好之後,它會按這一批實際做出來的包裹去問取件要多少錢——重量來自耗掉的紙張——把回來的服務列出來,訂下其中一種,存好面單,並一路追到送達。業者不接受的地址會以一則讀得懂、改得掉的退回回來,而不是無聲失敗。它是照著貨運業者契約寫的,不是照著某一家公司寫的,所以下一家業者就是這一家的複製;示範裡它接的是替身通道,絕不會真的約到取件。

它依附在什麼上

附加元件擴充的是你已經在用的應用程式,它從不單獨部署。這一個依附於:

連線之後它可以做什麼

它需要你自己在貨運業者那邊的 API 金鑰與客戶編號。兩者都加密存放,在每次回應裡都遮蔽,永遠不會送到瀏覽器。連上之後,它可以讀取一件做好的工作,寫入出貨紀錄與追蹤事件,並把面單放進你的檔案儲存空間。它的伺服器端只能呼叫一個位址,其他都不行。

在你自己的安裝環境裡

  • 讀取它正在處理的那件工作
  • 建立與更新出貨紀錄
  • 把檔案寫進你的檔案儲存空間

它的伺服器程式碼可以連到的位址

  • express.api.dhl.com

這份清單就是全部:連到其他位址會被拒絕並記錄下來。

連線時需要什麼

一組 API 金鑰

它增加了什麼

它出現在哪裡 4
  • 工單上的出貨操作
  • 下單時的配送方式選擇
  • 客戶訂單上的出貨資訊
  • 後台設定裡「附加元件」下它自己的面板
它帶來的資料表 2
  • shipments
  • shipment_events
需要設定的項目 4
  • API 金鑰
  • 客戶編號
  • 改用替身通道
  • 取件截止時間

如果你把它關掉

中斷連線會移除附加元件的畫面。它絕不會刪掉自己建立的資料表、寫入的檔案或新增的紀錄 —— 它寫下的一切都留在你的資料庫裡。 交給它的憑證會隨之被撤銷並刪除。

會留下什麼

已經約好的出貨、面單與整段追蹤紀錄都原樣留著。

會消失什麼

貨運業者從下單頁、客戶訂單與工單上消失,存下的金鑰會被刪除。櫃檯交件跟以前一樣。

關於示範

本站的任何示範都不會真的呼叫別人的服務。每個附加元件都自帶一個替代傳輸層,回應來自內建資料,而且預設就是開著的。真正的憑證屬於自行架設的選擇,寫在該附加元件自己的 README 裡。

如何開啟它 在示範裡切到「印刷工坊」那一側,打開「附加元件」並開啟 DHL Shipping——接著打開一件做好的工作。

Adminium 與該公司沒有任何關係。