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

Шаблон — это 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 — возможно, он попадёт в галерею.