Get Credentials to Access SF Express Shipping API
Overview
SF Express is a Shenzhen based multinational delivery services and logistics company. Connect your SF Express account to AfterShip Shipping and ship packages easily at your own negotiated rates.
Create SF Express shipper account
Go to https://open.sf-express.com/
Click 注册 if you are looking to create a business account outside of mainland China. You can also contact an SF Express sales representative and provide them with the following details:
公司名稱 (company name)
公司BR (company registration number)
擬註冊的郵箱 (intended registered email)
Fill the required information in the form and click 注册.
Go to 控制台 - 开发者对接 - 新建应用 and input the required information. Click the button 下一步 to create the app successfully.
顾客编码, 沙箱校验码 and 生产校验码 will be generated for you. Keep them somewhere where you can easily access them.
Please click 关联API and search EXP_RECE_CREATE_ORDER, the API list will be pop up.
Please click 关联API and search COM_RECE_CLOUD_PRINT_WAYBILLS, the API list will be pop up.
Please click the button of 关联, and the app EXP_RECE_CREATE_ORDER will be in status of 测试中 and COM_RECE_CLOUD_PRINT_WAYBILLS is 待配置.
Please click 配置 to Config the COM_RECE_CLOUD_PRINT_WAYBILLS and check the templates you needed for SF Express labels, please select 同步 for 面单接受方式.
The sizes of SF Express and Shipping for these templates are as follows. For API users, please use the value of Shipping paper size in the paper_size field when using the Shipping API .
| SF Express template description | SF Express template code | Shipping paper size |
|---|---|---|
| 丰密150标准模板100*150 | fm_150_standard_{partnerId} | 4x6 |
| 丰密180标准模板100*180 | fm_180_standard_{partnerId} | 4x7 |
| 丰密76130标准模板76*130 | fm_76130_standard_{partnerId} | 3x5 |
| 丰密210标准模板100*210 | fm_210_standard_{partnerId} | 4x8 |
| 丰密150港澳台国际模板100*150 | fm_150_international_{partnerId} | 4x6 |
| 丰密210港澳台国际模板100*210 | fm_210_international_{partnerId} | 4x8 |
| 丰密76130港澳台国际模板76*130 | fm_76130_international_{partnerId} | 3x5 |
Add SF Express carrier account in AfterShip Shipping > Enter the required details > Submit details in Test mode.
Use AfterShip Shipping to create your sandbox labels for 3 times, submit one of the generated label to SF qiao system from 控制台 - 开发者对接 - 查看 API - 电子面单. (Please convert the pdf label to png)
SF team will check the generated label and approve for your production credentials 顾客编码 and 生产校验码, the status will be from 测试中 to 待上线.
When using cloud printing, SF Express supports a maximum of 30 parcels. If the number of parcels exceeds this limit, an error will occur, and the error message will state: "Documents size must be less than 30."
Required API Credentials
Optional API Settings
SF Express labels support 2 languages. Please select your preferred value for the Label Template Language.
There are 2 options available: Chinese (Simplified) and Chinese (Traditional).
SF Express Developer Resources
API docs
Accepted service types
Updated on: 11/11/2024