> ## Documentation Index
> Fetch the complete documentation index at: https://foliant-help.iforiti.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Asiakirjojen numerot malleissa

> Tulosta laskujen, hyvityslaskujen ja tarjousten numerot muuttujalla `document_number`, laskun päivämäärä muuttujalla `document_date` sekä mitätöintimerkintä.

Kun asiakirjojen numerointi on käytössä, Foliant antaa laskuille, hyvityslaskuille ja tarjouksille omat juoksevat numerot, kuten `INV-0042`. Malli tulostaa numeron muuttujalla `{{ document_number }}` tai visuaalisessa editorissa **Asiakirjan numero** -lohkolla.

## Ennen kuin aloitat

* Ota numerointi käyttöön kohdassa **Asetukset › Asiakirjat ja tulostus › Asiakirjojen numerointi**. Katso [Asiakirjojen numeroinnin määrittäminen](https://foliant-help.iforiti.com/fi/invoices-and-numbering/document-numbering.md).
* Aseta mallin **Asiakirjatyyppi** mallin asetussivulla arvoon **Lasku**, **Hyvityslasku** tai **Tarjous**. Tyypin **Muu (ei numeroitu)** mallit eivät saa numeroita.

## Visuaalisessa editorissa

Lisää **Asiakirjan numero** -lohko (kohdassa **Vaatimukset**). Se tulostaa numeron ja asiakirjan päivämäärän otsikoineen, kuten "Laskun numero" ja "Laskun päivämäärä" (hyvityslaskussa "Hyvityslaskun päivämäärä", tarjouksessa "Tarjouksen päivämäärä"), asiakirjan kielellä. Se näkyy vain numeroiduissa asiakirjoissa.

Voit myös lisätä kentät **Asiakirjan numero** ja **Asiakirjan päivämäärä** **Ylätunniste**-lohkon kohtaan **Tiedot otsikon alla** tai käyttää kenttää **Asiakirjan numero** sisältönä, jonka **Viivakoodi / QR** -lohko koodaa.

## Koodissa

| Muuttuja | Mikä se on |
| - | - |
| `{{ document_number }}` | Asiakirjan numero. Tyhjä, kun asiakirjalla ei ole numeroa. |
| `{{ document_issued_at }}` | Milloin numero annettiin. Tyhjä, kun asiakirjalla ei ole numeroa. Muotoile se `date`-suodattimella. |
| `{{ document_date }}` | Asiakirjan päivämäärä, aina asetettu: numeron antamispäivä, muuten tilauksen päivämäärä (hyvityslaskussa hyvityksen päivämäärä). Käytä sitä laskun päivämääränä. Muotoile se `date`-suodattimella. |
| `{{ document_voided }}` | Tosi, kun asiakirja on peruttu. Sen numero pysyy käytettynä, eikä sitä anneta koskaan uudelleen. |
| `{{ document_kind }}` | `invoice`, `credit_note` tai `quote`; tyhjä, kun mallia ei numeroida. |

Tulosta numero vain, kun sellainen on:

```liquid theme={null}
{% if document_number %}
  <p>{{ 'document_number.invoice' | t }}: {{ document_number }}</p>
  <p>{{ 'document_date.invoice' | t }}: {{ document_date | date: '%d %B %Y' }}</p>
  {% if document_voided %}<p>{{ 'document_number.void' | t }}</p>{% endif %}
{% endif %}
```

`'document_date.invoice' | t` tulostaa "Laskun päivämäärä" asiakirjan kielellä. Käytä muille tyypeille avaimia `document_date.credit_note` tai `document_date.quote`.

## Laskun päivämäärä

Laskun päivämäärä on sen antamispäivä eli päivä, jolloin sille annettiin numero. Se ei ole tilauksen päivämäärä eikä tämä päivä, joka muuttuu aina, kun tulostat laskun uudelleen. `{{ document_date }}` antaa sinulle tämän päivämäärän:

* Numeroidussa asiakirjassa se on numeron antamispäivä kauppasi aikavyöhykkeellä. Jos tulostat asiakirjan uudelleen ensi kuussa, se ei muutu.
* Asiakirjassa, jolla ei ole numeroa, se on tilauksen päivämäärä. Muualta tuoduissa tilauksissa se on tilauksen käsittelypäivä. Hyvityslasku käyttää hyvityksensä päivämäärää.

Sama malli toimii siis, oli numerointi käytössä tai ei. Valmiit lasku-, hyvityslasku- ja tarjousmallit tulostavat sen jo otsikolla "Laskun päivämäärä", "Hyvityslaskun päivämäärä" tai "Tarjouksen päivämäärä". Jos oma mallisi tulostaa päivämääräksi `'now' | date`, korvaa se muodolla `{{ document_date | date: '%d %B %Y' }}`.

## Jos mallisi ei tulosta numeroa

Kun numeroidun asiakirjan malli ei käytä muuttujaa `document_number` missään, Foliant lisää loppuun pienen rivin, jossa on numero ja sen antamispäivä, kuten "Laskun numero: INV-0042 · 4. lokakuuta 2026", jotta numero ei koskaan puutu. Lisää `{{ document_number }}` haluamaasi kohtaan, niin ylimääräinen rivi poistuu. Jos mallisi tulostaa jo muuttujan `document_date` tai `document_issued_at`, rivillä näkyy vain numero.

## Hyvä tietää

* Asiakirja saa numeronsa, kun se ladataan, tulostetaan tai viedään ensimmäisen kerran, ja se säilyttää numeron.
* Editorin esikatselu näyttää numeron, jonka seuraava asiakirjasi saisi, kuluttamatta sitä.
* Numeron viivakoodi: `{{ document_number | barcode }}`. Katso [Viivakoodit ja QR-koodit](https://foliant-help.iforiti.com/fi/template-editor/liquid-barcodes-and-qr-codes.md).
* Kaikkien valittujen tilausten malleja ei koskaan numeroida.

## Aiheeseen liittyvät artikkelit

* [Asiakirjojen numeroinnin määrittäminen](https://foliant-help.iforiti.com/fi/invoices-and-numbering/document-numbering.md)
* [Lohkojen opas](https://foliant-help.iforiti.com/fi/template-editor/block-catalogue.md)
* [Viivakoodit ja QR-koodit](https://foliant-help.iforiti.com/fi/template-editor/liquid-barcodes-and-qr-codes.md)
* [Päivämäärät, kielet ja käännökset](https://foliant-help.iforiti.com/fi/template-editor/liquid-dates-and-languages.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.