Shopify 自动开票与库存管理

运行一套简洁、以审核为先的 Shopify 运营工作流，聚焦于订单识别、发票准备、库存更新以及清晰的月度报告。

确保所有输出内容专业、面向商家友好，并在执行任何外部操作前便于人工验证。

工作流

请按以下顺序处理完整请求：

1. 收集店铺上下文
2. 识别新订单或相关订单
3. 准备可用于开票的账单数据
4. 更新库存表格
5. 汇总异常情况
6. 导出月度运营报告

1. 收集店铺上下文

在生成任何输出前，先获取运营简报。

最低输入要求：

• 店铺名称
• 币种
• 税务制度或增值税说明（VAT note）
• 如已提供，需包含发票编号规则
• 订单日期范围或事件触发条件
• 商品 SKU 数据来源
• 当前库存数据来源
• 目标报告月份

若信息缺失，请明确注明假设内容，并保持保守判断。

2. 识别新订单

可使用 Shopify 订单导出文件、Webhook 载荷、用户提供的 CSV 文件，或经人工审核的订单列表。

尽可能采集以下字段：

• order_id
• order_name
• created_at
• financial_status
• fulfillment_status
• customer_name
• customer_email
• billing country
• shipping country
• currency
• line items
• SKU
• quantity
• subtotal
• tax
• shipping
• total price

将订单归类至以下简单类别：

• ready_for_invoice
• paid_but_review_needed
• pending_payment
• cancelled_or_ignore

规则：

• 仅对已付款或已明确批准的订单开具发票
• 切勿自行编造税务数据
• 在生成发票前，标记客户账单信息缺失的订单

3. 准备可用于开票的账单数据

生成结构化的发票明细行，而非假装自动签发正式会计凭证。

针对每个“可开票”订单，准备如下内容：

• invoice_number 或占位符
• invoice_date
• merchant legal name 占位符
• 客户账单姓名（customer billing name）
• 客户账单地址（customer billing address）
• 如有，客户税号（tax identifier）
• 明细描述（line description）
• 数量（quantity）
• 单价（unit price）
• 税额（tax amount）
• 总金额（total amount）
• 付款状态（payment status）
• 原始订单引用（source order reference）

参考 references/templates.md 获取发票字段结构及面向商家的语言规范。

若用户要求生成 PDF，请输出专业格式的发票内容区块，或输出适用于 PDF 渲染的数据集；除非系统中已集成真实 PDF 渲染器。

4. 更新库存表格

在处理完有效订单后，生成库存变动视图。

推荐列名：

• sku
• product_title
• variant_title
• opening_stock
• quantity_sold
• quantity_refunded
• net_change
• closing_stock
• low_stock_flag
• reorder_note

规则：

• 从库存中扣减已售数量
• 仅在明确确认退款后，才将退款数量加回库存
• 若计算结果导致库存为负数，则标记为 needs_review
• 低库存预警阈值由用户指定；若未指定，默认为 5

使用 scripts/stock_sync.py 脚本，基于库存与订单导出文件，生成扁平化的库存核对文件。

5. 汇总异常情况

每次均须生成简明的异常汇总节。

应包含：

• 缺少账单信息的订单
• 因未付款而被排除在开票范围外的订单
• 缺少 SKU 数据的订单
• 库存为负或处于低库存状态的商品
• 税务或币种不匹配的情况

该节内容须简洁、可操作。

6. 导出月度报告

当用户请求月度汇总时，应包含以下指标：

• 已处理订单总数
• 已付款订单数
• 待付款订单数
• 已取消订单数
• 可开票订单数
• 已开票收入总额
• 税额合计
• 销售单位总数
• 按销量排序的 Top SKU
• 低库存 SKU 数量

使用 scripts/monthly_ops_report.py 脚本，聚合订单与库存数据，生成紧凑型 CSV 汇总报告。

输出顺序

对于完整请求，请按以下顺序输出：

1. 运营假设说明
2. 订单状态汇总
3. 可开票订单表格
4. 库存核对表格
5. 异常清单
6. 月度报告摘要

易用性标准

面向非技术背景的 Shopify 商家撰写内容。

优先采用：

• 通俗易懂的标签
• 紧凑型表格或可直接导入 CSV 的行格式
• 一目了然的状态命名
• 清晰的摘要，并附带后续操作建议

避免：

• 过度使用会计术语（除非用户明确要求）
• 将仅完成草稿的发票表述为“已正式发送”
• 在缺乏源数据支撑的情况下，做出存在风险的自动化承诺

合规性标准

以审核为先、兼顾会计规范的方式运行。

本能力旨在支持以下场景：

• 订单审核
• 发票准备
• 库存核对
• 月度报告

不得声称具备超出所提供数据范围的法律或税务合规性。当税务处理方式存疑时，应建议咨询专业会计师。

社区版说明

本免费版本聚焦于“可开票数据准备”、“库存核对”和“简易月度报告”，有意不包含自动付款提醒、高级 PDF 工作流以及更丰富的财务自动化功能。

资源

在适用时，请调用以下内置资源：

• references/templates.md：发票与报告模板
• scripts/invoice_export.py：将 Shopify 风格的订单 JSON 转换为可用于开票的 CSV 行数据
• scripts/stock_sync.py：基于订单与库存 CSV 文件进行库存核对
• scripts/monthly_ops_report.py：生成简易月度运营汇总报告