lml
|
ca6d00ba18
|
fix(xincang): 补齐下单与转运缺失的字段
上一版按文档只实现了部分字段,这次对齐到 schema 全量:
一单多件 api.add_order_multiple:
- 补 gzh(trackingNumber)/ face_base64(labelContentBase64)/
shop_name / sfp;order_type=wayfair 时前两者必填,缺失在下单前拦下,
不再等仓返回看不懂的错误
- 移除 remark:该接口 schema 没有这个字段,之前是多发的
新增转运 fba.do_fba:
- 补 4 个单附件(product_label_att / ctn_label_att / express_label_att /
pallet_label_att)、2 个数组附件(other_att / bol_att)、
express_print_copies
- products 明细补 fn_sku / ctn_sku / remark
模型配套:
- OutboundCommand 增加 trackingNumber / labelContentBase64 / shopName / sfp
- TransferCommand 增加 6 个附件字段与快递份数;TransferLine 增加三方 SKU、
箱标 SKU 与备注(保留原两参构造,YQN 不受影响)
- 新增 TransferAttachment 承载 upload.files 返回的附件元数据,
SDK 只搬运、不下载不落盘
字段覆盖已与文档逐项核对:两个接口均无缺、无多。
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
2 weeks ago |
chenchuchuan
|
a8dfb08e69
|
refactor(warehouse): 枚举下沉 core + 平台枚举分层映射
枚举原来散在各模型内部(OutboundStatus 嵌在 OutboundOrder 里、DealMethod 嵌在
ReturnCommand 里),且直接带仓方的数字码,导致 core 知道运去哪的协议值。改成两层:
- 底层枚举(warehouse-sdk-core/enums):只含 SDK 自编稳定 code + 中文名,
不认识任何仓的码值。code 从 10 起按 10 递增、只追加不重排,落库用。
- 平台枚举(warehouse-sdk-yqn/enums):带仓方原始码,toCore() 映射到底层。
运去哪出库状态是自由文本(无码表),按关键字收敛;其余按文档码表 1:1。
Mapper 里 9 个散落的 switch 全部删除,改为一行 of(raw).toCore()。
顺带修两处会误导下游的问题:
- OutboundStatus 缺 UNKNOWN,认不出的状态被兜底成 SUBMITTED(已下发)。
补 UNKNOWN(0, rank=-1),认不出归它;对应测试断言一并修正,
新增 unknownStatusIsNotGuessed 覆盖 null / 空串 / 未知值。
- InboundOrder / TransferOrder / WarehouseReturn / BillingDocument 缺
sourceProvider,rawStatus 无法解释(同一数字在不同仓含义不同)。补上字段,
运去哪的 Mapper 全部标注 YQN。
落库契约写进 WarehouseSink:rawStatus 必须与 sourceProvider 成对保存,
它是映射调整后唯一能重跑、修正历史数据的依据。
删除 WarehouseEnum 接口——在该规模下各枚举自带 code()/label()/ofCode() 足够,
不引入额外抽象。合并 ReturnDisposition 到 ReturnProcessDisposition(后者加
UNKNOWN),退货只保留「预约预报」与「检验后决定」两套语义。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |
lml
|
cde4bac44a
|
feat(xincang): 对接一单多件下单与转运创建 / 审核
- 新增订单一单多件:POST api.add_order_multiple,multipart/form-data,
products 字段是 JSON 字符串;返回 rst.order_no 作为仓侧单号
- 新增转运:POST fba.do_fba,application/json,返回 rst.order_no,
创建后处于待审核
- 转运审核:POST fba.do_approve,无请求体,token 与 order_no 都在 query
仓库域内核的配套扩展(YQN 不受影响,原有测试全绿):
- OutboundCommand 增加 splitOrder,仅声明了 SPLIT 的仓解释
- TransferCommand 增加 po / orderType / deliveryMode / deliveryWay /
otherWarehouseName / labelRequirements / palletRequired / 各类贴标份数
- TransferCapable 增加默认 approve(不支持的仓显式拒绝),
WarehouseOperations.approveTransfer 走幂等守卫,动作键 approve
字段映射的取舍:
- logistics_type 用 carrierCode 承载;ckh 用 outboundRequestNo(要求唯一)
- is_sign 模型无对应字段,固定发「否」
- order_type:Wayfair → wayfair,其余 → common
- 地址超过 32 字符的部分自动拆到 address2
- 字典字段(orderType / deliveryMode / deliveryWay / labelRequirements)
只接受仓方字典原值,SDK 不做归一
- 信仓这版不收申报信息与包裹尺寸,统一模型里的对应字段不发送
- 转运仅支持 TransferType.OUTBOUND(信仓转运 = 仓到平台仓)
|
2 weeks ago |
lml
|
8078e72de9
|
feat(xincang): 对接商品新增 / 更新(api.add_product / api.update_product)
信仓没有 upsert 接口,createOrUpdate 按「先查临时产品,有则更新、无则新增」实现:
- GET api.productlist?state=0 按 SKU 查临时产品,结果再按 product_no 精确比对,
防止 key 模糊匹配把相似 SKU 误判为已存在
- 命中走 api.update_product(只对临时产品有效),否则 api.add_product
- 写接口 token 同时放 query(文档通用约定)与请求体(产品接口 schema 要求)
- WarehouseProduct 的 cm / g 按常量换算成信仓的 inch / lbs,保留 4 位小数;
金额取 declaredValue 并固定 USD,非美元直接拒绝,避免静默按美元记错价
- bar_code 缺失时退回 SKU;packing_rate 固定 1(必填项);
包装方式 / SN / 海关等信仓未定义的字段不发送
- 适配器改为实现 WarehouseProductCapable,能力位声明 PRODUCT
未接入 api.pub_product:建档结果仍是临时产品(state=0),上架正式产品另行接入。
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
2 weeks ago |
lml
|
c6241dddc7
|
feat(xincang): 新增信仓三方仓模块与登录换 token
- GET /api.login?appkey=&secret= 换取客户级 token,token 放 query 参数,
不是 Authorization 头
- token_expire_time 按北京时间 yyyy-MM-dd HH:mm:ss 解析为 UTC expiresAt;
字段缺失按文档 2 小时兜底,格式非法直接失败
- TokenManager 按 appkey 缓存(同客户多仓共用一个 token),提前 10 分钟续期;
信仓无 refresh 接口,到期即重新登录
- XincangEnvelope 统一校验顶层 errno 与 rst.code,HTTP 401/403/429/5xx 照常分类,
trace_id 落到 platformRequestId
- 本期不声明任何 WarehouseCapability,业务能力后续逐个接入
- 附登录只读探针,默认跳过,凭据走 -Dxincang.probe.*
待核对:生产基址(文档只给测试地址)与限流值(文档未公开,暂按 2 req/s)。
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
2 weeks ago |