square-import

Square 导入

概述

从 Square POS CSV 导出文件导入交易数据。支持销售、消费税前小费、退款和 Square 处理费。将 Square 的商品级明细映射为 Open Accountant 的交易格式。

使用的 Wilson 工具

• transaction_search — 检查是否已有 Square 交易，防止重复
• categorize — 为导入的 Square 交易分配类别
• export_transactions — 导出已对账的 Square 数据

列映射

Square CSV 列	Open Accountant 字段	备注
Date	date	交易日期
Time	—	不存储
Transaction ID	reference_id	用于去重的 Square 支付 ID
Description 或 Item	description	商品或付款说明
Gross Sales	amount	扣费前总额（正数 = 收入）
Tips	amount（单独一行）	小费金额（正数 = 收入）
Processing Fees	amount（单独一行）	Square 费用（负数 = 支出）
Refunds	amount（单独一行）	退款金额（负数）
Net Sales	—	计算得出，不直接存储
Payment Method	notes	现金、银行卡等

工作流

1. 向用户索取 Square CSV 文件路径。
2. 解析 CSV 并验证 Square 列标题。
3. 为每行交易最多创建四条记录：
   • 销售：销售总额（正数），类别为 "Revenue:Sales"
   • 小费：小费金额（正数），类别为 "Revenue:Tips"（如果 > $0）
   • 费用：处理费（负数），类别为 "Fees:Payment Processing"（如果 > $0）
   • 退款：退款金额（负数），类别为 "Revenue:Refunds"（如果 > $0）
4. 现金交易的处理费为 $0，但仍需导入销售记录。
5. 使用 Square Transaction ID 去重。
6. 预览导入摘要：销售总额、小费总额、费用总额、退款总额和净额。
7. 插入交易并确认。

不使用 Wilson

如需手动处理 Square 导出文件：

从 Square 下载

1. 登录 squareup.com（Square Dashboard）
2. 前往 Transactions（左侧边栏）
3. 点击 Export（右上角，或下载图标）
4. 选择日期范围
5. 选择 Transactions CSV（而非 Items CSV，后者是库存数据）
6. 下载
7. 另一个选项：前往 Reporting > Sales > Export，获取汇总级数据

在电子表格中手动处理

1. 在 Google Sheets 或 Excel 中打开 CSV。
2. 分离收入来源：
   • E 列：Gross Sales（产品/服务收入）
   • F 列：Tips（收入，在某些司法辖区，其税务处理与销售收入不同）
   • G 列：Processing Fees（支出）
   • H 列：Refunds（负收入）
3. 创建单独的类别行（或使用多个类别列）：
   • 对于小费 > $0 的每一行，新增一行记录小费金额
   • 对于费用 > $0 的每一行，新增一行记录负数费用
4. 汇总公式：

   Gross Sales:       =SUM(E:E)
   Total Tips:        =SUM(F:F)
   Total Fees:        =SUM(G:G)
   Total Refunds:     =SUM(H:H)
   Net Revenue:       =GrossSales + Tips - Fees - Refunds
   Effective Fee %:   =TotalFees / (GrossSales + Tips) * 100
   Avg Transaction:   =GrossSales / COUNTA(D:D)
   

5. 与银行对账：Square 每天或每周存入资金。汇总存款日期之间的净销售额，并与银行对账单核对。

Square 报表（无需导出）

Square Dashboard 在 Reporting > Sales Summary 中提供内置报表，可按日、周或月查看销售总额、费用和净额。无需导出即可快速查看。

重要说明

• Square CSV 导出文件可以是交易级或商品级。此技能需要交易级导出文件。商品级导出文件每笔销售中的每件商品各占一行，因此需要先按 Transaction ID 分组。
• 单独列出小费，是因为小费的税务处理可能与销售收入不同。
• 如果通过 POS 录入，Square 中也会显示现金交易，但其处理费为 $0。这些交易仍需导入。
• Square 存入银行的金额已扣除费用。不要将银行中的存款记录作为 Square 收入导入，而应使用此技能导入扣费前的明细。
• 如果同时使用 Square 进行线下和线上销售，两者都会出现在同一导出文件中。