search

Invoice

Send an invoice to Ropo One via the REST API.

hashtag
Minimum invoice payload

At minimum, send one dataset item with:

  • jobtype

    • 0 = invoice (Embed or Unify service invoice)

    • 300 = print service (Information logistic invoice from Connect service model)

  • debtor details (person or company, address, postcode, city, customertype)

  • invoice dates (billdate, paydate)

  • at least one invoice row (payrow)

{
  "datastream": {
    "dataset": [
      {
        "jobtype": "0",
        "person": "Teppo Testaaja",
        "address": "Sammonkatu 23-25 A 7",
        "postcode": "70100",
        "city": "KUOPIO",
        "customertype": "2",
        "billdate": "2017-03-03",
        "paydate": "2017-03-17",
        "payrow": [
          {
            "desc": "Hieronta",
            "count": "1",
            "itemtype": "h",
            "amount": "35.00",
            "taxpr": "24.00"
          }
        ]
      }
    ]
  }
}

Depending on your use case, you can add extra fields and features.

hashtag
Additional invoice features

Use these when a basic invoice is not enough.

Attachmentschevron-rightCash discountchevron-rightPayment planschevron-rightFinancing and invoice purchasechevron-rightFixed fee (Late Payment Directive)chevron-rightConstruction site informationchevron-rightPrint service (own account and reference)chevron-right
Field
Description
Example
Info

addaddress

Delivery address or additional address to which a copy of the invoice will be sent

address

Address of the recipient

Mäkikatu 12 B 4

addressaddline1

The first accessory card in the contact card prints over the recipient's name

addressaddline2

The second address of the contact card is printed between the name and the street address

addresscountry

The home country of the recipient

FIN

attachment

appendix Documentary

billcode

A reference or message for a payment to be made to the invoice

billdate

Date of invoice in the form of YYYY-MM-DD

2026-02-02

billnum

The current number of the invoice in the accountant's account

billtemplate

Invoice Layout: CUSTOM, ECOM, BOBCAT, INC

CUSTOM

cashbill

Cash receipt, to be paid directly: 1 = cash receipt

1

checkbillnum

Make sure the bill number is unique: 1 = on

1

city

Debtor's post office

collectionprocess

The type of claim to determine collection process in use

company

The name of a corporate customer,

Matin konepaja Oy

country

The country where the customer company is registered

FIN

custnum

Client's customer number in the client's system

customertype

Client type: 1 = company, 2 = private person

1

deliverydate

Delivery date in the form of YYYY-MM-DD

2026-02-02

deliverymethod

Delivery method as text

deliveryterm

Delivery terms as text

email

The email address to which the invoice will be sent

[email protected]

email2

Another e-mail address to which the invoice will be sent

[email protected]

evoice

E-invoice address

FI123578612717718

evoiceint

Intermediary identifier for electronic billing

NDEAFIHH

freetext

Free text attached to the end of the invoice

govid

Customer ID or Identity ID

jobtype

Message type: 0 = invoice, 1 = reminder, 2 = debt collection, 300 = print service, 301 = mail service

0

language

Invoice language: eng, fin, swe, nor

eng

model

Make a mark, the cost of a customer account or any other reference

negvat

1, if the invoice is used for reverse taxation

1

ordernumber

Order number

ourcode

The principal's reference

Ford Transporter 1.2.2010-15.2.2010

overdueinterest

Overdue interest rate

8.00

ownref

Temporary delivery reference

paydate

Date of issue in the form of YYYY-MM-DD

2026-02-02

period

The date on which the invoice is recorded in the account of the principal

person

The name of the consumer customer

Teppo Testaaja

phone

Telephone number of the customer / buyer / debtor

postcode

Customer's postal code

70100

salesman

Seller ID

salesmanname

Seller name or initials

sendtype

Invoice sending method: post, print, email or evoice, evoicenet, evoicesm, peppol

post

sensible

The reminder reminder is automatically sent: 1 = no, 0 = yes

0

servicecode

Cost center, Ropo One™ system

vatid

Customer VAT ID

FI22059054

vatperiod

The date on which the VAT is charged in the account of the principal

voucherbatch

Voucher type

vouchernum

Voucher number

yourcode

Buyer's reference

Teppo Testaaja

advancepayment

Advance payments

hashtag
Add bills

post
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Header parameters
DataIdentifierstringOptional

Data identifier defined by customer for tracking purposes

DataTypeIdentifierstringOptional

Data type identifier

Content-TypestringOptional

Content type

Body

Job

Responses
post
/jobs
PreviousData transfer limits and ZIP uploadsNextPrices on the invoice row

Last updated

Was this helpful?