JSON pentru pachet

Cardul Linii de factură suplimentare salvează un pachet ca JSON pe produs, sub cheia invoiceBundle. Pentru importuri folosiți aceeași structură. Pentru utilizarea obișnuită nu aveți nevoie de această pagină: câmpurile și explicațiile lor se află la Pașii pachetului.

StructurăCopiază linkul către această secțiune

Fiecare pas este un pas de produs sau un pas de informare.

Pas de produsCopiază linkul către această secțiune

Pas de informareCopiază linkul către această secțiune

{
  "stepKind": "info",
  "description": "Inclusief toeristen-, gemeente- en provincietaksen"
}

description este obligatoriu, iar un pas de informare nu are productId. Cu style (DEFAULT sau INFO) alegeți stilul liniei, implicit este INFO. O formula care returnează false omite linia de informare.

FormulaCopiază linkul către această secțiune

formula este TypeScript care, la salvarea unei facturi, returnează true (o linie cu quantity), false (nicio linie), un număr (cantitatea) sau o listă de linii { "quantity", "description", "unitPrice", "accessMethodValue" }. Ce câmpuri și liste puteți citi și ce face fiecare formă se află la Formula pe pas. O formulă care nu se compilează este refuzată la salvarea produsului. În JSON, formula este un singur șir de caractere, cu \n pentru sfârșiturile de rând.

"formula": "return {customer.customFields.exemptFromSurcharges} !== true;"

Prelungirea NFCCopiază linkul către această secțiune

Are sens doar dacă produsul principal are ca acțiune Prelungiți perioada de ocupare.

"extendAccessMethod": { "daysAfterPeriodEnd": 20 }

La plata unei linii dintr-un astfel de pas, Tillor setează valabilitatea metodelor de acces ale clientului la data de sfârșit a liniei principale plus daysAfterPeriodEnd zile calendaristice. Implicit, valabilitatea durează până la 23:59 în fusul orar al organizației sau până la ziua din săptămână și ora din Prelungiți metoda de acces de pe produsul principal. Tot acolo stabiliți ce tipuri și ce stări se iau în calcul. Fără dată de sfârșit pe linia principală nu se întâmplă nimic. Cu Nu scurtați la prelungire activat, Tillor sare peste metodele a căror valabilitate se află deja la sau după noua dată. Un accessMethodValue pe linie indică metoda acelei linii; prelungirea în sine urmează setările produsului principal.

După o prelungire reușită, pe cronologia facturii apare o linie care trimite la plată.

Exemplu: explicație, supliment NFC, închiriere contor și câiniCopiază linkul către această secțiune

{
  "invoiceBundle": {
    "version": 1,
    "steps": [
      {
        "stepKind": "info",
        "description": "Inclusief toeristen-, gemeente- en provincietaksen"
      },
      {
        "productId": "prd_nfc_toeslag",
        "quantity": 1,
        "quantityScale": "anchor_line_quantity",
        "extendAccessMethod": { "daysAfterPeriodEnd": 20 },
        "style": "INFO",
        "billOncePerInvoice": true,
        "formula": "const nfc = {accessMethods}.filter((a) => a.type === \"NFC\" && a.status === \"ACTIVE\");\nreturn nfc.slice(0, 1).map((a) => ({ quantity: 0, unitPrice: 0, accessMethodValue: a.value, description: `Toegangsmethode inclusief: ${a.label}` }));"
      },
      {
        "productId": "prd_nfc_toeslag",
        "quantity": 1,
        "quantityScale": "anchor_line_quantity",
        "extendAccessMethod": { "daysAfterPeriodEnd": 20 },
        "billOncePerInvoice": true,
        "formula": "const nfc = {accessMethods}.filter((a) => a.type === \"NFC\" && a.status === \"ACTIVE\");\nreturn nfc.slice(1).map((a) => ({ quantity: 1, accessMethodValue: a.value, description: `Toeslag extra toegangsmethode: ${a.label}` }));"
      },
      {
        "productId": "prd_meterhuur",
        "quantity": 1,
        "quantityScale": "anchor_line_quantity",
        "formula": "return {meters}.filter((m) => m.provider === \"ICY\" && m.type === \"ELECTRICITY\" && m.icyMetadata?.switchState === true).map((m) => ({ quantity: 1, description: `Huur digitale elektriciteitsmeter ${m.name}` }));"
      },
      {
        "productId": "prd_hond",
        "quantity": 1,
        "quantityScale": "anchor_line_quantity",
        "billOncePerInvoice": true,
        "formula": "const dogs = Math.max(0, Math.floor(Number({customer.customFields.animals.dogs}) || 0));\nreturn dogs === 0 ? false : [{ quantity: dogs, description: `Honden (${dogs})` }];"
      }
    ]
  }
}

Vezi șiCopiază linkul către această secțiune