Hausing - Register Laekumised: erinevus redaktsioonide vahel

Allikas: Excellent || Opendoc
Mine navigeerimisribale Mine otsikasti
 
(ei näidata 3 kasutaja 6 vahepealset redaktsiooni)
17. rida: 17. rida:
!Field type
!Field type
!Max Length
!Max Length
!Kommentaar
|-
|-
|Comment
|Comment
25. rida: 26. rida:
|M4Str
|M4Str
|60
|60
|
|-
|-
|PayMode
|PayMode
33. rida: 35. rida:
|M4Code
|M4Code
|2
|2
|
|-
|-
|CurPayVal
|PayCurCode
|Valuuta
|Valuuta
|Value 2 or 3 Decimals
|Value 2 or 3 Decimals
41. rida: 44. rida:
|M4Val
|M4Val
|0
|0
|Kui on antud, kirjutab üle kõikide ridade valuutad
|-
|-
|TransDate
|TransDate
46. rida: 50. rida:
|In Dataformat Order
|In Dataformat Order
|kande kuupäev
|kande kuupäev
| +
|  
|M4Date
|M4Date
|0
|0
|Kui puudub siis tänane kuupäev.
NB! Peab sobima arvele, ehk ei tohi arvest varasemat kuupäeva sisestada.
|-
|-
|OKFlag
|OKFlag
57. rida: 63. rida:
|M4Int
|M4Int
|0
|0
|
|}
|}


68. rida: 75. rida:
!Field type
!Field type
!Max Length
!Max Length
!Kommentaar
|-
|-
|stp
|stp
81. rida: 89. rida:
|M4Int
|M4Int
|0
|0
|Hetkel ainult 1 = tavaline on toetatud
|-
|-
|ovst
|ovst
86. rida: 95. rida:
|Small Value with No Decimals
|Small Value with No Decimals
|Tühistatud rida jah=1/ei=0
|Tühistatud rida jah=1/ei=0
| +
|  
|M4Int
|M4Int
|0
|0
|Ei ole kohustuslik, vaikimisi alati 0
|-
|-
|InvoiceNr
|InvoiceNr
97. rida: 107. rida:
|M4Long
|M4Long
|0
|0
|Peab olema täidetud siis kui puudub Ettemaksu nr. ja vastupidi.
|-
|-
|PayDate
|PayDate
105. rida: 116. rida:
|M4Date
|M4Date
|0
|0
|
|-
|-
|CustCode
|CustCode
110. rida: 122. rida:
|Code String
|Code String
|kliendikood
|kliendikood
|
| +
|M4Code
|M4Code
|20
|20
|Peab vastama antud arvele.
|-
|-
|RecVal
|RecVal
121. rida: 134. rida:
|M4Val
|M4Val
|0
|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 ===
=== Näidis XML päring ===
<syntaxhighlight lang="xml">
<syntaxhighlight lang="xml" line="1">
<?xml version="1.0" encoding="UTF-8"?>
<?xml version="1.0" encoding="UTF-8"?>
<data register="IPVc" sequence="5949" systemversion="8.4.21.1518">
<data register="IPVc" method="create" sequence="106357" systemversion="8.4.20.504">
  <IPVc>
  <IPVc>
      <SerNr>180001</SerNr>
    <PayMode>P</PayMode>
      <PayMode>P</PayMode>
    <OKFlag>0</OKFlag>
      <CurPayVal>36.00</CurPayVal>
    <Comment>This is comment</Comment>
      <TransDate>2018-01-23</TransDate>
    <PayCurCode>USD</PayCurCode>
      <rows>
    <rows>
        <row rownumber="0">
      <row rownumber="0">
            <stp>1</stp>
        <stp>1</stp>
            <ovst>0</ovst>
        <ovst>0</ovst>
            <InvoiceNr>180001</InvoiceNr>
        <InvoiceNr>180010</InvoiceNr>
            <PayDate>2018-01-23</PayDate>
        <CustCode>101</CustCode>
            <CustCode>2</CustCode>
        <RecVal>20</RecVal>
        </row>
        <PayDate>2018-08-17</PayDate>
      </rows>
      </row>
  </IPVc>
    </rows>
  </IPVc>
</data>
</data>


148. rida: 181. rida:
== Kõigi XML väljade kirjeldused ==
== Kõigi XML väljade kirjeldused ==


=== Päis ===
=== Päis ''(Header)'' ===
{| class="wikitable"
{| class="wikitable"
!Field Name
!Field Name
361. rida: 394. rida:
|}
|}


=== Maatriks ===
=== Maatriks ''(Rows)'' ===
{| class="wikitable"
{| class="wikitable"
!Field Name
!Field Name
425. rida: 458. rida:
|-
|-
|CUPNr
|CUPNr
|
|Ettemaksu number
|Value with No Decimals
|Value with No Decimals
|
|Ettemaksu number
|M4Long
|M4Long
|0
|0
|-
|-
|ChequeNr
|ChequeNr
|
|Tsheki number
|Value with No Decimals
|Value with No Decimals
|
|Tsheki number
|M4Long
|M4Long
|0
|0
772. rida: 805. rida:


</syntaxhighlight>
</syntaxhighlight>
== 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:
{| class="wikitable"
!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:
{| class="wikitable"
!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.

Viimane redaktsioon: 5. mai 2023, kell 10:58

Hausing - Pealeht

Register

<data> element peab sisaldama:

  • register="IPVc"

Laekumised hausing.png

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.