Invoice
Send an invoice to Ropo One via the REST API.
Minimum invoice payload
At minimum, send one dataset item with:
jobtype0= invoice (Embed or Unify service invoice)300= print service (Information logistic invoice from Connect service model)
debtor details (
personorcompany,address,postcode,city,customertype)invoice dates (
billdate,paydate)at least one invoice row (
payrow)
{
"datastream": {
"dataset": [
{
"jobtype": "0",
"person": "Teppo Testaaja",
"address": "Sammonkatu 23-25 A 7",
"postcode": "70100",
"city": "KUOPIO",
"customertype": "2",
"billdate": "2017-03-03",
"paydate": "2017-03-17",
"payrow": [
{
"desc": "Hieronta",
"count": "1",
"itemtype": "h",
"amount": "35.00",
"taxpr": "24.00"
}
]
}
]
}
}Depending on your use case, you can add extra fields and features.
Additional invoice features
Use these when a basic invoice is not enough.
Field
Description
Example
Info
addaddress
Delivery address or additional address to which a copy of the invoice will be sent
address
Address of the recipient
Mäkikatu 12 B 4
addressaddline1
The first accessory card in the contact card prints over the recipient's name
addressaddline2
The second address of the contact card is printed between the name and the street address
addresscountry
The home country of the recipient
FIN
attachment
appendix Documentary
billcode
A reference or message for a payment to be made to the invoice
billdate
Date of invoice in the form of YYYY-MM-DD
2026-02-02
billnum
The current number of the invoice in the accountant's account
billtemplate
Invoice Layout: CUSTOM, ECOM, BOBCAT, INC
CUSTOM
cashbill
Cash receipt, to be paid directly: 1 = cash receipt
1
checkbillnum
Make sure the bill number is unique: 1 = on
1
city
Debtor's post office
collectionprocess
The type of claim to determine collection process in use
company
The name of a corporate customer,
Matin konepaja Oy
country
The country where the customer company is registered
FIN
custnum
Client's customer number in the client's system
customertype
Client type: 1 = company, 2 = private person
1
deliverydate
Delivery date in the form of YYYY-MM-DD
2026-02-02
deliverymethod
Delivery method as text
deliveryterm
Delivery terms as text
The email address to which the invoice will be sent
abc@abc.com
email2
Another e-mail address to which the invoice will be sent
cba@abc.com
evoice
E-invoice address
FI123578612717718
evoiceint
Intermediary identifier for electronic billing
NDEAFIHH
freetext
Free text attached to the end of the invoice
govid
Customer ID or Identity ID
jobtype
Message type: 0 = invoice, 1 = reminder, 2 = debt collection, 300 = print service, 301 = mail service
0
language
Invoice language: eng, fin, swe, nor
eng
model
Make a mark, the cost of a customer account or any other reference
negvat
1, if the invoice is used for reverse taxation
1
ordernumber
Order number
ourcode
The principal's reference
Ford Transporter 1.2.2010-15.2.2010
overdueinterest
Overdue interest rate
8.00
ownref
Temporary delivery reference
paydate
Date of issue in the form of YYYY-MM-DD
2026-02-02
period
The date on which the invoice is recorded in the account of the principal
person
The name of the consumer customer
Teppo Testaaja
phone
Telephone number of the customer / buyer / debtor
postcode
Customer's postal code
70100
salesman
Seller ID
salesmanname
Seller name or initials
sendtype
Invoice sending method: post, print, email or evoice, evoicenet, evoicesm, peppol
post
sensible
The reminder reminder is automatically sent: 1 = no, 0 = yes
0
servicecode
Cost center, Ropo One™ system
vatid
Customer VAT ID
FI22059054
vatperiod
The date on which the VAT is charged in the account of the principal
voucherbatch
Voucher type
vouchernum
Voucher number
yourcode
Buyer's reference
Teppo Testaaja
advancepayment
Advance payments
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Header parameters
DataIdentifierstringOptional
Data identifier defined by customer for tracking purposes
DataTypeIdentifierstringOptional
Data type identifier
Content-TypestringOptional
Content type
Body
Job
Responses
201
Successful operation
application/json
JobResponse
acceptedintegerOptionalExample:
Total count of accepted jobs
1400
Bad request
application/json
401
Unauthorized
429
Too many requests - Too many concurrent requests for this customer
application/json
post/jobs
POST /rest/jobs HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 24547
{
"datastream": {
"debug": "true",
"noreport": "true",
"operator": "123456",
"origname": "invoices.xml",
"transferkey": "7d843a4e0d13ceb69b61e919ca4b0fbe",
"fileid": "7d843a4e0d13ceb69b61e919ca4b0fbe",
"batchid": "batch123123",
"dataset": [
{
"accountdate": "2017-10-10",
"address": "Satamakatu 123",
"addressaddline1": "Johto",
"addressaddline2": "PL 43",
"addressaddline3": "CO Mauno Mansikka",
"addresscountry": "FIN",
"advancepayment": "15.00",
"amount": "19.96",
"billcode": "4349",
"billdate": "2017-01-01",
"xmldate": "2017-01-01",
"billnum": "11213",
"billtemplate": "CUSTOM",
"billtemplateid": "123",
"cashbill": "1",
"checkbillnum": "1",
"city": "KUOPIO",
"claimtext": "Unpaid bill 123456.",
"collectionprocess": "AUTO",
"color": "0",
"collectioninvoice": "0",
"company": "Matin konepaja Oy",
"contactperson": "Liisa Liukaas",
"contactpersontitle": "Assistentti",
"contactpersondepartment": "Customer service",
"country": "FIN",
"countryname": "Finland",
"currency": "EUR",
"custnum": "1022",
"customerid": "1022",
"customertype": "1",
"deliverydate": "2017-01-24",
"deliverymethod": "Kiitolinja",
"deliveryterm": "NOK",
"department": "Sales",
"doublesided": "0",
"email": "foobar@helloworld.com",
"email2": "foobar@helloworld.com",
"evoice": "FI123578612717718",
"evoiceint": "NDEAFIHH",
"finance": "0",
"foreignamount": "123.32",
"foreigncurrency": "SEK",
"freetext": "Kiitokset tilauksesta!",
"govid": "2262509-5",
"jobtype": "0",
"language": "fin",
"model": "Malli tai merkki",
"negvat": "1",
"netamount": "16.10",
"noticedate": "2017-03-24",
"noticedate2": "2017-04-24",
"noticedate3": "2017-05-24",
"noticedate4": "2017-06-24",
"noticefee": "10.00",
"ordernumber": "10232",
"ourcode": "Volvo ABC-553",
"overdueinterest": "8.0",
"ovt": "00371234567800001",
"ownref": "155",
"origbillnum": "123456",
"paydate": "2017-01-17",
"payplanamount": "100.00",
"payplancount": "5",
"payplaninterval": "1",
"payplan": {
"instalment": [
{
"date": "2017-01-17",
"amount": "10.00"
}
]
},
"pdfname": "preview.pdf",
"period": "2017-02-17",
"person": "Teppo Nuutinen",
"phone": "+358441234567",
"postclass": "2",
"postcode": "70100",
"putonhold": 1,
"refundtobillnum": "11213",
"refundtojobid": "31211",
"refundiban": "FI2112345600000785",
"refundmessage": "tm 22141739 tili 1514 va 4804",
"refundmessagetype": "3",
"salesman": "12",
"salesmanname": "Sam Salesman",
"sendtype": "post",
"secondarysendtype": [
{
"sendtype": "b2c",
"evoice": "FI123578612717718",
"evoiceint": "NDEAFIHH"
}
],
"sensible": "0",
"servicecode": "1",
"servicecode_name": "Center X",
"servicecode_dimension": "123",
"TA0001": "TA-FI-STVOY0001-B",
"TA0002": "1234",
"TA0003": "Y",
"totalamount": "19.96",
"vatamount": "3.86",
"vatlayout": "0",
"vatid": "FI22059054",
"vatperiod": "2017-02-17",
"voucherbatch": "43",
"vouchernum": "202132",
"yourcode": "Teppo Nuutinen",
"addaddress": [
{
"address": "Kuninkaankatu 15",
"city": "KUOPIO",
"addressaddline1": "Johto",
"addressaddline2": "PL 43",
"addressaddline3": "CO Mauno Mansikka",
"addresstype": "1",
"person": "Tauno Testaaja",
"company": "Toiminimi Testaaja",
"addresscountry": "FIN",
"postcode": "70100",
"custnum": "123456",
"govid": "123456-7",
"vatid": "FI1234567",
"customertype": "1",
"email": "name@domain.fi",
"phone": "+3581234567",
"partytext": "Workshop",
"partycode": "xyz",
"sitecode": "123456",
"contactperson": "Liisa Assistentti",
"countryname": "Sweden",
"ovt": "00371234567800001",
"department": "Kuopio",
"contactpersontitle": "Salesmanager",
"contactpersondepartment": "Sales"
}
],
"accountrow": [
{
"accountid": "3000",
"credit": "100.00",
"debit": "100.00",
"desc": "Leivokset",
"servicecode": "0",
"servicecode_name": "300",
"netamount": "120.01",
"taxpr": "24.00",
"vatamount": "27.62",
"type": "A12345",
"type2": "B12345",
"type3": "C12345",
"type4": "D12345",
"type5": "123",
"type6": "123",
"type7": "123",
"type8": "123",
"type9": "123",
"type10": "123",
"kwh": "123,10",
"voucherbatch": "A123",
"batch": "OLDLEDGER",
"vatcode": "1"
}
],
"advancepayments": [
{
"paid_amount": null,
"paid_vat_excluded_amount": null,
"unpaid_amount": null,
"unpaid_vat_excluded_amount": null,
"interest_percent": null,
"prosessing_costs_amount": null,
"vat_included_amount": null,
"vat_excluded_amount": null,
"duedate": null,
"reference_identifier": null
}
],
"attachment": [
{
"attachmentid": "2519700",
"attachmentfile": "JVBERi0xLjQNJeLjz9MNCjE",
"attachmentname": "Attachment.pdf",
"securityclass": "SEI01",
"type": "cover",
"jobid": "123456789"
}
],
"cashdiscountrow": [
{
"discountamount": "28.30",
"discountbaseamount": "28.30",
"discountdate": "2017-02-17",
"discountpercent": "2",
"discountfreetext": "10 pv -2%"
}
],
"contract": [
{
"contract_no": "123456",
"name": "Network contract",
"startdate": "2017-06-01",
"enddate": "2018-06-01",
"contractstatus": "closed",
"type": "insurance",
"termination_date": "2022-06-01",
"terminationterm": "14",
"product": "Home insurance"
}
],
"originalcurrency": [
{
"source": "job",
"currency": "DKK",
"rate": "1.501",
"amount": "1.001",
"currency_date": "2017-06-01"
}
],
"definitiondetails": [
{
"headertext": "Vuosikayttoarvio",
"code": "E1003",
"value": "17030",
"unitcode": "kWh",
"unitcodeun": "KWH"
}
],
"image": {
"file": "JVBERi0xLjQNJeLjz9MNCjE",
"pagecount": "2",
"fileType": "txt"
},
"links": [
{
"name": "SellerReferenceIdentifierUrlText",
"link": "http://www.seller.com/reference"
}
],
"packagedetails": {
"packagelength": "1",
"lengthquantityunitcode": "m",
"lengthquantityunitcodeun": "M",
"packagewidth": "1",
"widthquantityunitcode": "m",
"widthquantityunitcodeun": "M",
"packageheight": "2",
"heightquantityunitcode": "m",
"heightquantityunitcodeun": "M",
"packageweight": "100",
"weightquantityunitcode": "kg",
"weightquantityunitcodeun": "KG",
"packagenetweight": "40",
"netweightquantityunitcode": "kg",
"netweightquantityunitcodeun": "TN",
"packagevolume": "3",
"volumequantityunitcode": "m3",
"volumequantityunitcodeun": "M3",
"transportcarriagequantity": "2",
"carriagequantityunitcode": "kpl",
"carriagequantityunitcodeun": "PCS"
},
"payee": {
"address": "Sienikatu 3",
"address2": "Sienikatu 3",
"addressaddline1": "Johto",
"addressaddline2": "PL 43",
"addressaddline3": "CO Mauno Mansikka",
"city": "Kuopio",
"countryname": "Norway",
"countrycode": "NOR",
"contact_email": "asiakaspalvelu@somewhere.fi",
"contact_name": "Asiakaspalvelu",
"contact_phone": "020-123123",
"govid": "1234567-8",
"name": "Yritys Oy",
"name_extension": "Kuopion toimipaikka",
"ovt": "003712345678",
"postcode": "00100",
"vatid": "FI1234567",
"www": "www.company.fi",
"fax": "020-123123",
"bankinfos": [
{
"name": "Nordea",
"iban": "FI1234345312312312",
"bic": "OKOYFIHH",
"bban": "1234345312312312",
"bankgiro": "123456789",
"plusgirot": "123456789"
}
]
},
"payrow": [
{
"accountid": "3000",
"allownullvalues": "0",
"amount": "0.76",
"ahinta": "15.53",
"count": "10",
"desc": "Leivokset",
"discount": "25",
"eancode": "5901234123457",
"enddate": "2017-02-17",
"freetext": "- 500 Mt kotisivutilaa",
"invoicerowtype": "25600",
"itemtype": "pcs",
"itemtypeun": "MON",
"netamount": "7.60",
"priceunit": "e/kwh",
"priceunitun": "MON",
"productid": "XN5",
"rowline": "1",
"rowtype": "3",
"salesman": "12",
"salesmanname": "Sam Salesman",
"servicecode": "0",
"startdate": "2017-02-17",
"storage": "12345",
"TA0001": "TA-FI-STVOY0001-B",
"TA0002": "1234",
"TA0003": "Y",
"taxpr": "24.00",
"totalamount": "10.00",
"itemprice": "147.60",
"totalitemprice": "147.60",
"vatamount": "2.40",
"vatcode": "1",
"vatfreetext": "MOMS Directive 44 type",
"subidentifier": "1",
"identifier": "INDENFIER",
"rowpositionidentifier": "1",
"usageplacecode": "123456",
"definitions": [
{
"headertext": "Vuosikayttoarvio",
"code": "E1003",
"value": "17030",
"unitcode": "kWh",
"unitcodeun": "KWH"
}
],
"packagedetails": {
"packagelength": "1",
"lengthquantityunitcode": "m",
"lengthquantityunitcodeun": "M",
"packagewidth": "1",
"widthquantityunitcode": "m",
"widthquantityunitcodeun": "M",
"packageheight": "2",
"heightquantityunitcode": "m",
"heightquantityunitcodeun": "M",
"packageweight": "100",
"weightquantityunitcode": "kg",
"weightquantityunitcodeun": "KG",
"packagenetweight": "40",
"netweightquantityunitcode": "kg",
"netweightquantityunitcodeun": "TN",
"packagevolume": "3",
"volumequantityunitcode": "m3",
"volumequantityunitcodeun": "M3",
"transportcarriagequantity": "2",
"carriagequantityunitcode": "kpl",
"carriagequantityunitcodeun": "PCS"
},
"propertyrow": [
{
"propname": "E1002",
"propvalue": "1402465093"
}
],
"discounts": [
{
"freetext": "Platinum customer discount",
"reasoncode": "XYZ",
"percent": "10.0",
"amount": "10.00",
"vatamount": "10.00",
"baseamount": "100.00",
"vatcategorycode": "ABC",
"vatratepercent": "24"
}
],
"charges": [
{
"freetext": "Platinum customer discount",
"reasoncode": "XYZ",
"percent": "10.0",
"amount": "10.00",
"vatamount": "10.00",
"baseamount": "100.00",
"vatcategorycode": "ABC",
"vatratepercent": "24"
}
],
"links": [
{
"name": "SellerReferenceIdentifierUrlText",
"link": "http://www.seller.com/reference"
}
],
"rowoverdue": {
"original_invoice_identifier": null,
"original_invoice_date": null,
"original_due_date": null,
"original_invoice_total_amount": null,
"original_epi_remittance_info_identifier": null,
"paid_vat_excluded_amount": null,
"paid_vat_included_amount": null,
"paid_date": null,
"un_paid_vat_excluded_amount": null,
"un_paid_vat_included_amount": null,
"collection_date": null,
"collection_quantity": null,
"quantity_unit_code": null,
"quantity_unit_code_u_n": null,
"collection_charge_amount": null,
"interest_rate": null,
"interest_start_date": null,
"interest_end_date": null,
"interest_period_text": null,
"interest_date_number": null,
"interest_charge_amount": null,
"interest_charge_vat_amount": null,
"amount_currency_identifier": null
},
"invoicerowaddress": [
{
"party_text": null,
"party_code": null,
"party_identifier": null,
"party_identifier_scheme_id": null,
"name": null,
"name2": null,
"department": null,
"tax_code": null,
"any_party_code": null,
"any_party_code_scheme_id": null,
"address": null,
"address2": null,
"address3": null,
"postcode": null,
"city": null,
"country_code": null,
"country_name": null,
"subdivision": null,
"post_box_id": null,
"organisation_unit_number": null,
"site_code": null
}
]
}
],
"propertyrow": [
{
"propname": "E1002",
"propvalue": "1402465093"
}
],
"marks": [
{
"jobid": "3000",
"statustime": "2018-10-23 10:12:32",
"text": "",
"whodid": "3000",
"specialmark": "1",
"customermark": "1",
"restricted": "1"
}
],
"taxrow": [
{
"netamount": "16.10",
"taxpr": "24",
"totalamount": "19.96",
"vatamount": "3.86",
"vatfreetext": "ALV 24",
"vatcode": "AE",
"vatexemptionreasoncode": "REC"
}
],
"xmldetailsrow": [
{
"text": "Rekisterinumero",
"source": "teapps",
"code": "rekno",
"value": "ABC-123",
"group": "123456"
}
],
"usageplaces": [
{
"address": {
"address": "Kuninkaankatu 15",
"city": "KUOPIO",
"addressaddline1": "Johto",
"addressaddline2": "PL 43",
"addressaddline3": "CO Mauno Mansikka",
"addresstype": "1",
"person": "Tauno Testaaja",
"company": "Toiminimi Testaaja",
"addresscountry": "FIN",
"postcode": "70100",
"custnum": "123456",
"govid": "123456-7",
"vatid": "FI1234567",
"customertype": "1",
"email": "name@domain.fi",
"phone": "+3581234567",
"partytext": "Workshop",
"partycode": "xyz",
"sitecode": "123456",
"contactperson": "Liisa Assistentti",
"countryname": "Sweden",
"ovt": "00371234567800001",
"department": "Kuopio",
"contactpersontitle": "Salesmanager",
"contactpersondepartment": "Sales"
},
"energycontract": [
{
"contract_no": "123456",
"name": "Verkkosopimus",
"vendor_name": "Testiverkot",
"startdate": "2017-06-01",
"enddate": "2018-06-01",
"expdate": "2018-06-01"
}
],
"code": "0070100",
"fuse": "25 A",
"usage_estimate": "20000",
"usage_estimate_unit": "kWh",
"grid_usageplace": "JSE000_2000111",
"grid_edielno": "JSE000",
"grid_govid": "0981408-6",
"gsrn_code": "12345749012345678",
"consumptionhistory": [
{
"consumption": "1234.76",
"monthly_avg_peak": "234.76",
"startdate": "2020-06-01",
"enddate": "2020-07-01",
"yoy_percentage_change": "8.00"
}
],
"freetext": [
{
"texttype": "HEADER",
"textname": "Text header",
"textvalue": "This is jobs free text"
}
]
}
],
"freetexts": [
{
"texttype": "HEADER",
"textname": "Text header",
"textvalue": "This is jobs free text"
}
],
"discounts": [
{
"freetext": "Platinum customer discount",
"reasoncode": "XYZ",
"percent": "10.0",
"amount": "10.00",
"vatamount": "10.00",
"baseamount": "100.00",
"vatcategorycode": "ABC",
"vatratepercent": "24"
}
],
"charges": [
{
"freetext": "Platinum customer discount",
"reasoncode": "XYZ",
"percent": "10.0",
"amount": "10.00",
"vatamount": "10.00",
"baseamount": "100.00",
"vatcategorycode": "ABC",
"vatratepercent": "24"
}
],
"originalinvoicereferences": [
{
"invoicenumber": "123456",
"invoicedate": "2017-12-31",
"netamount": "7.60",
"totalamount": "10.00"
}
],
"partialpayments": [
{
"paid_amount": null,
"paid_vat_excluded_amount": null,
"unpaid_amount": null,
"unpaid_vat_excluded_amount": null,
"interest_percent": null,
"prosessing_costs_amount": null,
"vat_included_amount": null,
"vat_excluded_amount": null,
"duedate": null,
"reference_identifier": null
}
],
"interestrates": [
{
"interest_type": "text",
"annual_rate": "19.90",
"real_annual_rate": "27.29",
"start_from_date": "2026-01-01",
"end_at_date": null
}
],
"classification": {
"documenttype": "GeneralNote"
},
"sendparameters": {
"earliestsenddate": "2022-10-24",
"delivery_channel_priority": "peppol,b2b"
},
"avtalegiro": "avtalegiro",
"autogiro": "autogiro",
"subset": [
{
"accountdate": "2017-10-10",
"address": "Satamakatu 123",
"addressaddline1": "Johto",
"addressaddline2": "PL 43",
"addressaddline3": "CO Mauno Mansikka",
"addresscountry": "FIN",
"advancepayment": "15.00",
"amount": "19.96",
"billcode": "4349",
"billdate": "2017-01-01",
"xmldate": "2017-01-01",
"billnum": "11213",
"billtemplate": "CUSTOM",
"billtemplateid": "123",
"cashbill": "1",
"checkbillnum": "1",
"city": "KUOPIO",
"claimtext": "Unpaid bill 123456.",
"collectionprocess": "AUTO",
"color": "0",
"collectioninvoice": "0",
"company": "Matin konepaja Oy",
"contactperson": "Liisa Liukaas",
"contactpersontitle": "Assistentti",
"contactpersondepartment": "Customer service",
"country": "FIN",
"countryname": "Finland",
"currency": "EUR",
"custnum": "1022",
"customerid": "1022",
"customertype": "1",
"deliverydate": "2017-01-24",
"deliverymethod": "Kiitolinja",
"deliveryterm": "NOK",
"department": "Sales",
"doublesided": "0",
"email": "foobar@helloworld.com",
"email2": "foobar@helloworld.com",
"evoice": "FI123578612717718",
"evoiceint": "NDEAFIHH",
"finance": "0",
"foreignamount": "123.32",
"foreigncurrency": "SEK",
"freetext": "Kiitokset tilauksesta!",
"govid": "2262509-5",
"jobtype": "0",
"language": "fin",
"model": "Malli tai merkki",
"negvat": "1",
"netamount": "16.10",
"noticedate": "2017-03-24",
"noticedate2": "2017-04-24",
"noticedate3": "2017-05-24",
"noticedate4": "2017-06-24",
"noticefee": "10.00",
"ordernumber": "10232",
"ourcode": "Volvo ABC-553",
"overdueinterest": "8.0",
"ovt": "00371234567800001",
"ownref": "155",
"origbillnum": "123456",
"paydate": "2017-01-17",
"payplanamount": "100.00",
"payplancount": "5",
"payplaninterval": "1",
"payplan": {
"instalment": [
{
"date": "2017-01-17",
"amount": "10.00"
}
]
},
"pdfname": "preview.pdf",
"period": "2017-02-17",
"person": "Teppo Nuutinen",
"phone": "+358441234567",
"postclass": "2",
"postcode": "70100",
"putonhold": 1,
"refundtobillnum": "11213",
"refundtojobid": "31211",
"refundiban": "FI2112345600000785",
"refundmessage": "tm 22141739 tili 1514 va 4804",
"refundmessagetype": "3",
"salesman": "12",
"salesmanname": "Sam Salesman",
"sendtype": "post",
"secondarysendtype": [
{
"sendtype": "b2c",
"evoice": "FI123578612717718",
"evoiceint": "NDEAFIHH"
}
],
"sensible": "0",
"servicecode": "1",
"servicecode_name": "Center X",
"servicecode_dimension": "123",
"TA0001": "TA-FI-STVOY0001-B",
"TA0002": "1234",
"TA0003": "Y",
"totalamount": "19.96",
"vatamount": "3.86",
"vatlayout": "0",
"vatid": "FI22059054",
"vatperiod": "2017-02-17",
"voucherbatch": "43",
"vouchernum": "202132",
"yourcode": "Teppo Nuutinen",
"addaddress": [
{
"address": "Kuninkaankatu 15",
"city": "KUOPIO",
"addressaddline1": "Johto",
"addressaddline2": "PL 43",
"addressaddline3": "CO Mauno Mansikka",
"addresstype": "1",
"person": "Tauno Testaaja",
"company": "Toiminimi Testaaja",
"addresscountry": "FIN",
"postcode": "70100",
"custnum": "123456",
"govid": "123456-7",
"vatid": "FI1234567",
"customertype": "1",
"email": "name@domain.fi",
"phone": "+3581234567",
"partytext": "Workshop",
"partycode": "xyz",
"sitecode": "123456",
"contactperson": "Liisa Assistentti",
"countryname": "Sweden",
"ovt": "00371234567800001",
"department": "Kuopio",
"contactpersontitle": "Salesmanager",
"contactpersondepartment": "Sales"
}
],
"accountrow": [
{
"accountid": "3000",
"credit": "100.00",
"debit": "100.00",
"desc": "Leivokset",
"servicecode": "0",
"servicecode_name": "300",
"netamount": "120.01",
"taxpr": "24.00",
"vatamount": "27.62",
"type": "A12345",
"type2": "B12345",
"type3": "C12345",
"type4": "D12345",
"type5": "123",
"type6": "123",
"type7": "123",
"type8": "123",
"type9": "123",
"type10": "123",
"kwh": "123,10",
"voucherbatch": "A123",
"batch": "OLDLEDGER",
"vatcode": "1"
}
],
"advancepayments": [
{
"paid_amount": null,
"paid_vat_excluded_amount": null,
"unpaid_amount": null,
"unpaid_vat_excluded_amount": null,
"interest_percent": null,
"prosessing_costs_amount": null,
"vat_included_amount": null,
"vat_excluded_amount": null,
"duedate": null,
"reference_identifier": null
}
],
"attachment": [
{
"attachmentid": "2519700",
"attachmentfile": "JVBERi0xLjQNJeLjz9MNCjE",
"attachmentname": "Attachment.pdf",
"securityclass": "SEI01",
"type": "cover",
"jobid": "123456789"
}
],
"cashdiscountrow": [
{
"discountamount": "28.30",
"discountbaseamount": "28.30",
"discountdate": "2017-02-17",
"discountpercent": "2",
"discountfreetext": "10 pv -2%"
}
],
"contract": [
{
"contract_no": "123456",
"name": "Network contract",
"startdate": "2017-06-01",
"enddate": "2018-06-01",
"contractstatus": "closed",
"type": "insurance",
"termination_date": "2022-06-01",
"terminationterm": "14",
"product": "Home insurance"
}
],
"originalcurrency": [
{
"source": "job",
"currency": "DKK",
"rate": "1.501",
"amount": "1.001",
"currency_date": "2017-06-01"
}
],
"definitiondetails": [
{
"headertext": "Vuosikayttoarvio",
"code": "E1003",
"value": "17030",
"unitcode": "kWh",
"unitcodeun": "KWH"
}
],
"image": {
"file": "JVBERi0xLjQNJeLjz9MNCjE",
"pagecount": "2",
"fileType": "txt"
},
"links": [
{
"name": "SellerReferenceIdentifierUrlText",
"link": "http://www.seller.com/reference"
}
],
"packagedetails": {
"packagelength": "1",
"lengthquantityunitcode": "m",
"lengthquantityunitcodeun": "M",
"packagewidth": "1",
"widthquantityunitcode": "m",
"widthquantityunitcodeun": "M",
"packageheight": "2",
"heightquantityunitcode": "m",
"heightquantityunitcodeun": "M",
"packageweight": "100",
"weightquantityunitcode": "kg",
"weightquantityunitcodeun": "KG",
"packagenetweight": "40",
"netweightquantityunitcode": "kg",
"netweightquantityunitcodeun": "TN",
"packagevolume": "3",
"volumequantityunitcode": "m3",
"volumequantityunitcodeun": "M3",
"transportcarriagequantity": "2",
"carriagequantityunitcode": "kpl",
"carriagequantityunitcodeun": "PCS"
},
"payee": {
"address": "Sienikatu 3",
"address2": "Sienikatu 3",
"addressaddline1": "Johto",
"addressaddline2": "PL 43",
"addressaddline3": "CO Mauno Mansikka",
"city": "Kuopio",
"countryname": "Norway",
"countrycode": "NOR",
"contact_email": "asiakaspalvelu@somewhere.fi",
"contact_name": "Asiakaspalvelu",
"contact_phone": "020-123123",
"govid": "1234567-8",
"name": "Yritys Oy",
"name_extension": "Kuopion toimipaikka",
"ovt": "003712345678",
"postcode": "00100",
"vatid": "FI1234567",
"www": "www.company.fi",
"fax": "020-123123",
"bankinfos": [
{
"name": "Nordea",
"iban": "FI1234345312312312",
"bic": "OKOYFIHH",
"bban": "1234345312312312",
"bankgiro": "123456789",
"plusgirot": "123456789"
}
]
},
"payrow": [
{
"accountid": "3000",
"allownullvalues": "0",
"amount": "0.76",
"ahinta": "15.53",
"count": "10",
"desc": "Leivokset",
"discount": "25",
"eancode": "5901234123457",
"enddate": "2017-02-17",
"freetext": "- 500 Mt kotisivutilaa",
"invoicerowtype": "25600",
"itemtype": "pcs",
"itemtypeun": "MON",
"netamount": "7.60",
"priceunit": "e/kwh",
"priceunitun": "MON",
"productid": "XN5",
"rowline": "1",
"rowtype": "3",
"salesman": "12",
"salesmanname": "Sam Salesman",
"servicecode": "0",
"startdate": "2017-02-17",
"storage": "12345",
"TA0001": "TA-FI-STVOY0001-B",
"TA0002": "1234",
"TA0003": "Y",
"taxpr": "24.00",
"totalamount": "10.00",
"itemprice": "147.60",
"totalitemprice": "147.60",
"vatamount": "2.40",
"vatcode": "1",
"vatfreetext": "MOMS Directive 44 type",
"subidentifier": "1",
"identifier": "INDENFIER",
"rowpositionidentifier": "1",
"usageplacecode": "123456",
"definitions": [
{
"headertext": "Vuosikayttoarvio",
"code": "E1003",
"value": "17030",
"unitcode": "kWh",
"unitcodeun": "KWH"
}
],
"packagedetails": {
"packagelength": "1",
"lengthquantityunitcode": "m",
"lengthquantityunitcodeun": "M",
"packagewidth": "1",
"widthquantityunitcode": "m",
"widthquantityunitcodeun": "M",
"packageheight": "2",
"heightquantityunitcode": "m",
"heightquantityunitcodeun": "M",
"packageweight": "100",
"weightquantityunitcode": "kg",
"weightquantityunitcodeun": "KG",
"packagenetweight": "40",
"netweightquantityunitcode": "kg",
"netweightquantityunitcodeun": "TN",
"packagevolume": "3",
"volumequantityunitcode": "m3",
"volumequantityunitcodeun": "M3",
"transportcarriagequantity": "2",
"carriagequantityunitcode": "kpl",
"carriagequantityunitcodeun": "PCS"
},
"propertyrow": [
{
"propname": "E1002",
"propvalue": "1402465093"
}
],
"discounts": [
{
"freetext": "Platinum customer discount",
"reasoncode": "XYZ",
"percent": "10.0",
"amount": "10.00",
"vatamount": "10.00",
"baseamount": "100.00",
"vatcategorycode": "ABC",
"vatratepercent": "24"
}
],
"charges": [
{
"freetext": "Platinum customer discount",
"reasoncode": "XYZ",
"percent": "10.0",
"amount": "10.00",
"vatamount": "10.00",
"baseamount": "100.00",
"vatcategorycode": "ABC",
"vatratepercent": "24"
}
],
"links": [
{
"name": "SellerReferenceIdentifierUrlText",
"link": "http://www.seller.com/reference"
}
],
"rowoverdue": {
"original_invoice_identifier": null,
"original_invoice_date": null,
"original_due_date": null,
"original_invoice_total_amount": null,
"original_epi_remittance_info_identifier": null,
"paid_vat_excluded_amount": null,
"paid_vat_included_amount": null,
"paid_date": null,
"un_paid_vat_excluded_amount": null,
"un_paid_vat_included_amount": null,
"collection_date": null,
"collection_quantity": null,
"quantity_unit_code": null,
"quantity_unit_code_u_n": null,
"collection_charge_amount": null,
"interest_rate": null,
"interest_start_date": null,
"interest_end_date": null,
"interest_period_text": null,
"interest_date_number": null,
"interest_charge_amount": null,
"interest_charge_vat_amount": null,
"amount_currency_identifier": null
},
"invoicerowaddress": [
{
"party_text": null,
"party_code": null,
"party_identifier": null,
"party_identifier_scheme_id": null,
"name": null,
"name2": null,
"department": null,
"tax_code": null,
"any_party_code": null,
"any_party_code_scheme_id": null,
"address": null,
"address2": null,
"address3": null,
"postcode": null,
"city": null,
"country_code": null,
"country_name": null,
"subdivision": null,
"post_box_id": null,
"organisation_unit_number": null,
"site_code": null
}
]
}
],
"propertyrow": [
{
"propname": "E1002",
"propvalue": "1402465093"
}
],
"marks": [
{
"jobid": "3000",
"statustime": "2018-10-23 10:12:32",
"text": "",
"whodid": "3000",
"specialmark": "1",
"customermark": "1",
"restricted": "1"
}
],
"taxrow": [
{
"netamount": "16.10",
"taxpr": "24",
"totalamount": "19.96",
"vatamount": "3.86",
"vatfreetext": "ALV 24",
"vatcode": "AE",
"vatexemptionreasoncode": "REC"
}
],
"xmldetailsrow": [
{
"text": "Rekisterinumero",
"source": "teapps",
"code": "rekno",
"value": "ABC-123",
"group": "123456"
}
],
"usageplaces": [
{
"address": {
"address": "Kuninkaankatu 15",
"city": "KUOPIO",
"addressaddline1": "Johto",
"addressaddline2": "PL 43",
"addressaddline3": "CO Mauno Mansikka",
"addresstype": "1",
"person": "Tauno Testaaja",
"company": "Toiminimi Testaaja",
"addresscountry": "FIN",
"postcode": "70100",
"custnum": "123456",
"govid": "123456-7",
"vatid": "FI1234567",
"customertype": "1",
"email": "name@domain.fi",
"phone": "+3581234567",
"partytext": "Workshop",
"partycode": "xyz",
"sitecode": "123456",
"contactperson": "Liisa Assistentti",
"countryname": "Sweden",
"ovt": "00371234567800001",
"department": "Kuopio",
"contactpersontitle": "Salesmanager",
"contactpersondepartment": "Sales"
},
"energycontract": [
{
"contract_no": "123456",
"name": "Verkkosopimus",
"vendor_name": "Testiverkot",
"startdate": "2017-06-01",
"enddate": "2018-06-01",
"expdate": "2018-06-01"
}
],
"code": "0070100",
"fuse": "25 A",
"usage_estimate": "20000",
"usage_estimate_unit": "kWh",
"grid_usageplace": "JSE000_2000111",
"grid_edielno": "JSE000",
"grid_govid": "0981408-6",
"gsrn_code": "12345749012345678",
"consumptionhistory": [
{
"consumption": "1234.76",
"monthly_avg_peak": "234.76",
"startdate": "2020-06-01",
"enddate": "2020-07-01",
"yoy_percentage_change": "8.00"
}
],
"freetext": [
{
"texttype": "HEADER",
"textname": "Text header",
"textvalue": "This is jobs free text"
}
]
}
],
"freetexts": [
{
"texttype": "HEADER",
"textname": "Text header",
"textvalue": "This is jobs free text"
}
],
"discounts": [
{
"freetext": "Platinum customer discount",
"reasoncode": "XYZ",
"percent": "10.0",
"amount": "10.00",
"vatamount": "10.00",
"baseamount": "100.00",
"vatcategorycode": "ABC",
"vatratepercent": "24"
}
],
"charges": [
{
"freetext": "Platinum customer discount",
"reasoncode": "XYZ",
"percent": "10.0",
"amount": "10.00",
"vatamount": "10.00",
"baseamount": "100.00",
"vatcategorycode": "ABC",
"vatratepercent": "24"
}
],
"originalinvoicereferences": [
{
"invoicenumber": "123456",
"invoicedate": "2017-12-31",
"netamount": "7.60",
"totalamount": "10.00"
}
],
"partialpayments": [
{
"paid_amount": null,
"paid_vat_excluded_amount": null,
"unpaid_amount": null,
"unpaid_vat_excluded_amount": null,
"interest_percent": null,
"prosessing_costs_amount": null,
"vat_included_amount": null,
"vat_excluded_amount": null,
"duedate": null,
"reference_identifier": null
}
],
"interestrates": [
{
"interest_type": "text",
"annual_rate": "19.90",
"real_annual_rate": "27.29",
"start_from_date": "2026-01-01",
"end_at_date": null
}
],
"classification": {
"documenttype": "GeneralNote"
},
"sendparameters": {
"earliestsenddate": "2022-10-24",
"delivery_channel_priority": "peppol,b2b"
},
"avtalegiro": "avtalegiro",
"autogiro": "autogiro",
"subset": "[Circular Reference]"
}
]
}
]
}
}{
"result": [
{
"accepted": "1",
"amount": "49.53",
"billnum": "11213",
"billcode": "112134",
"error": "Billnum 1002 already exists",
"evoicetype": "elasku",
"jobid": "549198",
"jobstatus": "0",
"jobtype": "0",
"notice": [
"Please check the chosen customer type",
"Please check the address"
],
"origbillnum": "11213",
"ownref": "155",
"print": "null",
"receiver": "Receivers name. Company or Person depending on customertype",
"reference": "2011035491985",
"sendtype": "post"
}
],
"errors": [
{
"error": "Billnum 11213 already exists"
}
],
"accepted": "1"
}Last updated
Was this helpful?