# shunfeng-wms

**Repository Path**: pifeifei/shunfeng-wms

## Basic Information

- **Project Name**: shunfeng-wms
- **Description**: PHP 版本的顺丰云仓接口
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-15
- **Last Updated**: 2026-05-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 顺丰云仓 WMS PHP SDK

>本接口基于以下文档创建：

    顺丰供应链科技中心企业服务平台接入技术规范

## 安装

```shell
composer require pifeifei/shunfeng-wms
```


## 使用

```php

require_once __DIR__ . '/vendor/autoload.php'; // Autoload files using Composer autoload

use hVenus\SFExpressAPI\BSP\OrderService;

$testEnvPath = __DIR__.'/.env';

if (file_exists($testEnvPath)) {
    $dotenv = Dotenv::createImmutable(dirname($testEnvPath));
    $dotenv->load();
}

$configAll = include_once __DIR__.'/config/services.php';
$config = $configAll['sf_express']['bsp'];


$client = new \Pff\SFWarehouse\WarehouseClient($config);


// 3.1 商品接口 ITEM_SERVICE
$data = ['ItemRequest' => [
    'CompanyCode' => $client->getClient()->config()->client('companycode'),
    'Items' => [
        'Item' => [[
            'SkuNo' => 'sxmTest000001', // 商品编码
            'ItemName' => '测试鲜食海参6A', // 商品名称
            'Description' => '测试商品描述', // 品牌描述（别名）
            'StandardDescription' => '1斤', // 物品规格描述
            'IsPresent' => 'N', // 是否赠品, Y：是; N：否
            'IsVirtualProduct' => 'N', // 是否虚拟产品, Y：是; N：否
            // 'IsFragile' => 'N', // 是否易碎品： Y：是; N：否
            'ItemClass' => '鲜食海参', // 货品类型
            //        'StorageTemperature' => '5', // 存储温度: 5：零下18度以下
            // 'TransportTemperature' => '5', // 运输温度
        ]],
    ],
]];

$response = $client->getClient()
    ->proxy('http://127.0.0.1:8888')
    ->setData($data)
    ->addDataOptions(['service' => 'ITEM_SERVICE'])
    ->request();
dump($response->toArray());

// 或者
$data = [[
        'SkuNo' => 'sxmTest000001', // 商品编码
        'ItemName' => '测试鲜食海参6A', // 商品名称
        'Description' => '测试商品描述', // 品牌描述（别名）
        'StandardDescription' => '1斤', // 物品规格描述
        'IsPresent' => 'N', // 是否赠品, Y：是; N：否
        'IsVirtualProduct' => 'N', // 是否虚拟产品, Y：是; N：否
        'ItemClass' => '鲜食海参', // 货品类型
    ]];
$response = $client->itemService($data);
dump($response); 
```
更多参数请参考顺丰文档。


## License

MIT