adiyya/dhl-express-php-sdk

dev-main 2022-05-20 10:41 UTC

This package is auto-updated.

Last update: 2024-09-20 16:16:41 UTC


README

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

要获取标准 DHL 运输的 SDK,请参阅来自 Petschko 的优秀 SDK,我已经用它作为灵感。

要求

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

兼容性

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

安装

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

composer require adiyya/dhl-express-php-sdk

支持的 API 操作

用法

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

请求访问实时 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
  7. 带商业发票的应征税国际运输 - test_7.php
  8. 带商业发票和运费的应征税国际运输 - test_8.php

在测试 API 过程中我学到了一些东西

  • 即使是国家包裹,“InternationalDetail”部分也是必需的
  • 地址中的街道名称和街道号码目前没有任何影响,总是使用“StreetLines”字段
  • 收件人地址中的公司名称是包裹上的名称(第一行)
  • 包装尺寸是必需的,但不必非常精确(DHL 仍然会检查它们) - 因此,您可以使用您拥有的最小包装尺寸
  • “StreetLine”不能用于任何额外的名称 - 使用“StreetLines2”来完成此操作 - 总是将其用于街道名称和编号

更多细节将很快揭晓。此包正在开发中。