kdn-sdk 0.2.9__py3-none-any.whl

kdn/__init__.py

@@ -0,0 +1,7 @@
+#!/usr/bin/python3
+# @Time    : 2020-03-25
+# @Author  : Kevin Kong (kfx2007@163.com)
+
+
+__author__ = "Kevin Kong"
+__version__ = "0.2.9"

kdn/api/__init__.py

@@ -0,0 +1,3 @@
+#!/usr/bin/python3
+# @Time    : 2020-04-17
+# @Author  : Kevin Kong (kfx2007@163.com)

kdn/api/comm.py

@@ -0,0 +1,100 @@
+#!/usr/bin/python3
+# @Time    : 2020-03-25
+# @Author  : Kevin Kong (kfx2007@163.com)
+
+# 接口调用公共类
+
+import json
+from hashlib import md5
+import base64
+from urllib.parse import urlencode, quote_plus, quote
+import requests
+import csv
+from copy import deepcopy
+import logging
+
+_logger = logging.getLogger(__name__)
+
+
+class Comm(object):
+
+    def __get__(self, instance, owner):
+        self.client_id = instance.client_id
+        self.api_key = instance.api_key
+        self.sandbox = instance.sandbox
+        self.timeout = instance.timeout
+        self.url = instance.url
+        return self
+
+    def _get_request_header(self):
+        """
+        获取固定的header
+        """
+        header = {
+            "Content-Type": "application/x-www-form-urlencoded; charset=utf-8",
+        }
+        return header
+
+    def _mask_identifier(self, value):
+        value = str(value or "")
+        if len(value) <= 4:
+            return "*" * len(value)
+        return f"{value[:2]}***{value[-2:]}"
+
+    def _sign(self, data):
+        """
+        签名逻辑
+        """
+        to_sign = f"{data}{self.api_key}".encode(
+            "utf-8")
+        sign = base64.b64encode(
+            md5(to_sign).hexdigest().encode("utf-8")).decode("utf-8")
+        return sign
+
+    def _remove_none(self, d):
+        dx = deepcopy(d)
+        for k, v in d.items():
+            if v and type(v) is dict:
+                r = self._remove_none(v)
+                if r:
+                    dx[k] = r
+                else:
+                    dx[k] = ''
+            if v and type(v) is list:
+                for i in range(len(v)):
+                    dx[k][i] = self._remove_none(v[i])
+            if not v:
+                dx[k] = ''
+        return dx
+
+    def post(self, request_type, data, url=None, timeout=None):
+        """
+        提交请求
+        params:
+        data: 提交的数据
+        """
+        payload = json.dumps(self._remove_none(
+            data), separators=(',', ':'), ensure_ascii=False)
+        request_data = {
+            "RequestType": request_type,
+            "EBusinessID": self.client_id,
+            "RequestData": quote_plus(payload),
+            "DataSign": self._sign(payload),
+            "DataType": 2
+        }
+        endpoint = url or self.url
+        request_timeout = self.timeout if timeout is None else timeout
+        _logger.debug(
+            "KDN-SDK POST request_type=%s ebusiness_id=%s endpoint=%s payload_bytes=%s",
+            request_type,
+            self._mask_identifier(self.client_id),
+            endpoint,
+            len(payload.encode("utf-8")),
+        )
+        response = requests.post(
+            endpoint,
+            data=request_data,
+            headers=self._get_request_header(),
+            timeout=request_timeout,
+        )
+        return response.json()

kdn/api/kdn.py

@@ -0,0 +1,110 @@
+#!/usr/bin/python3
+# @Time    : 2020-03-25
+# @Author  : Kevin Kong (kfx2007@163.com)
+
+from .comm import Comm
+from .query import Query
+from .order import Order
+from .service import Service
+from .logistic import Logistic
+import csv
+import os
+
+
+SANDBOXURL = "http://sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.json"
+URL = "http://api.kdniao.com"
+DEFAULT_TIMEOUT = 15
+
+
+class KDN(object):
+
+    def __init__(self, client_id, api_key, sandbox=False, timeout=DEFAULT_TIMEOUT):
+        """
+        params:
+        client_id: 商户ID,
+        api_key: API KEY,
+        sandbox: 是否沙箱测试环境
+        timeout: 请求超时时间，单位秒
+        """
+        self.client_id = client_id
+        self.api_key = api_key
+        self.sandbox = sandbox
+        self.timeout = timeout
+        self.url = SANDBOXURL if self.sandbox else URL
+
+    @classmethod
+    def get_express_list(cls):
+        """
+        获取支持的公司列表
+        返回包含代码和名称的字典
+        """
+        express = {}
+        csv_path = os.path.dirname(os.path.dirname(__file__))
+        with open(os.path.join(csv_path, "data/express.csv"),encoding='UTF-8') as f:
+            for row in csv.reader(f):
+                express[row[1].strip()] = row[0].strip()
+        return express
+
+    @classmethod
+    def get_eorder_express(cls):
+        """
+        获取支持电子面单的物流公司
+        """
+        codes = []
+        filelist = ('direct.csv', 'eorder.csv',
+                    'kdn.csv', 'month.csv', 'offline.csv')
+        csv_path = os.path.dirname(os.path.dirname(__file__))
+        for file in filelist:
+            with open(os.path.join(csv_path, f"data/{file}"),encoding='UTF-8') as f:
+                for row in csv.reader(f):
+                    codes.append(row[0])
+        return set(list(codes))
+
+    @classmethod
+    def get_templates(cls):
+        """
+        获取电子面单模板
+        """
+        templates = []
+        csv_path = os.path.dirname(os.path.dirname(__file__))
+        with open(os.path.join(csv_path, "data/templates.csv"),encoding='UTF-8') as f:
+            for row in csv.reader(f):
+                templates.append(tuple(row))
+        return templates
+
+    @classmethod
+    def get_express_types(self):
+        """获取快递公司业务类型"""
+        types = []
+        csv_path = os.path.dirname(os.path.dirname(__file__))
+        with open(os.path.join(csv_path, "data/exptype.csv"),encoding='UTF-8') as f:
+            for row in csv.reader(f):
+                types.append(tuple(row))
+        return types
+
+    @classmethod
+    def get_preorder_express(self):
+        """get express list which supported preordering"""
+        expresses =[]
+        csv_path = os.path.dirname(os.path.dirname(__file__))
+        with open(os.path.join(csv_path, "data/preorder.csv"),encoding='UTF-8') as f:
+            for row in csv.reader(f):
+                expresses.append(row[0])
+        return expresses
+
+    
+    @classmethod
+    def get_trans_types(self):
+        """get express trans types"""
+        transtypes =[]
+        csv_path = os.path.dirname(os.path.dirname(__file__))
+        with open(os.path.join(csv_path, "data/trans.csv"),encoding='UTF-8') as f:
+            for row in csv.reader(f):
+                transtypes.append(row)
+        return transtypes
+
+    comm = Comm()
+    query = Query()
+    order = Order()
+    service = Service()
+    logistic = Logistic()

kdn/api/logistic.py

@@ -0,0 +1,96 @@
+#!/usr/bin/python3
+# @Time    : 2021-11-29
+# @Author  : Kevin Kong (kfx2007@163.com)
+
+# 物流跟踪 API
+
+from requests.api import get
+from .query import Query
+# from .comm import Comm
+# UPGRADE = {
+#     1002: 8001,
+# }
+
+
+# def logistic(func):
+#     def wrapper(*args, **kwargs):
+#         print(getattr(func,'request_type'))
+#         func.request_type = UPGRADE[func.request_type]
+#         return func(*args, **kwargs)
+#     return wrapper
+
+
+class Logistic(Query):
+
+    def __init__(self, *args, **kwargs):
+        self.express_code = 8001
+        self.subsribe_code = 8008
+
+    # def get_express_routes(self, *args, **kwargs):
+    #     """
+    #     获取即时物流轨迹
+    #     params:
+    #     shipper_code: 快递公司编码
+    #     logistic_code: 快递单号
+    #     order_code: 订单编号
+    #     customer_name: ShipperCode 为 JD，必填，对应京东的青龙配送编码，也叫商家编码.
+    #     """
+    #     func = Query.get_express_routes
+    #     func.request_type = 8001
+    #     return func(self, *args, **kwargs)
+
+    # def subscribe_express_routes(self, *args, **kwargs):
+    #     """
+    #     轨迹订阅接口
+    #     params:
+    #     shipper_code: 快递公司编码
+    #     logistic_code: 快递单号
+    #     recevier_name: 收件人姓名
+    #     province_name: 收件人省份
+    #     city_name: 收件人城市
+    #     district_name: 收件人区域
+    #     address: 收件人详细地址
+    #     sender_name: 发件人姓名
+    #     sender_tel: 发件人电话
+    #     sender_mobile: 发件人手机 (电话或手机必填一个)
+    #     sender_province: 发件人省份
+    #     sender_city:发件人城市
+    #     sender_district: 发件人区域
+    #     sender_address: 发件人详细地址
+    #     recevier_tel: 收件人电话
+    #     receiver_mobile: 收件人手机 (电话或手机必填一个)
+    #     member_id: ERP 系统、电商平台等系统或平台类型用户的会员ID或店铺账号等唯一性标识，用于区分其用户
+    #     warehouse_id: 仓库标志
+    #     customer_name: ShipperCode 为 JD，必填，对应京东的青龙配送编码，也叫商家编码
+    #     order_code: 订单编号
+    #     month_code: 月结单号
+    #     pay_type: 运费支付方式：1-现付，2-到付，3-月结，4- 第三方付(仅 SF、KYSY 支持)
+    #     exp_type：详细快递类型
+    #     cost: 快递运费
+    #     other_cost: 其他费用
+    #     receiver_company: 收件人公司
+    #     receiver_post_code：收件人邮编
+    #     sender_company： 发件人公司
+    #     sender_post_code： 发件人邮编
+    #     is_notice：是否通知快递员上门揽件 0-通知，1-不通知，不填则 默认为 1
+    #     start_date: 上门揽件时间段，格式：YYYY-MM-DD HH24:MM:SS
+    #     end_date: 上门揽件时间段
+    #     weight: 重量
+    #     quantity： 包裹数量
+    #     volume： 体积
+    #     remark: 备注
+    #     is_sender_message: 是否订阅短信 0-不需要，1-需要
+    #     service_name：增值服务名称
+    #     service_value: 增值服务值
+    #     service_customer_id: 增值服务客户id
+    #     goods_name： 商品名称
+    #     goods_code： 商品编码
+    #     goods_quantity：商品数量
+    #     goods_price： 商品价格
+    #     goods_weight：商品重量
+    #     goods_desc：商品描述
+    #     goods_vol: 商品体积
+    #     """
+    #     func = Query.subscribe_express_routes
+    #     func.request_type = 8008
+    #     return func(self, *args, **kwargs)