API / ZALKTIS

Rēķinu nolasīšana

Atgriež konkrētajam API tokenam piesaistītā namsaimnieka rēķinus Zalktis XML formātā.

GEThttps://nextevohomes.lv/api/v1/zalktis/invoices

Query parametri

Parametrs	Tips	Obligāts	Apraksts
`date_from`	date	Jā	Izrakstīšanas datums no, ieskaitot. Formāts `YYYY-MM-DD`.
`date_to`	date	Jā	Izrakstīšanas datums līdz, ieskaitot. Formāts `YYYY-MM-DD`.

Maksimālais viena pieprasījuma intervāls: 366 dienas.

Filtrēšana ir pēc rēķina izrakstīšanas datumadate_from un date_to tiek salīdzināti ar rēķina issue_date, nevis pakalpojumu/rēķina periodu.

Pieprasījuma piemērs

curl \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/xml" \
  "https://nextevohomes.lv/api/v1/zalktis/invoices?date_from=2026-08-17&date_to=2026-08-17"

Atlases noteikumi

Tiek atlasīti tikai tokenam piesaistītā namsaimnieka rēķini.
draft un cancelled statusa rēķini netiek iekļauti.
Katrs rēķins pirms XML izveides iziet to pašu kontējumu validāciju, ko manuālais Zalktis eksports.
Ja kaut viens atlasītais rēķins nav derīgs eksportam, API neatgriež daļēju XML — tiek atgriezts 422.
Ja atlasē nav rēķinu, tiek atgriezts 200 ar korektu XML bez <Dokuments> elementiem.

Veiksmīga atbilde

HTTP/2 200
Content-Type: application/xml; charset=utf-8

<?xml version="1.0" encoding="utf-8"?>
<Root>
    <FailaPase>
        <Pamats>Zalktis</Pamats>
        <DatuAvots>Nextevo Homes</DatuAvots>
        ...
    </FailaPase>
    <Dokuments>
        <HronoDocName>Rēķins</HronoDocName>
        <HronoDocNr>123/2608</HronoDocNr>
        ...
    </Dokuments>
</Root>

Validācijas kļūda

HTTP/2 422
Content-Type: application/json; charset=utf-8

{
  "error":"invoice_validation_failed",
  "message":"123/2608: Klientam nav personas koda/reģistrācijas numura."
}