README

DPD PL API 客户端 for laravel。

要求

• PHP 8.2 或更高版本，且带有 json 扩展。

安装

推荐通过 Composer 进行安装。

composer require patryk-sawicki/dpd-laravel

后端使用

添加到环境变量

DPD_LOGIN = 'your_login'
DPD_API_KEY = 'your_password'
DPD_MASTER_FID = 'your_master_fid'
DPD_SANDBOX = false // optional - default false
DPD_CACHE_DEFAULT_TTL = 86400 // optional - default 86400 seconds
DPD_OUTPUT_DOC_FORMAT_V1 = 'PDF' // optional - default PDF
DPD_OUTPUT_DOC_PAGE_FORMAT_V1 = 'LBL_PRINTER' // optional - default LBL_PRINTER
DPD_OUTPUT_LABEL_TYPE_V1 = 'BIC3' // optional - default BIC3

导入类

use PatrykSawicki\DpdApi\app\Classes\Dpd;

生成运单标签

生成运单标签。

Dpd::generateWaybillLabel()->generate(array $data); // return ?

请求

[
            'openUMLFeV11' => [
                'packages' => [
                    'parcels' => [
                        'weight' => 20, //in kilograms
                        //'weightAdr' => 20, //in kilograms
                        'sizeX' => 10, //in centimeters
                        'sizeY' => 20, //in centimeters
                        'sizeZ' => 30, //in centimeters
                        'content' => 'Some content',
                        'customerData1' => 'parcel ref11',
                        'customerData2' => 'parcel ref33',
                        'customerData3' => 'parcel ref33',
                    ],
                    'payerType' => 'THIRD_PARTY',
                    'thirdPartyFID' => 1495,
                    'receiver' => [
                        'name' => 'John Doe',
                        //'address' => 'Testowa 1',
                        //'city' => 'Warszawa',
                        //'postalCode' => '99418',
                        'countryCode' => 'PL',
                        'phone' => '123456789',
                        'email' => 'pan@chcepaczke.pl',
                    ],
                    'sender' => [
                        'company' => 'qw',
                        'name' => 'John Doe',
                        'address' => 'Testowa 1',
                        'city' => 'Warszawa',
                        'postalCode' => '01234',
                        'countryCode' => 'PL',
                        'phone' => '123456789',
                        'email' => 'pan@chcepaczke.pl',
                    ],
                    'ref1' => 'cos tam 1',
                    'ref2' => 'cos tam 2',
                    'ref3' => 'cos tam 3',
                    'services' => [
                        //'dpdLQ' => null,
                        //'rod' => null,
                        //'carryIn' => null,
                        /*'declaredValue' => [
                            'amount' => 100,
                            'currency' => 'PLN',
                        ],*/
                        'dpdPickup' => [
                            'pudo' => 'PL14187',
                        ],
                    ],
                ],
            ],
            'pkgNumsGenerationPolicyV1' => 'ALL_OR_NOTHING',
            'langCode' => 'PL',
        ];

结果

[
  "Status" => "OK"
  "SessionId" => "238285549"
  "Packages" => [
    "Package" => [
      "Status" => "OK"
      "PackageId" => "220959048"
      "Parcels" => [
        "Parcel" => [
          "Status" => "OK"
          "ParcelId" => "248680600"
          "Waybill" => "0000003466547Q"
        ]
      ]
    ]
  ]
]

生成发货标签

生成发货标签。

Dpd::generateShippingLabel()->pdf(array $data); // return ?

请求

[
            'dpdServicesParamsV1' => [
                'policy' => 'STOP_ON_FIRST_ERROR',
                'session' => [
                    'packages' => [
                        'parcels' => [
                            'waybill' => '0000003466547Q',
                        ],
                    ],
                    'sessionType' => 'DOMESTIC',
                ],
            ],
            'outputDocFormatV1' => 'PDF', // ZPL
            'outputDocPageFormatV1' => 'LBL_PRINTER',
            'outputLabelType' => 'BIC3',
        ]

结果

[
  "documentData" => "JVBERi0xLjQKJeLjz9MKMiAwIG9iag..."
  "session" => [
    "packages" => [
      "parcels" => [
        "statusInfo" => [
          "status" => "OK"
        ]
        "waybill" => "0000003466551Q"
      ]
      "statusInfo" => [
        "status" => "OK"
      ]
    ]
    "statusInfo" => [
      "status" => "OK"
    ]
  ]
]

标签面板

添加生成标签的面板。

<x-dpd::labels-panel
    :weight=""
    :sizeX=""
    :sizeY=""
    :sizeZ=""
    :destination-code=""
    :receiverName=""
    :receiverAddress=""
    :receiverCity=""
    :receiverPostCode=""
    :receiverPhone=""
    :receiverEmail=""
    :senderName=""
    :senderEmail=""
    :senderAddress=""
    :senderCity=""
    :senderPostCode=""
    :senderPhone=""
    :disc=""
    :dir=""
    :file=""
/>

变更日志

变更日志可在 此处 查找。