Create Sales Invoice

Create Sales Invoice v1
Create Sales Invoice v2

V2 should be used when willow dimensions ase used.

Endpoints v1

Estonia: https://aktiva.merit.ee/api/v1/sendinvoice
Poland: https://program.360ksiegowosc.pl/api/v1/sendinvoice

Query Payload

Example payload 1: payload only

Example payload 2: PHP example with sending

Field	Type	Comment
Customer	CustomerObject
AccountingDoc	Int 1	Values: 1 faktura, 2 rachunek, 3 paragon, 4 nodoc, 5 credit, 6 prepinvoice, 7 fincchrg, 8 delivorder, 9 grpinv
ProcCodes	Array of Strings	Poland only. Values: SW, EE, TP, TT_WNT, TT_D, MR_T, MR_UZ, I_42, I_63, B_SPV, B_SPV_DOSTAWA, B_MRV_PROWIZJA, MPP, WSTO_EE, IED
PolDocType	Int	Poland only. Values: 1-RO, 2 - WEW, 3 - FP, 4 - OJPK
DocDate	Date
DueDate	Date
TransactionDate	Date
InvoiceNo	Str 35	Required
RefNo	Str 36	If not specified, generated automatically. Please validate this number yourself.
CurrencyCode	Str 4
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 InvoiceRow objects
TaxAmount	Array of VAT objects	Required
RoundingAmount	Decimal 18.2	Use it for getting PDF invoice to round number. Does not affect TotalAmount.
TotalAmount	Decimal 18.2	Amount without VAT
Payment	Payment object
Hcomment	String 4K	If not specified, API will get it from client record, if it is written there.
Fcomment	String 4K	If not specified, API will get it from client record, if it is written there.
ContractNo	String 35	Contract number with operator
PDF	String 4K	Pdf file in Base64 format

CustomerObject

3 use cases:

new customer – you will create new client record when this name was not found
existing customer by name – if this name exists in our system, Merit will take info from client record instead of reading it from the payload.
customer by ID – every time you add new customer, the CustomerId is returned, you can use this ID instead of name, the object = { CustomerId: <guid-of-the-customer }.

Parameter	Type	Comment
Id	Guid	If 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 150	Required when customer is added
RegNo	Str 30
NotTDCustomer	Bool	Required when customer is added. EE True for physical persons and foreign companies. PL True for physical persons. Allowed “true” or “false” (lowercase).
VatRegNo	Str 30
CurrencyCode	Str 30
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
SalesInvLang	Str 8	Invoice language for this specific customer.(ET, EN, RU,FI,PL,SV)
RefNoBase	Str 36
EInvPaymId	Str 20
EInvOperator	Int	1 - Not exist, 2 - E-invoices to the bank through Omniva, 3 - Bank ( full extent E-invoice), 4- Bank (limited extent E-invoice)
BankAccount	Str 50
Contact	Str 35
ApixEinv	Str 20
GroupInv	Bool

InvoiceRowObject

Every invoice has its rows. Row has its quantity and price, it also has its general ledger record and that’s why it has its own tax calculation.

Field	Type	Comment
Item	ItemObject	Sometimes 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.
Quantity	Decimal 18.3
Price	Decimal 18.7	If there is no price field, the price is searched from the sales price table
DiscountPct	Decimal 18.2
DiscountAmount	Decimal 18.2	Amount * Price * (DiscountPCt / 100). This is not rounded. Will be substracted from row amount before row roundings.
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.
ItemCostAmount	Decimal 18.2	Required for credit invoices when crediting stock items.
GLAccountCode	String 10	If used, must be found in the company database.
ProjectCode	String 20	If used, must be found in the company database.
CostCenterCode	String 20	If used, must be found in the company database.
VatDate	Date String	YYYYMMDD type date. In some countries where you have to specify VatDate.

ItemObject

Field	Type	Comment
Code	Str 20	Required
Description	Str 150	Required More than 150 characters will be cut off
Type	Int	1 = stock item, 2 = service, 3 = item. Required.
UOMName	Str 64	Name for the unit
DefLocationCode	Str 20	If company has more than one (default) stock, stock code in this field is required for all stock items.
GTUCode	Int	Poland only, values: 1...13

PaymentObject

You can mark the invoice already paid. This is useful when you create invoice only when internet bank payment is successful, or you have received cash.

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

TaxObject

Every invoice has section of taxes. Those taxes have to be calculated grouped and summed by TaxId. Every row has its own tax calculation, you have to group and sum them up.

This is because you can have different tax rates for different articles.

API always counts it as well to assure you have correct calculation.

Field	Type	Comment
TaxId	Guid	Required. Use gettaxes endpoint to detect the guid needed
Amount	Decimal 18.2

Endpoints v2

Estonia: https://aktiva.merit.ee/api/v2/sendinvoice
Poland: https://program.360ksiegowosc.pl/api/v2/sendinvoice