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"; /** 取消销售订单(API 122)。 */ public static final String PATH_ORDER_CANCEL = "/v1/saleOrder/cancel"; /** 批量查询库存(API 107),GET + 分页。 */ public static final String PATH_INVENTORY_PAGE = "/v2/inventory/get_inventory_by_page"; /** 创建调拨单(API 139)。 */ public static final String PATH_TRANSFER_CREATE = "/v2/transferOutboundPlan/create"; /** 创建入库计划单(API 97)。 */ public static final String PATH_INBOUND_CREATE = "/v1/inbound/createInboundPlan"; /** 打印入库计划单箱标(API 99):异步生成,只回任务编号。 */ public static final String PATH_INBOUND_BOX_LABEL = "/v1/inbound/generateBoxLabel"; /** 打印入库计划单 SKU 标(API 100):异步生成,只回任务编号。 */ public static final String PATH_INBOUND_SKU_LABEL = "/v1/inbound/generateItemLabel"; /** 查询入库计划(API 101)。 */ public static final String PATH_INBOUND_GET = "/v1/inbound/getInboundPlanInfo"; /** 创建销售退货(API 81)。 */ public static final String PATH_RETURN_CREATE = "/v3/saleReturn/createSaleReturnPlan"; /** 销售退货计划查询(API 83):按退货单号取详情,含明细行 id。 */ public static final String PATH_RETURN_GET = "/v3/saleReturn/getInboundPlanInfo"; /** 退货条目处理(API 77):按明细行设置检验后处理方式。 */ public static final String PATH_RETURN_PROCESS = "/v3/saleReturn/addProcessMode"; /** 创建销毁计划(API 88)。 */ public static final String PATH_DESTRUCTION_CREATE = "/v1/destroyPlan/createDestroyPlan"; /** * 物流轨迹(API 189):{@code GET /api/v2/orderShipment/track/{trackingNo}}。 * *

注意主机不同:这个接口在 {@code pr-ship-api.yqn.com},不是仓接口的 * {@code pr-hwc-open-api.yqn.com}。调用方需通过 * {@code WarehouseConnection.of(主基址, 辅助基址, 凭据)} 传辅助基址, * 未传时适配器显式拒绝而不是打到主基址上。

*/ public static final String PATH_TRACKING = "/api/v2/orderShipment/track/"; /** 轨迹接口的 PR 环境基址;与仓接口不同主机,供调用方填 {@code auxEndpointBaseUrl}。 */ public static final String AUX_BASE_URL_PR = "https://pr-ship-api.yqn.com"; /** * 轨迹接口的成功码——待联调核对。 * *

该接口在另一个主机(ship-api),文档响应示例里 {@code code} 是 {@code 1}, * 但同站的其它接口都是 {@code 200},且该文档的示例值是自动生成的占位符 * ({@code message: "example"}),不能据此断定。因此两者都按成功处理, * 联调确认后再收紧为单一值。

*/ public static final int[] TRACK_SUCCESS_CODES = {1, 200}; /** 轨迹接口某次返回的业务码是否按成功处理。 */ public static boolean isTrackSuccess(int code) { for (int ok : TRACK_SUCCESS_CODES) { if (ok == code) { return true; } } return false; } /** 结算明细(API 133):作业费 / 仓储费 / 增值服务费 / 尾程费。 */ public static final String PATH_FEE_DETAIL = "/v1/warehouse/operation/costs/detail"; /** 订单测算 / 运费试算(API 121):发货前按包裹 + 地址 + 渠道询价。 */ public static final String PATH_FEE_ESTIMATE = "/v1/saleOrder/calculate"; /** 物流产品服务清单(API 135):按仓查询可用承运商渠道。 */ public static final String PATH_LOGISTICS_PRODUCTS = "/v2/sysCarrierGroup/getCarrierGroupList"; /** 查询仓库(API 134):组织下全部可用仓的基础档案。 */ public static final String PATH_WAREHOUSE_FIND_ALL = "/v1/warehouse/findAll"; /** * 仓库查询接口(API 134)的成功 status 值。 * *

实测该接口返回 {@code status=200, message=success},不是文档示例的 1。

*/ public static final int WAREHOUSE_LIST_SUCCESS_STATUS = 200; /** Spec §7.5:三家仓均未公开限流值,保守默认 2 req/s/仓。 */ public static final int PERMITS_PER_SECOND = 2; private YqnConstants() { } }