Endpoints
Estonia: https://aktiva.merit.ee/api/v1/sendpurchinvoicePoland: https://program.360ksiegowosc.pl/api/v1/sendpurchinvoice
This endpoint creates document and general ledger records without any confirmation. If you need solution where book keepers are approving puchase orders and expanse claims, use different endpoint: sendpurchorder .
Query Payload
Example payload1: Example create
Example payload2: Example with proportional vat
PurchaseInvoice
Field Type Comment
Vendor VendorObject
ExpenseClaim bool If false, it indicates a normal purchase invoice. If true, the purchase invoice is handled as presented by responsible employee for expense claim.
DocDate Date
DueDate Date
BillNo Str 35
RefNo Str 36
BankAccount Str 50
CurrencyCode Str 4
CurrencyRate Decimal 18.7
DepartmentCode Str 20 If used then must be found in the company database.
ProjectCode Str 20 If used then must be found in the company database.
InvoiceRow Array of InvoiceRowObjects
TaxAmount Array of TaxObjects Required
RoundingAmount Decimal 18.2 Use it for rounding invoice totalsum. Does not affect TotalAmount.
TotalAmount Decimal 18.2 Amount without VAT
Payment Payment object
Hcomment String 4K Comment before invoice rows
Fcomment String 4K Comment after invoice rows
Attachment AttachmentObject
PolDocType int 1 Poland only
VendorObject
Field Type Comment
Id Guid If filled and vendor is found in the database then following fields are not important. If not found, the vendor is added using the following fields.
Name Str 150 Required when vendor is added
RegNo Str 30
VatAccountable Bool Required when vendor is added. Allowed true or false (lowercase).
VatRegNo Str 30
CurrencyCode Str 4
PaymentDeadLine Int If missing then taken from default settings.
OverDueCharge Decimal 5.2 If missing then taken from default settings.
Address Str 100
City Str 30
County Str 100
PostalCode Str 15
CountryCode Str 2 Required when adding
PhoneNo Str 50
PhoneNo2 Str 50
HomePage Str 80
Email Str 80
ItemObject
Field Type Comment
Code Str 20 Required. Must be found in company database.
Description Str 100 Required
Type Int 1 = stock item, 2 = service, 3 = item. Required when item is added
UOMName Str 64 Name for the unit. Required for stock item
DefLocationCode Str 20 If company has more than one (default) stock, stock code in this field is required if the item is a stock item and does not exist yet.
InvoiceRowObject
Field Type Comment
Item ItemObject
Quantity Decimal 18.3
Price Decimal 18.7
TaxId Guid Required. Use gettaxes endpoint to detect the guid needed
LocationCode Str 20 Used for stock items and multiple stocks. If used then must be found in the company database.
DepartmentCode Str 20 If used then must be found in the company database.
GLAccountCode Str 10 General ledger Account code. If used then must be found in the company database
ProjectCode Str 20 If used then must be found in the company database
CostCenterCode Str 20 If used then must be found in the company database
TaxObject
Field Type Comment
TaxId Guid Required. Use gettaxes endpoint to detect the guid needed
Amount Decimal 18.2
PaymentObject
Field Type Comment
PaymentMethod Str 150 Name of the payment method. Must be found in the company database.
PaidAmount Decimal 18.2 Amount with VAT (not more) or less if partial payment
PaymDate Date YYYYmmddHHii
AttachmentObject
Field Type Comment
FileName Str Filename with the extension
FileContent Str PDF In Base64 format
Endpoints
Estonia: https://aktiva.merit.ee/api/v2/sendpurchinvoicePoland: https://program.360ksiegowosc.pl/api/v2/sendpurchinvoice
Query Payload
Field Type Comment
Vendor VendorObject
ExpenseClaim bool If false, it indicates a normal purchase invoice. If true, the purchase invoice is handled as presented by responsible employee for expense claim.
DocDate Date
DueDate Date
TransactionDate Date
BillNo Str 35
RefNo Str 36
CurrencyCode Str 4
CurrencyRate Decimal 18.7
DepartmentCode Str 20 If used then must be found in the company database.
Dimensions Array of dimensions objects If used then must be found in the company database.
InvoiceRow Array of InvoiceRowObjects
TotalAmount Decimal 18.2 Amount without VAT
RoundingAmount Decimal 18.2 Use it for rounding invoice totalsum. Does not affect TotalAmount.
TaxAmount Array of TaxObjects Required
Payment Payment object
Hcomment String 4K Comment before invoice rows
Fcomment String 4K Comment after invoice rows
Attachment AttachmentObject
BankAccount Str 50
Receiver ReceiverObject
KsefNumber Str 36 Ksef invoice number Poland only
Vendor Object
Field Type Comment
Id Guid If filled and vendor is found in the database then following fields are not important. If not found, the vendor is added using the following fields.
Name Str 150 Required when vendor is added
RegNo Str 30
VatAccountable Bool Required when vendor is added. Allowed true or false (lowercase).
VatRegNo Str 30
CurrencyCode Str 4
PaymentDeadLine Int If missing then taken from default settings.
OverDueCharge Decimal 5.2 If missing then taken from default settings.
Address Str 100
City Str 30
County Str 100
PostalCode Str 15
CountryCode Str 2 Required when adding
PhoneNo Str 50
PhoneNo2 Str 50
HomePage Str 80
Email Str 80
InvoiceRowObject
Field Type Comment
Item Item Object
Quantity Decimal 18.3
Price Decimal 18.7
TaxId Guid Required. Use gettaxes endpoint to detect the guid needed
LocationCode Str 20 Used for stock items and multiple stocks. If used then must be found in the company database.
DepartmentCode Str 20 If used then must be found in the company database.
GLAccountCode Str 10 General ledger Account code. If used then must be found in the company database
Dimensions Array of Dimensions objects If used then must be found in the company database
VatDate Str 20
SalesAccCode Str 10
PurchaseAccCode Str 10 If included GLAccountCode then the PurchaseAccCode not be used
InventoryAccCode Str 10
CostAccCode Str 10
ItemObject
Field Type Comment
Code Str 20 Required. Must be found in company database.
Description Str 100 Required
Type Int 1 = stock item, 2 = service, 3 = item. Required when item is added
UOMName Str 64 Name for the unit. Required for stock item
DefLocationCode Str 20 If company has more than one (default) stock, stock code in this field is required if the item is a stock item and does not exist yet.
DimensionsObject
Field Type Comment
DimId Int
DimValueId Guid
DimCode Str
TaxObject
Field Type Comment
TaxId Guid Required. Use gettaxes endpoint to detect the guid needed
Amount Decimal 18.2
PaymentObject
Field Type Comment
PaymentMethod Str 150 Name of the payment method. Must be found in the company database.
PaidAmount Decimal 18.2 Amount with VAT (not more) or less if partial payment
PaymDate Date YYYYmmddHHii
AttachmentObject
Field Type Comment
FileName Str Filename with the extension
FileContent Str PDF In Base64 format
ReceiverObject
Field Type Comment
Id Guid If filled and receiver (vendor) is found in the database then following fields are not important. If not found, the receiver is added using the following fields.
Name Str 150 Required when receiver is added
RegNo Str 30
VatAccountable Bool Required when receiver is added. Allowed “true” or “false” (lowercase).
VatRegNo Str 30
CurrencyCode Str 4
PaymentDeadLine Int If missing then taken from default settings.
OverDueCharge Decimal 5.2 If missing then taken from default settings.
Address Str 100
City Str 30
County Str 100
PostalCode Str 15
CountryCode Str 2 Required when adding
PhoneNo Str 50
PhoneNo2 Str 50
HomePage Str 80
Email Str 80
Successful Result
VendorId BillId BillNo RefNo BatcInfo
