{"id":14966787,"url":"https://github.com/yiier/yii2-cross-border-express","last_synced_at":"2025-10-25T17:30:36.552Z","repository":{"id":34903637,"uuid":"188538821","full_name":"yiier/yii2-cross-border-express","owner":"yiier","description":"跨境物流接口：云途物流、三态速递、飞特物流","archived":false,"fork":false,"pushed_at":"2022-07-30T07:11:39.000Z","size":208,"stargazers_count":29,"open_issues_count":1,"forks_count":8,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-10-30T01:58:41.482Z","etag":null,"topics":["express","yii2-extension"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yiier.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-05-25T08:09:20.000Z","updated_at":"2024-10-17T14:20:48.000Z","dependencies_parsed_at":"2022-08-24T22:50:46.064Z","dependency_job_id":null,"html_url":"https://github.com/yiier/yii2-cross-border-express","commit_stats":null,"previous_names":[],"tags_count":88,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yiier%2Fyii2-cross-border-express","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yiier%2Fyii2-cross-border-express/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yiier%2Fyii2-cross-border-express/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yiier%2Fyii2-cross-border-express/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yiier","download_url":"https://codeload.github.com/yiier/yii2-cross-border-express/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238019329,"owners_count":19402880,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["express","yii2-extension"],"created_at":"2024-09-24T13:36:56.756Z","updated_at":"2025-10-25T17:30:36.230Z","avatar_url":"https://github.com/yiier.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"Cross Border Express for Yii2\n================\n跨境物流接口，目前只支持:\n\n- 云途物流\n- 三态速递\n- 飞特物流\n- 华磊物流\n- 集优物流\n- 万邦物流\n- 速递管家\n- 易仓物流\n- 顺丰国际物流\n- K5物流系统\n- 燕文物流\n- 互联通物流\n\n[![Latest Stable Version](https://poser.pugx.org/yiier/yii2-cross-border-express/v/stable)](https://packagist.org/packages/yiier/yii2-cross-border-express) \n[![Total Downloads](https://poser.pugx.org/yiier/yii2-cross-border-express/downloads)](https://packagist.org/packages/yiier/yii2-cross-border-express) \n[![Latest Unstable Version](https://poser.pugx.org/yiier/yii2-cross-border-express/v/unstable)](https://packagist.org/packages/yiier/yii2-cross-border-express) \n[![License](https://poser.pugx.org/yiier/yii2-cross-border-express/license)](https://packagist.org/packages/yiier/yii2-cross-border-express)\n\n\nInstallation\n------------\n\nThe preferred way to install this extension is through [composer](http://getcomposer.org/download/).\n\nEither run\n\n```\nphp composer.phar require --prefer-dist yiier/yii2-cross-border-express \"*\"\n```\n\nor add\n\n```\n\"yiier/yii2-cross-border-express\": \"*\"\n```\n\nto the require section of your `composer.json` file.\n\n\nUsage\n-----\n\n\n### 配置\n\n```php\n\u003c?php\n\n$config = [\n    // HTTP 请求的超时时间（秒）\n    'timeout' =\u003e 5.0,\n\n    // 可用的平台配置\n    'platforms' =\u003e [\n       'santai' =\u003e [\n            'appKey' =\u003e 'xxx',\n            'token' =\u003e 'xxx',\n            'userId' =\u003e 'xxx'\n        ],\n        'yuntu' =\u003e [\n            'account' =\u003e 'xxx',\n            'secret' =\u003e 'xxx',\n        ],\n        'feite' =\u003e [\n            'token' =\u003e 'xxx',\n            'syncPlatformId' =\u003e '', // 订单同步平台标识(一般指第三方平台标识，格式类似：scb.logistics.flyt)\n            'accountId' =\u003e 'xxx',\n            'password' =\u003e '',\n            'printUsername' =\u003e '', // 面单接口需要\n            'printPassword' =\u003e '' // 面单接口需要\n        ],\n        'hualei' =\u003e [\n            'host' =\u003e '',\n            'print_host' =\u003e '',\n            'customer_id' =\u003e '', # 如果customer_id和customer_user_id不为空可不填username及password\n            'customer_user_id' =\u003e '',\n            'username' =\u003e '',\n            'password' =\u003e '',\n        ],\n        'jiyou' =\u003e [\n            'host' =\u003e '',\n            'user_token' =\u003e ''\n        ],\n        'wanb' =\u003e [\n            \"host\" =\u003e \"http://api-sbx.wanbexpress.com\",\n            \"account_no\" =\u003e \"\",\n            \"token\" =\u003e \"\",\n            \"warehouse_code\" =\u003e \"\",\n            \"oss_wan_domain\" =\u003e \"oss-cn-beijing.aliyuncs.com\",\n            \"oss_lan_domain\" =\u003e \"oss-cn-beijing-internal.aliyuncs.com\",\n            \"oss_bucket\" =\u003e \"\",\n            \"oss_access_key_id\" =\u003e \"\",\n            \"oss_access_key_secret\" =\u003e \"\",\n        ],\n        'courierbutler' =\u003e [\n            \"host\" =\u003e \"http://lfn.rtb56.com\",\n            \"app_token\" =\u003e \"\",\n            \"app_key\" =\u003e \"\",\n        ],\n        'eccang' =\u003e [\n            \"appKey\" =\u003e \"\",\n            \"appToken\" =\u003e \"\",\n            \"host\" =\u003e \"\"\n        ],\n        'sfexpress' =\u003e [\n            \"accesscode\" =\u003e \"\",\n            \"username\" =\u003e \"\",\n            \"checkword\" =\u003e \"\",\n            \"platform_code\" =\u003e \"\",\n        ], \n\t\t'k5' =\u003e [\n            \"host\" =\u003e \"\",\n            \"clientid\" =\u003e \"\",\n            \"token\" =\u003e \"\",\n        ],\n        'yw56' =\u003e [\n            \"host\" =\u003e '',\n            \"userId\" =\u003e '',\n            \"token\" =\u003e '',\n            \"ossBucket\" =\u003e '',\n            \"ossAccessKeyId\" =\u003e '',\n            \"ossAccessKeySecret\" =\u003e '',\n            \"ossLanDomain\" =\u003e \"oss-accelerate-internal.aliyuncs.com\",\n            \"ossWanDomain\" =\u003e \"oss-accelerate.aliyuncs.com\",\n        ],\n        'huiliantong' =\u003e [\n            'host' =\u003e \"\",\n            'userToken' =\u003e ''\n        ]\n    ],\n];\n\n$express = new \\yiier\\crossBorderExpress\\Express($config, 'santai');\n    \n```\n\n\n### 发货\n\n```php\n\u003c?php\n$expressOrder = new \\yiier\\crossBorderExpress\\contracts\\Order();\n$expressOrder-\u003ecustomerOrderNo = 'xxx';\n$expressOrder-\u003etransportCode = 'xxx';\n\n$goods[] = new \\yiier\\crossBorderExpress\\contracts\\Goods();\n$goods-\u003edescription = 'xxx';\n$goods-\u003ecnDescription = 'xxx';\n$goods-\u003equantity = 'xxx';\n$goods-\u003eweight = 'xxx';\n$goods-\u003ehsCode = 'xxx';\n$goods-\u003eenMaterial = 'cotton';\n$goods-\u003ecnMaterial = '棉';\n$goods-\u003eworth = 1; // 1美元;\n$goods-\u003esku = 'xxx'; // 云途某些渠道需要\n        \n$expressOrder-\u003egoods = $goods;\n$expressOrder-\u003eevaluate = 1; // 1美元\n$expressOrder-\u003etaxesNumber = 'xxx'; // 税号\n$expressOrder-\u003eisRemoteConfirm = 1; // 是否同意收偏远费\n$expressOrder-\u003eisReturn = 1; // 是否退件\n$expressOrder-\u003ewithBattery = 0; // 是否带电池\n\n$package = new \\yiier\\crossBorderExpress\\contracts\\Package();\n$package-\u003edescription = 'xxxx';\n$package-\u003equantity = 1;\n$package-\u003eweight = 'xxx';\n$package-\u003edeclareWorth = 1; // 1美元\n$expressOrder-\u003epackage = $package;\n\n\n$recipient = new \\yiier\\crossBorderExpress\\contracts\\Recipient();\n$recipient-\u003ecountryCode = 'xx';\n$recipient-\u003ename = 'xx';\n$recipient-\u003eaddress = 'xx';\n$recipient-\u003ecity = 'xx';\n$recipient-\u003estate = 'xx';\n$recipient-\u003ezip = 'xx';\n$recipient-\u003ephone = 'xx';\n$expressOrder-\u003erecipient = $recipient;\n\n$shipper = new \\yiier\\crossBorderExpress\\contracts\\Shipper();\n$shipper-\u003ecountryCode = 'CN';\n$shipper-\u003ename = 'xxx';\n$shipper-\u003ecompany = 'xxx';\n$shipper-\u003eaddress = 'xxx';\n$shipper-\u003ecity = 'xxx';\n$shipper-\u003estate = 'xxx';\n$shipper-\u003ezip = 'xx';\n$shipper-\u003ephone = 'xxx';\n$expressOrder-\u003eshipper = $shipper;\n    \n// 发货\n$express-\u003ecreateOrder($expressOrder);\n```\n\n\n### 获取物流方式\n\n```php\n\u003c?php\n$countryCode = 'US';\n$item = [];\nif (!empty($transports = $express-\u003egetTransportsByCountryCode($countryCode))) {\n    foreach ($transports as $transport) {\n        // 带跟踪号的物流方式\n        $item[$transport-\u003ecode] = [\n            'code' =\u003e $transport-\u003ecode,\n            'name' =\u003e $transport-\u003ecnName,\n            'is_tracking_no' =\u003e (int)$transport-\u003eifTracking,\n            'data' =\u003e $transport-\u003edata,\n        ];\n    }\n}\nreturn $item;\n```\n\n\n### 获取打印地址\n\n```php\n\u003c?php\n$orderNumber = 'xxx';\n$express-\u003egetPrintUrl($orderNumber);\n```\n\n### 获取订单详细费用\n\n```php\n\u003c?php\n$orderNumber = 'xxx';\n$express-\u003egetOrderFee($orderNumber);\n```\n\n## 相关链接\n\n- [云途接口文档](https://docs.qq.com/pdf/DVldoV2JWQ2hTQWNH)\n- [三态接口文档](http://www.sfcservice.com/api-doc)\n- [飞特接口文档](https://docs.qq.com/doc/DV1lrcURDTHNhRkR3)\n- [华磊接口文档](http://www.sz56t.com:8090/pages/viewpage.action?pageId=3473454)\n- [集优接口文档](http://120.25.155.64:8086/xms/download/api/HLT-XMS-API.docx)\n- [万邦接口文档](http://apidoc.wanbexpress.com/)\n- [速递管家接口文档](http://lfn.rtb56.com/usercenter/manager/api_document.aspx)\n- [易仓物流](http://ec.wiki.eccang.com/docs/show/2547)\n- [顺丰国际物流](http://docs.uat.trackmeeasy.com/api/)\n- [互联通物流系统](http://8.129.12.42:8086/xms/download/api/HLT-XMS-API.docx)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyiier%2Fyii2-cross-border-express","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyiier%2Fyii2-cross-border-express","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyiier%2Fyii2-cross-border-express/lists"}