sf-sdk 2.1.0.0__py3-none-any.whl

sf/__init__.py

@@ -0,0 +1,7 @@
+
+#!/usr/bin/python3
+# @Time    : 2019-08-21
+# @Author  : Kevin Kong (kfx2007@163.com)
+
+__version__ = "2.1.0.0"
+__author__ = "Kevin Kong"

sf/api.py

@@ -0,0 +1,35 @@
+#!/usr/bin/python3
+# @Time    : 2019-08-21
+# @Author  : Kevin Kong (kfx2007@163.com)
+
+from sf.comm import Comm
+from sf.order import Order
+from sf.order import Sheet
+import os
+import csv
+
+
+class SF(object):
+    """顺丰SDK"""
+
+    def __init__(self, clientcode, checkword, sandbox=False, language='zh-CN'):
+        """
+        初始化方法
+        """
+        self.clientcode = clientcode
+        self.checkword = checkword
+        self.sandbox = sandbox
+        self.language = language
+
+    comm = Comm()
+    order = Order()
+    sheet = Sheet()
+
+    @classmethod
+    def get_express_types(cls):
+        express = []
+        csv_path = os.path.dirname(__file__)
+        with open(os.path.join(csv_path, "data","express_type.csv")) as f:
+            for row in csv.reader(f):
+                express.append((row[0], row[1], row[2]))
+        return express

sf/comm/__init__.py

@@ -0,0 +1,2 @@
+from .comm import *
+from .exceptions import *

sf/comm/comm.py

@@ -0,0 +1,80 @@
+#!/usr/bin/python3
+# @Time    : 2019-08-21
+# @Author  : Kevin Kong (kfx2007@163.com)
+
+import requests
+import uuid
+import time
+from copy import copy
+import json
+
+URL = "https://bspgw.sf-express.com/std/service"
+HKURL = "https://sfapi-hk.sf-express.com/std/service"
+SANDBOXURL = "https://sfapi-sbox.sf-express.com/std/service"
+TOKEN_URL = "https://sfapi.sf-express.com/oauth2/accessToken"
+TOKEN_SANDBOXURL = "https://sfapi-sbox.sf-express.com/oauth2/accessToken"
+
+
+class Comm(object):
+    """封装公共请求"""
+
+    def __get__(self, instance, owner):
+        self._clientcode = instance.clientcode
+        self._checkword = instance.checkword
+        self._sandbox = instance.sandbox
+        self._language = instance.language
+        self.get_access_token()
+        return self
+
+    def get_access_token(self):
+        """获取AccessToken"""
+        url = f"{TOKEN_SANDBOXURL if self._sandbox else TOKEN_URL}?partnerID={self._clientcode}&secret={self._checkword}&grantType=password"
+        res = requests.post(url, headers={
+            "content-type": "application/x-www-form-urlencoded;charset=UTF-8"
+        }).json()
+        if res['apiResultCode'] == "A1000":
+            self._access_token = res['accessToken']
+        else:
+            raise Exception(
+                f"getting access token error:{res['apiResultCode'],res['apiErrorMsg']}")
+        return self._access_token
+
+    def get_public_params(self):
+        """获取公共参数"""
+        data = {
+            "partnerID": self._clientcode,
+            "requestID": str(uuid.uuid4()),
+            "timestamp": int(time.time()),
+            "accessToken": self._access_token
+        }
+        return data
+
+    def post(self, service, data):
+        """
+        提交请求
+
+        param data: 数据结构
+        """
+
+        post_data = self.get_public_params()
+        copy_data = copy(data)
+
+        for key, value in copy_data.items():
+            if value is None:
+                data.pop(key)
+
+        post_data.update({
+            "serviceCode": service,
+            "msgData": json.dumps(data)
+        })
+
+        headers = {
+            "content-type": "application/x-www-form-urlencoded"
+        }
+
+        url = SANDBOXURL if self._sandbox else URL
+        
+        res = requests.post(url, data=post_data, headers=headers).json()
+        if res['apiResultCode'] != 'A1000':
+            raise Exception(res['apiErrorMsg'])
+        return json.loads(res['apiResultData'])

sf/comm/exceptions.py

@@ -0,0 +1,7 @@
+#!/usr/bin/python3
+# @Time    : 2023-08-29
+# @Author  : Kevin Kong (kfx2007@163.com)
+
+class SheetException(Exception):
+
+    pass

sf/comm/token.py

@@ -0,0 +1,6 @@
+#!/usr/bin/python3
+# @Time    : 2022-12-03
+# @Author  : Kevin Kong (kfx2007@163.com)
+
+TOKEN_URL = "https://sfapi.sf-express.com/oauth2/accessToken"
+TOKEN_SANDBOXURL = "https://sfapi-sbox.sf-express.com/oauth2/accessToken"

sf/data/express_type.csv

@@ -0,0 +1,49 @@
+1,T4,顺丰特快
+2,T6,顺丰标快
+6,T104,顺丰即日
+10,T14,国际小包
+12,T7,国际特惠配送
+23,T9,顺丰国际特惠(文件)
+24,T9,顺丰国际特惠(包裹)
+29,T7,国际电商专递-标准
+30,T4,三号便利箱(特快)
+31,T4,便利封/袋(特快)
+32,T4,二号便利箱(特快)
+33,T4,岛内件(80CM)
+35,T23,物资配送
+39,T4,岛内件(110CM)
+50,T4,千点取60
+53,T4,电商盒子F1
+54,T4,电商盒子F2
+59,SP202,E顺递
+60,T4,顺丰特快（文件）
+61,T4,C1类包裹
+111,T36,顺丰干配
+153,T12,整车直达
+154,T6,重货包裹
+155,T6,标准零担
+199,T4,特快包裹
+201,T15,冷运标快
+202,T4,顺丰微小件
+209,T112,高铁专送
+215,T39,大票直送
+221,T15,香港冷运到家(≤60厘米)
+229,T57,精温专递
+231,T6,陆运包裹
+233,T56,精温专递（样本陆）
+235,T66,极效前置-预售
+238,T29,纯重特配
+242,T77,丰网速运
+247,T68,电商标快
+250,T70,极置店配
+255,T28,顺丰卡航
+256,T28,顺丰卡航（D类）
+257,T4,退换上门
+258,T4,退换自寄
+260,T68,入仓电标
+261,T68,O2O店配
+263,T11,同城半日达
+265,T67,预售电标
+266,T5,顺丰空配（新）
+283,T75,填舱标快
+285,T76,填舱电标

sf/model/__init__.py

@@ -0,0 +1,8 @@
+#!/usr/bin/python3
+# @Time    : 2022-12-03
+# @Author  : Kevin Kong (kfx2007@163.com)
+
+from . import contact
+from . import cargo
+from . import service
+from . import address

sf/model/address.py

@@ -0,0 +1,37 @@
+#!/usr/bin/python3
+# @Time    : 2022-12-12
+# @Author  : Kevin Kong (kfx2007@163.com)
+
+MAPPING = {
+    "Hong Kong":"香港",
+    "Macau":"澳门"
+}
+
+class Address(object):
+
+    def __init__(self,province=None,city=None,district=None,address=None,code=None):
+        self.province = province
+        self.city = city
+        self.district = district
+        self.address =address
+        self.code = code
+
+        if (self.province and self.province.lower() in ['hong kong','香港']) or (self.city and self.city.lower in ['hong kong','香港']):
+            self.code = '852'
+        if (self.province and self.province.lower() in ['macau','澳门']) or (self.city and self.city.lower in ['macau','澳门']):
+            self.code = '853'
+
+
+    def _convert(self,key):
+        if key in MAPPING:
+            return MAPPING[key]
+        return key
+    
+    def to_dict(self):
+        return {
+            "province":self._convert(self.province),
+            "city": self._convert(self.city),
+            "district": self.district,
+            "address": self.address,
+            "code": self.code
+        }

sf/model/cargo.py

@@ -0,0 +1,99 @@
+#!/usr/bin/python3
+# @Time    : 2022-12-03
+# @Author  : Kevin Kong (kfx2007@163.com)
+
+from copy import copy
+
+class CargoDetail(object):
+
+    def __init__(self, name, count=None, unit=None, weight=None, amount=None, currency=None, sourceArea=None, **kwargs):
+        """
+        货物信息
+
+        param count: Number(5)	条件	货物数量 跨境件报关需要填写
+        param unit: String(30)	条件	货物单位，如：个、台、本， 跨境件报关需要填写
+        param weight: Number(16,3)	条件	订单货物单位重量，包含子母件， 单位千克，精确到小数点后3位 跨境件报关需要填写
+        param amount: Number(17,3)	条件	货物单价，精确到小数点后3位， 跨境件报关需要填写
+        param currency: String(5)	条件	货物单价的币别： 参照附录《国际件币别表》
+        param sourceArea: String(5)	条件	原产地国别， 跨境件报关需要填写
+        param productRecordNo: String(18)	否	货物产品国检备案编号
+        param goodPrepardNo: String(100)	否	商品海关备案号
+        param taxNo: String(100)	否	商品行邮税号
+        param hsCode: String(100)	否	海关编码
+        param goodsCode: String(60)	否	商品编号
+        param brand: String(60)	否	货物品牌
+        param specifications:String(60)	否	货物规格型号
+        param manufacturer:String(100)	否	生产厂家
+        param shipmentWeight:Double (16,3)	否	托寄物毛重
+        param length:Double (16,3)	否	托寄物长
+        param width:Double (16,3)	否	托寄物宽
+        param height:Double (16,3)	否	托寄物高
+        param volume:Double (16,2)	否	托寄物体积
+        param cargoDeclaredValue:Double (16,5)	否	托寄物声明价值（杭州口岸必填）
+        param declaredValueDeclaredCurrency	String(5)	否	托寄物声明价值币别（杭州口岸必填）
+        param cargoId:String(60)	否	货物id（逆向物流）
+        param intelligentInspection	Number(1):否	智能验货标识(1-是,0-否) （逆向物流）
+        param snCode:String(4000)	否	货物标识码（逆向物流）
+        param stateBarCode: String(50)	否	国条码
+        """
+        self.name = name
+        self.count = count
+        self.unit = unit
+        self.weight = weight
+        self.amount = amount
+        self.currency = currency
+        self.sourceArea = sourceArea
+        self.productRecordNo = kwargs.get('productRecordNo',None)
+        self.goodPrepardNo = kwargs.get('goodPrepardNo',None)
+        self.taxNo = kwargs.get('taxNo',None)
+        self.hsCode = kwargs.get('hsCode',None)
+        self.goodsCode = kwargs.get('goodsCode',None)
+        self.brand = kwargs.get('brand',None)
+        self.specifications = kwargs.get('specifications',None)
+        self.manufacturer = kwargs.get('manufacturer',None)
+        self.shipmentWeight = kwargs.get('shipmentWeight',None)
+        self.length = kwargs.get('length',None)
+        self.width = kwargs.get('width',None)
+        self.height = kwargs.get('height',None)
+        self.volume = kwargs.get('valume',None)
+        self.cargoDeclaredValue = kwargs.get('cargoDeclaredValue',None)
+        self.declaredValueDeclaredCurrency = kwargs.get('declaredValueDeclaredCurrency',None)
+        self.cargoId = kwargs.get('cargoId',None)
+        self.intelligentInspection = kwargs.get('intelligentInspection',None)
+        self.snCode = kwargs.get('snCode',None)
+        self.stateBarCode = kwargs.get('stateBarCode',None)
+
+    def to_dict(self):
+        res = {
+            "name": self.name,
+            "count": self.count,
+            "unit": self.unit,
+            "weight": self.weight,
+            "amount": self.amount,
+            "currency": self.currency,
+            "sourceArea": self.sourceArea,
+            "productRecordNo": self.productRecordNo,
+            "goodPrepardNo": self.goodPrepardNo,
+            "taxNo": self.taxNo,
+            "hsCode": self.hsCode,
+            "goodsCode": self.goodsCode,
+            "brand": self.brand,
+            "specifications": self.specifications,
+            "manufacturer": self.manufacturer,
+            "shipmentWeight": self.shipmentWeight,
+            "length": self.length,
+            "width": self.width,
+            "height": self.height,
+            "volume": self.volume,
+            "cargoDeclaredValue": self.cargoDeclaredValue,
+            "declaredValueDeclaredCurrency": self.declaredValueDeclaredCurrency,
+            "cargoId": self.cargoId,
+            "intelligentInspection": self.intelligentInspection,
+            "snCode": self.snCode,
+            "stateBarCode": self.stateBarCode
+        }
+        copy_data = copy(res)
+        for k, v in copy_data.items():
+            if v is None:
+                res.pop(k)
+        return res

sf/model/contact.py

@@ -0,0 +1,46 @@
+#!/usr/bin/python3
+# @Time    : 2022-12-03
+# @Author  : Kevin Kong (kfx2007@163.com)
+
+from copy import copy
+
+
+class ContactInfo(object):
+
+    def __init__(self, address, country='CN', contactType=2, company=None, contact=None, mobile=None, zoneCode=None, province=None, city=None, postCode=None, email=None, taxNo=None, tel=None):
+        self.address = address
+        self.country = country
+        self.contactType = contactType
+        self.company = company
+        self.contact = contact
+        self.mobile = mobile
+        self.tel = tel
+        self.zoneCode = zoneCode
+        self.province = province
+        self.city = city
+        self.postCode = postCode
+        self.email = email
+        self.taxNo = taxNo
+
+    def to_dict(self):
+        res = {
+            "address":self.address,
+            "country":self.country,
+            "contactType":self.contactType,
+            "company":self.company,
+            "contact":self.contact,
+            "mobile":self.mobile,
+            "tel": self.tel,
+            "zoneCode":self.zoneCode,
+            "province":self.province,
+            "city":self.city,
+            "postCode":self.postCode,
+            "email":self.email,
+            "taxNo":self.taxNo,
+        }
+
+        copy_data = copy(res)
+        for k, v in copy_data.items():
+            if v is None:
+                res.pop(k)
+        return res

sf/model/service.py

@@ -0,0 +1,31 @@
+#!/usr/bin/python3
+# @Time    : 2022-12-03
+# @Author  : Kevin Kong (kfx2007@163.com)
+
+from copy import copy
+
+class Service(object):
+
+    def __init__(self, name, value=None, value1=None, value2=None, value3=None, value4=None):
+        self.name = name
+        self.value = value
+        self.value1 = value1
+        self.value2 = value2
+        self.value3 = value3
+        self.value4 = value4
+
+    def to_dict(self):
+        res = {
+            "name": name,
+            "value": value,
+            "value1": value1,
+            "value2": value2,
+            "value3": value3,
+            "value4": value4,
+        }
+
+        copy_data = copy(res)
+        for k, v in copy_data.items():
+            if v is None:
+                res.pop(k)
+        return res

sf/order/__init__.py

@@ -0,0 +1,2 @@
+from .order import *
+from .sheet import * 

sf/order/order.py

@@ -0,0 +1,314 @@
+#!/usr/bin/python3
+# @Time    : 2019-08-21
+# @Author  : Kevin Kong (kfx2007@163.com)
+
+from sf.comm import Comm
+
+QUERY_URL = "https://www.sf-express.com/we/ow/chn/sc/waybill/waybill-detail/"
+
+
+class Order(Comm):
+
+    def pre_order(self, orderId, contactInfoList, cargoDetails, monthlyCard=None, expressTypeId=1, isReturnRoutelabel=1, **kwargs):
+        data = {
+            "language": kwargs.get("language",None) or self._language,
+            "orderId": orderId,
+            "contactInfoList": [c.to_dict() for c in contactInfoList],
+            "cargoDetails": [c.to_dict() for c in cargoDetails],
+            "monthlyCard": monthlyCard,
+            "expressTypeId": expressTypeId,
+            "isReturnRoutelabel": isReturnRoutelabel,
+        }
+
+        data.update(kwargs)
+        return self.post("EXP_RECE_PRE_ORDER", data)
+
+    def create_order(self, orderId, contactInfoList, cargoDetails, monthlyCard=None, expressTypeId=1, isReturnRoutelabel=1, **kwargs):
+        """
+        下订单接口
+
+        param language:String(10) 必填 响应报文的语言， 缺省值为zh-CN，目前支持以下值zh-CN 表示中文简体， zh-TW或zh-HK或 zh-MO表示中文繁体， en表示英文
+        param orderId: String(64) 客户订单号，不能重复
+        param waybillNoInfoList: List		顺丰运单号
+        param customsInfo: CustomsInfo 报关信息
+        param cargoDetails: List 托寄物信息
+        param cargoDesc: String(20) 拖寄物类型描述,如： 文件，电子产品，衣服等
+        param extraInfoList: List 扩展属性
+        param serviceList: List 增值服务信息，支持附录： 《增值服务产品表》
+        param contactInfoList: List 收寄双方信息
+        param monthlyCard: String(20): 条件 顺丰月结卡号 月结支付时传值，现结不需传值；沙箱联调可使用测试月结卡号7551234567（非正式，无须绑定，仅支持联调使用）
+        param payMethod: Number(2): 1: 付款方式，支持以下值： 1:寄方付 2:收方付 3:第三方付
+        param expressTypeId: Number(5): 1: 快件产品类别， 支持附录 《快件产品类别表》 的产品编码值，仅可使用与顺丰销售约定的快件产品
+        param parcelQty: Number(5): 1: 包裹数，一个包裹对应一个运单号；若包裹数大于1，则返回一个母运单号和N-1个子运单号
+        param totalLength: Number(16,5) 客户订单货物总长，单位厘米， 精确到小数点后3位， 包含子母件
+        param totalWidth: Number(16,5) 客户订单货物总宽，单位厘米， 精确到小数点后3位， 包含子母件
+        param totalHeight: Number(16,5) 客户订单货物总高，单位厘米， 精确到小数点后3位， 包含子母件
+        param volume: Number(16,5) : 订单货物总体积，单位立方厘米, 精确到小数点后3位，会用于计抛 (是否计抛具体商务沟通中 双方约定)
+        param totalWeight: Number(17,5): 条件 订单货物总重量（郑州空港海关必填）， 若为子母件必填， 单位千克， 精确到小数点后3位，如果提供此值， 必须>0 (子母件需>6)
+        param totalNetWeight: Number(17,5) 商品总净重
+        param sendStartTm: Date: 接收 到报 文的 时间: 要求上门取件开始时间， 格式： YYYY-MM-DD HH24:MM:SS， 示例： 2012-7-30 09:30:00 （预约单传预约截止时间，不赋值默认按当前时间下发，1小时内取件）
+        param isDocall: Number(1): 0: 是否通过手持终端 通知顺丰收派 员上门收件，支持以下值： 1：要求 0：不要求
+        param isSignBack: Number(1): 0: 是否返回签回单 （签单返还）的运单号， 支持以下值： 1：要求 0：不要求
+        param custReferenceNo: String(100) 客户参考编码：如客户原始订单号
+        param temperatureRange: Number(2): 条件 温度范围类型，当 express_type为12 医药温控件 时必填，支持以下值： 1:冷藏 3：冷冻
+        param orderSource: String(50) 订单平台类型 （对于平台类客户， 如果需要在订单中 区分订单来源， 则可使用此字段） 天猫:tmall， 拼多多：pinduoduo， 京东 : jd 等平台类型编码
+        param remark: String(100) 备注
+        param isOneselfPickup: Number(1): 0: 快件自取，支持以下值： 1：客户同意快件自取 0：客户不同意快件自取
+        param filterField: String 筛单特殊字段用来人工筛单
+        param isReturnQRCode: Number(1): 0: 是否返回用来退货业务的 二维码URL， 支持以下值： 1：返回二维码 0：不返回二维码
+        param specialDeliveryTypeCode: String(3) 特殊派送类型代码 1:身份验证
+        param specialDeliveryValue: String(100) 特殊派件具体表述 证件类型: 证件后8位如： 1:09296231（1 表示身份证， 暂不支持其他证件）
+        param merchantPayOrderNo: String(100) 商户支付订单号
+        param isReturnSignBackRoute label: Number(1): 0: 是否返回签回单路由标签： 默认0， 1：返回路由标签， 0：不返回
+        param isReturnRoutelabel: Number(1): 1: 是否返回路由标签： 默认1， 1：返回路由标签， 0：不返回；除部分特殊用户外，其余用户都默认返回
+        param isUnifiedWaybillNo: Number(1): 0: 是否使用国家统一面单号 1：是， 0：否（默认）
+        param podModelAddress: String(1024) 签单返还范本地址
+        param inProcessWaybillNo: String(100) 头程运单号（郑州空港海关必填）
+        param isGenWaybillNo: Number(1)	1	是否需求分配运单号1：分配 0：不分配（若带单号下单，请传值0）
+
+        return: dict 接口返回结果
+                success: true/false 接口调用是否成功
+                errorCode: 错误码
+                errorMsg: 错误信息
+                msgData: 成功后返回的数据
+        """
+        data = {
+            "language": kwargs.get("language",None) or self._language,
+            "orderId": orderId,
+            "contactInfoList": [c.to_dict() for c in contactInfoList],
+            "cargoDetails": [c.to_dict() for c in cargoDetails],
+            "monthlyCard": monthlyCard,
+            "expressTypeId": expressTypeId,
+            "isReturnRoutelabel": isReturnRoutelabel,
+        }
+
+        data.update(kwargs)
+        return self.post("EXP_RECE_CREATE_ORDER", data)
+
+    def create_sub_order(self, orderId, parcelQty, waybillNoInfoList=None):
+        """
+        子单号申请接口-速运类API
+        客户在下单成功后 ，因业务场景需要可以调用此接口获取更多的子单号数。但不能超过配置的最大数/1200个。
+
+        :param orderId: 客户订单号
+        :param parcelQty: 子单号数
+        :param waybillNoInfoList: 顺丰运单号子单申请需要指定每个子包裹的长宽高提交重量时需要传入此参数
+        """
+
+        data = {
+            "orderId": orderId,
+            "parcelQty": parcelQty,
+            "waybillNoInfoList": waybillNoInfoList
+        }
+
+        return self.post("EXP_RECE_GET_SUB_MAILNO", data)
+
+    def confirm_order(self, orderId, dealType=1, **kwargs):
+        """
+        订单确认/取消接口-速运类API
+
+        param: orderId	String(64)	是		客户订单号
+        param: dealType	Number(1)	否	1	客户订单操作标识: 1:确认 (丰桥下订单接口默认自动确认，不需客户重复确认，该操作用在其它非自动确认的场景) 2:取消
+        param: waybillNoInfoList	List	否		顺丰运单号(如dealtype=1， 必填)
+        param: customsBatchs	String(20)	否		报关批次
+        param: collectEmpCode	String(30)	否		揽收员工号
+        param: inProcessWaybillNo	String(100)	否		头程运单号
+        param: sourceZoneCode	String(10)	否		原寄地网点代码
+        param: destZoneCode	String(10)	否		目的地网点代码
+        param: totalWeight	Number(17,5)	否		订单货物总重量，包含子母 件，单位千克，精确到小数点 后3位，如果提供此值，必 须>0
+        param: totalVolume	Number(16,5)	否		订单货物总体积，单位立方厘 米，精确到小数点后3位，会 用于计抛（是否计抛具体商务 沟通中双方约定）
+        param: expressTypeId	Number(5)	否		快件产品类别，支持附录《快 件产品类别表》的产品编码 值，仅可使用与顺丰销售约定 的快件产品
+        param: extraInfoList	List	否		扩展属性
+        param: totalLength	Number(16, 5)	否		客户订单货物总长，单位厘米， 精确到小数点后3位，包含子 母件
+        param: totalWidth	Number(16, 5)	否		客户订单货物总宽，单位厘米， 精确到小数点后3位，包含子 母件
+        param: totalHeight	Number(16, 5)	否		客户订单货物总高，单位厘米， 精确到小数点后3位，包含子 母件
+        param: serviceList	List	否		增值服务信息
+        param: isConfirmNew	Number (1)	否		是否走新通用确认1：支持修改联系人 2：支持改其他客户订单默认0
+        param: destContactInfo	OrderContactInfoDto	否		收件人信息
+        param: isDocall	Number(1)	否		是否通过手持终端通知顺丰收派员上门收件， 支持以下值：1：要求其它为不要求
+        param: specialDeliveryTypeCode	String(3)	否		1. 特殊派送类型代码 身份验证 2. 极效前置单
+        param: specialDeliveryValue	String(100)	否		1> 特殊派件具体表述 证件类型:证件后8位 如：1:09296231（1表示身份证，暂不支持其他证件） 2>.极效前置单时:Y:若不支持则返回普通运单N:若不支持则返回错误码
+        param: sendStartTm	Date	否		预约时间(上门揽收时间)
+        param: pickupAppointEndtime	Date	否		上门揽收截止时间
+        """
+        data = {
+            "orderId": orderId,
+            "dealType": dealType
+        }
+
+        data.update(kwargs)
+        return self.post("EXP_RECE_UPDATE_ORDER", data)
+
+    def get_order(self, orderId, searchType='1', language=None):
+        """
+        订单结果查询接口
+
+        params：
+        orderId	String(64)	是		客户订单号
+        searchType	String(10)	否		查询类型：1正向单 2退货单
+        language	String(10)	否		响应报文的语言， 缺省值为zh-CN，目前支持以下值zh-CN 表示中文简体， zh-TW或zh-HK或 zh-MO表示中文繁体， en表示英文
+        """
+        data = {
+            "language": language or self._language,
+            "orderId": orderId,
+            "searchType": searchType,
+            "language": language
+        }
+
+        return self.post("EXP_RECE_SEARCH_ORDER_RESP", data)
+
+    def get_route_info(self, trackingNumber, trackingType=1, methodType=1, referenceNumber=None, checkPhoneNo=None, language=None):
+        """
+        路由查询接口接口-速运类API
+
+        param trackingNumber: 查询号: trackingType=1,则此值为顺丰运单号 如果trackingType=2,则此值为客户订单号
+        param trackingType: 查询号类别: 1:根据顺丰运单号查询,trackingNumber将被当作顺丰运单号处理 2:根据客户订单号查询,trackingNumber将被当作客户订单号处理
+        param methodType: 路由查询类别: 1:标准路由查询 2:定制路由查询
+        param referenceNumber: 参考编码(目前针对亚马逊客户,由客户传)
+        param checkPhoneNo: 校验电话号码后四位值;
+
+        return: 包含节点信息的路由
+        """
+        data = {
+            "language": language or self._language,
+            "trackingNumber": trackingNumber,
+            "trackingType": trackingType,
+            "methodType": methodType,
+            "referenceNumber": referenceNumber,
+            "checkPhoneNo": checkPhoneNo
+        }
+
+        return self.post("EXP_RECE_SEARCH_ROUTES", data)
+
+    def can_delivery(self, orderId, monthlyCard=None, filterType=1, contactInfos=None):
+        """
+        订单筛选接口-速运类API
+
+        客户系统通过此接口向顺丰系统发送主动的筛单请求,用于判断客户的收、派地址是否属于顺丰的收派范围。
+
+        param orderId: String 到件方详细地址,需要包括省市区
+        param orderid: String 客户订单号,filter_type=2则必须提供
+        param filterType: Int 筛单类别: 1:自动筛单(系统根据地址库进行判断,并返回结果,系统无法检索到可派送的将返回不可派送) 2:可人工筛单(系统首先根据地址库判断,如果无法自动判断是否收派,系统将生成需要人工判断的任务,后续由人工处理,处理结束后,顺丰可主动推送给客户系统)
+        param contactInfos: List 地址信息
+        """
+
+        data = {
+            "orderId": orderId,
+            "monthlyCard": monthlyCard,
+            "filterType": filterType,
+            "contactInfos": contactInfos
+        }
+
+        return self.post("EXP_RECE_FILTER_ORDER_BSP", data)
+
+    
+    def query_delivery(self, businessType,destAddress,srcAddress, weight=None,volume=None,consignedTime=None,searchPrice=0):
+        """
+        时效标准及价格查询接口-速运类API
+
+        客户可通过接口查询从特定原寄地寄特定目的地的时效和价格。
+
+        param businessType: 快件产品：可以为空，为空时查询默认时效对应的产品列表。不为空时以数字代码业务类型，例如：1：表示“”2：表示“顺丰特惠”5：表示“顺丰次晨”6：表示“即日件
+        param destAddress: 目的地信息
+        param srcAddress: 原寄地信息
+        param weight: 货物总重量，包含子母件，单位千克，精确到小数点后2位，如果提供此值，必须>0
+        param volume: 货物的体积（长、宽、高分别以厘米为单位计算体积），精确到小数点后2位。
+        param consignedTime: 寄件时间，格式为YYYY-MM-DD HH24:MM:SS，示例2013-12-27 17:54:20。
+        param searchPrice: 1：表示查询含价格的接口0：表示查询不含价格的接口 备注：限制只能为0,1或者不传searchPrice，不可以为空,null
+        """
+
+        data = {
+            "businessType": businessType,
+            "destAddress": destAddress.to_dict(),
+            "srcAddress": srcAddress.to_dict(),
+            "weight": weight,
+            "volume": volume,
+            "consignedTime": consignedTime,
+            "searchPrice": searchPrice
+        }
+
+        return self.post("EXP_RECE_QUERY_DELIVERTM", data)
+
+    def recommend_products(self, srcProvince, srcCity, destProvince, destCity,
+                           sendTime, weight, paymentTerms, srcAddress,
+                           destAddress, **kwargs):
+        """产品推荐接口-速运类API。
+
+        返回顺丰可用产品、预计送达时间、计费重量、币种、总费用及
+        增值服务费明细。燃油附加费在 ``serviceFeeList`` 中的服务代码
+        为 ``IN15``。
+
+        :param srcProvince: 原寄地省/一级行政区
+        :param srcCity: 原寄地市/二级行政区
+        :param destProvince: 目的地省/一级行政区
+        :param destCity: 目的地市/二级行政区
+        :param sendTime: 寄件时间，格式 ``YYYY-MM-DD HH:MM:SS``
+        :param weight: 重量，单位 kg
+        :param paymentTerms: 付款方式：1寄付、2到付、3寄转第三方、4到转第三方
+        :param srcAddress: 原寄地详细地址
+        :param destAddress: 目的地详细地址
+        :param kwargs: 顺丰接口的其他可选字段，如 monthlyCard、srcCounty、
+            destCounty、commodityNameList、declaredValue、declaredCurrency 等
+        :return: 顺丰接口原始响应字典
+        """
+        data = {
+            "srcProvince": srcProvince,
+            "srcCity": srcCity,
+            "destProvince": destProvince,
+            "destCity": destCity,
+            "sendTime": sendTime,
+            "weight": weight,
+            "paymentTerms": paymentTerms,
+            "srcAddress": srcAddress,
+            "destAddress": destAddress,
+        }
+
+        data.update(kwargs)
+        return self.post("EXP_RECE_PSDS_PRODUCT_RECOMMEND", data)
+
+    def estimate_total_fee(self, customerCode, interProductCode, senderInfo,
+                           receiverInfo, **kwargs):
+        """预估总费用接口-国际件API。
+
+        该接口返回 ``currency``、``totalFee`` 和 ``feeInfoList``，其中费用
+        明细可包含燃油附加费。调用前需在顺丰开放平台开通对应接口权限。
+
+        :param customerCode: 顺丰国际客户编码
+        :param interProductCode: 国际产品映射码
+        :param senderInfo: 寄件方信息字典
+        :param receiverInfo: 收件方信息字典
+        :param kwargs: parcelTotalWeight、paymentInfo、customsInfo、
+            addServiceInfoList 等其他可选字段
+        :return: 顺丰接口原始响应字典
+        """
+        data = {
+            "customerCode": customerCode,
+            "interProductCode": interProductCode,
+            "senderInfo": senderInfo,
+            "receiverInfo": receiverInfo,
+        }
+
+        data.update(kwargs)
+        return self.post("COM_RECE_IUOP_ESTIMATE_FEE", data)
+
+    def query_waybill_fee(self, trackingType, trackingNum,
+                          bizTemplateCode=None, **kwargs):
+        """清单运费查询接口-速运类API。
+
+        支持按客户订单号或顺丰运单号查询已产生的费用。燃油附加费在
+        ``waybillFeeList`` 中的费用类型为 ``14``。
+
+        :param trackingType: 查询类型：1按客户订单号，2按顺丰运单号
+        :param trackingNum: 客户订单号或顺丰运单号
+        :param bizTemplateCode: 可选业务配置代码
+        :param kwargs: 顺丰接口后续扩展字段
+        :return: 顺丰接口原始响应字典
+        """
+        data = {
+            "trackingType": str(trackingType),
+            "trackingNum": trackingNum,
+            "bizTemplateCode": bizTemplateCode,
+        }
+
+        data.update(kwargs)
+        return self.post("EXP_RECE_QUERY_SFWAYBILL", data)

sf/order/sheet.py

@@ -0,0 +1,65 @@
+#!/usr/bin/python3
+# @Time    : 2022-12-04
+# @Author  : Kevin Kong (kfx2007@163.com)
+
+from sf.comm import Comm
+from sf.comm import SheetException
+import requests
+
+
+class Sheet(Comm):
+
+    def print(self, templateCode, documents, version='2.0', fileType="pdf", sync=True, customTemplateCode=None, extJson=None):
+        """
+        云打印面单打印2.0接口-面单类API
+        param templateCode:	模板编码	是	String	关联云打印接口后，点击查看，可在接口详情页获取模板编码，类似：fm_76130_standard_{partnerId}
+        param documents:	业务数据	是	array	一批不要超过20个运单，字段定义参考 2.3.1 模板固定字段
+        param version:	版本号	是	String	版本号，传固定值:2.0
+        param fileType:	生成面单文件格式	否	String	pdf格式
+        param sync:	是否同步	条件	boolean	true: 同步,false: 异步,默认同步
+        param customTemplateCode:	自定义模板编码，当需要使用模板编辑器编辑自定义区时，将自定义模板编码赋值该字段	否	String	自定义模板必须是已发布的，且规格要和需要打印的模板对应
+        param extJson:	扩展字段	否	Json	字段定义参考下方extJson字段
+
+        """
+
+        data = {
+            "templateCode": templateCode,
+            "documents": documents,
+            "version": version,
+            "fileType": fileType,
+            "sync": sync,
+            "customTemplateCode": customTemplateCode,
+            "extJson": extJson
+        }
+
+        return self.post("COM_RECE_CLOUD_PRINT_WAYBILLS", data)
+
+    def sync_print(self, templateCode, documents, **kwargs):
+        """同步获取电子面单"""
+        res = self.print(templateCode, documents,**kwargs)
+        if not res['success']:
+            raise SheetException(f"Getting template error:{res['errorMessage']}")
+        files = []
+        for file in res['obj']['files']:
+            resp = requests.get(file['url'], headers={
+                "X-Auth-token": file['token']
+            })
+            files.append(resp.content)
+        return files
+
+    def get_custom_templates(self, sellerUserId, type=1, standardTemplateCode=None,):
+        """
+        获取自定义面单编码
+
+        param sellerUserId: isv商家在isv平台注册的账号
+        param type: 	查询类型，（1：商家自定义模板）
+        param standardTemplateCode: 标准模板code，取值查看 2.3.2，不传值时，则查询所有规格的
+        """
+
+        data = {
+            "sellerUserId": sellerUserId,
+            "type": type,
+            "standardTemplateCode": standardTemplateCode
+        }
+
+        return self.post("COM_RECE_CLOUD_CUSTOMTEMPLATE_LIST", data)

sf_sdk-2.1.0.0.dist-info/METADATA

@@ -0,0 +1,173 @@
+Metadata-Version: 2.1
+Name: sf-sdk
+Version: 2.1.0.0
+Summary: Shunfeng Express Python SDK
+Home-page: https://github.com/block-cat/sf-sdk
+Author: blackcat
+Author-email: kfx2007@163.com
+License: GNU
+Keywords: sf sdk
+Platform: UNKNOWN
+Classifier: License :: OSI Approved :: GNU Affero General Public License v3
+Classifier: Programming Language :: Python
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Scientific/Engineering :: Astronomy
+Classifier: Topic :: Scientific/Engineering :: GIS
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Information Technology
+Description-Content-Type: text/markdown
+Requires-Dist: requests
+
+[![Build Status](https://travis-ci.org/block-cat/sf-sdk.svg?branch=master)](https://travis-ci.org/block-cat/sf-sdk)
+[![Coverage Status](https://coveralls.io/repos/github/block-cat/sf-sdk/badge.svg?branch=master)](https://coveralls.io/github/block-cat/sf-sdk?branch=master)
+[![PYPI](https://img.shields.io/pypi/v/sf-sdk)](https://pypi.org/project/sf-sdk/)
+
+# 顺丰 Python SDK
+
+基于顺丰官网开放平台2.0 API开发的Python SDK
+
+版本：2.1.0.0
+
+## 功能概述
+
+目前已经开发完成的接口列表:
+
+* 下订单接口
+* 订单确认/取消接口-速运类API
+* 订单结果查询接口
+* 路由查询接口接口-速运类API
+* 订单筛选接口-速运类API
+* 时效标准及价格查询接口-速运类API
+* 产品推荐接口-速运类API
+* 预估总费用接口-国际件API
+* 清单运费查询接口-速运类API
+
+其他接口正在陆续对接中...
+
+## 安装
+
+```python
+pip install sf-sdk
+```
+
+## 使用示例
+
+clientcode和checkword是在顺丰官网注册后得到的用户编码和校验码
+
+```python
+from sf.api import SF
+
+sf = SF("clientcode","checkword")
+sf.order.create_order(clientid,..)
+```
+
+### 下单
+
+```python
+contacts = []
+sender = ContactInfo("北京市昌平区回龙观天慧园",company="测试公司",mobile="18512345678",contactType=1)
+receiver = ContactInfo("北京市海淀区新中关大厦A座",company="新东方",mobile="18511223344",contactType=2)
+contacts.append(sender)
+contacts.append(receiver)
+cargo_detail = CargoDetail("测试货物")
+res = self.sf.order.create_order(self.order_no, contacts,[cargo_detail])
+```
+
+### 订单查询
+
+```python
+res = self.sf.order.get_order(self.order_no)
+```
+
+### 确认/取消订单
+
+```python
+res = self.sf.order.confirm_order(self.order_no, dealType=2)
+```
+
+### 路由信息
+
+```python
+res = self.sf.order.get_route_info(self.order_no)
+```
+
+### 判断是否可以派单
+
+```python
+res = self.sf.order.can_delivery(self.order_no)
+```
+
+### 打印电子面单
+
+```python
+res = self.sf.order.get_order(self.order_no)
+documents = [
+    {
+        "masterWaybillNo": res['msgData']['waybillNoInfoList'][0]['waybillNo'],
+    }
+]
+res = self.sf.sheet.sync_print(f"fm_150_standard_QXH",documents)
+```
+
+### 产品推荐与预估费用
+
+产品推荐接口需要先开通 `EXP_RECE_PSDS_PRODUCT_RECOMMEND` 权限。返回值中的
+`msgData.productList` 会包含 `totalFee`、`currency` 和 `serviceFeeList`；其中
+燃油附加费的服务代码为 `IN15`。
+
+```python
+res = sf.order.recommend_products(
+    srcProvince="香港",
+    srcCity="香港",
+    destProvince="澳门",
+    destCity="澳门",
+    sendTime="2026-09-04 12:00:00",
+    weight=1,
+    paymentTerms="1",
+    srcAddress="香港葵涌永建路",
+    destAddress="澳门半岛南湾大马路",
+    monthlyCard="your-monthly-card",
+    commodityNameList=["文件"],
+)
+```
+
+国际件预估总费用接口会返回 `currency`、`totalFee` 和 `feeInfoList`，需要单独
+申请对应的国际接口权限。
+
+```python
+res = sf.order.estimate_total_fee(
+    customerCode="your-international-customer-code",
+    interProductCode="INT0001",
+    senderInfo={"country": "HK", "postCode": "999077", "address": "Kwai Chung"},
+    receiverInfo={"country": "MO", "postCode": "999078", "address": "Macau"},
+    parcelQuantity=1,
+    parcelTotalWeight=1,
+)
+```
+
+### 清单运费查询
+
+`trackingType` 为 `1` 时按客户订单号查询，为 `2` 时按顺丰运单号查询。
+返回值中的 `msgData.waybillFeeList` 是实际费用明细，燃油附加费的费用类型为
+`14`。
+
+```python
+res = sf.order.query_waybill_fee(
+    trackingType=2,
+    trackingNum="SF1234567890",
+)
+```
+
+### 沙箱联调
+
+实时沙箱测试默认跳过。需要运行时通过环境变量提供凭据，凭据不会写入代码：
+
+```bash
+export SF_SANDBOX_CLIENT_CODE="your-client-code"
+export SF_SANDBOX_CHECKWORD="your-checkword"
+pytest
+```
+
+

sf_sdk-2.1.0.0.dist-info/RECORD

@@ -0,0 +1,23 @@
+sf/__init__.py,sha256=1GX8aoFp-7kCmUb1Osf0s_UrL_1Cak-O5IYzbfdBr0U,137
+sf/api.py,sha256=QdvIWDGoQCojk1NwWXI1SEcgAntjiyRiBNQJ-19Id2k,858
+sf/comm/__init__.py,sha256=6JdNyDcIRDfiiofuryu1Arq1oNRLBr75Vhts48BrcXA,45
+sf/comm/comm.py,sha256=AF9vSApk_Li9uq4s72tO9ZLB56KbmmYlyank8pzgPmM,2460
+sf/comm/exceptions.py,sha256=xs6fgmuEvNxnEziS2OtmTVp6CuIdpo1pmJc-F1swG-k,128
+sf/comm/token.py,sha256=KnNVBhlAiggHaIpSyJVxSGYueS6DfrRIAxaJA9UlAhk,221
+sf/data/express_type.csv,sha256=OGb3Rscm29bEBK7ik4hKJnpVLWCSWobz4vqIhELmiVM,1143
+sf/model/__init__.py,sha256=h76cagNALAFU8nlqng20eehKDZCChVO8MictLYYIfHw,171
+sf/model/address.py,sha256=6pgS5yXLGT7wCqTQRdzU9RVzIie8KCVjIWfeR-OJO3w,1105
+sf/model/cargo.py,sha256=W4aWA7ATdWjcoSNsg8dwsxkTZKywwthg-QVJ2hu_U5E,4794
+sf/model/contact.py,sha256=7aHgiEe3c9hmp-cy5fwLdWvYj8UDZ1U-0pvLfQ0DLfA,1375
+sf/model/service.py,sha256=WQHQxCBVkZOYGbxeQkQoaYBap153gkGeJM-6U9LwATY,760
+sf/order/__init__.py,sha256=0wUPsj5waTgiZCoGN5Ed6ZEhkkdKHhsFnWh_7RxRkPA,42
+sf/order/order.py,sha256=Go0LreSHK6Y5FBAI8nXQninxT2S-Zk4BaD5wsD9Ny3s,18181
+sf/order/sheet.py,sha256=hmJKDjLxXRjovYiMSGpDXiCx8fCvZAxFnNcHyJgY0oE,2722
+tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tests/test_fee_apis.py,sha256=cxz0QKPWmopXhGlMpFMDJvMZMntR7cg3DLMLFshIlco,3146
+tests/test_order.py,sha256=VPBwlsCG5m4YO8s51pEeyApNeKZWk5zRSMsMnJ-9Wr0,6204
+sf_sdk-2.1.0.0.dist-info/METADATA,sha256=GpujS51rKdz1BRNZGMBnNNvh0_1ePhZKHCqA4RivNr4,4645
+sf_sdk-2.1.0.0.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
+sf_sdk-2.1.0.0.dist-info/top_level.txt,sha256=Wzp9OGy9dpK4Rp9m5ctKYX8HGCOSrRJc8eZLxHowLL8,9
+sf_sdk-2.1.0.0.dist-info/zip-safe,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+sf_sdk-2.1.0.0.dist-info/RECORD,,

sf_sdk-2.1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.42.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

sf_sdk-2.1.0.0.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+sf
+tests

sf_sdk-2.1.0.0.dist-info/zip-safe

@@ -0,0 +1 @@
+

tests/test_fee_apis.py

@@ -0,0 +1,103 @@
+#!/usr/bin/python3
+
+import unittest
+from unittest.mock import Mock
+
+from sf.order.order import Order
+
+
+class TestFeeApiPayloads(unittest.TestCase):
+
+    def setUp(self):
+        self.order = Order()
+        self.order.post = Mock(return_value={"success": True})
+
+    def test_recommend_products_payload(self):
+        result = self.order.recommend_products(
+            srcProvince="香港",
+            srcCity="香港",
+            destProvince="澳门",
+            destCity="澳门",
+            sendTime="2026-09-04 12:00:00",
+            weight=1,
+            paymentTerms="1",
+            srcAddress="香港葵涌永建路",
+            destAddress="澳门半岛南湾大马路",
+            monthlyCard="test-monthly-card",
+            commodityNameList=["文件"],
+        )
+
+        self.assertEqual(result, {"success": True})
+        self.order.post.assert_called_once_with(
+            "EXP_RECE_PSDS_PRODUCT_RECOMMEND",
+            {
+                "srcProvince": "香港",
+                "srcCity": "香港",
+                "destProvince": "澳门",
+                "destCity": "澳门",
+                "sendTime": "2026-09-04 12:00:00",
+                "weight": 1,
+                "paymentTerms": "1",
+                "srcAddress": "香港葵涌永建路",
+                "destAddress": "澳门半岛南湾大马路",
+                "monthlyCard": "test-monthly-card",
+                "commodityNameList": ["文件"],
+            },
+        )
+
+    def test_estimate_total_fee_payload(self):
+        sender = {
+            "country": "HK",
+            "postCode": "999077",
+            "address": "Kwai Chung",
+        }
+        receiver = {
+            "country": "MO",
+            "postCode": "999078",
+            "address": "Macau Peninsula",
+        }
+
+        result = self.order.estimate_total_fee(
+            customerCode="test-customer",
+            interProductCode="INT0001",
+            senderInfo=sender,
+            receiverInfo=receiver,
+            parcelQuantity=1,
+            parcelTotalWeight=1,
+            declaredCurrency="HKD",
+        )
+
+        self.assertEqual(result, {"success": True})
+        self.order.post.assert_called_once_with(
+            "COM_RECE_IUOP_ESTIMATE_FEE",
+            {
+                "customerCode": "test-customer",
+                "interProductCode": "INT0001",
+                "senderInfo": sender,
+                "receiverInfo": receiver,
+                "parcelQuantity": 1,
+                "parcelTotalWeight": 1,
+                "declaredCurrency": "HKD",
+            },
+        )
+
+    def test_query_waybill_fee_payload(self):
+        result = self.order.query_waybill_fee(
+            trackingType=2,
+            trackingNum="SF1234567890",
+            bizTemplateCode="test-template",
+        )
+
+        self.assertEqual(result, {"success": True})
+        self.order.post.assert_called_once_with(
+            "EXP_RECE_QUERY_SFWAYBILL",
+            {
+                "trackingType": "2",
+                "trackingNum": "SF1234567890",
+                "bizTemplateCode": "test-template",
+            },
+        )
+
+
+if __name__ == "__main__":
+    unittest.main()

tests/test_order.py

@@ -0,0 +1,137 @@
+#!/usr/bin/python3
+# @Time    : 2019-08-21
+# @Author  : Kevin Kong (kfx2007@163.com)
+
+import os
+import unittest
+import uuid
+from sf.api import SF
+from sf.model.contact import ContactInfo
+from sf.model.cargo import CargoDetail
+from sf.model.address import Address
+
+
+class TestOrder(unittest.TestCase):
+
+    @classmethod
+    def setUpClass(cls):
+        clientcode = os.environ.get("SF_SANDBOX_CLIENT_CODE")
+        checkword = os.environ.get("SF_SANDBOX_CHECKWORD")
+        if not clientcode or not checkword:
+            raise unittest.SkipTest(
+                "Set SF_SANDBOX_CLIENT_CODE and SF_SANDBOX_CHECKWORD "
+                "to run live sandbox tests."
+            )
+        cls.sf = SF(clientcode, checkword, True, 'en')
+        cls.order_no = uuid.uuid4().hex[:12]
+        cls.mail_no = None
+
+    def _create_order(self):
+        contacts = []
+        sender = ContactInfo("北京市昌平区回龙观天慧园",company="测试公司",mobile="18512345678")
+        receiver = ContactInfo("北京市海淀区新中关大厦A座",company="新东方",mobile="18511223344",contactType=1)
+        contacts.append(sender)
+        contacts.append(receiver)
+        cargo_detail = CargoDetail("测试货物")
+        return self.sf.order.create_order(self.order_no, contacts,[cargo_detail])
+
+    def test_1_create_order(self):
+        """测试下单"""
+        res = self._create_order()
+        self.assertEqual(res["success"], True, res)
+
+    def test_2_get_order(self):
+        """测试订单查询接口"""
+        res = self.sf.order.get_order(self.order_no)
+        self.assertEqual(res["success"], True, res)
+
+    def test_99_cancel_order(self):
+        """测试取消订单"""
+        res = self.sf.order.confirm_order(self.order_no, dealType=2)
+        self.assertEqual(res["success"], True, res)
+
+    def test_4_get_router(self):
+        """测试路由信息"""
+        #{'apiErrorMsg': '', 'apiResponseID': '000184DB8E57803FE6AA43A0CAC24D3F', 
+        # 'apiResultCode': 'A1000', 'apiResultData': 
+        # '{"success":true,"errorCode":"S0000","errorMsg":null,
+        # "msgData":{"routeResps":
+        # [{"mailNo":"066106553309","routes":[{"acceptAddress":"深圳市","acceptTime":"2022-12-04 13:14:09","remark":"顺丰速运 已收取快件","opCode":"50"
+        # }]}]}}'}
+        # 只有先下单 才能拿得到路由信息 否则是空
+        contacts = []
+        sender = ContactInfo("北京市昌平区回龙观天慧园",company="测试公司",mobile="18512345678")
+        receiver = ContactInfo("北京市海淀区新中关大厦A座",company="新东方",mobile="18511223344",contactType=1)
+        contacts.append(sender)
+        contacts.append(receiver)
+        cargo_detail = CargoDetail("测试货物")
+        self.sf.order.create_order(uuid.uuid4().hex[:12], contacts,[cargo_detail])
+        res = self.sf.order.get_route_info(self.order_no)
+        self.assertTrue(res['success'], res)
+
+    def test_5_can_deliver(self):
+        """是否可以收派"""
+        res = self.sf.order.can_delivery(self.order_no)
+        self.assertTrue(res['success'], res)
+
+    def test_0_access_token(self):
+        """测试获取AccessToken"""
+        access_token = self.sf.comm.get_access_token()
+        self.assertNotEqual(access_token, None)
+
+    def test_6_print(self):
+        """"测试电子面单"""
+        # [{'areaNo': 1, 'pageNo': 1, 'seqNo': 1, '
+        #  token': 'AUTH_tkv12_f146d1855480549d262b5c46ab0ab597ff20a97d9d0db45c16bedeb4fabd112b012deadd477ee524b1d690ce01baa3cdffbb125a6ccf69b73778dba2eb5157eb73744dffd1a1bbe5c4390bfb93ce4c3e9197d359c3ace1b33151306bc9e831ab67720381919951fc04fd23bb349f18cda712e03cdb9961c933bba7d6177fa548e4a43f0933ce2b32089181f98d7c23a786969366c357d7da3f10ac20f099e909e8a27d9f175808a32056e0c85df11786d9c10d75656ea37df97b385c9c79c546', 
+        # 'url': 'https://eos-scp-core-shenzhen-futian1-oss.sf-express.com:443/v1.2/AUTH_EOS-SCP-CORE/print-file-sbox/QXH_e45c4058-6972-4605-9182-e337814f5dff_SF7444462031543_fm_150_standard_QXH_1_1_1.pdf', 
+        # 'waybillNo': 'SF7444462031543'}]
+        res = self.sf.order.get_order(self.order_no)
+        documents = [
+            {
+                "masterWaybillNo": res['msgData']['waybillNoInfoList'][0]['waybillNo'],
+            }
+        ]
+        res = self.sf.sheet.sync_print(f"fm_150_standard_{self.sf.clientcode}",documents)
+        self.assertTrue(len(res[0]), res)
+
+    def test_7_get_express_types(self):
+        res = SF.get_express_types()
+        self.assertTrue(len(res), res)
+
+    def test_8_get_custom_templates(self):
+        res = self.sf.sheet.get_custom_templates("123456",0)
+        self.assertTrue(res['success'],res)
+
+    def test_9_query_delivery(self):
+        src_address = Address("北京市","北京市","昌平区","回龙观大街")
+        dest_address = Address("山东省","青岛市","市北区","万达广场")
+        res = self.sf.order.query_delivery(1,src_address, dest_address)
+        self.assertTrue(res['success'],res)
+
+    def test_10_hk_mau(self):
+        src_address = Address("北京市","北京市","昌平区","回龙观大街")
+        dest_address = Address("台湾","新竹市","市北区","万达广场")
+        res = self.sf.order.query_delivery(1,src_address, dest_address)
+        self.assertTrue(res['success'],res)
+
+    def test_11_create_suborders(self):
+        res = self.sf.order.create_sub_order(self.order_no, 3)
+        self.assertTrue(res['success'], res)
+
+
+if __name__ == "__main__":
+    suite = unittest.TestSuite()
+    suite.addTest(TestOrder("test_0_access_token"))
+    suite.addTest(TestOrder("test_1_create_order"))
+    suite.addTest(TestOrder("test_2_get_order"))
+    suite.addTest(TestOrder("test_4_get_router"))
+    suite.addTest(TestOrder("test_5_can_deliver"))
+    suite.addTest(TestOrder("test_6_print"))
+    suite.addTest(TestOrder("test_99_cancel_order"))
+    suite.addTest(TestOrder("test_7_get_express_types"))
+    suite.addTest(TestOrder("test_8_get_custom_templates"))
+    suite.addTest(TestOrder("test_9_query_delivery"))
+    suite.addTest(TestOrder("test_10_hk_mau"))
+    suite.addTest(TestOrder("test_11_create_suborders"))
+    runner = unittest.TextTestRunner(verbosity=2)
+    runner.run(suite)