package common.ecommerce.yqn; /** * 运去哪(YQN)协议常量。 * *

端点与路径是协议的一部分,写在代码里,不做成配置表。 * 运行时不使用 {@link #PRODUCTION_BASE_URL}:端点由调用方每次经 * {@code WarehouseConnection} 传入。

* *

端点与路径来自 Spec W0 §2.3 / §8.1(《得力系统对接.xlsx》整理)。

*/ public final class YqnConstants { public static final String ADAPTER_ID = "yqn"; /** PR(联调)环境。 */ public static final String PR_BASE_URL = "https://pr-hwc-open-api.yqn.com"; /** 生产环境。 */ public static final String PRODUCTION_BASE_URL = "https://open-hwc.yqn.com"; /** * 组织级 Token 的请求头名。API 115 文档确认:{@code x-api-key},固定值放请求头,无签名。 */ public static final String TOKEN_HEADER = "x-api-key"; /** 商品创建 / 编辑(V1 推荐版)。 */ public static final String PATH_PRODUCT_SAVE = "/v1/product/save"; /** 创建销售订单(API 123)。 */ public static final String PATH_ORDER_CREATE = "/v1/saleOrder/create"; /** 订单详情(API 128):按来源单号查完整订单。 */ public static final String PATH_ORDER_FIND_ONE = "/v1/saleOrder/findOne"; /** 出库单取消。 */ public static final String PATH_ORDER_CANCEL = "/saleorder/OrderCancel"; /** 批量库存查询。 */ public static final String PATH_INVENTORY_BATCH = "/inventory/BatchQueryInventory"; /** 库存调拨出库计划。 */ public static final String PATH_TRANSFER_OUTBOUND = "/transferoutboundplan/TransferOutboundPlanCreate"; /** 头程入库创建。 */ public static final String PATH_INBOUND_CREATE = "/inbound/inboundCreate"; /** 头程入库查询。 */ public static final String PATH_INBOUND_QUERY = "/inbound/InboundPlanQuery"; /** 退货发起。 */ public static final String PATH_RETURN_CREATE = "/salereturn/SalesReturnCreate"; /** 退货处理方式(二次上架 / 销毁)。 */ public static final String PATH_RETURN_DISPOSITION = "/salereturn/SaleReturnAddProcessMode"; /** 销毁计划。 */ public static final String PATH_DESTRUCTION_CREATE = "/destroyplan/DestructionPlanCreate"; /** 物流轨迹。 */ public static final String PATH_TRACKING = "/cloudship/expressdelivery/GetTrackingStatus"; /** 费用账单。 */ public static final String PATH_FEE_SETTLEMENT = "/fee/SettlementDetails"; /** 费用试算。 */ public static final String PATH_FEE_ESTIMATE = "/fee/SalesOrderCalculation"; /** Spec §7.5:三家仓均未公开限流值,保守默认 2 req/s/仓。 */ public static final int PERMITS_PER_SECOND = 2; private YqnConstants() { } }