Gmail を使用して Square の月次売上レポートを自動送信

• •Googleアカウント + Gmail API認証情報
• •ターゲットAPIの認証情報が必要な場合あり

{
  "meta": {
    "instanceId": "d6e2f2f655b1125bbcac14a4cac6d2e46c7a150e927f85fc96fdca1a6dc39e0e",
    "templateCredsSetupCompleted": true
  },
  "nodes": [
    {
      "id": "49c8db5b-81ca-42de-b51b-20b55b564d08",
      "name": "Square 店舗情報の取得",
      "type": "n8n-nodes-base.httpRequest",
      "position": [
        1312,
        544
      ],
      "parameters": {
        "url": "https://connect.squareup.com/v2/locations",
        "options": {},
        "sendHeaders": true,
        "authentication": "genericCredentialType",
        "genericAuthType": "httpHeaderAuth",
        "headerParameters": {
          "parameters": [
            {
              "name": "Content-Type",
              "value": "application/json"
            }
          ]
        }
      },
      "credentials": {
        "httpHeaderAuth": {
          "id": "n1GRrdbh899dbLYB",
          "name": "Square Header Auth"
        }
      },
      "typeVersion": 4.2
    },
    {
      "id": "ddd37765-27c7-4e42-8c55-3aaac40181c3",
      "name": "店舗リストへの変換",
      "type": "n8n-nodes-base.splitOut",
      "position": [
        1536,
        544
      ],
      "parameters": {
        "include": "selectedOtherFields",
        "options": {},
        "fieldToSplitOut": "locations",
        "fieldsToInclude": "id"
      },
      "typeVersion": 1
    },
    {
      "id": "e030b283-e555-44f1-862f-b001cfb1e128",
      "name": "売上なし店舗の除外",
      "type": "n8n-nodes-base.if",
      "position": [
        2032,
        544
      ],
      "parameters": {
        "options": {},
        "conditions": {
          "options": {
            "version": 2,
            "leftValue": "",
            "caseSensitive": true,
            "typeValidation": "strict"
          },
          "combinator": "and",
          "conditions": [
            {
              "id": "498f5fab-6930-4e89-9fbe-0d67671da8d2",
              "operator": {
                "type": "array",
                "operation": "notEmpty",
                "singleValue": true
              },
              "leftValue": "={{ $json.orders }}",
              "rightValue": ""
            }
          ]
        }
      },
      "typeVersion": 2.2
    },
    {
      "id": "de5bca22-f883-41dd-a82e-960c6e3a9328",
      "name": "Square からの売上データ取得",
      "type": "n8n-nodes-base.httpRequest",
      "position": [
        1792,
        544
      ],
      "parameters": {
        "url": "https://connect.squareup.com/v2/orders/search",
        "method": "POST",
        "options": {
          "batching": {
            "batch": {}
          }
        },
        "jsonBody": "={\n  \"location_ids\": [\"{{ $json.locations.id }}\"],\n  \"query\": {\n    \"filter\": {\n      \"state_filter\": {\n        \"states\": [\"COMPLETED\"]\n      },\n      \"date_time_filter\": {\n        \"created_at\": {\n          \"start_at\": \"{{ $('Get Dates From Last Month').item.json.date }}T00:00:00-05:00\",\n          \"end_at\": \"{{ $('Get Dates From Last Month').item.json.date }}T23:59:59-05:00\"\n        }\n      }\n    }\n  },\n  \"limit\": 1000,\n  \"return_entries\": false\n}",
        "sendBody": true,
        "sendHeaders": true,
        "specifyBody": "json",
        "authentication": "genericCredentialType",
        "genericAuthType": "httpHeaderAuth",
        "headerParameters": {
          "parameters": [
            {
              "name": "Content-Type",
              "value": "application/json"
            }
          ]
        }
      },
      "credentials": {
        "httpHeaderAuth": {
          "id": "n1GRrdbh899dbLYB",
          "name": "Square Header Auth"
        }
      },
      "executeOnce": false,
      "typeVersion": 4.2
    },
    {
      "id": "fd52f1c3-b58e-4452-82a9-20451d613768",
      "name": "売上レポートの編集",
      "type": "n8n-nodes-base.code",
      "position": [
        2320,
        544
      ],
      "parameters": {
        "mode": "runOnceForEachItem",
        "jsCode": "// Date and Location Metadata\nconst date = $('Get Dates From Last Month').item.json.date;\nconst location_id = $json.orders[0].location_id || null;\nconst location_name = $('Get Square Locations').item.json.locations.find(locations => locations.id === location_id)?.name;\n\n// Our Result Variables\nlet total_money = 0;\nlet total_tax = 0;\nlet total_discount = 0;\nlet total_tip = 0;\nlet total_returns = 0;\nlet cash_rounding = 0;\n\nlet cash_tender = 0;\nlet card_tender = 0;\nlet gift_card_tender = 0;\nlet other_tender = 0;\nlet fees = 0;\n\n// Loop Through Each Order\nfor (const sale of $json.orders) {\n\n    // Add the sales, taxes, discounts and tips\n    total_money += sale.total_money?.amount || 0;\n    total_tax += sale.total_tax_money?.amount || 0;\n    total_discount += -(sale.total_discount_money?.amount || 0);\n    total_tip += sale.total_tip_money?.amount || 0;\n    if (sale.rounding_adjustment) {\n      cash_rounding += sale.rounding_adjustment.amount_money?.amount || 0;\n    }\n\n  \n    if (sale.return_amounts) {\n      // If there are returns, subtract from sales totals and add to return amount total\n      total_money -= sale.return_amounts?.total_money?.amount || 0;\n      total_tax -= sale.return_amounts?.tax_money?.amount || 0;\n      total_discount -= sale.return_amounts?.discount_money?.amount || 0;\n      total_tip -= sale.return_amounts?.tip_money?.amount || 0;\n  \n      total_returns += -(sale.return_amounts?.total_money?.amount || 0);\n      total_returns -= -(sale.return_amounts?.tax_money?.amount || 0);\n      total_returns -= -(sale.return_amounts?.tip_money?.amount || 0);\n      total_returns -= -(sale.return_amounts?.discount_money?.amount || 0);\n  \n      // If an array of refunds is provided\n      for (const refund of sale.refunds || []) {\n        const transaction_id = refund.transaction_id;\n      \n        // Look for the original sale this refund refers to\n        const original_sale = $json.orders.find(original =>\n          original.id && transaction_id && original.id.includes(transaction_id)\n        );\n      \n        if (original_sale) {\n          if (original_sale.rounding_adjustment) {\n            const amount = original_sale.rounding_adjustment.amount_money?.amount || 0;\n            cash_rounding -= amount;\n            total_returns += amount;\n          }\n      \n          if (original_sale.tenders) {\n            for (const tender of original_sale.tenders) {\n              if (tender.id === refund.tender_id) {\n                const amount = refund.amount_money?.amount || 0;\n                if (tender.type === 'CARD') card_tender -= amount;\n                else if (tender.type === 'CASH') cash_tender -= amount;\n                else if (tender.type === 'SQUARE_GIFT_CARD') gift_card_tender -= amount;\n                else other_tender -= amount;\n      \n                if (refund.processing_fee_money && tender.id === refund.tender_id) {\n                  fees -= refund.processing_fee_money.amount || 0;\n                }\n              }\n            }\n          }\n        }\n      }\n    }\n  \n    if (sale.tenders) {\n      for (const tender of sale.tenders) {\n        const amount = tender.amount_money?.amount || 0;\n        if (tender.type === 'CARD') card_tender += amount;\n        else if (tender.type === 'CASH') cash_tender += amount;\n        else if (tender.type === 'SQUARE_GIFT_CARD') gift_card_tender += amount;\n        else other_tender += amount;\n  \n        if (tender.processing_fee_money) {\n          fees -= tender.processing_fee_money.amount || 0;\n        }\n      }\n    }\n  \n}\n\n// Final computed values\nconst net_sales = total_money - total_tip - total_tax - cash_rounding;\nconst gross_sales = net_sales - total_discount - total_returns;\nconst net_total = cash_tender + card_tender + gift_card_tender + other_tender + fees;\n\nreturn {\n  json: {\n    date,\n    location_id,\n    location_name,\n    gross_sales: gross_sales / 100.0,\n    total_returns: total_returns / 100.0,\n    total_discount: total_discount / 100.0,\n    net_sales: net_sales / 100.0,\n    total_tax: total_tax / 100.0,\n    total_tip: total_tip / 100.0,\n    cash_rounding: cash_rounding / 100.0,\n    total_payments_collected: total_money / 100.0,\n    cash: cash_tender / 100.0,\n    card: card_tender / 100.0,\n    gift_card: gift_card_tender / 100.0,\n    other: other_tender / 100.0,\n    fees: fees / 100.0,\n    net_total: net_total / 100.0,\n  }\n};"
      },
      "typeVersion": 2
    },
    {
      "id": "cae9b53a-144d-482a-be43-245acb088f35",
      "name": "付箋1",
      "type": "n8n-nodes-base.stickyNote",
      "position": [
        704,
        352
      ],
      "parameters": {
        "color": 5,
        "height": 420,
        "content": "## Trigger  \n- This workflow runs on the first day of every Month.  \n- Each month, it pulls the previous month's sales data from Square.\n"
      },
      "typeVersion": 1
    },
    {
      "id": "93058d76-e0fa-4479-a6cd-d3df49dcb185",
      "name": "付箋2",
      "type": "n8n-nodes-base.stickyNote",
      "position": [
        1232,
        352
      ],
      "parameters": {
        "color": 5,
        "width": 460,
        "height": 420,
        "content": "## Get Square Locations and Process Each One Separately  \n- This HTTP node connects to the Square Locations API to fetch all your locations.\n"
      },
      "typeVersion": 1
    },
    {
      "id": "7636415e-1d8b-4643-9935-072fff0f8fdb",
      "name": "付箋3",
      "type": "n8n-nodes-base.stickyNote",
      "position": [
        1712,
        352
      ],
      "parameters": {
        "color": 5,
        "height": 420,
        "content": "## Get Sales from Square  \n- This HTTP node retrieves all orders for the given location on the specified date."
      },
      "typeVersion": 1
    },
    {
      "id": "7a4389ca-bde6-4eb4-a28f-600352bdcde8",
      "name": "付箋4",
      "type": "n8n-nodes-base.stickyNote",
      "position": [
        2256,
        352
      ],
      "parameters": {
        "color": 5,
        "height": 420,
        "content": "## Compile a Report for Each Location  \n- This code node calculates totals for each location.  \n- Please ensure the numbers match EXACTLY with the Square Sales Summary Dashboard.\n"
      },
      "typeVersion": 1
    },
    {
      "id": "645aae4e-6bd7-40da-94bd-d43e108f445a",
      "name": "スケジュールトリガー",
      "type": "n8n-nodes-base.scheduleTrigger",
      "position": [
        784,
        544
      ],
      "parameters": {
        "rule": {
          "interval": [
            {
              "field": "months",
              "triggerAtHour": 8
            }
          ]
        }
      },
      "typeVersion": 1.2
    },
    {
      "id": "c9f0d20a-ab6f-4027-97b2-bda40e2e0a85",
      "name": "付箋5",
      "type": "n8n-nodes-base.stickyNote",
      "position": [
        2512,
        352
      ],
      "parameters": {
        "color": 5,
        "height": 420,
        "content": "## Convert the Square Sales Summary into a CSV File \n"
      },
      "typeVersion": 1
    },
    {
      "id": "ed7fe015-7025-41db-be57-2712514115dc",
      "name": "売上サマリーの CSV ファイル変換",
      "type": "n8n-nodes-base.convertToFile",
      "position": [
        2576,
        544
      ],
      "parameters": {
        "options": {
          "fileName": "=sales_report_{{ $('Schedule Trigger').item.json.timestamp }}.csv"
        },
        "binaryPropertyName": "sales_report"
      },
      "typeVersion": 1.1
    },
    {
      "id": "b06c9ef4-4711-4e3a-9f00-e15fb1a67f53",
      "name": "付箋6",
      "type": "n8n-nodes-base.stickyNote",
      "position": [
        2768,
        352
      ],
      "parameters": {
        "color": 5,
        "height": 420,
        "content": "## Send the Report to the Finance Team / Manager"
      },
      "typeVersion": 1
    },
    {
      "id": "1cd8c221-c9ee-47a3-b878-74b6a47738c0",
      "name": "レポート送信",
      "type": "n8n-nodes-base.gmail",
      "position": [
        2848,
        544
      ],
      "webhookId": "b38e72a3-bcf6-4e82-840e-d0171ea71138",
      "parameters": {
        "sendTo": "rosh.edwin15@gmail.com",
        "message": "=<p>Hello User,</p><p>Please see the attached report containing last month's sales!</p><p>Best,<br> An Efficient Person</p>",
        "options": {
          "attachmentsUi": {
            "attachmentsBinary": [
              {
                "property": "sales_report"
              }
            ]
          }
        },
        "subject": "=Your Last Month's Square Sales Report"
      },
      "credentials": {
        "gmailOAuth2": {
          "id": "x5LsvRUYpInxYmcG",
          "name": "Rosh's Personal Email"
        }
      },
      "typeVersion": 2.1
    },
    {
      "id": "2b30411b-4154-4a06-addb-3c6a4e681b16",
      "name": "付箋7",
      "type": "n8n-nodes-base.stickyNote",
      "position": [
        -64,
        -32
      ],
      "parameters": {
        "width": 736,
        "height": 1440,
        "content": "## Automatically Send Monthly Sales Reports from Square via Gmail\n\n## What It Does  \nThis workflow automatically connects to the Square API and generates a **monthly** sales summary report for all your Square locations. The report matches the figures displayed in **Square Dashboard > Reports > Sales Summary**.\n\nIt's designed to run monthly and pull the **previous month’s** sales into a CSV file, which is then sent to a manager/finance team for analysis.\n\nThis workflow builds on my previous template, which allows users to automatically pull data from the Square API into n8n for processing. (See here: https://n8n.io/workflows/6358)\n\n## Prerequisites  \nTo use this workflow, you'll need:\n- A Square API credential (configured as a Header Auth credential)\n- A Gmail credential\n\n## How to Set Up Square Credentials:  \n- Go to **Credentials > Create New**  \n- Choose **Header Auth**  \n- Set the **Name** to `Authorization`  \n- Set the **Value** to your Square Access Token (e.g., `Bearer <your-api-key>`)\n\n## How It Works  \n1. **Trigger:** The workflow runs on the **1st of every month at 8:00 AM**  \n2. **Fetch Locations:** An HTTP request retrieves all Square locations linked to your account  \n3. **Fetch Orders:** For each location, an HTTP request pulls completed orders for the **previous calendar month**  \n4. **Filter Empty Locations:** Locations with no sales are ignored  \n5. **Aggregate Sales Data:** A Code node processes the order data and produces a summary identical to Square’s built-in Sales Summary report  \n6. **Create CSV File:** A CSV file is created containing the relevant data  \n7. **Send Email:** An email is sent using Gmail to the chosen third party  \n\n## Example Use Cases  \n- Automatically send monthly Square sales data to management for forecasting and planning  \n- Automatically send data to an external third party, such as a landlord or agent, who is paid via commission  \n- Automatically send data to a bookkeeper for entry into QuickBooks  \n\n## How to Use  \n- Configure both HTTP Request nodes to use your Square API credential  \n- Set the workflow to **Active** so it runs automatically  \n- Enter the email address of the person you want to send the report to and update the message body  \n- If you want to remove the n8n attribution, you can do so in the last node  \n\n## Customization Options  \n- Add pagination to handle locations with more than 1,000 orders per month\n- Adjust the date filters in the HTTP node to cover the full calendar month (e.g., use Luxon or JavaScript to calculate `start_date` and `end_date`)\n\n## Why It's Useful  \nThis workflow saves time, reduces manual report pulling from Square, and enables smarter automation around sales data — whether for operations, finance, or performance monitoring."
      },
      "typeVersion": 1
    },
    {
      "id": "9effe5b0-f320-4313-989d-a5745f9a44d5",
      "name": "前月の日付範囲取得",
      "type": "n8n-nodes-base.code",
      "position": [
        1040,
        544
      ],
      "parameters": {
        "jsCode": "const inputDate = new Date($input.first().json.timestamp);\nconst year = inputDate.getFullYear();\nconst month = inputDate.getMonth();\n\n// Get first day of previous month\nconst firstDay = new Date(year, month - 1, 1);\n\n// Get last day of previous month by setting date to 0 of current month\nconst lastDay = new Date(year, month, 0).getDate();\n\nconst output = [];\n\nfor (let day = 1; day <= lastDay; day++) {\n  const date = new Date(year, month - 1, day);\n  const formatted = date.toISOString().split('T')[0];\n  output.push({ json: { date: formatted } });\n}\n\nreturn output;\n"
      },
      "typeVersion": 2
    }
  ],
  "pinData": {},
  "connections": {
    "1cd8c221-c9ee-47a3-b878-74b6a47738c0": {
      "main": [
        []
      ]
    },
    "645aae4e-6bd7-40da-94bd-d43e108f445a": {
      "main": [
        [
          {
            "node": "9effe5b0-f320-4313-989d-a5745f9a44d5",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "49c8db5b-81ca-42de-b51b-20b55b564d08": {
      "main": [
        [
          {
            "node": "ddd37765-27c7-4e42-8c55-3aaac40181c3",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "fd52f1c3-b58e-4452-82a9-20451d613768": {
      "main": [
        [
          {
            "node": "ed7fe015-7025-41db-be57-2712514115dc",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "de5bca22-f883-41dd-a82e-960c6e3a9328": {
      "main": [
        [
          {
            "node": "e030b283-e555-44f1-862f-b001cfb1e128",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "ddd37765-27c7-4e42-8c55-3aaac40181c3": {
      "main": [
        [
          {
            "node": "de5bca22-f883-41dd-a82e-960c6e3a9328",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "9effe5b0-f320-4313-989d-a5745f9a44d5": {
      "main": [
        [
          {
            "node": "49c8db5b-81ca-42de-b51b-20b55b564d08",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "e030b283-e555-44f1-862f-b001cfb1e128": {
      "main": [
        [
          {
            "node": "fd52f1c3-b58e-4452-82a9-20451d613768",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "ed7fe015-7025-41db-be57-2712514115dc": {
      "main": [
        [
          {
            "node": "1cd8c221-c9ee-47a3-b878-74b6a47738c0",
            "type": "main",
            "index": 0
          }
        ]
      ]
    }
  }
}