Articles on: Shipper Account

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


  1. Go to https://open.sf-express.com/


  1. 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)





  1. Fill the required information in the form and click 注册.



  1. Go to 控制台 - 开发者对接 - 新建应用 and input the required information. Click the button 下一步 to create the app successfully.


  1. 顾客编码, 沙箱校验码 and 生产校验码 will be generated for you. Keep them somewhere where you can easily access them.



  1. Please click 关联API and search EXP_RECE_CREATE_ORDER, the API list will be pop up.



  1. Please click 关联API and search COM_RECE_CLOUD_PRINT_WAYBILLS, the API list will be pop up.



  1. Please click the button of 关联, and the app EXP_RECE_CREATE_ORDER will be in status of 测试中 and COM_RECE_CLOUD_PRINT_WAYBILLS is 待配置.



  1. 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


  1. Add SF Express carrier account in AfterShip Shipping > Enter the required details > Submit details in Test mode.




  1. 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)





  1. 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


Updated on: 11/11/2024