{"id":"1d1ca4a5-0c9a-4c98-92cd-b6a9f85bc46d","entityType":"agent","slug":"clawhub-linkfox-ai-linkfox-lingxing-erp","name":"领星官方MCP安装","canonicalUrl":"https://www.xpersona.co/agent/clawhub-linkfox-ai-linkfox-lingxing-erp","canonicalPath":"/agent/clawhub-linkfox-ai-linkfox-lingxing-erp","generatedAt":"2026-10-10T11:52:19.607Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-10T09:49:58.619Z","emptyReason":null},"description":"引导用户安装、连接和配置领星（Lingxing）官方 MCP，并排查连接、鉴权、权限与客户端兼容性问题。触发关键词：领星、领星 ERP、Lingxing、领星 MCP、Lingxing MCP、安装领星 MCP、配置领星 MCP、连接领星 MCP、重新配置领星 MCP、MCP Server URL、X-MCP-KEY、X-Mcp-Key、领星 MCP 鉴权失败、领星 MCP 连接失败。 Skill: 领星官方MCP安装 Owner: linkfox-ai Summary: 引导用户安装、连接和配置领星（Lingxing）官方 MCP，并排查连接、鉴权、权限与客户端兼容性问题。触发关键词：领星、领星 ERP、Lingxing、领星 MCP、Lingxing MCP、安装领星 MCP、配置领星 MCP、连接领星 MCP、重新配置领星 MCP、MCP Server URL、X-MCP-KEY、X-Mcp-Key、领星 MCP 鉴权失败、领星 MCP 连接失败。 Tags: latest:2.0.0 Version history: v2.0.0 | 2026-09-14T05:21:46.838Z | user Update from 1.0.6 to 2.0.0 v1.0.6 | 2026-08-14T14:57:02.390Z | user Update from 1.0.5 to 1.0.6 v1.0.5 |","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.5K downloads reported by the source. Last updated 10/10/2026.","installCommand":"clawhub skill install s171g8b6m2khwdy9ye8bxj0wx183vd4z:linkfox-lingxing-erp","sourceUrl":"https://clawhub.ai/linkfox-ai/linkfox-lingxing-erp","homepage":"https://clawhub.ai/linkfox-ai/skills/linkfox-lingxing-erp","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/linkfox-ai/linkfox-lingxing-erp","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/linkfox-ai/skills/linkfox-lingxing-erp","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":64,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"引导用户安装、连接和配置领星（Lingxing）官方 MCP，并排查连接、鉴权、权限与客户端兼容性问题。触发关键词：领星、领星 ERP、Lingxing、领星 MCP、Lingxing MCP、安装领星 MCP、配置领星 MCP、连接领星 MCP、重新配置领星 MCP、MCP Server URL、X-MCP-KEY、"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-10T09:49:58.619Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T09:49:58.619Z","emptyReason":null},"stars":null,"forks":null,"downloads":1514,"packageName":null,"latestVersion":"2.0.0","tractionLabel":"1.5K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T09:49:58.619Z","emptyReason":null},"lastUpdatedAt":"2026-10-10T09:49:58.619Z","lastCrawledAt":"2026-10-10T09:49:58.619Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-11T09:49:58.619Z","lastVerifiedAt":null,"highlights":[{"version":"2.0.0","createdAt":"2026-09-14T05:21:46.838Z","changelog":"Update from 1.0.6 to 2.0.0","fileCount":4,"zipByteSize":5864},{"version":"1.0.6","createdAt":"2026-08-14T14:57:02.390Z","changelog":"Update from 1.0.5 to 1.0.6","fileCount":29,"zipByteSize":85666},{"version":"1.0.5","createdAt":"2026-08-07T10:52:53.649Z","changelog":"Update from 1.0.4 to 1.0.5","fileCount":29,"zipByteSize":85611},{"version":"1.0.4","createdAt":"2026-07-13T12:13:21.709Z","changelog":"Update from 1.0.3 to 1.0.4","fileCount":27,"zipByteSize":76888},{"version":"1.0.3","createdAt":"2026-07-06T11:22:16.909Z","changelog":"Update from 1.0.2 to 1.0.3","fileCount":27,"zipByteSize":76151},{"version":"1.0.2","createdAt":"2026-07-03T08:20:53.549Z","changelog":"Update from 1.0.1 to 1.0.2","fileCount":26,"zipByteSize":74676},{"version":"1.0.1","createdAt":"2026-07-03T06:51:36.630Z","changelog":"Update from 1.0.0 to 1.0.1","fileCount":26,"zipByteSize":74675},{"version":"1.0.0","createdAt":"2026-04-30T08:55:26.604Z","changelog":"Initial release","fileCount":26,"zipByteSize":68939}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s171g8b6m2khwdy9ye8bxj0wx183vd4z:linkfox-lingxing-erp","setupComplexity":"low","setupSteps":["Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-lingxing-erp/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-lingxing-erp/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-lingxing-erp/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-lingxing-erp/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-lingxing-erp/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-lingxing-erp/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-10T11:52:19.602Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-lingxing-erp/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-lingxing-erp/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-lingxing-erp/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-lingxing-erp/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-10T09:49:58.619Z","emptyReason":null},"readme":"Skill: 领星官方MCP安装\n\nOwner: linkfox-ai\n\nSummary: 引导用户安装、连接和配置领星（Lingxing）官方 MCP，并排查连接、鉴权、权限与客户端兼容性问题。触发关键词：领星、领星 ERP、Lingxing、领星 MCP、Lingxing MCP、安装领星 MCP、配置领星 MCP、连接领星 MCP、重新配置领星 MCP、MCP Server URL、X-MCP-KEY、X-Mcp-Key、领星 MCP 鉴权失败、领星 MCP 连接失败。\n\nTags: latest:2.0.0\n\nVersion history:\n\nv2.0.0 | 2026-09-14T05:21:46.838Z | user\n\nUpdate from 1.0.6 to 2.0.0\n\nv1.0.6 | 2026-08-14T14:57:02.390Z | user\n\nUpdate from 1.0.5 to 1.0.6\n\nv1.0.5 | 2026-08-07T10:52:53.649Z | user\n\nUpdate from 1.0.4 to 1.0.5\n\nv1.0.4 | 2026-07-13T12:13:21.709Z | user\n\nUpdate from 1.0.3 to 1.0.4\n\nv1.0.3 | 2026-07-06T11:22:16.909Z | user\n\nUpdate from 1.0.2 to 1.0.3\n\nv1.0.2 | 2026-07-03T08:20:53.549Z | user\n\nUpdate from 1.0.1 to 1.0.2\n\nv1.0.1 | 2026-07-03T06:51:36.630Z | user\n\nUpdate from 1.0.0 to 1.0.1\n\nv1.0.0 | 2026-04-30T08:55:26.604Z | user\n\nInitial release\n\nArchive index:\n\nArchive v2.0.0: 4 files, 5864 bytes\n\nFiles: _meta.json (139b), references/install.md (3463b), skill-card.md (2460b), SKILL.md (3877b)\n\nFile v2.0.0:SKILL.md\n\n---\nname: linkfox-lingxing-erp\ndescription: 引导用户安装、连接和配置领星（Lingxing）官方 MCP，并排查连接、鉴权、权限与客户端兼容性问题。触发关键词：领星、领星 ERP、Lingxing、领星 MCP、Lingxing MCP、安装领星 MCP、配置领星 MCP、连接领星 MCP、重新配置领星 MCP、MCP Server URL、X-MCP-KEY、X-Mcp-Key、领星 MCP 鉴权失败、领星 MCP 连接失败。\n---\n\n# 安装领星官方 MCP\n\n只引导安装领星官方 MCP，不封装、代调或讲解任何领星业务 Tool/API。\n\n## 官方依据\n\n- 只以领星官方指引为准：<https://www.lingxing.com/help/article/mcp>\n- 将服务器 URL、按钮名称、传输方式或配置字段与官方页面不一致时，以官方页面的当前内容为准。\n\n## 必须执行的流程\n\n1. 识别当前 Agent 所在客户端及其 MCP 安装方式。可先只读检查是否已有 `lingxing-mcp` 连接；不要发现、列出或调用领星业务工具。\n2. 告知前置条件：领星付费用户需由超级管理员在【业务配置】→【开放接口】→【MCP】启用功能，当前帐号还需拥有相应权限。\n3. 在索取任何配置值前，完整读取 `references/install.md`，按其中“必须向用户展示的图文引导”发送文字和领星官方截图。不得只发一句“去获取 X-Mcp-Key”。\n4. 让用户亲自在领星 ERP 中复制两项配置：\n   - 当前帐号对应的 **MCP Server URL**；\n   - **X-Mcp-Key** 鉴权密钥。\n5. 优先通过当前客户端的安全凭据输入、Secret Store 或私密配置界面接收密钥。若客户端没有安全输入通道，让用户按 `references/install.md` 在本地自行填写配置，并只回复“已配置”；不要要求用户在普通聊天中粘贴完整密钥。\n6. 使用当前客户端原生的 MCP 添加方式保存连接：名称使用 `lingxing-mcp`，传输方式使用 **Streamable HTTP / HTTP Streaming**，URL 使用用户从领星复制的完整值，请求头名严格使用 `X-Mcp-Key`。\n7. 保存前向用户说明将写入哪个客户端、使用哪个服务器域名，并只显示掩码后的密钥。若用户已明确要求安装或配置，可直接继续；否则先取得明确同意。\n8. 仅验证 MCP 连接、鉴权和工具发现是否成功。不得为了验证而调用任何会读取或写入领星业务数据的工具。\n9. 成功后只报告连接已安装及验证结果。后续数据任务交由已安装的领星官方 MCP 处理，不在本 skill 中提供调用方法。\n\n## 安全边界\n\n- 不代替用户登录领星，不索取帐号密码或验证码，不替用户创建、复制、重新生成或轮换密钥。\n- 将 MCP Server URL 与 `X-Mcp-Key` 都视为敏感配置；不要回显、记录到日志、提交到仓库或写进示例文件。\n- 不把真实密钥放进 shell 命令、命令历史、截图、测试输出或故障报告。\n- 若用户已在聊天中粘贴密钥，不要复述或使用该值；将其视为已暴露，让用户先在【管理MCP】中手动重新生成，再通过安全方式提供新密钥。\n- 若怀疑泄露，停止配置并让用户在【管理MCP】页面手动重新生成。\n\n## 故障排查范围\n\n只排查安装与鉴权：\n\n- 未看到 MCP 功能：确认付费资格及超级管理员是否已启用。\n- 鉴权失败：确认 URL 使用 `https://`、Header 名为 `X-Mcp-Key`、密钥复制完整且无多余空格。\n- 权限不符：说明服务器 URL 与当前领星帐号权限绑定，让用户换用正确帐号重新复制。\n- 客户端不支持自定义 Streamable HTTP MCP：明确说明该客户端无法按此方式安装，并引导用户查看客户端官方 MCP 支持文档。\n\n不要通过 curl、Python、OpenAPI 或 MCP Tool 调用来诊断，不要查询库存、订单、利润、广告、Listing 或其他业务数据。\n\nFile v2.0.0:_meta.json\n\n{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-lingxing-erp\",\n  \"version\": \"2.0.0\",\n  \"publishedAt\": 1789363306838\n}\n\nFile v2.0.0:references/install.md\n\n# 领星官方 MCP 安装引导\n\n本文件只用于安装和鉴权配置。不要扩展为业务工具清单、接口参考或数据操作教程。\n\n## 必须向用户展示的图文引导\n\n在请求用户提供 MCP Server URL 或 `X-Mcp-Key` 前，按顺序发送下面的文字和领星官方截图。即使图片无法显示，也要保留完整文字步骤。\n\n### 第 1 步：打开管理 MCP\n\n请用户登录领星 ERP，进入【AI助手】，点击输入框附近的【MCP】，再点击【管理MCP】。此操作必须由用户本人完成。\n\n![进入领星 AI 助手](../assets/mcp-install/01-open-ai-assistant.png)\n\n![在领星 AI 助手中点击管理 MCP](../assets/mcp-install/02-open-manage-mcp.png)\n\n### 第 2 步：进入第三方应用配置\n\n在【管理MCP】窗口找到【领星MCP】，点击“复制链接到第三方APP使用”一类入口。页面文案若已更新，以当前领星页面为准。\n\n![在管理 MCP 中进入第三方应用配置](../assets/mcp-install/03-third-party-app-config.png)\n\n### 第 3 步：分别复制 URL 和 X-Mcp-Key\n\n在第三方配置页分别点击【复制服务器 URL】与【复制鉴权密钥（X-Mcp-Key）】。两项缺一不可；密钥与当前领星帐号绑定，不要分享给其他人。\n\n以上三张截图均来自领星官方 MCP 指引，已保存在 skill 内，不依赖远程图片 URL。\n\n## 告诉用户如何安全提供给 Agent\n\n优先使用以下话术：\n\n> 请不要把完整 `X-Mcp-Key` 发在普通聊天、群聊或工单里。若当前客户端弹出安全凭据/Secret 输入框，请把从领星复制的服务器 URL 与密钥分别粘贴到对应字段；密钥字段名为 `X-Mcp-Key`。如果没有安全输入框，请在本机 MCP 配置中自行填入下面的占位位置，保存后只回复“已配置”，无需把密钥发给我。\n\n若当前客户端提供安全凭据输入，收集：\n\n- `MCP Server URL`：用户从【管理MCP】复制的完整 HTTPS URL；\n- `X-Mcp-Key`：用户从同一页面复制的完整鉴权密钥。\n\nAgent 接收后只显示掩码，例如 `****abcd`，不要复述完整值。\n\n## 通用配置形状\n\n不同客户端的字段名可能略有差异，优先使用客户端原生的 MCP 配置界面。需要向用户展示本地填写示例时，只使用占位符：\n\n```json\n{\n  \"mcpServers\": {\n    \"lingxing-mcp\": {\n      \"type\": \"streamableHttp\",\n      \"url\": \"<从领星复制的 MCP Server URL>\",\n      \"headers\": {\n        \"X-Mcp-Key\": \"<仅在本机安全填写，不要发送到普通聊天>\"\n      }\n    }\n  }\n}\n```\n\n若客户端使用 `transport` 字段，则选择或填写 `streamable_http`；不要同时猜测多个不受客户端支持的字段。\n\n## 连接验证\n\n只验证以下结果：\n\n1. MCP 服务器可连接；\n2. `X-Mcp-Key` 鉴权通过；\n3. 客户端能完成工具发现。\n\n不要调用任何工具读取库存、订单、Listing、销售、利润、广告或其他业务数据，也不要执行新增、修改、删除等写操作。\n\n## 官方信息摘要\n\n- 超级管理员需在【业务配置】→【开放接口】→【MCP】启用功能，仅限付费用户。\n- MCP Server URL 与当前领星帐号的数据权限绑定。\n- 传输方式为 Streamable HTTP（HTTP Streaming）。\n- 只配置 URL 而未配置 `X-Mcp-Key` 会导致鉴权失败。\n- 密钥泄露时，由用户在【管理MCP】页面手动重新生成。\n\n来源：<https://www.lingxing.com/help/article/mcp>\n\nFile v2.0.0:skill-card.md\n\n## Description:\n\n引导用户安装、连接和配置领星（Lingxing）官方 MCP，并排查连接、鉴权、权限与客户端兼容性问题。\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and developers use this skill to install and configure the official Lingxing MCP connection in an MCP-capable client. It focuses on collecting the MCP Server URL and X-Mcp-Key securely, validating connection and authentication, and troubleshooting setup issues without accessing Lingxing business data.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The MCP Server URL and X-Mcp-Key are sensitive and could be exposed if pasted into ordinary chat, logs, shell commands, screenshots, or example files.\n\nMitigation: Use a secure credential input, secret store, or local MCP configuration, mask any displayed key value, and regenerate the key if it was exposed.\n\nRisk: Connection validation could unintentionally access Lingxing business data if the agent uses business tools during setup.\n\nMitigation: Limit validation to server connectivity, authentication, and tool discovery; do not query inventory, orders, listings, sales, profit, advertising, or other business data.\n\nRisk: Bundled screenshot assets referenced by the install guide are not present in the artifact.\n\nMitigation: Use the official Lingxing MCP help page when current screenshots or UI labels are needed.\n\n## Reference(s):\n\n- [Lingxing MCP official guide](https://www.lingxing.com/help/article/mcp)\n- [领星官方 MCP 安装引导](artifact/references/install.md)\n- [ClawHub skill page](https://clawhub.ai/linkfox-ai/skills/linkfox-lingxing-erp)\n\n## Skill Output:\n\n**Output Type(s):** [Guidance, Markdown, Configuration instructions]\n\n**Output Format:** [Markdown with JSON configuration examples]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Does not produce or store Lingxing credentials; validation is limited to connection, authentication, and tool discovery.]\n\n## Skill Version(s):\n\n2.0.0 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v1.0.6: 29 files, 85666 bytes\n\nFiles: _meta.json (139b), references/api.md (2427b), references/basedata.md (6901b), references/basicdata-full.md (2891b), references/fba.md (6624b), references/fbalimit.md (1417b), references/fbasug.md (4352b), references/finance.md (22193b), references/logistics.md (1657b), references/multiplatform-ads.md (14140b), references/multiplatform-v2.md (15569b), references/newad-report.md (9507b), references/onboarding.md (2046b), references/product.md (7749b), references/purchase.md (5103b), references/sale-full.md (18675b), references/sale-ops.md (4857b), references/service.md (11308b), references/sourcedata.md (11520b), references/statistics.md (25011b), references/targetmanage.md (1332b), references/tools.md (3601b), references/vc.md (3829b), references/warehouse.md (24034b), scripts/lingxing.py (55214b), scripts/onboarding.py (24089b), scripts/response_io.py (18387b), skill-card.md (3134b), SKILL.md (17302b)\n\nFile v1.0.6:SKILL.md\n\n---\nname: linkfox-lingxing-erp\ndescription: LinkFox 包装的领星（Lingxing）ERP 技能「linkfox-lingxing-erp」：由 LinkFox Skills 仓库收录分发，封装领星官方 OpenAPI 文档与脚本用法，底层仍直连 openapi.lingxing.com（非 LinkFox 自建网关）。覆盖约 373 个接口场景，含广告报表 SP/SB/SD、订单与 Listing、库存仓库、财务与 FBA、源表、采购、客服、多平台广告与订单等。当用户提到领星、Lingxing、领星开放接口、领星 ERP 数据、领星广告报表、领星订单/库存/利润、领星 SID、Lingxing OpenAPI、Lingxing ERP data、LinkFox 领星、linkfox-lingxing-erp 时触发。分模块参数见 references/api.md 及各 references/*.md；需 LINGXING_APP_ID 与 LINGXING_APP_SECRET。\n---\n\n# 领星 ERP OpenAPI（LinkFox 包装版）\n\n**本 skill 是 LinkFox 对领星（Lingxing）官方开放能力的包装**：`name` 为 `linkfox-lingxing-erp`，内容与领星侧 OpenAPI 文档及 `scripts/lingxing.py` 保持一致，由 LinkFox 仓库统一版本管理；认证与请求仍发往 **领星官方域名**。速查见 `references/api.md`。\n\n查询领星 ERP 全模块数据，支持 **373 个接口**，覆盖广告、销售、产品、财务、统计、FBA、仓库、采购、客服、多平台等全业务线。\n\n## 环境变量配置\n\n```bash\nexport LINGXING_APP_ID=your_app_id\nexport LINGXING_APP_SECRET=your_app_secret\n\n# 可选：设置默认店铺 SID，无需每次在 --params 中传入\nexport LINGXING_SID=your_sid\n```\n\n在领星 ERP -> 开放接口菜单中获取 AppID 和 AppSecret。\n\n## 使用方式\n\n以下命令均在 **本 skill 根目录**（含 `SKILL.md` 与 `scripts/` 的目录）下执行。\n\n```bash\n# 列出所有已授权亚马逊店铺，获取 SID\npython3 scripts/lingxing.py --list-stores\n\n# 查看所有支持的接口\npython3 scripts/lingxing.py --api help\n\n# 基础调用\npython3 scripts/lingxing.py --api <接口名> --params '<JSON参数>'\n\n# 自动翻页获取全部数据\npython3 scripts/lingxing.py --api <接口名> --params '<JSON参数>' --all\n\n# 自定义翻页大小\npython3 scripts/lingxing.py --api <接口名> --params '<JSON参数>' --all --page-size 50\n```\n\n输出为 JSON 到 stdout，翻页进度输出到 stderr。\n\n## 调用示例\n\n```bash\n# 第一步：查询店铺列表获取 SID\npython3 scripts/lingxing.py --list-stores\nexport LINGXING_SID=813\n\n# 广告报表\npython3 scripts/lingxing.py \\\n  --api spCampaignReports \\\n  --params '{\"report_date\": \"2024-01-01\"}'\n\n# 亚马逊订单（自动翻页）\npython3 scripts/lingxing.py \\\n  --api mwsOrders \\\n  --params '{\"start_date\": \"2024-01-01\", \"end_date\": \"2024-01-31\"}' --all\n\n# 亚马逊 Listing\npython3 scripts/lingxing.py \\\n  --api mwsListing \\\n  --params '{\"sid\": \"813\", \"is_pair\": 1, \"is_delete\": 0}' --all\n\n# 产品列表\npython3 scripts/lingxing.py \\\n  --api ProductLists --params '{\"offset\": 0, \"length\": 20}'\n\n# 利润报表（ASIN维度）\npython3 scripts/lingxing.py \\\n  --api profitAsin \\\n  --params '{\"sids\": \"813\", \"start_date\": \"2024-01-01\", \"end_date\": \"2024-01-31\"}'\n\n# ASIN日销量\npython3 scripts/lingxing.py \\\n  --api AsinDailyLists \\\n  --params '{\"sid\": 813, \"start_date\": \"2024-01-01\", \"end_date\": \"2024-01-07\"}' --all\n\n# FBA发货单列表\npython3 scripts/lingxing.py \\\n  --api FBAShipmentList \\\n  --params '{\"sid\": 813}' --all\n\n# 亚马逊源表-全部订单\npython3 scripts/lingxing.py \\\n  --api AllOrders \\\n  --params '{\"sid\": 813, \"start_date\": \"2024-01-01\", \"end_date\": \"2024-01-31\"}' --all\n\n# 仓库列表\npython3 scripts/lingxing.py \\\n  --api WarehouseLists --params '{\"offset\": 0, \"length\": 50}'\n\n# Review列表（v2，支持更多筛选）\npython3 scripts/lingxing.py \\\n  --api reviewV2 --params '{\"sid\": 813, \"offset\": 0, \"length\": 20}'\n\n# 多平台订单（V2）\npython3 scripts/lingxing.py \\\n  --api MultiPlatOrderV2 \\\n  --params '{\"start_date\": 1704067200, \"end_date\": 1706745600}' --all\n\n# TikTok广告主列表\npython3 scripts/lingxing.py \\\n  --api queryAdvertiserList \\\n  --params '{\"length\": 100}'\n\n# 补货建议汇总\npython3 scripts/lingxing.py \\\n  --api GetSummaryList \\\n  --params '{\"sid_list\": [813]}' --all\n```\n\n## 接口总览（373个）\n\n### 新广告报表（37个）\n接口详见 `references/newad-report.md`。\n\n| 分组 | 接口 |\n|------|------|\n| SP报表(8) | spCampaignReports, campaignPlacementReports, spAdGroupReports, spProductAdReports, spKeywordReports, spTargetReports, asinReports, queryWordReports |\n| SB报表(8) | hsaCampaignReports, hsaCampaignPlacementReports, hsaAdGroupReports, listHsaTargetingReport, hsaQueryWordReports, hsaPurchasedAsinReports, listHsaProductAdReport, listHsaKeywordPlacementReport |\n| SD报表(6) | sdCampaignReports, sdAdGroupReports, sdProductAdReports, sdTargetReports, sdAsinReports, sdMatchTargetReports |\n| SP小时(5) | spCampaignHourData, spAdPlacementHourData, spAdGroupHourData, spAdvertiseHourData, spTargetHourData |\n| SB小时(4) | sbCampaignHourData, sbAdGroupHourData, sbTargetHourData, sbAdPlacementHourData |\n| SD小时(4) | sdCampaignHourData, sdAdGroupHourData, sdAdvertiseHourData, sdTargetHourData |\n| 其他(2) | dspReportOrderList, ProductAnalysisList |\n\n### 广告基础数据（21个）\n接口详见 `references/basedata.md`。\n\n| 分组 | 接口 |\n|------|------|\n| 账号(1) | dspAccountList |\n| 组合(1) | portfolios |\n| SP(6) | spCampaigns, spAdGroups, spProductAds, spKeywords, spTargets, spNegativeTargetsOrKeywords |\n| SB(6) | hsaCampaigns, hsaAdGroups, hsaProductAds, sbTargeting, hsaNegativeKeywords, hsaNegativeTargets, sbDivideAsinReports |\n| SD(5) | sdCampaigns, sdAdGroups, sdProductAds, sdTargets, sdNegativeTargets |\n| 报表下载(1) | abaReport |\n\n### 基础数据（8个）\n接口详见 `references/basicdata-full.md`。\n\nAccoutLists(GET), AllMarketplace(GET), AttachmentDownload, ConceptSellerLists(GET), Currency, CustomAttachmentDownload, StateList, WorldStateLists\n\n### 销售（39个）\n接口详见 `references/sale-ops.md`（订单/Listing核心4个）+ `references/sale-full.md`（其余35个）。\n\n| 分组 | 接口 |\n|------|------|\n| 订单(7) | mwsOrders, OrderDetail, FBMOrderList, FBMOrderDetail, MCFOrderList, RefundOrder, afterSaleList |\n| Listing(5) | mwsListing, sale_ProductList, QueryProductList, GetPrices, listingOperateLogPageList |\n| 退货(3) | orderReturnInformation, ProductInformation, LogisticsInformation |\n| 促销(12) | promotionListingList, promotionListingDetailCoupon/Manage/PrimeDiscount/SecKill, promotionalActivitiesCouponList/ManageList/SecKillList/VipDiscountList, promotionCouponAllDetailBatch/ManagementAllDetailBatch/PrimeDiscountAllDetailBatch/SecKillAllDetailBatch |\n| 运营(7) | scOrderSetRemark, adjustPriceAdjustPriceManual, fbaFeeDifferenceList/MskuList, globalTagPageList, queryListingRelationTagList, GetFulfillmentResult |\n| 刊登(5) | PublishManageCategoryRoot/Children, PublishManageGetProductType, GetMerchantShippingGroup |\n\n### 产品（14个）\n接口详见 `references/product.md`。\n\nProductLists, ProductDetails, Brand, Category, UpcList, GetProductTag(GET), GetPagingLogLists, attributeList, batchGetProductInfo, bundledProductList, getTransparencyProductList, productAuxList, spuInfo, spuList\n\n### 财务（41个）\n接口详见 `references/finance.md`。\n\n| 分组 | 接口 |\n|------|------|\n| 利润报表(7) | profitAsin, profitAsinSon, profitSettlement, FianceProfitMsku, OrderProfitListMSKU, ProfitMsku |\n| 结算(6) | SettlementReport, SettlementExportUrlGet, settlementSummaryList, settlementTransactionList, CostStream, summaryQuery |\n| BD报表(7) | bdASIN, bdMSKU, bdOrder, bdParentASIN, bdSKU, bdSeller, bdSellerSummary |\n| 发票(3) | InvoiceList, InvoiceDetail, InvoiceCampaignList |\n| 费用管理(2) | feeManagementList, feeManagementType |\n| 资金池(6) | requestFundsPoolCustomFeeList/InboundList/LogisticsList/OtherFeeList/PrepayList/PurchaseList |\n| 应收(3) | receivableReportList, reportListDetail, reportListDetailInfo |\n| 其他(7) | QueryReceiptFundsList, RequestFundsOrderList, centerOdsDetailQuery, profitReportOrderTranscationList, lazadaPayoutList, lazadaSettlementList, shopeeAdjustmentList/IncomeList/PayoutList |\n\n### 统计（35个）\n接口详见 `references/statistics.md`。\n\n| 分组 | 接口 |\n|------|------|\n| 销量(4) | AsinDailyLists, AsinList, AsinListNew, StoreSales |\n| FBA仓储(5) | FBAStorageFeeLongTerm, FBAStorageFeeMonth, FbaStockReportList, FbaStockAggregateListNew, FbaStockDetailListNew |\n| 本地仓(4) | LocalAggregateList/New, LocalDetailList/New |\n| 海外仓(4) | OverseasAggregateList/New, OverseasDetailList/New |\n| 新版统计(4) | statisticsOpenASIN/MSKU/Parent/Seller |\n| 其他(14) | MonthRefund, ProfitMsku, ReimbursementList, ReturnOrderAnalysisLists, PurchaseReportBuyerList/ProductList/SupplierList, performanceTrendByHour, operateLogList/V2List, PlatformStatisticsSaleStatPageListV2, AmazonReportExportTask, reportCreate/QueryReportExportTask |\n\n### FBA发货（13个）\n接口详见 `references/fba.md`。\n\nFBAShipmentList, FBAReceivedInventory, ShipmentPlanLists, GetFbaProductList, GetInboundShipmentList, GetInboundShipmentListMwsDetailList, ShipFromAddressList, BoxInfo, GetHeadLogisticsFeeTypes, GetSeaTrackSupplierCarriers, QuerySTATaskList, StaTaskDetail, getInboundShipmentListMwsDetail\n\n### 亚马逊源表数据（20个）\n接口详见 `references/sourcedata.md`。\n\nAllOrders, FbaOrders, RefundOrders, Transaction, ManageInventory, DailyInventory, AfnFulfillableQuantity, ReservedInventory, RemovalLists, RemovalOrderListNew, RemovalShipmentList, SourceRemovalOrders, AdjustmentList, getAmazonFulfilledShipmentsList, getFbaAgeList, getFbaInventoryEventDetailList, v1getAmazonFulfilledShipmentsList, v1getFbaInventoryEventDetailList, fbaExchangeOrderList, fbmReturnOrderList\n\n### 补货建议（9个）\n接口详见 `references/fbasug.md`。\n\nGetSummaryList, ConfigASIN, ConfigMSKU, DailySalesInfoFeatureASIN, DailySalesInfoFeatureMSKU, InfoASIN, InfoMSKU, SourceListASIN, SourceListMSKU\n\n### 补货限制（2个）\n接口详见 `references/fbalimit.md`。\n\nGetIpiInfo, replenishmentRestrictionList\n\n### 采购（7个）\n接口详见 `references/purchase.md`。\n\nPurchaseOrderList, Supplier, changeOrderList, purchaseGetOrders, getPurchasePlans, getPurchaseReturnOrderList, purchaserLists\n\n### 仓库（32个）\n接口详见 `references/warehouse.md`。\n\n| 分组 | 接口 |\n|------|------|\n| 仓库/库存(11) | WarehouseLists, WarehouseStatement/New, InventoryDetails, inventoryBinDetails, wareHouseBinStatement, warehouseBin, FBAStock, FBAStock_v2, AwdWarehouseDetail |\n| 批次(2) | GetBatchDetailList, GetBatchStatementList |\n| 收货(4) | GetReceiveGoodRecords, PurchaseReceiptOrderList, ReceiptOrderQcList, getPackingData(GET) |\n| WMS(2) | WmsOrderList, WmsOrderDetail |\n| 海外仓(2) | OverseaWarehouseMatchList, OverSeasStockDetail |\n| 调拨/调整/盘点(3) | getStorageAdjustOrderList, getStorageAllocationList, checkGetOrderList/Detail |\n| 入库/出库(4) | inboundgetOrders, outboundgetOrders, listInbound, matchSkuList |\n| 其他(4) | getProcessOrderLists, ReturnList, removalInboundList, qualityInspectionOrderDetail |\n\n### 客服（18个）\n接口详见 `references/service.md`。\n\nFeedbackList, FeedbackListMws, CustomerList, AfterSalesWorkOrderList, PerformanceNoticeList, PerformanceNoticeDetail, mailDetail, mailLists, review, reviewDetail, reviewLists(GET), reviewV2, feedbackDetail, feedbackLists, customerServiceCrmcustomerIndex, customerServiceRmaManageList, storePerformanceList, voiceOfBuyerList\n\n### 物流（3个）\n接口详见 `references/logistics.md`。\n\nChannelList, QueryHeadLogisticsProvider, transportMethodList\n\n### 工具（4个）\n接口详见 `references/tools.md`。\n\nCompetitiveMonitorList, GetKeywordList, warningMessageGoodsList, warningMessageInventoryList\n\n### VC（7个）\n接口详见 `references/vc.md`。\n\nvcOrderPageList, vcOrderPoDetail, vcOrderDfDetail, vcDeliverPageList, vcDeliverDetail, listingManageVcListingPageList, platformAuthVcSellerPageList\n\n### 目标管理（2个）\n接口详见 `references/targetmanage.md`。\n\nStoreBatchSelect, UserBatchSelect\n\n### 多平台广告（28个）\n接口详见 `references/multiplatform-ads.md`。\n\n| 分组 | 接口 |\n|------|------|\n| TikTok(9) | queryCommonAdvertiserList, queryGmvStoreList, queryTiktokAdGroupList/AdList/CampaignList, queryAdvertiserList, queryGmvAdvertiserReportList/CampaignReportList/ItemGroupReportList |\n| Walmart(19) | queryAdGroupSvList, queryCampaignSpList, queryGroupSpList, queryPageTypeSPList, queryReportPageTypeSvList, reportAdGroupSbList, reportAdItemSbList/SpList/SvList, reportCampaignSbList/SvList, reportKeywordSbList/SpList/SvList, reportPageTypeSbList, reportPlatformSbList/SpList/SvList, reportSearchTrendsList |\n\n### 多平台V2（33个）\n接口详见 `references/multiplatform-v2.md`。\n\n| 分组 | 接口 |\n|------|------|\n| 订单(3) | MultiPlatOrderV2, newPlatformOrderList |\n| 店铺(1) | StoreInfoV2 |\n| Listing(2) | PairListV2, addCargoGoodsList |\n| 发货(4) | QueryShippingListV2, QueryShippingListPage, QueryWFSCargoPage/InventionPage |\n| 平台订单(8) | AliexpressListV2, aliexpressList, eBayList, walmartList, TemuList, TikTokList, SheinList, ShopifyVariantList |\n| 库存(6) | TemuCargo, CoupangStockList, FbsStockList, FbtStockList/Search, FullList, WayfairStockList |\n| 利润(4) | profitReportMsku/Order/Seller/Sku |\n| 其他(5) | WalmartPaymentQueryPage/Report, WalmartCommentList, LineList, addressReturnAddressList |\n\n## 店铺列表（--list-stores）\n\n调用 `GET /erp/sc/data/seller/lists` 接口，列出所有已授权亚马逊店铺。\n\n> **注意**：此接口需要领星 ERP **全量权限**。如果 AppKey 仅授权了广告数据，会返回 403。\n> 解决方法：在领星 ERP -> 开放接口中为该 AppKey 添加「基础数据」权限，或直接设置 `LINGXING_SID=<数字>` 跳过自动发现。\n\n## 注意事项\n\n- **SID 注入优先级**: `--params` 中显式传入 > `LINGXING_SID` 环境变量自动注入\n- **sid vs profile_id**: 广告类接口 sid 和 profile_id 二选一必填；dspReportOrderList 仅支持 profile_id\n- **GET 接口**: AccoutLists, AllMarketplace, ConceptSellerLists, GetProductTag, reviewLists, getPackingData 使用 GET 方法\n- **分页模式**: 大多数接口用 offset/length；WmsOrderList 等用 page/page_size；FBMOrderList 用 page/length\n- **响应格式**: `/cost/center/` 路径 API 数据在 `data.records` 或 `data.row_data` 下\n- **日期参数**: 报表类接口用 `report_date`（单日）；订单/利润类用 `start_date`/`end_date`（日期范围）；多平台V2用 Unix 时间戳（秒）\n- **Token 缓存**: token 自动缓存到 `/tmp/lingxing_token_*.json`，2小时有效\n- **限流**: 大多数接口令牌桶容量为 10，ProductAnalysisList 和 mwsOrders 仅为 1\n- **依赖**: 需要安装 `pycryptodome` 和 `requests`（`pip install pycryptodome requests`）\n\n## 错误处理\n\n| 场景 | 处理 |\n|------|------|\n| 环境变量未设置 | 脚本报错退出，提示设置 LINGXING_APP_ID/LINGXING_APP_SECRET |\n| Token 获取失败 | 检查 AppID/AppSecret 是否正确，IP 是否在白名单内 |\n| API 返回 code != 0 | 检查参数是否正确，参见错误信息 |\n| --list-stores 返回 403 | AppKey 仅有广告权限；设置 LINGXING_SID 直接指定店铺 |\n| 依赖未安装 | `pip install pycryptodome requests` |\n\n<!-- LF_LARGE_RESPONSE_BLOCK -->\n## Handling Large Responses\n\nTo avoid overflowing the agent context, persist the response to disk and extract only the fields you need:\n\n```\npython scripts/response_io.py run --script scripts/lingxing.py --out-dir <DIR> '<params>'\npython scripts/response_io.py read <file> --fields \"<paths>\"   # or --path \"<JMESPath>\"\n```\n\n> Pick `--out-dir` outside 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.\n\n`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.\n\n**When to prefer this pattern** — apply your judgment based on the response characteristics, e.g.:\n- High field count per record, or fields you don't need\n- Batch/paginated results (multiple items per call)\n- Long-text fields (descriptions, reviews, HTML, time series)\n- Output reused across later steps rather than consumed immediately\n\nFor small, single-use responses, calling the main script directly is fine.\n\n⚠️ The preview is a truncated schema + sample, not the full data. Any field-level decision must read from the persisted file via `read`.\n<!-- /LF_LARGE_RESPONSE_BLOCK -->\n\n## 解决认证和积分问题\n发生以下异常情况时，采用 references/onboarding.md 引导解决问题：\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n## 积分消耗规则\n\n不消耗积分。\n\nFile v1.0.6:_meta.json\n\n{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-lingxing-erp\",\n  \"version\": \"1.0.6\",\n  \"publishedAt\": 1786719422390\n}\n\nFile v1.0.6:references/api.md\n\n# 领星 OpenAPI — 调用说明（LinkFox 包装入口）\n\n本页对应 LinkFox skill **`linkfox-lingxing-erp`**：由 LinkFox 仓库收录领星官方材料并做路径说明，**请求仍直连领星**（非 LinkFox 工具网关）。完整接口清单、参数与返回字段见同目录下各专题文档；本页仅汇总认证、域名与脚本用法。\n\n## Base URL\n\n- **Host**: `https://openapi.lingxing.com`\n- 具体路径由 `scripts/lingxing.py` 内 `SPECIAL_PATHS` 与各模块约定决定，详见 `SKILL.md` 与各 `references/*.md`。\n\n## 认证与凭证\n\n| 变量 | 必填 | 说明 |\n|------|------|------|\n| `LINGXING_APP_ID` | 是 | 领星开放接口 AppID |\n| `LINGXING_APP_SECRET` | 是 | 领星开放接口 AppSecret |\n| `LINGXING_SID` | 否 | 默认店铺 SID；未在 `--params` 中写 `sid` 时由脚本注入 |\n\n在领星 ERP → **开放接口** 中创建应用并获取密钥；IP 白名单按领星文档配置。\n\n## 推荐执行方式\n\n在 skill 根目录 `skills/linkfox-lingxing-erp/` 下：\n\n```bash\nexport LINGXING_APP_ID=...\nexport LINGXING_APP_SECRET=...\n\npython3 scripts/lingxing.py --list-stores\npython3 scripts/lingxing.py --api help\npython3 scripts/lingxing.py --api <接口名> --params '<JSON>'\n```\n\n支持 `--all`、`--page-size` 等，见 `SKILL.md`「使用方式」与 `scripts/lingxing.py` 头部说明。\n\n## 依赖\n\n脚本需 **`requests`** 与 **`pycryptodome`**：\n\n```bash\npip install requests pycryptodome\n```\n\n## 分模块参考索引\n\n| 文档 | 内容 |\n|------|------|\n| `newad-report.md` | 新广告报表 SP/SB/SD 等 |\n| `basedata.md` | 广告基础数据 |\n| `basicdata-full.md` | 基础数据全量 |\n| `sale-ops.md` / `sale-full.md` | 销售订单、Listing、促销等 |\n| `product.md` | 产品 |\n| `finance.md` | 财务利润、结算、发票等 |\n| `statistics.md` | 统计报表 |\n| `fba.md` / `fbasug.md` / `fbalimit.md` | FBA 发货、补货建议与限制 |\n| `sourcedata.md` | 亚马逊源表 |\n| `purchase.md` | 采购 |\n| `warehouse.md` | 仓库库存 |\n| `service.md` | 客服、Review 等 |\n| `logistics.md` | 物流 |\n| `tools.md` | 工具类 |\n| `vc.md` | VC |\n| `targetmanage.md` | 目标管理 |\n| `multiplatform-ads.md` / `multiplatform-v2.md` | 多平台广告与订单 |\n\n## Feedback\n\n若需向 LinkFox 反馈本 skill 使用体验，可按仓库内其他 skill 的约定调用 Feedback API（`skillName` 使用 `linkfox-lingxing-erp`）。\n\nFile v1.0.6:references/basedata.md\n\n# 领星新广告基础数据接口参考（newAd/baseData）\n\n所有接口均为 POST 请求，域名：`https://openapi.lingxing.com`\n所有接口均为**只读查询**，令牌桶容量 10（`sbDivideAsinReports` 为 1）。\n`sid` 与 `profile_id` 二选一必填（`dspAccountList` 除外）。\n\n---\n\n## dspAccountList - 查询广告账号列表\n\n**路径**: `/basicOpen/baseData/account/list`（特殊路径）\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| type | 是 | string | `dsp` / `seller` / `vendor` |\n| offset | 否 | int | 分页偏移，默认 0 |\n| length | 否 | int | 每页条数，默认 20 |\n\n**关键返回字段**: profile_id, sid, name, type, country_code, currency_code, status(-1删除/0停止/1正常/2授权异常)\n\n---\n\n## portfolios - 广告组合\n\n**路径**: `/pb/openapi/newad/portfolios`\n\n**参数**: sid/profile_id, offset, length, next_token\n\n**关键返回字段**: portfolio_id, profile_id, name, state, budget(amount/policy/startDate/endDate), in_budget, serving_status\n\n---\n\n## SP 广告基础数据（6个）\n\n### spCampaigns - SP广告活动\n\n**路径**: `/pb/openapi/newad/spCampaigns`\n\n**参数**: sid/profile_id, state(enabled/paused/archived), offset, length, next_token\n\n**关键返回字段**: campaign_id, profile_id, name, targeting_type(auto/manual), state, serving_status, daily_budget, start_date, end_date, bidding(strategy/adjustments), portfolio_id, tags\n\n---\n\n### spAdGroups - SP广告组\n\n**路径**: `/pb/openapi/newad/spAdGroups`\n\n**参数**: sid/profile_id, state, campaign_id(可选), offset, length, next_token\n\n**关键返回字段**: ad_group_id, campaign_id, profile_id, name, default_bid, state, serving_status, bid_optimization\n\n---\n\n### spProductAds - SP广告商品\n\n**路径**: `/pb/openapi/newad/spProductAds`\n\n**参数**: sid/profile_id, state, ad_group_id(可选), offset, length, next_token\n\n**关键返回字段**: ad_id, campaign_id, ad_group_id, profile_id, sku, asin, state, serving_status\n\n---\n\n### spKeywords - SP关键词\n\n**路径**: `/pb/openapi/newad/spKeywords`\n\n**参数**: sid/profile_id, state, campaign_id(可选), ad_group_id(可选), offset, length, next_token\n\n**关键返回字段**: keyword_id, campaign_id, ad_group_id, profile_id, keyword_text, match_type(exact/phrase/broad), bid, state, serving_status\n\n---\n\n### spTargets - SP商品定位\n\n**路径**: `/pb/openapi/newad/spTargets`\n\n**参数**: sid/profile_id, state, campaign_id(可选), ad_group_id(可选), offset, length, next_token\n\n**关键返回字段**: target_id, campaign_id, ad_group_id, profile_id, expression_type(auto/manual), expression, resolved_expression, bid, state, serving_status\n\n---\n\n### spNegativeTargetsOrKeywords - SP否定投放\n\n**路径**: `/pb/openapi/newad/spNegativeTargetsOrKeywords`\n\n**参数**: sid/profile_id, campaign_id(可选), ad_group_id(可选), offset, length, next_token\n\n**关键返回字段**: campaign_id, ad_group_id, profile_id, negative_type(negativeKeyword/negativeAsin/negativeBrand), negative_text, negative_match_type, state\n\n---\n\n## SB 广告基础数据（5个）\n\n### hsaCampaigns - SB广告活动\n\n**路径**: `/pb/openapi/newad/hsaCampaigns`\n\n**参数**: sid/profile_id, state, offset, length, next_token\n\n**关键返回字段**: campaign_id, profile_id, name, budget, budget_type, state, serving_status, start_date, landing_page, bid_multiplier\n\n---\n\n### hsaAdGroups - SB广告组\n\n**路径**: `/pb/openapi/newad/hsaAdGroups`\n\n**参数**: sid/profile_id, state, campaign_id(可选), offset, length, next_token\n\n**关键返回字段**: ad_group_id, campaign_id, profile_id, name, state, serving_status\n\n---\n\n### hsaProductAds - SB广告创意\n\n**路径**: `/pb/openapi/newad/hsaProductAds`\n\n**参数**: sid/profile_id, offset, length, next_token\n\n**关键返回字段**: ad_id, campaign_id, ad_group_id, profile_id, state, creative(广告创意结构)\n\n---\n\n### sbTargeting - SB广告投放\n\n**路径**: `/pb/openapi/newad/sbTargeting`\n\n**参数**: sid/profile_id, ads_type(SB/SBV/ALL), state, offset, length, next_token\n\n**关键返回字段**: campaign_id, ad_group_id, keyword_id, keyword_text, keyword_bid, match_type, target_id, expression, target_bid, target_state, resolved_expression\n\n---\n\n### hsaNegativeKeywords - SB否定关键词\n\n**路径**: `/pb/openapi/newad/hsaNegativeKeywords`\n\n**参数**: sid/profile_id, state, campaign_id(可选), offset, length, next_token\n\n**关键返回字段**: keyword_id, campaign_id, ad_group_id, profile_id, keyword_text, match_type, state\n\n---\n\n### hsaNegativeTargets - SB否定商品投放\n\n**路径**: `/pb/openapi/newad/hsaNegativeTargets`\n\n**参数**: sid/profile_id, state, campaign_id(可选), offset, length, next_token\n\n**关键返回字段**: target_id, campaign_id, ad_group_id, profile_id, expression_type, expression, resolved_expression, state\n\n---\n\n### sbDivideAsinReports - SB分摊\n\n**路径**: `/pb/openapi/newad/sbDivideAsinReports`\n**令牌桶容量**: 1\n\n**参数**: profile_id(必填，不支持sid), report_date(Y-m-d), offset, length, next_token\n\n---\n\n## SD 广告基础数据（5个）\n\n### sdCampaigns - SD广告活动\n\n**路径**: `/pb/openapi/newad/sdCampaigns`\n\n**参数**: sid/profile_id, state, offset, length, next_token\n\n**关键返回字段**: campaign_id, profile_id, name, tactic(T00001/T00020/T00030), cost_type, budget_type, budget, state, serving_status, start_date\n\n---\n\n### sdAdGroups - SD广告组\n\n**路径**: `/pb/openapi/newad/sdAdGroups`\n\n**参数**: sid/profile_id, state, campaign_id(可选), offset, length, next_token\n\n**关键返回字段**: ad_group_id, campaign_id, profile_id, name, default_bid, state, serving_status, bid_optimization\n\n---\n\n### sdProductAds - SD广告商品\n\n**路径**: `/pb/openapi/newad/sdProductAds`\n\n**参数**: sid/profile_id, state, ad_group_id(可选), offset, length, next_token\n\n**关键返回字段**: ad_id, ad_group_id, campaign_id, profile_id, sku, asin, state, serving_status\n\n---\n\n### sdTargets - SD商品定位\n\n**路径**: `/pb/openapi/newad/sdTargets`\n\n**参数**: sid/profile_id, state, campaign_id(可选), offset, length, next_token\n\n**关键返回字段**: target_id, campaign_id, ad_group_id, profile_id, expression_type, expression, resolved_expression, bid, state, serving_status\n\n---\n\n### sdNegativeTargets - SD否定商品定位\n\n**路径**: `/pb/openapi/newad/sdNegativeTargets`\n\n**参数**: sid/profile_id, state, campaign_id(可选), offset, length, next_token\n\n**关键返回字段**: target_id, campaign_id, ad_group_id, profile_id, expression_type, expression, resolved_expression, state\n\n---\n\n## 通用说明\n\n- `state` 过滤：`enabled` / `paused` / `archived`，不传返回全部\n- `next_token` 分页游标：与 `offset` 同时传时以 `next_token` 为准，推荐优先用 `next_token`\n- `sbDivideAsinReports` 仅支持 `profile_id`，不支持 `sid`，且令牌桶容量仅 1，需串行调用\n\nFile v1.0.6:references/basicdata-full.md\n\n# 领星基础数据接口参考\n\n所有接口均为 POST 请求（除标注 GET 外），域名：`https://openapi.lingxing.com`\n\n---\n\n## AccoutLists - 查询ERP账户列表\n\n**路径**: `/erp/sc/data/account/lists`\n**方法**: GET（无请求参数）\n\n**关键返回字段**: uid, username, realname, mobile, email, status（0禁用/1正常）, role, seller（店铺权限）, is_master\n\n---\n\n## AllMarketplace - 查询亚马逊市场列表\n\n**路径**: `/erp/sc/data/seller/allMarketplace`\n**方法**: GET（无请求参数）\n\n**关键返回字段**: mid（领星站点ID）, region, country, code（国家代码如US/UK）, marketplace_id（亚马逊市场ID）\n\n---\n\n## AttachmentDownload - 附件下载\n\n**路径**: `/erp/sc/routing/common/file/download`\n**方法**: POST\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| file_id | 是 | int | 附件id（来自对应功能接口返回的附件id） |\n\n**关键返回字段**: file_name, mime_type, content（base64编码的文件内容）\n\n---\n\n## ConceptSellerLists - 查询概念店铺列表\n\n**路径**: `/erp/sc/data/seller/conceptLists`\n**方法**: GET（无请求参数）\n\n**关键返回字段**: id（概念店铺ID）, mid（概念市场ID）, name, seller_id, seller_account_name, seller_account_id, region, country, status（1启用/2禁用）\n\n---\n\n## Currency - 查询货币月汇率\n\n**路径**: `/erp/sc/routing/finance/currency/currencyMonth`\n**方法**: POST\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| date | 是 | string | 汇率月份，格式 YYYY-MM |\n\n**关键返回字段**: date, code（币种代码如CNY/USD）, icon, name, rate_org（官方汇率）, my_rate（自定义汇率）\n\n---\n\n## CustomAttachmentDownload - 自定义附件下载\n\n**路径**: `/erp/sc/routing/customized/file/download`\n**方法**: POST\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| file_id | 是 | string | 附件文件id（来自订单详情接口） |\n\n**关键返回字段**: file_name, mime_type, content（base64编码文件内容）\n\n---\n\n## StateList - 查询省份列表\n\n**路径**: `/basicOpen/multiplatform/profit/report/stateList`\n**方法**: POST\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| countryCode | 是 | string | 国家编码二字码，如 US/AF/DE |\n\n**关键返回字段**: data>>states>>countryCode, data>>states>>stateOrProvinceName, data>>states>>code（州/省编码）\n\n---\n\n## WorldStateLists - 查询亚马逊国家地区列表\n\n**路径**: `/erp/sc/data/worldState/lists`\n**方法**: POST\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| country_code | 是 | string | 国家code，来自 AllMarketplace 接口的 code 字段 |\n\n**关键返回字段**: country_code, state_or_province_name, code（地区code）\n\n---\n\nFile v1.0.6:references/fba.md\n\n# 领星FBA接口参考\n\n所有接口均为 POST 请求，域名：`https://openapi.lingxing.com`\n\n---\n\n## fbaShipmentList - 查询FBA发货单列表\n\n**路径**: `/erp/sc/data/fba_report/shipmentList`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sid | 是 | int | 店铺ID |\n| start_date | 否 | string | 开始日期，格式 Y-m-d |\n| end_date | 否 | string | 结束日期 |\n| status | 否 | string | 发货单状态 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 分页长度，默认1000 |\n\n**关键返回字段**: sid, shipment_id, shipment_name, status, destination_fulfillment_center_id, label_prep_type, create_date, item_list[seller_sku/fnsku/asin/quantity_shipped]\n\n---\n\n## fbaReceivedInventory - 查询FBA已收货库存\n\n**路径**: `/erp/sc/data/fba_report/receivedInventory`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sid | 是 | int | 店铺ID |\n| start_date | 否 | string | 开始日期，格式 Y-m-d |\n| end_date | 否 | string | 结束日期 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 分页长度，默认1000 |\n\n**关键返回字段**: sid, shipment_id, fnsku, asin, seller_sku, quantity_shipped, quantity_received, quantity_in_case\n\n---\n\n## shipmentPlanLists - 查询FBA发货计划列表\n\n**路径**: `/erp/sc/data/fba_report/shipmentPlanLists`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sid | 是 | int | 店铺ID |\n| start_date | 否 | string | 开始日期，格式 Y-m-d |\n| end_date | 否 | string | 结束日期 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 分页长度，默认1000 |\n\n**关键返回字段**: sid, plan_id, plan_name, status, create_date, item_list[seller_sku/asin/quantity]\n\n---\n\n## getFbaProductList - 查询FBA产品列表\n\n**路径**: `/erp/sc/routing/fba/shipment/getFbaProductList`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sid | 是 | int | 店铺ID |\n| search_field | 否 | string | 搜索字段：seller_sku/asin/fnsku |\n| search_value | 否 | string | 搜索值 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 分页长度，默认20 |\n\n**关键返回字段**: sid, seller_sku, asin, fnsku, product_name, local_sku, condition, prep_type\n\n---\n\n## getInboundShipmentList - 查询FBA入库发货单列表\n\n**路径**: `/erp/sc/routing/storage/shipment/getInboundShipmentList`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sid | 是 | int | 店铺ID |\n| start_date | 否 | string | 开始日期，格式 Y-m-d |\n| end_date | 否 | string | 结束日期 |\n| status | 否 | string | 发货单状态 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 分页长度，默认20 |\n\n**关键返回字段**: sid, shipment_id, shipment_name, status, fulfillment_center_id, create_date, total_quantity\n\n---\n\n## getInboundShipmentListMwsDetailList - 查询FBA入库发货单商品明细列表\n\n**路径**: `/erp/sc/routing/storage/shipment/getInboundShipmentListMwsDetailList`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sid | 是 | int | 店铺ID |\n| shipment_id | 是 | string | 发货单ID |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 分页长度，默认20 |\n\n**关键返回字段**: shipment_id, seller_sku, fnsku, asin, quantity_shipped, quantity_received, quantity_in_case\n\n---\n\n## shipFromAddressList - 查询FBA发货地址列表\n\n**路径**: `/erp/sc/routing/fba/shipment/shipFromAddressList`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sid | 是 | int | 店铺ID |\n\n**关键返回字段**: address_id, name, address_line1, city, state_or_province_code, country_code, postal_code\n\n---\n\n## boxInfo - 查询FBA箱规信息\n\n**路径**: `/erp/sc/routing/fba/shipment/boxInfo`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sid | 是 | int | 店铺ID |\n| shipment_id | 是 | string | 发货单ID |\n\n**关键返回字段**: shipment_id, box_list[box_no/length/width/height/weight/quantity/item_list]\n\n---\n\n## getHeadLogisticsFeeTypes - 查询头程费用类型\n\n**路径**: `/erp/sc/routing/fba/shipment/getHeadLogisticsFeeTypes`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sid | 否 | int | 店铺ID |\n\n**关键返回字段**: fee_type_id, fee_type_name, currency\n\n---\n\n## getSeaTrackSupplierCarriers - 查询海运跟踪供应商承运商\n\n**路径**: `/erp/sc/routing/fba/shipment/getSeaTrackSupplierCarriers`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| supplier_id | 否 | int | 供应商ID |\n\n**关键返回字段**: carrier_id, carrier_name, supplier_id\n\n---\n\n## querySTATaskList - 查询STA入库计划列表\n\n**路径**: `/amzStaServer/openapi/inbound-plan/page`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sid | 是 | int | 店铺ID |\n| status | 否 | string | 计划状态 |\n| start_date | 否 | string | 开始日期，格式 Y-m-d |\n| end_date | 否 | string | 结束日期 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 分页长度，默认20 |\n\n**关键返回字段**: inbound_plan_id, sid, status, create_date, total_boxes, total_quantity, marketplace_id\n\n---\n\n## staTaskDetail - 查询STA入库计划详情\n\n**路径**: `/amzStaServer/openapi/inbound-plan/detail`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| inbound_plan_id | 是 | string | 入库计划ID |\n| sid | 是 | int | 店铺ID |\n\n**关键返回字段**: inbound_plan_id, status, marketplace_id, shipment_list[shipment_id/status/destination/quantity], item_list[seller_sku/fnsku/asin/quantity]\n\n---\n\n## getInboundShipmentListMwsDetail - 查询FBA入库发货单商品明细\n\n**路径**: `/erp/sc/routing/storage/shipment/getInboundShipmentListMwsDetail`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sid | 是 | int | 店铺ID |\n| shipment_id | 是 | string | 发货单ID |\n\n**关键返回字段**: shipment_id, seller_sku, fnsku, asin, quantity_shipped, quantity_received, prep_detail_list\n\nFile v1.0.6:references/fbalimit.md\n\n# 领星FBA库容限制接口参考\n\n所有接口均为 POST 请求，域名：`https://openapi.lingxing.com`\n\n---\n\n## GetIpiInfo - 查询IPI绩效指标信息\n\n**路径**: `/erp/sc/routing/fbaLimit/restock/getIpiInfo`\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| offset | 否 | int | 分页偏移量 |\n| length | 否 | int | 分页长度 |\n| sids | 否 | string | 店铺id，多个以英文逗号分隔 |\n| seller_ids | 否 | string | 亚马逊卖家id，多个以英文逗号分隔 |\n| mids | 否 | string | 站点id，多个以英文逗号分隔 |\n\n**关键返回字段**: 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\n\n---\n\n## replenishmentRestrictionList - 查询补货限制列表\n\n**路径**: `/basicOpen/openapi/replenishmentRestriction/page/list`\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| storage_type | 是 | string | 仓储类型 |\n| offset | 否 | int | 分页偏移量 |\n| length | 否 | int | 分页长度 |\n| sids | 否 | string | 店铺id，多个以英文逗号分隔 |\n\n**关键返回字段**: 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\n\n---\n\nFile v1.0.6:references/fbasug.md\n\n# 领星FBA补货建议接口参考\n\n所有接口均为 POST 请求，域名：`https://openapi.lingxing.com`\n\n---\n\n## GetSummaryList - 查询补货建议汇总列表\n\n**路径**: `/erp/sc/routing/restocking/analysis/getSummaryList`\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| data_type | 是 | int | 数据维度类型 |\n| sid_list | 否 | array | 店铺id列表 |\n| asin_list | 否 | array | ASIN列表 |\n| msku_list | 否 | array | MSKU列表 |\n| mode | 否 | int | 模式 |\n| listing_date_range | 否 | array | 上架日期范围 |\n| offset | 否 | int | 分页偏移量 |\n| length | 否 | int | 分页长度 |\n\n**关键返回字段**: data>>basic_info>>data_type, data>>basic_info>>node_type, data>>basic_info>>sid, data>>basic_info>>asin, data>>basic_info>>msku_fnsku_list\n\n---\n\n## ConfigASIN - 查询ASIN补货配置\n\n**路径**: `/erp/sc/routing/fbaSug/asin/getConfig`\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sid | 是 | int | 店铺id |\n| asin | 是 | string | ASIN |\n\n**关键返回字段**: data>>info>>days_total, data>>info>>days_total2, data>>info>>days_plan, data>>info>>days_purchase, data>>info>>days_qc\n\n---\n\n## ConfigMSKU - 查询MSKU补货配置\n\n**路径**: `/erp/sc/routing/fbaSug/msku/getConfig`\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sid | 是 | string | 店铺id |\n| msku | 是 | string | MSKU |\n\n**关键返回字段**: data>>info>>days_total, data>>info>>days_total2, data>>info>>days_plan, data>>info>>days_purchase, data>>info>>days_qc\n\n---\n\n## DailySalesInfoFeatureASIN - 查询ASIN日销售特征数据\n\n**路径**: `/erp/sc/routing/fbaSug/asin/getDailySalesInfoFeature`\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sid | 是 | int | 店铺id |\n| asin | 是 | string | ASIN |\n| sug_type | 是 | int | 建议类型 |\n| mode | 否 | int | 模式 |\n\n**关键返回字段**: data>>list（日期销量列表）, data>>sug_date_line>>date, data>>sug_date_line>>desc, data>>sug_date_line>>title\n\n---\n\n## DailySalesInfoFeatureMSKU - 查询MSKU日销售特征数据\n\n**路径**: `/erp/sc/routing/fbaSug/msku/getDailySalesInfoFeature`\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sid | 是 | int | 店铺id |\n| msku | 是 | string | MSKU |\n| sug_type | 是 | int | 建议类型 |\n| mode | 否 | int | 模式 |\n\n**关键返回字段**: data>>list（日期销量列表）, data>>sug_date_line>>date, data>>sug_date_line>>desc, data>>sug_date_line>>title\n\n---\n\n## InfoASIN - 查询ASIN补货建议信息\n\n**路径**: `/erp/sc/routing/fbaSug/asin/getInfo`\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sid | 是 | int | 店铺id |\n| asin | 是 | string | ASIN |\n| mode | 否 | int | 模式 |\n\n**关键返回字段**: data>>sid, data>>asin, data>>mode, data>>quantity_fba_valid, data>>msku_list>>msku\n\n---\n\n## InfoMSKU - 查询MSKU补货建议信息\n\n**路径**: `/erp/sc/routing/fbaSug/msku/getInfo`\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sid | 是 | int | 店铺id |\n| msku | 是 | string | MSKU |\n| mode | 否 | int | 模式 |\n\n**关键返回字段**: data>>sid, data>>msku, data>>mode, data>>quantity_sug_replenishment, data>>quantity_sug_send, data>>quantity_fba_valid\n\n---\n\n## SourceListASIN - 查询ASIN补货来源列表\n\n**路径**: `/erp/sc/routing/fbaSug/asin/getSourceList`\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sid | 是 | int | 店铺id |\n| asin | 是 | string | ASIN |\n| type | 否 | string | 补货来源类型 |\n| mode | 否 | string | 模式 |\n\n**关键返回字段**: data>>mode, data>>source_list>>quantity, data>>source_list>>type, data>>source_list>>amazon_sale_date, data>>source_list>>remark\n\n---\n\n## SourceListMSKU - 查询MSKU补货来源列表\n\n**路径**: `/erp/sc/routing/fbaSug/msku/getSourceList`\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sid | 是 | int | 店铺id |\n| msku | 是 | string | MSKU |\n| type | 否 | string | 补货来源类型 |\n| mode | 否 | string | 模式 |\n\n**关键返回字段**: data>>mode, data>>source_list>>quantity, data>>source_list>>type, data>>source_list>>amazon_sale_date, data>>source_list>>remark\n\n---\n\nFile v1.0.6:references/finance.md\n\n# 领星财务接口参考\n\n所有接口均为 POST 请求，域名：`https://openapi.lingxing.com`\n\n---\n\n## profitAsin - 查询ASIN利润报表\n\n**路径**: `/erp/sc/routing/finance/ProfitState/profitAsin`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| month | 是 | string | 月份，格式 Y-m |\n| sids | 否 | string | 店铺ID，多个逗号分隔 |\n| currency_type | 否 | string | 币种：1=CNY，2=USD，3=EUR等 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，上限200 |\n\n**关键返回字段**: sid, asin, parent_asin, seller_sku, month, sales_amount, cost, profit, profit_rate, fba_fee, commission, ad_cost\n\n---\n\n## profitAsinSon - 查询ASIN子变体利润\n\n**路径**: `/erp/sc/routing/finance/ProfitState/profitAsinSon`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| month | 是 | string | 月份，格式 Y-m |\n| sids | 否 | string | 店铺ID，多个逗号分隔 |\n| asin | 否 | string | 父ASIN |\n| version | 否 | int | 版本号 |\n| currency_type | 否 | string | 币种 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，上限200 |\n\n**关键返回字段**: sid, asin, seller_sku, month, sales_amount, profit, profit_rate\n\n---\n\n## profitSettlement - 查询结算利润报表\n\n**路径**: `/erp/sc/routing/finance/ProfitState/profitSettlement`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sids | 否 | string | 店铺ID，多个逗号分隔 |\n| start_date | 是 | string | 开始日期，格式 Y-m-d |\n| end_date | 是 | string | 结束日期 |\n| currency_type | 否 | string | 币种 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，上限200 |\n\n**关键返回字段**: sid, amazon_order_id, settlement_id, sales_amount, fba_fee, commission, profit, currency\n\n---\n\n## profitMsku - 查询MSKU利润报表\n\n**路径**: `/erp/sc/routing/finance/ProfitState/profitMsku`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| month | 是 | string | 月份，格式 Y-m |\n| sids | 否 | string | 店铺ID，多个逗号分隔 |\n| currency_type | 否 | string | 币种 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，上限200 |\n\n**关键返回字段**: sid, seller_sku, asin, month, sales_amount, profit, profit_rate, fba_fee, commission\n\n---\n\n## settlementReport - 查询结算报告\n\n**路径**: `/cost/center/api/settlement/report`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| amazonSellerIds | 否 | array | 亚马逊店铺ID列表 |\n| sids | 否 | array | 领星店铺ID列表 |\n| timeType | 是 | int | 时间类型：1=结算开始时间，2=结算结束时间 |\n| filterBeginDate | 是 | string | 开始日期，格式 Y-m-d |\n| filterEndDate | 是 | string | 结束日期 |\n\n**关键返回字段**: settlement_id, sid, start_date, end_date, total_amount, currency\n\n---\n\n## costStream - 查询成本流水\n\n**路径**: `/cost/center/api/cost/stream`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| mskus | 否 | array | MSKU列表 |\n| business_types | 是 | array | 业务类型列表 |\n| query_type | 是 | int | 查询类型 |\n| start_date | 否 | string | 开始日期 |\n| end_date | 否 | string | 结束日期 |\n\n**关键返回字段**: msku, business_type, amount, currency, date, remark\n\n---\n\n## orderProfitListMSKU - 查询订单MSKU利润明细\n\n**路径**: `/basicOpen/finance/mreport/OrderProfit`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sids | 否 | string | 店铺ID，多个逗号分隔 |\n| startDate | 是 | string | 开始日期，格式 Y-m-d |\n| endDate | 是 | string | 结束日期 |\n| searchField | 否 | string | 搜索字段：amazon_order_id/seller_sku/asin |\n| searchValue | 否 | string | 搜索值 |\n| currencyCode | 否 | string | 货币代码 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: amazon_order_id, sid, seller_sku, asin, sales_amount, fba_fee, commission, profit, currency\n\n---\n\n## invoiceList - 查询发票列表\n\n**路径**: `/bd/profit/report/open/report/ads/invoice/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sids | 否 | array | 店铺ID列表 |\n| start_date | 否 | string | 开始日期 |\n| end_date | 否 | string | 结束日期 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: invoice_id, sid, invoice_date, amount, currency, status, campaign_count\n\n---\n\n## invoiceDetail - 查询发票详情\n\n**路径**: `/bd/profit/report/open/report/ads/invoice/detail`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| invoice_id | 是 | string | 发票ID |\n| sid | 是 | int | 店铺ID |\n\n**关键返回字段**: invoice_id, sid, invoice_date, amount, currency, status, line_items\n\n---\n\n## invoiceCampaignList - 查询发票广告活动列表\n\n**路径**: `/bd/profit/report/open/report/ads/invoice/campaign/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| invoice_id | 是 | string | 发票ID |\n| sid | 是 | int | 店铺ID |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: campaign_id, campaign_name, spend, impressions, clicks\n\n---\n\n## queryReceiptFundsList - 查询收款记录列表\n\n**路径**: `/basicOpen/finance/queryReceiptFundsList`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sids | 否 | string | 店铺ID，多个逗号分隔 |\n| start_date | 否 | string | 开始日期 |\n| end_date | 否 | string | 结束日期 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: receipt_id, sid, amount, currency, receipt_date, status\n\n---\n\n## requestFundsOrderList - 查询付款单列表\n\n**路径**: `/basicOpen/finance/requestFunds/order/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| start_date | 否 | string | 开始日期 |\n| end_date | 否 | string | 结束日期 |\n| status | 否 | int | 状态 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: order_id, amount, currency, status, create_time, type\n\n---\n\n## settlementExportUrlGet - 获取结算报告导出URL\n\n**路径**: `/bd/sp/api/open/settlement/export/url/get`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| settlement_id | 是 | string | 结算ID |\n| sid | 是 | int | 店铺ID |\n\n**关键返回字段**: url, expires_at\n\n---\n\n## bdAsin - 查询ASIN利润分析报表\n\n**路径**: `/bd/profit/report/open/report/asin/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| startDate | 是 | string | 开始日期，格式 Y-m-d |\n| endDate | 是 | string | 结束日期 |\n| sids | 否 | array | 店铺ID列表 |\n| currencyCode | 否 | string | 货币代码 |\n| monthlyQuery | 否 | int | 是否按月查询：0=否，1=是 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: asin, sid, sales_amount, ad_cost, fba_fee, commission, profit, profit_rate, currency\n\n---\n\n## bdMsku - 查询MSKU利润分析报表\n\n**路径**: `/bd/profit/report/open/report/msku/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| startDate | 是 | string | 开始日期 |\n| endDate | 是 | string | 结束日期 |\n| sids | 否 | array | 店铺ID列表 |\n| currencyCode | 否 | string | 货币代码 |\n| monthlyQuery | 否 | int | 是否按月查询 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: seller_sku, asin, sid, sales_amount, profit, profit_rate, currency\n\n---\n\n## bdOrder - 查询订单利润分析报表\n\n**路径**: `/bd/profit/report/open/report/order/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| startDate | 是 | string | 开始日期 |\n| endDate | 是 | string | 结束日期 |\n| sids | 否 | array | 店铺ID列表 |\n| currencyCode | 否 | string | 货币代码 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: amazon_order_id, sid, sales_amount, profit, profit_rate, currency, purchase_date\n\n---\n\n## bdParentAsin - 查询父ASIN利润分析报表\n\n**路径**: `/bd/profit/report/open/report/parent/asin/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| startDate | 是 | string | 开始日期 |\n| endDate | 是 | string | 结束日期 |\n| sids | 否 | array | 店铺ID列表 |\n| currencyCode | 否 | string | 货币代码 |\n| monthlyQuery | 否 | int | 是否按月查询 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: parent_asin, sid, sales_amount, profit, profit_rate, currency\n\n---\n\n## bdSku - 查询SKU利润分析报表\n\n**路径**: `/bd/profit/report/open/report/sku/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| startDate | 是 | string | 开始日期 |\n| endDate | 是 | string | 结束日期 |\n| sids | 否 | array | 店铺ID列表 |\n| currencyCode | 否 | string | 货币代码 |\n| monthlyQuery | 否 | int | 是否按月查询 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: sku, asin, sid, sales_amount, profit, profit_rate, currency\n\n---\n\n## bdSeller - 查询店铺利润分析报表\n\n**路径**: `/bd/profit/report/open/report/seller/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| startDate | 是 | string | 开始日期 |\n| endDate | 是 | string | 结束日期 |\n| sids | 否 | array | 店铺ID列表 |\n| currencyCode | 否 | string | 货币代码 |\n| monthlyQuery | 否 | int | 是否按月查询 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: sid, seller_name, sales_amount, profit, profit_rate, currency\n\n---\n\n## bdSellerSummary - 查询店铺利润汇总报表\n\n**路径**: `/bd/profit/report/open/report/seller/summary/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| startDate | 是 | string | 开始日期 |\n| endDate | 是 | string | 结束日期 |\n| sids | 否 | array | 店铺ID列表 |\n| currencyCode | 否 | string | 货币代码 |\n\n**关键返回字段**: sid, seller_name, total_sales, total_profit, profit_rate, currency\n\n---\n\n## centerOdsDetailQuery - 查询成本中心ODS明细\n\n**路径**: `/cost/center/ods/detail/query`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| mskus | 否 | array | MSKU列表 |\n| start_date | 否 | string | 开始日期 |\n| end_date | 否 | string | 结束日期 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: msku, cost_type, amount, currency, date, warehouse\n\n---\n\n## feeManagementList - 查询其他费用列表\n\n**路径**: `/bd/fee/management/open/feeManagement/otherFee/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sids | 否 | array | 店铺ID列表 |\n| start_date | 否 | string | 开始日期 |\n| end_date | 否 | string | 结束日期 |\n| fee_type | 否 | string | 费用类型 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: fee_id, sid, fee_type, fee_name, amount, currency, date\n\n---\n\n## feeManagementType - 查询费用类型列表\n\n**路径**: `/bd/fee/management/open/feeManagement/otherFee/type`\n**令牌桶容量**: 1\n\n**参数**: 无\n\n**关键返回字段**: type_id, type_name, type_code\n\n---\n\n## lazadaPayoutList - 查询Lazada打款记录\n\n**路径**: `/basicOpen/finance/lazada/payout/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| store_ids | 否 | array | 店铺ID列表 |\n| start_date | 否 | string | 开始日期 |\n| end_date | 否 | string | 结束日期 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: payout_id, store_id, amount, currency, payout_date, status\n\n---\n\n## lazadaSettlementList - 查询Lazada结算列表\n\n**路径**: `/basicOpen/finance/lazada/settlement/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| store_ids | 否 | array | 店铺ID列表 |\n| start_date | 否 | string | 开始日期 |\n| end_date | 否 | string | 结束日期 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: settlement_id, store_id, amount, currency, start_date, end_date, status\n\n---\n\n## profitReportOrderTranscationList - 查询订单交易利润报表\n\n**路径**: `/basicOpen/finance/profitReport/order/transcation/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sids | 否 | string | 店铺ID，多个逗号分隔 |\n| start_date | 是 | string | 开始日期 |\n| end_date | 是 | string | 结束日期 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: amazon_order_id, sid, transaction_type, amount, currency, posted_date\n\n---\n\n## receivableReportList - 查询应收账款报表列表\n\n**路径**: `/bd/sp/api/open/monthly/receivable/report/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sids | 否 | array | 店铺ID列表 |\n| year_month | 否 | string | 年月，格式 Y-m |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: report_id, sid, year_month, receivable_amount, currency, status\n\n---\n\n## reportListDetail - 查询应收账款报表明细\n\n**路径**: `/bd/sp/api/open/monthly/receivable/report/list/detail`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| report_id | 是 | string | 报表ID |\n| sid | 是 | int | 店铺ID |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: settlement_id, amount, currency, start_date, end_date\n\n---\n\n## reportListDetailInfo - 查询应收账款报表明细详情\n\n**路径**: `/bd/sp/api/open/monthly/receivable/report/list/detail/info`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| report_id | 是 | string | 报表ID |\n| settlement_id | 是 | string | 结算ID |\n| sid | 是 | int | 店铺ID |\n\n**关键返回字段**: settlement_id, transaction_list[type/amount/currency/date]\n\n---\n\n## requestFundsPoolCustomFeeList - 查询资金池自定义费用列表\n\n**路径**: `/basicOpen/finance/requestFundsPool/customFee/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| pool_id | 是 | int | 资金池ID |\n| start_date | 否 | string | 开始日期 |\n| end_date | 否 | string | 结束日期 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: fee_id, pool_id, fee_type, amount, currency, date, remark\n\n---\n\n## requestFundsPoolInboundList - 查询资金池头程费用列表\n\n**路径**: `/basicOpen/finance/requestFundsPool/inbound/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| pool_id | 是 | int | 资金池ID |\n| start_date | 否 | string | 开始日期 |\n| end_date | 否 | string | 结束日期 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: fee_id, pool_id, shipment_no, amount, currency, date\n\n---\n\n## requestFundsPoolLogisticsList - 查询资金池物流费用列表\n\n**路径**: `/basicOpen/finance/requestFundsPool/logistics/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| pool_id | 是 | int | 资金池ID |\n| start_date | 否 | string | 开始日期 |\n| end_date | 否 | string | 结束日期 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: fee_id, pool_id, order_no, amount, currency, date\n\n---\n\n## requestFundsPoolOtherFeeList - 查询资金池其他费用列表\n\n**路径**: `/basicOpen/finance/requestFundsPool/otherFee/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| pool_id | 是 | int | 资金池ID |\n| start_date | 否 | string | 开始日期 |\n| end_date | 否 | string | 结束日期 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: fee_id, pool_id, fee_type, amount, currency, date\n\n---\n\n## requestFundsPoolPrepayList - 查询资金池预付款列表\n\n**路径**: `/basicOpen/finance/requestFundsPool/prepay/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| pool_id | 是 | int | 资金池ID |\n| start_date | 否 | string | 开始日期 |\n| end_date | 否 | string | 结束日期 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: prepay_id, pool_id, amount, currency, date, status\n\n---\n\n## requestFundsPoolPurchaseList - 查询资金池采购费用列表\n\n**路径**: `/basicOpen/finance/requestFundsPool/purchase/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| pool_id | 是 | int | 资金池ID |\n| start_date | 否 | string | 开始日期 |\n| end_date | 否 | string | 结束日期 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: fee_id, pool_id, purchase_order_no, amount, currency, date\n\n---\n\n## settlementSummaryList - 查询结算汇总列表\n\n**路径**: `/bd/sp/api/open/settlement/summary/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sids | 否 | array | 店铺ID列表 |\n| start_date | 否 | string | 开始日期 |\n| end_date | 否 | string | 结束日期 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: settlement_id, sid, start_date, end_date, total_amount, deposit_amount, currency\n\n---\n\n## settlementTransactionList - 查询结算交易明细列表\n\n**路径**: `/bd/sp/api/open/settlement/transaction/detail/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| settlement_id | 是 | string | 结算ID |\n| sid | 是 | int | 店铺ID |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: transaction_id, settlement_id, type, amount, currency, posted_date, order_id\n\n---\n\n## shopeeAdjustmentList - 查询Shopee调整列表\n\n**路径**: `/basicOpen/finance/shopee/adjustment/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| store_ids | 否 | array | 店铺ID列表 |\n| start_date | 否 | string | 开始日期 |\n| end_date | 否 | string | 结束日期 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: adjustment_id, store_id, type, amount, currency, date, reason\n\n---\n\n## shopeeIncomeList - 查询Shopee收入列表\n\n**路径**: `/basicOpen/finance/shopee/income/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| store_ids | 否 | array | 店铺ID列表 |\n| start_date | 否 | string | 开始日期 |\n| end_date | 否 | string | 结束日期 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: income_id, store_id, order_id, amount, currency, income_date, type\n\n---\n\n## shopeePayoutList - 查询Shopee打款列表\n\n**路径**: `/basicOpen/finance/shopee/payout/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| store_ids | 否 | array | 店铺ID列表 |\n| start_date | 否 | string | 开始日期 |\n| end_date | 否 | string | 结束日期 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: payout_id, store_id, amount, currency, payout_date, status\n\n---\n\n## summaryQuery - 查询成本中心ODS汇总\n\n**路径**: `/cost/center/ods/summary/query`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| mskus | 否 | array | MSKU列表 |\n| start_date | 否 | string | 开始日期 |\n| end_date | 否 | string | 结束日期 |\n\n**关键返回字段**: msku, total_cost, cost_by_type[type/amount/currency]\n\nFile v1.0.6:references/logistics.md\n\n# 领星物流接口参考\n\n所有接口均为 POST 请求，域名：`https://openapi.lingxing.com`\n\n---\n\n## ChannelList - 查询物流渠道列表\n\n**路径**: `/erp/sc/data/local_inventory/channelList`\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| offset | 是 | int | 分页偏移量 |\n| length | 是 | int | 分页长度 |\n\n**关键返回字段**: id, channel_name, method_id, method_name, billing_type, volume_calc_param, zip_code, valid_period\n\n---\n\n## QueryHeadLogisticsProvider - 查询头程物流商列表\n\n**路径**: `/basicOpen/logistics/headLogisticsProvider/query/list`\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| search | 是 | object | 搜索条件对象 |\n| search>>page | 是 | int | 页码 |\n| search>>length | 是 | int | 每页大小 |\n| search>>enabled | 否 | int | 是否启用 |\n| search>>isAuth | 否 | int | 是否已授权 |\n| search>>payMethod | 否 | int | 付款方式 |\n| search>>searchField | 否 | string | 搜索字段名 |\n| search>>searchValue | 否 | string | 搜索值 |\n\n**关键返回字段**: 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\n\n---\n\n## transportMethodList - 查询运输方式列表\n\n**路径**: `/basicOpen/businessConfig/transportMethod/list`\n**参数**: 无（直接调用即可）\n\n**关键返回字段**: data>>method_id, data>>code, data>>name, data>>is_system, data>>enabled, data>>remark, data>>creator_id, data>>creator_name\n\n---\n\nFile v1.0.6:references/multiplatform-ads.md\n\n# 领星多平台广告接口参考\n\n所有接口均为 POST 请求，域名：`https://openapi.lingxing.com`\n\n---\n\n## TikTok 推广广告\n\n### queryAdvertiserList - 查询广告账号\n\n**路径**: `/basicOpen/multiplatform/ads/queryAdvertiserList`\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| startDate | 是 | string | 开始日期，yyyy-MM-dd，间隔不超过31天 |\n| endDate | 是 | string | 结束日期，yyyy-MM-dd |\n| length | 是 | int | 每页条数，小于2000 |\n| page | 是 | int | 页码 |\n| advertiserIds | 否 | array | 广告账号ID列表 |\n| status | 否 | array | STATUS_ENABLE/SYSTEM_STATUS_IN_REVIEW/SYSTEM_STATUS_NOT_PASS/STATUS_LIMIT/STATUS_DISABLE |\n| currencies | 否 | array | 币种列表，如 [\"USD\",\"CNY\"] |\n| orderField | 否 | string | 排序字段（驼峰） |\n| orderType | 否 | string | ASC/DESC |\n| searchType | 否 | string | advertiser_name/ad_group_name/campaign_name/ad_name |\n| searchValue | 否 | array | 搜索值 |\n\n**关键返回字段**: advertiserId, advertiserName, spend, impressions, clicks, ctr, cpc, orders, revenue, roas\n\n---\n\n### queryCommonAdvertiserList - 查询推广广告账号（通用）\n\n**路径**: `/basicOpen/multiplatform/ads/queryCommonAdvertiserList`\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| internalStatus | 否 | string | ENABLE/DISABLE/DELETE |\n| hasGmvStore | 否 | int | 1=只返回有GMV店铺的账号 |\n\n**关键返回字段**: 广告账号基础信息列表\n\n---\n\n### queryTiktokCampaignList - 查询广告系列\n\n**路径**: `/basicOpen/multiplatform/ads/queryTiktokCampaignList`\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| startDate | 是 | string | 开始日期，yyyy-MM-dd，间隔不超过31天 |\n| endDate | 是 | string | 结束日期 |\n| length | 是 | int | 每页条数，小于2000 |\n| page | 是 | int | 页码 |\n| advertiserIds | 否 | array | 广告账号ID列表 |\n| campaignIds | 否 | array | 广告活动ID列表 |\n| objectiveType | 否 | array | REACH/TRAFFIC/VIDEO_VIEWS/LEAD_GENERATION/ENGAGEMENT/APP_PROMOTION/WEB_CONVERSIONS/PRODUCT_SALES |\n| status | 否 | array | STATUS_ENABLE/STATUS_DISABLE 等 |\n| summaryCurrency | 否 | string | 汇总币种 |\n\n**关键返回字段**: campaignId, campaignName, spend, impressions, clicks, orders, revenue, roas, status\n\n---\n\n### queryTiktokAdGroupList - 查询广告组\n\n**路径**: `/basicOpen/multiplatform/ads/queryTiktokAdGroupList`\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| startDate | 是 | string | 开始日期，yyyy-MM-dd，间隔不超过31天 |\n| endDate | 是 | string | 结束日期 |\n| length | 是 | int | 每页条数，小于2000 |\n| page | 是 | int | 页码 |\n| advertiserIds | 否 | array | 广告账号ID列表 |\n| campaignIds | 否 | array | 广告活动ID列表 |\n| status | 否 | array | STATUS_ENABLE/STATUS_DISABLE 等 |\n| searchType | 否 | string | ad_group_name 等 |\n\n**关键返回字段**: adGroupId, adGroupName, campaignId, spend, impressions, clicks, orders, roas\n\n---\n\n### queryTiktokAdList - 查询广告\n\n**路径**: `/basicOpen/multiplatform/ads/queryTiktokAdList`\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| startDate | 是 | string | 开始日期，yyyy-MM-dd，间隔不超过31天 |\n| endDate | 是 | string | 结束日期 |\n| length | 是 | int | 每页条数，小于2000 |\n| page | 是 | int | 页码 |\n| advertiserIds | 否 | array | 广告账号ID列表 |\n| campaignIds | 否 | array | 推广系列ID列表 |\n| adgroupIds | 否 | array | 广告组ID列表 |\n| adIds | 否 | array | 广告ID列表 |\n\n**关键返回字段**: adId, adName, adGroupId, campaignId, spend, impressions, clicks, orders, roas, status\n\n---\n\n## TikTok GMV Max\n\n### queryGmvStoreList - 查询 GMV MAX 店铺列表\n\n**路径**: `/basicOpen/multiplatform/ads/queryGmvStoreList`\n**参数**: 无必填参数\n\n**关键返回字段**: advertiserId, storeId, storeName\n\n---\n\n### queryGmvAdvertiserReportList - 查询 GMV MAX 广告账号报告\n\n**路径**: `/basicOpen/multiplatform/ads/queryGmvAdvertiserReportList`\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| startDate | 是 | string | 开始日期，yyyy-MM-dd，间隔不超过31天 |\n| endDate | 是 | string | 结束日期 |\n| length | 是 | int | 每页条数，小于2000 |\n| page | 是 | int | 页码，从1开始 |\n| advertiserIds | 否 | array | 广告账号ID列表 |\n| gmvMaxPromotionTypeCodes | 否 | array | PRODUCT/LIVE |\n| storeIds | 否 | array | 店铺ID列表 |\n| summaryCurrency | 否 | string | 汇总币种，默认USD |\n\n**关键返回字段**: subjectId, reportDate, cost, orders, roi, grossRevenue（唯一键：subjectId+reportDate）\n\n---\n\n### queryGmvCampaignReportList - 查询 GMV MAX 推广系列报告\n\n**路径**: `/basicOpen/multiplatform/ads/queryGmvCampaignReportList`\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| startDate | 是 | string | 开始日期，yyyy-MM-dd，间隔不超过31天 |\n| endDate | 是 | string | 结束日期 |\n| length | 是 | int | 每页条数，小于2000 |\n| page | 是 | int | 页码，从1开始 |\n| advertiserIds | 否 | array | 广告账号ID列表 |\n| campaignIds | 否 | array | 推广系列ID列表 |\n| gmvMaxPromotionTypeCodes | 否 | array | PRODUCT/LIVE |\n| status | 否 | array | ENABLE/DISABLE/DELETE |\n\n**关键返回字段**: subjectId, campaignId, reportDate, cost, orders, roi（唯一键：subjectId+reportDate）\n\n---\n\n### queryGmvItemGroupReportList - 查询 GMV MAX 广告商品报告\n\n**路径**: `/basicOpen/multiplatform/ads/queryGmvItemGroupReportList`\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| startDate | 是 | string | 开始日期，yyyy-MM-dd，间隔不超过31天 |\n| endDate | 是 | string | 结束日期 |\n| length | 是 | int | 每页条数，小于2000 |\n| page | 是 | int | 页码 |\n| advertiserIds | 否 | array | 广告账号ID列表 |\n| itemGroupIds | 否 | array | 广告商品ID列表 |\n| status | 否 | array | available/unavailable |\n\n**关键返回字段**: subjectId, reportDate, grossRevenue, cost, orders, roi（唯一键：subjectId+reportDate）\n\n---\n\n## 沃尔玛广告 - SP 广告\n\n### queryCampaignSpList - 查询 SP 广告活动\n\n**路径**: `/basicOpen/multiplatform/ads/queryCampaignSpList`\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| advertiserIds | 是 | array | 广告账号ID列表 |\n| campaignType | 是 | array | sponsoredProducts-manual/sponsoredProducts-auto（SP必须且只能用这两个） |\n| day | 是 | int | 归因天数：3/14/30 |\n| startDate | 是 | string | 开始日期，yyyy-MM-dd，间隔不超过31天 |\n| endDate | 是 | string | 结束日期 |\n| operationSourceType | 是 | string | openapi调用传 gateway |\n| pageNum | 是 | int | 页码，从1开始 |\n| pageSize | 是 | int | 每页大小，小于2000 |\n| paging | 是 | boolean | openapi必填 true |\n| campaignIds | 否 | array | 广告活动ID列表 |\n| status | 否 | array | enabled/paused/live/completed 等 |\n\n**关键返回字段**: campaignId, campaignName, adSpend, numAdsShown, numAdsClicks, attributedSales, attributedOrders, acos, roas, cpc, ctr, status\n\n---\n\n### queryGroupSpList - 查询 SP 广告组\n\n**路径**: `/basicOpen/multiplatform/ads/queryGroupSpList`\n**参数**: 同 queryCampaignSpList（campaignIds 改为可选筛选项）\n\n**关键返回字段**: adGroupId, adGroupName, campaignId, adSpend, attributedSales, acos, roas, status\n\n---\n\n### queryPageTypeSPList - 查询 SP 广告页面类型\n\n**路径**: `/basicOpen/multiplatform/ads/queryPageTypeSPList`\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| startDate | 否 | string | 开始日期，yyyy-MM-dd |\n| endDate | 否 | string | 结束日期 |\n| advertiserIds | 否 | array | 广告账号ID列表 |\n| campaignType | 否 | array | 广告类型列表 |\n| campaignIds | 否 | array | 广告活动ID列表 |\n| day | 否 | int | 归因天数 |\n| pageNum | 否 | int | 页码 |\n| pageSize | 否 | int | 每页大小 |\n\n**关键返回字段**: pageType, adSpend, numAdsShown, numAdsClicks, attributedSales, acos, roas\n\n---\n\n### reportAdItemSpList - 查询 SP 广告\n\n**路径**: `/basicOpen/multiplatform/ads/reportAdItemSpList`\n**参数**: 与 queryCampaignSpList 相同必填参数，另可加 adGroupIds 筛选\n\n**关键返回字段**: adId, adGroupId, campaignId, adSpend, attributedSales, acos, roas, status\n\n---\n\n### reportKeywordSpList - 查询 SP 关键词\n\n**路径**: `/basicOpen/multiplatform/ads/reportKeywordSpList`\n**参数**: 与 queryCampaignSpList 相同必填参数\n\n**关键返回字段**: keywordId, keywordText, matchType, adGroupId, adSpend, attributedSales, acos, roas\n\n---\n\n### reportPlatformSpList - 查询 SP 平台\n\n**路径**: `/basicOpen/multiplatform/ads/reportPlatformSpList`\n**参数**: 与 queryCampaignSpList 相同必填参数\n\n**关键返回字段**: platform, adSpend, numAdsShown, numAdsClicks, attributedSales, acos, roas\n\n---\n\n## 沃尔玛广告 - SB 广告\n\n### reportCampaignSbList - 查询 SB 广告活动\n\n**路径**: `/basicOpen/multiplatform/ads/reportCampaignSbList`\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| advertiserIds | 是 | array | 广告账号ID列表 |\n| campaignType | 是 | array | [\"sba\"]（SB必须且只能用sba） |\n| startDate | 是 | string | 开始日期，yyyy-MM-dd |\n| endDate | 是 | string | 结束日期 |\n| campaignIds | 否 | array | 广告活动ID列表 |\n| day | 否 | int | 归因天数，默认14 |\n| pageNum | 否 | int | 页码 |\n| pageSize | 否 | int | 每页大小，最大200 |\n\n**关键返回字段**: campaignId, campaignName, adSpend, attributedSales, acos, roas, ntbOrders, ntbRevenue, status\n\n---\n\n### reportAdGroupSbList - 查询 SB 广告组\n\n**路径**: `/basicOpen/multiplatform/ads/reportAdGroupSbList`\n**参数**: 与 reportCampaignSbList 相同必填参数，加 campaignIds 筛选\n\n**关键返回字段**: adGroupId, adGroupName, campaignId, adSpend, attributedSales, acos, roas\n\n---\n\n### reportAdItemSbList - 查询 SB 广告\n\n**路径**: `/basicOpen/multiplatform/ads/reportAdItemSbList`\n**参数**: 与 reportAdGroupSbList 相同，加 adGroupIds 筛选\n\n**关键返回字段**: adId, adGroupId, campaignId, adSpend, attributedSales, acos, roas\n\n---\n\n### reportKeywordSbList - 查询 SB 关键词\n\n**路径**: `/basicOpen/multiplatform/ads/reportKeywordSbList`\n**参数**: 与 reportCampaignSbList 相同必填参数\n\n**关键返回字段**: keywordText, matchType, adSpend, attributedSales, acos, roas\n\n---\n\n### reportPageTypeSbList - 查询 SB 页面类型\n\n**路径**: `/basicOpen/multiplatform/ads/reportPageTypeSbList`\n**参数**: 与 reportCampaignSbList 相同必填参数\n\n**关键返回字段**: pageType, adSpend, attributedSales, acos, roas\n\n---\n\n### reportPlatformSbList - 查询 SB 平台\n\n**路径**: `/basicOpen/multiplatform/ads/reportPlatformSbList`\n**参数**: 与 reportCampaignSbList 相同必填参数\n\n**关键返回字段**: platform, adSpend, attributedSales, acos, roas\n\n---\n\n## 沃尔玛广告 - SV 广告\n\n### queryAdGroupSvList - 查询 SV 广告组\n\n**路径**: `/basicOpen/multiplatform/ads/queryAdGroupSvList`\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| advertiserIds | 是 | array | 广告账号ID列表 |\n| campaignType | 是 | array | [\"video\"]（SV必须且只能用video） |\n| dateKey | 是 | string | day/week/month |\n| startDate | 是 | string | 开始日期，yyyy-MM-dd |\n| endDate | 是 | string | 结束日期 |\n| campaignIds | 否 | array | 广告活动ID列表 |\n| status | 否 | array | enabled/disabled/delete |\n| pageNum | 否 | int | 页码，从1开始 |\n| pageSize | 否 | int | 每页大小 |\n\n**关键返回字段**: adGroupId, adGroupName, campaignId, adSpend, numAdsShown, numAdsClicks, attributedSales, acos, roas, status\n\n---\n\n### queryReportPageTypeSvList - 查询 SV 页面类型\n\n**路径**: `/basicOpen/multiplatform/ads/queryReportPageTypeSvList`\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| advertiserIds | 是 | array | 广告账号ID列表 |\n| campaignType | 是 | array | [\"video\"] |\n| startDate | 是 | string | 开始日期，yyyy-MM-dd |\n| endDate | 是 | string | 结束日期 |\n| pageType | 否 | array | browse/item/search/topic/category/homepage/other |\n| day | 否 | int | 归因天数，默认14 |\n\n**关键返回字段**: pageType, adSpend, numAdsShown, numAdsClicks, attributedSales, acos, roas\n\n---\n\n### reportAdItemSvList - 查询 SV 广告\n\n**路径**: `/basicOpen/multiplatform/ads/reportAdItemSvList`\n**参数**: advertiserIds(是), campaignType=[\"video\"](是), startDate(是), endDate(是)，其他选填\n\n**关键返回字段**: adId, adGroupId, campaignId, adSpend, attributedSales, acos, roas\n\n---\n\n### reportCampaignSvList - 查询 SV 广告活动\n\n**路径**: `/basicOpen/multiplatform/ads/reportCampaignSvList`\n**参数**: advertiserIds(是), campaignType=[\"video\"](是), startDate(是), endDate(是)，其他选填\n\n**关键返回字段**: campaignId, campaignName, adSpend, attributedSales, acos, roas, status\n\n---\n\n### reportKeywordSvList - 查询 SV 关键词\n\n**路径**: `/basicOpen/multiplatform/ads/reportKeywordSvList`\n**参数**: advertiserIds(是), campaignType=[\"video\"](是), startDate(是), endDate(是)\n\n**关键返回字段**: keywordText, matchType, adSpend, attributedSales, acos, roas\n\n---\n\n### reportPlatformSvList - 查询 SV 平台\n\n**路径**: `/basicOpen/multiplatform/ads/reportPlatformSvList`\n**参数**: advertiserIds(是), campaignType=[\"video\"](是), startDate(是), endDate(是)\n\n**关键返回字段**: platform, adSpend, attributedSales, acos, roas\n\n---\n\n### reportSearchTrendsList - 查询搜索趋势\n\n**路径**: `/basicOpen/multiplatform/ads/reportSearchTrendsList`\n**参数**: advertiserIds(是), startDate(是), endDate(是)，其他选填\n\n**关键返回字段**: searchTerm, impressions, clicks, adSpend, reportDate\n\n---\n\nFile v1.0.6:references/multiplatform-v2.md\n\n# 领星多平台 V2 接口参考\n\n所有接口均为 POST 请求，域名：`https://openapi.lingxing.com`\n\n---\n\n## MultiPlatOrderV2 - 查询订单管理订单列表\n\n**路径**: `/pb/mp/order/v2/list`\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| offset | 是 | int | 分页偏移量 |\n| length | 是 | int | 分页长度，上限500 |\n| date_type | 否* | string | update_time/global_purchase_time/global_delivery_time/global_payment_time/delivery_time（仅按平台单号查时可不传） |\n| start_time | 否* | int | 开始时间戳（秒），查询跨度不超过31天 |\n| end_time | 否* | int | 结束时间戳（秒） |\n| store_id | 否 | array | 多平台店铺ID |\n| platform_code | 否 | array | 平台code（10001=Amazon，10002=Shopify，10003=eBay，10008=Walmart，10011=TikTok，10021=SHEIN，10022=Temu全托管，10024=Temu半托管 等） |\n| platform_order_nos | 否 | array | 平台单号列表，上限200（eBay/Newegg/Coupang/Shopify/Mercado/Shopline 除外） |\n| platform_order_names | 否 | array | 特定平台单号（eBay/Newegg/Coupang/Shopify/Mercado/Shopline 用此字段） |\n| order_status | 否 | int | 1=同步中，2=已同步，3=待付款，4=待审核，5=待发货，6=已发货，7=已取消，8=不显示，9=平台发货 |\n| include_delete | 否 | boolean | 是否包含已删除订单 |\n\n**关键返回字段**: 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\n\n---\n\n## StoreInfoV2 - 查询多平台店铺信息\n\n**路径**: `/pb/mp/shop/v2/getSellerList`\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| platform_code | 否 | array | 平台code列表 |\n| is_sync | 否 | int | 1=启用，0=停用 |\n| status | 否 | int | 1=正常授权，0=授权失败 |\n| offset | 否 | int | 分页偏移量 |\n| length | 否 | int | 分页长度，上限200 |\n\n**关键返回字段**: store_id, sid, store_name, platform_code, platform_name, currency, is_sync\n\n---\n\n## PairListV2 - 查询多平台配对列表\n\n**路径**: `/pb/mp/listing/v2/getPairList`\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| msku | 否 | array | MSKU列表 |\n| sku | 否 | array | 本地SKU列表 |\n| store_ids | 否 | array | 店铺ID列表 |\n| platform_codes | 否 | array | 平台code列表 |\n| start_time | 否 | string | 操作开始时间 |\n| end_time | 否 | string | 操作结束时间 |\n| use_cursor | 否 | boolean | 使用分页游标（数据多时推荐） |\n| cursor_id | 否 | boolean | 游标ID（use_cursor=true时必填） |\n| offset | 否 | int | 分页偏移量 |\n| length | 否 | int | 分页条数 |\n\n**关键返回字段**: msku, sku, store_id, platform_code, pair_time\n\n---\n\n## QueryShippingListV2 - 查询平台仓发货单列表 v2\n\n**路径**: `/basicOpen/multiplatform/query/shippingList`\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| platformCodes | 是 | array | 10008=Walmart，10011=TikTok，10022=Temu，10027=Shein |\n| timeField | 否 | int | 1=创建时间，2=发货时间，3=开船时间，4=预计到港，5=实际妥投，6=实际发货 |\n| startTime | 否 | string | 开始时间，Y-m-d |\n| endTime | 否 | string | 结束时间，Y-m-d |\n| shippingListStatus | 否 | int | 0=待配货，1=待发货，2=已发货，3=已作废 |\n| pickingStatus | 否 | string | 1=已拣货，0=待拣货 |\n| searchField | 否 | int | 1=MSKU，2=发货单号，7=货件单号，8=商品条码 |\n| searchSingleValue | 否 | string | 模糊搜索值 |\n| storeIds | 否 | array | 店铺ID列表 |\n| offset | 否 | int | 分页偏移量 |\n| length | 否 | int | 分页长度 |\n\n**关键返回字段**: 发货单列表（发货单号、状态、货件、商品明细）\n\n---\n\n## QueryShippingListPage - 查询平台仓发货单列表（Walmart 旧版）\n\n**路径**: `/cepf/warehouse/api/openApi/queryShippingListPage`\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| store_id | 否 | array | 店铺ID |\n| shipping_list_codes | 否 | array | 发货单编号，上限100 |\n| cargo_code | 否 | string | 货件单号 |\n| shipping_list_status | 否 | int | 0=待配货，1=待发货，2=已发货，3=已作废 |\n| start_time | 否 | string | 创建开始时间，Y-m-d |\n| end_time | 否 | string | 创建结束时间，Y-m-d |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 分页长度，默认15，上限200 |\n\n**关键返回字段**: 发货单列表（仅支持Walmart，建议改用 QueryShippingListV2）\n\n---\n\n## QueryWFSCargoPage - 查询 WFS 货件列表\n\n**路径**: `/cepf/warehouse/api/openApi/queryWFSCargoPage`\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| store_id | 否 | array | 店铺ID |\n| cargo_status_list | 否 | array | 0=PENDING_SHIPMENT_DETAILS，1=AWAITING_DELIVERY，2=RECEIVING_IN_PROGRESS，3=CLOSED，4=CANCELLED |\n| inbound_order_id | 否 | string | 入库订单编号 |\n| start_time | 否 | string | 创建开始时间，Y-m-d |\n| end_time | 否 | string | 创建结束时间，Y-m-d |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 分页长度，默认15，上限200 |\n\n**关键返回字段**: 货件列表（货件号、状态、入库数量、商品明细）\n\n---\n\n## QueryWFSInventionPage - 查询 WFS 库存列表\n\n**路径**: `/cepf/warehouse/api/openApi/queryWFSInventionPage`\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| store_id | 是 | array | 店铺ID |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 分页长度，默认15，上限200 |\n\n**关键返回字段**: 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]\n\n---\n\n## AliexpressListV2 - 查询 AliExpress 在线商品（托管模式）\n\n**路径**: `/basicOpen/multiplatform/aliexpress/list/v2`\n**参数**: offset, length（分页）；store_id（店铺筛选）等\n\n**关键返回字段**: 商品列表（product_id, msku, title, price, status, inventory）\n\n---\n\n## aliexpressList - 查询 AliExpress 在线商品（自运营）\n\n**路径**: `/basicOpen/multiplatform/aliExpress/list`\n**参数**: offset, length（分页）；store_id, msku 等\n\n**关键返回字段**: item_id, msku, status, price, title\n\n---\n\n## eBayList - 查询 eBay 在线商品列表\n\n**路径**: `/basicOpen/multiplatform/ebay/list`\n**参数**: offset, length（分页）；store_id 等\n\n**关键返回字段**: msku, listing_status, site_name, accept_price, product_auto_restock_response\n\n---\n\n## walmartList - 查询 Walmart 在线商品\n\n**路径**: `/basicOpen/multiplatform/walmart/list`\n**参数**: offset, length（分页）；store_id 等\n\n**关键返回字段**: title, store_name, fulfillment_type_name, buy_box_shipping_price, quantityAdjustBefore, offer_end_date\n\n---\n\n## TemuList - 查询 Temu 在线商品\n\n**路径**: `/basicOpen/multiplatform/temu/list`\n**参数**: offset, length（分页）；store_id 等\n\n**关键返回字段**: mskuId, title, principalName, usableInventory, attribute, wareHouseDataList\n\n---\n\n## TemuCargo - 查询 Temu 货件\n\n**路径**: `/basicOpen/multiplatform/temu/cargo`\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| startTime | 是 | string | 开始时间 |\n| offset/length | 否 | int | 分页 |\n\n**关键返回字段**: cargoGoodListResponses[mskuCargo/purchaseOrderSn/sku], deliverPackageNum, deliveryAddress\n\n---\n\n## TikTokList - 查询 TikTok 在线商品\n\n**路径**: `/basicOpen/multiplatform/tiktok/list`\n**参数**: offset, length（分页）；store_id 等\n\n**关键返回字段**: id, storeId, pname, usableInventory, currency\n\n---\n\n## SheinList - 查询 Shein 在线商品\n\n**路径**: `/basicOpen/multiplatform/shein/list`\n**参数**: offset, length（分页）；store_id 等\n\n**关键返回字段**: mskuId, title, principalName, status, wareHouseDataList, attribute\n\n---\n\n## ShopifyVariantList - 查询 Shopify 在线商品\n\n**路径**: `/basicOpen/multiplatform/shopify/variantList`\n**参数**: offset, length（分页）；store_id 等\n\n**关键返回字段**: title, store_name, weight, listing_start_time, location_infos\n\n---\n\n## CoupangStockList - 查询 Coupang 库存\n\n**路径**: `/basicOpen/multiplatform/coupang/stockSearch`\n**参数**: offset, length（分页）；store_id 等\n\n**关键返回字段**: stockPage[records[storeName, ...]]\n\n---\n\n## FbsStockList - 查询 FBS 库存\n\n**路径**: `/basicOpen/multiplatform/fbs/stockSearch`\n**参数**: offset, length（分页）；store_id 等\n\n**关键返回字段**: records[shopSkuId, whsId, irApprovalQty, last60Sold, notMovingTag, gmtCreate]\n\n---\n\n## FbtStockList - 查询 FBT 库存\n\n**路径**: `/basicOpen/multiplatform/fbt/stockSearch/v2`\n**参数**: offset, length（分页）；store_id 等\n\n**关键返回字段**: page[records[goodReferenceCode, totalInventoryQuantity, ...]]\n\n---\n\n## FbtStockSearch - 查询 Temu 库存\n\n**路径**: `/basicOpen/multiplatform/fbt/stockSearch`\n**参数**: offset, length（分页）；store_id 等\n\n**关键返回字段**: list[mskuList[msku], quantity, adviceQuantity, inventorySaleDays, warehouseInventoryNum, todaySaleVolume]\n\n---\n\n## FullList - 查询 FULL 库存\n\n**路径**: `/basicOpen/multiplatform/full/stockSearch`\n**参数**: offset, length（分页）；store_id 等\n\n**关键返回字段**: 库存记录列表\n\n---\n\n## WayfairStockList - 查询 Wayfair 库存\n\n**路径**: `/basicOpen/multiplatform/wayfair/stockSearch`\n**参数**: offset, length（分页）；store_id 等\n\n**关键返回字段**: page[records[supplierPartNumber, heldQty, options, ...], total]\n\n---\n\n## LineList - 查询 Line 在线商品\n\n**路径**: `/basicOpen/multiplatform/line/list`\n**参数**: offset, length（分页）；store_id 等\n\n**关键返回字段**: list[bid, imgUrl, children[id/pid/productUniqueId/storeName/availableNumber]]\n\n---\n\n## addCargoGoodsList - 查询 WFS 货件可添加商品列表\n\n**路径**: `/basicOpen/multiplatform/cargo/addCargoGoods/list`\n**参数**: store_id 等\n\n**关键返回字段**: item_id 等商品信息\n\n---\n\n## WalmartPaymentQueryPage - 查询报告详情（Walmart Payment）\n\n**路径**: `/cepf/fms/openapi/walmartPayment/queryPage`\n**参数**: store_id, report_date, offset, length 等\n\n**关键返回字段**: records[transaction_key, partner_gtin, product_type, commission_rule, ship_to_zipcode, ...]\n\n---\n\n## WalmartPaymentQueryReport - 查询可用报告列表（Walmart Payment）\n\n**路径**: `/cepf/fms/openapi/walmartPayment/queryReport`\n**参数**: store_id 等\n\n**关键返回字段**: list[report_date, ...]\n\n---\n\n## WalmartCommentList - 查询 Walmart Review 列表\n\n**路径**: `/basicOpen/multiplatform/walmart/queryCommentList`\n**参数**: store_id, start_date, end_date, offset, length 等\n\n**关键返回字段**: records[commentTitle, productMsku, storeName, title, ...], current, total\n\n---\n\n## profitReportMsku - 查询结算利润报表（MSKU 维度）\n\n**路径**: `/basicOpen/multiplatform/profit/report/msku`\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| startDate | 是 | string | 开始结算日期，Y-m-d |\n| endDate | 是 | string | 结束结算日期，Y-m-d |\n| offset | 是 | int | 分页偏移量，默认0 |\n| length | 是 | int | 分页长度，默认1000 |\n| platformCodeS | 否 | array | 平台code列表 |\n| sids | 否 | string | 店铺ID，逗号分隔 |\n| mids | 否 | string | 国家ID，逗号分隔 |\n| currencyCode | 否 | string | 原币种/USD/EUR/GBP/CNY |\n| searchField | 否 | string | msku/local_sku/platform_order_no |\n| searchValue | 否 | string | 搜索值 |\n\n**关键返回字段**: totalSum[salesNum, refundNum, buyerFreightAmount, platformLogisticsAmount, platformFineAmount, currencyIcon]，列表明细\n\n---\n\n## profitReportOrder - 查询结算利润报表（订单维度）\n\n**路径**: `/basicOpen/multiplatform/profit/report/order`\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| startDate | 是 | string | 开始结算日期，Y-m-d |\n| endDate | 是 | string | 结束结算日期，Y-m-d |\n| offset | 是 | int | 分页偏移量，默认0 |\n| length | 是 | int | 分页长度，默认200 |\n| searchDateType | 否 | int | 1=下单时间，2=结算日期（默认），3=发货日期 |\n| transactionTypeS | 否 | array | 0=销售，2=退货，4=退款，5=补发，6=调整，7=其他 |\n| platformCodeS | 否 | array | 平台code列表 |\n| currencyCode | 否 | string | 汇率币种 |\n\n**关键返回字段**: totalSum[salesNum, refundRate, platformOtherIncomeAmount, promotionExtendAmount]，订单明细列表\n\n---\n\n## profitReportSeller - 查询结算利润报表（店铺维度）\n\n**路径**: `/basicOpen/multiplatform/profit/report/seller`\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| startDate | 是 | string | 开始结算日期，Y-m-d |\n| endDate | 是 | string | 结束结算日期，Y-m-d |\n| offset | 是 | int | 分页偏移量，默认0 |\n| length | 是 | int | 分页长度，默认1000 |\n| platformCodeS | 否 | array | 平台code列表 |\n| sids | 否 | string | 店铺ID，逗号分隔 |\n| currencyCode | 否 | string | 汇率币种 |\n\n**关键返回字段**: totalSum[buyerFreightAmount, refundNum, platformLogisticsAmount, platformFineAmount, currencyIcon]，店铺维度明细\n\n---\n\n## profitReportSku - 查询结算利润报表（SKU 维度）\n\n**路径**: `/basicOpen/multiplatform/profit/report/sku`\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| startDate | 是 | string | 开始结算日期，Y-m-d |\n| endDate | 是 | string | 结束结算日期，Y-m-d |\n| mids | 是 | string | 国家ID，逗号分隔 |\n| offset | 是 | int | 分页偏移量，默认0 |\n| length | 是 | int | 分页长度，默认1000 |\n| platformCodeS | 否 | array | 平台code列表 |\n| currencyCode | 否 | string | 汇率币种 |\n\n**关键返回字段**: totalSum[buyerFreightAmount, refundNum, platformLogisticsAmount, currencyIcon]，SKU 维度明细\n\n---\n\n## newPlatformOrderList - 查询平台订单列表（新）\n\n**路径**: `/cepfPlatformOrder/open-api/newPlatformOrder/list`\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| dateType | 是 | int | 0=平台数据变动时间，1=订购时间，2=订购时间(北京)，3=支付时间，4=支付时间(北京)，5=发货时间 |\n| platformCodeList | 否 | array | 平台code（支持TikTok/Temu半托管/Line/Lazada/Shopee/Shopify等） |\n| deliveryTypeList | 否 | array | 0=自发货，1=平台发货，2=部分自发货 |\n| searchType | 否 | int | 1=sku，2=品名，3=msku，4=商品id，5=平台单号，6=参考号，7=商品标题 |\n| searchSingleValue | 否 | string | 模糊搜索值 |\n| searchMultiValue | 否 | array | 精确搜索值列表 |\n| siteCodeList | 否 | array | 站点列表 |\n| pageNum | 否 | int | 页码 |\n| pageSize | 否 | int | 每页大小 |\n\n**关键返回字段**: 订单列表（平台单号、状态、购买时间、配送信息、商品明细）\n\n---\n\n## addressReturnAddressList - 查询退件地址列表\n\n**路径**: `/basicOpen/multiplatform/address/returnAddressList`\n**参数**: 无必填（可按 store_id 等筛选）\n\n**关键返回字段**: mobile, street_detail 等退件地址信息\n\n---\n\nArchive v1.0.5: 29 files, 85611 bytes\n\nFiles: _meta.json (139b), references/api.md (2427b), references/basedata.md (6901b), references/basicdata-full.md (2891b), references/fba.md (6624b), references/fbalimit.md (1417b), references/fbasug.md (4352b), references/finance.md (22193b), references/logistics.md (1657b), references/multiplatform-ads.md (14140b), references/multiplatform-v2.md (15569b), references/newad-report.md (9507b), references/onboarding.md (2046b), references/product.md (7749b), references/purchase.md (5103b), references/sale-full.md (18675b), references/sale-ops.md (4857b), references/service.md (11308b), references/sourcedata.md (11520b), references/statistics.md (25011b), references/targetmanage.md (1332b), references/tools.md (3601b), references/vc.md (3829b), references/warehouse.md (24034b), scripts/lingxing.py (55214b), scripts/onboarding.py (24089b), scripts/response_io.py (18387b), skill-card.md (2985b), SKILL.md (17302b)\n\nFile v1.0.5:SKILL.md\n\n---\nname: linkfox-lingxing-erp\ndescription: LinkFox 包装的领星（Lingxing）ERP 技能「linkfox-lingxing-erp」：由 LinkFox Skills 仓库收录分发，封装领星官方 OpenAPI 文档与脚本用法，底层仍直连 openapi.lingxing.com（非 LinkFox 自建网关）。覆盖约 373 个接口场景，含广告报表 SP/SB/SD、订单与 Listing、库存仓库、财务与 FBA、源表、采购、客服、多平台广告与订单等。当用户提到领星、Lingxing、领星开放接口、领星 ERP 数据、领星广告报表、领星订单/库存/利润、领星 SID、Lingxing OpenAPI、Lingxing ERP data、LinkFox 领星、linkfox-lingxing-erp 时触发。分模块参数见 references/api.md 及各 references/*.md；需 LINGXING_APP_ID 与 LINGXING_APP_SECRET。\n---\n\n# 领星 ERP OpenAPI（LinkFox 包装版）\n\n**本 skill 是 LinkFox 对领星（Lingxing）官方开放能力的包装**：`name` 为 `linkfox-lingxing-erp`，内容与领星侧 OpenAPI 文档及 `scripts/lingxing.py` 保持一致，由 LinkFox 仓库统一版本管理；认证与请求仍发往 **领星官方域名**。速查见 `references/api.md`。\n\n查询领星 ERP 全模块数据，支持 **373 个接口**，覆盖广告、销售、产品、财务、统计、FBA、仓库、采购、客服、多平台等全业务线。\n\n## 环境变量配置\n\n```bash\nexport LINGXING_APP_ID=your_app_id\nexport LINGXING_APP_SECRET=your_app_secret\n\n# 可选：设置默认店铺 SID，无需每次在 --params 中传入\nexport LINGXING_SID=your_sid\n```\n\n在领星 ERP -> 开放接口菜单中获取 AppID 和 AppSecret。\n\n## 使用方式\n\n以下命令均在 **本 skill 根目录**（含 `SKILL.md` 与 `scripts/` 的目录）下执行。\n\n```bash\n# 列出所有已授权亚马逊店铺，获取 SID\npython3 scripts/lingxing.py --list-stores\n\n# 查看所有支持的接口\npython3 scripts/lingxing.py --api help\n\n# 基础调用\npython3 scripts/lingxing.py --api <接口名> --params '<JSON参数>'\n\n# 自动翻页获取全部数据\npython3 scripts/lingxing.py --api <接口名> --params '<JSON参数>' --all\n\n# 自定义翻页大小\npython3 scripts/lingxing.py --api <接口名> --params '<JSON参数>' --all --page-size 50\n```\n\n输出为 JSON 到 stdout，翻页进度输出到 stderr。\n\n## 调用示例\n\n```bash\n# 第一步：查询店铺列表获取 SID\npython3 scripts/lingxing.py --list-stores\nexport LINGXING_SID=813\n\n# 广告报表\npython3 scripts/lingxing.py \\\n  --api spCampaignReports \\\n  --params '{\"report_date\": \"2024-01-01\"}'\n\n# 亚马逊订单（自动翻页）\npython3 scripts/lingxing.py \\\n  --api mwsOrders \\\n  --params '{\"start_date\": \"2024-01-01\", \"end_date\": \"2024-01-31\"}' --all\n\n# 亚马逊 Listing\npython3 scripts/lingxing.py \\\n  --api mwsListing \\\n  --params '{\"sid\": \"813\", \"is_pair\": 1, \"is_delete\": 0}' --all\n\n# 产品列表\npython3 scripts/lingxing.py \\\n  --api ProductLists --params '{\"offset\": 0, \"length\": 20}'\n\n# 利润报表（ASIN维度）\npython3 scripts/lingxing.py \\\n  --api profitAsin \\\n  --params '{\"sids\": \"813\", \"start_date\": \"2024-01-01\", \"end_date\": \"2024-01-31\"}'\n\n# ASIN日销量\npython3 scripts/lingxing.py \\\n  --api AsinDailyLists \\\n  --params '{\"sid\": 813, \"start_date\": \"2024-01-01\", \"end_date\": \"2024-01-07\"}' --all\n\n# FBA发货单列表\npython3 scripts/lingxing.py \\\n  --api FBAShipmentList \\\n  --params '{\"sid\": 813}' --all\n\n# 亚马逊源表-全部订单\npython3 scripts/lingxing.py \\\n  --api AllOrders \\\n  --params '{\"sid\": 813, \"start_date\": \"2024-01-01\", \"end_date\": \"2024-01-31\"}' --all\n\n# 仓库列表\npython3 scripts/lingxing.py \\\n  --api WarehouseLists --params '{\"offset\": 0, \"length\": 50}'\n\n# Review列表（v2，支持更多筛选）\npython3 scripts/lingxing.py \\\n  --api reviewV2 --params '{\"sid\": 813, \"offset\": 0, \"length\": 20}'\n\n# 多平台订单（V2）\npython3 scripts/lingxing.py \\\n  --api MultiPlatOrderV2 \\\n  --params '{\"start_date\": 1704067200, \"end_date\": 1706745600}' --all\n\n# TikTok广告主列表\npython3 scripts/lingxing.py \\\n  --api queryAdvertiserList \\\n  --params '{\"length\": 100}'\n\n# 补货建议汇总\npython3 scripts/lingxing.py \\\n  --api GetSummaryList \\\n  --params '{\"sid_list\": [813]}' --all\n```\n\n## 接口总览（373个）\n\n### 新广告报表（37个）\n接口详见 `references/newad-report.md`。\n\n| 分组 | 接口 |\n|------|------|\n| SP报表(8) | spCampaignReports, campaignPlacementReports, spAdGroupReports, spProductAdReports, spKeywordReports, spTargetReports, asinReports, queryWordReports |\n| SB报表(8) | hsaCampaignReports, hsaCampaignPlacementReports, hsaAdGroupReports, listHsaTargetingReport, hsaQueryWordReports, hsaPurchasedAsinReports, listHsaProductAdReport, listHsaKeywordPlacementReport |\n| SD报表(6) | sdCampaignReports, sdAdGroupReports, sdProductAdReports, sdTargetReports, sdAsinReports, sdMatchTargetReports |\n| SP小时(5) | spCampaignHourData, spAdPlacementHourData, spAdGroupHourData, spAdvertiseHourData, spTargetHourData |\n| SB小时(4) | sbCampaignHourData, sbAdGroupHourData, sbTargetHourData, sbAdPlacementHourData |\n| SD小时(4) | sdCampaignHourData, sdAdGroupHourData, sdAdvertiseHourData, sdTargetHourData |\n| 其他(2) | dspReportOrderList, ProductAnalysisList |\n\n### 广告基础数据（21个）\n接口详见 `references/basedata.md`。\n\n| 分组 | 接口 |\n|------|------|\n| 账号(1) | dspAccountList |\n| 组合(1) | portfolios |\n| SP(6) | spCampaigns, spAdGroups, spProductAds, spKeywords, spTargets, spNegativeTargetsOrKeywords |\n| SB(6) | hsaCampaigns, hsaAdGroups, hsaProductAds, sbTargeting, hsaNegativeKeywords, hsaNegativeTargets, sbDivideAsinReports |\n| SD(5) | sdCampaigns, sdAdGroups, sdProductAds, sdTargets, sdNegativeTargets |\n| 报表下载(1) | abaReport |\n\n### 基础数据（8个）\n接口详见 `references/basicdata-full.md`。\n\nAccoutLists(GET), AllMarketplace(GET), AttachmentDownload, ConceptSellerLists(GET), Currency, CustomAttachmentDownload, StateList, WorldStateLists\n\n### 销售（39个）\n接口详见 `references/sale-ops.md`（订单/Listing核心4个）+ `references/sale-full.md`（其余35个）。\n\n| 分组 | 接口 |\n|------|------|\n| 订单(7) | mwsOrders, OrderDetail, FBMOrderList, FBMOrderDetail, MCFOrderList, RefundOrder, afterSaleList |\n| Listing(5) | mwsListing, sale_ProductList, QueryProductList, GetPrices, listingOperateLogPageList |\n| 退货(3) | orderReturnInformation, ProductInformation, LogisticsInformation |\n| 促销(12) | promotionListingList, promotionListingDetailCoupon/Manage/PrimeDiscount/SecKill, promotionalActivitiesCouponList/ManageList/SecKillList/VipDiscountList, promotionCouponAllDetailBatch/ManagementAllDetailBatch/PrimeDiscountAllDetailBatch/SecKillAllDetailBatch |\n| 运营(7) | scOrderSetRemark, adjustPriceAdjustPriceManual, fbaFeeDifferenceList/MskuList, globalTagPageList, queryListingRelationTagList, GetFulfillmentResult |\n| 刊登(5) | PublishManageCategoryRoot/Children, PublishManageGetProductType, GetMerchantShippingGroup |\n\n### 产品（14个）\n接口详见 `references/product.md`。\n\nProductLists, ProductDetails, Brand, Category, UpcList, GetProductTag(GET), GetPagingLogLists, attributeList, batchGetProductInfo, bundledProductList, getTransparencyProductList, productAuxList, spuInfo, spuList\n\n### 财务（41个）\n接口详见 `references/finance.md`。\n\n| 分组 | 接口 |\n|------|------|\n| 利润报表(7) | profitAsin, profitAsinSon, profitSettlement, FianceProfitMsku, OrderProfitListMSKU, ProfitMsku |\n| 结算(6) | SettlementReport, SettlementExportUrlGet, settlementSummaryList, settlementTransactionList, CostStream, summaryQuery |\n| BD报表(7) | bdASIN, bdMSKU, bdOrder, bdParentASIN, bdSKU, bdSeller, bdSellerSummary |\n| 发票(3) | InvoiceList, InvoiceDetail, InvoiceCampaignList |\n| 费用管理(2) | feeManagementList, feeManagementType |\n| 资金池(6) | requestFundsPoolCustomFeeList/InboundList/LogisticsList/OtherFeeList/PrepayList/PurchaseList |\n| 应收(3) | receivableReportList, reportListDetail, reportListDetailInfo |\n| 其他(7) | QueryReceiptFundsList, RequestFundsOrderList, centerOdsDetailQuery, profitReportOrderTranscationList, lazadaPayoutList, lazadaSettlementList, shopeeAdjustmentList/IncomeList/PayoutList |\n\n### 统计（35个）\n接口详见 `references/statistics.md`。\n\n| 分组 | 接口 |\n|------|------|\n| 销量(4) | AsinDailyLists, AsinList, AsinListNew, StoreSales |\n| FBA仓储(5) | FBAStorageFeeLongTerm, FBAStorageFeeMonth, FbaStockReportList, FbaStockAggregateListNew, FbaStockDetailListNew |\n| 本地仓(4) | LocalAggregateList/New, LocalDetailList/New |\n| 海外仓(4) | OverseasAggregateList/New, OverseasDetailList/New |\n| 新版统计(4) | statisticsOpenASIN/MSKU/Parent/Seller |\n| 其他(14) | MonthRefund, ProfitMsku, ReimbursementList, ReturnOrderAnalysisLists, PurchaseReportBuyerList/ProductList/SupplierList, performanceTrendByHour, operateLogList/V2List, PlatformStatisticsSaleStatPageListV2, AmazonReportExportTask, reportCreate/QueryReportExportTask |\n\n### FBA发货（13个）\n接口详见 `references/fba.md`。\n\nFBAShipmentList, FBAReceivedInventory, ShipmentPlanLists, GetFbaProductList, GetInboundShipmentList, GetInboundShipmentListMwsDetailList, ShipFromAddressList, BoxInfo, GetHeadLogisticsFeeTypes, GetSeaTrackSupplierCarriers, QuerySTATaskList, StaTaskDetail, getInboundShipmentListMwsDetail\n\n### 亚马逊源表数据（20个）\n接口详见 `references/sourcedata.md`。\n\nAllOrders, FbaOrders, RefundOrders, Transaction, ManageInventory, DailyInventory, AfnFulfillableQuantity, ReservedInventory, RemovalLists, RemovalOrderListNew, RemovalShipmentList, SourceRemovalOrders, AdjustmentList, getAmazonFulfilledShipmentsList, getFbaAgeList, getFbaInventoryEventDetailList, v1getAmazonFulfilledShipmentsList, v1getFbaInventoryEventDetailList, fbaExchangeOrderList, fbmReturnOrderList\n\n### 补货建议（9个）\n接口详见 `references/fbasug.md`。\n\nGetSummaryList, ConfigASIN, ConfigMSKU, DailySalesInfoFeatureASIN, DailySalesInfoFeatureMSKU, InfoASIN, InfoMSKU, SourceListASIN, SourceListMSKU\n\n### 补货限制（2个）\n接口详见 `references/fbalimit.md`。\n\nGetIpiInfo, replenishmentRestrictionList\n\n### 采购（7个）\n接口详见 `references/purchase.md`。\n\nPurchaseOrderList, Supplier, changeOrderList, purchaseGetOrders, getPurchasePlans, getPurchaseReturnOrderList, purchaserLists\n\n### 仓库（32个）\n接口详见 `references/warehouse.md`。\n\n| 分组 | 接口 |\n|------|------|\n| 仓库/库存(11) | WarehouseLists, WarehouseStatement/New, InventoryDetails, inventoryBinDetails, wareHouseBinStatement, warehouseBin, FBAStock, FBAStock_v2, AwdWarehouseDetail |\n| 批次(2) | GetBatchDetailList, GetBatchStatementList |\n| 收货(4) | GetReceiveGoodRecords, PurchaseReceiptOrderList, ReceiptOrderQcList, getPackingData(GET) |\n| WMS(2) | WmsOrderList, WmsOrderDetail |\n| 海外仓(2) | OverseaWarehouseMatchList, OverSeasStockDetail |\n| 调拨/调整/盘点(3) | getStorageAdjustOrderList, getStorageAllocationList, checkGetOrderList/Detail |\n| 入库/出库(4) | inboundgetOrders, outboundgetOrders, listInbound, matchSkuList |\n| 其他(4) | getProcessOrderLists, ReturnList, removalInboundList, qualityInspectionOrderDetail |\n\n### 客服（18个）\n接口详见 `references/service.md`。\n\nFeedbackList, FeedbackListMws, CustomerList, AfterSalesWorkOrderList, PerformanceNoticeList, PerformanceNoticeDetail, mailDetail, mailLists, review, reviewDetail, reviewLists(GET), reviewV2, feedbackDetail, feedbackLists, customerServiceCrmcustomerIndex, customerServiceRmaManageList, storePerformanceList, voiceOfBuyerList\n\n### 物流（3个）\n接口详见 `references/logistics.md`。\n\nChannelList, QueryHeadLogisticsProvider, transportMethodList\n\n### 工具（4个）\n接口详见 `references/tools.md`。\n\nCompetitiveMonitorList, GetKeywordList, warningMessageGoodsList, warningMessageInventoryList\n\n### VC（7个）\n接口详见 `references/vc.md`。\n\nvcOrderPageList, vcOrderPoDetail, vcOrderDfDetail, vcDeliverPageList, vcDeliverDetail, listingManageVcListingPageList, platformAuthVcSellerPageList\n\n### 目标管理（2个）\n接口详见 `references/targetmanage.md`。\n\nStoreBatchSelect, UserBatchSelect\n\n### 多平台广告（28个）\n接口详见 `references/multiplatform-ads.md`。\n\n| 分组 | 接口 |\n|------|------|\n| TikTok(9) | queryCommonAdvertiserList, queryGmvStoreList, queryTiktokAdGroupList/AdList/CampaignList, queryAdvertiserList, queryGmvAdvertiserReportList/CampaignReportList/ItemGroupReportList |\n| Walmart(19) | queryAdGroupSvList, queryCampaignSpList, queryGroupSpList, queryPageTypeSPList, queryReportPageTypeSvList, reportAdGroupSbList, reportAdItemSbList/SpList/SvList, reportCampaignSbList/SvList, reportKeywordSbList/SpList/SvList, reportPageTypeSbList, reportPlatformSbList/SpList/SvList, reportSearchTrendsList |\n\n### 多平台V2（33个）\n接口详见 `references/multiplatform-v2.md`。\n\n| 分组 | 接口 |\n|------|------|\n| 订单(3) | MultiPlatOrderV2, newPlatformOrderList |\n| 店铺(1) | StoreInfoV2 |\n| Listing(2) | PairListV2, addCargoGoodsList |\n| 发货(4) | QueryShippingListV2, QueryShippingListPage, QueryWFSCargoPage/InventionPage |\n| 平台订单(8) | AliexpressListV2, aliexpressList, eBayList, walmartList, TemuList, TikTokList, SheinList, ShopifyVariantList |\n| 库存(6) | TemuCargo, CoupangStockList, FbsStockList, FbtStockList/Search, FullList, WayfairStockList |\n| 利润(4) | profitReportMsku/Order/Seller/Sku |\n| 其他(5) | WalmartPaymentQueryPage/Report, WalmartCommentList, LineList, addressReturnAddressList |\n\n## 店铺列表（--list-stores）\n\n调用 `GET /erp/sc/data/seller/lists` 接口，列出所有已授权亚马逊店铺。\n\n> **注意**：此接口需要领星 ERP **全量权限**。如果 AppKey 仅授权了广告数据，会返回 403。\n> 解决方法：在领星 ERP -> 开放接口中为该 AppKey 添加「基础数据」权限，或直接设置 `LINGXING_SID=<数字>` 跳过自动发现。\n\n## 注意事项\n\n- **SID 注入优先级**: `--params` 中显式传入 > `LINGXING_SID` 环境变量自动注入\n- **sid vs profile_id**: 广告类接口 sid 和 profile_id 二选一必填；dspReportOrderList 仅支持 profile_id\n- **GET 接口**: AccoutLists, AllMarketplace, ConceptSellerLists, GetProductTag, reviewLists, getPackingData 使用 GET 方法\n- **分页模式**: 大多数接口用 offset/length；WmsOrderList 等用 page/page_size；FBMOrderList 用 page/length\n- **响应格式**: `/cost/center/` 路径 API 数据在 `data.records` 或 `data.row_data` 下\n- **日期参数**: 报表类接口用 `report_date`（单日）；订单/利润类用 `start_date`/`end_date`（日期范围）；多平台V2用 Unix 时间戳（秒）\n- **Token 缓存**: token 自动缓存到 `/tmp/lingxing_token_*.json`，2小时有效\n- **限流**: 大多数接口令牌桶容量为 10，ProductAnalysisList 和 mwsOrders 仅为 1\n- **依赖**: 需要安装 `pycryptodome` 和 `requests`（`pip install pycryptodome requests`）\n\n## 错误处理\n\n| 场景 | 处理 |\n|------|------|\n| 环境变量未设置 | 脚本报错退出，提示设置 LINGXING_APP_ID/LINGXING_APP_SECRET |\n| Token 获取失败 | 检查 AppID/AppSecret 是否正确，IP 是否在白名单内 |\n| API 返回 code != 0 | 检查参数是否正确，参见错误信息 |\n| --list-stores 返回 403 | AppKey 仅有广告权限；设置 LINGXING_SID 直接指定店铺 |\n| 依赖未安装 | `pip install pycryptodome requests` |\n\n<!-- LF_LARGE_RESPONSE_BLOCK -->\n## Handling Large Responses\n\nTo avoid overflowing the agent context, persist the response to disk and extract only the fields you need:\n\n```\npython scripts/response_io.py run --script scripts/lingxing.py --out-dir <DIR> '<params>'\npython scripts/response_io.py read <file> --fields \"<paths>\"   # or --path \"<JMESPath>\"\n```\n\n> Pick `--out-dir` outside 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.\n\n`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.\n\n**When to prefer this pattern** — apply your judgment based on the response characteristics, e.g.:\n- High field count per record, or fields you don't need\n- Batch/paginated results (multiple items per call)\n- Long-text fields (descriptions, reviews, HTML, time series)\n- Output reused across later steps rather than consumed immediately\n\nFor small, single-use responses, calling the main script directly is fine.\n\n⚠️ The preview is a truncated schema + sample, not the full data. Any field-level decision must read from the persisted file via `read`.\n<!-- /LF_LARGE_RESPONSE_BLOCK -->\n\n## 解决认证和积分问题\n发生以下异常情况时，采用 references/onboarding.md 引导解决问题：\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n## 积分消耗规则\n\n不消耗积分。\n\nFile v1.0.5:_meta.json\n\n{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-lingxing-erp\",\n  \"version\": \"1.0.5\",\n  \"publishedAt\": 1786099973649\n}\n\nFile v1.0.5:references/api.md\n\n# 领星 OpenAPI — 调用说明（LinkFox 包装入口）\n\n本页对应 LinkFox skill **`linkfox-lingxing-erp`**：由 LinkFox 仓库收录领星官方材料并做路径说明，**请求仍直连领星**（非 LinkFox 工具网关）。完整接口清单、参数与返回字段见同目录下各专题文档；本页仅汇总认证、域名与脚本用法。\n\n## Base URL\n\n- **Host**: `https://openapi.lingxing.com`\n- 具体路径由 `scripts/lingxing.py` 内 `SPECIAL_PATHS` 与各模块约定决定，详见 `SKILL.md` 与各 `references/*.md`。\n\n## 认证与凭证\n\n| 变量 | 必填 | 说明 |\n|------|------|------|\n| `LINGXING_APP_ID` | 是 | 领星开放接口 AppID |\n| `LINGXING_APP_SECRET` | 是 | 领星开放接口 AppSecret |\n| `LINGXING_SID` | 否 | 默认店铺 SID；未在 `--params` 中写 `sid` 时由脚本注入 |\n\n在领星 ERP → **开放接口** 中创建应用并获取密钥；IP 白名单按领星文档配置。\n\n## 推荐执行方式\n\n在 skill 根目录 `skills/linkfox-lingxing-erp/` 下：\n\n```bash\nexport LINGXING_APP_ID=...\nexport LINGXING_APP_SECRET=...\n\npython3 scripts/lingxing.py --list-stores\npython3 scripts/lingxing.py --api help\npython3 scripts/lingxing.py --api <接口名> --params '<JSON>'\n```\n\n支持 `--all`、`--page-size` 等，见 `SKILL.md`「使用方式」与 `scripts/lingxing.py` 头部说明。\n\n## 依赖\n\n脚本需 **`requests`** 与 **`pycryptodome`**：\n\n```bash\npip install requests pycryptodome\n```\n\n## 分模块参考索引\n\n| 文档 | 内容 |\n|------|------|\n| `newad-report.md` | 新广告报表 SP/SB/SD 等 |\n| `basedata.md` | 广告基础数据 |\n| `basicdata-full.md` | 基础数据全量 |\n| `sale-ops.md` / `sale-full.md` | 销售订单、Listing、促销等 |\n| `product.md` | 产品 |\n| `finance.md` | 财务利润、结算、发票等 |\n| `statistics.md` | 统计报表 |\n| `fba.md` / `fbasug.md` / `fbalimit.md` | FBA 发货、补货建议与限制 |\n| `sourcedata.md` | 亚马逊源表 |\n| `purchase.md` | 采购 |\n| `warehouse.md` | 仓库库存 |\n| `service.md` | 客服、Review 等 |\n| `logistics.md` | 物流 |\n| `tools.md` | 工具类 |\n| `vc.md` | VC |\n| `targetmanage.md` | 目标管理 |\n| `multiplatform-ads.md` / `multiplatform-v2.md` | 多平台广告与订单 |\n\n## Feedback\n\n若需向 LinkFox 反馈本 skill 使用体验，可按仓库内其他 skill 的约定调用 Feedback API（`skillName` 使用 `linkfox-lingxing-erp`）。\n\nFile v1.0.5:references/basedata.md\n\n# 领星新广告基础数据接口参考（newAd/baseData）\n\n所有接口均为 POST 请求，域名：`https://openapi.lingxing.com`\n所有接口均为**只读查询**，令牌桶容量 10（`sbDivideAsinReports` 为 1）。\n`sid` 与 `profile_id` 二选一必填（`dspAccountList` 除外）。\n\n---\n\n## dspAccountList - 查询广告账号列表\n\n**路径**: `/basicOpen/baseData/account/list`（特殊路径）\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| type | 是 | string | `dsp` / `seller` / `vendor` |\n| offset | 否 | int | 分页偏移，默认 0 |\n| length | 否 | int | 每页条数，默认 20 |\n\n**关键返回字段**: profile_id, sid, name, type, country_code, currency_code, status(-1删除/0停止/1正常/2授权异常)\n\n---\n\n## portfolios - 广告组合\n\n**路径**: `/pb/openapi/newad/portfolios`\n\n**参数**: sid/profile_id, offset, length, next_token\n\n**关键返回字段**: portfolio_id, profile_id, name, state, budget(amount/policy/startDate/endDate), in_budget, serving_status\n\n---\n\n## SP 广告基础数据（6个）\n\n### spCampaigns - SP广告活动\n\n**路径**: `/pb/openapi/newad/spCampaigns`\n\n**参数**: sid/profile_id, state(enabled/paused/archived), offset, length, next_token\n\n**关键返回字段**: campaign_id, profile_id, name, targeting_type(auto/manual), state, serving_status, daily_budget, start_date, end_date, bidding(strategy/adjustments), portfolio_id, tags\n\n---\n\n### spAdGroups - SP广告组\n\n**路径**: `/pb/openapi/newad/spAdGroups`\n\n**参数**: sid/profile_id, state, campaign_id(可选), offset, length, next_token\n\n**关键返回字段**: ad_group_id, campaign_id, profile_id, name, default_bid, state, serving_status, bid_optimization\n\n---\n\n### spProductAds - SP广告商品\n\n**路径**: `/pb/openapi/newad/spProductAds`\n\n**参数**: sid/profile_id, state, ad_group_id(可选), offset, length, next_token\n\n**关键返回字段**: ad_id, campaign_id, ad_group_id, profile_id, sku, asin, state, serving_status\n\n---\n\n### spKeywords - SP关键词\n\n**路径**: `/pb/openapi/newad/spKeywords`\n\n**参数**: sid/profile_id, state, campaign_id(可选), ad_group_id(可选), offset, length, next_token\n\n**关键返回字段**: keyword_id, campaign_id, ad_group_id, profile_id, keyword_text, match_type(exact/phrase/broad), bid, state, serving_status\n\n---\n\n### spTargets - SP商品定位\n\n**路径**: `/pb/openapi/newad/spTargets`\n\n**参数**: sid/profile_id, state, campaign_id(可选), ad_group_id(可选), offset, length, next_token\n\n**关键返回字段**: target_id, campaign_id, ad_group_id, profile_id, expression_type(auto/manual), expression, resolved_expression, bid, state, serving_status\n\n---\n\n### spNegativeTargetsOrKeywords - SP否定投放\n\n**路径**: `/pb/openapi/newad/spNegativeTargetsOrKeywords`\n\n**参数**: sid/profile_id, campaign_id(可选), ad_group_id(可选), offset, length, next_token\n\n**关键返回字段**: campaign_id, ad_group_id, profile_id, negative_type(negativeKeyword/negativeAsin/negativeBrand), negative_text, negative_match_type, state\n\n---\n\n## SB 广告基础数据（5个）\n\n### hsaCampaigns - SB广告活动\n\n**路径**: `/pb/openapi/newad/hsaCampaigns`\n\n**参数**: sid/profile_id, state, offset, length, next_token\n\n**关键返回字段**: campaign_id, profile_id, name, budget, budget_type, state, serving_status, start_date, landing_page, bid_multiplier\n\n---\n\n### hsaAdGroups - SB广告组\n\n**路径**: `/pb/openapi/newad/hsaAdGroups`\n\n**参数**: sid/profile_id, state, campaign_id(可选), offset, length, next_token\n\n**关键返回字段**: ad_group_id, campaign_id, profile_id, name, state, serving_status\n\n---\n\n### hsaProductAds - SB广告创意\n\n**路径**: `/pb/openapi/newad/hsaProductAds`\n\n**参数**: sid/profile_id, offset, length, next_token\n\n**关键返回字段**: ad_id, campaign_id, ad_group_id, profile_id, state, creative(广告创意结构)\n\n---\n\n### sbTargeting - SB广告投放\n\n**路径**: `/pb/openapi/newad/sbTargeting`\n\n**参数**: sid/profile_id, ads_type(SB/SBV/ALL), state, offset, length, next_token\n\n**关键返回字段**: campaign_id, ad_group_id, keyword_id, keyword_text, keyword_bid, match_type, target_id, expression, target_bid, target_state, resolved_expression\n\n---\n\n### hsaNegativeKeywords - SB否定关键词\n\n**路径**: `/pb/openapi/newad/hsaNegativeKeywords`\n\n**参数**: sid/profile_id, state, campaign_id(可选), offset, length, next_token\n\n**关键返回字段**: keyword_id, campaign_id, ad_group_id, profile_id, keyword_text, match_type, state\n\n---\n\n### hsaNegativeTargets - SB否定商品投放\n\n**路径**: `/pb/openapi/newad/hsaNegativeTargets`\n\n**参数**: sid/profile_id, state, campaign_id(可选), offset, length, next_token\n\n**关键返回字段**: target_id, campaign_id, ad_group_id, profile_id, expression_type, expression, resolved_expression, state\n\n---\n\n### sbDivideAsinReports - SB分摊\n\n**路径**: `/pb/openapi/newad/sbDivideAsinReports`\n**令牌桶容量**: 1\n\n**参数**: profile_id(必填，不支持sid), report_date(Y-m-d), offset, length, next_token\n\n---\n\n## SD 广告基础数据（5个）\n\n### sdCampaigns - SD广告活动\n\n**路径**: `/pb/openapi/newad/sdCampaigns`\n\n**参数**: sid/profile_id, state, offset, length, next_token\n\n**关键返回字段**: campaign_id, profile_id, name, tactic(T00001/T00020/T00030), cost_type, budget_type, budget, state, serving_status, start_date\n\n---\n\n### sdAdGroups - SD广告组\n\n**路径**: `/pb/openapi/newad/sdAdGroups`\n\n**参数**: sid/profile_id, state, campaign_id(可选), offset, length, next_token\n\n**关键返回字段**: ad_group_id, campaign_id, profile_id, name, default_bid, state, serving_status, bid_optimization\n\n---\n\n### sdProductAds - SD广告商品\n\n**路径**: `/pb/openapi/newad/sdProductAds`\n\n**参数**: sid/profile_id, state, ad_group_id(可选), offset, length, next_token\n\n**关键返回字段**: ad_id, ad_group_id, campaign_id, profile_id, sku, asin, state, serving_status\n\n---\n\n### sdTargets - SD商品定位\n\n**路径**: `/pb/openapi/newad/sdTargets`\n\n**参数**: sid/profile_id, state, campaign_id(可选), offset, length, next_token\n\n**关键返回字段**: target_id, campaign_id, ad_group_id, profile_id, expression_type, expression, resolved_expression, bid, state, serving_status\n\n---\n\n### sdNegativeTargets - SD否定商品定位\n\n**路径**: `/pb/openapi/newad/sdNegativeTargets`\n\n**参数**: sid/profile_id, state, campaign_id(可选), offset, length, next_token\n\n**关键返回字段**: target_id, campaign_id, ad_group_id, profile_id, expression_type, expression, resolved_expression, state\n\n---\n\n## 通用说明\n\n- `state` 过滤：`enabled` / `paused` / `archived`，不传返回全部\n- `next_token` 分页游标：与 `offset` 同时传时以 `next_token` 为准，推荐优先用 `next_token`\n- `sbDivideAsinReports` 仅支持 `profile_id`，不支持 `sid`，且令牌桶容量仅 1，需串行调用\n\nFile v1.0.5:references/basicdata-full.md\n\n# 领星基础数据接口参考\n\n所有接口均为 POST 请求（除标注 GET 外），域名：`https://openapi.lingxing.com`\n\n---\n\n## AccoutLists - 查询ERP账户列表\n\n**路径**: `/erp/sc/data/account/lists`\n**方法**: GET（无请求参数）\n\n**关键返回字段**: uid, username, realname, mobile, email, status（0禁用/1正常）, role, seller（店铺权限）, is_master\n\n---\n\n## AllMarketplace - 查询亚马逊市场列表\n\n**路径**: `/erp/sc/data/seller/allMarketplace`\n**方法**: GET（无请求参数）\n\n**关键返回字段**: mid（领星站点ID）, region, country, code（国家代码如US/UK）, marketplace_id（亚马逊市场ID）\n\n---\n\n## AttachmentDownload - 附件下载\n\n**路径**: `/erp/sc/routing/common/file/download`\n**方法**: POST\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| file_id | 是 | int | 附件id（来自对应功能接口返回的附件id） |\n\n**关键返回字段**: file_name, mime_type, content（base64编码的文件内容）\n\n---\n\n## ConceptSellerLists - 查询概念店铺列表\n\n**路径**: `/erp/sc/data/seller/conceptLists`\n**方法**: GET（无请求参数）\n\n**关键返回字段**: id（概念店铺ID）, mid（概念市场ID）, name, seller_id, seller_account_name, seller_account_id, region, country, status（1启用/2禁用）\n\n---\n\n## Currency - 查询货币月汇率\n\n**路径**: `/erp/sc/routing/finance/currency/currencyMonth`\n**方法**: POST\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| date | 是 | string | 汇率月份，格式 YYYY-MM |\n\n**关键返回字段**: date, code（币种代码如CNY/USD）, icon, name, rate_org（官方汇率）, my_rate（自定义汇率）\n\n---\n\n## CustomAttachmentDownload - 自定义附件下载\n\n**路径**: `/erp/sc/routing/customized/file/download`\n**方法**: POST\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| file_id | 是 | string | 附件文件id（来自订单详情接口） |\n\n**关键返回字段**: file_name, mime_type, content（base64编码文件内容）\n\n---\n\n## StateList - 查询省份列表\n\n**路径**: `/basicOpen/multiplatform/profit/report/stateList`\n**方法**: POST\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| countryCode | 是 | string | 国家编码二字码，如 US/AF/DE |\n\n**关键返回字段**: data>>states>>countryCode, data>>states>>stateOrProvinceName, data>>states>>code（州/省编码）\n\n---\n\n## WorldStateLists - 查询亚马逊国家地区列表\n\n**路径**: `/erp/sc/data/worldState/lists`\n**方法**: POST\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| country_code | 是 | string | 国家code，来自 AllMarketplace 接口的 code 字段 |\n\n**关键返回字段**: country_code, state_or_province_name, code（地区code）\n\n---\n\nFile v1.0.5:references/fba.md\n\n# 领星FBA接口参考\n\n所有接口均为 POST 请求，域名：`https://openapi.lingxing.com`\n\n---\n\n## fbaShipmentList - 查询FBA发货单列表\n\n**路径**: `/erp/sc/data/fba_report/shipmentList`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sid | 是 | int | 店铺ID |\n| start_date | 否 | string | 开始日期，格式 Y-m-d |\n| end_date | 否 | string | 结束日期 |\n| status | 否 | string | 发货单状态 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 分页长度，默认1000 |\n\n**关键返回字段**: sid, shipment_id, shipment_name, status, destination_fulfillment_center_id, label_prep_type, create_date, item_list[seller_sku/fnsku/asin/quantity_shipped]\n\n---\n\n## fbaReceivedInventory - 查询FBA已收货库存\n\n**路径**: `/erp/sc/data/fba_report/receivedInventory`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sid | 是 | int | 店铺ID |\n| start_date | 否 | string | 开始日期，格式 Y-m-d |\n| end_date | 否 | string | 结束日期 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 分页长度，默认1000 |\n\n**关键返回字段**: sid, shipment_id, fnsku, asin, seller_sku, quantity_shipped, quantity_received, quantity_in_case\n\n---\n\n## shipmentPlanLists - 查询FBA发货计划列表\n\n**路径**: `/erp/sc/data/fba_report/shipmentPlanLists`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sid | 是 | int | 店铺ID |\n| start_date | 否 | string | 开始日期，格式 Y-m-d |\n| end_date | 否 | string | 结束日期 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 分页长度，默认1000 |\n\n**关键返回字段**: sid, plan_id, plan_name, status, create_date, item_list[seller_sku/asin/quantity]\n\n---\n\n## getFbaProductList - 查询FBA产品列表\n\n**路径**: `/erp/sc/routing/fba/shipment/getFbaProductList`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sid | 是 | int | 店铺ID |\n| search_field | 否 | string | 搜索字段：seller_sku/asin/fnsku |\n| search_value | 否 | string | 搜索值 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 分页长度，默认20 |\n\n**关键返回字段**: sid, seller_sku, asin, fnsku, product_name, local_sku, condition, prep_type\n\n---\n\n## getInboundShipmentList - 查询FBA入库发货单列表\n\n**路径**: `/erp/sc/routing/storage/shipment/getInboundShipmentList`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sid | 是 | int | 店铺ID |\n| start_date | 否 | string | 开始日期，格式 Y-m-d |\n| end_date | 否 | string | 结束日期 |\n| status | 否 | string | 发货单状态 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 分页长度，默认20 |\n\n**关键返回字段**: sid, shipment_id, shipment_name, status, fulfillment_center_id, create_date, total_quantity\n\n---\n\n## getInboundShipmentListMwsDetailList - 查询FBA入库发货单商品明细列表\n\n**路径**: `/erp/sc/routing/storage/shipment/getInboundShipmentListMwsDetailList`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sid | 是 | int | 店铺ID |\n| shipment_id | 是 | string | 发货单ID |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 分页长度，默认20 |\n\n**关键返回字段**: shipment_id, seller_sku, fnsku, asin, quantity_shipped, quantity_received, quantity_in_case\n\n---\n\n## shipFromAddressList - 查询FBA发货地址列表\n\n**路径**: `/erp/sc/routing/fba/shipment/shipFromAddressList`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sid | 是 | int | 店铺ID |\n\n**关键返回字段**: address_id, name, address_line1, city, state_or_province_code, country_code, postal_code\n\n---\n\n## boxInfo - 查询FBA箱规信息\n\n**路径**: `/erp/sc/routing/fba/shipment/boxInfo`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sid | 是 | int | 店铺ID |\n| shipment_id | 是 | string | 发货单ID |\n\n**关键返回字段**: shipment_id, box_list[box_no/length/width/height/weight/quantity/item_list]\n\n---\n\n## getHeadLogisticsFeeTypes - 查询头程费用类型\n\n**路径**: `/erp/sc/routing/fba/shipment/getHeadLogisticsFeeTypes`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sid | 否 | int | 店铺ID |\n\n**关键返回字段**: fee_type_id, fee_type_name, currency\n\n---\n\n## getSeaTrackSupplierCarriers - 查询海运跟踪供应商承运商\n\n**路径**: `/erp/sc/routing/fba/shipment/getSeaTrackSupplierCarriers`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| supplier_id | 否 | int | 供应商ID |\n\n**关键返回字段**: carrier_id, carrier_name, supplier_id\n\n---\n\n## querySTATaskList - 查询STA入库计划列表\n\n**路径**: `/amzStaServer/openapi/inbound-plan/page`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sid | 是 | int | 店铺ID |\n| status | 否 | string | 计划状态 |\n| start_date | 否 | string | 开始日期，格式 Y-m-d |\n| end_date | 否 | string | 结束日期 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 分页长度，默认20 |\n\n**关键返回字段**: inbound_plan_id, sid, status, create_date, total_boxes, total_quantity, marketplace_id\n\n---\n\n## staTaskDetail - 查询STA入库计划详情\n\n**路径**: `/amzStaServer/openapi/inbound-plan/detail`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| inbound_plan_id | 是 | string | 入库计划ID |\n| sid | 是 | int | 店铺ID |\n\n**关键返回字段**: inbound_plan_id, status, marketplace_id, shipment_list[shipment_id/status/destination/quantity], item_list[seller_sku/fnsku/asin/quantity]\n\n---\n\n## getInboundShipmentListMwsDetail - 查询FBA入库发货单商品明细\n\n**路径**: `/erp/sc/routing/storage/shipment/getInboundShipmentListMwsDetail`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sid | 是 | int | 店铺ID |\n| shipment_id | 是 | string | 发货单ID |\n\n**关键返回字段**: shipment_id, seller_sku, fnsku, asin, quantity_shipped, quantity_received, prep_detail_list\n\nFile v1.0.5:references/fbalimit.md\n\n# 领星FBA库容限制接口参考\n\n所有接口均为 POST 请求，域名：`https://openapi.lingxing.com`\n\n---\n\n## GetIpiInfo - 查询IPI绩效指标信息\n\n**路径**: `/erp/sc/routing/fbaLimit/restock/getIpiInfo`\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| offset | 否 | int | 分页偏移量 |\n| length | 否 | int | 分页长度 |\n| sids | 否 | string | 店铺id，多个以英文逗号分隔 |\n| seller_ids | 否 | string | 亚马逊卖家id，多个以英文逗号分隔 |\n| mids | 否 | string | 站点id，多个以英文逗号分隔 |\n\n**关键返回字段**: 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\n\n---\n\n## replenishmentRestrictionList - 查询补货限制列表\n\n**路径**: `/basicOpen/openapi/replenishmentRestriction/page/list`\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| storage_type | 是 | string | 仓储类型 |\n| offset | 否 | int | 分页偏移量 |\n| length | 否 | int | 分页长度 |\n| sids | 否 | string | 店铺id，多个以英文逗号分隔 |\n\n**关键返回字段**: 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\n\n---\n\nFile v1.0.5:references/fbasug.md\n\n# 领星FBA补货建议接口参考\n\n所有接口均为 POST 请求，域名：`https://openapi.lingxing.com`\n\n---\n\n## GetSummaryList - 查询补货建议汇总列表\n\n**路径**: `/erp/sc/routing/restocking/analysis/getSummaryList`\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| data_type | 是 | int | 数据维度类型 |\n| sid_list | 否 | array | 店铺id列表 |\n| asin_list | 否 | array | ASIN列表 |\n| msku_list | 否 | array | MSKU列表 |\n| mode | 否 | int | 模式 |\n| listing_date_range | 否 | array | 上架日期范围 |\n| offset | 否 | int | 分页偏移量 |\n| length | 否 | int | 分页长度 |\n\n**关键返回字段**: data>>basic_info>>data_type, data>>basic_info>>node_type, data>>basic_info>>sid, data>>basic_info>>asin, data>>basic_info>>msku_fnsku_list\n\n---\n\n## ConfigASIN - 查询ASIN补货配置\n\n**路径**: `/erp/sc/routing/fbaSug/asin/getConfig`\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sid | 是 | int | 店铺id |\n| asin | 是 | string | ASIN |\n\n**关键返回字段**: data>>info>>days_total, data>>info>>days_total2, data>>info>>days_plan, data>>info>>days_purchase, data>>info>>days_qc\n\n---\n\n## ConfigMSKU - 查询MSKU补货配置\n\n**路径**: `/erp/sc/routing/fbaSug/msku/getConfig`\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sid | 是 | string | 店铺id |\n| msku | 是 | string | MSKU |\n\n**关键返回字段**: data>>info>>days_total, data>>info>>days_total2, data>>info>>days_plan, data>>info>>days_purchase, data>>info>>days_qc\n\n---\n\n## DailySalesInfoFeatureASIN - 查询ASIN日销售特征数据\n\n**路径**: `/erp/sc/routing/fbaSug/asin/getDailySalesInfoFeature`\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sid | 是 | int | 店铺id |\n| asin | 是 | string | ASIN |\n| sug_type | 是 | int | 建议类型 |\n| mode | 否 | int | 模式 |\n\n**关键返回字段**: data>>list（日期销量列表）, data>>sug_date_line>>date, data>>sug_date_line>>desc, data>>sug_date_line>>title\n\n---\n\n## DailySalesInfoFeatureMSKU - 查询MSKU日销售特征数据\n\n**路径**: `/erp/sc/routing/fbaSug/msku/getDailySalesInfoFeature`\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sid | 是 | int | 店铺id |\n| msku | 是 | string | MSKU |\n| sug_type | 是 | int | 建议类型 |\n| mode | 否 | int | 模式 |\n\n**关键返回字段**: data>>list（日期销量列表）, data>>sug_date_line>>date, data>>sug_date_line>>desc, data>>sug_date_line>>title\n\n---\n\n## InfoASIN - 查询ASIN补货建议信息\n\n**路径**: `/erp/sc/routing/fbaSug/asin/getInfo`\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sid | 是 | int | 店铺id |\n| asin | 是 | string | ASIN |\n| mode | 否 | int | 模式 |\n\n**关键返回字段**: data>>sid, data>>asin, data>>mode, data>>quantity_fba_valid, data>>msku_list>>msku\n\n---\n\n## InfoMSKU - 查询MSKU补货建议信息\n\n**路径**: `/erp/sc/routing/fbaSug/msku/getInfo`\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sid | 是 | int | 店铺id |\n| msku | 是 | string | MSKU |\n| mode | 否 | int | 模式 |\n\n**关键返回字段**: data>>sid, data>>msku, data>>mode, data>>quantity_sug_replenishment, data>>quantity_sug_send, data>>quantity_fba_valid\n\n---\n\n## SourceListASIN - 查询ASIN补货来源列表\n\n**路径**: `/erp/sc/routing/fbaSug/asin/getSourceList`\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sid | 是 | int | 店铺id |\n| asin | 是 | string | ASIN |\n| type | 否 | string | 补货来源类型 |\n| mode | 否 | string | 模式 |\n\n**关键返回字段**: data>>mode, data>>source_list>>quantity, data>>source_list>>type, data>>source_list>>amazon_sale_date, data>>source_list>>remark\n\n---\n\n## SourceListMSKU - 查询MSKU补货来源列表\n\n**路径**: `/erp/sc/routing/fbaSug/msku/getSourceList`\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sid | 是 | int | 店铺id |\n| msku | 是 | string | MSKU |\n| type | 否 | string | 补货来源类型 |\n| mode | 否 | string | 模式 |\n\n**关键返回字段**: data>>mode, data>>source_list>>quantity, data>>source_list>>type, data>>source_list>>amazon_sale_date, data>>source_list>>remark\n\n---\n\nFile v1.0.5:references/finance.md\n\n# 领星财务接口参考\n\n所有接口均为 POST 请求，域名：`https://openapi.lingxing.com`\n\n---\n\n## profitAsin - 查询ASIN利润报表\n\n**路径**: `/erp/sc/routing/finance/ProfitState/profitAsin`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| month | 是 | string | 月份，格式 Y-m |\n| sids | 否 | string | 店铺ID，多个逗号分隔 |\n| currency_type | 否 | string | 币种：1=CNY，2=USD，3=EUR等 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，上限200 |\n\n**关键返回字段**: sid, asin, parent_asin, seller_sku, month, sales_amount, cost, profit, profit_rate, fba_fee, commission, ad_cost\n\n---\n\n## profitAsinSon - 查询ASIN子变体利润\n\n**路径**: `/erp/sc/routing/finance/ProfitState/profitAsinSon`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| month | 是 | string | 月份，格式 Y-m |\n| sids | 否 | string | 店铺ID，多个逗号分隔 |\n| asin | 否 | string | 父ASIN |\n| version | 否 | int | 版本号 |\n| currency_type | 否 | string | 币种 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，上限200 |\n\n**关键返回字段**: sid, asin, seller_sku, month, sales_amount, profit, profit_rate\n\n---\n\n## profitSettlement - 查询结算利润报表\n\n**路径**: `/erp/sc/routing/finance/ProfitState/profitSettlement`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sids | 否 | string | 店铺ID，多个逗号分隔 |\n| start_date | 是 | string | 开始日期，格式 Y-m-d |\n| end_date | 是 | string | 结束日期 |\n| currency_type | 否 | string | 币种 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，上限200 |\n\n**关键返回字段**: sid, amazon_order_id, settlement_id, sales_amount, fba_fee, commission, profit, currency\n\n---\n\n## profitMsku - 查询MSKU利润报表\n\n**路径**: `/erp/sc/routing/finance/ProfitState/profitMsku`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| month | 是 | string | 月份，格式 Y-m |\n| sids | 否 | string | 店铺ID，多个逗号分隔 |\n| currency_type | 否 | string | 币种 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，上限200 |\n\n**关键返回字段**: sid, seller_sku, asin, month, sales_amount, profit, profit_rate, fba_fee, commission\n\n---\n\n## settlementReport - 查询结算报告\n\n**路径**: `/cost/center/api/settlement/report`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| amazonSellerIds | 否 | array | 亚马逊店铺ID列表 |\n| sids | 否 | array | 领星店铺ID列表 |\n| timeType | 是 | int | 时间类型：1=结算开始时间，2=结算结束时间 |\n| filterBeginDate | 是 | string | 开始日期，格式 Y-m-d |\n| filterEndDate | 是 | string | 结束日期 |\n\n**关键返回字段**: settlement_id, sid, start_date, end_date, total_amount, currency\n\n---\n\n## costStream - 查询成本流水\n\n**路径**: `/cost/center/api/cost/stream`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| mskus | 否 | array | MSKU列表 |\n| business_types | 是 | array | 业务类型列表 |\n| query_type | 是 | int | 查询类型 |\n| start_date | 否 | string | 开始日期 |\n| end_date | 否 | string | 结束日期 |\n\n**关键返回字段**: msku, business_type, amount, currency, date, remark\n\n---\n\n## orderProfitListMSKU - 查询订单MSKU利润明细\n\n**路径**: `/basicOpen/finance/mreport/OrderProfit`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sids | 否 | string | 店铺ID，多个逗号分隔 |\n| startDate | 是 | string | 开始日期，格式 Y-m-d |\n| endDate | 是 | string | 结束日期 |\n| searchField | 否 | string | 搜索字段：amazon_order_id/seller_sku/asin |\n| searchValue | 否 | string | 搜索值 |\n| currencyCode | 否 | string | 货币代码 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: amazon_order_id, sid, seller_sku, asin, sales_amount, fba_fee, commission, profit, currency\n\n---\n\n## invoiceList - 查询发票列表\n\n**路径**: `/bd/profit/report/open/report/ads/invoice/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sids | 否 | array | 店铺ID列表 |\n| start_date | 否 | string | 开始日期 |\n| end_date | 否 | string | 结束日期 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: invoice_id, sid, invoice_date, amount, currency, status, campaign_count\n\n---\n\n## invoiceDetail - 查询发票详情\n\n**路径**: `/bd/profit/report/open/report/ads/invoice/detail`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| invoice_id | 是 | string | 发票ID |\n| sid | 是 | int | 店铺ID |\n\n**关键返回字段**: invoice_id, sid, invoice_date, amount, currency, status, line_items\n\n---\n\n## invoiceCampaignList - 查询发票广告活动列表\n\n**路径**: `/bd/profit/report/open/report/ads/invoice/campaign/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| invoice_id | 是 | string | 发票ID |\n| sid | 是 | int | 店铺ID |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: campaign_id, campaign_name, spend, impressions, clicks\n\n---\n\n## queryReceiptFundsList - 查询收款记录列表\n\n**路径**: `/basicOpen/finance/queryReceiptFundsList`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sids | 否 | string | 店铺ID，多个逗号分隔 |\n| start_date | 否 | string | 开始日期 |\n| end_date | 否 | string | 结束日期 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: receipt_id, sid, amount, currency, receipt_date, status\n\n---\n\n## requestFundsOrderList - 查询付款单列表\n\n**路径**: `/basicOpen/finance/requestFunds/order/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| start_date | 否 | string | 开始日期 |\n| end_date | 否 | string | 结束日期 |\n| status | 否 | int | 状态 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: order_id, amount, currency, status, create_time, type\n\n---\n\n## settlementExportUrlGet - 获取结算报告导出URL\n\n**路径**: `/bd/sp/api/open/settlement/export/url/get`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| settlement_id | 是 | string | 结算ID |\n| sid | 是 | int | 店铺ID |\n\n**关键返回字段**: url, expires_at\n\n---\n\n## bdAsin - 查询ASIN利润分析报表\n\n**路径**: `/bd/profit/report/open/report/asin/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| startDate | 是 | string | 开始日期，格式 Y-m-d |\n| endDate | 是 | string | 结束日期 |\n| sids | 否 | array | 店铺ID列表 |\n| currencyCode | 否 | string | 货币代码 |\n| monthlyQuery | 否 | int | 是否按月查询：0=否，1=是 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: asin, sid, sales_amount, ad_cost, fba_fee, commission, profit, profit_rate, currency\n\n---\n\n## bdMsku - 查询MSKU利润分析报表\n\n**路径**: `/bd/profit/report/open/report/msku/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| startDate | 是 | string | 开始日期 |\n| endDate | 是 | string | 结束日期 |\n| sids | 否 | array | 店铺ID列表 |\n| currencyCode | 否 | string | 货币代码 |\n| monthlyQuery | 否 | int | 是否按月查询 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: seller_sku, asin, sid, sales_amount, profit, profit_rate, currency\n\n---\n\n## bdOrder - 查询订单利润分析报表\n\n**路径**: `/bd/profit/report/open/report/order/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| startDate | 是 | string | 开始日期 |\n| endDate | 是 | string | 结束日期 |\n| sids | 否 | array | 店铺ID列表 |\n| currencyCode | 否 | string | 货币代码 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: amazon_order_id, sid, sales_amount, profit, profit_rate, currency, purchase_date\n\n---\n\n## bdParentAsin - 查询父ASIN利润分析报表\n\n**路径**: `/bd/profit/report/open/report/parent/asin/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| startDate | 是 | string | 开始日期 |\n| endDate | 是 | string | 结束日期 |\n| sids | 否 | array | 店铺ID列表 |\n| currencyCode | 否 | string | 货币代码 |\n| monthlyQuery | 否 | int | 是否按月查询 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: parent_asin, sid, sales_amount, profit, profit_rate, currency\n\n---\n\n## bdSku - 查询SKU利润分析报表\n\n**路径**: `/bd/profit/report/open/report/sku/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| startDate | 是 | string | 开始日期 |\n| endDate | 是 | string | 结束日期 |\n| sids | 否 | array | 店铺ID列表 |\n| currencyCode | 否 | string | 货币代码 |\n| monthlyQuery | 否 | int | 是否按月查询 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: sku, asin, sid, sales_amount, profit, profit_rate, currency\n\n---\n\n## bdSeller - 查询店铺利润分析报表\n\n**路径**: `/bd/profit/report/open/report/seller/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| startDate | 是 | string | 开始日期 |\n| endDate | 是 | string | 结束日期 |\n| sids | 否 | array | 店铺ID列表 |\n| currencyCode | 否 | string | 货币代码 |\n| monthlyQuery | 否 | int | 是否按月查询 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: sid, seller_name, sales_amount, profit, profit_rate, currency\n\n---\n\n## bdSellerSummary - 查询店铺利润汇总报表\n\n**路径**: `/bd/profit/report/open/report/seller/summary/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| startDate | 是 | string | 开始日期 |\n| endDate | 是 | string | 结束日期 |\n| sids | 否 | array | 店铺ID列表 |\n| currencyCode | 否 | string | 货币代码 |\n\n**关键返回字段**: sid, seller_name, total_sales, total_profit, profit_rate, currency\n\n---\n\n## centerOdsDetailQuery - 查询成本中心ODS明细\n\n**路径**: `/cost/center/ods/detail/query`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| mskus | 否 | array | MSKU列表 |\n| start_date | 否 | string | 开始日期 |\n| end_date | 否 | string | 结束日期 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: msku, cost_type, amount, currency, date, warehouse\n\n---\n\n## feeManagementList - 查询其他费用列表\n\n**路径**: `/bd/fee/management/open/feeManagement/otherFee/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sids | 否 | array | 店铺ID列表 |\n| start_date | 否 | string | 开始日期 |\n| end_date | 否 | string | 结束日期 |\n| fee_type | 否 | string | 费用类型 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: fee_id, sid, fee_type, fee_name, amount, currency, date\n\n---\n\n## feeManagementType - 查询费用类型列表\n\n**路径**: `/bd/fee/management/open/feeManagement/otherFee/type`\n**令牌桶容量**: 1\n\n**参数**: 无\n\n**关键返回字段**: type_id, type_name, type_code\n\n---\n\n## lazadaPayoutList - 查询Lazada打款记录\n\n**路径**: `/basicOpen/finance/lazada/payout/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| store_ids | 否 | array | 店铺ID列表 |\n| start_date | 否 | string | 开始日期 |\n| end_date | 否 | string | 结束日期 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: payout_id, store_id, amount, currency, payout_date, status\n\n---\n\n## lazadaSettlementList - 查询Lazada结算列表\n\n**路径**: `/basicOpen/finance/lazada/settlement/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| store_ids | 否 | array | 店铺ID列表 |\n| start_date | 否 | string | 开始日期 |\n| end_date | 否 | string | 结束日期 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: settlement_id, store_id, amount, currency, start_date, end_date, status\n\n---\n\n## profitReportOrderTranscationList - 查询订单交易利润报表\n\n**路径**: `/basicOpen/finance/profitReport/order/transcation/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sids | 否 | string | 店铺ID，多个逗号分隔 |\n| start_date | 是 | string | 开始日期 |\n| end_date | 是 | string | 结束日期 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: amazon_order_id, sid, transaction_type, amount, currency, posted_date\n\n---\n\n## receivableReportList - 查询应收账款报表列表\n\n**路径**: `/bd/sp/api/open/monthly/receivable/report/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sids | 否 | array | 店铺ID列表 |\n| year_month | 否 | string | 年月，格式 Y-m |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: report_id, sid, year_month, receivable_amount, currency, status\n\n---\n\n## reportListDetail - 查询应收账款报表明细\n\n**路径**: `/bd/sp/api/open/monthly/receivable/report/list/detail`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| report_id | 是 | string | 报表ID |\n| sid | 是 | int | 店铺ID |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: settlement_id, amount, currency, start_date, end_date\n\n---\n\n## reportListDetailInfo - 查询应收账款报表明细详情\n\n**路径**: `/bd/sp/api/open/monthly/receivable/report/list/detail/info`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| report_id | 是 | string | 报表ID |\n| settlement_id | 是 | string | 结算ID |\n| sid | 是 | int | 店铺ID |\n\n**关键返回字段**: settlement_id, transaction_list[type/amount/currency/date]\n\n---\n\n## requestFundsPoolCustomFeeList - 查询资金池自定义费用列表\n\n**路径**: `/basicOpen/finance/requestFundsPool/customFee/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| pool_id | 是 | int | 资金池ID |\n| start_date | 否 | string | 开始日期 |\n| end_date | 否 | string | 结束日期 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: fee_id, pool_id, fee_type, amount, currency, date, remark\n\n---\n\n## requestFundsPoolInboundList - 查询资金池头程费用列表\n\n**路径**: `/basicOpen/finance/requestFundsPool/inbound/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| pool_id | 是 | int | 资金池ID |\n| start_date | 否 | string | 开始日期 |\n| end_date | 否 | string | 结束日期 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: fee_id, pool_id, shipment_no, amount, currency, date\n\n---\n\n## requestFundsPoolLogisticsList - 查询资金池物流费用列表\n\n**路径**: `/basicOpen/finance/requestFundsPool/logistics/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| pool_id | 是 | int | 资金池ID |\n| start_date | 否 | string | 开始日期 |\n| end_date | 否 | string | 结束日期 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: fee_id, pool_id, order_no, amount, currency, date\n\n---\n\n## requestFundsPoolOtherFeeList - 查询资金池其他费用列表\n\n**路径**: `/basicOpen/finance/requestFundsPool/otherFee/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| pool_id | 是 | int | 资金池ID |\n| start_date | 否 | string | 开始日期 |\n| end_date | 否 | string | 结束日期 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: fee_id, pool_id, fee_type, amount, currency, date\n\n---\n\n## requestFundsPoolPrepayList - 查询资金池预付款列表\n\n**路径**: `/basicOpen/finance/requestFundsPool/prepay/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| pool_id | 是 | int | 资金池ID |\n| start_date | 否 | string | 开始日期 |\n| end_date | 否 | string | 结束日期 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: prepay_id, pool_id, amount, currency, date, status\n\n---\n\n## requestFundsPoolPurchaseList - 查询资金池采购费用列表\n\n**路径**: `/basicOpen/finance/requestFundsPool/purchase/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| pool_id | 是 | int | 资金池ID |\n| start_date | 否 | string | 开始日期 |\n| end_date | 否 | string | 结束日期 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: fee_id, pool_id, purchase_order_no, amount, currency, date\n\n---\n\n## settlementSummaryList - 查询结算汇总列表\n\n**路径**: `/bd/sp/api/open/settlement/summary/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| sids | 否 | array | 店铺ID列表 |\n| start_date | 否 | string | 开始日期 |\n| end_date | 否 | string | 结束日期 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: settlement_id, sid, start_date, end_date, total_amount, deposit_amount, currency\n\n---\n\n## settlementTransactionList - 查询结算交易明细列表\n\n**路径**: `/bd/sp/api/open/settlement/transaction/detail/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| settlement_id | 是 | string | 结算ID |\n| sid | 是 | int | 店铺ID |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: transaction_id, settlement_id, type, amount, currency, posted_date, order_id\n\n---\n\n## shopeeAdjustmentList - 查询Shopee调整列表\n\n**路径**: `/basicOpen/finance/shopee/adjustment/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| store_ids | 否 | array | 店铺ID列表 |\n| start_date | 否 | string | 开始日期 |\n| end_date | 否 | string | 结束日期 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: adjustment_id, store_id, type, amount, currency, date, reason\n\n---\n\n## shopeeIncomeList - 查询Shopee收入列表\n\n**路径**: `/basicOpen/finance/shopee/income/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| store_ids | 否 | array | 店铺ID列表 |\n| start_date | 否 | string | 开始日期 |\n| end_date | 否 | string | 结束日期 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: income_id, store_id, order_id, amount, currency, income_date, type\n\n---\n\n## shopeePayoutList - 查询Shopee打款列表\n\n**路径**: `/basicOpen/finance/shopee/payout/list`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| store_ids | 否 | array | 店铺ID列表 |\n| start_date | 否 | string | 开始日期 |\n| end_date | 否 | string | 结束日期 |\n| offset | 否 | int | 分页偏移量，默认0 |\n| length | 否 | int | 每页条数，默认20 |\n\n**关键返回字段**: payout_id, store_id, amount, currency, payout_date, status\n\n---\n\n## summaryQuery - 查询成本中心ODS汇总\n\n**路径**: `/cost/center/ods/summary/query`\n**令牌桶容量**: 1\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| mskus | 否 | array | MSKU列表 |\n| start_date | 否 | string | 开始日期 |\n| end_date | 否 | string | 结束日期 |\n\n**关键返回字段**: msku, total_cost, cost_by_type[type/amount/currency]\n\nFile v1.0.5:references/logistics.md\n\n# 领星物流接口参考\n\n所有接口均为 POST 请求，域名：`https://openapi.lingxing.com`\n\n---\n\n## ChannelList - 查询物流渠道列表\n\n**路径**: `/erp/sc/data/local_inventory/channelList`\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| offset | 是 | int | 分页偏移量 |\n| length | 是 | int | 分页长度 |\n\n**关键返回字段**: id, channel_name, method_id, method_name, billing_type, volume_calc_param, zip_code, valid_period\n\n---\n\n## QueryHeadLogisticsProvider - 查询头程物流商列表\n\n**路径**: `/basicOpen/logistics/headLogisticsProvider/query/list`\n\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| search | 是 | object | 搜索条件对象 |\n| search>>page | 是 | int | 页码 |\n| search>>length | 是 | int | 每页大小 |\n| search>>enabled | 否 | int | 是否启用 |\n| search>>isAuth | 否 | int | 是否已授权 |\n| search>>payMethod | 否 | int | 付款方式 |\n| search>>searchField | 否 | string | 搜索字段名 |\n| search>>searchValue | 否 | string | 搜索值 |\n\n**关键返回字段**: 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\n\n---\n\n## transportMethodList - 查询运输方式列表\n\n**路径**: `/basicOpen/businessConfig/transportMethod/list`\n**参数**: 无（直接调用即可）\n\n**关键返回字段**: data>>method_id, data>>code, data>>name, data>>is_system, data>>enabled, data>>remark, data>>creator_id, data>>creator_name\n\n---\n\nFile v1.0.5:references/multiplatform-ads.md\n\n# 领星多平台广告接口参考\n\n所有接口均为 POST 请求，域名：`https://openapi.lingxing.com`\n\n---\n\n## TikTok 推广广告\n\n### queryAdvertiserList - 查询广告账号\n\n**路径**: `/basicOpen/multiplatform/ads/queryAdvertiserList`\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| startDate | 是 | string | 开始日期，yyyy-MM-dd，间隔不超过31天 |\n| endDate | 是 | string | 结束日期，yyyy-MM-dd |\n| length | 是 | int | 每页条数，小于2000 |\n| page | 是 | int | 页码 |\n| advertiserIds | 否 | array | 广告账号ID列表 |\n| status | 否 | array | STATUS_ENABLE/SYSTEM_STATUS_IN_REVIEW/SYSTEM_STATUS_NOT_PASS/STATUS_LIMIT/STATUS_DISABLE |\n| currencies | 否 | array | 币种列表，如 [\"USD\",\"CNY\"] |\n| orderField | 否 | string | 排序字段（驼峰） |\n| orderType | 否 | string | ASC/DESC |\n| searchType | 否 | string | advertiser_name/ad_group_name/campaign_name/ad_name |\n| searchValue | 否 | array | 搜索值 |\n\n**关键返回字段**: advertiserId, advertiserName, spend, impressions, clicks, ctr, cpc, orders, revenue, roas\n\n---\n\n### queryCommonAdvertiserList - 查询推广广告账号（通用）\n\n**路径**: `/basicOpen/multiplatform/ads/queryCommonAdvertiserList`\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| internalStatus | 否 | string | ENABLE/DISABLE/DELETE |\n| hasGmvStore | 否 | int | 1=只返回有GMV店铺的账号 |\n\n**关键返回字段**: 广告账号基础信息列表\n\n---\n\n### queryTiktokCampaignList - 查询广告系列\n\n**路径**: `/basicOpen/multiplatform/ads/queryTiktokCampaignList`\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| startDate | 是 | string | 开始日期，yyyy-MM-dd，间隔不超过31天 |\n| endDate | 是 | string | 结束日期 |\n| length | 是 | int | 每页条数，小于2000 |\n| page | 是 | int | 页码 |\n| advertiserIds | 否 | array | 广告账号ID列表 |\n| campaignIds | 否 | array | 广告活动ID列表 |\n| objectiveType | 否 | array | REACH/TRAFFIC/VIDEO_VIEWS/LEAD_GENERATION/ENGAGEMENT/APP_PROMOTION/WEB_CONVERSIONS/PRODUCT_SALES |\n| status | 否 | array | STATUS_ENABLE/STATUS_DISABLE 等 |\n| summaryCurrency | 否 | string | 汇总币种 |\n\n**关键返回字段**: campaignId, campaignName, spend, impressions, clicks, orders, revenue, roas, status\n\n---\n\n### queryTiktokAdGroupList - 查询广告组\n\n**路径**: `/basicOpen/multiplatform/ads/queryTiktokAdGroupList`\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| startDate | 是 | string | 开始日期，yyyy-MM-dd，间隔不超过31天 |\n| endDate | 是 | string | 结束日期 |\n| length | 是 | int | 每页条数，小于2000 |\n| page | 是 | int | 页码 |\n| advertiserIds | 否 | array | 广告账号ID列表 |\n| campaignIds | 否 | array | 广告活动ID列表 |\n| status | 否 | array | STATUS_ENABLE/STATUS_DISABLE 等 |\n| searchType | 否 | string | ad_group_name 等 |\n\n**关键返回字段**: adGroupId, adGroupName, campaignId, spend, impressions, clicks, orders, roas\n\n---\n\n### queryTiktokAdList - 查询广告\n\n**路径**: `/basicOpen/multiplatform/ads/queryTiktokAdList`\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| startDate | 是 | string | 开始日期，yyyy-MM-dd，间隔不超过31天 |\n| endDate | 是 | string | 结束日期 |\n| length | 是 | int | 每页条数，小于2000 |\n| page | 是 | int | 页码 |\n| advertiserIds | 否 | array | 广告账号ID列表 |\n| campaignIds | 否 | array | 推广系列ID列表 |\n| adgroupIds | 否 | array | 广告组ID列表 |\n| adIds | 否 | array | 广告ID列表 |\n\n**关键返回字段**: adId, adName, adGroupId, campaignId, spend, impressions, clicks, orders, roas, status\n\n---\n\n## TikTok GMV Max\n\n### queryGmvStoreList - 查询 GMV MAX 店铺列表\n\n**路径**: `/basicOpen/multiplatform/ads/queryGmvStoreList`\n**参数**: 无必填参数\n\n**关键返回字段**: advertiserId, storeId, storeName\n\n---\n\n### queryGmvAdvertiserReportList - 查询 GMV MAX 广告账号报告\n\n**路径**: `/basicOpen/multiplatform/ads/queryGmvAdvertiserReportList`\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| startDate | 是 | string | 开始日期，yyyy-MM-dd，间隔不超过31天 |\n| endDate | 是 | string | 结束日期 |\n| length | 是 | int | 每页条数，小于2000 |\n| page | 是 | int | 页码，从1开始 |\n| advertiserIds | 否 | array | 广告账号ID列表 |\n| gmvMaxPromotionTypeCodes | 否 | array | PRODUCT/LIVE |\n| storeIds | 否 | array | 店铺ID列表 |\n| summaryCurrency | 否 | string | 汇总币种，默认USD |\n\n**关键返回字段**: subjectId, reportDate, cost, orders, roi, grossRevenue（唯一键：subjectId+reportDate）\n\n---\n\n### queryGmvCampaignReportList - 查询 GMV MAX 推广系列报告\n\n**路径**: `/basicOpen/multiplatform/ads/queryGmvCampaignReportList`\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| startDate | 是 | string | 开始日期，yyyy-MM-dd，间隔不超过31天 |\n| endDate | 是 | string | 结束日期 |\n| length | 是 | int | 每页条数，小于2000 |\n| page | 是 | int | 页码，从1开始 |\n| advertiserIds | 否 | array | 广告账号ID列表 |\n| campaignIds | 否 | array | 推广系列ID列表 |\n| gmvMaxPromotionTypeCodes | 否 | array | PRODUCT/LIVE |\n| status | 否 | array | ENABLE/DISABLE/DELETE |\n\n**关键返回字段**: subjectId, campaignId, reportDate, cost, orders, roi（唯一键：subjectId+reportDate）\n\n---\n\n### queryGmvItemGroupReportList - 查询 GMV MAX 广告商品报告\n\n**路径**: `/basicOpen/multiplatform/ads/queryGmvItemGroupReportList`\n**参数**:\n| 参数 | 必填 | 类型 | 说明 |\n|------|------|------|------|\n| startDate | 是 | string | 开始日期，yyyy-MM-dd，间隔不超过31天 |\n| endDate | 是 | string | 结束日期 |\n| length | 是 | int | 每页条数，小于2000 |\n| page | 是 | int | 页码 |\n| advertiserIds | 否 | array | 广告账号ID列表 |\n| itemGroupIds | 否 | array | 广告商品ID列表 |\n| status | 否 | array | available/unavailable |\n\n**关键返回字段**: subjectId, reportDate, grossRevenue, cost, orders, roi（唯一键：subjectId+reportDate）\n\n---\n\n## 沃尔玛广告 - SP 广告\n\n### queryCampaignSpList - 查询 SP 广告活动\n\n**路径**: `/basicOpen/multiplatform/ads/q\n\nArchive v1.0.4: 27 files, 76888 bytes\n\nFiles: _meta.json (139b), references/api.md (2427b), references/basedata.md (6901b), references/basicdata-full.md (2891b), references/fba.md (6624b), references/fbalimit.md (1417b), references/fbasug.md (4352b), references/finance.md (22193b), references/logistics.md (1657b), references/multiplatform-ads.md (14140b), references/multiplatform-v2.md (15569b), references/newad-report.md (9507b), references/product.md (7749b), references/purchase.md (5103b), references/sale-full.md (18675b), references/sale-ops.md (4857b), references/service.md (11308b), references/sourcedata.md (11520b), references/statistics.md (25011b), references/targetmanage.md (1332b), references/tools.md (3601b), references/vc.md (3829b), references/warehouse.md (24034b), scripts/lingxing.py (55214b), scripts/response_io.py (18387b), skill-card.md (3286b), SKILL.md (17919b)\n\nArchive v1.0.3: 27 files, 76151 bytes\n\nFiles: _meta.json (139b), references/api.md (2427b), references/basedata.md (6901b), references/basicdata-full.md (2891b), references/fba.md (6624b), references/fbalimit.md (1417b), references/fbasug.md (4352b), references/finance.md (22193b), references/logistics.md (1657b), references/multiplatform-ads.md (14140b), references/multiplatform-v2.md (15569b), references/newad-report.md (9507b), references/product.md (7749b), references/purchase.md (5103b), references/sale-full.md (18675b), references/sale-ops.md (4857b), references/service.md (11308b), references/sourcedata.md (11520b), references/statistics.md (25011b), references/targetmanage.md (1332b), references/tools.md (3601b), references/vc.md (3829b), references/warehouse.md (24034b), scripts/lingxing.py (55214b), scripts/response_io.py (18387b), skill-card.md (3121b), SKILL.md (16785b)\n\nArchive v1.0.2: 26 files, 74676 bytes\n\nFiles: _meta.json (139b), references/api.md (2427b), references/basedata.md (6901b), references/basicdata-full.md (2891b), references/fba.md (6624b), references/fbalimit.md (1417b), references/fbasug.md (4352b), references/finance.md (22193b), references/logistics.md (1657b), references/multiplatform-ads.md (14140b), references/multiplatform-v2.md (15569b), references/newad-report.md (9507b), references/product.md (7749b), references/purchase.md (5103b), references/sale-full.md (18675b), references/sale-ops.md (4857b), references/service.md (11308b), references/sourcedata.md (11520b), references/statistics.md (25011b), references/targetmanage.md (1332b), references/tools.md (3601b), references/vc.md (3829b), references/warehouse.md (24034b), scripts/lingxing.py (55214b), scripts/response_io.py (18387b), SKILL.md (16785b)\n\nArchive v1.0.1: 26 files, 74675 bytes\n\nFiles: _meta.json (139b), references/api.md (2427b), references/basedata.md (6901b), references/basicdata-full.md (2891b), references/fba.md (6624b), references/fbalimit.md (1417b), references/fbasug.md (4352b), references/finance.md (22193b), references/logistics.md (1657b), references/multiplatform-ads.md (14140b), references/multiplatform-v2.md (15569b), references/newad-report.md (9507b), references/product.md (7749b), references/purchase.md (5103b), references/sale-full.md (18675b), references/sale-ops.md (4857b), references/service.md (11308b), references/sourcedata.md (11520b), references/statistics.md (25011b), references/targetmanage.md (1332b), references/tools.md (3601b), references/vc.md (3829b), references/warehouse.md (24034b), scripts/lingxing.py (55214b), scripts/response_io.py (18387b), SKILL.md (16785b)\n\nArchive v1.0.0: 26 files, 68939 bytes\n\nFiles: _meta.json (139b), references/api.md (2427b), references/basedata.md (6901b), references/basicdata-full.md (2891b), references/fba.md (6624b), references/fbalimit.md (1417b), references/fbasug.md (4352b), references/finance.md (22193b), references/logistics.md (1657b), references/multiplatform-ads.md (14140b), references/multiplatform-v2.md (15569b), references/newad-report.md (9507b), references/product.md (7749b), references/purchase.md (5103b), references/sale-full.md (18675b), references/sale-ops.md (4857b), references/service.md (11308b), references/sourcedata.md (11520b), references/statistics.md (25011b), references/targetmanage.md (1332b), references/tools.md (3601b), references/vc.md (3829b), references/warehouse.md (24034b), scripts/lingxing.py (55214b), skill-card.md (2940b), SKILL.md (15420b)","readmeExcerpt":"Skill: 领星官方MCP安装 Owner: linkfox-ai Summary: 引导用户安装、连接和配置领星（Lingxing）官方 MCP，并排查连接、鉴权、权限与客户端兼容性问题。触发关键词：领星、领星 ERP、Lingxing、领星 MCP、Lingxing MCP、安装领星 MCP、配置领星 MCP、连接领星 MCP、重新配置领星 MCP、MCP Server URL、X-MCP-KEY、X-Mcp-Key、领星 MCP 鉴权失败、领星 MCP 连接失败。 Tags: latest:2.0.0 Version history: v2.0.0 | 2026-09-14T05:21:46.838Z | user Update from 1.0.6 to 2.0.0 v1.0.6 | 2026-08-14T14:57:02.390Z | user Update from 1.0.5 to 1.0.6 v1.0.5 | ","codeSnippets":[],"executableExamples":[{"language":"json","snippet":"{\n  \"mcpServers\": {\n    \"lingxing-mcp\": {\n      \"type\": \"streamableHttp\",\n      \"url\": \"<从领星复制的 MCP Server URL>\",\n      \"headers\": {\n        \"X-Mcp-Key\": \"<仅在本机安全填写，不要发送到普通聊天>\"\n      }\n    }\n  }\n}"},{"language":"bash","snippet":"export LINGXING_APP_ID=your_app_id\nexport LINGXING_APP_SECRET=your_app_secret\n\n# 可选：设置默认店铺 SID，无需每次在 --params 中传入\nexport LINGXING_SID=your_sid"},{"language":"bash","snippet":"# 列出所有已授权亚马逊店铺，获取 SID\npython3 scripts/lingxing.py --list-stores\n\n# 查看所有支持的接口\npython3 scripts/lingxing.py --api help\n\n# 基础调用\npython3 scripts/lingxing.py --api <接口名> --params '<JSON参数>'\n\n# 自动翻页获取全部数据\npython3 scripts/lingxing.py --api <接口名> --params '<JSON参数>' --all\n\n# 自定义翻页大小\npython3 scripts/lingxing.py --api <接口名> --params '<JSON参数>' --all --page-size 50"},{"language":"bash","snippet":"# 第一步：查询店铺列表获取 SID\npython3 scripts/lingxing.py --list-stores\nexport LINGXING_SID=813\n\n# 广告报表\npython3 scripts/lingxing.py \\\n  --api spCampaignReports \\\n  --params '{\"report_date\": \"2024-01-01\"}'\n\n# 亚马逊订单（自动翻页）\npython3 scripts/lingxing.py \\\n  --api mwsOrders \\\n  --params '{\"start_date\": \"2024-01-01\", \"end_date\": \"2024-01-31\"}' --all\n\n# 亚马逊 Listing\npython3 scripts/lingxing.py \\\n  --api mwsListing \\\n  --params '{\"sid\": \"813\", \"is_pair\": 1, \"is_delete\": 0}' --all\n\n# 产品列表\npython3 scripts/lingxing.py \\\n  --api ProductLists --params '{\"offset\": 0, \"length\": 20}'\n\n# 利润报表（ASIN维度）\npython3 scripts/lingxing.py \\\n  --api profitAsin \\\n  --params '{\"sids\": \"813\", \"start_date\": \"2024-01-01\", \"end_date\": \"2024-01-31\"}'\n\n# ASIN日销量\npython3 scripts/lingxing.py \\\n  --api AsinDailyLists \\\n  --params '{\"sid\": 813, \"start_date\": \"2024-01-01\", \"end_date\": \"2024-01-07\"}' --all\n\n# FBA发货单列表\npython3 scripts/lingxing.py \\\n  --api FBAShipmentList \\\n  --params '{\"sid\": 813}' --all\n\n# 亚马逊源表-全部订单\npython3 scripts/lingxing.py \\\n  --api AllOrders \\\n  --params '{\"sid\": 813, \"start_date\": \"2024-01-01\", \"end_date\": \"2024-01-31\"}' --all\n\n# 仓库列表\npython3 scripts/lingxing.py \\\n  --api WarehouseLists --params '{\"offset\": 0, \"length\": 50}'\n\n# Review列表（v2，支持更多筛选）\npython3 scripts/lingxing.py \\\n  --api reviewV2 --params '{\"sid\": 813, \"offset\": 0, \"length\": 20}'\n\n# 多平台订单（V2）\npython3 scripts/lingxing.py \\\n  --api MultiPlatOrderV2 \\\n  --params '{\"start_date\": 1704067200, \"end_date\": 1706745600}' --all\n\n# TikTok广告主列表\npython3 scripts/lingxing.py \\\n  --api queryAdvertiserList \\\n  --params '{\"length\": 100}'\n\n# 补货建议汇总\npython3 scripts/lingxing.py \\\n  --api GetSummaryList \\\n  --params '{\"sid_list\": [813]}' --all"},{"language":"text","snippet":"python scripts/response_io.py run --script scripts/lingxing.py --out-dir <DIR> '<params>'\npython scripts/response_io.py read <file> --fields \"<paths>\"   # or --path \"<JMESPath>\""},{"language":"bash","snippet":"export LINGXING_APP_ID=...\nexport LINGXING_APP_SECRET=...\n\npython3 scripts/lingxing.py --list-stores\npython3 scripts/lingxing.py --api help\npython3 scripts/lingxing.py --api <接口名> --params '<JSON>'"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: linkfox-lingxing-erp\ndescription: 引导用户安装、连接和配置领星（Lingxing）官方 MCP，并排查连接、鉴权、权限与客户端兼容性问题。触发关键词：领星、领星 ERP、Lingxing、领星 MCP、Lingxing MCP、安装领星 MCP、配置领星 MCP、连接领星 MCP、重新配置领星 MCP、MCP Server URL、X-MCP-KEY、X-Mcp-Key、领星 MCP 鉴权失败、领星 MCP 连接失败。\n---\n\n# 安装领星官方 MCP\n\n只引导安装领星官方 MCP，不封装、代调或讲解任何领星业务 Tool/API。\n\n## 官方依据\n\n- 只以领星官方指引为准：<https://www.lingxing.com/help/article/mcp>\n- 将服务器 URL、按钮名称、传输方式或配置字段与官方页面不一致时，以官方页面的当前内容为准。\n\n## 必须执行的流程\n\n1. 识别当前 Agent 所在客户端及其 MCP 安装方式。可先只读检查是否已有 `lingxing-mcp` 连接；不要发现、列出或调用领星业务工具。\n2. 告知前置条件：领星付费用户需由超级管理员在【业务配置】→【开放接口】→【MCP】启用功能，当前帐号还需拥有相应权限。\n3. 在索取任何配置值前，完整读取 `references/install.md`，按其中“必须向用户展示的图文引导”发送文字和领星官方截图。不得只发一句“去获取 X-Mcp-Key”。\n4. 让用户亲自在领星 ERP 中复制两项配置：\n   - 当前帐号对应的 **MCP Server URL**；\n   - **X-Mcp-Key** 鉴权密钥。\n5. 优先通过当前客户端的安全凭据输入、Secret Store 或私密配置界面接收密钥。若客户端没有安全输入通道，让用户按 `references/install.md` 在本地自行填写配置，并只回复“已配置”；不要要求用户在普通聊天中粘贴完整密钥。\n6. 使用当前客户端原生的 MCP 添加方式保存连接：名称使用 `lingxing-mcp`，传输方式使用 **Streamable HTTP / HTTP Streaming**，URL 使用用户从领星复制的完整值，请求头名严格使用 `X-Mcp-Key`。\n7. 保存前向用户说明将写入哪个客户端、使用哪个服务器域名，并只显示掩码后的密钥。若用户已明确要求安装或配置，可直接继续；否则先取得明确同意。\n8. 仅验证 MCP 连接、鉴权和工具发现是否成功。不得为了验证而调用任何会读取或写入领星业务数据的工具。\n9. 成功后只报告连接已安装及验证结果。后续数据任务交由已安装的领星官方 MCP 处理，不在本 skill 中提供调用方法。\n\n## 安全边界\n\n- 不代替用户登录领星，不索取帐号密码或验证码，不替用户创建、复制、重新生成或轮换密钥。\n- 将 MCP Server URL 与 `X-Mcp-Key` 都视为敏感配置；不要回显、记录到日志、提交到仓库或写进示例文件。\n- 不把真实密钥放进 shell 命令、命令历史、截图、测试输出或故障报告。\n- 若用户已在聊天中粘贴密钥，不要复述或使用该值；将其视为已暴露，让用户先在【管理MCP】中手动重新生成，再通过安全方式提供新密钥。\n- 若怀疑泄露，停止配置并让用户在【管理MCP】页面手动重新生成。\n\n## 故障排查范围\n\n只排查安装与鉴权：\n\n- 未看到 MCP 功能：确认付费资格及超级管理员是否已启用。\n- 鉴权失败：确认 URL 使用 `https://`、Header 名为 `X-Mcp-Key`、密钥复制完整且无多余空格。\n- 权限不符：说明服务器 URL 与当前领星帐号权限绑定，让用户换用正确帐号重新复制。\n- 客户端不支持自定义 Streamable HTTP MCP：明确说明该客户端无法按此方式安装，并引导用户查看客户端官方 MCP 支持文档。\n\n不要通过 curl、Python、OpenAPI 或 MCP Tool 调用来诊断，不要查询库存、订单、利润、广告、Listing 或其他业务数据。"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-lingxing-erp\",\n  \"version\": \"2.0.0\",\n  \"publishedAt\": 1789363306838\n}"},{"path":"references/install.md","content":"# 领星官方 MCP 安装引导\n\n本文件只用于安装和鉴权配置。不要扩展为业务工具清单、接口参考或数据操作教程。\n\n## 必须向用户展示的图文引导\n\n在请求用户提供 MCP Server URL 或 `X-Mcp-Key` 前，按顺序发送下面的文字和领星官方截图。即使图片无法显示，也要保留完整文字步骤。\n\n### 第 1 步：打开管理 MCP\n\n请用户登录领星 ERP，进入【AI助手】，点击输入框附近的【MCP】，再点击【管理MCP】。此操作必须由用户本人完成。\n\n![进入领星 AI 助手](../assets/mcp-install/01-open-ai-assistant.png)\n\n![在领星 AI 助手中点击管理 MCP](../assets/mcp-install/02-open-manage-mcp.png)\n\n### 第 2 步：进入第三方应用配置\n\n在【管理MCP】窗口找到【领星MCP】，点击“复制链接到第三方APP使用”一类入口。页面文案若已更新，以当前领星页面为准。\n\n![在管理 MCP 中进入第三方应用配置](../assets/mcp-install/03-third-party-app-config.png)\n\n### 第 3 步：分别复制 URL 和 X-Mcp-Key\n\n在第三方配置页分别点击【复制服务器 URL】与【复制鉴权密钥（X-Mcp-Key）】。两项缺一不可；密钥与当前领星帐号绑定，不要分享给其他人。\n\n以上三张截图均来自领星官方 MCP 指引，已保存在 skill 内，不依赖远程图片 URL。\n\n## 告诉用户如何安全提供给 Agent\n\n优先使用以下话术：\n\n> 请不要把完整 `X-Mcp-Key` 发在普通聊天、群聊或工单里。若当前客户端弹出安全凭据/Secret 输入框，请把从领星复制的服务器 URL 与密钥分别粘贴到对应字段；密钥字段名为 `X-Mcp-Key`。如果没有安全输入框，请在本机 MCP 配置中自行填入下面的占位位置，保存后只回复“已配置”，无需把密钥发给我。\n\n若当前客户端提供安全凭据输入，收集：\n\n- `MCP Server URL`：用户从【管理MCP】复制的完整 HTTPS URL；\n- `X-Mcp-Key`：用户从同一页面复制的完整鉴权密钥。\n\nAgent 接收后只显示掩码，例如 `****abcd`，不要复述完整值。\n\n## 通用配置形状\n\n不同客户端的字段名可能略有差异，优先使用客户端原生的 MCP 配置界面。需要向用户展示本地填写示例时，只使用占位符：\n\n```json\n{\n  \"mcpServers\": {\n    \"lingxing-mcp\": {\n      \"type\": \"streamableHttp\",\n      \"url\": \"<从领星复制的 MCP Server URL>\",\n      \"headers\": {\n        \"X-Mcp-Key\": \"<仅在本机安全填写，不要发送到普通聊天>\"\n      }\n    }\n  }\n}\n```\n\n若客户端使用 `transport` 字段，则选择或填写 `streamable_http`；不要同时猜测多个不受客户端支持的字段。\n\n## 连接验证\n\n只验证以下结果：\n\n1. MCP 服务器可连接；\n2. `X-Mcp-Key` 鉴权通过；\n3. 客户端能完成工具发现。\n\n不要调用任何工具读取库存、订单、Listing、销售、利润、广告或其他业务数据，也不要执行新增、修改、删除等写操作。\n\n## 官方信息摘要\n\n- 超级管理员需在【业务配置】→【开放接口】→【MCP】启用功能，仅限付费用户。\n- MCP Server URL 与当前领星帐号的数据权限绑定。\n- 传输方式为 Streamable HTTP（HTTP Streaming）。\n- 只配置 URL 而未配置 `X-Mcp-Key` 会导致鉴权失败。\n- 密钥泄露时，由用户在【管理MCP】页面手动重新生成。\n\n来源：<https://www.lingxing.com/help/article/mcp>"},{"path":"skill-card.md","content":"## Description:\n\n引导用户安装、连接和配置领星（Lingxing）官方 MCP，并排查连接、鉴权、权限与客户端兼容性问题。\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and developers use this skill to install and configure the official Lingxing MCP connection in an MCP-capable client. It focuses on collecting the MCP Server URL and X-Mcp-Key securely, validating connection and authentication, and troubleshooting setup issues without accessing Lingxing business data.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The MCP Server URL and X-Mcp-Key are sensitive and could be exposed if pasted into ordinary chat, logs, shell commands, screenshots, or example files.\n\nMitigation: Use a secure credential input, secret store, or local MCP configuration, mask any displayed key value, and regenerate the key if it was exposed.\n\nRisk: Connection validation could unintentionally access Lingxing business data if the agent uses business tools during setup.\n\nMitigation: Limit validation to server connectivity, authentication, and tool discovery; do not query inventory, orders, listings, sales, profit, advertising, or other business data.\n\nRisk: Bundled screenshot assets referenced by the install guide are not present in the artifact.\n\nMitigation: Use the official Lingxing MCP help page when current screenshots or UI labels are needed.\n\n## Reference(s):\n\n- [Lingxing MCP official guide](https://www.lingxing.com/help/article/mcp)\n- [领星官方 MCP 安装引导](artifact/references/install.md)\n- [ClawHub skill page](https://clawhub.ai/linkfox-ai/skills/linkfox-lingxing-erp)\n\n## Skill Output:\n\n**Output Type(s):** [Guidance, Markdown, Configuration instructions]\n\n**Output Format:** [Markdown with JSON configuration examples]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Does not produce or store Lingxing credentials; validation is limited to connection, authentication, and tool discovery.]\n\n## Skill Version(s):\n\n2.0.0 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"引导用户安装、连接和配置领星（Lingxing）官方 MCP，并排查连接、鉴权、权限与客户端兼容性问题。触发关键词：领星、领星 ERP、Lingxing、领星 MCP、Lingxing MCP、安装领星 MCP、配置领星 MCP、连接领星 MCP、重新配置领星 MCP、MCP Server URL、X-MCP-KEY、X-Mcp-Key、领星 MCP 鉴权失败、领星 MCP 连接失败。 Skill: 领星官方MCP安装 Owner: linkfox-ai Summary: 引导用户安装、连接和配置领星（Lingxing）官方 MCP，并排查连接、鉴权、权限与客户端兼容性问题。触发关键词：领星、领星 ERP、Lingxing、领星 MCP、Lingxing MCP、安装领星 MCP、配置领星 MCP、连接领星 MCP、重新配置领星 MCP、MCP Server URL、X-MCP-KEY、X-Mcp-Key、领星 MCP 鉴权失败、领星 MCP 连接失败。 Tags: latest:2.0.0 Version history: v2.0.0 | 2026-09-14T05:21:46.838Z | user Update from 1.0.6 to 2.0.0 v1.0.6 | 2026-08-14T14:57:02.390Z | user Update from 1.0.5 to 1.0.6 v1.0.5 |","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":856,"uniquenessScore":49,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-10T09:49:58.619Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-10T09:49:58.619Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-10T11:52:19.607Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}