You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

142 lines
5.4 KiB

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>ecommerce</groupId>
<artifactId>channel-sdk-parent</artifactId>
<version>1.0.0-SNAPSHOT</version>
<packaging>pom</packaging>
<name>common-ecommerce</name>
<description>多渠道电商履约对接 SDK</description>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
<maven.compiler.source>1.8</maven.compiler.source>
<maven.compiler.target>1.8</maven.compiler.target>
<java.version>1.8</java.version>
<okhttp.version>4.12.0</okhttp.version>
<jackson.version>2.13.5</jackson.version>
<slf4j.version>1.7.36</slf4j.version>
<junit.version>5.8.2</junit.version>
<lombok.version>1.18.30</lombok.version>
</properties>
<modules>
<module>sdk-common</module>
<module>channel-sdk-core</module>
<module>sdk-testkit</module>
<module>lingxing</module>
feat(walmart): 沃尔玛 Marketplace 直连适配器(只读一期) 通道 ChannelProvider.DIRECT + Platform.WALMART_SC,新增模块 channel-sdk-walmart。 一期只做只读:鉴权、订单、商品、售后。标发、退款、商品写入不在本期, 对应能力位也不声明——门面调用会显式抛 UnsupportedCapabilityException。 【core 模型增量】全部是可选字段,不影响领星现有行为: - 新增 ShipToAddress(收件信息;toString 只输出城市/州/邮编,不输出街道与姓名) - SalesOrder 增加 buyerEmail / shipToAddress - OrderLine 增加 status(行状态原值)与 lineAmount(行金额,金额权威来源) - OrderLine.unitPrice 明确为「单价」:行金额除以数量,除不尽时留 null 而不是四舍五入倒推,否则 unitPrice × quantity 与原金额会差出分差 【适配器】 - POST /v3/token(Basic Auth + client_credentials),按 clientId 缓存, 提前 120s 续期;401/403 时 forceRefresh 后重发一次 - GET /v3/orders、/v3/orders/{id}:updatedAfter/Before 映射到创建时间窗 (沃尔玛没有更新时间过滤),跨度超 180 天本地拒绝 - GET /v3/items、/v3/items/{sku}:limit 上限 200;syncStrategy=FULL_PULL_DIFF, 传更新时间窗直接报错而不是静默忽略 - GET /v3/returns:一个退货单按商品行展开成多个 AfterSale, nextCursor 是整段查询串,翻页时整串拼到路径后 - 扩展查询:getReturn(退货详情)、getShipping(发货信息),沙箱均 404 增量语义拆成两条车道:pull 走创建时间窗语义可预测,老单状态变化由 pullOpenOrders 按行状态对账,不混在一个方法里。 脏数据处理:缺订单号/下单时间/退货单号的记录跳过并 WARN,不崩整页, 也不用假值兜底写脏主键。运费不冒充商品单价,行金额除不尽时 unitPrice 留 null。 【测试】108 个:订单 22、商品 18、售后 13、脏数据 10、扩展查询 12、 状态映射 16、错误 11、门面 5、沙箱探针 1(默认跳过)。 【文档】仅新增 docs/walmart/README.md,以及 README / 操作手册.md 里 沃尔玛相关的两处能力表条目。 Co-Authored-By: Claude Code <noreply@anthropic.com>
3 days ago
<module>channel-sdk-walmart</module>
<module>warehouse-sdk-core</module>
<module>warehouse-sdk-testkit</module>
<module>warehouse-sdk-yqn</module>
<module>warehouse-sdk-xincang</module>
<module>warehouse-sdk-edayun</module>
<module>warehouse-sdk-hengjian</module>
</modules>
<dependencyManagement>
<dependencies>
<dependency>
<groupId>ecommerce</groupId>
<artifactId>sdk-common</artifactId>
<version>${project.version}</version>
</dependency>
<dependency>
<groupId>ecommerce</groupId>
<artifactId>channel-sdk-core</artifactId>
<version>${project.version}</version>
</dependency>
<dependency>
<groupId>ecommerce</groupId>
feat(walmart): 沃尔玛 Marketplace 直连适配器(只读一期) 通道 ChannelProvider.DIRECT + Platform.WALMART_SC,新增模块 channel-sdk-walmart。 一期只做只读:鉴权、订单、商品、售后。标发、退款、商品写入不在本期, 对应能力位也不声明——门面调用会显式抛 UnsupportedCapabilityException。 【core 模型增量】全部是可选字段,不影响领星现有行为: - 新增 ShipToAddress(收件信息;toString 只输出城市/州/邮编,不输出街道与姓名) - SalesOrder 增加 buyerEmail / shipToAddress - OrderLine 增加 status(行状态原值)与 lineAmount(行金额,金额权威来源) - OrderLine.unitPrice 明确为「单价」:行金额除以数量,除不尽时留 null 而不是四舍五入倒推,否则 unitPrice × quantity 与原金额会差出分差 【适配器】 - POST /v3/token(Basic Auth + client_credentials),按 clientId 缓存, 提前 120s 续期;401/403 时 forceRefresh 后重发一次 - GET /v3/orders、/v3/orders/{id}:updatedAfter/Before 映射到创建时间窗 (沃尔玛没有更新时间过滤),跨度超 180 天本地拒绝 - GET /v3/items、/v3/items/{sku}:limit 上限 200;syncStrategy=FULL_PULL_DIFF, 传更新时间窗直接报错而不是静默忽略 - GET /v3/returns:一个退货单按商品行展开成多个 AfterSale, nextCursor 是整段查询串,翻页时整串拼到路径后 - 扩展查询:getReturn(退货详情)、getShipping(发货信息),沙箱均 404 增量语义拆成两条车道:pull 走创建时间窗语义可预测,老单状态变化由 pullOpenOrders 按行状态对账,不混在一个方法里。 脏数据处理:缺订单号/下单时间/退货单号的记录跳过并 WARN,不崩整页, 也不用假值兜底写脏主键。运费不冒充商品单价,行金额除不尽时 unitPrice 留 null。 【测试】108 个:订单 22、商品 18、售后 13、脏数据 10、扩展查询 12、 状态映射 16、错误 11、门面 5、沙箱探针 1(默认跳过)。 【文档】仅新增 docs/walmart/README.md,以及 README / 操作手册.md 里 沃尔玛相关的两处能力表条目。 Co-Authored-By: Claude Code <noreply@anthropic.com>
3 days ago
<artifactId>channel-sdk-walmart</artifactId>
<version>${project.version}</version>
</dependency>
<dependency>
<groupId>ecommerce</groupId>
<artifactId>sdk-testkit</artifactId>
<version>${project.version}</version>
</dependency>
<dependency>
<groupId>ecommerce</groupId>
<artifactId>warehouse-sdk-core</artifactId>
<version>${project.version}</version>
</dependency>
<dependency>
<groupId>ecommerce</groupId>
<artifactId>warehouse-sdk-testkit</artifactId>
<version>${project.version}</version>
</dependency>
<dependency>
<groupId>ecommerce</groupId>
<artifactId>warehouse-sdk-yqn</artifactId>
<version>${project.version}</version>
</dependency>
<dependency>
<groupId>ecommerce</groupId>
<artifactId>warehouse-sdk-xincang</artifactId>
<version>${project.version}</version>
</dependency>
<dependency>
<groupId>ecommerce</groupId>
<artifactId>warehouse-sdk-hengjian</artifactId>
<version>${project.version}</version>
</dependency>
<dependency>
<groupId>com.squareup.okhttp3</groupId>
<artifactId>okhttp</artifactId>
<version>${okhttp.version}</version>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>${jackson.version}</version>
</dependency>
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
<version>${slf4j.version}</version>
</dependency>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<version>${lombok.version}</version>
<scope>provided</scope>
</dependency>
<dependency>
<groupId>org.junit.jupiter</groupId>
<artifactId>junit-jupiter</artifactId>
<version>${junit.version}</version>
<scope>test</scope>
</dependency>
</dependencies>
</dependencyManagement>
<build>
<pluginManagement>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.11.0</version>
<configuration>
<source>1.8</source>
<target>1.8</target>
<encoding>UTF-8</encoding>
</configuration>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
<version>2.22.2</version>
</plugin>
</plugins>
</pluginManagement>
</build>
</project>