Hausing - Register Laekumised

Hausing - Pealeht

Register

<data> element peab sisaldama:

• register="IPVc"

Toetatud väljad

Päis

Field Name	Kasutajaliidese nimi	Description	Kirjeldus	Kohustuslik	Field type	Max Length	Kommentaar
Comment	Kommentaar	String	kirjeldus		M4Str	60
PayMode	Tasumisviis	Code String	Tasumisviis	+	M4Code	2
PayCurCode	Valuuta	Value 2 or 3 Decimals	Valuuta		M4Val	0	Kui on antud, kirjutab üle kõikide ridade valuutad
TransDate	Kande kp.	In Dataformat Order	kande kuupäev		M4Date	0	Kui puudub siis tänane kuupäev. NB! Peab sobima arvele, ehk ei tohi arvest varasemat kuupäeva sisestada.
OKFlag	Kinnita	Small Value with No Decimals	Kinnitatud linnuke	+	M4Int	0

Maatriks

Field Name	Kasutajaliidese nimi	Description	Kirjeldus	Kohustuslik	Field type	Max Length	Kommentaar
stp		Small Value with No Decimals	Rea tüüp: 1 = tavaline 2 = Muutusmärk 3 = parandusmärk	+	M4Int	0	Hetkel ainult 1 = tavaline on toetatud
ovst		Small Value with No Decimals	Tühistatud rida jah=1/ei=0		M4Int	0	Ei ole kohustuslik, vaikimisi alati 0
InvoiceNr	Arve nr.	Value with No Decimals	Arve nr	+	M4Long	0	Peab olema täidetud siis kui puudub Ettemaksu nr. ja vastupidi.
PayDate	Tasumise kp.	In Dataformat Order	Laekumise kuupäev		M4Date	0
CustCode	Klient	Code String	kliendikood	+	M4Code	20	Peab vastama antud arvele.
RecVal	Saadud summa	Value 2 or 3 Decimals	Saadud summa		M4Val	0	Kui puudub, võetakse arve kogu summa. Ridade asetamisel arvutatakse ka Laekumise "Kokku" summat automaatselt.
CUPNr	Ettemaksu nr.	Value with No Decimals	Ettemaksu nr		M4Long		Peab olema täidetud siis kui puudub Arve nr. ja vastupidi.
VATCode	KM-k	Code String	Käibemaksukood		M4Code		Peab olema täidetud siis kui antud Ettemaksu nr.

Näidis XML päring

<?xml version="1.0" encoding="UTF-8"?>
<data register="IPVc" method="create" sequence="106357" systemversion="8.4.20.504">
  <IPVc>
    <PayMode>P</PayMode>
    <OKFlag>0</OKFlag>
    <Comment>This is comment</Comment>
    <PayCurCode>USD</PayCurCode>
    <rows>
      <row rownumber="0">
        <stp>1</stp>
        <ovst>0</ovst>
        <InvoiceNr>180010</InvoiceNr>
        <CustCode>101</CustCode>
        <RecVal>20</RecVal>
        <PayDate>2018-08-17</PayDate>
      </row>
    </rows>
  </IPVc>
</data>

Kõigi XML väljade kirjeldused

Päis (Header)

Field Name	Kasutajaliidese nimi	Description	Kirjeldus	Field type	Max Length
SerNr	Nr.	Value with No Decimals	Kande number	M4Long	0
Comment	Kommentaar	String	kirjeldus	M4Str	60
PayMode	Tasumisviis	Code String	Tasumisviis	M4Code	2
OKFlag	Kinnita	Small Value with No Decimals	Kinnitatud linnuke	M4Int	0
CurPayVal	Valuuta	Value 2 or 3 Decimals	Valuuta	M4Val	0
RegDate	Kande kp.	In Dataformat Order	Kande kuupäev	M4Date	0
OKMark		As Bool but displayed as a Checkbox	Sirvi akna kinnituse märk	M4Mark	0
TransDate	Kande kuupäev	In Dataformat Order	kande kuupäev	M4Date	0
Sign		Code String	isik	M4Code	10
ARonTR		Small Value with No Decimals		M4Int	0
ExportedFlag		Small Value with No Decimals	eksporditud	M4Int	0
ReceivedFlag		Small Value with No Decimals	n/a	M4Int	0
RejectedFlag		Small Value with No Decimals	n/a	M4Int	0
RecNumber		String		M4Str	20
Invalid		Small Value with No Decimals	tühistatud	M4Int	0
PayCurCode		Code String	valuuta	M4Code	5
Objects		Capital Characters Only	objektid	M4UStr	60
Prntdf		Small Value with No Decimals		M4Int	0
AuthorizationCode		Capital Characters Only	n/a	M4UStr	20
MachineName		Code String	n/a	M4Code	20
DrawerCode		Code String	n/a	M4Code	5
RegTime		Hour:Min:Secs	salvestamise kellaaeg	M4Time	0
IPBookVAT		Small Value with No Decimals		M4Int	0
OfficialSerNr		String	ametlik numbriseeria	M4Str	100
OfficialSerNr2		String	ametlik numbriseeria	M4Str	100
Status		Int represented by a Set of String	hetkeseis	M4Set	361
BranchID		Code String	n/a	M4Code	20
TerminalID		String	n/a	M4Str	60
OfficialSerNrSerie		String	ametliku numbri numbriseeria	M4Str	30

Maatriks (Rows)

Field Name	Kasutajaliidese nimi	Description	Kirjeldus	Field type	Max Length
stp		Small Value with No Decimals	Rea tüüp: 1 = tavaline 2 = Muutusmärk 3 = parandusmärk	M4Int	0
ovst		Small Value with No Decimals	Tühistatud rida jah/ei	M4Int	0
InvoiceNr	Arve nr.	Value with No Decimals	Arve nr	M4Long	0
PayDate	Tasumise kp.	In Dataformat Order	Laekumise kuupäev	M4Date	0
CustCode	Klient	Code String	kliendikood	M4Code	20
latedays		Value with No Decimals	hilinenud päevi	M4Long	0
CustName	Tekst	String	kliendi nimi	M4Str	200
CUPNr	Ettemaksu number	Value with No Decimals	Ettemaksu number	M4Long	0
ChequeNr	Tsheki number	Value with No Decimals	Tsheki number	M4Long	0
VATVal		Value 2 or 3 Decimals	KM valuuta	M4Val	0
VATCode	KM-k	Code String	KM kood	M4Code	10
InvOutstand	Tasumata summa	Value 2 or 3 Decimals	Arve tasumata summa	M4Val	0
InvCurncy	A.val	Code String	Arve valuuta	M4Code	5
InvVal	Arve summa	Value 2 or 3 Decimals	Arve summa	M4Val	0
PayMode	Tas. viis	Code String	Tasumisviis	M4Code	2
BankCurncy	P. val.	Code String	Panga valuuta	M4Code	5
BankVal	Panga sum.	Value 2 or 3 Decimals	Panga summa	M4Val	0
RecCurncy	S.val	Code String	Saadud valuuta	M4Code	5
RecVal	Saadud summa	Value 2 or 3 Decimals	Saadud summa	M4Val	0
BankFeeVal		Value 2 or 3 Decimals	Panga teenustasu valuuta	M4Val	0
RoundOff		Value 2 or 3 Decimals	ümardamine	M4Val	0
RoundOffAcc		Code String	Ümardamise konto	M4Code	10
Objects	Objektid	Capital Characters Only	objektid	M4UStr	60
Coef		Value with 6 Decimals	n/a	M4Rate	0
BankFeePrc			n/a		20
TAX1Sum		Value 2 or 3 Decimals		M4Val	0
OrderNr	Tellimuse nr.	Value with No Decimals	tellimuse nr	M4Long	0
Comment		String	kirjeldus	M4Str	60
B1BankVal	Panga summa BV 1	Value 2 or 3 Decimals	baasvaluuta 1 summa	M4Val	0
B2BankVal	Panga summa BV 2	Value 2 or 3 Decimals	baasvaluuta 2 summa	M4Val	0
ToRateB1BankVal	Baaskurss 1	Value with 6 Decimals	baasvaluuta kurss	M4Rate	0
ToRateB2BankVal	Baaskurss 2	Value with 6 Decimals	baasvaluuta kurss	M4Rate	0
rkRecNumber		String	riigikassa	M4Str	40
ARAcc		Code String		M4Code	10
TAX2Prc		Value with 2 or 3 Decimals		M423Val	0
CredManNr		Value with No Decimals		M4Long	0
SuggestVal		Value 2 or 3 Decimals		M4Val	0
InstNr		Value with No Decimals		M4Long	0
WriteOffAcc		Code String	lootusetult laekuvate arvete konto	M4Code	10
FrRateBankVal		Value with 6 Decimals		M4Rate	0
BaseRate1BankVal	BV-e 1	Value with 6 Decimals	baasvaluuta summa	M4Rate	0
BaseRate2BankVal	BV-e 2	Value with 6 Decimals	baasvaluuta summa	M4Rate	0
TaxTemplateCode		Capital Characters Only	maksumaatriksi kood	M4UStr	60
TaxMatrix		Packed Matrix, base64 data	maksumaatriks	M4PackedMatrix	0

Näidis XML päring

<?xml version="1.0" encoding="UTF-8"?>
<data register="IPVc" sequence="5949" systemversion="8.4.21.1518">
   <IPVc>
      <SerNr>180001</SerNr>
      <Comment>Arveldusarve</Comment>
      <PayMode>P</PayMode>
      <OKFlag>1</OKFlag>
      <CurPayVal>36.00</CurPayVal>
      <RegDate>2018-01-23</RegDate>
      <OKMark>1</OKMark>
      <TransDate>2018-01-23</TransDate>
      <Math />
      <Sign>TANEL</Sign>
      <ARonTR>0</ARonTR>
      <ExportedFlag>0</ExportedFlag>
      <ReceivedFlag>0</ReceivedFlag>
      <RejectedFlag>0</RejectedFlag>
      <RecNumber />
      <Invalid>0</Invalid>
      <PayCurCode>EUR</PayCurCode>
      <Objects />
      <Prntdf>0</Prntdf>
      <AuthorizationCode />
      <MachineName />
      <DrawerCode />
      <RegTime>09:45:18</RegTime>
      <IPBookVAT>1</IPBookVAT>
      <OfficialSerNr />
      <OfficialSerNr2 />
      <Status>-</Status>
      <BranchID />
      <TerminalID />
      <OfficialSerNrSerie />
      <rows>
         <row rownumber="0">
            <stp>1</stp>
            <ovst>0</ovst>
            <InvoiceNr>180001</InvoiceNr>
            <PayDate>2018-01-23</PayDate>
            <CustCode>2</CustCode>
            <latedays />
            <CustName>Uus kontakt, Kostja testib</CustName>
            <CUPNr />
            <ChequeNr />
            <VATVal>6.00</VATVal>
            <VATCode>1</VATCode>
            <InvOutstand>36.00</InvOutstand>
            <InvCurncy>EUR</InvCurncy>
            <InvVal>36.00</InvVal>
            <PayMode />
            <BankCurncy>EUR</BankCurncy>
            <BankVal>36.00</BankVal>
            <RecCurncy>EUR</RecCurncy>
            <RecVal>36.00</RecVal>
            <BankFeeVal />
            <RoundOff />
            <RoundOffAcc />
            <Objects />
            <Coef />
            <BankFeePrc />
            <TAX1Sum />
            <OrderNr />
            <Comment />
            <B1BankVal />
            <B2BankVal />
            <ToRateB1BankVal />
            <ToRateB2BankVal />
            <rkRecNumber />
            <ARAcc>1210</ARAcc>
            <TAX2Prc />
            <CredManNr />
            <SuggestVal />
            <InstNr />
            <WriteOffAcc />
            <FrRateBankVal />
            <BaseRate1BankVal />
            <BaseRate2BankVal />
            <TaxTemplateCode />
            <TaxMatrix />
            <InvoiceOfficialSerNr />
         </row>
      </rows>
   </IPVc>
</data>

Ettemaks

Juhul kui laekunud summat ei seota konkreetse arvega, või laekub rohkem kui arve summa on, saadetakse arvega mitteseotav summa eraldi laekumise reana.

Ettemaksunumber võib olla kliendikood, st see ei pea olema iga kord erinev.

Standard Booksi sees ei tohi olla Moodul Müügiarved > Seadistused > Lausendamine, Müük peal linnukest “Kohustuslikud unikaalsed ettemaksunumbrid (vaikimisi see peal ei ole).

Laekumise real peavad Ettemaksu korral olema minimaalselt täidetud:

Field Name	Kasutajaliidese nimi	Kirjeldus
stp		Reatüüp. Ettemaksu puhul väärtuseks: 0
CustCode	Klient	Kliendikood
RecVal	Summa	Ette makstud summa
CUPNr	Ettemaksu nr.	Kokkuleppeliselt kliendi kood
VATCode	KM-kood	Käibemaksukood

Kui arve seotakse ettemaksuga, siis saadetakse see info Standard Booksi Laekumiste registrisse kahe reana:

Row	Field Name	Kasutajaliidese nimi	Kirjeldus
1	stp		Reatüüp. Ettemaksu puhul väärtuseks: 0
1	InvoiceNr	Arve nr.	Arve, mis seotakse ettemaksuga.
1	CustCode	Klient	Kliendikood
1	RecVal	Summa	Kinni kantav summa (Positiivse märgiga)
2	stp		Reatüüp. Ettemaksu puhul väärtuseks: 0
2	CustCode	Klient	Kliendikood
2	RecVal	Summa	Kinni kantav summa (Negatiivse märgiga)
2	CUPNr	Ettemaksu nr.	Kokkuleppeliselt kliendi kood
2	VATCode	KM-kood	Käibemaksukood

Tulemuseks on see, et arvele tekib laekumine ja ettemaksu saldot vähendatakse kinnikantava summa ulatuses. Ettemaksu võib kinni kanda ka osaliselt, nt kui ettemaks on 100 eurot, arve summa aga ainult 80. Nii jääb 20 veel ettemaksuna üles.