Get Credentials to Access SF Express Shipping API
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.
Go to https://open.sf-express.com/, click button 注册, if you are trying to create a business account outside of China mainland, you can contact an SF Express sales representative and provide them with the following information: 公司名稱 (company name), 公司BR (company BR), and 擬註冊的郵箱 (intended registered email).
![](https://storage.crisp.chat/users/helpdesk/website/c31b6ca0d393080/image_c7opjw.png)
Fill the required information in the form and click 注册.
![](https://storage.crisp.chat/users/helpdesk/website/c31b6ca0d393080/image_1v7gnuu.png)
Go to 控制台 - 开发者对接 - 新建应用 and input the required information, click the button 下一步, then the app will be created successfully.
顾客编码, 沙箱校验码 and 生产校验码 will be generated for you, keep safe of them.
![](https://storage.crisp.chat/users/helpdesk/website/c31b6ca0d393080/image_1d4tqx8.png)
Please click 关联API and search EXP_RECE_CREATE_ORDER, the API list will be pop up.
![](https://storage.crisp.chat/users/helpdesk/website/c31b6ca0d393080/image_xrs5w3.png)
Please click 关联API and search COM_RECE_CLOUD_PRINT_WAYBILLS, the API list will be pop up.
![](https://storage.crisp.chat/users/helpdesk/website/c31b6ca0d393080/image_1i82jwx.png)
Please click the button of 关联, and the app EXP_RECE_CREATE_ORDER will be in status of 测试中 and COM_RECE_CLOUD_PRINT_WAYBILLS
is 待配置.
![](https://storage.crisp.chat/users/helpdesk/website/c31b6ca0d393080/image_1euc37b.png)
![](https://storage.crisp.chat/users/helpdesk/website/c31b6ca0d393080/image_15kkaaz.png)
Please click 配置 to Config the COM_RECE_CLOUD_PRINT_WAYBILLS and check the templates you needed for SF Express labels, please select 同步 for 面单接受方式.
![](https://storage.crisp.chat/users/helpdesk/website/c31b6ca0d393080/image_jdq3l4.png)
![](https://storage.crisp.chat/users/helpdesk/website/c31b6ca0d393080/image_1mmyv93.png)
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.
Add SF Express carrier account in AfterShip Shipping > Enter the required details > Submit details in Test mode.
![](https://storage.crisp.chat/users/helpdesk/website/c31b6ca0d393080/image_1ouczjx.png)
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)
![](https://storage.crisp.chat/users/helpdesk/website/c31b6ca0d393080/image_1q4kyob.png)
SF team will check the generated label and approve for your production credentials 顾客编码 and 生产校验码, the status will be from 测试中 -> 待上线.
![](https://storage.crisp.chat/users/helpdesk/website/c31b6ca0d393080/image_l1ejjp.png)
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."
![](https://storage.crisp.chat/users/helpdesk/website/c31b6ca0d393080/screenshot-2021-02-01-at-82803_s6dklz.png)
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).
![](https://storage.crisp.chat/users/helpdesk/website/c31b6ca0d393080/image_1dirail.png)
API docs
Accepted service types
Create SF Express shipper account
Go to https://open.sf-express.com/, click button 注册, if you are trying to create a business account outside of China mainland, you can contact an SF Express sales representative and provide them with the following information: 公司名稱 (company name), 公司BR (company BR), and 擬註冊的郵箱 (intended registered email).
![](https://storage.crisp.chat/users/helpdesk/website/c31b6ca0d393080/image_c7opjw.png)
Fill the required information in the form and click 注册.
![](https://storage.crisp.chat/users/helpdesk/website/c31b6ca0d393080/image_1v7gnuu.png)
Go to 控制台 - 开发者对接 - 新建应用 and input the required information, click the button 下一步, then the app will be created successfully.
顾客编码, 沙箱校验码 and 生产校验码 will be generated for you, keep safe of them.
![](https://storage.crisp.chat/users/helpdesk/website/c31b6ca0d393080/image_1d4tqx8.png)
Please click 关联API and search EXP_RECE_CREATE_ORDER, the API list will be pop up.
![](https://storage.crisp.chat/users/helpdesk/website/c31b6ca0d393080/image_xrs5w3.png)
Please click 关联API and search COM_RECE_CLOUD_PRINT_WAYBILLS, the API list will be pop up.
![](https://storage.crisp.chat/users/helpdesk/website/c31b6ca0d393080/image_1i82jwx.png)
Please click the button of 关联, and the app EXP_RECE_CREATE_ORDER will be in status of 测试中 and COM_RECE_CLOUD_PRINT_WAYBILLS
is 待配置.
![](https://storage.crisp.chat/users/helpdesk/website/c31b6ca0d393080/image_1euc37b.png)
![](https://storage.crisp.chat/users/helpdesk/website/c31b6ca0d393080/image_15kkaaz.png)
Please click 配置 to Config the COM_RECE_CLOUD_PRINT_WAYBILLS and check the templates you needed for SF Express labels, please select 同步 for 面单接受方式.
![](https://storage.crisp.chat/users/helpdesk/website/c31b6ca0d393080/image_jdq3l4.png)
![](https://storage.crisp.chat/users/helpdesk/website/c31b6ca0d393080/image_1mmyv93.png)
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.
![](https://storage.crisp.chat/users/helpdesk/website/c31b6ca0d393080/image_1ouczjx.png)
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)
![](https://storage.crisp.chat/users/helpdesk/website/c31b6ca0d393080/image_1q4kyob.png)
SF team will check the generated label and approve for your production credentials 顾客编码 and 生产校验码, the status will be from 测试中 -> 待上线.
![](https://storage.crisp.chat/users/helpdesk/website/c31b6ca0d393080/image_l1ejjp.png)
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
![](https://storage.crisp.chat/users/helpdesk/website/c31b6ca0d393080/screenshot-2021-02-01-at-82803_s6dklz.png)
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).
![](https://storage.crisp.chat/users/helpdesk/website/c31b6ca0d393080/image_1dirail.png)
SF Express Developer Resources
API docs
Accepted service types
Updated on: 21/02/2024
Thank you!