Taloushallinnon velvoitteiden tilan nouto financialobligationstatus.nv

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

Oliko tästä vastauksesta apua? Kyllä Ei

Send feedback