API - https://moj.minimax.si/SI/API/Home/ModuleDetails/IssuedInvoicePosting
Opis
Vmesnik je namenjen prenosu prometa dnevnega iztržka in knjiženju izdanih računov. Preko vmesnika so omogočene naslednje funkcionalnosti:
- Branje seznama in posameznih zapisov dnevnih iztržkov in knjiženih računov
- Dodajanje dnevnih iztržkov in knjiženih računov
- Brisanje dnevnih iztržkov in knjiženih računov
- Branje seznama pripadajočih načinov plačil, ki se uporabljajo na knjiženji izdanih računov in dnevnih iztržkov
IssuedInvoicePosting
Spodnja tabela opisuje podatke, ki jih potrebujemo za vnos iztržka oz. za vnos knjiženja izdanega računa.
Podatek | Opis |
DocumentType | Tip dokumenta:
|
Status |
|
Customer | Stranka, obvezen podatek na tipih dokumenta:
Vnese se ID stranke. Stranko izberemo iz šifranta strank, ki ga dobimo s klicem metode GetCustomers. |
DateTransaction | Datum opravljanja, obvezen podatek na tipih dokumenta:
|
DateDue | Datum opravljanja, obvezen podatek na tipu dokumenta:
|
PaymentReference | Veza za plačilo, podatek lahko vnašamo na tipu dokumenta:
|
Analytic | Analitika. Vnese se ID analitike. Analitiko izberemo iz šifranta analitik, ki ga dobimo s klicem metode GetAnalytics. |
Date | Datum. |
Description | Opis. |
Currency | Denarna enota. |
ExchangeRate | Tečaj. |
SalesValue | Prodajna vrednost z DDV. |
SalesValueVat | DDV od prodajne vrednosti. |
PurchaseValue | Nabavna vrednost. |
IssuedInvoicePostingPaymentMethods | Način plačila - podatek lahko vnašamo na tipih dokumenta:
Vnesemo ID načina plačil, ki ga dobimo preko seznama GetIssuedInvoicePostingPaymentMethods |
IssuedInvoicePostingTaxes | Davki na iztržku oz. na knjiženju izdanega računa. |
IssuedInvoicePostingRevenues | Prihodki na iztržku oz. na knjiženju izdanega računa. |
IssuedInvoicePostingPaymentMethods
Načini plačil na iztržku ali za knjiženje izdanega računa.
Podatek | Opis |
PaymentMethod | |
Amount | Znesek |
AmountInDomesticCurrency | Znesek v domači denarni enoti |
Customer | Stranka, lahko vnašamo na tipu dokumenta:
|
AdvancePaymentIssuedInvoicePostingId | Referenca na predplačilo. |
IssuedInvoicePostingTaxes
Podatki za vnos davka na iztržek ali za knjiženje izdanega računa.
Podatek | Opis |
TaxType | Tip davka:
|
TaxSubjectType | |
VatRate | Stopnja DDV, obvezen podatek. Vnese se ID stopnje DDV-ja. Stopnjo DDV izberemo iz šifranta stopenj DDV, ki ga izpišemo s klicem metode GetVatRates. |
TaxPercentage | Davek v procentih. |
TaxBase | Osnova davka. |
TaxAmount | Vrednost davka. |
TaxBaseInDomesticCurrency | Osnova davka v domači denarni enoti. |
TaxAmountInDomesticCurrency | Vrednost davka v domači denarni enoti. |
VatAccountingType | Vrsta obračuna DDV. |
IssuedInvoicePostingRevenues
Prihodki iztržka ali za knjiženje izdanega računa
Podatek | Opis |
Account | Konto, obvezen podatek. Vnese se ID konta. Konto izberemo iz šifranta kontov, ki ga izpišemo s klicem metode GetAccounts. |
Amount | Znesek |
AmountInDomesticCurrency | Znesek v domači denarni enoti |
Primeri
Primeri v nadaljevanju prikazujejo osnovni nabor podatkov za uspešen prenos prometa dnevnega iztržka oz. podatkov za knjiženje izdanega računa.
Pomembno:
Med podatki v JSON zapisih v nadaljevanju so navedeni vzorčni ID-ji, ki jih je pred klicem potrebno zamenjati s pravilnimi ID-ji, ki pripadajo organizaciji in jih dobimo s klicem ustreznih metod.
Vzorčni podatki v primerih:
Customer.ID = 111111
PaymentMethod.ID = 222222
Account.ID = 333333
Iztržek
{
"DocumentType":"IZT",
"Date":"2020-05-19",
"Description":"Opis",
"IssuedInvoicePostingTaxes":[
{
"TaxType":"DDV",
"TaxBase":100.00,
"TaxAmount":22.00,
"VatRate":{
"ID":36
}
},
{
"TaxType":"DDV",
"TaxBase":100.00,
"TaxAmount":9.50,
"VatRate":{
"ID":28
}
}
],
"IssuedInvoicePostingPaymentMethods":[
{
"Amount":231.50,
"PaymentMethod":{
"ID":222222
}
}
],
"IssuedInvoicePostingRevenues":[
{
"Amount":200.00,
"Account":{
"ID":333333
}
}
]
}
Izdan račun, ki je vključen v iztržku
{
"DocumentType":"IRI",
"Date":"2020-05-19",
"Customer":{
"ID":111111
},
"Description":"Opis",
"IssuedInvoicePostingTaxes":[
{
"TaxType":"DDV",
"TaxBase":100.00,
"TaxAmount":22.00,
"VatRate":{
"ID":36
}
},
{
"TaxType":"DDV",
"TaxBase":100.00,
"TaxAmount":9.50,
"VatRate":{
"ID":28
}
}
],
}
Izdan račun
{
"DocumentType":"IRS",
"Date":"2020-05-19",
"DateTransaction":"2020-05-19",
"DateDue":"2020-05-19",
"Customer":{
"ID":8676870
},
"Description":"Opis",
"IssuedInvoicePostingTaxes":[
{
"TaxType":"DDV",
"TaxBase":100.00,
"TaxAmount":22.00,
"VatRate":{
"ID":36
}
},
{
"TaxType":"DDV",
"TaxBase":100.00,
"TaxAmount":9.50,
"VatRate":{
"ID":28
}
}
],
"IssuedInvoicePostingPaymentMethods": [
{
"Amount": 200.00,
"PaymentMethod": {
"ID": 190498
}
}],
"IssuedInvoicePostingRevenues": [{
"Amount": 200.00,
"Account": {
"ID": 7614360
}
}
]
}