领星 ERP OpenAPI（LinkFox 包装版）
本 skill 是 LinkFox 对领星（Lingxing）官方开放能力的包装：
为
，内容与领星侧 OpenAPI 文档及
保持一致，由 LinkFox 仓库统一版本管理；认证与请求仍发往
领星官方域名。速查见
。
查询领星 ERP 全模块数据，支持 373 个接口，覆盖广告、销售、产品、财务、统计、FBA、仓库、采购、客服、多平台等全业务线。
环境变量配置
bash
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 根目录（含
与
的目录）下执行。
bash
# 列出所有已授权亚马逊店铺，获取 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。
调用示例
bash
# 第一步：查询店铺列表获取 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个）
| 分组 | 接口 |
|---|
| 账号(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个）
接口详见
（订单/Listing核心4个）+
（其余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个）
ProductLists, ProductDetails, Brand, Category, UpcList, GetProductTag(GET), GetPagingLogLists, attributeList, batchGetProductInfo, bundledProductList, getTransparencyProductList, productAuxList, spuInfo, spuList
财务（41个）
| 分组 | 接口 |
|---|
| 利润报表(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个）
| 分组 | 接口 |
|---|
| 销量(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个）
FBAShipmentList, FBAReceivedInventory, ShipmentPlanLists, GetFbaProductList, GetInboundShipmentList, GetInboundShipmentListMwsDetailList, ShipFromAddressList, BoxInfo, GetHeadLogisticsFeeTypes, GetSeaTrackSupplierCarriers, QuerySTATaskList, StaTaskDetail, getInboundShipmentListMwsDetail
亚马逊源表数据（20个）
AllOrders, FbaOrders, RefundOrders, Transaction, ManageInventory, DailyInventory, AfnFulfillableQuantity, ReservedInventory, RemovalLists, RemovalOrderListNew, RemovalShipmentList, SourceRemovalOrders, AdjustmentList, getAmazonFulfilledShipmentsList, getFbaAgeList, getFbaInventoryEventDetailList, v1getAmazonFulfilledShipmentsList, v1getFbaInventoryEventDetailList, fbaExchangeOrderList, fbmReturnOrderList
补货建议（9个）
GetSummaryList, ConfigASIN, ConfigMSKU, DailySalesInfoFeatureASIN, DailySalesInfoFeatureMSKU, InfoASIN, InfoMSKU, SourceListASIN, SourceListMSKU
补货限制（2个）
GetIpiInfo, replenishmentRestrictionList
采购（7个）
PurchaseOrderList, Supplier, changeOrderList, purchaseGetOrders, getPurchasePlans, getPurchaseReturnOrderList, purchaserLists
仓库（32个）
| 分组 | 接口 |
|---|
| 仓库/库存(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个）
FeedbackList, FeedbackListMws, CustomerList, AfterSalesWorkOrderList, PerformanceNoticeList, PerformanceNoticeDetail, mailDetail, mailLists, review, reviewDetail, reviewLists(GET), reviewV2, feedbackDetail, feedbackLists, customerServiceCrmcustomerIndex, customerServiceRmaManageList, storePerformanceList, voiceOfBuyerList
物流（3个）
ChannelList, QueryHeadLogisticsProvider, transportMethodList
工具（4个）
CompetitiveMonitorList, GetKeywordList, warningMessageGoodsList, warningMessageInventoryList
VC（7个）
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 添加「基础数据」权限，或直接设置
跳过自动发现。
注意事项
- 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
- 响应格式: 路径 API 数据在 或 下
- 日期参数: 报表类接口用 （单日）；订单/利润类用 /（日期范围）；多平台V2用 Unix 时间戳（秒）
- Token 缓存: token 自动缓存到
/tmp/lingxing_token_*.json
- 限流: 大多数接口令牌桶容量为 10，ProductAnalysisList 和 mwsOrders 仅为 1
- 依赖: 需要安装 和 （
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
|