Išlaidos

Registruokite pirkimo dokumentus su jų failu, atnaujinkite juos, pakeiskite failą ir atsisiųskite originalą.

Išlaidų dokumentas – tai jūsų gautas pirkimo dokumentas: tiekėjo sąskaita faktūra, kvitas, mokėjimo pranešimas. API saugo jo pagrindinius skaičius ir originalų failą. Kadangi failas keliauja kartu su užklausa, išlaidų galiniai taškai naudoja multipart/form-data, o ne JSON.

Galiniai taškai

GET/expensesList expenses POST/expensesCreate an expense GET/expenses/{expense}Get an expense DELETE/expenses/{expense}Delete an expense PUT/expenses/{expense}Replace an expense POST/expenses/{expense}/fileReplace the expense file GET/expenses/{expense}/downloadDownload the expense file

Laukai

Laukas	Privalomas	Pastabos
`file`	kuriant	Vienas failas. Leidžiami plėtiniai: `pdf`, `jpg`, `jpeg`, `png`, `gif`, `bmp`, `tiff`, `xls`, `xlsx`, `doc`, `docx`, `odf`
`date`	taip	`YYYY-MM-DD`, dokumento data
`total`	taip	Suma su PVM, skaičius
`currency`	taip	Kodas iš `GET /currencies`, pavyzdžiui `EUR`
`seller`	taip	Tiekėjo pavadinimas, iki 255 simbolių
`vat`	ne	PVM suma, skaičius
`invoice_number`	ne	Tiekėjo dokumento numeris

Sukurkite išlaidų dokumentą

curl -X POST https://app.fsaskaita.lt/api/expenses \
  -H "Authorization: Bearer $FSASKAITA_TOKEN" \
  -H "Accept: application/json" \
  -F "[email protected]" \
  -F "date=2026-09-08" \
  -F "total=60.50" \
  -F "vat=10.50" \
  -F "currency=EUR" \
  -F "seller=Telia Lietuva, AB" \
  -F "invoice_number=TL-2026-000123"

Atsakymas:

{
  "data": {
    "id": "2a7d6c1b-8e9f-4a0b-9c1d-2e3f4a5b6c7d",
    "date": "2026-09-08",
    "total": 60.5,
    "currency": "EUR",
    "seller": "Telia Lietuva, AB",
    "created_at": 1757318400,
    "updated_at": 1757318400
  }
}

Atsakyme negrąžinami vat, invoice_number ir failo metaduomenys. Jei jų reikia, saugokite juos savo pusėje; patį failą visada galima atsisiųsti per atsisiuntimo galinį tašką.

Atnaujinimas

PUT /expenses/{id} priima tuos pačius multipart laukus. file čia neprivalomas; jei pateiktas, jis pakeičia saugomą failą. Daug HTTP klientų negali siųsti multipart turinio su PUT. Naudokite PATCH, kuris veikia identiškai, arba siųskite POST su papildomu formos lauku _method=PUT (arba antrašte X-HTTP-Method-Override: PUT), kurį API traktuoja kaip PUT. Jei reikia pakeisti tik failą, naudokite POST /expenses/{id}/file.

Atsisiųskite originalą

curl -L https://app.fsaskaita.lt/api/expenses/$ID/download \
  -H "Authorization: Bearer $FSASKAITA_TOKEN" \
  -H "Accept: application/json" \
  -o receipt.pdf

Atsakymas srautu perduoda saugomą failą su originaliu failo pavadinimu antraštėje Content-Disposition. Turinio tipas atitinka failą.

Šalutiniai efektai

Kūrimas išsiunčia expense.created webhook pranešimą; skaičių ar failo atnaujinimas išsiunčia expense.updated. Šalinimas išsiunčia expense.deleted ir pašalina saugomą failą.