alex-le/dhl-express-php-sdk

此包已被弃用且不再维护。未建议替代包。

DHL Express SDK

0.2 2022-05-20 09:55 UTC

This package is auto-updated.

Last update: 2023-01-20 11:25:46 UTC


README

这个非官方库封装了DHL Express JSON/REST API(称为MyDHL_API)的一些功能。

要获取标准DHL的SDK,请查看Petschko的伟大SDK,我已经从中获得灵感。

要求

  • DHL Express技术联系人提供的测试(和实时)凭证
  • PHP版本5.5或更高版本 (它可能在较旧版本上工作,但我不对这些提供支持)
  • Guzzle已安装

兼容性

本项目是为MyDHL API 版本v1编写的。

安装

您可以使用Composer将包安装到项目中

composer require alex-le/dhl-express-php-sdk

支持的API操作

操作 支持
RateRequest
ShipmentRequest
TrackingRequest
DocumentRetrieve
updateShipment
requestPickup

使用

请参阅示例以获取基本示例和生成测试标签的脚本(见下文)

请求访问实时API

为了获取实时账户的凭证,DHL要求测试某些场景的标签

测试脚本可以在示例文件夹中找到

  1. 国内运输,周六配送 - test_1.php
  2. 国内运输时间选项和2个包裹 - test_2.php
  3. 国际运输,免关税 - test_3.php
  4. 国际运输,需关税 - test_4.php
  5. 国际运输,需关税且服务为DDP - test_5.php
  6. 国际运输,需关税且付款账户不同 - test_6.php

在测试API期间学到的东西

  • "InternationalDetail"部分是强制性的,即使是国内包裹
  • 地址中的街道名称和街道号码目前没有任何效果,始终使用"StreetLines"字段
  • 收件人地址中的公司名称是包裹上的名称(第一行)
  • 包装尺寸是必填项,但不必非常精确(DHL仍会进行检查) - 因此您始终可以使用您拥有的最小包装尺寸
  • "StreetLine" 不能用于任何额外名称 - 使用 "StreetLines2" 来表示 - 总是用于街道名称和门牌号码

更多详细信息将随后提供。此包装正在制作中。