diff --git a/core/src/main/java/common/ecommerce/capability/SettlementCapable.java b/core/src/main/java/common/ecommerce/capability/SettlementCapable.java new file mode 100644 index 0000000..29cb5e6 --- /dev/null +++ b/core/src/main/java/common/ecommerce/capability/SettlementCapable.java @@ -0,0 +1,17 @@ +package common.ecommerce.capability; + +import common.ecommerce.model.settlement.SettlementQuery; +import common.ecommerce.model.settlement.SettlementTransaction; +import common.ecommerce.model.support.Page; +import common.ecommerce.sdk.ChannelContext; + +/** + * 结算 / 账单能力:拉取平台结算交易明细。 + * + *
一行代表一笔费用(佣金、配送费、退款、广告费等),平台可能按 + * 结算周期或修改时间分页给出。重复同步按 {@code transactionKey} upsert。
+ */ +public interface SettlementCapable extends PlatformAdapter { + + Page平台通常要求「结算时间」与「修改时间」二选一,或给出精确搜索值; + * 具体校验在适配器里做,core 只承载条件。
+ */ +public final class SettlementQuery { + + private final LocalDate settledAfter; + private final LocalDate settledBefore; + private final Instant modifiedAfter; + private final Instant modifiedBefore; + private final String eventType; + private final String transactionType; + private final String searchField; + private final List用于对账:一笔订单可能拆成佣金、配送费、退款、广告费等多行, + * 每行由 {@code transactionKey} 唯一标识。{@code transactionKey} 必须稳定, + * 否则重复同步会产生重复账单;平台在未结算阶段可能变更 key 的, + * 由适配器文档单独说明。
+ */ +public final class SettlementTransaction { + + private final String omsStoreId; + private final String transactionKey; + private final ChannelProvider sourceProvider; + private final String sourceAccountId; + private final String channelOrderId; + private final String storeName; + private final String countryCode; + private final String fulfillment; + private final String eventType; + private final String transactionType; + private final String sellerSku; + private final String localSku; + private final String asin; + private final Money amount; + private final int quantity; + private final String processingStatus; + private final String fundTransferStatus; + private final String settlementId; + private final PlatformTime postedAt; + private final String marketplaceName; + + private SettlementTransaction(Builder b) { + this.omsStoreId = Objects.requireNonNull(b.omsStoreId, "omsStoreId"); + this.transactionKey = Objects.requireNonNull(b.transactionKey, "transactionKey"); + this.sourceProvider = Objects.requireNonNull(b.sourceProvider, "sourceProvider"); + this.sourceAccountId = b.sourceAccountId; + this.channelOrderId = b.channelOrderId; + this.storeName = b.storeName; + this.countryCode = b.countryCode; + this.fulfillment = b.fulfillment; + this.eventType = b.eventType; + this.transactionType = b.transactionType; + this.sellerSku = b.sellerSku; + this.localSku = b.localSku; + this.asin = b.asin; + this.amount = b.amount; + this.quantity = b.quantity; + this.processingStatus = b.processingStatus; + this.fundTransferStatus = b.fundTransferStatus; + this.settlementId = b.settlementId; + this.postedAt = b.postedAt; + this.marketplaceName = b.marketplaceName; + } + + public static Builder builder() { + return new Builder(); + } + + public String omsStoreId() { + return omsStoreId; + } + + /** 交易明细唯一标识,重复同步按它 upsert。 */ + public String transactionKey() { + return transactionKey; + } + + public ChannelProvider sourceProvider() { + return sourceProvider; + } + + public String sourceAccountId() { + return sourceAccountId; + } + + public String channelOrderId() { + return channelOrderId; + } + + public String storeName() { + return storeName; + } + + public String countryCode() { + return countryCode; + } + + public String fulfillment() { + return fulfillment; + } + + /** 来源事件,如 Shipment / Refund / ServiceFee。 */ + public String eventType() { + return eventType; + } + + /** 交易类型,如 Commission / Tax / Refund。 */ + public String transactionType() { + return transactionType; + } + + public String sellerSku() { + return sellerSku; + } + + public String localSku() { + return localSku; + } + + public String asin() { + return asin; + } + + /** 金额;平台未给币种时为 null。 */ + public Money amount() { + return amount; + } + + public int quantity() { + return quantity; + } + + /** 结算状态:Open / Closed / Reconciled。 */ + public String processingStatus() { + return processingStatus; + } + + /** 转账状态:Succeeded / Processing / Failed / Unknown。 */ + public String fundTransferStatus() { + return fundTransferStatus; + } + + public String settlementId() { + return settlementId; + } + + /** 结算时间;平台未给可解析时间时为 null。 */ + public PlatformTime postedAt() { + return postedAt; + } + + public String marketplaceName() { + return marketplaceName; + } + + public static final class Builder { + + private String omsStoreId; + private String transactionKey; + private ChannelProvider sourceProvider; + private String sourceAccountId; + private String channelOrderId; + private String storeName; + private String countryCode; + private String fulfillment; + private String eventType; + private String transactionType; + private String sellerSku; + private String localSku; + private String asin; + private Money amount; + private int quantity; + private String processingStatus; + private String fundTransferStatus; + private String settlementId; + private PlatformTime postedAt; + private String marketplaceName; + + public Builder omsStoreId(String omsStoreId) { + this.omsStoreId = omsStoreId; + return this; + } + + public Builder transactionKey(String transactionKey) { + this.transactionKey = transactionKey; + return this; + } + + public Builder sourceProvider(ChannelProvider sourceProvider) { + this.sourceProvider = sourceProvider; + return this; + } + + public Builder sourceAccountId(String sourceAccountId) { + this.sourceAccountId = sourceAccountId; + return this; + } + + public Builder channelOrderId(String channelOrderId) { + this.channelOrderId = channelOrderId; + return this; + } + + public Builder storeName(String storeName) { + this.storeName = storeName; + return this; + } + + public Builder countryCode(String countryCode) { + this.countryCode = countryCode; + return this; + } + + public Builder fulfillment(String fulfillment) { + this.fulfillment = fulfillment; + return this; + } + + public Builder eventType(String eventType) { + this.eventType = eventType; + return this; + } + + public Builder transactionType(String transactionType) { + this.transactionType = transactionType; + return this; + } + + public Builder sellerSku(String sellerSku) { + this.sellerSku = sellerSku; + return this; + } + + public Builder localSku(String localSku) { + this.localSku = localSku; + return this; + } + + public Builder asin(String asin) { + this.asin = asin; + return this; + } + + public Builder amount(Money amount) { + this.amount = amount; + return this; + } + + public Builder quantity(int quantity) { + this.quantity = quantity; + return this; + } + + public Builder processingStatus(String processingStatus) { + this.processingStatus = processingStatus; + return this; + } + + public Builder fundTransferStatus(String fundTransferStatus) { + this.fundTransferStatus = fundTransferStatus; + return this; + } + + public Builder settlementId(String settlementId) { + this.settlementId = settlementId; + return this; + } + + public Builder postedAt(PlatformTime postedAt) { + this.postedAt = postedAt; + return this; + } + + public Builder marketplaceName(String marketplaceName) { + this.marketplaceName = marketplaceName; + return this; + } + + public SettlementTransaction build() { + return new SettlementTransaction(this); + } + } +} diff --git a/core/src/main/java/common/ecommerce/sdk/ChannelSdk.java b/core/src/main/java/common/ecommerce/sdk/ChannelSdk.java index 90506b1..83ace37 100644 --- a/core/src/main/java/common/ecommerce/sdk/ChannelSdk.java +++ b/core/src/main/java/common/ecommerce/sdk/ChannelSdk.java @@ -9,6 +9,7 @@ import common.ecommerce.capability.CapabilityReport; import common.ecommerce.capability.PlatformAdapter; import common.ecommerce.capability.Products; import common.ecommerce.capability.SalesOrders; +import common.ecommerce.capability.Settlements; import common.ecommerce.idempotency.IdempotencyGuard; import common.ecommerce.model.account.AccountKey; import common.ecommerce.model.account.ChannelAccount; @@ -79,6 +80,12 @@ public final class ChannelSdk implements ProviderResolver { return new Products(resolve(key), account, newContext(account, connection)); } + /** 结算 / 账单交易明细视图。 */ + public Settlements settlements(AccountKey key, ChannelConnection connection) { + ChannelAccount account = requireAccount(key); + return new Settlements(resolve(key), account, newContext(account, connection)); + } + /** * 聚合器的子店铺列表(如领星下已授权的亚马逊 / 沃尔玛店铺)。 * diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/LingxingApi.java b/lingxing/src/main/java/common/ecommerce/lingxing/LingxingApi.java index fe70aca..e4e4e82 100644 --- a/lingxing/src/main/java/common/ecommerce/lingxing/LingxingApi.java +++ b/lingxing/src/main/java/common/ecommerce/lingxing/LingxingApi.java @@ -26,6 +26,29 @@ public enum LingxingApi { /** 亚马逊 SC Listing 列表。POST,offset/length 分页,上限 1000。 */ LISTING_AMAZON_SC("/erp/sc/data/mws/listing", 1), + /** + * 亚马逊 SC 订单列表。POST,offset/length 分页,length 上限 5000; + * 查询时间窗不超过 1 年。 + */ + ORDER_LIST_AMAZON_SC("/erp/sc/data/mws/orders", 1), + + /** 亚马逊 SC 订单详情。POST,{@code order_id} 支持逗号分隔多个(上限 200)。 */ + ORDER_DETAIL_AMAZON_SC("/erp/sc/data/mws/orderDetail", 1), + + /** + * 亚马逊自发货(FBM)订单列表。POST,{@code page} 从 1 开始,{@code length} 默认 100。 + * + *与 {@link #ORDER_LIST_AMAZON_SC} 不同:主键是领星系统单号 {@code order_number}, + * 不是平台订单号。
+ */ + ORDER_LIST_FBM_AMAZON_SC("/erp/sc/routing/order/Order/getOrderList", 1), + + /** 亚马逊自发货(FBM)订单详情。POST,入参是领星系统单号 {@code order_number}。 */ + ORDER_DETAIL_FBM_AMAZON_SC("/erp/sc/routing/order/Order/getOrderDetail", 1), + + /** 亚马逊结算中心交易明细。POST,offset/length 分页,上限 10000。 */ + SETTLEMENT_TRANSACTION_LIST("/bd/sp/api/open/settlement/transaction/detail/list", 10), + /** 多平台订单列表;当前实现使用的跨平台接口。 */ ORDER_LIST("/pb/mp/order/v2/list", 10); diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/LingxingConstants.java b/lingxing/src/main/java/common/ecommerce/lingxing/LingxingConstants.java index 2445161..3b7a3a7 100644 --- a/lingxing/src/main/java/common/ecommerce/lingxing/LingxingConstants.java +++ b/lingxing/src/main/java/common/ecommerce/lingxing/LingxingConstants.java @@ -19,12 +19,35 @@ public final class LingxingConstants { public static final String ADAPTER_ID = "lingxing"; - // 接口路径与限流值统一放在 LingxingApi 枚举里,这里不再重复。 + /** 获取令牌。 */ + public static final String PATH_ACCESS_TOKEN = "/api/auth-server/oauth/access-token"; + /** 多平台订单列表(各平台自发货)。 */ + public static final String PATH_ORDER_LIST = "/pb/mp/order/v2/list"; + /** 店铺列表。 */ + public static final String PATH_SELLER_LIST = "/pb/mp/shop/v2/getSellerList"; - /** 订单查询时间跨度上限:31 天(领星统一订单接口的限制)。 */ + /** 亚马逊 SC 的领星 platform_code。 */ + public static final int PLATFORM_CODE_AMAZON = 10001; + + /** 多平台订单列表令牌桶:10 req/s(亚马逊/VC/Walmart 接口是 1 req/s)。 */ + public static final int ORDER_LIST_PER_SECOND = 10; + + /** 订单查询时间跨度上限:31 天。 */ public static final int MAX_QUERY_DAYS = 31; - /** 分页 length 上限(领星统一订单接口的限制)。 */ + /** 亚马逊订单查询时间跨度上限:1 年。 */ + public static final int AMAZON_MAX_QUERY_DAYS = 365; + + /** 多平台分页 length 上限(领星统一订单接口的限制)。 */ public static final int MAX_PAGE_SIZE = 500; + /** 亚马逊订单分页 length 上限。 */ + public static final int AMAZON_MAX_PAGE_SIZE = 5000; + /** 亚马逊 FBM 订单分页 length:文档默认 100,未给上限,按默认值取。 */ + public static final int FBM_MAX_PAGE_SIZE = 100; + + /** 结算交易明细分页 length 上限。 */ + public static final int SETTLEMENT_MAX_PAGE_SIZE = 10000; + /** 结算时间查询跨度上限:7 天(双闭区间)。 */ + public static final int SETTLEMENT_MAX_QUERY_DAYS = 7; private LingxingConstants() { } diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/adapter/LingxingAdapter.java b/lingxing/src/main/java/common/ecommerce/lingxing/adapter/LingxingAdapter.java index c17329e..88b0149 100644 --- a/lingxing/src/main/java/common/ecommerce/lingxing/adapter/LingxingAdapter.java +++ b/lingxing/src/main/java/common/ecommerce/lingxing/adapter/LingxingAdapter.java @@ -1,26 +1,25 @@ package common.ecommerce.lingxing.adapter; -import common.ecommerce.lingxing.LingxingConstants; -import common.ecommerce.lingxing.mapper.LingxingOrderMapper; -import common.ecommerce.lingxing.http.LingxingRateLimiter; -import common.ecommerce.lingxing.http.LingxingRequestFactory; -import common.ecommerce.lingxing.auth.LingxingTokenClient; -import common.ecommerce.lingxing.platform.LingxingCall; -import common.ecommerce.lingxing.platform.LingxingSubPlatform; -import common.ecommerce.lingxing.platform.LingxingSubPlatforms; import common.ecommerce.capability.AggregatorCapable; import common.ecommerce.capability.ProductCapable; import common.ecommerce.capability.SalesOrderCapable; +import common.ecommerce.capability.SettlementCapable; import common.ecommerce.error.AuthException; import common.ecommerce.error.ChannelException; import common.ecommerce.http.HttpTransport; import common.ecommerce.http.JacksonJsonCodec; import common.ecommerce.http.TokenManager; +import common.ecommerce.lingxing.LingxingConstants; +import common.ecommerce.lingxing.auth.LingxingTokenClient; +import common.ecommerce.lingxing.http.LingxingRateLimiter; +import common.ecommerce.lingxing.http.LingxingRequestFactory; +import common.ecommerce.lingxing.platform.LingxingCall; +import common.ecommerce.lingxing.platform.LingxingSubPlatform; +import common.ecommerce.lingxing.platform.LingxingSubPlatforms; import common.ecommerce.model.Capability; -import common.ecommerce.model.account.ChannelAccount; import common.ecommerce.model.ChannelProvider; -import common.ecommerce.model.support.Page; import common.ecommerce.model.Platform; +import common.ecommerce.model.account.ChannelAccount; import common.ecommerce.model.order.SalesOrder; import common.ecommerce.model.order.SalesOrderQuery; import common.ecommerce.model.order.SalesOrderRef; @@ -28,6 +27,9 @@ import common.ecommerce.model.product.ProductListing; import common.ecommerce.model.product.ProductQuery; import common.ecommerce.model.product.ProductRef; import common.ecommerce.model.product.ProductSyncStrategy; +import common.ecommerce.model.settlement.SettlementQuery; +import common.ecommerce.model.settlement.SettlementTransaction; +import common.ecommerce.model.support.Page; import common.ecommerce.sdk.ChannelContext; import common.ecommerce.spi.AccessToken; import common.ecommerce.spi.ChannelSecret; @@ -35,8 +37,6 @@ import common.ecommerce.spi.LockProvider; import common.ecommerce.spi.TokenStore; import java.time.Clock; -import java.time.Duration; -import java.time.ZoneId; import java.util.EnumSet; import java.util.List; import java.util.Set; @@ -45,14 +45,17 @@ import java.util.Set; * 领星聚合适配器。 * *一个适配器服务多个子平台,子平台由 {@code ChannelAccount.platformCode} 决定, - * 能力按子平台细化({@link #supports})。首期只实现订单列表拉取。
+ * 能力按子平台细化({@link #supports})。 + * + *适配器只做三件事:取 token、把公共设施装进 {@link LingxingCall}、按子平台分派。 + * 具体的「拼请求体 + 解析响应」由各子平台的 Source 实现,见 + * {@link LingxingSubPlatform}。
*/ -public final class LingxingAdapter implements SalesOrderCapable, ProductCapable, AggregatorCapable { +public final class LingxingAdapter implements SalesOrderCapable, ProductCapable, SettlementCapable, + AggregatorCapable { private final HttpTransport transport; private final JacksonJsonCodec json; - private final Clock clock; - private final LingxingOrderMapper mapper; private final TokenManager tokenManager; private final LingxingRateLimiter rateLimiter; private final LingxingRequestFactory requestFactory; @@ -64,8 +67,6 @@ public final class LingxingAdapter implements SalesOrderCapable, ProductCapable, TokenStore tokenStore, LockProvider lockProvider, Clock clock) { this.transport = transport; this.json = json; - this.clock = clock; - this.mapper = new LingxingOrderMapper(json); final LingxingTokenClient tokenClient = new LingxingTokenClient(transport, json, clock); // 领星 access_token 约 2h,提前 10 分钟续期。 // @@ -109,14 +110,14 @@ public final class LingxingAdapter implements SalesOrderCapable, ProductCapable, @Override public EnumSeteBay / SHEIN / Mirakl / 自定义平台在领星侧只有订单,未见账单与售后接口, - * 因此只声明 SALES_ORDER,缺口由能力报告显式暴露,不假装支持。
+ *能力以子平台实际装配的 Source 为准:没有 orderSource 就不声明订单, + * 缺口由能力报告显式暴露,不假装支持。
*/ @Override public boolean supports(ChannelAccount account, Capability capability) { @@ -124,7 +125,7 @@ public final class LingxingAdapter implements SalesOrderCapable, ProductCapable, return false; } Platform p = LingxingConstants.toPlatform(account.platformCode()); - if (!LingxingSubPlatforms.isRegistered(p)) { + if (p == null || !LingxingSubPlatforms.isRegistered(p)) { return false; } LingxingSubPlatform impl = LingxingSubPlatforms.of(p); @@ -134,6 +135,9 @@ public final class LingxingAdapter implements SalesOrderCapable, ProductCapable, if (capability == Capability.PRODUCT) { return impl.productSource() != null; } + if (capability == Capability.BILLING) { + return impl.settlementSource() != null; + } return false; } @@ -142,9 +146,6 @@ public final class LingxingAdapter implements SalesOrderCapable, ProductCapable, */ @Override public List与 {@link #pull(ChannelContext, SalesOrderQuery)} 不是同一条路由: + * 这套接口的主键是领星系统单号 {@code order_number},用于「订单管理」视角; + * 跨渠道同步仍用标准订单路由。
+ */ + public Page领星部分接口(如亚马逊店铺列表)是 GET 且无业务参数, * 此时 query 里只有 {@code app_key} / {@code timestamp} / {@code sign}。
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/mapper/LingxingOrderMapper.java b/lingxing/src/main/java/common/ecommerce/lingxing/mapper/LingxingOrderMapper.java index 6224f84..7499fdf 100644 --- a/lingxing/src/main/java/common/ecommerce/lingxing/mapper/LingxingOrderMapper.java +++ b/lingxing/src/main/java/common/ecommerce/lingxing/mapper/LingxingOrderMapper.java @@ -131,8 +131,10 @@ public final class LingxingOrderMapper { /** * 领星金额可能带币种符号或千分位({@code "¥49.16"}、{@code "-¥0.98"}、{@code "1,234.56"}), * 只保留数字、小数点与符号位;没有数字时视为缺失。 + * + *亚马逊订单与多平台订单共用这套清洗规则,故对外暴露。
*/ - static String cleanAmount(String raw) { + public static String cleanAmount(String raw) { if (raw == null) { return null; } diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingSubPlatform.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingSubPlatform.java index e6fb1dc..43035a2 100644 --- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingSubPlatform.java +++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingSubPlatform.java @@ -1,42 +1,50 @@ package common.ecommerce.lingxing.platform; -import common.ecommerce.capability.AggregatorCapable.SubChannel; -import common.ecommerce.model.order.SalesOrder; -import common.ecommerce.model.order.SalesOrderQuery; -import common.ecommerce.model.product.ProductListing; -import common.ecommerce.model.product.ProductQuery; -import common.ecommerce.model.support.Page; - -import java.util.List; +import common.ecommerce.lingxing.platform.order.LingxingOrderSource; +import common.ecommerce.lingxing.platform.product.LingxingProductSource; +import common.ecommerce.lingxing.platform.settlement.LingxingSettlementSource; +import common.ecommerce.lingxing.platform.shop.LingxingShopSource; /** * 领星子平台的能力分派入口:只做组合,不写业务逻辑。 * - *各能力由独立的 Source 实现({@link common.ecommerce.lingxing.platform.order.LingxingOrderSource}、 - * {@link common.ecommerce.lingxing.platform.product.LingxingProductSource}、 - * {@link common.ecommerce.lingxing.platform.shop.LingxingShopSource})提供, - * 子平台不支持的 Source 传 {@code null} 即可,调用时统一抛 - * {@code UnsupportedCapabilityException}。
- * - *这样单个平台类不会随能力增长而膨胀,能力之间也互不干扰。
+ *各能力由独立的 Source 实现({@link LingxingOrderSource}、 + * {@link LingxingProductSource}、{@link LingxingShopSource}、 + * {@link LingxingSettlementSource})提供,子平台不支持的 Source 传 {@code null} 即可, + * 调用时统一抛 {@code UnsupportedCapabilityException}。
*/ public interface LingxingSubPlatform { /** 对应的业务平台,用于注册表与日志。 */ common.ecommerce.model.Platform platform(); - /** 订单能力;不支持时为 null。 */ - default common.ecommerce.lingxing.platform.order.LingxingOrderSource orderSource() { + /** 订单能力(领星标准订单接口);不支持时为 null。 */ + default LingxingOrderSource orderSource() { + return null; + } + + /** + * 亚马逊 FBM(自发货)路由订单能力;不支持时为 null。 + * + *这套接口的主键是领星系统单号 {@code order_number},与 + * {@link #orderSource()} 的平台订单号不同,因此单独成一路,不混用。
+ */ + default LingxingOrderSource fbmOrderSource() { return null; } /** 商品能力;不支持时为 null。 */ - default common.ecommerce.lingxing.platform.product.LingxingProductSource productSource() { + default LingxingProductSource productSource() { return null; } /** 店铺能力;不支持时为 null。 */ - default common.ecommerce.lingxing.platform.shop.LingxingShopSource shopSource() { + default LingxingShopSource shopSource() { + return null; + } + + /** 结算 / 账单能力;不支持时为 null。 */ + default LingxingSettlementSource settlementSource() { return null; } } diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/AmazonScSubPlatform.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/AmazonScSubPlatform.java index b0ac6ca..792fe10 100644 --- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/AmazonScSubPlatform.java +++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/AmazonScSubPlatform.java @@ -3,8 +3,12 @@ package common.ecommerce.lingxing.platform.amazon; import common.ecommerce.http.HttpTransport; import common.ecommerce.http.JacksonJsonCodec; import common.ecommerce.lingxing.platform.LingxingSubPlatform; +import common.ecommerce.lingxing.platform.amazon.order.AmazonFbmOrderSource; +import common.ecommerce.lingxing.platform.amazon.order.AmazonOrderSource; +import common.ecommerce.lingxing.platform.amazon.settlement.AmazonSettlementSource; import common.ecommerce.lingxing.platform.order.LingxingOrderSource; import common.ecommerce.lingxing.platform.product.LingxingProductSource; +import common.ecommerce.lingxing.platform.settlement.LingxingSettlementSource; import common.ecommerce.lingxing.platform.shop.LingxingShopSource; import common.ecommerce.model.Platform; @@ -13,12 +17,18 @@ import common.ecommerce.model.Platform; */ public final class AmazonScSubPlatform implements LingxingSubPlatform { + private final LingxingOrderSource orders; + private final LingxingOrderSource fbmOrders; private final LingxingProductSource products; private final LingxingShopSource shops; + private final LingxingSettlementSource settlements; public AmazonScSubPlatform(HttpTransport transport, JacksonJsonCodec json) { + this.orders = new AmazonOrderSource(); + this.fbmOrders = new AmazonFbmOrderSource(); this.products = new AmazonProductSource(); this.shops = new AmazonShopSource(); + this.settlements = new AmazonSettlementSource(); } @Override @@ -27,6 +37,16 @@ public final class AmazonScSubPlatform implements LingxingSubPlatform { } @Override + public LingxingOrderSource orderSource() { + return orders; + } + + @Override + public LingxingOrderSource fbmOrderSource() { + return fbmOrders; + } + + @Override public LingxingProductSource productSource() { return products; } @@ -36,9 +56,8 @@ public final class AmazonScSubPlatform implements LingxingSubPlatform { return shops; } - /** 亚马逊 SC 的订单接口暂未核对,接入前不声明订单能力。 */ @Override - public LingxingOrderSource orderSource() { - return null; + public LingxingSettlementSource settlementSource() { + return settlements; } } diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/AmazonShopSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/AmazonShopSource.java index e919a26..2ab9dda 100644 --- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/AmazonShopSource.java +++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/AmazonShopSource.java @@ -4,6 +4,7 @@ import common.ecommerce.capability.AggregatorCapable.SubChannel; import common.ecommerce.http.HttpRequest; import common.ecommerce.http.HttpResponse; import common.ecommerce.lingxing.LingxingApi; +import common.ecommerce.lingxing.LingxingConstants; import common.ecommerce.lingxing.http.LingxingEnvelope; import common.ecommerce.lingxing.platform.LingxingCall; import common.ecommerce.lingxing.platform.amazon.dto.AmazonShopDto; @@ -22,9 +23,6 @@ import java.util.List; */ public final class AmazonShopSource implements LingxingShopSource { - /** 领星侧 Amazon SC 的 platform_code。 */ - private static final int AMAZON_SC_PLATFORM_CODE = 10001; - /** 店铺状态:1 = 正常同步。 */ private static final int STATUS_ACTIVE = 1; @@ -42,7 +40,7 @@ public final class AmazonShopSource implements LingxingShopSource { } // platformCode 取领星侧 Amazon SC 的平台码 10001;externalStoreId 用领星店铺 id(sid) out.add(new SubChannel( - AMAZON_SC_PLATFORM_CODE, + LingxingConstants.PLATFORM_CODE_AMAZON, String.valueOf(shop.getSid()), Platform.AMAZON_SC, shop.getName() == null ? shop.getSellerId() : shop.getName())); diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/dto/AmazonOrderDetailDto.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/dto/AmazonOrderDetailDto.java new file mode 100644 index 0000000..184d53b --- /dev/null +++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/dto/AmazonOrderDetailDto.java @@ -0,0 +1,77 @@ +package common.ecommerce.lingxing.platform.amazon.dto; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonProperty; +import lombok.Getter; +import lombok.Setter; + +import java.util.ArrayList; +import java.util.List; + +/** + * 领星 · 亚马逊 SC 订单详情({@code /erp/sc/data/mws/orderDetail} 的 {@code data[]})。 + * + *与列表的差异:
+ *金额字段文档写 string,真实响应里 {@code unit_price_amount} / + * {@code item_discount} 是 number,用 String 接收两种都能读, + * 由 Source 统一清洗。
+ */ +@Getter +@Setter +@JsonIgnoreProperties(ignoreUnknown = true) +public class AmazonOrderDetailItemDto { + + /** 订单商品自增 id。 */ + @JsonProperty("id") + private Long id; + + /** 订单商品编码;亚马逊可能变更,不能当稳定主键。 */ + @JsonProperty("order_item_id") + private String orderItemId; + + @JsonProperty("title") + private String title; + + /** 平台 MSKU。 */ + @JsonProperty("seller_sku") + private String sellerSku; + + @JsonProperty("asin") + private String asin; + + /** 本地 SKU。 */ + @JsonProperty("sku") + private String sku; + + @JsonProperty("product_name") + private String productName; + + /** 下单量。 */ + @JsonProperty("quantity_ordered") + private Integer quantityOrdered; + + /** 已配送量。 */ + @JsonProperty("quantity_shipped") + private Integer quantityShipped; + + /** 商品支付金额(含税)。 */ + @JsonProperty("item_price_amount") + private String itemPriceAmount; + + /** 商品税。 */ + @JsonProperty("item_tax_amount") + private String itemTaxAmount; + + /** 单价。 */ + @JsonProperty("unit_price_amount") + private String unitPriceAmount; + + /** 商品促销折扣。 */ + @JsonProperty("promotion_discount_amount") + private String promotionDiscountAmount; + + /** 商品折扣。 */ + @JsonProperty("item_discount") + private String itemDiscount; +} diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/dto/AmazonOrderDto.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/dto/AmazonOrderDto.java new file mode 100644 index 0000000..47b0d8b --- /dev/null +++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/dto/AmazonOrderDto.java @@ -0,0 +1,100 @@ +package common.ecommerce.lingxing.platform.amazon.dto; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonProperty; +import lombok.Getter; +import lombok.Setter; + +import java.util.ArrayList; +import java.util.List; + +/** + * 领星 · 亚马逊 SC 订单列表条目({@code /erp/sc/data/mws/orders} 的 {@code data[]})。 + * + *与多平台订单的差异:
+ *列表接口不返回单价/税额/折扣,这些字段只在订单详情里。
+ */ +@Getter +@Setter +@JsonIgnoreProperties(ignoreUnknown = true) +public class AmazonOrderDto { + + /** 领星店铺 id。 */ + @JsonProperty("sid") + private Long sid; + + /** 店铺名称。 */ + @JsonProperty("seller_name") + private String sellerName; + + /** 亚马逊订单号,即 channelOrderId。 */ + @JsonProperty("amazon_order_id") + private String amazonOrderId; + + /** 订单状态:Pending / Unshipped / PartiallyShipped / Shipped / Canceled 等。 */ + @JsonProperty("order_status") + private String orderStatus; + + /** 订单金额;文档类型是 number。 */ + @JsonProperty("order_total_amount") + private String orderTotalAmount; + + /** 订单金额币种;金额为 0 时该字段可能为空。 */ + @JsonProperty("order_total_currency_code") + private String orderTotalCurrencyCode; + + /** 配送方式:AFN(亚马逊)/ MFN(自发货)。 */ + @JsonProperty("fulfillment_channel") + private String fulfillmentChannel; + + /** 邮编。 */ + @JsonProperty("postal_code") + private String postalCode; + + /** 销售渠道,如 Amazon.com。 */ + @JsonProperty("sales_channel") + private String salesChannel; + + /** 订购时间,亚马逊原始格式,如 {@code 2020-11-07T03:25:38Z}。 */ + @JsonProperty("purchase_date") + private String purchaseDate; + + /** 订购时间(UTC),{@code yyyy-MM-dd HH:mm:ss}。 */ + @JsonProperty("purchase_date_utc") + private String purchaseDateUtc; + + /** 订购时间(站点时间),{@code yyyy-MM-dd HH:mm:ss}。 */ + @JsonProperty("purchase_date_local") + private String purchaseDateLocal; + + /** 订单更新时间(站点时间)。 */ + @JsonProperty("last_update_date") + private String lastUpdateDate; + + /** 订单更新时间(UTC)。 */ + @JsonProperty("last_update_date_utc") + private String lastUpdateDateUtc; + + /** 订单修改时间(北京时间)。 */ + @JsonProperty("gmt_modified") + private String gmtModified; + + /** 订单修改时间(UTC)。 */ + @JsonProperty("gmt_modified_utc") + private String gmtModifiedUtc; + + /** 退款金额;文档类型是 number。 */ + @JsonProperty("refund_amount") + private String refundAmount; + + /** 商品明细。 */ + @JsonProperty("item_list") + private List只有 SKU / ASIN / 数量,金额字段在订单详情接口里。文档写 + * {@code quantity_ordered} 是 string,但真实响应可能是 number, + * 用 String 接收两种都能读。
+ */ +@Getter +@Setter +@JsonIgnoreProperties(ignoreUnknown = true) +public class AmazonOrderItemDto { + + @JsonProperty("asin") + private String asin; + + /** 数量;文档类型是 string,真实响应可能是 number。 */ + @JsonProperty("quantity_ordered") + private String quantityOrdered; + + /** 平台 MSKU。 */ + @JsonProperty("seller_sku") + private String sellerSku; + + /** 领星本地 SKU。 */ + @JsonProperty("local_sku") + private String localSku; + + /** 本地品名。 */ + @JsonProperty("local_name") + private String localName; +} diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/dto/AmazonSettlementTransactionDto.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/dto/AmazonSettlementTransactionDto.java new file mode 100644 index 0000000..57f66a0 --- /dev/null +++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/dto/AmazonSettlementTransactionDto.java @@ -0,0 +1,134 @@ +package common.ecommerce.lingxing.platform.amazon.dto; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonProperty; +import lombok.Getter; +import lombok.Setter; + +/** + * 领星 · 亚马逊结算中心交易明细({@code data.records[]})。 + * + *一行是一笔费用(佣金、配送费、退款、广告费……),不是订单合计。 + * 金额为负数表示扣款。
+ * + *这里只保留对账需要的主干字段,其余字段(税费模型、促销 ID 等) + * 在需要时再补,避免 DTO 跟着文档无限膨胀。
+ */ +@Getter +@Setter +@JsonIgnoreProperties(ignoreUnknown = true) +public class AmazonSettlementTransactionDto { + + /** 交易明细唯一标识;未结算时可能为空。 */ + @JsonProperty("uniqueKey") + private String uniqueKey; + + /** 主键编号,非唯一键。 */ + @JsonProperty("id") + private String id; + + /** 记录 MD5,兜底标识。 */ + @JsonProperty("md5") + private String md5; + + /** 亚马逊订单号。 */ + @JsonProperty("amazonOrderId") + private String amazonOrderId; + + /** 领星店铺 id。 */ + @JsonProperty("sid") + private Long sid; + + @JsonProperty("storeName") + private String storeName; + + /** 亚马逊店铺 id。 */ + @JsonProperty("sellerId") + private String sellerId; + + /** 国家。 */ + @JsonProperty("countryCode") + private String countryCode; + + /** 报告类型,如 Standard。 */ + @JsonProperty("accountType") + private String accountType; + + /** 配送方式,如 FBA / FBM。 */ + @JsonProperty("fulfillment") + private String fulfillment; + + /** 来源事件,如 Shipment / Refund / ServiceFee。 */ + @JsonProperty("eventType") + private String eventType; + + /** 平台 MSKU。 */ + @JsonProperty("sellerSku") + private String sellerSku; + + /** 交易类型,如 Commission / Tax / Refund。 */ + @JsonProperty("type") + private String type; + + /** 结算时间(站点时间,带偏移),如 {@code 2022-09-10T23:55:12+01:00}。 */ + @JsonProperty("postedDateLocale") + private String postedDateLocale; + + /** 结算日期,0 时区,如 {@code 2024-06-06T08:29:00Z}。 */ + @JsonProperty("postedDate") + private String postedDate; + + /** 币种。 */ + @JsonProperty("currencyCode") + private String currencyCode; + + /** 金额;文档类型是 number,用 String 兼容。 */ + @JsonProperty("currencyAmount") + private String currencyAmount; + + @JsonProperty("quantity") + private Integer quantity; + + /** 结算状态:Open 未结算 / Closed 已结算 / Reconciled 已对账。 */ + @JsonProperty("processingStatus") + private String processingStatus; + + /** 转账状态:Succeeded / Processing / Failed / Unknown。 */ + @JsonProperty("fundTransferStatus") + private String fundTransferStatus; + + /** 结算编号。 */ + @JsonProperty("fid") + private String fid; + + @JsonProperty("settlementId") + private String settlementId; + + /** 领星本地 SKU。 */ + @JsonProperty("localSku") + private String localSku; + + /** 领星本地品名。 */ + @JsonProperty("localName") + private String localName; + + /** 修改时间(领星系统时间)。 */ + @JsonProperty("gmtModified") + private String gmtModified; + + /** 商家订单 ID。 */ + @JsonProperty("merchantOrderId") + private String merchantOrderId; + + @JsonProperty("marketplaceName") + private String marketplaceName; + + @JsonProperty("asin") + private String asin; + + @JsonProperty("fnsku") + private String fnsku; + + @JsonProperty("orderItemId") + private String orderItemId; +} diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/dto/FbmOrderDetailDto.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/dto/FbmOrderDetailDto.java new file mode 100644 index 0000000..f0296fa --- /dev/null +++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/dto/FbmOrderDetailDto.java @@ -0,0 +1,111 @@ +package common.ecommerce.lingxing.platform.amazon.dto; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonProperty; +import lombok.Getter; +import lombok.Setter; + +import java.util.ArrayList; +import java.util.List; + +/** + * 领星 · 亚马逊 FBM 订单详情 + * ({@code /erp/sc/routing/order/Order/getOrderDetail} 的 {@code data})。 + * + *注意 {@code data} 是对象,不是数组。
+ */ +@Getter +@Setter +@JsonIgnoreProperties(ignoreUnknown = true) +public class FbmOrderDetailDto { + + /** 领星系统单号。 */ + @JsonProperty("order_number") + private String orderNumber; + + /** 订单状态(中文原值)。 */ + @JsonProperty("order_status") + private String orderStatus; + + @JsonProperty("order_from_name") + private String orderFromName; + + /** 订购时间。 */ + @JsonProperty("purchase_time") + private String purchaseTime; + + /** 平台,如 AMAZON。 */ + @JsonProperty("platform") + private String platform; + + @JsonProperty("shop_name") + private String shopName; + + @JsonProperty("buyer_choose_express") + private String buyerChooseExpress; + + /** 客付运费。 */ + @JsonProperty("total_shipping_price") + private String totalShippingPrice; + + @JsonProperty("buyer_message") + private String buyerMessage; + + @JsonProperty("customer_comment") + private String customerComment; + + @JsonProperty("warehouse_name") + private String warehouseName; + + @JsonProperty("wid") + private Long wid; + + @JsonProperty("tracking_number") + private String trackingNumber; + + @JsonProperty("logistics_type_name") + private String logisticsTypeName; + + @JsonProperty("logistics_provider_name") + private String logisticsProviderName; + + @JsonProperty("logistics_type_id") + private Long logisticsTypeId; + + @JsonProperty("logistics_provider_id") + private Long logisticsProviderId; + + @JsonProperty("logistics_pre_weight") + private String logisticsPreWeight; + + @JsonProperty("logistics_pre_weight_unit") + private String logisticsPreWeightUnit; + + @JsonProperty("logistics_pre_price") + private String logisticsPrePrice; + + /** 物流运费。 */ + @JsonProperty("logistics_freight") + private String logisticsFreight; + + @JsonProperty("logistics_freight_currency_code") + private String logisticsFreightCurrencyCode; + + @JsonProperty("pkg_real_weight") + private String pkgRealWeight; + + @JsonProperty("pkg_real_weight_unit") + private String pkgRealWeightUnit; + + /** 订单总金额;文档没给币种,按商品行币种解释。 */ + @JsonProperty("order_price_amount") + private String orderPriceAmount; + + /** 订单毛利润。 */ + @JsonProperty("gross_profit_amount") + private String grossProfitAmount; + + /** 订单商品行。 */ + @JsonProperty("order_item") + private List这是领星 ERP「销售 > 订单管理」的自发货订单视图,主键是系统单号 + * {@code order_number},不是亚马逊订单号;平台单号在 {@code platform_list} 里, + * 当前不解析(避免数组元素类型不一致导致整页解析失败)。
+ */ +@Getter +@Setter +@JsonIgnoreProperties(ignoreUnknown = true) +public class FbmOrderDto { + + /** 领星系统单号,详情接口的入参。 */ + @JsonProperty("order_number") + private String orderNumber; + + /** 订单状态(中文原值,如 待发货 / 已发货 / 已取消)。 */ + @JsonProperty("status") + private String status; + + /** 订单类型,如 线上订单 / 手工订单。 */ + @JsonProperty("order_from") + private String orderFrom; + + /** 目的国代码。 */ + @JsonProperty("country_code") + private String countryCode; + + /** 订购时间。 */ + @JsonProperty("purchase_time") + private String purchaseTime; + + /** 付款时间。 */ + @JsonProperty("payment_time") + private String paymentTime; + + @JsonProperty("logistics_type_id") + private String logisticsTypeId; + + @JsonProperty("logistics_provider_id") + private String logisticsProviderId; + + @JsonProperty("logistics_type_name") + private String logisticsTypeName; + + @JsonProperty("logistics_provider_name") + private String logisticsProviderName; + + /** 发货仓库 id。 */ + @JsonProperty("wid") + private Long wid; + + @JsonProperty("warehouse_name") + private String warehouseName; + + @JsonProperty("customer_comment") + private String customerComment; +} diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/dto/FbmOrderItemDto.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/dto/FbmOrderItemDto.java new file mode 100644 index 0000000..7c12c2a --- /dev/null +++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/dto/FbmOrderItemDto.java @@ -0,0 +1,55 @@ +package common.ecommerce.lingxing.platform.amazon.dto; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonProperty; +import lombok.Getter; +import lombok.Setter; + +/** + * 领星 · 亚马逊 FBM 订单详情的商品行({@code data.order_item[]})。 + * + *字段名 {@code MSKU} 是全大写,Jackson 按注解原样匹配;数量字段文档写作 + * {@code quality}(不是 quantity),照文档保留。
+ */ +@Getter +@Setter +@JsonIgnoreProperties(ignoreUnknown = true) +public class FbmOrderItemDto { + + /** 平台订单号。 */ + @JsonProperty("platform_order_id") + private String platformOrderId; + + /** 平台 MSKU。 */ + @JsonProperty("MSKU") + private String msku; + + /** 订单明细单号。 */ + @JsonProperty("order_item_no") + private String orderItemNo; + + @JsonProperty("pic_url") + private String picUrl; + + /** 领星本地 SKU。 */ + @JsonProperty("sku") + private String sku; + + @JsonProperty("product_name") + private String productName; + + /** 数量;文档字段名是 {@code quality}。 */ + @JsonProperty("quality") + private Integer quality; + + /** 单价。 */ + @JsonProperty("item_unit_price") + private String itemUnitPrice; + + /** 单价币种。 */ + @JsonProperty("currency_code") + private String currencyCode; + + @JsonProperty("customization") + private String customization; +} diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/order/AmazonFbmOrderSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/order/AmazonFbmOrderSource.java new file mode 100644 index 0000000..ba27ca7 --- /dev/null +++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/order/AmazonFbmOrderSource.java @@ -0,0 +1,298 @@ +package common.ecommerce.lingxing.platform.amazon.order; + +import com.fasterxml.jackson.databind.JsonNode; + +import common.ecommerce.error.ChannelException; +import common.ecommerce.error.ValidationException; +import common.ecommerce.http.HttpRequest; +import common.ecommerce.http.HttpResponse; +import common.ecommerce.lingxing.LingxingApi; +import common.ecommerce.lingxing.LingxingConstants; +import common.ecommerce.lingxing.http.LingxingEnvelope; +import common.ecommerce.lingxing.mapper.LingxingOrderMapper; +import common.ecommerce.lingxing.platform.LingxingCall; +import common.ecommerce.lingxing.platform.amazon.dto.FbmOrderDetailDto; +import common.ecommerce.lingxing.platform.amazon.dto.FbmOrderDto; +import common.ecommerce.lingxing.platform.amazon.dto.FbmOrderItemDto; +import common.ecommerce.lingxing.platform.order.LingxingOrderSource; +import common.ecommerce.model.ChannelProvider; +import common.ecommerce.model.account.ChannelAccount; +import common.ecommerce.model.order.OrderLine; +import common.ecommerce.model.order.SalesOrder; +import common.ecommerce.model.order.SalesOrderQuery; +import common.ecommerce.model.support.Money; +import common.ecommerce.model.support.Page; +import common.ecommerce.model.support.PlatformTime; + +import java.time.Instant; +import java.time.LocalDateTime; +import java.time.ZoneId; +import java.time.format.DateTimeFormatter; +import java.time.format.DateTimeParseException; +import java.util.ArrayList; +import java.util.Collections; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; + +/** + * 领星 · 亚马逊 FBM(自发货)路由订单。 + * + *对应领星 ERP「销售 > 订单管理」,与 {@link AmazonOrderSource} + * ({@code /erp/sc/data/mws/orders})是两个不同视角:
+ *两者不要混用同一个 canonicalKey 存储:需要跨渠道去重时用 + * {@link AmazonOrderSource},需要按领星系统单号查 FBM 作业数据时用本类。
+ * + *时区待核对:文档没有标注 {@code purchase_time} 的时区, + * 这里按领星 ERP 系统时间(北京时间)解析。首次真实联调时应打印报文确认。
+ */ +public final class AmazonFbmOrderSource implements LingxingOrderSource { + + /** 接口时间格式。 */ + private static final DateTimeFormatter DATE_TIME = + DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"); + + /** 文档未注明时区,按 ERP 系统时间(北京时间)解释,待真实报文核对。 */ + private static final ZoneId SYSTEM_ZONE = PlatformTime.BEIJING_ZONE; + + private static final String OP_PULL = "salesOrders.pull.fbm"; + private static final String OP_GET = "salesOrders.get.fbm"; + + @Override + public Page列表 {@link LingxingApi#ORDER_LIST_AMAZON_SC}:POST,{@code offset}/{@code length} + * 分页(上限 5000),查询窗口不超过 1 年,{@code total} 在顶层。
+ * + *详情 {@link LingxingApi#ORDER_DETAIL_AMAZON_SC}:只有详情返回单价/税额/折扣, + * 列表接口没有这些字段。
+ * + *与多平台订单的区别:状态是字符串枚举、时间是字符串、{@code data} 直接是数组。 + * 因此不复用 {@link LingxingOrderMapper},只复用它的金额清洗规则。
+ */ +public final class AmazonOrderSource implements LingxingOrderSource { + + /** 亚马逊接口时间参数格式:{@code yyyy-MM-dd HH:mm:ss}(UTC)。 */ + private static final DateTimeFormatter DATE_TIME = + DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"); + + /** {@code date_type=3}:平台更新时间(UTC),与 updatedAfter/updatedBefore 语义一致。 */ + private static final int DATE_TYPE_PLATFORM_UPDATE_UTC = 3; + + private static final String OP_PULL = "salesOrders.pull.amazon"; + private static final String OP_GET = "salesOrders.get.amazon"; + + @Override + public Page接口 {@link LingxingApi#SETTLEMENT_TRANSACTION_LIST}:POST,{@code offset}/{@code length} + * 分页(上限 10000),令牌桶 10 req/s。
+ * + *查询窗口规则(官方文档):结算时间 {@code startDate/endDate} 双闭区间、 + * 间隔不得超过 7 天;没有搜索值时,结算时间与修改时间二选一必填。 + * 修改时间按北京时间传。
+ */ +public final class AmazonSettlementSource implements LingxingSettlementSource { + + /** 结算日期格式。 */ + private static final DateTimeFormatter DATE = DateTimeFormatter.ofPattern("yyyy-MM-dd"); + /** 修改时间格式(北京时间)。 */ + private static final DateTimeFormatter DATE_TIME = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"); + + private static final String OP = "settlements.pull.amazon"; + + @Override + public Page只负责「拼请求体 + 解析响应」;限流、取 token、签名、业务码校验由 + * {@link LingxingCall} 提供。
+ */ +public interface LingxingSettlementSource { + + /** 分页拉取结算交易明细。 */ + Page不依赖 STORE_ID:sid 来自 {@code /erp/sc/data/seller/lists}。
+ */ + @Test + void listsAmazonShopsAndPullsOrders() { + requireCredentials(); + LingxingAdapter adapter = adapter(); + + String sid = firstAmazonShopSid(adapter); + if (sid == null) { + return; + } + + ChannelContext ctx = context(amazonAccount(sid), "smoke-amazon-orders-"); + Instant to = Instant.now(); + Instant from = to.minus(Duration.ofDays(2)); + Page这条路由的主键是领星系统单号 {@code order_number},不是平台订单号。
+ */ + @Test + void pullsAmazonFbmOrders() { + requireCredentials(); + LingxingAdapter adapter = adapter(); + + String sid = firstAmazonShopSid(adapter); + if (sid == null) { + return; + } + + ChannelContext ctx = context(amazonAccount(sid), "smoke-fbm-"); + Instant to = Instant.now(); + Instant from = to.minus(Duration.ofDays(2)); + Page