Iteration Layer

Generate Sales Report Spreadsheet

Generate a formatted XLSX spreadsheet with sales data, currency formatting, and bold headers.

No credit card required — start with free trial credits

Who this is for

Business intelligence teams and reporting platforms use this recipe to generate Excel reports from structured data. Define columns, rows, and cell formats — currency, percentage, bold headers — and receive a ready-to-distribute XLSX file.

Request
curl -X POST https://api.iterationlayer.com/sheet-generation/v1/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "format": "xlsx",
    "styles": {
      "header": {
        "font_family": "Helvetica",
        "font_size_in_pt": 11,
        "is_bold": true,
        "background_color": "#1E3A5F",
        "font_color": "#FFFFFF"
      },
      "body": {
        "font_family": "Helvetica",
        "font_size_in_pt": 11,
        "font_color": "#333333"
      }
    },
    "sheets": [
      {
        "name": "Q1 Sales",
        "columns": [
          {
            "name": "Region",
            "width": 22
          },
          {
            "name": "Revenue",
            "width": 18
          },
          {
            "name": "Growth",
            "width": 14
          }
        ],
        "rows": [
          [
            {
              "value": "North America"
            },
            {
              "value": 4520000,
              "format": "currency"
            },
            {
              "value": 0.071,
              "format": "percentage"
            }
          ],
          [
            {
              "value": "EMEA"
            },
            {
              "value": 3310000,
              "format": "currency"
            },
            {
              "value": 0.178,
              "format": "percentage"
            }
          ],
          [
            {
              "value": "APAC"
            },
            {
              "value": 1400000,
              "format": "currency"
            },
            {
              "value": 0.273,
              "format": "percentage"
            }
          ]
        ]
      }
    ]
  }'
Response
{
  "success": true,
  "data": {
    "buffer": "UEsDBBQAAAA...",
    "mime_type": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
  }
}
Request
import { IterationLayer } from "iterationlayer";
const client = new IterationLayer({ apiKey: "YOUR_API_KEY" });

const result = await client.generateSheet({
  format: "xlsx",
  styles: {
    header: {
      font_family: "Helvetica",
      font_size_in_pt: 11,
      is_bold: true,
      background_color: "#1E3A5F",
      font_color: "#FFFFFF",
    },
    body: {
      font_family: "Helvetica",
      font_size_in_pt: 11,
      font_color: "#333333",
    },
  },
  sheets: [
    {
      name: "Q1 Sales",
      columns: [
        {
          name: "Region",
          width: 22,
        },
        {
          name: "Revenue",
          width: 18,
        },
        {
          name: "Growth",
          width: 14,
        },
      ],
      rows: [
        [
          {
            value: "North America",
          },
          {
            value: 4520000,
            format: "currency",
          },
          {
            value: 0.071,
            format: "percentage",
          },
        ],
        [
          {
            value: "EMEA",
          },
          {
            value: 3310000,
            format: "currency",
          },
          {
            value: 0.178,
            format: "percentage",
          },
        ],
        [
          {
            value: "APAC",
          },
          {
            value: 1400000,
            format: "currency",
          },
          {
            value: 0.273,
            format: "percentage",
          },
        ],
      ],
    },
  ],
});
Response
{
  "success": true,
  "data": {
    "buffer": "UEsDBBQAAAA...",
    "mime_type": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
  }
}
Request
from iterationlayer import IterationLayer
client = IterationLayer(api_key="YOUR_API_KEY")

result = client.generate_sheet(
    format="xlsx",
    styles={
        "header": {
            "font_family": "Helvetica",
            "font_size_in_pt": 11,
            "is_bold": True,
            "background_color": "#1E3A5F",
            "font_color": "#FFFFFF",
        },
        "body": {
            "font_family": "Helvetica",
            "font_size_in_pt": 11,
            "font_color": "#333333",
        },
    },
    sheets=[
        {
            "name": "Q1 Sales",
            "columns": [
                {
                    "name": "Region",
                    "width": 22,
                },
                {
                    "name": "Revenue",
                    "width": 18,
                },
                {
                    "name": "Growth",
                    "width": 14,
                },
            ],
            "rows": [
                [
                    {
                        "value": "North America",
                    },
                    {
                        "value": 4520000,
                        "format": "currency",
                    },
                    {
                        "value": 0.071,
                        "format": "percentage",
                    },
                ],
                [
                    {
                        "value": "EMEA",
                    },
                    {
                        "value": 3310000,
                        "format": "currency",
                    },
                    {
                        "value": 0.178,
                        "format": "percentage",
                    },
                ],
                [
                    {
                        "value": "APAC",
                    },
                    {
                        "value": 1400000,
                        "format": "currency",
                    },
                    {
                        "value": 0.273,
                        "format": "percentage",
                    },
                ],
            ],
        }
    ],
)
Response
{
  "success": true,
  "data": {
    "buffer": "UEsDBBQAAAA...",
    "mime_type": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
  }
}
Request
package main

import il "github.com/iterationlayer/sdk-go"

func main() {
    client := il.NewClient("YOUR_API_KEY")

    result, err := client.GenerateSheet(il.GenerateSheetRequest{
        Format: "xlsx",
        Styles: &il.SheetStyles{
            Header: &il.CellStyle{
                FontFamily:      "Helvetica",
                FontSizeInPt:    11,
                IsBold:          true,
                BackgroundColor: "#1E3A5F",
                FontColor:       "#FFFFFF",
            },
            Body: &il.CellStyle{
                FontFamily:   "Helvetica",
                FontSizeInPt: 11,
                FontColor:    "#333333",
            },
        },
        Sheets: []il.Sheet{
            {
                Name: "Q1 Sales",
                Columns: []il.SheetColumn{
                    {
                        Name:  "Region",
                        Width: 22,
                    },
                    {
                        Name:  "Revenue",
                        Width: 18,
                    },
                    {
                        Name:  "Growth",
                        Width: 14,
                    },
                },
                Rows: []il.SheetRow{
                    {
                        {
                            Value:  "North America",
                        },
                        {
                            Value:  4520000,
                            Format: "currency",
                        },
                        {
                            Value:  0.071,
                            Format: "percentage",
                        },
                    },
                    {
                        {
                            Value:  "EMEA",
                        },
                        {
                            Value:  3310000,
                            Format: "currency",
                        },
                        {
                            Value:  0.178,
                            Format: "percentage",
                        },
                    },
                    {
                        {
                            Value:  "APAC",
                        },
                        {
                            Value:  1400000,
                            Format: "currency",
                        },
                        {
                            Value:  0.273,
                            Format: "percentage",
                        },
                    },
                },
            },
        },
    })
    if err != nil {
        panic(err)
    }
    _ = result
}
Response
{
  "success": true,
  "data": {
    "buffer": "UEsDBBQAAAA...",
    "mime_type": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
  }
}
Template
{
  "name": "Generate Sales Report Spreadsheet",
  "nodes": [
    {
      "parameters": {
        "content": "## Generate Sales Report Spreadsheet\n\nBusiness intelligence teams and reporting platforms use this recipe to generate Excel reports from structured data. Define columns, rows, and cell formats \u2014 currency, percentage, bold headers \u2014 and receive a ready-to-distribute XLSX file.\n\n**Note:** This workflow uses the Iteration Layer community node (`n8n-nodes-iterationlayer`). Install it via Settings > Community Nodes before importing. Self-hosted n8n only.",
        "height": 280,
        "width": 500,
        "color": 2
      },
      "type": "n8n-nodes-base.stickyNote",
      "typeVersion": 1,
      "position": [
        200,
        40
      ],
      "id": "ad633e8a-69f0-4690-9d6e-bfdda52d6f75",
      "name": "Overview"
    },
    {
      "parameters": {
        "content": "### Step 1: Generate Spreadsheet\nResource: **Sheet Generation**\n\nConfigure the Sheet Generation parameters below, then connect your credentials.",
        "height": 160,
        "width": 300,
        "color": 6
      },
      "type": "n8n-nodes-base.stickyNote",
      "typeVersion": 1,
      "position": [
        475,
        100
      ],
      "id": "6a962e0c-c0e8-4754-9043-b3dd95d2b285",
      "name": "Step 1 Note"
    },
    {
      "parameters": {},
      "type": "n8n-nodes-base.manualTrigger",
      "typeVersion": 1,
      "position": [
        250,
        300
      ],
      "id": "d4bf0905-26f1-400c-a3f5-2915bf0e0953",
      "name": "Manual Trigger"
    },
    {
      "parameters": {
        "resource": "sheetGeneration",
        "sheetFormat": "xlsx",
        "sheetsJson": "[\n  {\n    \"name\": \"Q1 Sales\",\n    \"columns\": [\n      {\n        \"name\": \"Region\",\n        \"width\": 22\n      },\n      {\n        \"name\": \"Revenue\",\n        \"width\": 18\n      },\n      {\n        \"name\": \"Growth\",\n        \"width\": 14\n      }\n    ],\n    \"rows\": [\n      [\n        {\n          \"value\": \"North America\"\n        },\n        {\n          \"value\": 4520000,\n          \"format\": \"currency\"\n        },\n        {\n          \"value\": 0.071,\n          \"format\": \"percentage\"\n        }\n      ],\n      [\n        {\n          \"value\": \"EMEA\"\n        },\n        {\n          \"value\": 3310000,\n          \"format\": \"currency\"\n        },\n        {\n          \"value\": 0.178,\n          \"format\": \"percentage\"\n        }\n      ],\n      [\n        {\n          \"value\": \"APAC\"\n        },\n        {\n          \"value\": 1400000,\n          \"format\": \"currency\"\n        },\n        {\n          \"value\": 0.273,\n          \"format\": \"percentage\"\n        }\n      ]\n    ]\n  }\n]",
        "sheetStylesJson": "{\n  \"header\": {\n    \"font_family\": \"Helvetica\",\n    \"font_size_in_pt\": 11,\n    \"is_bold\": true,\n    \"background_color\": \"#1E3A5F\",\n    \"font_color\": \"#FFFFFF\"\n  },\n  \"body\": {\n    \"font_family\": \"Helvetica\",\n    \"font_size_in_pt\": 11,\n    \"font_color\": \"#333333\"\n  }\n}"
      },
      "type": "n8n-nodes-iterationlayer.iterationLayer",
      "typeVersion": 1,
      "position": [
        500,
        300
      ],
      "id": "bf6516ea-c9fc-4669-b932-41725d97f4fa",
      "name": "Generate Spreadsheet",
      "credentials": {
        "iterationLayerApi": {
          "id": "1",
          "name": "Iteration Layer API"
        }
      }
    }
  ],
  "connections": {
    "Manual Trigger": {
      "main": [
        [
          {
            "node": "Generate Spreadsheet",
            "type": "main",
            "index": 0
          }
        ]
      ]
    }
  },
  "settings": {
    "executionOrder": "v1"
  }
}
Prompt
Generate a formatted XLSX sales report. Use the generate_sheet tool with format "xlsx" and these columns:

- Date (date)
- Product (text)
- Region (text)
- Units Sold (number)
- Revenue (currency)
- Margin % (percentage)

Include styled bold headers, one row per sale, and currency/percentage formatting on the appropriate columns.

Related Recipes

Build your first workflow in minutes

Chain our APIs together and ship a complete pipeline before lunch. Free trial credits included — no credit card required.