Vorlagenformat

Eine Vorlage ist eine JSON-Datei mit der Endung .invoyatemplate. Sie beschreibt nur ein Layout: welche Abschnitte die Rechnung hat, in welcher Reihenfolge und wie sie aussehen. Die Angaben setzt Invoya ein, und jede Beschriftung – „Rechnung an“, „Gesamt“ – druckt die App in der Sprache, auf die sie eingestellt ist.

Am schnellsten geht es mit einer Vorlage aus der Galerie: Laden Sie eine herunter, ändern Sie sie in einem beliebigen Texteditor und öffnen Sie sie in Invoya – dort sehen Sie das Ergebnis, bevor Sie sie hinzufügen.

Die Datei

Die Schlüssel auf oberster Ebene der Datei.

page

Maße in Punkt: 1 pt ist 1/72 Zoll, ein A4-Blatt misst 595 × 842 pt. Der rechte Rand ist immer so breit wie der linke.

style

Jeder Schlüssel hier ist optional.

blocks

Die Blöcke werden in der Reihenfolge der Liste untereinander gedruckt. Jeder Block hat einen type und kann eine id haben – die braucht nur die letterhead-Liste. Ein Typ darf mehrmals vorkommen, vor allem spacer.

Was die App ablehnt

• Einen Blocktyp oder Wert, der nicht auf dieser Seite steht. Invoya lehnt dann die ganze Datei ab, statt eine halbe Rechnung zu drucken.
• Eine Vorlage ohne footer-Block mit "center": "footerText". Jede Rechnung druckt ihren Fußzeilentext, also muss eine Vorlage Platz dafür lassen.
• Eine formatVersion, die neuer ist als die App. Aktualisieren Sie Invoya und öffnen Sie die Datei erneut.
• Eine Datei, die größer als 16 KB ist.

Gut zu wissen

• Farben werden als #rrggbb geschrieben. Eine Farbe, die sich nicht lesen lässt, wird schwarz gedruckt.
• Eine Vorlage kann keine eigenen Schriften, Bilder oder Texte mitbringen: Die Schrift ist eine der fünf oben, das Logo ist das in der App hinterlegte, und alle Beschriftungen kommen aus der App.

Beispiel

„Klassisch“, die Vorlage, mit der jede Installation beginnt:

{
  "format": "invoya.invoice-template",
  "formatVersion": "1.3",
  "id": "app.invoya.classic",
  "name": {
    "en": "Classic",
    "de": "Klassisch",
    "ru": "Классический",
    "uk": "Класичний"
  },
  "author": "Invoya",
  "page": {
    "size": "a4",
    "margins": { "top": 72, "left": 72, "bottom": 72, "footer": 30 }
  },
  "style": { "bodySize": 8 },
  "letterhead": ["business"],
  "blocks": [
    { "id": "business", "type": "business", "align": "right", "logo": "left" },
    { "type": "spacer", "height": 30 },
    { "id": "title", "type": "title", "align": "center", "filled": true },
    { "id": "meta", "type": "invoiceMeta", "align": "right",
      "fields": ["number", "invoiceDate", "dueDate"] },
    { "id": "client", "type": "client", "caption": "billTo" },
    { "type": "spacer", "height": 30 },
    { "id": "items", "type": "items",
      "columns": ["index", "description", "unit", "qty", "rate", "amount"],
      "borders": true },
    { "type": "spacer", "height": 10 },
    { "id": "totals", "type": "totals", "align": "right",
      "lines": ["subtotal", "discount", "taxes", "total"] },
    { "id": "terms", "type": "terms" },
    { "id": "payment", "type": "payment", "qr": "auto" },
    { "id": "footer", "type": "footer", "left": "pageXofN", "center": "footerText" }
  ]
}

Schicken Sie sie uns

Haben Sie eine Vorlage gestaltet, die Ihnen gefällt? Senden Sie die Datei an support@invoya.app – vielleicht kommt sie in die Galerie.