lml
|
5b45641e4b
|
feat(xincang): 对接实时库存与库龄列表
- 实时库存 GET api.stocklist:warehouse_code 必填,支持 product_no / page / limit
- 库龄列表 GET api.stockagelist:bill_date 为「起 - 止」单值,支持 key / is_need_fee_rate
core 只新增、不修改:
- InventorySnapshot 追加 productName / pendingOutbound / alertQuantity / volumeCbm
(信仓库存行有、原模型无处承载)
- InventoryCapable 增加 default queryAges(ctx, InventoryAgeQuery),
WarehouseOperations.InventoryView 增加 queryAges
- 新增 InventoryAgeQuery / InventoryAgeRecord:库龄是计费视角数据
(按计费日 × 仓 × SKU × 柜号计费),与库存快照分开建模
信仓实现要点:
- 实时库存只接受单个 warehouse_code;传多个显式拒绝,不静默只查第一个
- syncStrategy = FULL_PULL_DIFF:该接口没有时间增量参数
- 分页游标是字符串化页码,按「本页是否满页」判断下一页(count 不可靠)
- 库龄行缺少计费日期时跳过,不猜日期;时间统一按北京时间解析成 UTC
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
2 weeks ago |
lml
|
47757616e5
|
feat(xincang): 对接订单详情与转运详情
- 订单详情 GET api.get_order:order_no 与 ckh 二选一(outboundRequestNo 走 ckh,
providerOrderId 走 order_no),映射到 OutboundOrder
- 转运详情 GET fba.fba_detail:token + order_no,映射到 TransferOrder
映射要点:
- state 经 XincangOrderStatus / XincangTransferState → core 枚举,未知值归 UNKNOWN
- 订单 order_type=wayfair → LabelMode.PLATFORM_LABEL,其余 WAREHOUSE_LABEL
- 详情只回系统单号 order_no,outboundRequestNo 用它兜底,业务参考号进 orderRef
- products[] 为空时退回 product_sku + sku_count 单值字段
- 时间按北京时间解析成 UTC;空串一律转 null
- errno=0 但 rst 为空抛 ValidationException,不返回"查到了空单"
core 只新增、不修改:
- TransferCapable 增加 default getTransfer(ctx, providerTransferNo)
- WarehouseOperations 增加 getTransfer,带 CallSupport.observe
方法名带 Transfer 后缀:InboundCapable 已有同签名的 get(ctx, String),
两者返回类型不同,同一适配器实现时无法区分(与既有 getReturn 同一手法)。
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
2 weeks ago |
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 |
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 |