stationery 0.11.0 → 0.12.0

data/examples/accessible_report.rb

@@ -0,0 +1,133 @@
+# frozen_string_literal: true
+
+# A survey report written for screen readers as a PDF/UA-1 file:
+# headings in order, a chart and a photo as figures with their `alt:` text,
+# a table whose header cells a reader announces with every value, and a
+# language and title of its own. `rake verify:conformance` validates it with
+# veraPDF. Run it to write examples/accessible_report.pdf:
+#
+#   ruby -Ilib examples/accessible_report.rb
+#   ruby -Ilib exe/stationery render examples/accessible_report.rb
+require "stationery"
+
+class ExampleAccessibleReport < Stationery::Document
+  PHOTO = File.expand_path("assets/hills.png", __dir__)
+  ACCENT = "#1D4ED8"
+  INK = "#111827"
+  MUTED = "#4B5563"
+  HAIRLINE = "#D1D5DB"
+  ZEBRA = "#F3F4F6"
+
+  page size: :a4, margin: [56, 60, 48, 60]
+  default_text size: 10.5, color: INK, leading: 3
+  # PDF/UA-1 asks for a title and a language, and turns tagging on. What it
+  # cannot keep (a figure without `alt:`, a heading level skipped) raises
+  # instead of writing a file that claims more than it is.
+  metadata title: "Cycling to school: survey 2026", author: "Example County Council", lang: "en",
+           creator: "stationery example"
+  conformance :pdf_ua1
+
+  footer { |page| text "Page #{page.number} of #{page.count}", size: 8, color: MUTED, align: :center }
+
+  def self.preview
+    new(schools: [["Northfield", 412, 38, 44], ["Riverside", 288, 51, 57], ["Hillcrest", 530, 22, 31],
+                  ["Harbour", 196, 44, 49], ["Meadow Lane", 351, 29, 41]])
+  end
+
+  def initialize(schools:)
+    super()
+    @schools = schools
+  end
+
+  def view_template
+    text "Cycling to school", size: 26, weight: :bold, heading: 1
+    text "Results of the 2026 travel survey in five primary schools", size: 13, color: MUTED
+    spacer 18
+    summary
+    findings
+    method_section
+  end
+
+  private
+
+  def heading(title, level: 2)
+    spacer 14
+    text title, size: level == 2 ? 16 : 12.5, weight: :bold, color: ACCENT, heading: level, keep_with_next: 60
+    spacer 6
+  end
+
+  def summary
+    heading "Summary"
+    text "More children cycle to school than a year ago in every school surveyed. Across the five schools the " \
+         "share rose from 35 to 45 per cent after the new cycle paths opened in March. The largest change was " \
+         "at Hillcrest, where a safe crossing on the main road was the most requested improvement."
+    spacer 10
+    image PHOTO, width: 1.0, height: 120, fit: :cover, radius: 4,
+                 alt: "Green hills under a yellow morning sky: the valley the new cycle paths run through"
+  end
+
+  def findings
+    heading "Findings"
+    heading "Share of pupils who cycle", level: 3
+    svg chart, width: 475, color: ACCENT,
+               alt: "Bar chart of the share of pupils who cycle, 2025 and 2026. Northfield 38 to 44 per cent, " \
+                    "Riverside 51 to 57, Hillcrest 22 to 31, Harbour 44 to 49, Meadow Lane 29 to 41."
+    spacer 4
+    text "Light bars 2025, dark bars 2026.", size: 8.5, color: MUTED
+    heading "By school", level: 3
+    school_table
+  end
+
+  # A header row is tagged as TH cells with a column scope, so a screen
+  # reader names the column with every value it reads.
+  def school_table
+    rows = [["School", "Pupils", "Cycling 2025", "Cycling 2026", "Change"]]
+    @schools.each do |name, pupils, before, after|
+      rows << [name, pupils.to_s, "#{before}%", "#{after}%", format("%+d points", after - before)]
+    end
+    table(rows, header: true, width: :full, widths: [nil, 60, 80, 80, 70],
+                cell: { padding: [5, 8], borders: [:bottom], border_color: HAIRLINE, size: 9.5 }) do |t|
+      t.row(0).set(weight: :bold, border_color: INK)
+      t.columns(1..).align = :right
+      t.zebra(from: 1, color: ZEBRA)
+    end
+  end
+
+  def method_section
+    heading "Method"
+    text "Every pupil in years three to six answered five questions in class in the first week of May, as in " \
+         "2025. Answers were collected on paper and entered twice by different people. The response rate " \
+         "was 94 per cent; absent pupils were not followed up."
+    spacer 8
+    ul(gap: 4, marker_color: ACCENT) do
+      li "Cycling means cycling for at least part of the way on three days or more of the week."
+      li "Pupils who walk and cycle on different days were counted as cycling."
+      li "Figures are rounded to whole percentage points."
+    end
+  end
+
+  # The bars as SVG, 2025 light and 2026 in the accent colour (currentColor).
+  def chart
+    bars = @schools.each_with_index.map do |(name, _, before, after), index|
+      x = 40 + (index * 90)
+      <<~BAR
+        <rect x="#{x}" y="#{150 - (before * 2)}" width="30" height="#{before * 2}" fill="#BFDBFE"/>
+        <rect x="#{x + 32}" y="#{150 - (after * 2)}" width="30" height="#{after * 2}" fill="currentColor"/>
+        <text x="#{x + 31}" y="168" font-size="11" text-anchor="middle" fill="#4B5563">#{name}</text>
+      BAR
+    end
+    <<~SVG
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 490 175">
+        <line x1="30" y1="150" x2="490" y2="150" stroke="#9CA3AF"/>
+        #{bars.join}
+      </svg>
+    SVG
+  end
+end
+
+if $PROGRAM_NAME == __FILE__
+  report = ExampleAccessibleReport.preview
+  report.to_pdf(File.expand_path("accessible_report.pdf", __dir__))
+  warn report.warnings.map(&:message) if report.warnings.any?
+  puts "wrote examples/accessible_report.pdf"
+end

data/examples/article.rb

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+
+# A magazine page: justified text wrapping around a floated photo, a pull
+# quote floated to the right and a snapshot floated by CSS inside `html`.
+# Run it to write examples/article.pdf:
+#
+#   ruby -Ilib examples/article.rb
+#   ruby -Ilib exe/stationery render examples/article.rb
+require "stationery"
+
+class ExampleArticle < Stationery::Document
+  ASSETS = File.expand_path("assets", __dir__)
+  INK = "#1F2937"
+  MUTED = "#6B7280"
+  ACCENT = "#B45309"
+  WASH = "#FEF3C7"
+
+  PARAGRAPHS = [
+    "The road to the bay ends where the asphalt does. From there a track of red earth runs between dry-stone " \
+    "walls, past a shuttered farm and a row of prickly pears, and then the land simply stops: a shelf of pale " \
+    "rock, the water beyond it green over sand and blue over weed. Nobody built anything here. The nearest " \
+    "village is an hour away on foot, and it has never been in a hurry to come closer.",
+    "We walked out in the cool of the morning with bread, tomatoes and two litres of water each. The shepherd " \
+    "we met at the last gate counted us, counted the bottles, and let us through with a nod. By ten the sun " \
+    "was over the ridge and the cicadas had started; by eleven the only shade on the whole shore was the one " \
+    "we carried with us, a square of canvas on four driftwood poles.",
+    "What strikes a visitor from the north is how little the place asks of you. There is no path to follow " \
+    "and no view to find, because the view is everywhere. You swim, you dry, you read a page and lose your " \
+    "place. The afternoon wind arrives at three, as it has every day since May, and turns the bay from glass " \
+    "to hammered pewter in the time it takes to look up.",
+    "On the way back the shepherd was waiting with a bag of figs. He would not take money for them. He asked " \
+    "instead whether the water had been cold, and when we said no, not at all, he laughed and said that it " \
+    "would be by November, and that November was the month to come."
+  ].freeze
+
+  NOTES = <<~HTML
+    <h2>Getting there</h2>
+    <p><img src="stone.png" alt="A sandstone wall beside the track" style="float: right; width: 96pt;
+    margin: 0 0 6pt 12pt">Leave the car at the last farm and carry what you need: there is no water on the
+    shore and no shade before the evening. The track is easy underfoot, but it is an hour each way and the
+    walls beside it keep the wind out. Start before eight, turn back by five, and close every gate behind
+    you.</p>
+  HTML
+
+  page size: :a4, margin: [64, 72]
+  default_text size: 10.5, color: INK, leading: 3, hyphenate: :en
+  metadata title: "An hour from the road", author: "stationery example", lang: "en"
+  tagged
+
+  def self.preview = new
+
+  def view_template
+    text "TRAVEL", size: 8, weight: :bold, color: ACCENT, letter_spacing: 1.5
+    text "An hour from the road", size: 28, weight: :bold, heading: 1, leading: 0
+    text "A bay in the south of Sardinia that the asphalt never reached", size: 12, color: MUTED
+    spacer 8
+    rule height: 2, color: ACCENT, width: 48
+    spacer 14
+    story
+    spacer 6
+    html NOTES, base_path: ASSETS, styles: { h2: { color: ACCENT, scale: 1.3 } }
+  end
+
+  private
+
+  # The photo floats left at the top of the first paragraph; the pull quote
+  # floats right where it is written, between the second and the third.
+  def story
+    group(gap: 9) do
+      image photo("sea"), float: :left, width: 0.42, margin: { right: 14, bottom: 8 }, radius: 6,
+                          alt: "The bay from the last gate, early in the morning"
+      PARAGRAPHS.first(2).each { |paragraph| text paragraph, align: :justify }
+      pull_quote "There is no path to follow and no view to find, because the view is everywhere."
+      PARAGRAPHS.drop(2).each { |paragraph| text paragraph, align: :justify }
+    end
+  end
+
+  def pull_quote(words)
+    box(float: :right, width: 170, margin: { left: 16, bottom: 6 }, padding: [10, 12], background: WASH,
+        border: { sides: [:left], width: 3, color: ACCENT }, role: :blockquote) do
+      text words, size: 13, style: :italic, color: ACCENT, leading: 2, hyphenate: nil
+    end
+  end
+
+  def photo(name) = File.join(ASSETS, "#{name}.png")
+end
+
+if $PROGRAM_NAME == __FILE__
+  article = ExampleArticle.preview
+  article.to_pdf(File.expand_path("article.pdf", __dir__))
+  warn article.warnings.map(&:message) if article.warnings.any?
+  puts "wrote examples/article.pdf"
+end

data/examples/certificate.rb

@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+
+# A certificate of completion on a landscape A4 page: a frame and rosettes
+# drawn on a canvas under the content, centred type, and two signature fields
+# for the people who sign it. Run it to write examples/certificate.pdf:
+#
+#   ruby -Ilib examples/certificate.rb
+#   ruby -Ilib exe/stationery render examples/certificate.rb
+require "stationery"
+
+class ExampleCertificate < Stationery::Document
+  GOLD = "#B08D57"
+  INK = "#1F2937"
+  MUTED = "#6B7280"
+  PAPER = "#FFFBF2"
+  SEAL = <<~SVG
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100">
+      <circle cx="50" cy="50" r="48" fill="#B08D57"/>
+      <circle cx="50" cy="50" r="40" fill="none" stroke="#FFFBF2" stroke-width="1.5" stroke-dasharray="3 2"/>
+      <path d="M50 24l7.6 15.4 17 2.5-12.3 12 2.9 16.9L50 62.8l-15.2 8 2.9-16.9-12.3-12 17-2.5z" fill="#FFFBF2"/>
+    </svg>
+  SVG
+
+  page size: :a4, layout: :landscape, margin: [112, 110, 72, 110]
+  default_text color: INK, align: :center
+  metadata title: "Certificate of completion", author: "Harbour Institute of Sailing", creator: "stationery example"
+
+  # The background is painted under the content of every page: a page
+  # template on the background layer, with a canvas the size of the page.
+  page_template(layer: :background) do |page|
+    canvas(height: page.height, width: page.width, at: [0, 0]) { |c, _rect| frame(c, page.width, page.height) }
+  end
+
+  def self.preview
+    new(name: "Robin Example", course: "Coastal Skipper, practical course",
+        hours: 64, date: "12 September 2026", number: "HIS-2026-0419")
+  end
+
+  def initialize(name:, course:, hours:, date:, number:)
+    super()
+    @name = name
+    @course = course
+    @hours = hours
+    @date = date
+    @number = number
+  end
+
+  def view_template
+    text "HARBOUR INSTITUTE OF SAILING", size: 10, weight: :bold, color: GOLD, letter_spacing: 3
+    spacer 18
+    text "Certificate of completion", size: 34, weight: :bold
+    spacer 18
+    text "This is to certify that", size: 12, color: MUTED, style: :italic
+    spacer 10
+    text @name, size: 30, weight: :bold, color: GOLD
+    spacer 12
+    text "has completed the #{@course}, #{@hours} hours afloat and ashore,\n" \
+         "and has shown the seamanship the course asks for.", size: 12, leading: 4
+    spacer 60
+    signatures
+  end
+
+  private
+
+  # Two signature fields with the seal between them; the signers sign in
+  # their PDF viewer, or with `to_pdf(sign: { …, field: "director" })`.
+  def signatures
+    row(gap: 40, align: :bottom) do
+      column { signature_field "director", label: "Anna Example, Director of Training", height: 44 }
+      column(width: 70) { svg SEAL, width: 70, align: :center }
+      column { signature_field "examiner", label: "Jonas Sample, Examiner", height: 44 }
+    end
+    spacer 16
+    text "Awarded #{@date} · Certificate #{@number}", size: 8.5, color: MUTED
+  end
+
+  # A double frame with rosettes in the corners, in page coordinates from
+  # the top left.
+  def frame(canvas, width, height)
+    canvas.fill_rect(0, 0, width, height, color: PAPER)
+    canvas.rounded_rect(24, 24, width - 48, height - 48, radius: 4, stroke: GOLD, line_width: 2.5)
+    canvas.rounded_rect(34, 34, width - 68, height - 68, radius: 2, stroke: GOLD, line_width: 0.75)
+    [[34, 34], [width - 34, 34], [34, height - 34], [width - 34, height - 34]].each do |x, y|
+      rosette(canvas, x, y)
+    end
+    canvas.line((width / 2) - 60, 88, (width / 2) + 60, 88, color: GOLD, width: 0.75)
+  end
+
+  def rosette(canvas, x, y)
+    canvas.circle(x, y, 14, fill: PAPER, stroke: GOLD, line_width: 1)
+    8.times do |i|
+      angle = i * Math::PI / 4
+      canvas.line(x, y, x + (12 * Math.cos(angle)), y + (12 * Math.sin(angle)), color: GOLD, width: 0.6)
+    end
+    canvas.circle(x, y, 4, fill: GOLD)
+  end
+end
+
+if $PROGRAM_NAME == __FILE__
+  certificate = ExampleCertificate.preview
+  certificate.to_pdf(File.expand_path("certificate.pdf", __dir__))
+  warn certificate.warnings.map(&:message) if certificate.warnings.any?
+  puts "wrote examples/certificate.pdf"
+end

data/examples/contract.rb

@@ -0,0 +1,159 @@
+# frozen_string_literal: true
+
+# A services agreement over several pages: numbered clauses whose headings
+# stay with their text, a box for both parties' initials in the footer of
+# every page, and signature fields for a digital signature. Run it to write
+# examples/contract.pdf:
+#
+#   ruby -Ilib examples/contract.rb
+#   ruby -Ilib exe/stationery render examples/contract.rb
+#
+# Signing happens when the file is written, with a certificate and its key;
+# `field:` names the signature field that carries the signature:
+#
+#   ExampleContract.preview.to_pdf("contract.pdf",
+#     sign: { certificate: File.read("provider.crt"), key: File.read("provider.key"),
+#             field: "signature.provider", reason: "Agreed", location: "Gothenburg" })
+require "stationery"
+
+class ExampleContract < Stationery::Document
+  INK = "#111827"
+  MUTED = "#6B7280"
+  HAIRLINE = "#D1D5DB"
+
+  CLAUSES = [
+    ["Definitions", ["“Services” means the development, hosting and support of the Client's delivery-tracking " \
+                     "application described in Schedule 1.",
+                     "“Business Day” means a day other than a Saturday, a Sunday or a public holiday in Sweden.",
+                     "Headings are for convenience only and do not affect how this Agreement is read."]],
+    ["Term", ["This Agreement starts on the Effective Date and runs for twenty-four months.",
+              "It renews for further periods of twelve months unless either party gives written notice at " \
+              "least ninety days before the end of the current period."]],
+    ["Services", ["The Provider shall perform the Services with reasonable skill and care, in line with good " \
+                  "industry practice, and through personnel who are suitably qualified.",
+                  "The Provider shall keep the application available 99.5 per cent of each calendar month, " \
+                  "measured as set out in Schedule 2, excluding maintenance announced five Business Days ahead.",
+                  "Changes to the Services are agreed in writing through the change procedure in Schedule 3."]],
+    ["Fees and payment", ["The Client shall pay the fees set out in Schedule 4, monthly in arrears, within " \
+                          "thirty days of the date of each invoice.",
+                          "Fees are exclusive of value added tax, which the Client pays at the rate in force.",
+                          "Late payments carry interest at the reference rate of the Riksbank plus eight " \
+                          "percentage points."]],
+    ["Intellectual property", ["Each party keeps the rights it owned before the Effective Date.",
+                               "Rights in work made for the Client under this Agreement pass to the Client when " \
+                               "it has been paid for. The Provider keeps its general tools and know-how."]],
+    ["Confidentiality", ["Each party shall keep the other's confidential information secret and use it only " \
+                         "to perform this Agreement.",
+                         "This clause survives the end of the Agreement for five years."]],
+    ["Data protection", ["Where the Provider processes personal data for the Client, it does so as processor " \
+                         "under the data processing agreement in Schedule 5, which forms part of this Agreement."]],
+    ["Liability", ["Neither party is liable for indirect loss, loss of profit or loss of data, except in the " \
+                   "case of gross negligence or wilful misconduct.",
+                   "Each party's total liability in a contract year is limited to the fees paid in that year."]],
+    ["Termination", ["Either party may terminate this Agreement with immediate effect if the other commits a " \
+                     "material breach and does not remedy it within thirty days of written notice.",
+                     "On termination the Provider shall hand over the Client's data in a common machine-readable " \
+                     "format and then delete it."]],
+    ["Governing law and disputes", ["This Agreement is governed by Swedish law.",
+                                    "Disputes are finally settled by arbitration under the Rules for Expedited " \
+                                    "Arbitrations of the SCC Arbitration Institute, seated in Gothenburg."]]
+  ].freeze
+
+  page size: :a4, margin: [56, 64, 48, 64]
+  default_text size: 10, color: INK, leading: 2.5
+  metadata title: "Services agreement", author: "Example Software AB", creator: "stationery example"
+
+  # Every page carries a box for each party's initials: a text field per
+  # party and page, named after the page (`initials.provider.3`) so that each
+  # is a field of its own. The frame is a box around the field, so it prints
+  # in viewers that redraw empty fields without their border.
+  footer(gap: 16) do |page|
+    row(align: :middle, gap: 12) do
+      column { text "Services agreement · page #{page.number} of #{page.count}", size: 8, color: MUTED }
+      column(width: :auto) { text "Initials", size: 8, color: MUTED }
+      %w[provider client].each do |party|
+        column(width: 44) do
+          box(border: { color: MUTED, width: 0.75 }, radius: 3) do
+            text_field "initials.#{party}.#{page.number}", height: 20, tooltip: "Initials of the #{party}",
+                                                           border: nil, background: nil
+          end
+        end
+      end
+    end
+  end
+
+  def self.preview
+    new(provider: ["Example Software AB", "Org. no. 556000-0000", "Storgatan 1, 411 00 Gothenburg"],
+        client: ["Sample Freight Ltd", "Company no. 00000000", "1 Test Street, Testville"],
+        date: "1 October 2026")
+  end
+
+  def initialize(provider:, client:, date:)
+    super()
+    @provider = provider
+    @client = client
+    @date = date
+  end
+
+  def view_template
+    text "Services agreement", size: 22, weight: :bold
+    spacer 4
+    text "Effective Date: #{@date}", color: MUTED
+    spacer 16
+    parties
+    spacer 10
+    CLAUSES.each_with_index { |(title, paragraphs), index| clause(index + 1, title, paragraphs) }
+    signatures
+  end
+
+  private
+
+  def parties
+    text "This Agreement is made between:"
+    spacer 6
+    row(gap: 24) do
+      column { party("THE PROVIDER", @provider) }
+      column { party("THE CLIENT", @client) }
+    end
+  end
+
+  def party(label, lines)
+    text label, size: 7.5, weight: :bold, color: MUTED, letter_spacing: 0.6
+    text "<b>#{lines.first}</b>\n#{lines.drop(1).join("\n")}", markup: true, size: 9.5
+  end
+
+  # "3. Services" and its sub-clauses 3.1, 3.2, …: the heading keeps at least
+  # 50 points of what follows on its page, so it never ends one alone.
+  def clause(number, title, paragraphs)
+    spacer 12
+    text "#{number}. #{title}", size: 11.5, weight: :bold, keep_with_next: 50, bookmark: title
+    spacer 4
+    paragraphs.each_with_index do |paragraph, index|
+      row(gap: 8) do
+        column(width: 30) { text "#{number}.#{index + 1}", color: MUTED }
+        column { text paragraph, align: :justify, hyphenate: true }
+      end
+      spacer 4
+    end
+  end
+
+  # Kept together, so both parties sign on one page.
+  def signatures
+    spacer 24
+    group(keep_together: true) do
+      text "Signed by the parties on the dates written below their signatures.", keep_with_next: true
+      spacer 30
+      row(gap: 40) do
+        column { signature_field "signature.provider", label: "For #{@provider.first}", height: 48 }
+        column { signature_field "signature.client", label: "For #{@client.first}", height: 48 }
+      end
+    end
+  end
+end
+
+if $PROGRAM_NAME == __FILE__
+  contract = ExampleContract.preview
+  contract.to_pdf(File.expand_path("contract.pdf", __dir__))
+  warn contract.warnings.map(&:message) if contract.warnings.any?
+  puts "wrote examples/contract.pdf"
+end

data/examples/e_invoice.rb

@@ -0,0 +1,161 @@
+# frozen_string_literal: true
+
+# A Factur-X (ZUGFeRD) e-invoice: the example invoice as PDF/A-3b with its
+# EN 16931 invoice XML embedded, so accounting software books what people read.
+# Run it to write examples/e_invoice.pdf:
+#
+#   ruby -Ilib examples/e_invoice.rb
+#   ruby -Ilib exe/stationery render examples/e_invoice.rb
+require "date"
+require "stationery"
+require_relative "invoice"
+
+class ExampleEInvoice < ExampleInvoice
+  ISSUED = Date.new(2026, 9, 26)
+  VAT_RATE = 25
+  SELLER = { name: "Acme Studio AB", street: "Storgatan 1", postcode: "111 22", city: "Stockholm", country: "SE",
+             email: "hello@acme.test", vat_id: "SE556677889901", iban: "SE4550000000058398257466" }.freeze
+  BUYER = { street: "Hauptstraße 5", postcode: "10115", city: "Berlin", country: "DE", vat_id: "DE123456789" }.freeze
+
+  metadata title: "E-invoice", author: SELLER[:name], lang: "en"
+
+  # The XML comes from the document being rendered, so every invoice embeds
+  # its own. `factur_x` also makes the file PDF/A-3b and identifies the
+  # invoice in the XMP metadata.
+  factur_x(profile: :en16931) { cross_industry_invoice }
+
+  private
+
+  # SAMPLE CODE. Stationery embeds the invoice XML, it does not write it: in
+  # an application the XML comes from your invoicing code or a library made
+  # for it. This is the smallest Cross Industry Invoice that satisfies
+  # EN 16931 for the lines above: one VAT rate, no allowances or charges.
+  def cross_industry_invoice
+    <<~XML
+      <?xml version="1.0" encoding="UTF-8"?>
+      <rsm:CrossIndustryInvoice xmlns:rsm="urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100" xmlns:ram="urn:un:unece:uncefact:data:standard:ReusableAggregateBusinessInformationEntity:100" xmlns:udt="urn:un:unece:uncefact:data:standard:UnqualifiedDataType:100">
+        <rsm:ExchangedDocumentContext>
+          <ram:GuidelineSpecifiedDocumentContextParameter>
+            <ram:ID>urn:cen.eu:en16931:2017</ram:ID>
+          </ram:GuidelineSpecifiedDocumentContextParameter>
+        </rsm:ExchangedDocumentContext>
+        <rsm:ExchangedDocument>
+          <ram:ID>#{xml(@number)}</ram:ID>
+          <ram:TypeCode>380</ram:TypeCode>
+          <ram:IssueDateTime>#{xml_date(ISSUED)}</ram:IssueDateTime>
+        </rsm:ExchangedDocument>
+        <rsm:SupplyChainTradeTransaction>
+      #{@items.each_with_index.map { |item, index| xml_line(index + 1, *item) }.join.chomp}
+          <ram:ApplicableHeaderTradeAgreement>
+            <ram:SellerTradeParty>
+              <ram:Name>#{xml(SELLER[:name])}</ram:Name>
+      #{xml_address(SELLER)}
+              <ram:URIUniversalCommunication>
+                <ram:URIID schemeID="EM">#{xml(SELLER[:email])}</ram:URIID>
+              </ram:URIUniversalCommunication>
+      #{xml_vat_id(SELLER)}
+            </ram:SellerTradeParty>
+            <ram:BuyerTradeParty>
+              <ram:Name>#{xml(@customer)}</ram:Name>
+      #{xml_address(BUYER)}
+      #{xml_vat_id(BUYER)}
+            </ram:BuyerTradeParty>
+            <ram:BuyerOrderReferencedDocument>
+              <ram:IssuerAssignedID>PO-7781</ram:IssuerAssignedID>
+            </ram:BuyerOrderReferencedDocument>
+          </ram:ApplicableHeaderTradeAgreement>
+          <ram:ApplicableHeaderTradeDelivery>
+            <ram:ActualDeliverySupplyChainEvent>
+              <ram:OccurrenceDateTime>#{xml_date(ISSUED)}</ram:OccurrenceDateTime>
+            </ram:ActualDeliverySupplyChainEvent>
+          </ram:ApplicableHeaderTradeDelivery>
+          <ram:ApplicableHeaderTradeSettlement>
+            <ram:InvoiceCurrencyCode>EUR</ram:InvoiceCurrencyCode>
+            <ram:SpecifiedTradeSettlementPaymentMeans>
+              <ram:TypeCode>58</ram:TypeCode>
+              <ram:PayeePartyCreditorFinancialAccount>
+                <ram:IBANID>#{SELLER[:iban]}</ram:IBANID>
+              </ram:PayeePartyCreditorFinancialAccount>
+            </ram:SpecifiedTradeSettlementPaymentMeans>
+            <ram:ApplicableTradeTax>
+              <ram:CalculatedAmount>#{xml_amount(vat)}</ram:CalculatedAmount>
+              <ram:TypeCode>VAT</ram:TypeCode>
+              <ram:BasisAmount>#{xml_amount(subtotal)}</ram:BasisAmount>
+              <ram:CategoryCode>S</ram:CategoryCode>
+              <ram:RateApplicablePercent>#{VAT_RATE}</ram:RateApplicablePercent>
+            </ram:ApplicableTradeTax>
+            <ram:SpecifiedTradePaymentTerms>
+              <ram:DueDateDateTime>#{xml_date(Date.parse(@due))}</ram:DueDateDateTime>
+            </ram:SpecifiedTradePaymentTerms>
+            <ram:SpecifiedTradeSettlementHeaderMonetarySummation>
+              <ram:LineTotalAmount>#{xml_amount(subtotal)}</ram:LineTotalAmount>
+              <ram:TaxBasisTotalAmount>#{xml_amount(subtotal)}</ram:TaxBasisTotalAmount>
+              <ram:TaxTotalAmount currencyID="EUR">#{xml_amount(vat)}</ram:TaxTotalAmount>
+              <ram:GrandTotalAmount>#{xml_amount(total)}</ram:GrandTotalAmount>
+              <ram:DuePayableAmount>#{xml_amount(total)}</ram:DuePayableAmount>
+            </ram:SpecifiedTradeSettlementHeaderMonetarySummation>
+          </ram:ApplicableHeaderTradeSettlement>
+        </rsm:SupplyChainTradeTransaction>
+      </rsm:CrossIndustryInvoice>
+    XML
+  end
+
+  def xml_line(number, name, quantity, price)
+    <<~XML.gsub(/^/, "    ")
+      <ram:IncludedSupplyChainTradeLineItem>
+        <ram:AssociatedDocumentLineDocument>
+          <ram:LineID>#{number}</ram:LineID>
+        </ram:AssociatedDocumentLineDocument>
+        <ram:SpecifiedTradeProduct>
+          <ram:Name>#{xml(name)}</ram:Name>
+        </ram:SpecifiedTradeProduct>
+        <ram:SpecifiedLineTradeAgreement>
+          <ram:NetPriceProductTradePrice>
+            <ram:ChargeAmount>#{xml_amount(price)}</ram:ChargeAmount>
+          </ram:NetPriceProductTradePrice>
+        </ram:SpecifiedLineTradeAgreement>
+        <ram:SpecifiedLineTradeDelivery>
+          <ram:BilledQuantity unitCode="C62">#{quantity}</ram:BilledQuantity>
+        </ram:SpecifiedLineTradeDelivery>
+        <ram:SpecifiedLineTradeSettlement>
+          <ram:ApplicableTradeTax>
+            <ram:TypeCode>VAT</ram:TypeCode>
+            <ram:CategoryCode>S</ram:CategoryCode>
+            <ram:RateApplicablePercent>#{VAT_RATE}</ram:RateApplicablePercent>
+          </ram:ApplicableTradeTax>
+          <ram:SpecifiedTradeSettlementLineMonetarySummation>
+            <ram:LineTotalAmount>#{xml_amount(quantity * price)}</ram:LineTotalAmount>
+          </ram:SpecifiedTradeSettlementLineMonetarySummation>
+        </ram:SpecifiedLineTradeSettlement>
+      </ram:IncludedSupplyChainTradeLineItem>
+    XML
+  end
+
+  def xml_address(party)
+    <<~XML.gsub(/^/, "        ").chomp
+      <ram:PostalTradeAddress>
+        <ram:PostcodeCode>#{xml(party[:postcode])}</ram:PostcodeCode>
+        <ram:LineOne>#{xml(party[:street])}</ram:LineOne>
+        <ram:CityName>#{xml(party[:city])}</ram:CityName>
+        <ram:CountryID>#{party[:country]}</ram:CountryID>
+      </ram:PostalTradeAddress>
+    XML
+  end
+
+  def xml_vat_id(party)
+    <<~XML.gsub(/^/, "        ").chomp
+      <ram:SpecifiedTaxRegistration>
+        <ram:ID schemeID="VA">#{party[:vat_id]}</ram:ID>
+      </ram:SpecifiedTaxRegistration>
+    XML
+  end
+
+  def xml_date(date) = %(<udt:DateTimeString format="102">#{date.strftime("%Y%m%d")}</udt:DateTimeString>)
+  def xml_amount(amount) = format("%.2f", amount)
+  def xml(text) = text.to_s.gsub("&", "&amp;").gsub("<", "&lt;").gsub(">", "&gt;")
+end
+
+if $PROGRAM_NAME == __FILE__
+  ExampleEInvoice.preview.to_pdf(File.expand_path("e_invoice.pdf", __dir__))
+  puts "wrote examples/e_invoice.pdf"
+end