patryk-sawicki/orlenpaczka-laravel

Orlen Paczka API 客户端,适用于 Laravel。

0.2.3 2024-03-28 15:30 UTC

This package is auto-updated.

Last update: 2024-09-28 16:31:11 UTC


README

Orlen Paczka API 客户端,适用于 Laravel。

要求

  • PHP 8.2 或更高版本,并启用 json 扩展。

安装

推荐通过 Composer 进行安装。

composer require patryk-sawicki/orlenpaczka-laravel

前端使用

地图按钮

将地图按钮添加到 blade 文件中。

<x-op::map-button/>

重要

  1. 您必须在 </head> 标签之前添加 @stack('after-css')
  2. 您必须在 </body> 标签之前添加 @stack('after-scripts')
  3. 选定的点将保存在 #orlenPointId 输入中。

后端使用

添加到 env

OP_API_ID = 'your_partner_id'
OP_API_KEY = 'your_partner_key'
OP_SANDBOX = false // optional - default false
OP_CACHE_DEFAULT_TTL = 86400 // optional - default 86400 seconds

导入类

use PatrykSawicki\OrlenPaczkaApi\app\Classes\OrlenPaczka;

所有点的列表。

获取所有点的列表。

OrlenPaczka::giveMeAllRUCHWithFilled()->list(); // return array

结果

[
    [
        'DestinationCode' => 'WS-100001-27-26',
        'StreetName' => 'ANNOPOL 17 TEST',
        'City' => 'Warszawa',
        'District' => 'Warszawa',
        'Latitude' => '52.311519',
        'Longitude' => '21.013830',
        'Province' => 'Mazowieckie',
        'CashOnDelivery' => 'true',
        'OpeningHours' => 'Pn-Pt:00:00-24:00, So:00:00-24:00, Nd:00:00-24:00',
        'Location' => 'Punkt testowy',
        'PSD' => '100001',
        'PointType' => 'PSD',
        'Filled' => 'false',
        'Suggestions' => [],
        'Available' => 'true',
        'ZipCode' => '03-236',
    ],
    ...
]

生成商业包裹标签

为商业包裹生成标签。

OrlenPaczka::generateLabelBusinessPack()->pdf(array $data); // return ?

请求

[
    [
        'DestinationCode' => 'WS-100001-27-26',
        'BoxSize' => 'S', // S, M, L
        'FirstName' => 'Jan',
        'LastName' => 'Kowalski',
        'PhoneNumber' => '123456789',
        'EMail' => 'aaa@bbb.pl',
        'SenderEMail' => 'aaa@bbb.pl',
        'SenderFirstName' => 'Jan',
        'SenderLastName' => 'Kowalski',
        'SenderStreetName' => 'Testowa 1',
        'SenderBuildingNumber' => '1',
        'SenderCity' => 'Warszawa',
        'SenderPostCode' => '00-001',
        'SenderPhoneNumber' => '123456789',
        'PrintAdress' => '1', // 1, 2
        'PrintType' => '1', // 1, 2
    ],
    ...
]

结果

// return pdf

标签面板

添加用于生成标签的面板。

<x-op::labels-panel 
    :destination-code=""
    :firstName=""
    :lastName=""
    :phoneNumber=""
    :email=""
    :senderEMail=""
    :senderFirstName=""
    :senderLastName=""
    :senderStreetName=""
    :senderBuildingNumber=""
    :senderCity=""
    :senderPostCode=""
    :senderPhoneNumber=""
    :disc=""
    :dir=""
    :file=""
/>

变更日志

变更日志可在 此处 查看。