Developer Reference

<!-- Loop over invoice lines -->
<table>
  <thead>
    <tr><th>Description</th><th>Qty</th><th>Unit Price</th><th>Total</th></tr>
  </thead>
  <tbody>
    {{#invoice.lines}}
    <tr>
      <td>{{description}}</td>
      <td>{{quantity}}</td>
      <td>{{unit_price}} €</td>
      <td>{{total}} €</td>
    </tr>
    {{/invoice.lines}}
  </tbody>
</table>

<!-- Nested loops (two levels) -->
{{#sections}}
  <h2>{{section_title}}</h2>
  {{#clauses}}
    <p>{{clause_number}}. {{text}}</p>
  {{/clauses}}
{{/sections}}

Table structure in the .docx file:

┌─────────────────┬──────────┬────────────┐
│ {{#items}}      │          │            │  ← marker row (first column)
├─────────────────┼──────────┼────────────┤
│ {{description}} │ {{qty}}  │ {{price}}  │  ← template row (cloned per item)
├─────────────────┼──────────┼────────────┤
│ {{/items}}      │          │            │  ← end marker row
└─────────────────┴──────────┴────────────┘

Rules:
  • Start marker {{#array.path}} must be in the FIRST column of a row
  • End marker   {{/array.path}} must be in the FIRST column of a row
  • All rows between markers are cloned for each item
  • Inside the loop, use {{field}}, {{nested.field}}, or {{.}} for the item itself
  • Marker rows are removed from the final document

Sheet layout:

Row 5  │ {{#invoice.lines}}   │            │            │
Row 6  │ {{description}}      │ {{qty}}    │ {{price}}  │  ← template row
Row 7  │ {{/invoice.lines}}   │            │            │

Result for 3 items: rows 5–7 expand to rows 5–7 (original 3 template rows → 3 × n rows).
Marker rows are removed. Subsequent sheet content is shifted down automatically.

{
  "version": "2.0",
  "mode": "FAN_OUT",
  "output": "ZIP",

  // Path to the array that drives iteration
  "fan_out_on": "$.input.insured_persons",

  // Max parallel executions (default: 5)
  "fan_out_parallelism": 10,

  // Naming template for each file inside the ZIP
  "file_naming_template": "attestation-{index}-{item.last_name}",

  "steps": [
    {
      // run_once=false → executes for EACH item (default)
      "id": "enrich_person",
      "type": "GATEWAY_CALL",
      "endpoint": "/persons/{{current_item.id}}",
      "output_key": "person_data"
    },
    {
      // run_once=true → executes ONCE before fan-out starts
      "id": "fetch_company_info",
      "type": "HTTP_CALL",
      "url": "https://api.internal.com/company",
      "run_once": true,
      "output_key": "company"
    }
  ]
}

// In post_processing array:
{
  "type": "STAMP",
  "imageBase64": "{{assets.company_seal}}",
  "page": -1,
  "x": 380, "y": 80, "width": 100, "height": 100,
  "opacity": 0.7
}