Käytetään yrityksen taloushallinnon velvoitteiden tilan seurantaan tietyltä kaudelta:
Sisältää ALV-ilmoitukset, ALV-yhteenveto ja täsmäytykset.
Resurssi: financialobligationstatus.nv
HTTP-metodi: GET
Kutsussa käytettävät parametrit
Parametri | Ilmentymiä | Kuvaus | Esimerkki |
StartMonth | 0...1 | Haun alkukuukausi. Vuosi 2000–2100. Oletus: edellinen kuukausi. | 2024-11 |
EndMonth | 0...1 | Haun loppukuukausi (sisältyvä). Maksimiväli 24 kuukautta. | 2024-11 |
Vastaus:
Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
root | Root | Aggregaatti | 1 | ||
1 | ResponseStatus | Aggregaatti | 1 | ||
1 | FinancialObligationStatus | Aggregaatti | 1 | Varsinainen vastausdata (Payload). |
|
2 | StartMonth | Merkkijono | 1 | Haun alkukuukausi muodossa YYYY-MM. | 2024-11 |
2 | EndMonth | Merkkijono | 1 | Haun loppukuukausi muodossa YYYY-MM. | 2024-11 |
2 | Months | Aggregaatti | 1 | kuukausikohtainen tieto |
|
3 | Month | Aggregaatti | 1...n | Yksittäisen kuukauden kooste. |
|
Attr. | Period | Merkkijono | 1 | Kausi (YYYY-MM). | 2024-11 |
4 | VATReport | Aggregaatti | 1 | ALV-ilmoituksen tiedot. Itsesulkeutuva, jos ei tietuetta. |
|
5 | FilingDate | Päivämäärä | 0...1 | Päivä, jolloin ALV-ilmoitus on jätetty (yyyy-MM-dd). | 2024-12-10 |
5 | Status | Merkkijono | 0...1 | Ilmoituksen tila | Katso tilat omasta taulukosta VATReport Status values |
5 | TaxPeriod | Merkkijono | 0...1 | ALV-ilmoitusjakso | Month, Quarter, Year |
5 | PayableAmount | Numeerinen | 0...1 | Maksettavan veron määrä (0.00). | 1250.00 |
4 | Reconciliations | Aggregaatti | 1 | Reskontrien täsmäytystiedot. Aina mukana. |
|
5 | PurchaseLedger / SalesLedger | Aggregaatti | 1 | Reskontran täsmäytyslohko. |
|
6 | DeviatingVouchers | Numeerinen | 1 | Poikkeavien tositteiden lukumäärä. | 2 |
6 | DeviatingPayments | Numeerinen | 1 | Poikkeavien maksujen lukumäärä | 2 |
6 | SourceEndBalance | Numeerinen | 1 | Reskontran loppusaldo kuukauden lopussa. | 4800.00 |
6 | BookkeepingEndBalance | Numeerinen | 1 | Kirjanpidon loppusaldo | 1500.00 |
2 | Years | Aggregaatti | 1 | Wrapperi vuosikohtaisille tiedoille. |
|
3 | Year | Aggregaatti | 1...n | Kalenterivuoden kooste |
|
Attr. | Value | Merkkijono | 1 | Kalenterivuosi (YYYY). | 2024 |
4 | VATSummaryReport | Aggregaatti | 1 | Yhteenvetoilmoituksen tiedot. |
|
5 | Period | Merkkijono | 0...1 | Viimeisin lähetetty yhteenveto | 2024-10 |
5 | Status | Merkkijono | 0...1 | Lähetyksen tila | Sent, MarkedAsSent |
5 | TotalAmount | Numeerinen | 0...1 | Yhteenlaskettu rivisumma, jos ei ole rivejä palautuu 0.00 | 1200.00 |
4 | IncomeTaxReport | Aggregaatti | 1 | Tuloveroilmoituksen tila | Sent/Unsent |
5 | FiscalYear | Aggregaatti | 1 | Tilikauden tila (esim. Open, Locked). |
|
5 | Status | Merkkijono | 1 | Tila on 'Lähetetty', mikäli kyseiselle vuodelle on olemassa hyväksytty tuloveroilmoitus; muutoin 'Lähettämätön | Sent, unsent |
4 | FiscalYearStatus | Aggregaatti | 1 | kts taulukko FiscalYearStatus Status values | |
5 | Year | Merkkijono | 1 | Kalenterivuosi | 2024 |
5 | Status | Status | 1 | tila. | Open |
VATReport Status -arvot:
Value | Kuvaus |
Errorneous | ALV-ilmoituksessa tapahtui virhe lähetyksen aikana. Vaatii korjaustoimenpiteitä. |
Sent | ALV-ilmoitus on lähetetty onnistuneesti sähköisesti. |
MonthsFirst | Kuukauden ensimmäinen muodostettu ilmoitus. |
Replacing | Korvaava ilmoitus, joka korvaa aiemmin lähetetyn ilmoituksen. |
MarkAsSent | Merkitty manuaalisesti lähetetyksi — ilmoitus on hoidettu Netvisorin ulkopuolella (esim. ilmoitettu suoraan OmaVerossa). |
FiscalYearStatus -arvot:
Value | Meaning (Kuvaus) |
Open | Tilikausi on avoinna kirjauksille. |
Locked | Kausi on lukittu — muutokset eivät ole sallittuja ilman lukituksen avaamista. |
Sealed | Kausi on suljettu (päätetty). Vahvempi tila kuin lukittu. |
Validated | Kirjanpitäjä on tarkastanut ja vahvistanut kauden. |
Audited | Tilikausi on tilintarkastettu. Lopullinen tila. |
SealedUnderGeneration | Välitila — kautta ollaan parhaillaan sulkemassa (tilinpäätöksen muodostus käynnissä). |
Muutoshistoria
Päivämäärä | Muutos | Kuvaus |
29.4.2026 | Uusi resurssi | FinancialObligationStatus.nv julkaistu |