Express Open API对接指南

1.申请API Key 

·在进行 API 对接前，请登录到 Cello Square（https://app.cellosquare.cn/）平台申请 API Key

·页面路径：我的主页 > Square API 管理页面 

2.申请API Key

·点击“新Square Open API Key”

·在弹出的对话框中为您的API账号取一个ID名称，只要符合规则，您可以任意取名，最后点击确认即可生成API Key

3. 申请 API Key 

·完成API key申请后，您可以在Square API管理页面中看到您的 API 账号信息（包含账户ID、API Key）

·Square Open API 门户网站：https://api.developer.cellosquare.com

4. 订单创建接口

·我们有两个订单创建接口，您可以根据需要选择其中一个进行对接：

·Order Create Quick Order：该接口不需要标注每一件货的Items信息

·Order Create Order Version1：该接口要求标注每一件货的Items信息

5.提货接口

·完成订单创建后，您需通过调用Request pickup order接口来获取快递单号，只有Pickup成功才算真正的下单成功 

·提货接口所需的Pickup_place_name参数是我们系统内部使用的提货地址别名，请联系运营人员获取 

·提货接口返回的tracking_no是快递的主单号，package_tracking_no是所有的快递单号

6. 获取 Label

·完成Pickup后，您可以通过Get Label接口获取快递面单

·Get Label需要使用订单创建接口中返回的Order ID作为参数来调取

·Label以URL的形式返回，您可以通过URL 下载Label，需要注意的是，URL的有效时间是半小时，请尽快下载保存

7.获取发票

·完成Pickup后，您可以通过Get CI接口获取订单的发票信息

·发票信息以Base64编码的形式返回

8.获取UPS Copy

·如果您使用的是UPS快递，您可以通过Get UPS Copy接口获取UPS的Copy

·Copy信息以 Base64 编码的形式返回

9.FAQ

Square Open API 门户网站：https://api.developer.cellosquare.com

10.FAQ

以上是比较常见的报错，如果您在进行API对接过程中遇到其他报错可邮件联系 square.cs.cn@samsung.com，请您在邮件中提供公司名称、报错截图以及订单的报文日志和Pickup日志，谢谢！