
Linkfox Lingxing Erp
- 241 installs
- 64 repo stars
- Updated August 3, 2026
- linkfox-ai/linkfox-skills
Connect agents to Lingxing ERP for inventory, orders, and fulfillment data when automating cross-border seller operations.
About
LinkFox Lingxing ERP skill integrates the Lingxing seller ERP so agents can read and act on inventory, orders, and fulfillment records, enabling automated cross-border e-commerce operations inside Claude workflows.
- Lingxing ERP API bridge
- Inventory and order sync
- Cross-border seller ops
- Agent-accessible backend data
Linkfox Lingxing Erp by the numbers
- 241 all-time installs (skills.sh)
- +35 installs in the week ending Aug 2, 2026 (Skillselion tracking)
- Ranked #537 of 2,715 Automation & Workflows skills by installs in the Skillselion catalog
- Data as of Aug 4, 2026 (Skillselion catalog sync)
npx skills add https://github.com/linkfox-ai/linkfox-skills --skill linkfox-lingxing-erpAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 241 |
|---|---|
| repo stars | ★ 64 |
| Last updated | August 3, 2026 |
| Repository | linkfox-ai/linkfox-skills ↗ |
What it does
Connect agents to Lingxing ERP for inventory, orders, and fulfillment data when automating cross-border seller operations.
Files
领星 ERP OpenAPI(LinkFox 包装版)
本 skill 是 LinkFox 对领星(Lingxing)官方开放能力的包装:name 为 linkfox-lingxing-erp,内容与领星侧 OpenAPI 文档及 scripts/lingxing.py 保持一致,由 LinkFox 仓库统一版本管理;认证与请求仍发往 领星官方域名。速查见 references/api.md。
查询领星 ERP 全模块数据,支持 373 个接口,覆盖广告、销售、产品、财务、统计、FBA、仓库、采购、客服、多平台等全业务线。
环境变量配置
export LINGXING_APP_ID=your_app_id
export LINGXING_APP_SECRET=your_app_secret
# 可选:设置默认店铺 SID,无需每次在 --params 中传入
export LINGXING_SID=your_sid在领星 ERP -> 开放接口菜单中获取 AppID 和 AppSecret。
使用方式
以下命令均在 本 skill 根目录(含 SKILL.md 与 scripts/ 的目录)下执行。
# 列出所有已授权亚马逊店铺,获取 SID
python3 scripts/lingxing.py --list-stores
# 查看所有支持的接口
python3 scripts/lingxing.py --api help
# 基础调用
python3 scripts/lingxing.py --api <接口名> --params '<JSON参数>'
# 自动翻页获取全部数据
python3 scripts/lingxing.py --api <接口名> --params '<JSON参数>' --all
# 自定义翻页大小
python3 scripts/lingxing.py --api <接口名> --params '<JSON参数>' --all --page-size 50输出为 JSON 到 stdout,翻页进度输出到 stderr。
调用示例
# 第一步:查询店铺列表获取 SID
python3 scripts/lingxing.py --list-stores
export LINGXING_SID=813
# 广告报表
python3 scripts/lingxing.py \
--api spCampaignReports \
--params '{"report_date": "2024-01-01"}'
# 亚马逊订单(自动翻页)
python3 scripts/lingxing.py \
--api mwsOrders \
--params '{"start_date": "2024-01-01", "end_date": "2024-01-31"}' --all
# 亚马逊 Listing
python3 scripts/lingxing.py \
--api mwsListing \
--params '{"sid": "813", "is_pair": 1, "is_delete": 0}' --all
# 产品列表
python3 scripts/lingxing.py \
--api ProductLists --params '{"offset": 0, "length": 20}'
# 利润报表(ASIN维度)
python3 scripts/lingxing.py \
--api profitAsin \
--params '{"sids": "813", "start_date": "2024-01-01", "end_date": "2024-01-31"}'
# ASIN日销量
python3 scripts/lingxing.py \
--api AsinDailyLists \
--params '{"sid": 813, "start_date": "2024-01-01", "end_date": "2024-01-07"}' --all
# FBA发货单列表
python3 scripts/lingxing.py \
--api FBAShipmentList \
--params '{"sid": 813}' --all
# 亚马逊源表-全部订单
python3 scripts/lingxing.py \
--api AllOrders \
--params '{"sid": 813, "start_date": "2024-01-01", "end_date": "2024-01-31"}' --all
# 仓库列表
python3 scripts/lingxing.py \
--api WarehouseLists --params '{"offset": 0, "length": 50}'
# Review列表(v2,支持更多筛选)
python3 scripts/lingxing.py \
--api reviewV2 --params '{"sid": 813, "offset": 0, "length": 20}'
# 多平台订单(V2)
python3 scripts/lingxing.py \
--api MultiPlatOrderV2 \
--params '{"start_date": 1704067200, "end_date": 1706745600}' --all
# TikTok广告主列表
python3 scripts/lingxing.py \
--api queryAdvertiserList \
--params '{"length": 100}'
# 补货建议汇总
python3 scripts/lingxing.py \
--api GetSummaryList \
--params '{"sid_list": [813]}' --all接口总览(373个)
新广告报表(37个)
接口详见 references/newad-report.md。
| 分组 | 接口 |
|---|---|
| SP报表(8) | spCampaignReports, campaignPlacementReports, spAdGroupReports, spProductAdReports, spKeywordReports, spTargetReports, asinReports, queryWordReports |
| SB报表(8) | hsaCampaignReports, hsaCampaignPlacementReports, hsaAdGroupReports, listHsaTargetingReport, hsaQueryWordReports, hsaPurchasedAsinReports, listHsaProductAdReport, listHsaKeywordPlacementReport |
| SD报表(6) | sdCampaignReports, sdAdGroupReports, sdProductAdReports, sdTargetReports, sdAsinReports, sdMatchTargetReports |
| SP小时(5) | spCampaignHourData, spAdPlacementHourData, spAdGroupHourData, spAdvertiseHourData, spTargetHourData |
| SB小时(4) | sbCampaignHourData, sbAdGroupHourData, sbTargetHourData, sbAdPlacementHourData |
| SD小时(4) | sdCampaignHourData, sdAdGroupHourData, sdAdvertiseHourData, sdTargetHourData |
| 其他(2) | dspReportOrderList, ProductAnalysisList |
广告基础数据(21个)
接口详见 references/basedata.md。
| 分组 | 接口 |
|---|---|
| 账号(1) | dspAccountList |
| 组合(1) | portfolios |
| SP(6) | spCampaigns, spAdGroups, spProductAds, spKeywords, spTargets, spNegativeTargetsOrKeywords |
| SB(6) | hsaCampaigns, hsaAdGroups, hsaProductAds, sbTargeting, hsaNegativeKeywords, hsaNegativeTargets, sbDivideAsinReports |
| SD(5) | sdCampaigns, sdAdGroups, sdProductAds, sdTargets, sdNegativeTargets |
| 报表下载(1) | abaReport |
基础数据(8个)
接口详见 references/basicdata-full.md。
AccoutLists(GET), AllMarketplace(GET), AttachmentDownload, ConceptSellerLists(GET), Currency, CustomAttachmentDownload, StateList, WorldStateLists
销售(39个)
接口详见 references/sale-ops.md(订单/Listing核心4个)+ references/sale-full.md(其余35个)。
| 分组 | 接口 |
|---|---|
| 订单(7) | mwsOrders, OrderDetail, FBMOrderList, FBMOrderDetail, MCFOrderList, RefundOrder, afterSaleList |
| Listing(5) | mwsListing, sale_ProductList, QueryProductList, GetPrices, listingOperateLogPageList |
| 退货(3) | orderReturnInformation, ProductInformation, LogisticsInformation |
| 促销(12) | promotionListingList, promotionListingDetailCoupon/Manage/PrimeDiscount/SecKill, promotionalActivitiesCouponList/ManageList/SecKillList/VipDiscountList, promotionCouponAllDetailBatch/ManagementAllDetailBatch/PrimeDiscountAllDetailBatch/SecKillAllDetailBatch |
| 运营(7) | scOrderSetRemark, adjustPriceAdjustPriceManual, fbaFeeDifferenceList/MskuList, globalTagPageList, queryListingRelationTagList, GetFulfillmentResult |
| 刊登(5) | PublishManageCategoryRoot/Children, PublishManageGetProductType, GetMerchantShippingGroup |
产品(14个)
接口详见 references/product.md。
ProductLists, ProductDetails, Brand, Category, UpcList, GetProductTag(GET), GetPagingLogLists, attributeList, batchGetProductInfo, bundledProductList, getTransparencyProductList, productAuxList, spuInfo, spuList
财务(41个)
接口详见 references/finance.md。
| 分组 | 接口 |
|---|---|
| 利润报表(7) | profitAsin, profitAsinSon, profitSettlement, FianceProfitMsku, OrderProfitListMSKU, ProfitMsku |
| 结算(6) | SettlementReport, SettlementExportUrlGet, settlementSummaryList, settlementTransactionList, CostStream, summaryQuery |
| BD报表(7) | bdASIN, bdMSKU, bdOrder, bdParentASIN, bdSKU, bdSeller, bdSellerSummary |
| 发票(3) | InvoiceList, InvoiceDetail, InvoiceCampaignList |
| 费用管理(2) | feeManagementList, feeManagementType |
| 资金池(6) | requestFundsPoolCustomFeeList/InboundList/LogisticsList/OtherFeeList/PrepayList/PurchaseList |
| 应收(3) | receivableReportList, reportListDetail, reportListDetailInfo |
| 其他(7) | QueryReceiptFundsList, RequestFundsOrderList, centerOdsDetailQuery, profitReportOrderTranscationList, lazadaPayoutList, lazadaSettlementList, shopeeAdjustmentList/IncomeList/PayoutList |
统计(35个)
接口详见 references/statistics.md。
| 分组 | 接口 |
|---|---|
| 销量(4) | AsinDailyLists, AsinList, AsinListNew, StoreSales |
| FBA仓储(5) | FBAStorageFeeLongTerm, FBAStorageFeeMonth, FbaStockReportList, FbaStockAggregateListNew, FbaStockDetailListNew |
| 本地仓(4) | LocalAggregateList/New, LocalDetailList/New |
| 海外仓(4) | OverseasAggregateList/New, OverseasDetailList/New |
| 新版统计(4) | statisticsOpenASIN/MSKU/Parent/Seller |
| 其他(14) | MonthRefund, ProfitMsku, ReimbursementList, ReturnOrderAnalysisLists, PurchaseReportBuyerList/ProductList/SupplierList, performanceTrendByHour, operateLogList/V2List, PlatformStatisticsSaleStatPageListV2, AmazonReportExportTask, reportCreate/QueryReportExportTask |
FBA发货(13个)
接口详见 references/fba.md。
FBAShipmentList, FBAReceivedInventory, ShipmentPlanLists, GetFbaProductList, GetInboundShipmentList, GetInboundShipmentListMwsDetailList, ShipFromAddressList, BoxInfo, GetHeadLogisticsFeeTypes, GetSeaTrackSupplierCarriers, QuerySTATaskList, StaTaskDetail, getInboundShipmentListMwsDetail
亚马逊源表数据(20个)
接口详见 references/sourcedata.md。
AllOrders, FbaOrders, RefundOrders, Transaction, ManageInventory, DailyInventory, AfnFulfillableQuantity, ReservedInventory, RemovalLists, RemovalOrderListNew, RemovalShipmentList, SourceRemovalOrders, AdjustmentList, getAmazonFulfilledShipmentsList, getFbaAgeList, getFbaInventoryEventDetailList, v1getAmazonFulfilledShipmentsList, v1getFbaInventoryEventDetailList, fbaExchangeOrderList, fbmReturnOrderList
补货建议(9个)
接口详见 references/fbasug.md。
GetSummaryList, ConfigASIN, ConfigMSKU, DailySalesInfoFeatureASIN, DailySalesInfoFeatureMSKU, InfoASIN, InfoMSKU, SourceListASIN, SourceListMSKU
补货限制(2个)
接口详见 references/fbalimit.md。
GetIpiInfo, replenishmentRestrictionList
采购(7个)
接口详见 references/purchase.md。
PurchaseOrderList, Supplier, changeOrderList, purchaseGetOrders, getPurchasePlans, getPurchaseReturnOrderList, purchaserLists
仓库(32个)
接口详见 references/warehouse.md。
| 分组 | 接口 |
|---|---|
| 仓库/库存(11) | WarehouseLists, WarehouseStatement/New, InventoryDetails, inventoryBinDetails, wareHouseBinStatement, warehouseBin, FBAStock, FBAStock_v2, AwdWarehouseDetail |
| 批次(2) | GetBatchDetailList, GetBatchStatementList |
| 收货(4) | GetReceiveGoodRecords, PurchaseReceiptOrderList, ReceiptOrderQcList, getPackingData(GET) |
| WMS(2) | WmsOrderList, WmsOrderDetail |
| 海外仓(2) | OverseaWarehouseMatchList, OverSeasStockDetail |
| 调拨/调整/盘点(3) | getStorageAdjustOrderList, getStorageAllocationList, checkGetOrderList/Detail |
| 入库/出库(4) | inboundgetOrders, outboundgetOrders, listInbound, matchSkuList |
| 其他(4) | getProcessOrderLists, ReturnList, removalInboundList, qualityInspectionOrderDetail |
客服(18个)
接口详见 references/service.md。
FeedbackList, FeedbackListMws, CustomerList, AfterSalesWorkOrderList, PerformanceNoticeList, PerformanceNoticeDetail, mailDetail, mailLists, review, reviewDetail, reviewLists(GET), reviewV2, feedbackDetail, feedbackLists, customerServiceCrmcustomerIndex, customerServiceRmaManageList, storePerformanceList, voiceOfBuyerList
物流(3个)
接口详见 references/logistics.md。
ChannelList, QueryHeadLogisticsProvider, transportMethodList
工具(4个)
接口详见 references/tools.md。
CompetitiveMonitorList, GetKeywordList, warningMessageGoodsList, warningMessageInventoryList
VC(7个)
接口详见 references/vc.md。
vcOrderPageList, vcOrderPoDetail, vcOrderDfDetail, vcDeliverPageList, vcDeliverDetail, listingManageVcListingPageList, platformAuthVcSellerPageList
目标管理(2个)
接口详见 references/targetmanage.md。
StoreBatchSelect, UserBatchSelect
多平台广告(28个)
接口详见 references/multiplatform-ads.md。
| 分组 | 接口 |
|---|---|
| TikTok(9) | queryCommonAdvertiserList, queryGmvStoreList, queryTiktokAdGroupList/AdList/CampaignList, queryAdvertiserList, queryGmvAdvertiserReportList/CampaignReportList/ItemGroupReportList |
| Walmart(19) | queryAdGroupSvList, queryCampaignSpList, queryGroupSpList, queryPageTypeSPList, queryReportPageTypeSvList, reportAdGroupSbList, reportAdItemSbList/SpList/SvList, reportCampaignSbList/SvList, reportKeywordSbList/SpList/SvList, reportPageTypeSbList, reportPlatformSbList/SpList/SvList, reportSearchTrendsList |
多平台V2(33个)
接口详见 references/multiplatform-v2.md。
| 分组 | 接口 |
|---|---|
| 订单(3) | MultiPlatOrderV2, newPlatformOrderList |
| 店铺(1) | StoreInfoV2 |
| Listing(2) | PairListV2, addCargoGoodsList |
| 发货(4) | QueryShippingListV2, QueryShippingListPage, QueryWFSCargoPage/InventionPage |
| 平台订单(8) | AliexpressListV2, aliexpressList, eBayList, walmartList, TemuList, TikTokList, SheinList, ShopifyVariantList |
| 库存(6) | TemuCargo, CoupangStockList, FbsStockList, FbtStockList/Search, FullList, WayfairStockList |
| 利润(4) | profitReportMsku/Order/Seller/Sku |
| 其他(5) | WalmartPaymentQueryPage/Report, WalmartCommentList, LineList, addressReturnAddressList |
店铺列表(--list-stores)
调用 GET /erp/sc/data/seller/lists 接口,列出所有已授权亚马逊店铺。
注意:此接口需要领星 ERP 全量权限。如果 AppKey 仅授权了广告数据,会返回 403。
解决方法:在领星 ERP -> 开放接口中为该 AppKey 添加「基础数据」权限,或直接设置 LINGXING_SID=<数字> 跳过自动发现。注意事项
- SID 注入优先级:
--params中显式传入 >LINGXING_SID环境变量自动注入 - sid vs profile_id: 广告类接口 sid 和 profile_id 二选一必填;dspReportOrderList 仅支持 profile_id
- GET 接口: AccoutLists, AllMarketplace, ConceptSellerLists, GetProductTag, reviewLists, getPackingData 使用 GET 方法
- 分页模式: 大多数接口用 offset/length;WmsOrderList 等用 page/page_size;FBMOrderList 用 page/length
- 响应格式:
/cost/center/路径 API 数据在data.records或data.row_data下 - 日期参数: 报表类接口用
report_date(单日);订单/利润类用start_date/end_date(日期范围);多平台V2用 Unix 时间戳(秒) - Token 缓存: token 自动缓存到
/tmp/lingxing_token_*.json,2小时有效 - 限流: 大多数接口令牌桶容量为 10,ProductAnalysisList 和 mwsOrders 仅为 1
- 依赖: 需要安装
pycryptodome和requests(pip install pycryptodome requests)
错误处理
| 场景 | 处理 |
|---|---|
| 环境变量未设置 | 脚本报错退出,提示设置 LINGXING_APP_ID/LINGXING_APP_SECRET |
| Token 获取失败 | 检查 AppID/AppSecret 是否正确,IP 是否在白名单内 |
| API 返回 code != 0 | 检查参数是否正确,参见错误信息 |
| --list-stores 返回 403 | AppKey 仅有广告权限;设置 LINGXING_SID 直接指定店铺 |
| 依赖未安装 | pip install pycryptodome requests |
<!-- LF_LARGE_RESPONSE_BLOCK -->
Handling Large Responses
To avoid overflowing the agent context, persist the response to disk and extract only the fields you need:
python scripts/response_io.py run --script scripts/lingxing.py --out-dir <DIR> '<params>'
python scripts/response_io.py read <file> --fields "<paths>" # or --path "<JMESPath>"Pick--out-diroutside any git working tree (e.g./tmp/...on Unix,%TEMP%/...on Windows). Persisted responses may contain PII, pricing, or auth-sensitive data — do not commit them. Files are not auto-deleted; clean up when the task is done.
run writes the full response to a file and emits only a schema preview + file path. read projects specific fields, with --limit/--offset for slicing and --format json|jsonl|csv|table for output.
When to prefer this pattern — apply your judgment based on the response characteristics, e.g.:
- High field count per record, or fields you don't need
- Batch/paginated results (multiple items per call)
- Long-text fields (descriptions, reviews, HTML, time series)
- Output reused across later steps rather than consumed immediately
For small, single-use responses, calling the main script directly is fine.
⚠️ The preview is a truncated schema + sample, not the full data. Any field-level decision must read from the persisted file via read. <!-- /LF_LARGE_RESPONSE_BLOCK -->
领星 OpenAPI — 调用说明(LinkFox 包装入口)
本页对应 LinkFox skill `linkfox-lingxing-erp`:由 LinkFox 仓库收录领星官方材料并做路径说明,请求仍直连领星(非 LinkFox 工具网关)。完整接口清单、参数与返回字段见同目录下各专题文档;本页仅汇总认证、域名与脚本用法。
Base URL
- Host:
https://openapi.lingxing.com - 具体路径由
scripts/lingxing.py内SPECIAL_PATHS与各模块约定决定,详见SKILL.md与各references/*.md。
认证与凭证
| 变量 | 必填 | 说明 |
|---|---|---|
LINGXING_APP_ID | 是 | 领星开放接口 AppID |
LINGXING_APP_SECRET | 是 | 领星开放接口 AppSecret |
LINGXING_SID | 否 | 默认店铺 SID;未在 --params 中写 sid 时由脚本注入 |
在领星 ERP → 开放接口 中创建应用并获取密钥;IP 白名单按领星文档配置。
推荐执行方式
在 skill 根目录 skills/linkfox-lingxing-erp/ 下:
export LINGXING_APP_ID=...
export LINGXING_APP_SECRET=...
python3 scripts/lingxing.py --list-stores
python3 scripts/lingxing.py --api help
python3 scripts/lingxing.py --api <接口名> --params '<JSON>'支持 --all、--page-size 等,见 SKILL.md「使用方式」与 scripts/lingxing.py 头部说明。
依赖
脚本需 `requests` 与 `pycryptodome`:
pip install requests pycryptodome分模块参考索引
| 文档 | 内容 |
|---|---|
newad-report.md | 新广告报表 SP/SB/SD 等 |
basedata.md | 广告基础数据 |
basicdata-full.md | 基础数据全量 |
sale-ops.md / sale-full.md | 销售订单、Listing、促销等 |
product.md | 产品 |
finance.md | 财务利润、结算、发票等 |
statistics.md | 统计报表 |
fba.md / fbasug.md / fbalimit.md | FBA 发货、补货建议与限制 |
sourcedata.md | 亚马逊源表 |
purchase.md | 采购 |
warehouse.md | 仓库库存 |
service.md | 客服、Review 等 |
logistics.md | 物流 |
tools.md | 工具类 |
vc.md | VC |
targetmanage.md | 目标管理 |
multiplatform-ads.md / multiplatform-v2.md | 多平台广告与订单 |
Feedback
若需向 LinkFox 反馈本 skill 使用体验,可按仓库内其他 skill 的约定调用 Feedback API(skillName 使用 linkfox-lingxing-erp)。
领星新广告基础数据接口参考(newAd/baseData)
所有接口均为 POST 请求,域名:https://openapi.lingxing.com 所有接口均为只读查询,令牌桶容量 10(sbDivideAsinReports 为 1)。 sid 与 profile_id 二选一必填(dspAccountList 除外)。
---
dspAccountList - 查询广告账号列表
路径: /basicOpen/baseData/account/list(特殊路径)
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| type | 是 | string | dsp / seller / vendor |
| offset | 否 | int | 分页偏移,默认 0 |
| length | 否 | int | 每页条数,默认 20 |
关键返回字段: profile_id, sid, name, type, country_code, currency_code, status(-1删除/0停止/1正常/2授权异常)
---
portfolios - 广告组合
路径: /pb/openapi/newad/portfolios
参数: sid/profile_id, offset, length, next_token
关键返回字段: portfolio_id, profile_id, name, state, budget(amount/policy/startDate/endDate), in_budget, serving_status
---
SP 广告基础数据(6个)
spCampaigns - SP广告活动
路径: /pb/openapi/newad/spCampaigns
参数: sid/profile_id, state(enabled/paused/archived), offset, length, next_token
关键返回字段: campaign_id, profile_id, name, targeting_type(auto/manual), state, serving_status, daily_budget, start_date, end_date, bidding(strategy/adjustments), portfolio_id, tags
---
spAdGroups - SP广告组
路径: /pb/openapi/newad/spAdGroups
参数: sid/profile_id, state, campaign_id(可选), offset, length, next_token
关键返回字段: ad_group_id, campaign_id, profile_id, name, default_bid, state, serving_status, bid_optimization
---
spProductAds - SP广告商品
路径: /pb/openapi/newad/spProductAds
参数: sid/profile_id, state, ad_group_id(可选), offset, length, next_token
关键返回字段: ad_id, campaign_id, ad_group_id, profile_id, sku, asin, state, serving_status
---
spKeywords - SP关键词
路径: /pb/openapi/newad/spKeywords
参数: sid/profile_id, state, campaign_id(可选), ad_group_id(可选), offset, length, next_token
关键返回字段: keyword_id, campaign_id, ad_group_id, profile_id, keyword_text, match_type(exact/phrase/broad), bid, state, serving_status
---
spTargets - SP商品定位
路径: /pb/openapi/newad/spTargets
参数: sid/profile_id, state, campaign_id(可选), ad_group_id(可选), offset, length, next_token
关键返回字段: target_id, campaign_id, ad_group_id, profile_id, expression_type(auto/manual), expression, resolved_expression, bid, state, serving_status
---
spNegativeTargetsOrKeywords - SP否定投放
路径: /pb/openapi/newad/spNegativeTargetsOrKeywords
参数: sid/profile_id, campaign_id(可选), ad_group_id(可选), offset, length, next_token
关键返回字段: campaign_id, ad_group_id, profile_id, negative_type(negativeKeyword/negativeAsin/negativeBrand), negative_text, negative_match_type, state
---
SB 广告基础数据(5个)
hsaCampaigns - SB广告活动
路径: /pb/openapi/newad/hsaCampaigns
参数: sid/profile_id, state, offset, length, next_token
关键返回字段: campaign_id, profile_id, name, budget, budget_type, state, serving_status, start_date, landing_page, bid_multiplier
---
hsaAdGroups - SB广告组
路径: /pb/openapi/newad/hsaAdGroups
参数: sid/profile_id, state, campaign_id(可选), offset, length, next_token
关键返回字段: ad_group_id, campaign_id, profile_id, name, state, serving_status
---
hsaProductAds - SB广告创意
路径: /pb/openapi/newad/hsaProductAds
参数: sid/profile_id, offset, length, next_token
关键返回字段: ad_id, campaign_id, ad_group_id, profile_id, state, creative(广告创意结构)
---
sbTargeting - SB广告投放
路径: /pb/openapi/newad/sbTargeting
参数: sid/profile_id, ads_type(SB/SBV/ALL), state, offset, length, next_token
关键返回字段: campaign_id, ad_group_id, keyword_id, keyword_text, keyword_bid, match_type, target_id, expression, target_bid, target_state, resolved_expression
---
hsaNegativeKeywords - SB否定关键词
路径: /pb/openapi/newad/hsaNegativeKeywords
参数: sid/profile_id, state, campaign_id(可选), offset, length, next_token
关键返回字段: keyword_id, campaign_id, ad_group_id, profile_id, keyword_text, match_type, state
---
hsaNegativeTargets - SB否定商品投放
路径: /pb/openapi/newad/hsaNegativeTargets
参数: sid/profile_id, state, campaign_id(可选), offset, length, next_token
关键返回字段: target_id, campaign_id, ad_group_id, profile_id, expression_type, expression, resolved_expression, state
---
sbDivideAsinReports - SB分摊
路径: /pb/openapi/newad/sbDivideAsinReports 令牌桶容量: 1
参数: profile_id(必填,不支持sid), report_date(Y-m-d), offset, length, next_token
---
SD 广告基础数据(5个)
sdCampaigns - SD广告活动
路径: /pb/openapi/newad/sdCampaigns
参数: sid/profile_id, state, offset, length, next_token
关键返回字段: campaign_id, profile_id, name, tactic(T00001/T00020/T00030), cost_type, budget_type, budget, state, serving_status, start_date
---
sdAdGroups - SD广告组
路径: /pb/openapi/newad/sdAdGroups
参数: sid/profile_id, state, campaign_id(可选), offset, length, next_token
关键返回字段: ad_group_id, campaign_id, profile_id, name, default_bid, state, serving_status, bid_optimization
---
sdProductAds - SD广告商品
路径: /pb/openapi/newad/sdProductAds
参数: sid/profile_id, state, ad_group_id(可选), offset, length, next_token
关键返回字段: ad_id, ad_group_id, campaign_id, profile_id, sku, asin, state, serving_status
---
sdTargets - SD商品定位
路径: /pb/openapi/newad/sdTargets
参数: sid/profile_id, state, campaign_id(可选), offset, length, next_token
关键返回字段: target_id, campaign_id, ad_group_id, profile_id, expression_type, expression, resolved_expression, bid, state, serving_status
---
sdNegativeTargets - SD否定商品定位
路径: /pb/openapi/newad/sdNegativeTargets
参数: sid/profile_id, state, campaign_id(可选), offset, length, next_token
关键返回字段: target_id, campaign_id, ad_group_id, profile_id, expression_type, expression, resolved_expression, state
---
通用说明
state过滤:enabled/paused/archived,不传返回全部next_token分页游标:与offset同时传时以next_token为准,推荐优先用next_tokensbDivideAsinReports仅支持profile_id,不支持sid,且令牌桶容量仅 1,需串行调用
领星基础数据接口参考
所有接口均为 POST 请求(除标注 GET 外),域名:https://openapi.lingxing.com
---
AccoutLists - 查询ERP账户列表
路径: /erp/sc/data/account/lists 方法: GET(无请求参数)
关键返回字段: uid, username, realname, mobile, email, status(0禁用/1正常), role, seller(店铺权限), is_master
---
AllMarketplace - 查询亚马逊市场列表
路径: /erp/sc/data/seller/allMarketplace 方法: GET(无请求参数)
关键返回字段: mid(领星站点ID), region, country, code(国家代码如US/UK), marketplace_id(亚马逊市场ID)
---
AttachmentDownload - 附件下载
路径: /erp/sc/routing/common/file/download 方法: POST
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| file_id | 是 | int | 附件id(来自对应功能接口返回的附件id) |
关键返回字段: file_name, mime_type, content(base64编码的文件内容)
---
ConceptSellerLists - 查询概念店铺列表
路径: /erp/sc/data/seller/conceptLists 方法: GET(无请求参数)
关键返回字段: id(概念店铺ID), mid(概念市场ID), name, seller_id, seller_account_name, seller_account_id, region, country, status(1启用/2禁用)
---
Currency - 查询货币月汇率
路径: /erp/sc/routing/finance/currency/currencyMonth 方法: POST
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| date | 是 | string | 汇率月份,格式 YYYY-MM |
关键返回字段: date, code(币种代码如CNY/USD), icon, name, rate_org(官方汇率), my_rate(自定义汇率)
---
CustomAttachmentDownload - 自定义附件下载
路径: /erp/sc/routing/customized/file/download 方法: POST
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| file_id | 是 | string | 附件文件id(来自订单详情接口) |
关键返回字段: file_name, mime_type, content(base64编码文件内容)
---
StateList - 查询省份列表
路径: /basicOpen/multiplatform/profit/report/stateList 方法: POST
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| countryCode | 是 | string | 国家编码二字码,如 US/AF/DE |
关键返回字段: data>>states>>countryCode, data>>states>>stateOrProvinceName, data>>states>>code(州/省编码)
---
WorldStateLists - 查询亚马逊国家地区列表
路径: /erp/sc/data/worldState/lists 方法: POST
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| country_code | 是 | string | 国家code,来自 AllMarketplace 接口的 code 字段 |
关键返回字段: country_code, state_or_province_name, code(地区code)
---
领星FBA接口参考
所有接口均为 POST 请求,域名:https://openapi.lingxing.com
---
fbaShipmentList - 查询FBA发货单列表
路径: /erp/sc/data/fba_report/shipmentList 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| sid | 是 | int | 店铺ID |
| start_date | 否 | string | 开始日期,格式 Y-m-d |
| end_date | 否 | string | 结束日期 |
| status | 否 | string | 发货单状态 |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 分页长度,默认1000 |
关键返回字段: sid, shipment_id, shipment_name, status, destination_fulfillment_center_id, label_prep_type, create_date, item_list[seller_sku/fnsku/asin/quantity_shipped]
---
fbaReceivedInventory - 查询FBA已收货库存
路径: /erp/sc/data/fba_report/receivedInventory 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| sid | 是 | int | 店铺ID |
| start_date | 否 | string | 开始日期,格式 Y-m-d |
| end_date | 否 | string | 结束日期 |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 分页长度,默认1000 |
关键返回字段: sid, shipment_id, fnsku, asin, seller_sku, quantity_shipped, quantity_received, quantity_in_case
---
shipmentPlanLists - 查询FBA发货计划列表
路径: /erp/sc/data/fba_report/shipmentPlanLists 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| sid | 是 | int | 店铺ID |
| start_date | 否 | string | 开始日期,格式 Y-m-d |
| end_date | 否 | string | 结束日期 |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 分页长度,默认1000 |
关键返回字段: sid, plan_id, plan_name, status, create_date, item_list[seller_sku/asin/quantity]
---
getFbaProductList - 查询FBA产品列表
路径: /erp/sc/routing/fba/shipment/getFbaProductList 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| sid | 是 | int | 店铺ID |
| search_field | 否 | string | 搜索字段:seller_sku/asin/fnsku |
| search_value | 否 | string | 搜索值 |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 分页长度,默认20 |
关键返回字段: sid, seller_sku, asin, fnsku, product_name, local_sku, condition, prep_type
---
getInboundShipmentList - 查询FBA入库发货单列表
路径: /erp/sc/routing/storage/shipment/getInboundShipmentList 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| sid | 是 | int | 店铺ID |
| start_date | 否 | string | 开始日期,格式 Y-m-d |
| end_date | 否 | string | 结束日期 |
| status | 否 | string | 发货单状态 |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 分页长度,默认20 |
关键返回字段: sid, shipment_id, shipment_name, status, fulfillment_center_id, create_date, total_quantity
---
getInboundShipmentListMwsDetailList - 查询FBA入库发货单商品明细列表
路径: /erp/sc/routing/storage/shipment/getInboundShipmentListMwsDetailList 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| sid | 是 | int | 店铺ID |
| shipment_id | 是 | string | 发货单ID |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 分页长度,默认20 |
关键返回字段: shipment_id, seller_sku, fnsku, asin, quantity_shipped, quantity_received, quantity_in_case
---
shipFromAddressList - 查询FBA发货地址列表
路径: /erp/sc/routing/fba/shipment/shipFromAddressList 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| sid | 是 | int | 店铺ID |
关键返回字段: address_id, name, address_line1, city, state_or_province_code, country_code, postal_code
---
boxInfo - 查询FBA箱规信息
路径: /erp/sc/routing/fba/shipment/boxInfo 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| sid | 是 | int | 店铺ID |
| shipment_id | 是 | string | 发货单ID |
关键返回字段: shipment_id, box_list[box_no/length/width/height/weight/quantity/item_list]
---
getHeadLogisticsFeeTypes - 查询头程费用类型
路径: /erp/sc/routing/fba/shipment/getHeadLogisticsFeeTypes 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| sid | 否 | int | 店铺ID |
关键返回字段: fee_type_id, fee_type_name, currency
---
getSeaTrackSupplierCarriers - 查询海运跟踪供应商承运商
路径: /erp/sc/routing/fba/shipment/getSeaTrackSupplierCarriers 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| supplier_id | 否 | int | 供应商ID |
关键返回字段: carrier_id, carrier_name, supplier_id
---
querySTATaskList - 查询STA入库计划列表
路径: /amzStaServer/openapi/inbound-plan/page 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| sid | 是 | int | 店铺ID |
| status | 否 | string | 计划状态 |
| start_date | 否 | string | 开始日期,格式 Y-m-d |
| end_date | 否 | string | 结束日期 |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 分页长度,默认20 |
关键返回字段: inbound_plan_id, sid, status, create_date, total_boxes, total_quantity, marketplace_id
---
staTaskDetail - 查询STA入库计划详情
路径: /amzStaServer/openapi/inbound-plan/detail 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| inbound_plan_id | 是 | string | 入库计划ID |
| sid | 是 | int | 店铺ID |
关键返回字段: inbound_plan_id, status, marketplace_id, shipment_list[shipment_id/status/destination/quantity], item_list[seller_sku/fnsku/asin/quantity]
---
getInboundShipmentListMwsDetail - 查询FBA入库发货单商品明细
路径: /erp/sc/routing/storage/shipment/getInboundShipmentListMwsDetail 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| sid | 是 | int | 店铺ID |
| shipment_id | 是 | string | 发货单ID |
关键返回字段: shipment_id, seller_sku, fnsku, asin, quantity_shipped, quantity_received, prep_detail_list
领星FBA库容限制接口参考
所有接口均为 POST 请求,域名:https://openapi.lingxing.com
---
GetIpiInfo - 查询IPI绩效指标信息
路径: /erp/sc/routing/fbaLimit/restock/getIpiInfo
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| offset | 否 | int | 分页偏移量 |
| length | 否 | int | 分页长度 |
| sids | 否 | string | 店铺id,多个以英文逗号分隔 |
| seller_ids | 否 | string | 亚马逊卖家id,多个以英文逗号分隔 |
| mids | 否 | string | 站点id,多个以英文逗号分隔 |
关键返回字段: data>>seller_id, data>>seller_account_name, data>>seller_name, data>>marketplace, data>>update_date, data>>vol_unit_text, data>>ipi, data>>excess_inventory_rate
---
replenishmentRestrictionList - 查询补货限制列表
路径: /basicOpen/openapi/replenishmentRestriction/page/list
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| storage_type | 是 | string | 仓储类型 |
| offset | 否 | int | 分页偏移量 |
| length | 否 | int | 分页长度 |
| sids | 否 | string | 店铺id,多个以英文逗号分隔 |
关键返回字段: data>>data>>month, data>>list>>sid, data>>list>>vol_unit_type, data>>list>>ipi, data>>list>>update_type, data>>list>>excess_inventory_rate, data>>list>>excess_inventory_color, data>>list>>sell_through_rate
---
领星FBA补货建议接口参考
所有接口均为 POST 请求,域名:https://openapi.lingxing.com
---
GetSummaryList - 查询补货建议汇总列表
路径: /erp/sc/routing/restocking/analysis/getSummaryList
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| data_type | 是 | int | 数据维度类型 |
| sid_list | 否 | array | 店铺id列表 |
| asin_list | 否 | array | ASIN列表 |
| msku_list | 否 | array | MSKU列表 |
| mode | 否 | int | 模式 |
| listing_date_range | 否 | array | 上架日期范围 |
| offset | 否 | int | 分页偏移量 |
| length | 否 | int | 分页长度 |
关键返回字段: data>>basic_info>>data_type, data>>basic_info>>node_type, data>>basic_info>>sid, data>>basic_info>>asin, data>>basic_info>>msku_fnsku_list
---
ConfigASIN - 查询ASIN补货配置
路径: /erp/sc/routing/fbaSug/asin/getConfig
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| sid | 是 | int | 店铺id |
| asin | 是 | string | ASIN |
关键返回字段: data>>info>>days_total, data>>info>>days_total2, data>>info>>days_plan, data>>info>>days_purchase, data>>info>>days_qc
---
ConfigMSKU - 查询MSKU补货配置
路径: /erp/sc/routing/fbaSug/msku/getConfig
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| sid | 是 | string | 店铺id |
| msku | 是 | string | MSKU |
关键返回字段: data>>info>>days_total, data>>info>>days_total2, data>>info>>days_plan, data>>info>>days_purchase, data>>info>>days_qc
---
DailySalesInfoFeatureASIN - 查询ASIN日销售特征数据
路径: /erp/sc/routing/fbaSug/asin/getDailySalesInfoFeature
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| sid | 是 | int | 店铺id |
| asin | 是 | string | ASIN |
| sug_type | 是 | int | 建议类型 |
| mode | 否 | int | 模式 |
关键返回字段: data>>list(日期销量列表), data>>sug_date_line>>date, data>>sug_date_line>>desc, data>>sug_date_line>>title
---
DailySalesInfoFeatureMSKU - 查询MSKU日销售特征数据
路径: /erp/sc/routing/fbaSug/msku/getDailySalesInfoFeature
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| sid | 是 | int | 店铺id |
| msku | 是 | string | MSKU |
| sug_type | 是 | int | 建议类型 |
| mode | 否 | int | 模式 |
关键返回字段: data>>list(日期销量列表), data>>sug_date_line>>date, data>>sug_date_line>>desc, data>>sug_date_line>>title
---
InfoASIN - 查询ASIN补货建议信息
路径: /erp/sc/routing/fbaSug/asin/getInfo
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| sid | 是 | int | 店铺id |
| asin | 是 | string | ASIN |
| mode | 否 | int | 模式 |
关键返回字段: data>>sid, data>>asin, data>>mode, data>>quantity_fba_valid, data>>msku_list>>msku
---
InfoMSKU - 查询MSKU补货建议信息
路径: /erp/sc/routing/fbaSug/msku/getInfo
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| sid | 是 | int | 店铺id |
| msku | 是 | string | MSKU |
| mode | 否 | int | 模式 |
关键返回字段: data>>sid, data>>msku, data>>mode, data>>quantity_sug_replenishment, data>>quantity_sug_send, data>>quantity_fba_valid
---
SourceListASIN - 查询ASIN补货来源列表
路径: /erp/sc/routing/fbaSug/asin/getSourceList
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| sid | 是 | int | 店铺id |
| asin | 是 | string | ASIN |
| type | 否 | string | 补货来源类型 |
| mode | 否 | string | 模式 |
关键返回字段: data>>mode, data>>source_list>>quantity, data>>source_list>>type, data>>source_list>>amazon_sale_date, data>>source_list>>remark
---
SourceListMSKU - 查询MSKU补货来源列表
路径: /erp/sc/routing/fbaSug/msku/getSourceList
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| sid | 是 | int | 店铺id |
| msku | 是 | string | MSKU |
| type | 否 | string | 补货来源类型 |
| mode | 否 | string | 模式 |
关键返回字段: data>>mode, data>>source_list>>quantity, data>>source_list>>type, data>>source_list>>amazon_sale_date, data>>source_list>>remark
---
领星财务接口参考
所有接口均为 POST 请求,域名:https://openapi.lingxing.com
---
profitAsin - 查询ASIN利润报表
路径: /erp/sc/routing/finance/ProfitState/profitAsin 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| month | 是 | string | 月份,格式 Y-m |
| sids | 否 | string | 店铺ID,多个逗号分隔 |
| currency_type | 否 | string | 币种:1=CNY,2=USD,3=EUR等 |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 每页条数,上限200 |
关键返回字段: sid, asin, parent_asin, seller_sku, month, sales_amount, cost, profit, profit_rate, fba_fee, commission, ad_cost
---
profitAsinSon - 查询ASIN子变体利润
路径: /erp/sc/routing/finance/ProfitState/profitAsinSon 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| month | 是 | string | 月份,格式 Y-m |
| sids | 否 | string | 店铺ID,多个逗号分隔 |
| asin | 否 | string | 父ASIN |
| version | 否 | int | 版本号 |
| currency_type | 否 | string | 币种 |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 每页条数,上限200 |
关键返回字段: sid, asin, seller_sku, month, sales_amount, profit, profit_rate
---
profitSettlement - 查询结算利润报表
路径: /erp/sc/routing/finance/ProfitState/profitSettlement 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| sids | 否 | string | 店铺ID,多个逗号分隔 |
| start_date | 是 | string | 开始日期,格式 Y-m-d |
| end_date | 是 | string | 结束日期 |
| currency_type | 否 | string | 币种 |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 每页条数,上限200 |
关键返回字段: sid, amazon_order_id, settlement_id, sales_amount, fba_fee, commission, profit, currency
---
profitMsku - 查询MSKU利润报表
路径: /erp/sc/routing/finance/ProfitState/profitMsku 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| month | 是 | string | 月份,格式 Y-m |
| sids | 否 | string | 店铺ID,多个逗号分隔 |
| currency_type | 否 | string | 币种 |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 每页条数,上限200 |
关键返回字段: sid, seller_sku, asin, month, sales_amount, profit, profit_rate, fba_fee, commission
---
settlementReport - 查询结算报告
路径: /cost/center/api/settlement/report 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| amazonSellerIds | 否 | array | 亚马逊店铺ID列表 |
| sids | 否 | array | 领星店铺ID列表 |
| timeType | 是 | int | 时间类型:1=结算开始时间,2=结算结束时间 |
| filterBeginDate | 是 | string | 开始日期,格式 Y-m-d |
| filterEndDate | 是 | string | 结束日期 |
关键返回字段: settlement_id, sid, start_date, end_date, total_amount, currency
---
costStream - 查询成本流水
路径: /cost/center/api/cost/stream 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| mskus | 否 | array | MSKU列表 |
| business_types | 是 | array | 业务类型列表 |
| query_type | 是 | int | 查询类型 |
| start_date | 否 | string | 开始日期 |
| end_date | 否 | string | 结束日期 |
关键返回字段: msku, business_type, amount, currency, date, remark
---
orderProfitListMSKU - 查询订单MSKU利润明细
路径: /basicOpen/finance/mreport/OrderProfit 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| sids | 否 | string | 店铺ID,多个逗号分隔 |
| startDate | 是 | string | 开始日期,格式 Y-m-d |
| endDate | 是 | string | 结束日期 |
| searchField | 否 | string | 搜索字段:amazon_order_id/seller_sku/asin |
| searchValue | 否 | string | 搜索值 |
| currencyCode | 否 | string | 货币代码 |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 每页条数,默认20 |
关键返回字段: amazon_order_id, sid, seller_sku, asin, sales_amount, fba_fee, commission, profit, currency
---
invoiceList - 查询发票列表
路径: /bd/profit/report/open/report/ads/invoice/list 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| sids | 否 | array | 店铺ID列表 |
| start_date | 否 | string | 开始日期 |
| end_date | 否 | string | 结束日期 |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 每页条数,默认20 |
关键返回字段: invoice_id, sid, invoice_date, amount, currency, status, campaign_count
---
invoiceDetail - 查询发票详情
路径: /bd/profit/report/open/report/ads/invoice/detail 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| invoice_id | 是 | string | 发票ID |
| sid | 是 | int | 店铺ID |
关键返回字段: invoice_id, sid, invoice_date, amount, currency, status, line_items
---
invoiceCampaignList - 查询发票广告活动列表
路径: /bd/profit/report/open/report/ads/invoice/campaign/list 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| invoice_id | 是 | string | 发票ID |
| sid | 是 | int | 店铺ID |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 每页条数,默认20 |
关键返回字段: campaign_id, campaign_name, spend, impressions, clicks
---
queryReceiptFundsList - 查询收款记录列表
路径: /basicOpen/finance/queryReceiptFundsList 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| sids | 否 | string | 店铺ID,多个逗号分隔 |
| start_date | 否 | string | 开始日期 |
| end_date | 否 | string | 结束日期 |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 每页条数,默认20 |
关键返回字段: receipt_id, sid, amount, currency, receipt_date, status
---
requestFundsOrderList - 查询付款单列表
路径: /basicOpen/finance/requestFunds/order/list 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| start_date | 否 | string | 开始日期 |
| end_date | 否 | string | 结束日期 |
| status | 否 | int | 状态 |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 每页条数,默认20 |
关键返回字段: order_id, amount, currency, status, create_time, type
---
settlementExportUrlGet - 获取结算报告导出URL
路径: /bd/sp/api/open/settlement/export/url/get 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| settlement_id | 是 | string | 结算ID |
| sid | 是 | int | 店铺ID |
关键返回字段: url, expires_at
---
bdAsin - 查询ASIN利润分析报表
路径: /bd/profit/report/open/report/asin/list 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| startDate | 是 | string | 开始日期,格式 Y-m-d |
| endDate | 是 | string | 结束日期 |
| sids | 否 | array | 店铺ID列表 |
| currencyCode | 否 | string | 货币代码 |
| monthlyQuery | 否 | int | 是否按月查询:0=否,1=是 |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 每页条数,默认20 |
关键返回字段: asin, sid, sales_amount, ad_cost, fba_fee, commission, profit, profit_rate, currency
---
bdMsku - 查询MSKU利润分析报表
路径: /bd/profit/report/open/report/msku/list 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| startDate | 是 | string | 开始日期 |
| endDate | 是 | string | 结束日期 |
| sids | 否 | array | 店铺ID列表 |
| currencyCode | 否 | string | 货币代码 |
| monthlyQuery | 否 | int | 是否按月查询 |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 每页条数,默认20 |
关键返回字段: seller_sku, asin, sid, sales_amount, profit, profit_rate, currency
---
bdOrder - 查询订单利润分析报表
路径: /bd/profit/report/open/report/order/list 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| startDate | 是 | string | 开始日期 |
| endDate | 是 | string | 结束日期 |
| sids | 否 | array | 店铺ID列表 |
| currencyCode | 否 | string | 货币代码 |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 每页条数,默认20 |
关键返回字段: amazon_order_id, sid, sales_amount, profit, profit_rate, currency, purchase_date
---
bdParentAsin - 查询父ASIN利润分析报表
路径: /bd/profit/report/open/report/parent/asin/list 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| startDate | 是 | string | 开始日期 |
| endDate | 是 | string | 结束日期 |
| sids | 否 | array | 店铺ID列表 |
| currencyCode | 否 | string | 货币代码 |
| monthlyQuery | 否 | int | 是否按月查询 |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 每页条数,默认20 |
关键返回字段: parent_asin, sid, sales_amount, profit, profit_rate, currency
---
bdSku - 查询SKU利润分析报表
路径: /bd/profit/report/open/report/sku/list 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| startDate | 是 | string | 开始日期 |
| endDate | 是 | string | 结束日期 |
| sids | 否 | array | 店铺ID列表 |
| currencyCode | 否 | string | 货币代码 |
| monthlyQuery | 否 | int | 是否按月查询 |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 每页条数,默认20 |
关键返回字段: sku, asin, sid, sales_amount, profit, profit_rate, currency
---
bdSeller - 查询店铺利润分析报表
路径: /bd/profit/report/open/report/seller/list 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| startDate | 是 | string | 开始日期 |
| endDate | 是 | string | 结束日期 |
| sids | 否 | array | 店铺ID列表 |
| currencyCode | 否 | string | 货币代码 |
| monthlyQuery | 否 | int | 是否按月查询 |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 每页条数,默认20 |
关键返回字段: sid, seller_name, sales_amount, profit, profit_rate, currency
---
bdSellerSummary - 查询店铺利润汇总报表
路径: /bd/profit/report/open/report/seller/summary/list 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| startDate | 是 | string | 开始日期 |
| endDate | 是 | string | 结束日期 |
| sids | 否 | array | 店铺ID列表 |
| currencyCode | 否 | string | 货币代码 |
关键返回字段: sid, seller_name, total_sales, total_profit, profit_rate, currency
---
centerOdsDetailQuery - 查询成本中心ODS明细
路径: /cost/center/ods/detail/query 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| mskus | 否 | array | MSKU列表 |
| start_date | 否 | string | 开始日期 |
| end_date | 否 | string | 结束日期 |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 每页条数,默认20 |
关键返回字段: msku, cost_type, amount, currency, date, warehouse
---
feeManagementList - 查询其他费用列表
路径: /bd/fee/management/open/feeManagement/otherFee/list 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| sids | 否 | array | 店铺ID列表 |
| start_date | 否 | string | 开始日期 |
| end_date | 否 | string | 结束日期 |
| fee_type | 否 | string | 费用类型 |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 每页条数,默认20 |
关键返回字段: fee_id, sid, fee_type, fee_name, amount, currency, date
---
feeManagementType - 查询费用类型列表
路径: /bd/fee/management/open/feeManagement/otherFee/type 令牌桶容量: 1
参数: 无
关键返回字段: type_id, type_name, type_code
---
lazadaPayoutList - 查询Lazada打款记录
路径: /basicOpen/finance/lazada/payout/list 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| store_ids | 否 | array | 店铺ID列表 |
| start_date | 否 | string | 开始日期 |
| end_date | 否 | string | 结束日期 |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 每页条数,默认20 |
关键返回字段: payout_id, store_id, amount, currency, payout_date, status
---
lazadaSettlementList - 查询Lazada结算列表
路径: /basicOpen/finance/lazada/settlement/list 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| store_ids | 否 | array | 店铺ID列表 |
| start_date | 否 | string | 开始日期 |
| end_date | 否 | string | 结束日期 |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 每页条数,默认20 |
关键返回字段: settlement_id, store_id, amount, currency, start_date, end_date, status
---
profitReportOrderTranscationList - 查询订单交易利润报表
路径: /basicOpen/finance/profitReport/order/transcation/list 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| sids | 否 | string | 店铺ID,多个逗号分隔 |
| start_date | 是 | string | 开始日期 |
| end_date | 是 | string | 结束日期 |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 每页条数,默认20 |
关键返回字段: amazon_order_id, sid, transaction_type, amount, currency, posted_date
---
receivableReportList - 查询应收账款报表列表
路径: /bd/sp/api/open/monthly/receivable/report/list 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| sids | 否 | array | 店铺ID列表 |
| year_month | 否 | string | 年月,格式 Y-m |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 每页条数,默认20 |
关键返回字段: report_id, sid, year_month, receivable_amount, currency, status
---
reportListDetail - 查询应收账款报表明细
路径: /bd/sp/api/open/monthly/receivable/report/list/detail 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| report_id | 是 | string | 报表ID |
| sid | 是 | int | 店铺ID |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 每页条数,默认20 |
关键返回字段: settlement_id, amount, currency, start_date, end_date
---
reportListDetailInfo - 查询应收账款报表明细详情
路径: /bd/sp/api/open/monthly/receivable/report/list/detail/info 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| report_id | 是 | string | 报表ID |
| settlement_id | 是 | string | 结算ID |
| sid | 是 | int | 店铺ID |
关键返回字段: settlement_id, transaction_list[type/amount/currency/date]
---
requestFundsPoolCustomFeeList - 查询资金池自定义费用列表
路径: /basicOpen/finance/requestFundsPool/customFee/list 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| pool_id | 是 | int | 资金池ID |
| start_date | 否 | string | 开始日期 |
| end_date | 否 | string | 结束日期 |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 每页条数,默认20 |
关键返回字段: fee_id, pool_id, fee_type, amount, currency, date, remark
---
requestFundsPoolInboundList - 查询资金池头程费用列表
路径: /basicOpen/finance/requestFundsPool/inbound/list 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| pool_id | 是 | int | 资金池ID |
| start_date | 否 | string | 开始日期 |
| end_date | 否 | string | 结束日期 |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 每页条数,默认20 |
关键返回字段: fee_id, pool_id, shipment_no, amount, currency, date
---
requestFundsPoolLogisticsList - 查询资金池物流费用列表
路径: /basicOpen/finance/requestFundsPool/logistics/list 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| pool_id | 是 | int | 资金池ID |
| start_date | 否 | string | 开始日期 |
| end_date | 否 | string | 结束日期 |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 每页条数,默认20 |
关键返回字段: fee_id, pool_id, order_no, amount, currency, date
---
requestFundsPoolOtherFeeList - 查询资金池其他费用列表
路径: /basicOpen/finance/requestFundsPool/otherFee/list 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| pool_id | 是 | int | 资金池ID |
| start_date | 否 | string | 开始日期 |
| end_date | 否 | string | 结束日期 |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 每页条数,默认20 |
关键返回字段: fee_id, pool_id, fee_type, amount, currency, date
---
requestFundsPoolPrepayList - 查询资金池预付款列表
路径: /basicOpen/finance/requestFundsPool/prepay/list 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| pool_id | 是 | int | 资金池ID |
| start_date | 否 | string | 开始日期 |
| end_date | 否 | string | 结束日期 |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 每页条数,默认20 |
关键返回字段: prepay_id, pool_id, amount, currency, date, status
---
requestFundsPoolPurchaseList - 查询资金池采购费用列表
路径: /basicOpen/finance/requestFundsPool/purchase/list 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| pool_id | 是 | int | 资金池ID |
| start_date | 否 | string | 开始日期 |
| end_date | 否 | string | 结束日期 |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 每页条数,默认20 |
关键返回字段: fee_id, pool_id, purchase_order_no, amount, currency, date
---
settlementSummaryList - 查询结算汇总列表
路径: /bd/sp/api/open/settlement/summary/list 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| sids | 否 | array | 店铺ID列表 |
| start_date | 否 | string | 开始日期 |
| end_date | 否 | string | 结束日期 |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 每页条数,默认20 |
关键返回字段: settlement_id, sid, start_date, end_date, total_amount, deposit_amount, currency
---
settlementTransactionList - 查询结算交易明细列表
路径: /bd/sp/api/open/settlement/transaction/detail/list 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| settlement_id | 是 | string | 结算ID |
| sid | 是 | int | 店铺ID |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 每页条数,默认20 |
关键返回字段: transaction_id, settlement_id, type, amount, currency, posted_date, order_id
---
shopeeAdjustmentList - 查询Shopee调整列表
路径: /basicOpen/finance/shopee/adjustment/list 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| store_ids | 否 | array | 店铺ID列表 |
| start_date | 否 | string | 开始日期 |
| end_date | 否 | string | 结束日期 |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 每页条数,默认20 |
关键返回字段: adjustment_id, store_id, type, amount, currency, date, reason
---
shopeeIncomeList - 查询Shopee收入列表
路径: /basicOpen/finance/shopee/income/list 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| store_ids | 否 | array | 店铺ID列表 |
| start_date | 否 | string | 开始日期 |
| end_date | 否 | string | 结束日期 |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 每页条数,默认20 |
关键返回字段: income_id, store_id, order_id, amount, currency, income_date, type
---
shopeePayoutList - 查询Shopee打款列表
路径: /basicOpen/finance/shopee/payout/list 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| store_ids | 否 | array | 店铺ID列表 |
| start_date | 否 | string | 开始日期 |
| end_date | 否 | string | 结束日期 |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 每页条数,默认20 |
关键返回字段: payout_id, store_id, amount, currency, payout_date, status
---
summaryQuery - 查询成本中心ODS汇总
路径: /cost/center/ods/summary/query 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| mskus | 否 | array | MSKU列表 |
| start_date | 否 | string | 开始日期 |
| end_date | 否 | string | 结束日期 |
关键返回字段: msku, total_cost, cost_by_type[type/amount/currency]
领星物流接口参考
所有接口均为 POST 请求,域名:https://openapi.lingxing.com
---
ChannelList - 查询物流渠道列表
路径: /erp/sc/data/local_inventory/channelList
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| offset | 是 | int | 分页偏移量 |
| length | 是 | int | 分页长度 |
关键返回字段: id, channel_name, method_id, method_name, billing_type, volume_calc_param, zip_code, valid_period
---
QueryHeadLogisticsProvider - 查询头程物流商列表
路径: /basicOpen/logistics/headLogisticsProvider/query/list
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| search | 是 | object | 搜索条件对象 |
| search>>page | 是 | int | 页码 |
| search>>length | 是 | int | 每页大小 |
| search>>enabled | 否 | int | 是否启用 |
| search>>isAuth | 否 | int | 是否已授权 |
| search>>payMethod | 否 | int | 付款方式 |
| search>>searchField | 否 | string | 搜索字段名 |
| search>>searchValue | 否 | string | 搜索值 |
关键返回字段: data>>total, data>>providers>>providerId, data>>providers>>name, data>>providers>>code, data>>providers>>enabled, data>>providers>>logisticsType, data>>providers>>isAuth, data>>providers>>supplierCode, data>>providers>>supplierName
---
transportMethodList - 查询运输方式列表
路径: /basicOpen/businessConfig/transportMethod/list 参数: 无(直接调用即可)
关键返回字段: data>>method_id, data>>code, data>>name, data>>is_system, data>>enabled, data>>remark, data>>creator_id, data>>creator_name
---
领星多平台广告接口参考
所有接口均为 POST 请求,域名:https://openapi.lingxing.com
---
TikTok 推广广告
queryAdvertiserList - 查询广告账号
路径: /basicOpen/multiplatform/ads/queryAdvertiserList 参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| startDate | 是 | string | 开始日期,yyyy-MM-dd,间隔不超过31天 |
| endDate | 是 | string | 结束日期,yyyy-MM-dd |
| length | 是 | int | 每页条数,小于2000 |
| page | 是 | int | 页码 |
| advertiserIds | 否 | array | 广告账号ID列表 |
| status | 否 | array | STATUS_ENABLE/SYSTEM_STATUS_IN_REVIEW/SYSTEM_STATUS_NOT_PASS/STATUS_LIMIT/STATUS_DISABLE |
| currencies | 否 | array | 币种列表,如 ["USD","CNY"] |
| orderField | 否 | string | 排序字段(驼峰) |
| orderType | 否 | string | ASC/DESC |
| searchType | 否 | string | advertiser_name/ad_group_name/campaign_name/ad_name |
| searchValue | 否 | array | 搜索值 |
关键返回字段: advertiserId, advertiserName, spend, impressions, clicks, ctr, cpc, orders, revenue, roas
---
queryCommonAdvertiserList - 查询推广广告账号(通用)
路径: /basicOpen/multiplatform/ads/queryCommonAdvertiserList 参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| internalStatus | 否 | string | ENABLE/DISABLE/DELETE |
| hasGmvStore | 否 | int | 1=只返回有GMV店铺的账号 |
关键返回字段: 广告账号基础信息列表
---
queryTiktokCampaignList - 查询广告系列
路径: /basicOpen/multiplatform/ads/queryTiktokCampaignList 参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| startDate | 是 | string | 开始日期,yyyy-MM-dd,间隔不超过31天 |
| endDate | 是 | string | 结束日期 |
| length | 是 | int | 每页条数,小于2000 |
| page | 是 | int | 页码 |
| advertiserIds | 否 | array | 广告账号ID列表 |
| campaignIds | 否 | array | 广告活动ID列表 |
| objectiveType | 否 | array | REACH/TRAFFIC/VIDEO_VIEWS/LEAD_GENERATION/ENGAGEMENT/APP_PROMOTION/WEB_CONVERSIONS/PRODUCT_SALES |
| status | 否 | array | STATUS_ENABLE/STATUS_DISABLE 等 |
| summaryCurrency | 否 | string | 汇总币种 |
关键返回字段: campaignId, campaignName, spend, impressions, clicks, orders, revenue, roas, status
---
queryTiktokAdGroupList - 查询广告组
路径: /basicOpen/multiplatform/ads/queryTiktokAdGroupList 参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| startDate | 是 | string | 开始日期,yyyy-MM-dd,间隔不超过31天 |
| endDate | 是 | string | 结束日期 |
| length | 是 | int | 每页条数,小于2000 |
| page | 是 | int | 页码 |
| advertiserIds | 否 | array | 广告账号ID列表 |
| campaignIds | 否 | array | 广告活动ID列表 |
| status | 否 | array | STATUS_ENABLE/STATUS_DISABLE 等 |
| searchType | 否 | string | ad_group_name 等 |
关键返回字段: adGroupId, adGroupName, campaignId, spend, impressions, clicks, orders, roas
---
queryTiktokAdList - 查询广告
路径: /basicOpen/multiplatform/ads/queryTiktokAdList 参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| startDate | 是 | string | 开始日期,yyyy-MM-dd,间隔不超过31天 |
| endDate | 是 | string | 结束日期 |
| length | 是 | int | 每页条数,小于2000 |
| page | 是 | int | 页码 |
| advertiserIds | 否 | array | 广告账号ID列表 |
| campaignIds | 否 | array | 推广系列ID列表 |
| adgroupIds | 否 | array | 广告组ID列表 |
| adIds | 否 | array | 广告ID列表 |
关键返回字段: adId, adName, adGroupId, campaignId, spend, impressions, clicks, orders, roas, status
---
TikTok GMV Max
queryGmvStoreList - 查询 GMV MAX 店铺列表
路径: /basicOpen/multiplatform/ads/queryGmvStoreList 参数: 无必填参数
关键返回字段: advertiserId, storeId, storeName
---
queryGmvAdvertiserReportList - 查询 GMV MAX 广告账号报告
路径: /basicOpen/multiplatform/ads/queryGmvAdvertiserReportList 参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| startDate | 是 | string | 开始日期,yyyy-MM-dd,间隔不超过31天 |
| endDate | 是 | string | 结束日期 |
| length | 是 | int | 每页条数,小于2000 |
| page | 是 | int | 页码,从1开始 |
| advertiserIds | 否 | array | 广告账号ID列表 |
| gmvMaxPromotionTypeCodes | 否 | array | PRODUCT/LIVE |
| storeIds | 否 | array | 店铺ID列表 |
| summaryCurrency | 否 | string | 汇总币种,默认USD |
关键返回字段: subjectId, reportDate, cost, orders, roi, grossRevenue(唯一键:subjectId+reportDate)
---
queryGmvCampaignReportList - 查询 GMV MAX 推广系列报告
路径: /basicOpen/multiplatform/ads/queryGmvCampaignReportList 参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| startDate | 是 | string | 开始日期,yyyy-MM-dd,间隔不超过31天 |
| endDate | 是 | string | 结束日期 |
| length | 是 | int | 每页条数,小于2000 |
| page | 是 | int | 页码,从1开始 |
| advertiserIds | 否 | array | 广告账号ID列表 |
| campaignIds | 否 | array | 推广系列ID列表 |
| gmvMaxPromotionTypeCodes | 否 | array | PRODUCT/LIVE |
| status | 否 | array | ENABLE/DISABLE/DELETE |
关键返回字段: subjectId, campaignId, reportDate, cost, orders, roi(唯一键:subjectId+reportDate)
---
queryGmvItemGroupReportList - 查询 GMV MAX 广告商品报告
路径: /basicOpen/multiplatform/ads/queryGmvItemGroupReportList 参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| startDate | 是 | string | 开始日期,yyyy-MM-dd,间隔不超过31天 |
| endDate | 是 | string | 结束日期 |
| length | 是 | int | 每页条数,小于2000 |
| page | 是 | int | 页码 |
| advertiserIds | 否 | array | 广告账号ID列表 |
| itemGroupIds | 否 | array | 广告商品ID列表 |
| status | 否 | array | available/unavailable |
关键返回字段: subjectId, reportDate, grossRevenue, cost, orders, roi(唯一键:subjectId+reportDate)
---
沃尔玛广告 - SP 广告
queryCampaignSpList - 查询 SP 广告活动
路径: /basicOpen/multiplatform/ads/queryCampaignSpList 参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| advertiserIds | 是 | array | 广告账号ID列表 |
| campaignType | 是 | array | sponsoredProducts-manual/sponsoredProducts-auto(SP必须且只能用这两个) |
| day | 是 | int | 归因天数:3/14/30 |
| startDate | 是 | string | 开始日期,yyyy-MM-dd,间隔不超过31天 |
| endDate | 是 | string | 结束日期 |
| operationSourceType | 是 | string | openapi调用传 gateway |
| pageNum | 是 | int | 页码,从1开始 |
| pageSize | 是 | int | 每页大小,小于2000 |
| paging | 是 | boolean | openapi必填 true |
| campaignIds | 否 | array | 广告活动ID列表 |
| status | 否 | array | enabled/paused/live/completed 等 |
关键返回字段: campaignId, campaignName, adSpend, numAdsShown, numAdsClicks, attributedSales, attributedOrders, acos, roas, cpc, ctr, status
---
queryGroupSpList - 查询 SP 广告组
路径: /basicOpen/multiplatform/ads/queryGroupSpList 参数: 同 queryCampaignSpList(campaignIds 改为可选筛选项)
关键返回字段: adGroupId, adGroupName, campaignId, adSpend, attributedSales, acos, roas, status
---
queryPageTypeSPList - 查询 SP 广告页面类型
路径: /basicOpen/multiplatform/ads/queryPageTypeSPList 参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| startDate | 否 | string | 开始日期,yyyy-MM-dd |
| endDate | 否 | string | 结束日期 |
| advertiserIds | 否 | array | 广告账号ID列表 |
| campaignType | 否 | array | 广告类型列表 |
| campaignIds | 否 | array | 广告活动ID列表 |
| day | 否 | int | 归因天数 |
| pageNum | 否 | int | 页码 |
| pageSize | 否 | int | 每页大小 |
关键返回字段: pageType, adSpend, numAdsShown, numAdsClicks, attributedSales, acos, roas
---
reportAdItemSpList - 查询 SP 广告
路径: /basicOpen/multiplatform/ads/reportAdItemSpList 参数: 与 queryCampaignSpList 相同必填参数,另可加 adGroupIds 筛选
关键返回字段: adId, adGroupId, campaignId, adSpend, attributedSales, acos, roas, status
---
reportKeywordSpList - 查询 SP 关键词
路径: /basicOpen/multiplatform/ads/reportKeywordSpList 参数: 与 queryCampaignSpList 相同必填参数
关键返回字段: keywordId, keywordText, matchType, adGroupId, adSpend, attributedSales, acos, roas
---
reportPlatformSpList - 查询 SP 平台
路径: /basicOpen/multiplatform/ads/reportPlatformSpList 参数: 与 queryCampaignSpList 相同必填参数
关键返回字段: platform, adSpend, numAdsShown, numAdsClicks, attributedSales, acos, roas
---
沃尔玛广告 - SB 广告
reportCampaignSbList - 查询 SB 广告活动
路径: /basicOpen/multiplatform/ads/reportCampaignSbList 参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| advertiserIds | 是 | array | 广告账号ID列表 |
| campaignType | 是 | array | ["sba"](SB必须且只能用sba) |
| startDate | 是 | string | 开始日期,yyyy-MM-dd |
| endDate | 是 | string | 结束日期 |
| campaignIds | 否 | array | 广告活动ID列表 |
| day | 否 | int | 归因天数,默认14 |
| pageNum | 否 | int | 页码 |
| pageSize | 否 | int | 每页大小,最大200 |
关键返回字段: campaignId, campaignName, adSpend, attributedSales, acos, roas, ntbOrders, ntbRevenue, status
---
reportAdGroupSbList - 查询 SB 广告组
路径: /basicOpen/multiplatform/ads/reportAdGroupSbList 参数: 与 reportCampaignSbList 相同必填参数,加 campaignIds 筛选
关键返回字段: adGroupId, adGroupName, campaignId, adSpend, attributedSales, acos, roas
---
reportAdItemSbList - 查询 SB 广告
路径: /basicOpen/multiplatform/ads/reportAdItemSbList 参数: 与 reportAdGroupSbList 相同,加 adGroupIds 筛选
关键返回字段: adId, adGroupId, campaignId, adSpend, attributedSales, acos, roas
---
reportKeywordSbList - 查询 SB 关键词
路径: /basicOpen/multiplatform/ads/reportKeywordSbList 参数: 与 reportCampaignSbList 相同必填参数
关键返回字段: keywordText, matchType, adSpend, attributedSales, acos, roas
---
reportPageTypeSbList - 查询 SB 页面类型
路径: /basicOpen/multiplatform/ads/reportPageTypeSbList 参数: 与 reportCampaignSbList 相同必填参数
关键返回字段: pageType, adSpend, attributedSales, acos, roas
---
reportPlatformSbList - 查询 SB 平台
路径: /basicOpen/multiplatform/ads/reportPlatformSbList 参数: 与 reportCampaignSbList 相同必填参数
关键返回字段: platform, adSpend, attributedSales, acos, roas
---
沃尔玛广告 - SV 广告
queryAdGroupSvList - 查询 SV 广告组
路径: /basicOpen/multiplatform/ads/queryAdGroupSvList 参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| advertiserIds | 是 | array | 广告账号ID列表 |
| campaignType | 是 | array | ["video"](SV必须且只能用video) |
| dateKey | 是 | string | day/week/month |
| startDate | 是 | string | 开始日期,yyyy-MM-dd |
| endDate | 是 | string | 结束日期 |
| campaignIds | 否 | array | 广告活动ID列表 |
| status | 否 | array | enabled/disabled/delete |
| pageNum | 否 | int | 页码,从1开始 |
| pageSize | 否 | int | 每页大小 |
关键返回字段: adGroupId, adGroupName, campaignId, adSpend, numAdsShown, numAdsClicks, attributedSales, acos, roas, status
---
queryReportPageTypeSvList - 查询 SV 页面类型
路径: /basicOpen/multiplatform/ads/queryReportPageTypeSvList 参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| advertiserIds | 是 | array | 广告账号ID列表 |
| campaignType | 是 | array | ["video"] |
| startDate | 是 | string | 开始日期,yyyy-MM-dd |
| endDate | 是 | string | 结束日期 |
| pageType | 否 | array | browse/item/search/topic/category/homepage/other |
| day | 否 | int | 归因天数,默认14 |
关键返回字段: pageType, adSpend, numAdsShown, numAdsClicks, attributedSales, acos, roas
---
reportAdItemSvList - 查询 SV 广告
路径: /basicOpen/multiplatform/ads/reportAdItemSvList 参数: advertiserIds(是), campaignType="video", startDate(是), endDate(是),其他选填
关键返回字段: adId, adGroupId, campaignId, adSpend, attributedSales, acos, roas
---
reportCampaignSvList - 查询 SV 广告活动
路径: /basicOpen/multiplatform/ads/reportCampaignSvList 参数: advertiserIds(是), campaignType="video", startDate(是), endDate(是),其他选填
关键返回字段: campaignId, campaignName, adSpend, attributedSales, acos, roas, status
---
reportKeywordSvList - 查询 SV 关键词
路径: /basicOpen/multiplatform/ads/reportKeywordSvList 参数: advertiserIds(是), campaignType="video", startDate(是), endDate(是)
关键返回字段: keywordText, matchType, adSpend, attributedSales, acos, roas
---
reportPlatformSvList - 查询 SV 平台
路径: /basicOpen/multiplatform/ads/reportPlatformSvList 参数: advertiserIds(是), campaignType="video", startDate(是), endDate(是)
关键返回字段: platform, adSpend, attributedSales, acos, roas
---
reportSearchTrendsList - 查询搜索趋势
路径: /basicOpen/multiplatform/ads/reportSearchTrendsList 参数: advertiserIds(是), startDate(是), endDate(是),其他选填
关键返回字段: searchTerm, impressions, clicks, adSpend, reportDate
---
领星多平台 V2 接口参考
所有接口均为 POST 请求,域名:https://openapi.lingxing.com
---
MultiPlatOrderV2 - 查询订单管理订单列表
路径: /pb/mp/order/v2/list 参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| offset | 是 | int | 分页偏移量 |
| length | 是 | int | 分页长度,上限500 |
| date_type | 否* | string | update_time/global_purchase_time/global_delivery_time/global_payment_time/delivery_time(仅按平台单号查时可不传) |
| start_time | 否* | int | 开始时间戳(秒),查询跨度不超过31天 |
| end_time | 否* | int | 结束时间戳(秒) |
| store_id | 否 | array | 多平台店铺ID |
| platform_code | 否 | array | 平台code(10001=Amazon,10002=Shopify,10003=eBay,10008=Walmart,10011=TikTok,10021=SHEIN,10022=Temu全托管,10024=Temu半托管 等) |
| platform_order_nos | 否 | array | 平台单号列表,上限200(eBay/Newegg/Coupang/Shopify/Mercado/Shopline 除外) |
| platform_order_names | 否 | array | 特定平台单号(eBay/Newegg/Coupang/Shopify/Mercado/Shopline 用此字段) |
| order_status | 否 | int | 1=同步中,2=已同步,3=待付款,4=待审核,5=待发货,6=已发货,7=已取消,8=不显示,9=平台发货 |
| include_delete | 否 | boolean | 是否包含已删除订单 |
关键返回字段: platform_code, store_id, platform_order_no, order_status, purchase_time, payment_time, delivery_time, buyer_name, shipping_address, items[msku/sku/quantity/price], freight_amount
---
StoreInfoV2 - 查询多平台店铺信息
路径: /pb/mp/shop/v2/getSellerList 参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| platform_code | 否 | array | 平台code列表 |
| is_sync | 否 | int | 1=启用,0=停用 |
| status | 否 | int | 1=正常授权,0=授权失败 |
| offset | 否 | int | 分页偏移量 |
| length | 否 | int | 分页长度,上限200 |
关键返回字段: store_id, sid, store_name, platform_code, platform_name, currency, is_sync
---
PairListV2 - 查询多平台配对列表
路径: /pb/mp/listing/v2/getPairList 参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| msku | 否 | array | MSKU列表 |
| sku | 否 | array | 本地SKU列表 |
| store_ids | 否 | array | 店铺ID列表 |
| platform_codes | 否 | array | 平台code列表 |
| start_time | 否 | string | 操作开始时间 |
| end_time | 否 | string | 操作结束时间 |
| use_cursor | 否 | boolean | 使用分页游标(数据多时推荐) |
| cursor_id | 否 | boolean | 游标ID(use_cursor=true时必填) |
| offset | 否 | int | 分页偏移量 |
| length | 否 | int | 分页条数 |
关键返回字段: msku, sku, store_id, platform_code, pair_time
---
QueryShippingListV2 - 查询平台仓发货单列表 v2
路径: /basicOpen/multiplatform/query/shippingList 参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| platformCodes | 是 | array | 10008=Walmart,10011=TikTok,10022=Temu,10027=Shein |
| timeField | 否 | int | 1=创建时间,2=发货时间,3=开船时间,4=预计到港,5=实际妥投,6=实际发货 |
| startTime | 否 | string | 开始时间,Y-m-d |
| endTime | 否 | string | 结束时间,Y-m-d |
| shippingListStatus | 否 | int | 0=待配货,1=待发货,2=已发货,3=已作废 |
| pickingStatus | 否 | string | 1=已拣货,0=待拣货 |
| searchField | 否 | int | 1=MSKU,2=发货单号,7=货件单号,8=商品条码 |
| searchSingleValue | 否 | string | 模糊搜索值 |
| storeIds | 否 | array | 店铺ID列表 |
| offset | 否 | int | 分页偏移量 |
| length | 否 | int | 分页长度 |
关键返回字段: 发货单列表(发货单号、状态、货件、商品明细)
---
QueryShippingListPage - 查询平台仓发货单列表(Walmart 旧版)
路径: /cepf/warehouse/api/openApi/queryShippingListPage 参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| store_id | 否 | array | 店铺ID |
| shipping_list_codes | 否 | array | 发货单编号,上限100 |
| cargo_code | 否 | string | 货件单号 |
| shipping_list_status | 否 | int | 0=待配货,1=待发货,2=已发货,3=已作废 |
| start_time | 否 | string | 创建开始时间,Y-m-d |
| end_time | 否 | string | 创建结束时间,Y-m-d |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 分页长度,默认15,上限200 |
关键返回字段: 发货单列表(仅支持Walmart,建议改用 QueryShippingListV2)
---
QueryWFSCargoPage - 查询 WFS 货件列表
路径: /cepf/warehouse/api/openApi/queryWFSCargoPage 参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| store_id | 否 | array | 店铺ID |
| cargo_status_list | 否 | array | 0=PENDING_SHIPMENT_DETAILS,1=AWAITING_DELIVERY,2=RECEIVING_IN_PROGRESS,3=CLOSED,4=CANCELLED |
| inbound_order_id | 否 | string | 入库订单编号 |
| start_time | 否 | string | 创建开始时间,Y-m-d |
| end_time | 否 | string | 创建结束时间,Y-m-d |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 分页长度,默认15,上限200 |
关键返回字段: 货件列表(货件号、状态、入库数量、商品明细)
---
QueryWFSInventionPage - 查询 WFS 库存列表
路径: /cepf/warehouse/api/openApi/queryWFSInventionPage 参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| store_id | 是 | array | 店铺ID |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 分页长度,默认15,上限200 |
关键返回字段: records[item_id, gtin, available_quantity, inbound_quantity, platform_product_status, ats03_months, ats36_months, ats69_months, ats912_months, ats1_years, last30_days_po_units]
---
AliexpressListV2 - 查询 AliExpress 在线商品(托管模式)
路径: /basicOpen/multiplatform/aliexpress/list/v2 参数: offset, length(分页);store_id(店铺筛选)等
关键返回字段: 商品列表(product_id, msku, title, price, status, inventory)
---
aliexpressList - 查询 AliExpress 在线商品(自运营)
路径: /basicOpen/multiplatform/aliExpress/list 参数: offset, length(分页);store_id, msku 等
关键返回字段: item_id, msku, status, price, title
---
eBayList - 查询 eBay 在线商品列表
路径: /basicOpen/multiplatform/ebay/list 参数: offset, length(分页);store_id 等
关键返回字段: msku, listing_status, site_name, accept_price, product_auto_restock_response
---
walmartList - 查询 Walmart 在线商品
路径: /basicOpen/multiplatform/walmart/list 参数: offset, length(分页);store_id 等
关键返回字段: title, store_name, fulfillment_type_name, buy_box_shipping_price, quantityAdjustBefore, offer_end_date
---
TemuList - 查询 Temu 在线商品
路径: /basicOpen/multiplatform/temu/list 参数: offset, length(分页);store_id 等
关键返回字段: mskuId, title, principalName, usableInventory, attribute, wareHouseDataList
---
TemuCargo - 查询 Temu 货件
路径: /basicOpen/multiplatform/temu/cargo 参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| startTime | 是 | string | 开始时间 |
| offset/length | 否 | int | 分页 |
关键返回字段: cargoGoodListResponses[mskuCargo/purchaseOrderSn/sku], deliverPackageNum, deliveryAddress
---
TikTokList - 查询 TikTok 在线商品
路径: /basicOpen/multiplatform/tiktok/list 参数: offset, length(分页);store_id 等
关键返回字段: id, storeId, pname, usableInventory, currency
---
SheinList - 查询 Shein 在线商品
路径: /basicOpen/multiplatform/shein/list 参数: offset, length(分页);store_id 等
关键返回字段: mskuId, title, principalName, status, wareHouseDataList, attribute
---
ShopifyVariantList - 查询 Shopify 在线商品
路径: /basicOpen/multiplatform/shopify/variantList 参数: offset, length(分页);store_id 等
关键返回字段: title, store_name, weight, listing_start_time, location_infos
---
CoupangStockList - 查询 Coupang 库存
路径: /basicOpen/multiplatform/coupang/stockSearch 参数: offset, length(分页);store_id 等
关键返回字段: stockPage[records[storeName, ...]]
---
FbsStockList - 查询 FBS 库存
路径: /basicOpen/multiplatform/fbs/stockSearch 参数: offset, length(分页);store_id 等
关键返回字段: records[shopSkuId, whsId, irApprovalQty, last60Sold, notMovingTag, gmtCreate]
---
FbtStockList - 查询 FBT 库存
路径: /basicOpen/multiplatform/fbt/stockSearch/v2 参数: offset, length(分页);store_id 等
关键返回字段: page[records[goodReferenceCode, totalInventoryQuantity, ...]]
---
FbtStockSearch - 查询 Temu 库存
路径: /basicOpen/multiplatform/fbt/stockSearch 参数: offset, length(分页);store_id 等
关键返回字段: list[mskuList[msku], quantity, adviceQuantity, inventorySaleDays, warehouseInventoryNum, todaySaleVolume]
---
FullList - 查询 FULL 库存
路径: /basicOpen/multiplatform/full/stockSearch 参数: offset, length(分页);store_id 等
关键返回字段: 库存记录列表
---
WayfairStockList - 查询 Wayfair 库存
路径: /basicOpen/multiplatform/wayfair/stockSearch 参数: offset, length(分页);store_id 等
关键返回字段: page[records[supplierPartNumber, heldQty, options, ...], total]
---
LineList - 查询 Line 在线商品
路径: /basicOpen/multiplatform/line/list 参数: offset, length(分页);store_id 等
关键返回字段: list[bid, imgUrl, children[id/pid/productUniqueId/storeName/availableNumber]]
---
addCargoGoodsList - 查询 WFS 货件可添加商品列表
路径: /basicOpen/multiplatform/cargo/addCargoGoods/list 参数: store_id 等
关键返回字段: item_id 等商品信息
---
WalmartPaymentQueryPage - 查询报告详情(Walmart Payment)
路径: /cepf/fms/openapi/walmartPayment/queryPage 参数: store_id, report_date, offset, length 等
关键返回字段: records[transaction_key, partner_gtin, product_type, commission_rule, ship_to_zipcode, ...]
---
WalmartPaymentQueryReport - 查询可用报告列表(Walmart Payment)
路径: /cepf/fms/openapi/walmartPayment/queryReport 参数: store_id 等
关键返回字段: list[report_date, ...]
---
WalmartCommentList - 查询 Walmart Review 列表
路径: /basicOpen/multiplatform/walmart/queryCommentList 参数: store_id, start_date, end_date, offset, length 等
关键返回字段: records[commentTitle, productMsku, storeName, title, ...], current, total
---
profitReportMsku - 查询结算利润报表(MSKU 维度)
路径: /basicOpen/multiplatform/profit/report/msku 参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| startDate | 是 | string | 开始结算日期,Y-m-d |
| endDate | 是 | string | 结束结算日期,Y-m-d |
| offset | 是 | int | 分页偏移量,默认0 |
| length | 是 | int | 分页长度,默认1000 |
| platformCodeS | 否 | array | 平台code列表 |
| sids | 否 | string | 店铺ID,逗号分隔 |
| mids | 否 | string | 国家ID,逗号分隔 |
| currencyCode | 否 | string | 原币种/USD/EUR/GBP/CNY |
| searchField | 否 | string | msku/local_sku/platform_order_no |
| searchValue | 否 | string | 搜索值 |
关键返回字段: totalSum[salesNum, refundNum, buyerFreightAmount, platformLogisticsAmount, platformFineAmount, currencyIcon],列表明细
---
profitReportOrder - 查询结算利润报表(订单维度)
路径: /basicOpen/multiplatform/profit/report/order 参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| startDate | 是 | string | 开始结算日期,Y-m-d |
| endDate | 是 | string | 结束结算日期,Y-m-d |
| offset | 是 | int | 分页偏移量,默认0 |
| length | 是 | int | 分页长度,默认200 |
| searchDateType | 否 | int | 1=下单时间,2=结算日期(默认),3=发货日期 |
| transactionTypeS | 否 | array | 0=销售,2=退货,4=退款,5=补发,6=调整,7=其他 |
| platformCodeS | 否 | array | 平台code列表 |
| currencyCode | 否 | string | 汇率币种 |
关键返回字段: totalSum[salesNum, refundRate, platformOtherIncomeAmount, promotionExtendAmount],订单明细列表
---
profitReportSeller - 查询结算利润报表(店铺维度)
路径: /basicOpen/multiplatform/profit/report/seller 参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| startDate | 是 | string | 开始结算日期,Y-m-d |
| endDate | 是 | string | 结束结算日期,Y-m-d |
| offset | 是 | int | 分页偏移量,默认0 |
| length | 是 | int | 分页长度,默认1000 |
| platformCodeS | 否 | array | 平台code列表 |
| sids | 否 | string | 店铺ID,逗号分隔 |
| currencyCode | 否 | string | 汇率币种 |
关键返回字段: totalSum[buyerFreightAmount, refundNum, platformLogisticsAmount, platformFineAmount, currencyIcon],店铺维度明细
---
profitReportSku - 查询结算利润报表(SKU 维度)
路径: /basicOpen/multiplatform/profit/report/sku 参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| startDate | 是 | string | 开始结算日期,Y-m-d |
| endDate | 是 | string | 结束结算日期,Y-m-d |
| mids | 是 | string | 国家ID,逗号分隔 |
| offset | 是 | int | 分页偏移量,默认0 |
| length | 是 | int | 分页长度,默认1000 |
| platformCodeS | 否 | array | 平台code列表 |
| currencyCode | 否 | string | 汇率币种 |
关键返回字段: totalSum[buyerFreightAmount, refundNum, platformLogisticsAmount, currencyIcon],SKU 维度明细
---
newPlatformOrderList - 查询平台订单列表(新)
路径: /cepfPlatformOrder/open-api/newPlatformOrder/list 参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| dateType | 是 | int | 0=平台数据变动时间,1=订购时间,2=订购时间(北京),3=支付时间,4=支付时间(北京),5=发货时间 |
| platformCodeList | 否 | array | 平台code(支持TikTok/Temu半托管/Line/Lazada/Shopee/Shopify等) |
| deliveryTypeList | 否 | array | 0=自发货,1=平台发货,2=部分自发货 |
| searchType | 否 | int | 1=sku,2=品名,3=msku,4=商品id,5=平台单号,6=参考号,7=商品标题 |
| searchSingleValue | 否 | string | 模糊搜索值 |
| searchMultiValue | 否 | array | 精确搜索值列表 |
| siteCodeList | 否 | array | 站点列表 |
| pageNum | 否 | int | 页码 |
| pageSize | 否 | int | 每页大小 |
关键返回字段: 订单列表(平台单号、状态、购买时间、配送信息、商品明细)
---
addressReturnAddressList - 查询退件地址列表
路径: /basicOpen/multiplatform/address/returnAddressList 参数: 无必填(可按 store_id 等筛选)
关键返回字段: mobile, street_detail 等退件地址信息
---
领星新广告-报告接口参考
所有接口均为 POST 请求,请求域名:https://openapi.lingxing.com
通用请求头
| 标签 | 必填 | 说明 |
|---|---|---|
| X-API-VERSION | 是 | 固定传 2(offset 为偏移量,从0开始) |
通用参数规律
sid或profile_id二选一必填(部分接口仅需其中一个)report_date:报告日期,格式Y-m-d,多数报表类接口必填offset:分页偏移量,从 0 开始,默认 0length:每页条数,默认 15,建议传 100
---
SP 广告报表
spCampaignReports - SP广告活动报表
路径: /pb/openapi/newad/spCampaignReports 参数:
| 参数 | 必填 | 说明 |
|---|---|---|
| sid | 是* | 店铺ID |
| profile_id | 是* | 广告账号ID(与sid二选一) |
| report_date | 是 | 报告日期 Y-m-d |
| show_detail | 否 | 1=返回1d/7d/14d/30d归因期数据 |
| offset | 否 | 分页偏移量 |
| length | 否 | 每页条数 |
关键返回字段: targeting_type, impressions, clicks, cost, same_orders, orders, same_sales, sales, units, same_units, campaign_id, profile_id, report_date
---
campaignPlacementReports - SP广告位报告
路径: /pb/openapi/newad/campaignPlacementReports 参数: 与 spCampaignReports 相同 关键返回字段: placement(广告位),impressions, clicks, cost, orders, sales, units, campaign_id
---
spAdGroupReports - SP广告组报表
路径: /pb/openapi/newad/spAdGroupReports 参数: 与 spCampaignReports 相同 关键返回字段: ad_group_id, campaign_id, impressions, clicks, cost, orders, sales, units
---
spProductAdReports - SP广告商品报表
路径: /pb/openapi/newad/spProductAdReports 参数: 与 spCampaignReports 相同,新增可选 ad_group_id 关键返回字段: ad_id, asin, sku, ad_group_id, campaign_id, impressions, clicks, cost, orders, sales, units
---
spKeywordReports - SP关键词报表
路径: /pb/openapi/newad/spKeywordReports 参数: 与 spCampaignReports 相同 关键返回字段: keyword_id, keyword_text, match_type, ad_group_id, campaign_id, impressions, clicks, cost, orders, sales
---
spTargetReports - SP商品定位报表
路径: /pb/openapi/newad/spTargetReports 参数: 与 spCampaignReports 相同 关键返回字段: target_id, targeting_expression, targeting_type, ad_group_id, campaign_id, impressions, clicks, cost, orders, sales
---
asinReports - SP已购买商品报表
路径: /pb/openapi/newad/asinReports 参数: sid/profile_id, report_date, offset, length 关键返回字段: asin, other_asin, campaign_id, ad_group_id, impressions, clicks, purchases_1d/7d/14d/30d, sales_1d/7d/14d/30d
---
queryWordReports - SP用户搜索词报表
路径: /pb/openapi/newad/queryWordReports 参数: 与 spCampaignReports 相同 关键返回字段: query, keyword_id, targeting_id, match_type, impressions, clicks, cost, orders, sales, units
---
SB 广告报表
hsaCampaignReports - SB广告活动报表
路径: /pb/openapi/newad/hsaCampaignReports 参数: sid/profile_id, report_date, offset, length 关键返回字段: campaign_id, impressions, clicks, cost, attributedOrdersNewToBrand14d, attributedSales14d
---
hsaCampaignPlacementReports - SB广告活动-广告位报告
路径: /pb/openapi/newad/hsaCampaignPlacementReports 参数: sid/profile_id, report_date, offset, length 关键返回字段: placement, campaign_id, impressions, clicks, cost, dpv, orders, sales
---
hsaAdGroupReports - SB广告组报表
路径: /pb/openapi/newad/hsaAdGroupReports 参数: sid/profile_id, report_date, offset, length 关键返回字段: ad_group_id, campaign_id, impressions, clicks, cost
---
listHsaTargetingReport - SB广告的投放报告
路径: /pb/openapi/newad/listHsaTargetingReport 参数: sid/profile_id, report_date, offset, length 关键返回字段: keyword_id/target_id, keyword_text, match_type, campaign_id, impressions, clicks, cost, dpv, orders, sales
---
hsaQueryWordReports - SB用户搜索词报表
路径: /pb/openapi/newad/hsaQueryWordReports 参数: 与 spCampaignReports 相同 关键返回字段: query, impressions, clicks, cost, orders_14d, sales_14d
---
hsaPurchasedAsinReports - SB广告归因于广告的购买报告
路径: /pb/openapi/newad/hsaPurchasedAsinReports 参数: sid/profile_id, report_date, offset, length 关键返回字段: asin, promoted_asin, campaign_id, purchases_14d, sales_14d, units_14d
---
listHsaProductAdReport - SB广告创意报告
路径: /pb/openapi/newad/listHsaProductAdReport 参数: sid/profile_id, report_date, offset, length 关键返回字段: ad_id, asin, ad_group_id, campaign_id, impressions, clicks, cost, orders_14d, sales_14d
---
listHsaKeywordPlacementReport - SB关键词-广告位报告
路径: /pb/openapi/newad/listHsaKeywordPlacementReport 参数: sid/profile_id, report_date, offset, length 关键返回字段: keyword_id, placement, campaign_id, impressions, clicks, cost
---
SD 广告报表
sdCampaignReports - SD广告活动报表
路径: /pb/openapi/newad/sdCampaignReports 参数: sid/profile_id, report_date, tactic(可选,T00001/T00002/T00003), offset, length 关键返回字段: campaign_id, tactic, impressions, clicks, cost, orders, sales, view_impressions
---
sdAdGroupReports - SD广告组报表
路径: /pb/openapi/newad/sdAdGroupReports 参数: 与 sdCampaignReports 相同 关键返回字段: ad_group_id, campaign_id, tactic, impressions, clicks, cost, orders, sales
---
sdProductAdReports - SD广告商品报表
路径: /pb/openapi/newad/sdProductAdReports 参数: 与 sdCampaignReports 相同 关键返回字段: ad_id, asin, sku, ad_group_id, campaign_id, impressions, clicks, cost, orders, sales
---
sdTargetReports - SD商品定位报表
路径: /pb/openapi/newad/sdTargetReports 参数: sid/profile_id, report_date, offset, length 关键返回字段: target_id, ad_group_id, campaign_id, impressions, clicks, cost, orders, sales
---
sdAsinReports - SD已购买商品报表
路径: /pb/openapi/newad/sdAsinReports 参数: sid/profile_id, report_date, tactic, offset, length 关键返回字段: asin, promoted_asin, other_asin, campaign_id, purchases_1d/7d/14d/30d
---
sdMatchTargetReports - SD匹配的目标报表
路径: /pb/openapi/newad/sdMatchTargetReports 参数: 与 sdCampaignReports 相同 关键返回字段: targeting_expression, targeting_type, targeting_text, target_id, ad_group_id, campaign_id
---
小时数据接口(SP/SB/SD)
所有小时数据接口参数格式一致:
| 参数 | 必填 | 说明 |
|---|---|---|
| sid 或 profile_id | 是* | 店铺ID或广告账号ID |
| report_date | 是 | 报告日期 Y-m-d |
| offset | 否 | 分页偏移量 |
| length | 否 | 每页条数 |
| 接口名 | 路径 | 说明 |
|---|---|---|
| spCampaignHourData | /pb/openapi/newad/spCampaignHourData | SP广告活动小时数据 |
| spAdPlacementHourData | /pb/openapi/newad/spAdPlacementHourData | SP广告位小时数据 |
| spAdGroupHourData | /pb/openapi/newad/spAdGroupHourData | SP广告组小时数据 |
| spAdvertiseHourData | /pb/openapi/newad/spAdvertiseHourData | SP广告小时数据 |
| spTargetHourData | /pb/openapi/newad/spTargetHourData | SP投放小时数据 |
| sbCampaignHourData | /pb/openapi/newad/sbCampaignHourData | SB广告活动小时数据 |
| sbAdGroupHourData | /pb/openapi/newad/sbAdGroupHourData | SB广告组小时数据 |
| sbTargetHourData | /pb/openapi/newad/sbTargetHourData | SB投放小时数据 |
| sbAdPlacementHourData | /pb/openapi/newad/sbAdPlacementHourData | SB广告位小时数据 |
| sdCampaignHourData | /pb/openapi/newad/sdCampaignHourData | SD广告活动小时数据 |
| sdAdGroupHourData | /pb/openapi/newad/sdAdGroupHourData | SD广告组小时数据 |
| sdAdvertiseHourData | /pb/openapi/newad/sdAdvertiseHourData | SD广告小时数据 |
| sdTargetHourData | /pb/openapi/newad/sdTargetHourData | SD投放小时数据 |
小时数据关键返回字段: hour(0-23的小时段),加各指标数据
---
其他接口
dspReportOrderList - 查询DSP报告列表-订单
路径: /basicOpen/dspReport/order/list 参数:
| 参数 | 必填 | 说明 |
|---|---|---|
| profile_id | 是 | DSP广告账号ID(仅支持profile_id,不支持sid) |
| start_date | 是 | 开始日期 Y-m-d |
| end_date | 是 | 结束日期 Y-m-d |
| offset | 否 | 分页偏移量 |
| length | 否 | 每页条数(默认20) |
---
ProductAnalysisList - 出单时段分析-产品
路径: /basicOpen/adReport/productOrderAnalysis/list 参数:
| 参数 | 必填 | 说明 |
|---|---|---|
| sid 或 profile_id | 是* | 店铺ID或广告账号ID |
| start_date | 是 | 开始日期 Y-m-d |
| end_date | 是 | 结束日期 Y-m-d |
| msku | 否 | MSKU 筛选 |
| asin | 否 | ASIN 筛选 |
| offset | 否 | 分页偏移量 |
| length | 否 | 每页条数 |
---
通用返回结构
{
"code": 0,
"message": "操作成功",
"error_details": [],
"request_id": "xxx",
"response_time": "2024-01-01 12:00:00",
"total": 100,
"data": [...]
}code=0 为成功,其他为失败。
领星产品接口参考
所有接口均为 POST 请求(除标注 GET 外),域名:https://openapi.lingxing.com
---
ProductLists - 查询本地产品列表
路径: /erp/sc/routing/data/local_inventory/productList 方法: POST
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 分页长度,默认/上限1000 |
| update_time_start | 否 | int | 更新时间开始(时间戳秒,左闭右开) |
| update_time_end | 否 | int | 更新时间结束(时间戳秒) |
| create_time_start | 否 | int | 创建时间开始(时间戳秒) |
| create_time_end | 否 | int | 创建时间结束(时间戳秒) |
| sku_list | 否 | array | 本地产品SKU列表 |
| sku_identifier_list | 否 | array | SKU识别码列表 |
关键返回字段: id, sku, sku_identifier, product_name, pic_url, ps_id, spu, bid, cid, brand_name, category_name, status(0停售/1在售/2开发中/3清仓), is_combo, cg_price, open_status, global_tags, create_time, update_time
---
ProductDetails - 查询本地产品详情
路径: /erp/sc/routing/data/local_inventory/productInfo 方法: POST
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| id | 否 | int | 产品id(三选一必填) |
| sku | 否 | string | 产品SKU(三选一必填) |
| sku_identifier | 否 | string | SKU识别码(三选一必填) |
关键返回字段: id, sku, product_name, pic_url, status, cid, bid, brand_name, category_name, cg_price, cg_delivery, special_attr, attachment_id, supplier_quote, combo_product_list, product_logistics_relation, declaration, clearance, aux_relation_list
---
Brand - 查询产品品牌列表
路径: /erp/sc/data/local_inventory/brand 方法: POST
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 分页长度,默认/上限1000 |
关键返回字段: bid, title(品牌名称), brand_code
---
Category - 查询产品分类列表
路径: /erp/sc/routing/data/local_inventory/category 方法: POST
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 分页长度,默认/上限1000 |
| ids | 否 | array | 分类ID列表 |
关键返回字段: cid, title(分类名称), parent_cid, category_code
---
UpcList - 获取UPC编码列表
路径: /listing/publish/api/upc/upcList 方法: POST
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 分页长度,默认20 |
关键返回字段: data>>total, data>>list>>id, data>>list>>commodity_code, data>>list>>code_type, data>>list>>is_used(0未使用/1已使用), data>>list>>use_time, data>>list>>gmt_create
---
GetProductTag - 查询产品标签
路径: /label/operation/v1/label/product/list 方法: GET(无请求参数)
关键返回字段: data>>list>>label_id, data>>list>>label_name, data>>list>>gmt_created, data>>total
---
GetPagingLogLists - 查询产品操作日志
路径: /basicOpen/product/getPagingLogLists 方法: POST
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| businessId | 是 | long | 产品id(对应ProductLists的data>>id) |
| startTime | 是 | string | 开始时间 |
| endTime | 是 | string | 结束时间 |
| page | 否 | int | 页码,默认1 |
| size | 否 | int | 每页大小,默认20 |
关键返回字段: data>>action, data>>datetime, data>>detail, data>>userId, data>>userName
---
attributeList - 查询产品属性列表
路径: /erp/sc/routing/storage/attribute/attributeList 方法: POST
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| offset | 是 | int | 分页偏移量 |
| length | 是 | int | 分页长度,上限200 |
关键返回字段: data>>total, data>>list>>pa_id, data>>list>>attr_name, data>>list>>create_time, data>>list>>item_list>>pai_id, data>>list>>item_list>>attr_value
---
batchGetProductInfo - 批量查询本地产品详情
路径: /erp/sc/routing/data/local_inventory/batchGetProductInfo 方法: POST
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| productIds | 否 | array | 产品id列表,上限100(三选一必填) |
| skus | 否 | array | 产品SKU列表,上限100(三选一必填) |
| sku_identifiers | 否 | array | SKU识别码列表,上限100(三选一必填) |
关键返回字段: 与 ProductDetails 相同,返回数组
---
bundledProductList - 查询捆绑产品关系列表
路径: /erp/sc/routing/data/local_inventory/bundledProductList 方法: POST
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 分页长度,默认/上限1000 |
关键返回字段: id, sku, product_name, cg_price, status_text, bundled_products>>productId, bundled_products>>sku, bundled_products>>bundledQty, bundled_products>>cost_ratio
---
getTransparencyProductList - 查询透明计划商品列表
路径: /basicOpen/product/getTransparencyProductList 方法: POST
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 分页长度,默认20,最大200 |
| isRelateMsku | 否 | int | 是否关联MSKU:1是/2否 |
| productStatus | 否 | string | 产品状态:all/Enrolled/In OPR/Protected/NoStatus |
| searchField | 否 | string | 搜索字段名(如asin) |
| searchValue | 否 | string | 搜索值 |
关键返回字段: data>>pageList>>id, asin, sellerSku, brandName, productStatus, gtin, labelType, tcodeTotal, tcodeNotUsedTotal, accountName, picUrl, data>>total
---
productAuxList - 查询产品辅料列表
路径: /erp/sc/routing/data/local_inventory/productAuxList 方法: POST
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 分页长度,默认/上限1000 |
关键返回字段: id, sku, product_name, cg_price, cg_product_length/width/height/net_weight, purchase_supplier_quote, aux_relation_product>>pid/sku/quantity
---
spuInfo - 查询多属性产品详情
路径: /erp/sc/routing/storage/spu/info 方法: POST
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| ps_id | 否 | int | SPU唯一id(与spu二选一必填) |
| spu | 否 | string | SPU编码(与ps_id二选一必填) |
关键返回字段: ps_id, spu, spu_name, status, cid, bid, brand_name, category_name, purchase_info, sku_list>>sku/product_name/attribute, aux_relation_list, logistics, attribute_skc_list
---
spuList - 查询多属性产品列表
路径: /erp/sc/routing/storage/spu/spuList 方法: POST
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 分页长度,默认1000,上限1000 |
| update_time_start | 否 | int | 更新时间开始(时间戳秒) |
| update_time_end | 否 | int | 更新时间结束(时间戳秒) |
| spu_list | 否 | array | SPU列表 |
关键返回字段: ps_id, spu, spu_name, status, cid, bid, brand_name, category_name, sku_count, create_time, update_time
---
领星采购接口参考
所有接口均为 POST 请求,域名:https://openapi.lingxing.com
---
purchaseOrderList - 查询采购订单列表
路径: /erp/sc/routing/data/local_inventory/purchaseOrderList 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| start_date | 否 | string | 开始日期,格式 Y-m-d |
| end_date | 否 | string | 结束日期 |
| date_type | 否 | int | 时间类型:1=创建时间,2=预计到货时间 |
| status | 否 | int | 状态:1=待提交,2=待审核,3=待收货,4=部分收货,5=已完成,6=已作废 |
| purchase_plan_sn | 否 | string | 采购计划号 |
| order_sn | 否 | string | 采购单号,多个逗号分隔 |
| wid | 否 | int | 仓库ID |
| buyer_id | 否 | int | 采购员ID |
| supplier_id | 否 | int | 供应商ID |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 分页长度,默认20 |
关键返回字段: order_sn, status, create_time, estimated_arrival_date, supplier_name, wid, warehouse_name, total_amount, currency, item_list[sku/product_name/quantity/price]
---
supplier - 查询供应商列表
路径: /erp/sc/data/local_inventory/supplier 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| keyword | 否 | string | 关键词(供应商名称/编码) |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 分页长度,默认20 |
关键返回字段: supplier_id, supplier_name, supplier_code, contact_name, phone, email, status, create_time
---
changeOrderList - 查询采购变更单列表
路径: /erp/sc/routing/purchase/purchaseChangeOrder/changeOrderList 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| start_date | 否 | string | 开始日期,格式 Y-m-d |
| end_date | 否 | string | 结束日期 |
| status | 否 | int | 状态:1=待审核,2=已通过,3=已驳回 |
| order_sn | 否 | string | 采购单号 |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 分页长度,默认20 |
关键返回字段: change_order_sn, purchase_order_sn, status, create_time, change_type, change_content, operator
---
getOrders - 查询委外采购订单列表
路径: /erp/sc/routing/purchase/purchaseOutsourceOrder/getOrders 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| start_date | 否 | string | 开始日期,格式 Y-m-d |
| end_date | 否 | string | 结束日期 |
| status | 否 | int | 状态 |
| order_sn | 否 | string | 委外单号,多个逗号分隔 |
| wid | 否 | int | 仓库ID |
| supplier_id | 否 | int | 供应商ID |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 分页长度,默认20 |
关键返回字段: order_sn, status, create_time, supplier_name, wid, warehouse_name, total_amount, currency, item_list[sku/product_name/quantity/price]
---
getPurchasePlans - 查询采购计划列表
路径: /erp/sc/routing/data/local_inventory/getPurchasePlans 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| start_date | 否 | string | 开始日期,格式 Y-m-d |
| end_date | 否 | string | 结束日期 |
| status | 否 | int | 状态:1=待提交,2=待审核,3=采购中,4=已完成,5=已作废 |
| plan_sn | 否 | string | 计划单号,多个逗号分隔 |
| buyer_id | 否 | int | 采购员ID |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 分页长度,默认20 |
关键返回字段: plan_sn, status, create_time, buyer_name, total_sku_count, total_quantity, item_list[sku/product_name/plan_quantity/purchase_quantity]
---
getPurchaseReturnOrderList - 查询采购退货单列表
路径: /erp/sc/routing/purchase/purchase_return_order/getPurchaseReturnOrderList 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| start_date | 否 | string | 开始日期,格式 Y-m-d |
| end_date | 否 | string | 结束日期 |
| status | 否 | int | 状态 |
| order_sn | 否 | string | 退货单号,多个逗号分隔 |
| supplier_id | 否 | int | 供应商ID |
| wid | 否 | int | 仓库ID |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 分页长度,默认20 |
关键返回字段: return_order_sn, purchase_order_sn, status, create_time, supplier_name, wid, warehouse_name, total_amount, currency, item_list[sku/product_name/return_quantity/price]
---
purchaserLists - 查询采购员列表
路径: /erp/sc/routing/data/purchaser/lists 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| keyword | 否 | string | 关键词(采购员名称) |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 分页长度,默认20 |
关键返回字段: buyer_id, buyer_name, email, status
领星订单 / Listing / 运营操作接口参考
所有接口均为 POST 请求,域名:https://openapi.lingxing.com
---
mwsOrders - 查询亚马逊订单列表
路径: /erp/sc/data/mws/orders 令牌桶容量: 1(串行调用)
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| sid | 否 | int | 店铺ID(与 sid_list 任选其一) |
| sid_list | 否 | array | 店铺ID列表,最大长度20 |
| start_date | 是 | string | 开始时间,格式 Y-m-d 或 Y-m-d H:i:s |
| end_date | 是 | string | 结束时间,左闭右开 |
| date_type | 否 | int | 1=订购时间(默认),2=订单修改时间,3=平台更新时间,10=发货时间 |
| order_status | 否 | array | ["Pending","Unshipped","PartiallyShipped","Shipped","Canceled"] |
| sort_desc_by_date_type | 否 | int | 0=不排序(默认),1=降序,2=升序 |
| fulfillment_channel | 否 | int | 1=AFN,2=MFN |
| offset | 否 | int | 分页偏移,默认0 |
| length | 否 | int | 每页条数,默认1000,上限5000 |
关键返回字段: sid, seller_name, amazon_order_id, order_status, order_total_amount, fulfillment_channel, is_return, is_return_order, is_replaced_order, item_list[asin/seller_sku/quantity_ordered], purchase_date_local, shipment_date_local, refund_amount
调用示例:
python3 lingxing.py --api mwsOrders \
--params '{"start_date": "2024-01-01", "end_date": "2024-01-31"}' --all---
mwsListing - 查询亚马逊 Listing
路径: /erp/sc/data/mws/listing 令牌桶容量: 1(账号级别共享,串行调用)
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| sid | 是 | string | 店铺ID,多个用英文逗号分隔,如 "813,814" |
| is_pair | 否 | int | 1=已配对,2=未配对 |
| is_delete | 否 | int | 0=未删除,1=已删除 |
| pair_update_start_time | 否 | string | 配对更新开始时间(北京时间,Y-m-d H:i:s),需 is_pair=1 |
| pair_update_end_time | 否 | string | 配对更新结束时间 |
| listing_update_start_time | 否 | string | All Listing报表更新开始时间(零时区) |
| listing_update_end_time | 否 | string | All Listing报表更新结束时间 |
| search_field | 否 | string | seller_sku / asin / sku |
| search_value | 否 | array | 搜索值列表,上限10个 |
| exact_search | 否 | int | 0=模糊,1=精确(默认) |
| store_type | 否 | int | 1=非低价商店,2=低价商店 |
| offset | 否 | int | 分页偏移,默认0 |
| length | 否 | int | 每页条数,默认1000,上限1000 |
关键返回字段: sid, seller_sku, asin, parent_asin, item_name, local_sku, local_name, status, price, landed_price, afn_fulfillable_quantity, afn_unsellable_quantity, fulfillment_channel_type, seller_rank, seller_category_new, review_num, last_star, total_volume, yesterday_volume, fourteen_volume, thirty_volume, seven_amount, thirty_amount
调用示例:
# 查询单个店铺所有 Listing
python3 lingxing.py --api mwsListing \
--params '{"sid": "813", "is_pair": 1, "is_delete": 0}' --all
# 按 ASIN 精确查询
python3 lingxing.py --api mwsListing \
--params '{"sid": "813", "search_field": "asin", "search_value": ["B0XXXXXX"]}'---
orderReturnInformation - 查询多渠道订单退货换货信息
路径: /order/amzod/api/orderDetails/returnInformation 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| order_info | 是 | array | 订单信息列表,上限200条 |
| order_info>>sid | 是 | int | 店铺ID |
| order_info>>seller_fulfillment_order_id | 是 | string | 卖家订单号 |
关键返回字段: amazon_order_id, seller_fulfillment_order_id, order_status, purchase_date_local, order_return_replace_tab>>return_tab[return_date/msku/asin/return_quantity/return_reason/return_status/customer_comments], order_return_replace_tab>>replace_tab[replacement_reason/msku/shipment_date]
调用示例:
python3 lingxing.py --api orderReturnInformation \
--params '{"order_info": [{"sid": 813, "seller_fulfillment_order_id": "xxx-R"}]}'---
scOrderSetRemark - SC订单设置备注
路径: /basicOpen/platformOrder/scOrder/setRemark 令牌桶容量: 1
参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| sid | 是 | int | 店铺ID |
| amazonOrderId | 是 | string | 亚马逊订单号 |
| remark | 是 | string | 备注内容(传空字符串可清除备注) |
返回: code=0 表示成功,data=null
调用示例:
python3 lingxing.py --api scOrderSetRemark \
--params '{"sid": 813, "amazonOrderId": "111-1234567-8901234", "remark": "已跟进"}'注意: scOrderSetRemark 是写操作,会修改领星系统内订单备注,请谨慎调用。领星目标管理接口参考
所有接口均为 POST 请求,域名:https://openapi.lingxing.com
注意:这两个接口的成功状态码为code=1(而非通常的 0),消息字段为msg。
---
StoreBatchSelect - 店铺维度批量查询目标
路径: /bd/goal/management/open/store/batchSelect 参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| assessYear | 是 | string | 目标年份,如 "2024" |
关键返回字段: goalName, sid, name(店铺名), currencyCode, icon, assessYear, goalAmount1~12(各月目标值), realAmount1~12(各月完成值), completeRateAmount1~12(各月完成率), totalGoalAmount, totalRealAmount, totalCompleteRate, createUserName, gmtCreate
---
UserBatchSelect - 组织维度批量查询目标
路径: /bd/goal/management/open/user/batchSelect 参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| assessYear | 是 | int | 目标年份,如 2024 |
| assessType | 是 | int | 考核指标:1=销售额,2=销量 |
关键返回字段: realName, uid, defaultOrg, orgs[orgId/orgName], currencyCode, assessType, goalValue1~12(各月目标值), realValue1~12(各月完成值), completeRate1~12(各月完成率), yearGoalValue, yearRealValue, completeProcess, createUser, gmtCreate
---
领星工具接口参考
所有接口均为 POST 请求,域名:https://openapi.lingxing.com
---
CompetitiveMonitorList - 查询竞品监控列表
路径: /basicOpen/tool/competitiveMonitor/list 参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| levels | 否 | array | 竞品等级:1=A,2=B,3=C,4=D |
| update_time_start | 否 | string | 更新开始时间,Y-m-d |
| update_time_end | 否 | string | 更新结束时间,Y-m-d |
| search_field | 否 | string | asin |
| search_value | 否 | string | 搜索值,多个用逗号分隔,上限200 |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 分页长度,默认20,上限200 |
关键返回字段: asin, asin_url, title, price, currency, level_name, rating, star, review_num, big_category_rank, big_category, small_ranks[small_rank/small_category_text], monitor_status, buybox_price, fbm_seller_num, fba_seller_num, main_image, featurebullets, item_weight, product_dimensions
---
GetKeywordList - 查询关键词排名列表
路径: /erp/sc/routing/tool/toolKeywordRank/getKeywordList 参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| offset | 是 | int | 分页偏移量,默认0 |
| length | 是 | int | 分页长度,默认20,上限2000 |
| mid | 否 | int | 国家ID |
| start_date | 否 | string | 开始日期,Y-m-d |
| end_date | 否 | string | 结束日期,Y-m-d |
关键返回字段: id, key_word, rank, page, asin, parent_asin, title, country, current_page_rank, sbv_page, rank_text, sbv_text, is_sponsored(1=广告/0=自然), type(1=PC/2=移动端), monitor_time, create_time, keyword_num, monitors
---
warningMessageGoodsList - 查询预警消息列表(商品)
路径: /basicOpen/settings/warningMessage/goodsList 参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| start_date | 是 | string | 开始日期【提醒时间】,间隔不超过90天,Y-m-d |
| end_date | 是 | string | 结束日期,Y-m-d |
| show_status | 是 | int | 0=待处理,1=全部 |
| model_id_list | 否 | array | 预警模型:1=Listing调价,2=FBA费变更,3=Listing下架,6=FBA费异常,7=折扣异常,18=业务指标,20=折扣叠加,21=buybox丢失,26=父ASIN变更 |
| sids | 否 | array | 店铺ID |
| search_field | 否 | string | rule_name/asin/msku |
| search_value | 否 | string | 搜索值 |
| offset | 否 | int | 分页偏移量 |
| length | 否 | int | 分页长度,默认50,上限200 |
关键返回字段: message_id, asin, title, msku_list, model_name, rule_name, metric, notify_time, receiver, handle_status, read_status, monitor_time
---
warningMessageInventoryList - 查询预警消息列表(库存)
路径: /basicOpen/settings/warningMessage/inventoryList 参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| start_date | 是 | string | 开始日期【提醒时间】,间隔不超过90天,Y-m-d |
| end_date | 是 | string | 结束日期,Y-m-d |
| show_status | 是 | int | 0=待处理,1=全部 |
| model_id_list | 否 | array | 预警模型:4=本地库存,5=亚马逊库存,22=本地库龄,23=亚马逊库龄 |
| product_type_list | 否 | array | 2=MSKU,3=SKU+仓库+店铺+FNSKU |
| offset | 否 | int | 分页偏移量 |
| length | 否 | int | 分页长度,默认50,上限200 |
关键返回字段: message_id, model_id, model_name, product_type_str, monitor_type_str, notify_time, receiver, handle_status, read_status, monitor_time
---
领星 VC 接口参考
所有接口均为 POST 请求,域名:https://openapi.lingxing.com
---
vcOrderPageList - 查询 VC 订单列表
路径: /basicOpen/platformOrder/vcOrder/pageList 参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| purchase_order_type | 是 | array | 订单类型:0=DF,1=PO,2=DI |
| vc_store_ids | 否 | array | VC 店铺ID |
| search_field_time | 否 | string | 1=订购时间,2=要求发货时间,3=订单更新时间 |
| start_date | 否 | string | 开始时间,Y-m-d,间隔不超过90天 |
| end_date | 否 | string | 结束时间,Y-m-d |
| search_field | 否 | string | purchase_order_number/asin/local_name/customer_order_number/vendor_product_id |
| search_value | 否 | array | 搜索值 |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 分页长度,默认20,上限200 |
关键返回字段: purchase_order_number, customer_order_number, purchase_order_type, purchase_order_process_state, currency_code, focus_party_id, shipment_confirm_status
---
vcOrderPoDetail - 查询 VC 订单详情(PO)
路径: /basicOpen/platformOrder/vcOrderPo/detail 参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| local_po_number | 是 | string | 本地 PO 号(来自 vcOrderPageList 的 local_po_number) |
关键返回字段: purchase_order_date, currency_code, delivery_window_start, remark, items[item_name/asin/vendor_product_id/ordered_quantity/unit_cost]
---
vcOrderDfDetail - 查询 VC 订单详情(DF)
路径: /basicOpen/platformOrder/vcOrderDf/detail 参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| vc_store_id | 是 | string | VC 店铺ID |
| purchase_order_number | 是 | string | 订单编号 |
关键返回字段: purchase_order_date, related_warehouse_id, is_pslip_required, message_to_customer, remark, items
---
vcDeliverPageList - 查询 VC 发货单列表
路径: /basicOpen/openapi/getInvoice/page/list 参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| shipmentType | 是 | int | 1=DF,2=PO,3=DI |
| sids | 否 | array | 店铺ID |
| wid | 否 | int | 国家ID |
| status | 否 | int | 0=全部,5=待配货,10=待出库,15=已完成,100=已作废 |
| createTimeStartTime | 否 | string | 创建日期开始 |
| createTimeEndTime | 否 | string | 创建日期结束 |
| offset | 否 | int | 偏移量,默认0 |
| length | 否 | int | 每页条数,默认20 |
关键返回字段: list[orderNo, shipmentTime, shipmentType, sourceType], count
---
vcDeliverDetail - 查询 VC 发货单详情
路径: /basicOpen/openapi/getInvoice/detail 参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| orderNo | 是 | string | 发货单号 |
关键返回字段: invoice[shippingWid, createUser, estimatedPickupTime, items]
---
listingManageVcListingPageList - 查询 VC Listing 列表
路径: /basicOpen/listingManage/vcListing/pageList 参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| vc_store_ids | 否 | array | VC 店铺ID |
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 分页长度,默认20,上限200 |
关键返回字段: msku, local_sku, asin, title, status, classification_rank, display_group_rank, reviews_num
---
platformAuthVcSellerPageList - 查询 VC 店铺列表
路径: /basicOpen/platformAuth/vcSeller/pageList 参数:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| offset | 否 | int | 分页偏移量,默认0 |
| length | 否 | int | 分页长度,默认20,上限200 |
关键返回字段: vc_store_id, region_name, seller_name, auth_status
---