README

关于

这个PHP库旨在提供PostNL的REST和SOAP API的简单连接方式。通过在处理运单信息时抽象掉不必要的复杂性并提高容错性，您可以在几分钟内快速使用PostNL。
在底层，这个库使用异步通信和负载分割来提高性能。

重要通知

PHP绑定可以连接到PostNL的SOAP和REST API。

状态

* SOAP版本不可用。将回退到REST API。

说明

• 克隆此仓库
• 运行composer install（没有composer？访问https://getcomposer.org.cn/）
• 可选地运行composer require guzzlehttp/guzzle以使用Guzzle而不是直接使用cURL
• 您已经准备就绪！本README中有一个小型示例。查看完整文档以获取快速入门指南。

文档

示例

允许用户使用默认REST API下载标签

<?php

use Firstred\PostNL\PostNL;
use Firstred\PostNL\Entity\Customer;
use Firstred\PostNL\Entity\Address;
use Firstred\PostNL\Entity\Shipment;
use Firstred\PostNL\Entity\Dimension;

require_once __DIR__.'/vendor/autoload.php';

$customer = Customer::create([
    'CollectionLocation' => '123456',
    'CustomerCode'       => 'DEVC',
    'CustomerNumber'     => '11223344',
    'ContactPerson'      => 'Peter',
    'Address'            => Address::create([
        'AddressType' => '02',
        'City'        => 'Hoofddorp',
        'CompanyName' => 'PostNL',
        'Countrycode' => 'NL',
        'HouseNr'     => '42',
        'Street'      => 'Siriusdreef',
        'Zipcode'     => '2132WT',
    ]),
    'Email'              => 'info@voorbeeld.nl',
    'Name'               => 'Michael',
]);

$apikey = 'YOUR_API_KEY_HERE';
$sandbox = false;

$postnl = new PostNL($customer, $apikey, $sandbox);

$barcode = $postnl->generateBarcodeByCountryCode('NL');

$shipment = Shipment::create([
    'Addresses'           => [
        Address::create([
            'AddressType' => '01',
            'City'        => 'Utrecht',
            'Countrycode' => 'NL',
            'FirstName'   => 'Peter',
            'HouseNr'     => '9',
            'HouseNrExt'  => 'a bis',
            'Name'        => 'de Ruijter',
            'Street'      => 'Bilderdijkstraat',
            'Zipcode'     => '3521VA',
        ]),
    ],
    'Barcode'             => $barcode,
    'Dimension'           => new Dimension(/* weight */ '2000'),
    'ProductCodeDelivery' => '3085',
]);

header('Content-Type: application/pdf');
header('Content-Disposition: attachment; filename="label.pdf"');
echo base64_decode($postnl->generateLabel(
    /* The actual shipment */ $shipment, 
    /* The output format */ 'GraphicFile|PDF',
    /* Immediately confirm the shipment */ true
)
    ->getResponseShipments()[0]
    ->getLabels()[0]
    ->getContent()
);
exit;

完整文档

完整文档可在此页面上找到： https://postnl-php.readthedocs.io/

构建文档

文档会自动构建并在readthedocs.io上托管。您可以通过安装Sphinx并运行以下命令来构建本地的HTML副本：

pip install -r docs/requirements.txt

安装需求，然后

sphinx-build -b html docs builddir

在builddir目录中构建HTML输出。

许可协议

本库使用MIT许可协议进行许可。