ey-commerce-lib 1.0.0__py3-none-any.whl

ey_commerce_lib/dxm/schemas/order.py

@@ -0,0 +1,273 @@
+from typing import TypedDict, Optional
+from urllib.parse import urlencode
+
+from ey_commerce_lib.utils.str import to_camel
+from pydantic import BaseModel, ConfigDict
+
+
+class DxmOrderSearchForm(BaseModel):
+    """
+    /package/advancedSearch.htm
+    店小秘订单搜索接口参数约束
+    """
+    # 搜索类型(orderId订单号, packageNum包裹号)
+    search_types: str = 'orderId'
+    # 搜索内容
+    contents: str = ''
+    order_adv_search_type: str = '1'
+    # 订单状态
+    state: str = ''
+    is_voided: str = '-1'
+    is_removed: str = '-1'
+    commit_platforms: str = ''
+    # 是否为海外仓-1代表全部,1是0否
+    is_oversea: str = '-1'
+    # 店铺id
+    shop_id: str = '-1'
+    # 平台
+    platform: str = ''
+    # 历史订单(空字符串就是代表没有, all 代表历史记录)
+    history: str = ''
+    # 排序方式
+    order_field: str = 'order_create_time'
+    is_desc: str = '1'
+    time_out: str = '0'
+    warehouse_code: str = ''
+    # 订单标记绿色
+    is_green: str = '0'
+    # 订单标记黄色
+    is_yellow: str = '0'
+    # 订单标记橙色
+    is_orange: str = '0'
+    # 订单标记红色
+    is_red: str = '0'
+    # 订单标记紫色
+    is_violet: str = '0'
+    # 订单标记蓝色
+    is_blue: str = '0'
+    # 订单标记青色
+    corn_flower_blue: str = '0'
+    # 订单标记粉色
+    pink: str = '0'
+    teal: str = '0'
+    turquoise: str = '0'
+    unmarked: str = '0'
+    forbidden_status: str = '-1'
+    forbidden_reason: str = '0'
+    picking_instructions: str = ''
+    # 订单金额起始
+    price_start: str = ''
+    # 订单金额结束
+    price_end: str = ''
+    # 下单时间
+    order_create_start: str = ''
+    order_create_end: str = ''
+    # 付款时间
+    order_pay_start: str = ''
+    order_pay_end: str = ''
+    # 发货时间
+    shipped_start: str = ''
+    shipped_end: str = ''
+    # 退款时间
+    refunded_start: str = ''
+    refunded_end: str = ''
+    # 面单打印时间
+    md_sign_start: str = ''
+    md_sign_end: str = ''
+    # 拣货单打印时间
+    jh_sign_start: str = ''
+    jh_sign_end: str = ''
+    # 剩余发货
+    time_out_query: str = '-1'
+    # 包裹类型
+    product_status: str = ''
+    # 订单商品数量
+    product_count_start: str = ''
+    product_count_end: str = ''
+    # 发货仓库, 多个仓库用逗号隔开
+    storage_ids: str = ''
+    storage_id: str = '0'
+    auth_id: str = '-1'
+    days: str = '-1'
+    # 国家区域
+    country: str = ''
+    # 拣货单打印（-1全部,1已打拣货单,2未打拣货单）
+    is_print_jh: str = '-1'
+    # 优先分配库存(-1全部,1是,2否)
+    sign_prior_ship: str = '-1'
+    # 面单打印(-1全部,1是,2否)
+    is_print_md: str = '-1'
+    # 提交单号(uncommit)
+    commit_platform: str = ''
+    # 买家留言(-1全部,1有留言,0没有留言)
+    is_has_order_message: str = '-1'
+    # 买家备注(-1全部,1有备注,0没有备注)
+    is_has_order_comment: str = '-1'
+    # 客服备注(-1全部,1有备注,0没有备注)
+    is_has_service_comment: str = '-1'
+    # 拣货备注(-1全部,1有备注,0没有备注)
+    is_has_pick_comment: str = '-1'
+
+    # 合并订单(1代表勾选)
+    is_merge: str = ''
+    # 拆分订单(1代表勾选)
+    is_split: str = ''
+    # 重发包裹(1代表勾选)
+    is_re_ship: str = ''
+    # 有退款
+    is_refund: str = ''
+    # 禁止处理(1代表勾选)
+    sign_ban_ship: str = ''
+    # 黑名单
+    black_list: str = ''
+    # 平台标识
+    global_collection: str = '-1'
+    # 分页
+    page_no: int = 1
+    page_size: int = 30
+
+    model_config = ConfigDict(
+        alias_generator=to_camel,
+        populate_by_name=True  # 对应旧版的 allow_population_by_field_name
+    )
+
+
+class DxmJsonResponse(TypedDict):
+    """
+    店小秘一般json返回响应
+    """
+    code: int
+    msg: str
+
+
+class DxmProcessMsg(TypedDict):
+    code: int
+    msg: str
+    data: Optional[dict]
+    num: int
+    totalNum: int
+    createDate: int
+
+
+class DxmCheckProcessResponse(TypedDict):
+    """
+    店小秘检测进度返回参数类型
+    """
+    processMsg: DxmProcessMsg
+
+
+class DxmOrderRuleCond(BaseModel):
+    """
+    店小秘订单规则参数项基类
+    """
+    # 条件值
+    cond_val: str
+    # 条件id
+    cond_id: str
+    # 条件名称
+    cond_name: str
+    # 条件单位
+    cond_unit: str = ''
+    # 条件类型
+    cond_type: str = '1'
+
+
+class DxmOrderRule(BaseModel):
+    """
+    店小秘订单规则参数基类
+    """
+    # 规则id
+    id: str
+    # 规则类型(1:审单规则，2:物流规则)
+    type: str
+    # 规则名称
+    rule_name: str
+    # 客服备注
+    kfbz: str = ''
+    # 拣货备足
+    jhbz: str = ''
+    # 拣货颜色
+    jh_color: str = ''
+    # 自定义备注
+    custom_mark: str = ''
+    # 附加规则(on勾选, ''未勾选)
+    other_action: str = ''
+    has_other_action: str = ''
+    # 条件列表
+    dxm_cond_list: list[DxmOrderRuleCond]
+
+    def to_update_rule_data_before(self):
+        data = list()
+        data.append(('id', self.id))
+        data.append(('type', self.type))
+        data.append(('ruleName', self.rule_name))
+        # 装填规则内容
+        for cond in self.dxm_cond_list:
+            data.append(('condVal', cond.cond_val))
+            data.append(('condId', cond.cond_id))
+            data.append(('condName', cond.cond_name))
+            data.append(('condUnit', cond.cond_unit))
+            data.append(('condType', cond.cond_type))
+        # 装填conditionId
+        for cond in self.dxm_cond_list:
+            data.append(('conditionId', cond.cond_id))
+        return data
+
+    def to_update_rule_data_after(self):
+        data = list()
+        data.append(('otherAction', self.other_action))
+        data.append(('kfbz', self.kfbz))
+        data.append(('jhbz', self.jhbz))
+        data.append(('hasOtherAction', self.has_other_action))
+        data.append(('customMark', self.custom_mark))
+        data.append(('jhColor', self.jh_color))
+        return data
+
+    def to_update_rule_data(self):
+        """
+        转换成更新物流规则的参数数据,由子类实现
+        :return:
+        """
+        pass
+
+
+class DxmOrderReviewRule(DxmOrderRule):
+    """
+    店小秘审单规则参数
+    """
+    # 流程规则(paid: 待审核, approved: 待处理)
+    action: str = 'paid'
+
+    def to_update_rule_data(self):
+        """
+        转换成更新物流规则的参数数据
+        :return:
+        """
+        data = super().to_update_rule_data_before()
+        # 装填其他参数
+        data.append(('action', self.action))
+        data.extend(super().to_update_rule_data_after())
+        return urlencode(data, encoding="utf-8")
+
+
+class DxmOrderLogisticsRule(DxmOrderRule):
+    """
+    店小秘订单物流规则参数
+    """
+    ware_id: str
+    # 物流方式id(物流规则使用, 必须要是distribute_type为0)
+    auth_id: str
+    # 分配方式(0:仅指定一个物流,1:指定多个物流)
+    distribute_type: str
+    # 物流方式ids(物流规则使用, 多个用逗号隔开, 必须要是distribute_type为1)
+    auth_ids: str
+
+    def to_update_rule_data(self):
+        data = super().to_update_rule_data_before()
+        # 装填其他参数
+        data.append(('wareId', self.ware_id))
+        data.append(('distributeType', self.distribute_type))
+        data.append(('authId', self.auth_id))
+        data.append(('authIds', self.auth_ids))
+        data.extend(super().to_update_rule_data_after())
+        return urlencode(data, encoding="utf-8")

ey_commerce_lib/dxm/schemas/warehouse.py

@@ -0,0 +1,161 @@
+from typing import Optional
+
+from ey_commerce_lib.utils.str import to_camel
+from pydantic import BaseModel, ConfigDict
+
+
+class WarehouseProductQuery(BaseModel):
+    refresh_flag: str = ''
+    # 8(全部区)6(次品区)0(拣货区)
+    zone_type: int = 0
+    # 页码
+    page_no: int = 1
+    # 每页条数
+    page_size: int = 100
+    # 搜索类型1(商品sku)4(商品编码)2(商品名称)3(货架位)4(识别码)
+    search_type: int = 1
+    # 搜索内容
+    search_value: str = ''
+    # 匹配方式1(精确匹配)0(模糊匹配)2(完全匹配)
+    product_search_type: int = 1
+    # 仓库id
+    warehouse_id: str = '7167025'
+    is_transit: str = ''
+    # 筛选排序 1(按照创建时间)2(按更新时间)3(按sku)4(按库存总量)5(按单价)6(按采购在途)7(按总价)8(按货架位)9(按可用库存)10(按未发)
+    order_by: str = '1'
+    # 排序方式 1(降序)0(升序)
+    order_by_val: str = '1'
+    # 分类路径用-分隔最后以-结尾 例如1379550-1379554-1379559-
+    full_cid: str = ''
+    # 类型 全部('')单个sku(0)组合sku(1)加工sku(2)
+    group_or_not: str = ''
+    # 商品单价开始
+    price_min: str = ''
+    # 商品单价结束
+    price_max: str = ''
+    # 总库存起始
+    stock_min: str = ''
+    # 总库存结束
+    stock_max: str = ''
+    # 可用库存起始
+    available_min: str = ''
+    # 可用库存结束
+    available_max: str = ''
+    # 安全库存开始
+    safe_min: str = ''
+    # 安全库存结束
+    safe_max: str = ''
+    # 采购在途开始
+    on_pass_min: str = ''
+    # 采购在途结束
+    on_pass_max: str = ''
+    # 预售数量起始
+    lock_min: str = ''
+    # 预售数量结束
+    lock_max: str = ''
+    # 未发数量起始
+    un_billed_order_min: str = ''
+    # 未发数量结束
+    un_billed_order_max: str = ''
+    # 仓库商品状态 -1(全部)0(在售)1(热销)2(新品)3(清仓)4(停售)5(滞销)
+    product_status: str = '-1'
+
+    model_config = ConfigDict(
+        alias_generator=to_camel,
+        populate_by_name=True  # 对应旧版的 allow_population_by_field_name
+    )
+
+
+class WarehouseProduct(BaseModel):
+    sku: str
+    name: Optional[str] = None
+    sku_code: str
+    shelf_position: str
+    # 安全库存
+    safe_stock: Optional[int] = None
+    # 在途库存
+    on_the_way_stock: Optional[int] = None
+    # 未发库存
+    not_shipped_stock: Optional[int] = None
+    # 占用库存
+    occupy_stock: Optional[int] = None
+    # 可用库存
+    available_stock: Optional[int] = None
+    # 总库存
+    total_stock: Optional[int] = None
+    # 更新时间
+    update_time: str
+    # 创建时间
+    create_time: str
+
+
+class PurchasingAllQuery(BaseModel):
+    """
+    采购订单全部查询参数
+    """
+    page_no: int = 1
+    page_size: int = 300
+    # 搜索类型0(采购单号)1(供货商)2(商品sku)6(商品编码)5(商品名称)4(1688单号)3(运单号)7(关联单号)8(采购单备注)9(商品备注)
+    search_type: int = 0
+    # 搜索内容
+    search_value: str = ''
+    # 搜索模式1(精确匹配)0(模糊匹配)2(完全匹配)
+    search_mode: int = 1
+    # 评论颜色使用,分隔
+    comment_colors: str = ''
+    # 仓库id
+    warehouse_id: str = ''
+    # 店铺id(或者1688账号)
+    authorization_id: str = ''
+    # 排序方式: 1(按创建时间) 2(按更新时间) 4(按照采购单号)5(按照供货商名)
+    purchasing_px: int = 2
+    # 排序方式: asc(升序) desc(降序)
+    purchasing_px_val: str = 'desc'
+    is_advance_search: str = 'Y'
+    # 采购金额起始
+    price_left: str = ''
+    # 采购金额结束
+    price_right: str = ''
+    # 采购数量起始
+    quantity_left: str = ''
+    # 采购数量结束
+    quantity_right: str = ''
+    # 创建时间开始
+    create_start_time: str = ''
+    # 创建时间结束
+    create_end_time: str = ''
+    # 快递签收时间开始
+    end_time_start: str = ''
+    # 快递签收时间结束
+    end_time_end: str = ''
+    # 到货时间开始
+    arrive_start_time: str = ''
+    # 到货时间结束
+    arrive_end_time: str = ''
+    # 供货商id
+    supplier_id: str = ''
+    # 采购员id
+    agent_id: str = ''
+    # 结算方式 1(款到发货)2(货到付款)3(账期付款)4(其它)5(账期付款周结)6(账期付款半月结)7(账期付款月结)
+    settlement_method: str = ''
+    # 订单状态
+    cur_states: str = ''
+    # 付款状态
+    submit_states: str = ''
+    # 到货状态
+    arrive_state: str = ''
+    # 消息标记-有留言(勾选是Y)
+    has_comment: str = ''
+    # 消息标记-有备注(勾选是Y)
+    has_remark: str = ''
+    # 无备注
+    no_has_comment: str = ''
+    # 下单类型2(1688采购)3(手工采购)''(全部)
+    is_alibaba: str = ''
+    # 物流信息 ''(全部)2(有运单号)3(无运单号)
+    is_have_identify_no: str = ''
+
+    model_config = ConfigDict(
+        alias_generator=to_camel,
+        populate_by_name=True  # 对应旧版的 allow_population_by_field_name
+    )

ey_commerce_lib/utils/dxm.py

@@ -0,0 +1,43 @@
+import math
+from typing import TypedDict
+
+
+class RemainingShipTime(TypedDict):
+    day: int
+    hour: int
+    minute: int
+    second: int
+
+
+def get_remaining_ship_time(time_int) -> RemainingShipTime:
+    """
+    获取剩余发货时间
+    :return:
+    """
+    d = math.floor(time_int / 86400)
+    h = math.floor((time_int % 86400) / 3600)
+    m = math.floor(((time_int % 86400) % 3600) / 60)
+    s = math.floor(((time_int % 86400) % 3600) % 60)
+    return {
+        "day": d,
+        "hour": h,
+        "minute": m,
+        "second": s
+    }
+
+
+def get_data_custom_mark_to_str(custom_mark: str) -> str:
+    mark_list = custom_mark.split(',')
+    color_str_list = list()
+    mark_color_list = ['isGreen', 'isYellow', 'isOrange', 'isRed', 'isViolet', 'isBlue', 'cornflowerBlue', 'pink',
+                       'teal',
+                       'turquoise']
+
+    for index in range(len(mark_list)):
+        if index >= len(mark_list):
+            break
+        # print(mark_list[index])
+        if mark_list[index] == '0':
+            continue
+        color_str_list.append(f'{mark_color_list[index]}_{mark_list[index]}')
+    return '&'.join(color_str_list)

ey_commerce_lib/utils/list_util.py

@@ -0,0 +1,23 @@
+from typing import Optional
+
+
+def get_list_first_or_none(array: list) -> Optional[any]:
+    """
+    获取列表第一个元素没有则获取空
+    :param array:
+    :return:
+    """
+    if len(array) > 0:
+        return array[0]
+    return None
+
+
+def get_str_list_first_not_blank_or_none(array: list) -> Optional[str]:
+    """
+    获取列表第一个元素(不能为'')没有则获取空
+    :param array:
+    :return:
+    """
+    if len(array) > 0 and array[0] != '':
+        return array[0].strip()
+    return None

ey_commerce_lib/utils/str.py

@@ -0,0 +1,3 @@
+def to_camel(string: str) -> str:
+    parts = string.split('_')
+    return parts[0] + ''.join(word.capitalize() for word in parts[1:])

ey_commerce_lib-1.0.0.dist-info/METADATA

@@ -0,0 +1,11 @@
+Metadata-Version: 2.4
+Name: ey-commerce-lib
+Version: 1.0.0
+Summary: eeyoung电商客户端调用封装
+Author-email: 饶奇奇 <1124393197@qq.com>
+Requires-Python: >=3.13
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: lxml>=5.3.2
+Requires-Dist: pydantic>=2.11.3
+Requires-Dist: pytest-asyncio>=0.26.0
+Requires-Dist: pytest>=8.3.5

ey_commerce_lib-1.0.0.dist-info/RECORD

@@ -0,0 +1,25 @@
+ey_commerce_lib/__init__.py,sha256=QTYqXqSTHFRkM9TEgpDFcHvwLbvqHDqvqfQ9EiXkcAM,23
+ey_commerce_lib/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ey_commerce_lib/dxm/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ey_commerce_lib/dxm/main.py,sha256=nJEsEp7shGofGdAOd3fIyCF7NxMigGwpMdlpDuFtbUs,14569
+ey_commerce_lib/dxm/order.py,sha256=hMdNm9X5h9tbvMWFnyE5hcSF4butzn7m-akGqLQUD0k,35
+ey_commerce_lib/dxm/constant/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ey_commerce_lib/dxm/constant/order.py,sha256=U-2NYnkIcqukzMtOFpfqvzIktu_t7jYEms_n9LgKMlY,2213
+ey_commerce_lib/dxm/exception/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ey_commerce_lib/dxm/exception/common.py,sha256=DM5vItHdZCGK2Piqp2S5TFxPm3pioMzzlV-1RTxty00,159
+ey_commerce_lib/dxm/parser/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ey_commerce_lib/dxm/parser/common.py,sha256=bJcP6ZQd0hNeZpEU-8_nN_2AKB69WufKF_JKXtKYZqA,2425
+ey_commerce_lib/dxm/parser/order.py,sha256=KvXKdrmec9rWlYuXPDIIhMGTaPC3rDKTELK3CB-jQ0M,16394
+ey_commerce_lib/dxm/parser/purchase.py,sha256=gBHpIMPPgOZXdU6RIU_a8NogjtzPphCtcLmRauh8r-s,2206
+ey_commerce_lib/dxm/parser/warehouse.py,sha256=LfmqVixV5IcnPvr6Ma4XYoWUdXixQ16xzPP07bJrWb0,3192
+ey_commerce_lib/dxm/schemas/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ey_commerce_lib/dxm/schemas/common.py,sha256=ihCeYrh4K_-m9_4rVzHm-o8rFNqzcD5XkO0JQd2023g,234
+ey_commerce_lib/dxm/schemas/order.py,sha256=uzhSgW0d7Z3L1yYb0meZ2AEF1OosnVM408W2-wZVriE,7802
+ey_commerce_lib/dxm/schemas/warehouse.py,sha256=WkJcLIoeGsTkqEK-6UdQMxScdFT05gfGHv7ZWsavo84,5122
+ey_commerce_lib/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ey_commerce_lib/utils/dxm.py,sha256=jVNltK_Pm_yMzXReD0Aw5VW6kzIZ5Bn23RucS0DKBI0,1196
+ey_commerce_lib/utils/list_util.py,sha256=R1w7B1m3sEXr38zSHWp-15C3xAs5ykYCCpvwmnRW4xs,545
+ey_commerce_lib/utils/str.py,sha256=939xE0y8U7KEWjwbEezMlaWJNBsfb2BSb-dBpYbOD8Q,138
+ey_commerce_lib-1.0.0.dist-info/METADATA,sha256=FCioN9_jIGdxiMiqAe1dGzH0CM1gZoohfKMpFLwNwKY,326
+ey_commerce_lib-1.0.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+ey_commerce_lib-1.0.0.dist-info/RECORD,,

ey_commerce_lib-1.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.27.0
+Root-Is-Purelib: true
+Tag: py3-none-any