Sheet Generation API: Structured JSON In, Formatted Spreadsheet Out
Iteration La
·
2026-04-30
·
via DEV Community
<h2> Spreadsheet Generation Is Still Painful </h2> <p>Every application eventually needs to export data as a spreadsheet. Financial reports, inventory lists, invoices, analytics dashboards — at some point, someone asks for an Excel file and you start searching for libraries.</p> <p>If you work in JavaScript, you find ExcelJS or SheetJS. Python has openpyxl. Ruby has caxlsx. Java has Apache POI. Each one has a different API surface, different quirks, and different failure modes. The common thread: they're all verbose. Generating a simple XLSX with headers, currency formatting, and a SUM formula takes dozens of lines of boilerplate — cell references, style objects, merge ranges, format strings.</p> <p>CSV is simpler but limited. No formatting, no formulas, no multiple sheets. You get a flat text file and hope the recipient's spreadsheet app guesses the delimiter correctly.</p> <p>And if you need both formats? You maintain two separate code paths. One for XLSX with its style objects and cell references. One for CSV with its string concatenation. Both doing the same conceptual thing — turning rows of data into a spreadsheet — in completely different ways.</p> <h2> One API Call, Three Formats </h2> <p>The <strong><a href="https://iterationlayer.com/products/sheet-generation" rel="noopener noreferrer">Iteration Layer's Sheet Generation API</a></strong> takes a single JSON payload describing your spreadsheet and returns a formatted file. The same payload produces XLSX, CSV, or Markdown — you just change the <code>format</code> field.</p> <p>Here's the simplest possible request:<br> </p> <div class="highlight js-code-highlight"> <pre class="highlight typescript"><code><span class="k">import</span> <span class="p">{</span> <span class="nx">IterationLayer</span> <span class="p">}</span> <span class="k">from</span> <span class="dl">"</span><span class="s2">iterationlayer</span><span class="dl">"</span><span class="p">;</span> <span class="kd">const</span> <span class="nx">client</span> <span class="o">=</span> <span class="k">new</span> <span class="nc">IterationLayer</span><span class="p">({</span> <span class="na">apiKey</span><span class="p">:</span> <span class="dl">"</span><span class="s2">YOUR_API_KEY</span><span class="dl">"</span><span class="p">,</span> <span class="p">});</span> <span class="kd">const</span> <span class="nx">result</span> <span class="o">=</span> <span class="k">await</span> <span class="nx">client</span><span class="p">.</span><span class="nf">generateSheet</span><span class="p">({</span> <span class="na">format</span><span class="p">:</span> <span class="dl">"</span><span class="s2">xlsx</span><span class="dl">"</span><span class="p">,</span> <span class="na">sheets</span><span class="p">:</span> <span class="p">[</span> <span class="p">{</span> <span class="na">name</span><span class="p">:</span> <span class="dl">"</span><span class="s2">Q1 Revenue</span><span class="dl">"</span><span class="p">,</span> <span class="na">columns</span><span class="p">:</span> <span class="p">[</span> <span class="p">{</span> <span class="na">name</span><span class="p">:</span> <span class="dl">"</span><span class="s2">Company</span><span class="dl">"</span><span class="p">,</span> <span class="p">},</span> <span class="p">{</span> <span class="na">name</span><span class="p">:</span> <span class="dl">"</span><span class="s2">Region</span><span class="dl">"</span><span class="p">,</span> <span class="p">},</span> <span class="p">{</span> <span class="na">name</span><span class="p">:</span> <span class="dl">"</span><span class="s2">Revenue</span><span class="dl">"</span><span class="p">,</span> <span class="p">},</span> <span class="p">],</span> <span class="na">rows</span><span class="p">:</span> <span class="p">[</span> <span class="p">[</span> <span class="p">{</span> <span class="na">value</span><span class="p">:</span> <span class="dl">"</span><span class="s2">Acme Corp</span><span class="dl">"</span><span class="p">,</span> <span class="p">},</span> <span class="p">{</span> <span class="na">value</span><span class="p">:</span> <span class="dl">"</span><span class="s2">North America</span><span class="dl">"</span><span class="p">,</span> <span class="p">},</span> <span class="p">{</span> <span class="na">value</span><span class="p">:</span> <span class="mf">48500.00</span><span class="p">,</span> <span class="na">format</span><span class="p">:</span> <span class="dl">"</span><span class="s2">currency</span><span class="dl">"</span><span class="p">,</span> <span class="na">currency_code</span><span class="p">:</span> <span class="dl">"</span><span class="s2">USD</span><span class="dl">"</span><span class="p">,</span> <span class="p">},</span> <span class="p">],</span> <span class="p">[</span> <span class="p">{</span> <span class="na">value</span><span class="p">:</span> <span class="dl">"</span><span class="s2">Globex Ltd</span><span class="dl">"</span><span class="p">,</span> <span class="p">},</span> <span class="p">{</span> <span class="na">value</span><span class="p">:</span> <span class="dl">"</span><span class="s2">Europe</span><span class="dl">"</span><span class="p">,</span> <span class="p">},</span> <span class="p">{</span> <span class="na">value</span><span class="p">:</span> <span class="mf">37200.00</span><span class="p">,</span> <span class="na">format</span><span class="p">:</span> <span class="dl">"</span><span class="s2">currency</span><span class="dl">"</span><span class="p">,</span> <span class="na">currency_code</span><span class="p">:</span> <span class="dl">"</span><span class="s2">EUR</span><span class="dl">"</span><span class="p">,</span> <span class="p">},</span> <span class="p">],</span> <span class="p">],</span> <span class="p">},</span> <span class="p">],</span> <span class="p">});</span> </code></pre> </div> <div class="highlight js-code-highlight"> <pre class="highlight json"><code><span class="p">{</span><span class="w"> </span><span class="nl">"success"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span><span class="w"> </span><span class="nl">"data"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nl">"buffer"</span><span class="p">:</span><span class="w"> </span><span class="s2">"UEsDBBQAAAAIAA..."</span><span class="p">,</span><span class="w"> </span><span class="nl">"mime_type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"</span><span class="w"> </span><span class="p">}</span><span class="w"> </span><span class="p">}</span><span class="w"> </span></code></pre> </div> <p>The response contains the file as a base64-encoded buffer with the appropriate MIME type. Decode it, save it, send it to a client — the file is ready to open in Excel, Google Sheets, or Numbers.</p> <h2> The Data Model </h2> <p>The API uses a positional model. You define columns, then provide rows as ordered arrays of cells. Each cell has a value and optional formatting.</p> <p><strong>Columns</strong> define the header row. Each column has a <code>name</code> and an optional <code>width</code>:<br> </p> <div class="highlight js-code-highlight"> <pre class="highlight json"><code><span class="p">{</span><span class="w"> </span><span class="nl">"columns"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nl">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Product"</span><span class="p">,</span><span class="w"> </span><span class="nl">"width"</span><span class="p">:</span><span class="w"> </span><span class="mi">30</span><span class="w"> </span><span class="p">},</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nl">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Units Sold"</span><span class="w"> </span><span class="p">},</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nl">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Unit Price"</span><span class="w"> </span><span class="p">},</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nl">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Total"</span><span class="w"> </span><span class="p">}</span><span class="w"> </span><span class="p">]</span><span class="w"> </span><span class="p">}</span><span class="w"> </span></code></pre> </div> <p><strong>Cells</strong> carry the data. At minimum, a cell has a <code>value</code>. Add <code>format</code> to control how it's displayed:<br> </p> <div class="highlight js-code-highlight"> <pre class="highlight json"><code><span class="p">{</span><span class="w"> </span><span class="nl">"value"</span><span class="p">:</span><span class="w"> </span><span class="mf">1500.50</span><span class="p">,</span><span class="w"> </span><span class="nl">"format"</span><span class="p">:</span><span class="w"> </span><span class="s2">"currency"</span><span class="p">,</span><span class="w"> </span><span class="nl">"currency_code"</span><span class="p">:</span><span class="w"> </span><span class="s2">"USD"</span><span class="w"> </span><span class="p">}</span><span class="w"> </span></code></pre> </div> <p>Supported cell formats: <code>text</code>, <code>number</code>, <code>decimal</code>, <code>currency</code>, <code>percentage</code>, <code>date</code>, <code>datetime</code>, <code>time</code>, and <code>custom</code>.</p> <p><strong>Number styles</strong> control how digits are grouped. Four styles cover the major international conventions:</p> <ul> <li> <code>comma_period</code> — 1,234.56 (US, UK, most of Asia)</li> <li> <code>period_comma</code> — 1.234,56 (Germany, Brazil, most of Europe)</li> <li> <code>space_comma</code> — 1 234,56 (France, Norway, Sweden)</li> <li> <code>space_period</code> — 1 234.56 (Estonia, South Africa)</li> </ul> <p><strong>Date styles</strong> control how date, datetime, and time values are formatted. Pass any Excel date format code — <code>dd/mm/yyyy</code> for European dates, <code>mm/dd/yyyy</code> for US, <code>d mmmm yyyy</code> for full month names, <code>hh:mm</code> for short times. The format code is applied natively in XLSX and rendered to the equivalent string in CSV and Markdown.</p> <p><strong>Currency codes</strong> follow ISO 4217. The API supports 162 codes — from USD and EUR to THB and CLP — and maps each one to its correct symbol.</p> <h2> Styles: Base and Per-Cell </h2> <p>Instead of styling every cell individually, you define base styles for headers and body rows, then override specific cells as needed.<br> </p> <div class="highlight js-code-highlight"> <pre class="highlight typescript"><code><span class="k">import</span> <span class="p">{</span> <span class="nx">IterationLayer</span> <span class="p">}</span> <span class="k">from</span> <span class="dl">"</span><span class="s2">iterationlayer</span><span class="dl">"</span><span class="p">;</span> <span class="kd">const</span> <span class="nx">client</span> <span class="o">=</span> <span class="k">new</span> <span class="nc">IterationLayer</span><span class="p">({</span> <span class="na">apiKey</span><span class="p">:</span> <span class="dl">"</span><span class="s2">YOUR_API_KEY</span><span class="dl">"</span><span class="p">,</span> <span class="p">});</span> <span class="kd">const</span> <span class="nx">result</span> <span class="o">=</span> <span class="k">await</span> <span class="nx">client</span><span class="p">.</span><span class="nf">generateSheet</span><span class="p">({</span> <span class="na">format</span><span class="p">:</span> <span class="dl">"</span><span class="s2">xlsx</span><span class="dl">"</span><span class="p">,</span> <span class="na">styles</span><span class="p">:</span> <span class="p">{</span> <span class="na">header</span><span class="p">:</span> <span class="p">{</span> <span class="na">is_bold</span><span class="p">:</span> <span class="kc">true</span><span class="p">,</span> <span class="na">font_size_in_pt</span><span class="p">:</span> <span class="mi">12</span><span class="p">,</span> <span class="na">background_color</span><span class="p">:</span> <span class="dl">"</span><span class="s2">#1a1a2e</span><span class="dl">"</span><span class="p">,</span> <span class="na">font_color</span><span class="p">:</span> <span class="dl">"</span><span class="s2">#ffffff</span><span class="dl">"</span><span class="p">,</span> <span class="na">horizontal_alignment</span><span class="p">:</span> <span class="dl">"</span><span class="s2">center</span><span class="dl">"</span><span class="p">,</span> <span class="p">},</span> <span class="na">body</span><span class="p">:</span> <span class="p">{</span> <span class="na">font_size_in_pt</span><span class="p">:</span> <span class="mi">10</span><span class="p">,</span> <span class="p">},</span> <span class="p">},</span> <span class="na">sheets</span><span class="p">:</span> <span class="p">[</span> <span class="p">{</span> <span class="na">name</span><span class="p">:</span> <span class="dl">"</span><span class="s2">Styled Report</span><span class="dl">"</span><span class="p">,</span> <span class="na">columns</span><span class="p">:</span> <span class="p">[</span> <span class="p">{</span> <span class="na">name</span><span class="p">:</span> <span class="dl">"</span><span class="s2">Item</span><span class="dl">"</span><span class="p">,</span> <span class="p">},</span> <span class="p">{</span> <span class="na">name</span><span class="p">:</span> <span class="dl">"</span><span class="s2">Amount</span><span class="dl">"</span><span class="p">,</span> <span class="p">},</span> <span class="p">],</span> <span class="na">rows</span><span class="p">:</span> <span class="p">[</span> <span class="p">[</span> <span class="p">{</span> <span class="na">value</span><span class="p">:</span> <span class="dl">"</span><span class="s2">Server costs</span><span class="dl">"</span><span class="p">,</span> <span class="p">},</span> <span class="p">{</span> <span class="na">value</span><span class="p">:</span> <span class="mf">4200.00</span><span class="p">,</span> <span class="na">format</span><span class="p">:</span> <span class="dl">"</span><span class="s2">currency</span><span class="dl">"</span><span class="p">,</span> <span class="na">currency_code</span><span class="p">:</span> <span class="dl">"</span><span class="s2">USD</span><span class="dl">"</span><span class="p">,</span> <span class="na">styles</span><span class="p">:</span> <span class="p">{</span> <span class="na">font_color</span><span class="p">:</span> <span class="dl">"</span><span class="s2">#cc0000</span><span class="dl">"</span><span class="p">,</span> <span class="p">},</span> <span class="p">},</span> <span class="p">],</span> <span class="p">],</span> <span class="p">},</span> <span class="p">],</span> <span class="p">});</span> </code></pre> </div> <div class="highlight js-code-highlight"> <pre class="highlight json"><code><span class="p">{</span><span class="w"> </span><span class="nl">"success"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span><span class="w"> </span><span class="nl">"data"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nl">"buffer"</span><span class="p">:</span><span class="w"> </span><span class="s2">"UEsDBBQAAAAIAA..."</span><span class="p">,</span><span class="w"> </span><span class="nl">"mime_type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"</span><span class="w"> </span><span class="p">}</span><span class="w"> </span><span class="p">}</span><span class="w"> </span></code></pre> </div> <p>The <code>styles.header</code> and <code>styles.body</code> objects set defaults. The <code>styles</code> field on individual cells overrides them. Available style properties include <code>font_family</code>, <code>font_size_in_pt</code>, <code>is_bold</code>, <code>is_italic</code>, <code>font_color</code>, <code>background_color</code>, <code>horizontal_alignment</code>, and <code>number_format</code>.</p> <p>For XLSX output, you can also embed custom fonts by including a <code>fonts</code> array with base64-encoded font buffers.</p> <h2> Formulas </h2> <p>Cells whose value starts with <code>=</code> are treated as formulas. In XLSX output, they're written as native Excel formulas — Excel evaluates them when the file opens. In CSV and Markdown output, the API evaluates them server-side and writes the computed result.</p> <p>The server-side evaluator supports <code>SUM</code>, <code>AVERAGE</code>, <code>COUNT</code>, <code>MIN</code>, and <code>MAX</code> on cell ranges.<br> </p> <div class="highlight js-code-highlight"> <pre class="highlight json"><code><span class="p">{</span><span class="w"> </span><span class="nl">"sheets"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nl">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Invoice"</span><span class="p">,</span><span class="w"> </span><span class="nl">"columns"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nl">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Description"</span><span class="w"> </span><span class="p">},</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nl">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Amount"</span><span class="w"> </span><span class="p">}</span><span class="w"> </span><span class="p">],</span><span class="w"> </span><span class="nl">"rows"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nl">"value"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Design work"</span><span class="w"> </span><span class="p">},</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nl">"value"</span><span class="p">:</span><span class="w"> </span><span class="mi">3200</span><span class="p">,</span><span class="w"> </span><span class="nl">"format"</span><span class="p">:</span><span class="w"> </span><span class="s2">"currency"</span><span class="p">,</span><span class="w"> </span><span class="nl">"currency_code"</span><span class="p">:</span><span class="w"> </span><span class="s2">"USD"</span><span class="w"> </span><span class="p">}</span><span class="w"> </span><span class="p">],</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nl">"value"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Development"</span><span class="w"> </span><span class="p">},</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nl">"value"</span><span class="p">:</span><span class="w"> </span><span class="mi">8500</span><span class="p">,</span><span class="w"> </span><span class="nl">"format"</span><span class="p">:</span><span class="w"> </span><span class="s2">"currency"</span><span class="p">,</span><span class="w"> </span><span class="nl">"currency_code"</span><span class="p">:</span><span class="w"> </span><span class="s2">"USD"</span><span class="w"> </span><span class="p">}</span><span class="w"> </span><span class="p">],</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nl">"value"</span><span class="p">:</span><span class="w"> </span><span class="s2">"QA testing"</span><span class="w"> </span><span class="p">},</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nl">"value"</span><span class="p">:</span><span class="w"> </span><span class="mi">1500</span><span class="p">,</span><span class="w"> </span><span class="nl">"format"</span><span class="p">:</span><span class="w"> </span><span class="s2">"currency"</span><span class="p">,</span><span class="w"> </span><span class="nl">"currency_code"</span><span class="p">:</span><span class="w"> </span><span class="s2">"USD"</span><span class="w"> </span><span class="p">}</span><span class="w"> </span><span class="p">],</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nl">"value"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Total"</span><span class="w"> </span><span class="p">},</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nl">"value"</span><span class="p">:</span><span class="w"> </span><span class="s2">"=SUM(B2:B4)"</span><span class="p">,</span><span class="w"> </span><span class="nl">"format"</span><span class="p">:</span><span class="w"> </span><span class="s2">"currency"</span><span class="p">,</span><span class="w"> </span><span class="nl">"currency_code"</span><span class="p">:</span><span class="w"> </span><span class="s2">"USD"</span><span class="w"> </span><span class="p">}</span><span class="w"> </span><span class="p">]</span><span class="w"> </span><span class="p">]</span><span class="w"> </span><span class="p">}</span><span class="w"> </span><span class="p">]</span><span class="w"> </span><span class="p">}</span><span class="w"> </span></code></pre> </div> <p>In XLSX, the Total cell contains <code>=SUM(B2:B4)</code> and Excel computes it. In CSV, the API evaluates the formula and writes <code>13200</code>. Same input, correct output in every format.</p> <h2> Cell Merging </h2> <p>Cells can span multiple columns and rows using <code>from_col</code>, <code>to_col</code>, <code>from_row</code>, and <code>to_row</code>. This works in XLSX output for building headers that span columns or summary rows that stretch across a table.<br> </p> <div class="highlight js-code-highlight"> <pre class="highlight json"><code><span class="p">{</span><span class="w"> </span><span class="nl">"value"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Q1 2026 Financial Summary"</span><span class="p">,</span><span class="w"> </span><span class="nl">"from_col"</span><span class="p">:</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="nl">"to_col"</span><span class="p">:</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span><span class="w"> </span><span class="nl">"styles"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nl">"is_bold"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span><span class="w"> </span><span class="nl">"horizontal_alignment"</span><span class="p">:</span><span class="w"> </span><span class="s2">"center"</span><span class="p">,</span><span class="w"> </span><span class="nl">"font_size_in_pt"</span><span class="p">:</span><span class="w"> </span><span class="mi">14</span><span class="w"> </span><span class="p">}</span><span class="w"> </span><span class="p">}</span><span class="w"> </span></code></pre> </div> <h2> The Pipeline: Extract Then Generate </h2> <p>The Sheet Generation API is designed to compose with the <strong>Document Extraction API</strong>. A common workflow: you receive invoices as PDFs, extract the line items, and generate a consolidated spreadsheet.<br> </p> <div class="highlight js-code-highlight"> <pre class="highlight typescript"><code><span class="k">import</span> <span class="p">{</span> <span class="nx">IterationLayer</span> <span class="p">}</span> <span class="k">from</span> <span class="dl">"</span><span class="s2">iterationlayer</span><span class="dl">"</span><span class="p">;</span> <span class="kd">const</span> <span class="nx">client</span> <span class="o">=</span> <span class="k">new</span> <span class="nc">IterationLayer</span><span class="p">({</span> <span class="na">apiKey</span><span class="p">:</span> <span class="dl">"</span><span class="s2">YOUR_API_KEY</span><span class="dl">"</span><span class="p">,</span> <span class="p">});</span> <span class="c1">// Step 1: Extract invoice data</span> <span class="kd">const</span> <span class="nx">extraction</span> <span class="o">=</span> <span class="k">await</span> <span class="nx">client</span><span class="p">.</span><span class="nf">extractDocument</span><span class="p">({</span> <span class="na">file</span><span class="p">:</span> <span class="nx">invoicePdfBase64</span><span class="p">,</span> <span class="na">schema</span><span class="p">:</span> <span class="p">{</span> <span class="na">vendor</span><span class="p">:</span> <span class="p">{</span> <span class="na">type</span><span class="p">:</span> <span class="dl">"</span><span class="s2">text</span><span class="dl">"</span><span class="p">,</span> <span class="p">},</span> <span class="na">invoice_number</span><span class="p">:</span> <span class="p">{</span> <span class="na">type</span><span class="p">:</span> <span class="dl">"</span><span class="s2">text</span><span class="dl">"</span><span class="p">,</span> <span class="p">},</span> <span class="na">line_items</span><span class="p">:</span> <span class="p">{</span> <span class="na">type</span><span class="p">:</span> <span class="dl">"</span><span class="s2">array</span><span class="dl">"</span><span class="p">,</span> <span class="na">items</span><span class="p">:</span> <span class="p">{</span> <span class="na">description</span><span class="p">:</span> <span class="p">{</span> <span class="na">type</span><span class="p">:</span> <span class="dl">"</span><span class="s2">text</span><span class="dl">"</span><span class="p">,</span> <span class="p">},</span> <span class="na">quantity</span><span class="p">:</span> <span class="p">{</span> <span class="na">type</span><span class="p">:</span> <span class="dl">"</span><span class="s2">number</span><span class="dl">"</span><span class="p">,</span> <span class="p">},</span> <span class="na">unit_price</span><span class="p">:</span> <span class="p">{</span> <span class="na">type</span><span class="p">:</span> <span class="dl">"</span><span class="s2">currency</span><span class="dl">"</span><span class="p">,</span> <span class="p">},</span> <span class="na">total</span><span class="p">:</span> <span class="p">{</span> <span class="na">type</span><span class="p">:</span> <span class="dl">"</span><span class="s2">currency</span><span class="dl">"</span><span class="p">,</span> <span class="p">},</span> <span class="p">},</span> <span class="p">},</span> <span class="p">},</span> <span class="p">});</span> <span class="kd">const</span> <span class="nx">fields</span> <span class="o">=</span> <span class="nx">extraction</span><span class="p">.</span><span class="nx">data</span><span class="p">.</span><span class="nx">fields</span><span class="p">;</span> <span class="c1">// Step 2: Generate the spreadsheet</span> <span class="kd">const</span> <span class="nx">rows</span> <span class="o">=</span> <span class="nx">fields</span><span class="p">.</span><span class="nx">line_items</span><span class="p">.</span><span class="nx">value</span><span class="p">.</span><span class="nf">map</span><span class="p">((</span><span class="nx">item</span><span class="p">)</span> <span class="o">=></span> <span class="p">[</span> <span class="p">{</span> <span class="na">value</span><span class="p">:</span> <span class="nx">item</span><span class="p">.</span><span class="nx">description</span><span class="p">.</span><span class="nx">value</span><span class="p">,</span> <span class="p">},</span> <span class="p">{</span> <span class="na">value</span><span class="p">:</span> <span class="nx">item</span><span class="p">.</span><span class="nx">quantity</span><span class="p">.</span><span class="nx">value</span><span class="p">,</span> <span class="na">format</span><span class="p">:</span> <span class="dl">"</span><span class="s2">number</span><span class="dl">"</span><span class="p">,</span> <span class="p">},</span> <span class="p">{</span> <span class="na">value</span><span class="p">:</span> <span class="nx">item</span><span class="p">.</span><span class="nx">unit_price</span><span class="p">.</span><span class="nx">value</span><span class="p">,</span> <span class="na">format</span><span class="p">:</span> <span class="dl">"</span><span class="s2">currency</span><span class="dl">"</span><span class="p">,</span> <span class="na">currency_code</span><span class="p">:</span> <span class="dl">"</span><span class="s2">USD</span><span class="dl">"</span><span class="p">,</span> <span class="p">},</span> <span class="p">{</span> <span class="na">value</span><span class="p">:</span> <span class="nx">item</span><span class="p">.</span><span class="nx">total</span><span class="p">.</span><span class="nx">value</span><span class="p">,</span> <span class="na">format</span><span class="p">:</span> <span class="dl">"</span><span class="s2">currency</span><span class="dl">"</span><span class="p">,</span> <span class="na">currency_code</span><span class="p">:</span> <span class="dl">"</span><span class="s2">USD</span><span class="dl">"</span><span class="p">,</span> <span class="p">},</span> <span class="p">]);</span> <span class="kd">const</span> <span class="nx">sheet</span> <span class="o">=</span> <span class="k">await</span> <span class="nx">client</span><span class="p">.</span><span class="nf">generateSheet</span><span class="p">({</span> <span class="na">format</span><span class="p">:</span> <span class="dl">"</span><span class="s2">xlsx</span><span class="dl">"</span><span class="p">,</span> <span class="na">styles</span><span class="p">:</span> <span class="p">{</span> <span class="na">header</span><span class="p">:</span> <span class="p">{</span> <span class="na">is_bold</span><span class="p">:</span> <span class="kc">true</span><span class="p">,</span> <span class="na">background_color</span><span class="p">:</span> <span class="dl">"</span><span class="s2">#f0f0f0</span><span class="dl">"</span><span class="p">,</span> <span class="p">},</span> <span class="p">},</span> <span class="na">sheets</span><span class="p">:</span> <span class="p">[</span> <span class="p">{</span> <span class="na">name</span><span class="p">:</span> <span class="s2">`Invoice </span><span class="p">${</span><span class="nx">fields</span><span class="p">.</span><span class="nx">invoice_number</span><span class="p">.</span><span class="nx">value</span><span class="p">}</span><span class="s2">`</span><span class="p">,</span> <span class="na">columns</span><span class="p">:</span> <span class="p">[</span> <span class="p">{</span> <span class="na">name</span><span class="p">:</span> <span class="dl">"</span><span class="s2">Description</span><span class="dl">"</span><span class="p">,</span> <span class="p">},</span> <span class="p">{</span> <span class="na">name</span><span class="p">:</span> <span class="dl">"</span><span class="s2">Quantity</span><span class="dl">"</span><span class="p">,</span> <span class="p">},</span> <span class="p">{</span> <span class="na">name</span><span class="p">:</span> <span class="dl">"</span><span class="s2">Unit Price</span><span class="dl">"</span><span class="p">,</span> <span class="p">},</span> <span class="p">{</span> <span class="na">name</span><span class="p">:</span> <span class="dl">"</span><span class="s2">Total</span><span class="dl">"</span><span class="p">,</span> <span class="p">},</span> <span class="p">],</span> <span class="nx">rows</span><span class="p">,</span> <span class="p">},</span> <span class="p">],</span> <span class="p">});</span> </code></pre> </div> <div class="highlight js-code-highlight"> <pre class="highlight json"><code><span class="p">{</span><span class="w"> </span><span class="nl">"success"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span><span class="w"> </span><span class="nl">"data"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nl">"buffer"</span><span class="p">:</span><span class="w"> </span><span class="s2">"UEsDBBQAAAAIAA..."</span><span class="p">,</span><span class="w"> </span><span class="nl">"mime_type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"</span><span class="w"> </span><span class="p">}</span><span class="w"> </span><span class="p">}</span><span class="w"> </span></code></pre> </div> <p>PDF in, formatted XLSX out. Two API calls, no local dependencies.</p> <h2> Get Started </h2> <p>The Sheet Generation API is available now. Check the <a href="https://iterationlayer.com/products/sheet-generation" rel="noopener noreferrer">docs</a> for the full API reference, including all cell formats, style properties, and formula support.</p> <p>If you're already using the Document Extraction API, the two compose naturally — extraction output maps directly to sheet rows. If you're starting fresh, the <a href="https://iterationlayer.com/products/sheet-generation" rel="noopener noreferrer">Sheet Generation quickstart</a> is the fastest path to your first generated spreadsheet.</p> <p><a href="https://platform.iterationlayer.com/signup" rel="noopener noreferrer">Sign up</a> for a free account — no credit card required — and generate your first spreadsheet in minutes.</p>
此内容由惯性聚合(RSS阅读器)自动聚合整理,仅供阅读参考。 原文来自 — 版权归原作者所有。