Jobs
Manage Jobs
Id of the job
Successful operation
JobJobInfo
The date job was added
2017-10-10The street address of the recipient
Satamakatu 123The first additional line of the address card, printed above the name of the recipient
JohtoThe second additional line of the address card, printed between the name and the street address
PL 43Reference number or message, by which the payment is delivered to the biller
4349The current number of the bill in the accounting books of the principal
11213The mailing location of the debtor
KUOPIOName of the corporate customer
Matin konepaja OyCountry where the corporate customer is registered
FINCurrent paydate
2017-12-31Current status
0Current statustext
InvoicingThe customer number of the customer in the principals system
1022The business ID (Y-tunnus) or personal identity code of the customer
2262509-5Job id
123Next status (-1 if next status is not available)
1Date when next status occurs
2018-01-15Next status text
ReminderDate when job was originally received
2017-11-13Original status text
InvoicingJobtype when job was originally received
0Original duedate of the bill
2017-11-27The name of the consumer client
Teppo NuutinenThe postal code of the customer
70100Reference number or message, by which the payment is delivered to the biller
412431235Assignment ID generated by Ropo to which the credit note is allocated.
31211The VAT ID of the customer
FI22059054Bad Request
Unauthorized
Not Found
GET /rest/jobs?jobid=1 HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"accountdate": "2017-10-10",
"address": "Satamakatu 123",
"addressaddline1": "Johto",
"addressaddline2": "PL 43",
"billcode": "4349",
"billnum": "11213",
"city": "KUOPIO",
"company": "Matin konepaja Oy",
"country": "FIN",
"currentpaydate": "2017-12-31",
"currentstatus": "0",
"currentstatustext": "Invoicing",
"custnum": "1022",
"govid": "2262509-5",
"jobid": "123",
"nextstatus": "1",
"nextstatusdate": "2018-01-15",
"nextstatustext": "Reminder",
"origjobdate": "2017-11-13",
"origjobtext": "Invoicing",
"origjobtype": "0",
"paydate": "2017-11-27",
"person": "Teppo Nuutinen",
"postcode": "70100",
"reference": "412431235",
"refundtojobid": "31211",
"vatid": "FI22059054",
"breakdown": [
{
"billnum": "12345678",
"origpaydate": "12.12.2018",
"capital": "710.00",
"interest": "7.00",
"expenses": "50.00",
"netamount": "200.00",
"opencapital": "250.00",
"title": "Sähkö",
"vatamount": "50.00",
"subtaskids": "text",
"subtasks": [
{
"billnum": "12345678",
"origpaydate": "12.12.2018",
"capital": "710.00",
"interest": "7.00",
"expenses": "50.00",
"netamount": "200.00",
"opencapital": "250.00",
"title": "Sähkö",
"vatamount": "50.00",
"subtaskids": "text",
"subtasks": [
"[Circular Reference]"
],
"creditnotes": {
"creditnote": [
{
"amount": "710.00",
"billnum": "R123467",
"jobid": "123467",
"billdate": "2017-10-10",
"duedate": "2017-10-10",
"allocated": "50",
"unallocated": "50",
"job_allocated": [
{
"billnum": "R123467",
"jobid": "123467",
"allocated": "50"
}
]
}
]
},
"opencapitalwithoutcreditnotes": "250.00",
"overdueinterest": "50.00"
}
],
"creditnotes": {
"creditnote": [
{
"amount": "710.00",
"billnum": "R123467",
"jobid": "123467",
"billdate": "2017-10-10",
"duedate": "2017-10-10",
"allocated": "50",
"unallocated": "50",
"job_allocated": [
{
"billnum": "R123467",
"jobid": "123467",
"allocated": "50"
}
]
}
]
},
"opencapitalwithoutcreditnotes": "250.00",
"overdueinterest": "50.00"
}
],
"payment": [
{
"amount": "710.00",
"desc": "PAID",
"paydate": "2017-10-10",
"rowtype": "1",
"rowtypetext": "Capital",
"returndesc": "1",
"returndesctext": "Paid to the creditor",
"rowtime": "2017-10-10 12:23:32",
"statusid": "213123"
}
],
"refund": [
{
"amount": "19.96",
"date": "2017-10-30",
"jobid": "123456"
}
],
"status": [
{
"statuscode": "0",
"statusref": "Paid",
"statustext": "Capital paid",
"statustime": "2017-10-30 16:27:41"
}
]
}Data identifier defined by customer for tracking purposes
Data type identifier
Content type
Job
Successful operation
JobResponse
Total count of accepted jobs
1Bad request
Unauthorized
Too many requests - Too many concurrent requests for this customer
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"
}Id of the job to modify [jobid or billnum is required]
Billnum of the job to modify [jobid or billnum is required]
JobDataSet
Account date
2017-10-10The street address of the recipient
Satamakatu 123The first additional line of the address card, printed above the name of the recipient
JohtoThe second additional line of the address card, printed between the name and the street address
PL 43Line between receivers name and the street address
CO Mauno MansikkaThe home country of the recipient
FINAmount of advancepayment
15.00Total amount of the bill
19.96Reference number or message, by which the payment is delivered to the biller
4349The date of the bill
2017-01-01The date of the bill on invoices or reminder date
2017-01-01The current number of the bill in the accounting books of the principal
11213The layout design of the bill template: CUSTOM, ECOM, BOBCAT, INC
CUSTOMThe layout id of the bill template.
123A cash bill is marked as paid directly: 1=cash bill
1Check if the bill number is unique 1=on, 0=off
1The mailing location of the debtor
KUOPIOReason for Recall and Recourse.
Unpaid bill 123456.Type of receivable. Influences the collection process
AUTO1=color, 0=black and white
01=Collection invoice, 0=Single invoice
0Name of the corporate customer
Matin konepaja OyContact person
Liisa LiukaasContact person title
AssistenttiContact person department
Customer serviceCountry where the corporate customer is registered
FINRecipients country name
FinlandCurrency of job
EURThe customer number of the customer in the principals system
1022The customer number of the customer in Ropo One
1022Type of customer: 1=company, 2=natural person
1Products delivery date on invoice or cover note.
2017-01-24Products delivery method as text.
KiitolinjaTerms of delivery as text.
NOKRecipients department
Sales0=singleside(default), 1=use doublesided bill
0The e-mail address to which the bill is sent
foobar@helloworld.comThe second e-mail address to which the bill is sent
foobar@helloworld.comFinnish e-invoice address
FI123578612717718The code of the intermediary in the e-invoice
NDEAFIHH1 = if funding applied from Ropo Finance.
0Total amount of the bill in its original currency.
123.32TotalIdentifier of the currency used in the bill.
SEKFree text field at the end of the bill
Kiitokset tilauksesta!The business ID (Y-tunnus) or personal identity code of the customer
2262509-5Type of job: 0=bill, 1=payment notice, 2=collection, 300=printing service, 301=mailing service
0Language of the bill: eng, fin, swe, est
finMake, cost centre in the customers accounting or other reference
Malli tai merkki1, if reverse VAT liability is used in the bill
1Total amount of the bill without VAT
16.10Date of the first payment notice.
2017-03-24Date of the second payment notice.
2017-04-24Date of the third payment notice.
2017-05-24Date of the fourth payment notice.
2017-06-24Principals notice costs.
10.00Order number
10232The principals reference
Volvo ABC-553Delay interest rate
8.0OrganisationUnitNumber of recipient
00371234567800001Temporary reference for sending
155Billnumber of collection invoices. Compulsory when invoice is sub invoice jobtype = 602.
123456The due date of the bill
2017-01-17Amount of one instalment in a payment schedule in euros.
100.00The number of instalments in a payment schedule.
5Interval between instalments of the payment schedule in months.
1Predefined filename. This value is returned in preview and localprint responseheader
preview.pdfThe date when the bill is recorded in the principals accounting. Contact our customer service before using this!
2017-02-17The name of the consumer client
Teppo NuutinenThe phone number of the customer/buyer/debtor
+358441234567Class of the letter in the post: 1 or 2
2The postal code of the customer
70100Should jobstatus be changed to 100: 1 = yes, 0 = no
1Bill number of the principal to which the credit note is allocated.
11213Assignment ID generated by Ropo to which the credit note is allocated.
31211Account number where credit note is payed
FI2112345600000785Message for payment of credit note
tm 22141739 tili 1514 va 4804Messagetype for payment of credit note: 1=Using reference, 3=Using message
3The code of the salesman
12Name or initials of the salesman
Sam SalesmanType of sending of the bill: post, print, email or evoice
postIs a payment notice sent automatically: 1=no, 0=yes
0Cost center id
1Cost center Name
Center XCost center code
123Site key in construction invoices.
TA-FI-STVOY0001-BSite number in construction invoices.
1234Reported to the site register: Y = yes, N = no
YTotal bill amount including VAT
19.96Total VAT amount of the bill
3.86VAT layout at invoice lines when only one is shown. 0 = Without VAT 1 = VAT included
0The VAT ID of the customer
FI22059054The date on which VAT is applied in the principals accounting. Contact our customer service before using this!
2017-02-17Voucher batch
43Voucher number
202132Reference of the buyer
Teppo NuutinenUsed to determine that invoice is Avtalegiro type
avtalegiroUsed to determine that invoice is Autogiro type
autogiroSuccessful operation
No content
Bad request
Unauthorized
Forbidden
Not Found
PATCH /rest/jobs HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 36475
{
"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": [
{
"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]"
]
}
]
}
]
}No content
Date (YYYY-MM-DD) to define to get all status update of given day.
Invoice number. Response will contain all status updates for the invoice.
Successful operation
JobsStatusUpdatesResult
No Content, No status updates to return
Bad Request
Unauthorized
GET /rest/jobs/statusupdates HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"result": {
"status": [
{
"jobid": "1",
"statusid": "P12345",
"billnum": "10123",
"openamount": "10.0",
"origamount": "15.0",
"opencapital": "6.0",
"openinterest": "3.0",
"openexpenses": "1.0",
"statustype": "payment",
"statustime": "2016-12-30 14:31:26",
"statusref": "Sample reason of update",
"statustext": "Detailed information of update",
"statuscode": "0",
"paydate": "2016-12-30",
"amount": "10.0"
}
]
}
}Id of the job [contractnum, billnum or jobid is required]
Billnum of the job [contractnum, billnum or jobid is required]
Contractnum of the job [contractnum, billnum or jobid is required]
Document date of the job [also contractnum or billnum is required]
0 = current, 1 = original[default]
Documenttype for Joisto archive.
Column name in Joisto archive (JobId, Laskunumero, Laskunro)
Returns PDF
Bad request
Unauthorized
Forbidden
Not Found
GET /rest/jobs/pdf HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
Customer number of job(s) to modify
Order number of job(s) to modify
JobDataSet
Account date
2017-10-10The street address of the recipient
Satamakatu 123The first additional line of the address card, printed above the name of the recipient
JohtoThe second additional line of the address card, printed between the name and the street address
PL 43Line between receivers name and the street address
CO Mauno MansikkaThe home country of the recipient
FINAmount of advancepayment
15.00Total amount of the bill
19.96Reference number or message, by which the payment is delivered to the biller
4349The date of the bill
2017-01-01The date of the bill on invoices or reminder date
2017-01-01The current number of the bill in the accounting books of the principal
11213The layout design of the bill template: CUSTOM, ECOM, BOBCAT, INC
CUSTOMThe layout id of the bill template.
123A cash bill is marked as paid directly: 1=cash bill
1Check if the bill number is unique 1=on, 0=off
1The mailing location of the debtor
KUOPIOReason for Recall and Recourse.
Unpaid bill 123456.Type of receivable. Influences the collection process
AUTO1=color, 0=black and white
01=Collection invoice, 0=Single invoice
0Name of the corporate customer
Matin konepaja OyContact person
Liisa LiukaasContact person title
AssistenttiContact person department
Customer serviceCountry where the corporate customer is registered
FINRecipients country name
FinlandCurrency of job
EURThe customer number of the customer in the principals system
1022The customer number of the customer in Ropo One
1022Type of customer: 1=company, 2=natural person
1Products delivery date on invoice or cover note.
2017-01-24Products delivery method as text.
KiitolinjaTerms of delivery as text.
NOKRecipients department
Sales0=singleside(default), 1=use doublesided bill
0The e-mail address to which the bill is sent
foobar@helloworld.comThe second e-mail address to which the bill is sent
foobar@helloworld.comFinnish e-invoice address
FI123578612717718The code of the intermediary in the e-invoice
NDEAFIHH1 = if funding applied from Ropo Finance.
0Total amount of the bill in its original currency.
123.32TotalIdentifier of the currency used in the bill.
SEKFree text field at the end of the bill
Kiitokset tilauksesta!The business ID (Y-tunnus) or personal identity code of the customer
2262509-5Type of job: 0=bill, 1=payment notice, 2=collection, 300=printing service, 301=mailing service
0Language of the bill: eng, fin, swe, est
finMake, cost centre in the customers accounting or other reference
Malli tai merkki1, if reverse VAT liability is used in the bill
1Total amount of the bill without VAT
16.10Date of the first payment notice.
2017-03-24Date of the second payment notice.
2017-04-24Date of the third payment notice.
2017-05-24Date of the fourth payment notice.
2017-06-24Principals notice costs.
10.00Order number
10232The principals reference
Volvo ABC-553Delay interest rate
8.0OrganisationUnitNumber of recipient
00371234567800001Temporary reference for sending
155Billnumber of collection invoices. Compulsory when invoice is sub invoice jobtype = 602.
123456The due date of the bill
2017-01-17Amount of one instalment in a payment schedule in euros.
100.00The number of instalments in a payment schedule.
5Interval between instalments of the payment schedule in months.
1Predefined filename. This value is returned in preview and localprint responseheader
preview.pdfThe date when the bill is recorded in the principals accounting. Contact our customer service before using this!
2017-02-17The name of the consumer client
Teppo NuutinenThe phone number of the customer/buyer/debtor
+358441234567Class of the letter in the post: 1 or 2
2The postal code of the customer
70100Should jobstatus be changed to 100: 1 = yes, 0 = no
1Bill number of the principal to which the credit note is allocated.
11213Assignment ID generated by Ropo to which the credit note is allocated.
31211Account number where credit note is payed
FI2112345600000785Message for payment of credit note
tm 22141739 tili 1514 va 4804Messagetype for payment of credit note: 1=Using reference, 3=Using message
3The code of the salesman
12Name or initials of the salesman
Sam SalesmanType of sending of the bill: post, print, email or evoice
postIs a payment notice sent automatically: 1=no, 0=yes
0Cost center id
1Cost center Name
Center XCost center code
123Site key in construction invoices.
TA-FI-STVOY0001-BSite number in construction invoices.
1234Reported to the site register: Y = yes, N = no
YTotal bill amount including VAT
19.96Total VAT amount of the bill
3.86VAT layout at invoice lines when only one is shown. 0 = Without VAT 1 = VAT included
0The VAT ID of the customer
FI22059054The date on which VAT is applied in the principals accounting. Contact our customer service before using this!
2017-02-17Voucher batch
43Voucher number
202132Reference of the buyer
Teppo NuutinenUsed to determine that invoice is Avtalegiro type
avtalegiroUsed to determine that invoice is Autogiro type
autogiroSuccessful operation
JobPatchOpenSalesInvoicesResponse
No content (no jobs were updated)
Bad request
Unauthorized
Forbidden (customer type mismatch)
PATCH /rest/jobs/opensalesinvoices?custnum=text&ordernumber=text HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 36475
{
"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": [
{
"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]"
]
}
]
}
]
}{
"opensalesinvoices": [
{
"jobid": "1234123",
"billnum": "4213451"
}
]
}JobDeliveryStatusRequest
Successful operation
No content
No content (no jobs were updated)
Bad request
Unauthorized
Forbidden
PATCH /rest/jobs/deliverystatus HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 158
{
"created_at": "text",
"id": "text",
"service": "text",
"data": [
{
"reporterid": "text",
"documentid": "text",
"status": "text",
"statustime": "text",
"description": "text"
}
]
}No content
Data identifier defined by customer for tracking purposes
Data type identifier
Job
Returns PDF
Bad request
Unauthorized
POST /rest/jobs/preview 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]"
}
]
}
]
}
}Data identifier defined by customer for tracking purposes
Data type identifier
Job
Returns PDF
Bad request
Unauthorized
POST /rest/jobs/localprint 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]"
}
]
}
]
}
}JobAddPayment
Amount of payment
710.00Reference of job. One of these required: 1.billcode, 2.jobid, 3. billnum (search order)
123467Billnum of job. One of these required: 1.billcode, 2.jobid, 3. billnum (search order)
R123467Id of job. One of these required: 1.billcode, 2.jobid, 3. billnum (search order)
123467Date of payment
2017-10-10Payment targeting identifier
insurancePayment type
directpaymentCredit note invoice number
26251Description of payment
Capital amount increased due to agreement change.Payment response
JobAddPaymentResponse
Id of job
123456Billnum of job
R12345Reference of job
123456Date of payment
2017-10-10Amount of payment
710.00Open capital before payment
710.00Open capital after payment
0.00Amount focused to opencapital
710.00Amount before to interest
0.00Amount after to interest
0.00Amount focused to interest
0.00Amount after to customer notice fee
0.00Amount before to customer notice fee
0.00Amount focused to customer notice fee
0.00Unfocused amount
0.000 : UNDONE, 1 : FAIL, 2 : OLD, 3 : ROPO, 4 : ROPO Refund, 5 : CLOSE, 6 : OHISPAY, 8 : IGNORE, 9 : DIFFCID, 10 : NOT FOUND, 11 : CANCELLED. Only with value 6 Http-Responsecode is 201 other 400
6additional information
Capital kirjattuBad request
Unauthorized
POST /rest/jobs/payment HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 241
{
"amount": "710.00",
"billcode": "123467",
"billnum": "R123467",
"jobid": "123467",
"paydate": "2017-10-10",
"identifier": "insurance",
"type": "directpayment",
"creditnotebillnum": "26251",
"description": "Capital amount increased due to agreement change."
}{
"jobid": "123456",
"billnum": "R12345",
"billcode": "123456",
"paydate": "2017-10-10",
"amount": "710.00",
"capitalbefore": "710.00",
"capitalafter": "0.00",
"focusedtocapital": "710.00",
"interestbefore": "0.00",
"interestafter": "0.00",
"focusedtointerest": "0.00",
"noticefeebefore": "0.00",
"noticefeeafter": "0.00",
"focusedtonoticefee": "0.00",
"unfocused": "0.00",
"statusid": "6",
"statustext": "Capital kirjattu"
}JobAddCreditNote
Amount of credit note
710.00Reference of job. One of these required: 1.billcode, 2.jobid, 3. billnum (search order)
123467Billnum of job. One of these required: 1.billcode, 2.jobid, 3. billnum (search order)
R123467Id of job. One of these required: 1.billcode, 2.jobid, 3. billnum (search order)
123467Date
2017-10-10Credit note type
allocatedCredit note invoice number
26251Description of credit note
Capital amount increased due to agreement change.Credit note response
JobAddCreditNoteResponse
Id of job
123456Billnum of job
R12345Reference of job
123456Date of credit note
2017-10-10Amount of credit note
710.000 : UNDONE, 1 : FAIL, 2 : OLD, 8 : IGNORE, 10 : NOT FOUND, 11 : CANCELLED, 12 = OLD CANCEL.
1additional information
Capital kirjattuBad request
Unauthorized
POST /rest/jobs/creditnote HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 209
{
"amount": "710.00",
"billcode": "123467",
"billnum": "R123467",
"jobid": "123467",
"date": "2017-10-10",
"type": "allocated",
"creditnotebillnum": "26251",
"description": "Capital amount increased due to agreement change."
}{
"jobid": "123456",
"billnum": "R12345",
"billcode": "123456",
"date": "2017-10-10",
"amount": "710.00",
"statusid": "1",
"statustext": "Capital kirjattu"
}Transferconfirmation batchid identifier
successful operation
No content
Bad request
report not found
GET /rest/jobs/transferconfirmation?batchid=text HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
No content
Job ID, required if invoice number not given.
Invoice number, required if job ID not given.
JobDisputeRequest
Returns success message if job was succesfully disputed.
JobDisputeResponse
Timestamp of the response.
Bad request
Unauthorized
Forbidden
Not Found
POST /rest/jobs/dispute HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 69
{
"data": {
"description": "More information on why case was disputed."
}
}{
"created_at": "text",
"data": [
{
"updated_at": "text",
"jobid": 1,
"billnum": "text",
"status": true,
"statustext": "text"
}
]
}Job ID, required if invoice_number not given.
Invoice number, required if job ID not given.
JobResolveDisputeRequest
Returns success message if job was succesfully resolved.
JobDisputeResponse
Timestamp of the response.
Bad request
Unauthorized
Forbidden
Not Found
POST /rest/jobs/dispute/resolve HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 69
{
"data": {
"description": "More information on why case was resolved."
}
}{
"created_at": "text",
"data": [
{
"updated_at": "text",
"jobid": 1,
"billnum": "text",
"status": true,
"statustext": "text"
}
]
}Social security number (HETU). Either ssn or custnum is required.
Customer number. Either ssn or custnum is required.
0 = open invoices only (default), 1 = all invoices including paid.
Jobs found
Bad request
Not found
POST /rest/jobs/findbyendcustomer HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 48
{
"ssn": "text",
"custnum": "text",
"all_invoices": 1
}{
"jobs": [
{
"case_number": 1,
"invoice_number": "text",
"original_invoice_date": "text",
"status": "text",
"open_amount": 1,
"group_job": 1,
"group_invoice_numbers": [
"text"
],
"group_total_payable": 1,
"my_ropo_link": "text"
}
]
}Last updated
Was this helpful?

