Create Recurring Invoice

Endpoints:

https://aktiva.meritaktiva.fi/api/v2/sendperinvoice

Query Payload

FieldTypeComment
CustomerCustomerObject
CodeStr
DepartmentCodeStr 20
InvoiceNoStr 35
StartDateDate
EndDateDate
CurrencyIdInt
CurrencyCodeStr 4
CurrencyRateDec 18.7
HCommentStr 4K
FCommentStr 4K
NextDateDate
Cycleint1-month, 2-quarter of a year , 3- year, 4-week
Periodint2-current period, 3-next period, 4-for the next period, 5-for previous period, 6-current period, less number of cycles
PaymentDayint
PaymentMonthint
ReferenceNoStr
PriceInclVatbool
RoundingPrecint
RoundingAmountDec 18.2
TotalAmountDec 18.2
TotalSumDec 18.2
PerLenInt
DimensionsArray of Dimensions objects
InvoiceRowArray of InvoiceRow objects
TaxAmountArray of VAT objects
PayerPayerObject

CustomerObject

FieldTypeComment
IdGuidIf filled and customer is found in the database then following fields are not important. If not found, the customer is added using the following fields.
Name Str 150Required when customer is added
RegNoStr 30
NotTDCustomerBoolRequired when customer is added. EE True for physical persons and foreign companies. PL True for physical persons. Allowed “true” or “false” (lowercase).
VatRegNoStr 30
CurrencyCodeStr 30
PaymentDeadLineIntIf missing then taken from default settings.
OverDueChargeDecimal 5.2If missing then taken from default settings.
RefNoBaseStr 36
AddressStr 100
CountryCodeStr 2Required when adding
CountyStr 100
CityStr 30
PostalCodeStr 15
PhoneNoStr 50
PhoneNo2Str 50
HomePageStr 80
EmailStr 80
SalesInvLangStr 8Invoice language for this specific customer.(ET,EN,RU,FI,PL,SV)
ContactStr 35
GLNCodeStr 10
PartyCodeStr 20
EInvOperatorInt1 - Not exist, 2 - E-invoices to the bank through Omniva, 3 - Bank ( full extent E-invoice), 4- Bank (limited extent E-invoice)
EInvPaymIdStr 20
BankAccountStr 50
DimensionsArray of DimensionsObjects
CustGrCodeStr 20
ShowBalanceBool
ApixEinvStr 20
GroupInvBool

InvoiceRowObject

FieldTypeComment 
ItemItemObjectSometimes the volume of transactions in the sales software is very high and there is no need to duplicate all the data in accounting. In those cases, you could consider using the same item code for the items with the same VAT rate.

Items with different VAT rates must have a different item codes.

Also, for the VAT declarations to work, goods and services may not be summed up and must have different item codes.
QuantityDecimal 18.3
PriceDecimal 18.7
DiscountPctDecimal 18.2
DiscountAmountDecimal 18.2Amount * Price * (DiscountPCt / 100). This is not rounded. Will be substracted from row amount before row roundings.
TaxIdGuidRequired. Use gettaxes endpoint to detect the guid needed
LocationCodeStr 20Used for stock items and multiple stocks. If used then must be found in the company database.
DepartmentCodeStr 20If used then must be found in the company database.
GLAccountCodeString 10If used, must be found in the company database.
DimensionsArray of DimensionsObjects
ItemCostAmountDecimal 18.2Required for credit invoices when crediting stock items.
VatDateDate StringYYYYMMDD type date. In some countries where you have to specify VatDate.
SalesAccCodeString 10If included GLAccountCode then the SalesAccCode not used
PurchaseAccCodeString 10
InventoryAccCodeString 10
CostAccCodeString 10

ItemObject

FieldTypeComment
CodeStr 20Required
DescriptionStr 100Required
TypeInt1 = stock item, 2 = service, 3 = item. Required.
UOMNameStr 64Name for the unit
DefLocationCodeStr 20If company has more than one (default) stock, stock code in this field is required for all stock items.

TaxObject

FieldTypeComment 
TaxIdGuidRequired. Use gettaxes endpoint to detect the guid needed
AmountDecimal 18.2

DimensionsObject

FieldTypeComment
DimIdInt
DimValueIdGuid
DimCodeStr

PayerObject

FieldTypeComment
IdGuidIf filled and payer (customer) is found in the database then following fields are not important. If not found, the payer is added using the following fields.
Name Str 150Required when payer is added
RegNoStr 30
NotTDCustomerBoolRequired when payer is added. True for physical persons and foreign companies. Allowed “true” or “false” (lowercase).
VatRegNoStr 30
CurrencyCodeStr 30
PaymentDeadLineIntIf missing then taken from default settings.
OverDueChargeDecimal 5.2If missing then taken from default settings.
RefNoBaseStr 36
AddressStr 100
CountryCodeStr 2Required when adding
CountyStr 100
CityStr 30
PostalCodeStr 15
PhoneNoStr 50
PhoneNo2Str 50
HomePageStr 80
EmailStr 80
SalesInvLangStr 8Invoice language for this specific payer.(ET,EN,RU,FI,PL,SV)
ContactStr 35
GLNCodeStr 10
PartyCodeStr 20
EInvOperatorInt1 - Not exist, 2 - E-invoices to the bank through Omniva, 3 - Bank ( full extent E-invoice), 4- Bank (limited extent E-invoice)
EInvPaymIdStr 20
BankAccountStr 50
DimensionsArray of DimensionsObjects
CustGrCodeStr 20
ShowBalanceBool