Формат шаблону

Шаблон — це JSON-файл із розширенням .invoyatemplate. Він описує лише макет: які розділи має рахунок, у якому порядку і як вони виглядають. Дані підставляє Invoya, а всі підписи — «Кому виставлено», «Разом» — друкуються мовою, вибраною в застосунку.

Найпростіше почати з шаблону з галереї: завантажте його, змініть у будь-якому текстовому редакторі й відкрийте в Invoya — ви побачите результат, перш ніж додати шаблон.

Файл

Ключі верхнього рівня.

page

Розміри — у пунктах: 1 pt — це 1/72 дюйма, аркуш A4 — 595 × 842 pt. Праве поле завжди дорівнює лівому.

style

Усі ключі тут необов’язкові.

blocks

Блоки друкуються згори донизу в тому порядку, у якому їх перелічено. Кожен блок має type і може мати id — він потрібен лише для списку letterhead. Той самий тип можна використати кілька разів, особливо spacer.

Що застосунок не прийме

• Тип блока або значення, яких немає на цій сторінці. Invoya відхилить увесь файл, а не надрукує пів рахунку.
• Шаблон без блока footer з "center": "footerText". Кожен рахунок друкує текст нижнього рядка, тож у шаблоні для нього має бути місце.
• formatVersion, новішу за застосунок. Оновіть Invoya й відкрийте файл знову.
• Файл, більший за 16 КБ.

Корисно знати

• Кольори записуються як #rrggbb. Колір, який не вдалося прочитати, друкується чорним.
• Шаблон не може містити власних шрифтів, зображень чи тексту: шрифт — один із п’яти вище, логотип — той, що задано в застосунку, а всі підписи беруться із застосунку.

Приклад

«Класичний» — шаблон, з якого починається кожне встановлення:

{
  "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" }
  ]
}

Надішліть його нам

Створили шаблон, який вам подобається? Надішліть файл на support@invoya.app — можливо, він потрапить до галереї.