Search
Payer docsAPI - PlatformAPI - SignUpPayer.eu
HomePayer DocsPayer B2BPayer B2B EventsPayer B2B SignUp
Payer B2B
Introduction
Integration guidelines
Authentication
Authentication
Invoices V2
PUTSends a copy of an invoice.
POSTPays out the outstanding amount from a credit invoice back to the party that made the original payment.
POSTPays an invoice with an outstanding amount from a credit invoice.
POSTCreates a credit invoice with items that credits items from the original invoice, items to be credited are identified by item position.
POSTReturns a credit invoice for given line items.
POSTReturns a credit invoice for the full amount of the provided invoice.
GETReturns an invoice for a given invoice number
GETReturns invoices where the invoice customer have the given reg number or vat id
GETReturns all credit invoices for a given orderId or orderReferenceId
GETReturns invoices with invoice number >= than given invoice number
Invoices V3
Reporting V1
Card Payments
Orders V2
Bank Accounts
Invoice Reminders
Customers V1
Customers V2
Mobile Payments
Cloud Pos V1
Direct Bank Payments
Invoice Aggregations V2
Settlements V2
Payment Requests
Payments V2
Bank Payments V1
Subscriptions
Powered By

Payer B2B 1

Introduction

The Payer REST API enables you to create magic payment experiences - based on your customers needs. It puts you in the driver's seat with full control of the flow.

Each service has its own set of functions that delivers value individually and can be applied - before, during and after the order moment. This enables you to use the functions to deliver value just in the right micro-moment throughout your customer’s journey.

Even though the services can create value when used individually, combined, you can create magic.

Take command and use single functions or combos in your scenario in the right micro-moment and generate maximum value.

In need of some inspiration or don’t know where to start? Don’t hesitate to contact us for guidance, tips & tricks or examples of experiences to start from

Integration guidelines

Formats

  1. All amounts are in cents, e.g. if you're using USD the amounts will be in cent
  2. ISO-8601 Standard for date and time stamps.
  3. UTF-8 text encoding.

VAT

When specifying prices of items in Orders, the unitPrice and subtotalPrice fields are specified including VAT.

Non-breaking updates of the API

When using Payers API, your service should allow for dynamic changes. Such as:

  1. New valid values for enums may be added.
  2. New fields may be added to a response.

Retrying requests

When sending a non-GET HTTP request to the API, you can add a Payer-Request-ID header with a unique UUID to the request. This header allows you to retry the request (using the same Payer-Request-ID) if you're unsure whether or not Payer successfully handled the request. For example, if there was a network problem so that you couldn't receive the response to the request. If the request has already been handled, a 409 Conflict will be returned. GET requests are excluded from this mechanism, since it's always safe to do GET requests multiple times.

Authentication

Payer B2B uses authentication with a OAuth2 Bearer token for all endpoints except the authentication endpoint. For <credentials>, we use the Base64-encoded string of clientId:clientSecret. On macOS/Linux you can generate it with:

echo -n clientId:clientSecret | base64

On Windows, you can use certutil -encode.

Use the following command with your <credentials> to authenticate:

curl -X POST \
 https://b2b.payer.se/oauth2/token \
  -H 'Accept: application/json' \
  -H 'Authorization: Basic <credentials>' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d grant_type=client_credentials

The POST will return a JSON response containing an OAuth2 Bearer token:

{
    "access_token": "some-very-long-token",
    "expires_in": 3599,
    "scope": "",
    "token_type": "bearer"
}

For all other endpoints in Payer B2B, use the access_token from the response as OAuth2 Bearer token with the HTTP header Authorization: Bearer <some-very-long-token>.

The token expires in one hour. You will notice this in the form of a 401 Unauthorized reply to a request. You should act on this reply by performing a re-authentication and then retrying the request. You are also free to keep track of the token age yourself and renew before it expires.

Common authentication errors

If you are not able to access the API, some possible errors are:

  • The access token was not provided in the Authorization header.
  • The Authorization header was not prefixed with Bearer.
  • The access token has expired. Generate a new token and perform the request again.
  • You are not allowed to access the API. Contact Payer if you need access to additional APIs.

If you have other issues with authentication, contact Payer for assistance.

Server
https://b2b.payer.se

Generated server url

Server Variables

Authentication

oauth2 Authentication

FlowClient Credentials
Token URL/oauth2/token
Scopes
NameDescription
No scopes

Sends a copy of an invoice.

Auth
Required Scopes:READWRITE
Request Body
objectobject
addressobject
citystring
coAddressstring
companyNamestring
countryCodestring

Enum: AL,DZ,AS,AD,AO,AI,AQ,AG,AR,AM,AW,AU,AT,AZ,BS,BH,BD,BB,BE,BZ,BJ,BM,BT,BO,BQ,BA,BW,BV,BR,IO,BN,BG,BF,BI,CV,KH,CM,CA,KY,CF,TD,CL,CN,CX,CC,CO,KM,CD,CG,CK,CR,HR,CW,CY,CZ,CI,DK,DJ,DM,DO,EC,EG,SV,GQ,ER,EE,SZ,ET,FK,FO,FJ,FI,FR,GF,PF,TF,GA,GM,GE,DE,GH,GI,GR,GL,GD,GP,GU,GT,GG,GN,GW,GY,HT,HM,VA,HN,HK,HU,IS,IN,ID,IQ,IE,IM,IL,IT,JM,JP,JE,JO,KZ,KE,KI,KR,KW,KG,LA,LV,LB,LS,LR,LY,LI,LT,LU,MO,MG,MW,MY,MV,ML,MT,MH,MQ,MR,MU,YT,MX,FM,MD,MC,MN,ME,MS,MA,MZ,NA,NR,NP,NL,NC,NZ,NI,NE,NG,NU,NF,MP,NO,OM,PK,PW,PA,PG,PY,PE,PH,PN,PL,PT,PR,QA,MK,RO,RW,RE,BL,SH,KN,LC,MF,PM,VC,WS,SM,ST,SA,SN,RS,SC,SL,SG,SX,SK,SI,SB,SO,ZA,GS,SS,ES,LK,SD,SR,SJ,SE,CH,TW,TJ,TZ,TH,TL,TG,TK,TO,TT,TN,TR,TM,TC,TV,UG,UA,AE,GB,UM,US,UY,UZ,VU,VN,VG,VI,WF,EH,YE,ZM,ZW,AX

firstNamestring
houseAddressstring
lastNamestring
statestring
streetAddress1string
streetAddress2string
titlestring
yourReferencestring
zipCodestring
deliveryTypestring

Enum: NONE,EMAIL,PRINT,EINVOICE,SMS

emailCCarray[string]
emailTostring
glnstring
invoiceNumberint64
smsNumberstring
PUT /api/v2/orders/invoices/send
Copy
Responses
200

OK

No response body
400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error

503

Service Unavailable

Response
Copy

Pays out the outstanding amount from a credit invoice back to the party that made the original payment.

It is only possible to use credit invoices created with API V2.

Auth
Required Scopes:READWRITE
Request Body
objectobject
invoiceNumberint64
POST /api/v2/orders/invoices/payout-credit
Copy
Responses
200

OK

objectobject
amountint64
bankAccountPayoutobject

If the payout is performed directly to a bank account, this field will be present

maskedAccountNumberstring

The last digits of the account number that the payout is to, to help verification without showing sensitive data

payoutJobIdstring
transactionMessagestring
currencyCodestring

Enum: DKK,EUR,GBP,NOK,SEK,USD,CHF

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error

503

Service Unavailable

Response
Copy

Pays an invoice with an outstanding amount from a credit invoice.

It is only possible to use invoices and credit invoices created with API V2.

Auth
Required Scopes:READWRITE
Request Body
objectobject
amountint64

minimum: 1

creditInvoiceNumberint64
toPayInvoiceAggregationIdstring

The Monthly Invoice Statement that should be paid. One of toPayInvoiceNumber and toPayInvoiceAggregationId is required.

toPayInvoiceNumberint64

The Invoice that should be paid. One of toPayInvoiceNumber and toPayInvoiceAggregationId is required.

POST /api/v2/orders/invoices/pay-with-credit
Copy
Responses
200

OK

No response body
400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error

503

Service Unavailable

Response
Copy

Creates a credit invoice with items that credits items from the original invoice, items to be credited are identified by item position.

An Invoice created with the V2 API can only be credited using the V2 API A credit invoice can be linked to the original invoice or it can be standalone. When using the standalone credit invoice as payment for another invoice, the original invoice will not be affected - no debt will be added to the original invoice. Either invoiceNumber or referenceId must be provided

Auth
Required Scopes:READWRITE
Request Body
objectobject
externalInvoiceNumberstring

Optional external invoiceNumber when this credit invoice is a mirror of credit invoice in an external system. Must be unique.

maxLength: 36

minLength: 0

invoiceDatedate

Invoice date can not be in the future. If not specified, defaults to today.

invoiceNumberint64

Required if no referenceId is provided.

itemsarray[object]

Positions and quantities to be credited from the original invoice

positionint32
quantitynumber

minimum: 0

referenceIdstring

Required if no invoiceNumber is provided.

maxLength: 64

minLength: 0

standaloneboolean

true means that this credit invoice will be a standalone credit invoice with no link to the original invoice.

POST /api/v2/orders/invoices/credit/partial
Copy
Responses
200

OK

objectobject
invoiceobject
amountToPayint64

Amount to pay in cents, 10 SEK = 1000

balanceint64

Balance of the invoice. A positive value means that there's outstanding amount for buyer to pay to seller. In cents, 10 SEK = 1000

calculationModestring

Enum: EX_VAT_ROUNDING_PER_ROW,EX_VAT_ROUNDING_AFTER_SUM,INC_VAT_ROUNDING_PER_ROW

countryCodestring

Enum: AL,DZ,AS,AD,AO,AI,AQ,AG,AR,AM,AW,AU,AT,AZ,BS,BH,BD,BB,BE,BZ,BJ,BM,BT,BO,BQ,BA,BW,BV,BR,IO,BN,BG,BF,BI,CV,KH,CM,CA,KY,CF,TD,CL,CN,CX,CC,CO,KM,CD,CG,CK,CR,HR,CW,CY,CZ,CI,DK,DJ,DM,DO,EC,EG,SV,GQ,ER,EE,SZ,ET,FK,FO,FJ,FI,FR,GF,PF,TF,GA,GM,GE,DE,GH,GI,GR,GL,GD,GP,GU,GT,GG,GN,GW,GY,HT,HM,VA,HN,HK,HU,IS,IN,ID,IQ,IE,IM,IL,IT,JM,JP,JE,JO,KZ,KE,KI,KR,KW,KG,LA,LV,LB,LS,LR,LY,LI,LT,LU,MO,MG,MW,MY,MV,ML,MT,MH,MQ,MR,MU,YT,MX,FM,MD,MC,MN,ME,MS,MA,MZ,NA,NR,NP,NL,NC,NZ,NI,NE,NG,NU,NF,MP,NO,OM,PK,PW,PA,PG,PY,PE,PH,PN,PL,PT,PR,QA,MK,RO,RW,RE,BL,SH,KN,LC,MF,PM,VC,WS,SM,ST,SA,SN,RS,SC,SL,SG,SX,SK,SI,SB,SO,ZA,GS,SS,ES,LK,SD,SR,SJ,SE,CH,TW,TJ,TZ,TH,TL,TG,TK,TO,TT,TN,TR,TM,TC,TV,UG,UA,AE,GB,UM,US,UY,UZ,VU,VN,VG,VI,WF,EH,YE,ZM,ZW,AX

creditedAmountint64
creditsInvoiceWithInvoiceNumberint64

If this is a credit invoice, this will be the invoice number of the original invoice

currencyCodestring

Enum: DKK,EUR,GBP,NOK,SEK,USD,CHF

deliveryTypestring

Enum: NONE,EMAIL,PRINT,EINVOICE,SMS

dueDatedate
externalInvoiceNumberstring
feeBalanceint64
invoiceCustomerobject
addressobject
citystring

maxLength: 48

minLength: 0

coAddressstring

maxLength: 128

minLength: 0

companyNamestring

maxLength: 128

minLength: 0

countryCodestring

Enum: AL,DZ,AS,AD,AO,AI,AQ,AG,AR,AM,AW,AU,AT,AZ,BS,BH,BD,BB,BE,BZ,BJ,BM,BT,BO,BQ,BA,BW,BV,BR,IO,BN,BG,BF,BI,CV,KH,CM,CA,KY,CF,TD,CL,CN,CX,CC,CO,KM,CD,CG,CK,CR,HR,CW,CY,CZ,CI,DK,DJ,DM,DO,EC,EG,SV,GQ,ER,EE,SZ,ET,FK,FO,FJ,FI,FR,GF,PF,TF,GA,GM,GE,DE,GH,GI,GR,GL,GD,GP,GU,GT,GG,GN,GW,GY,HT,HM,VA,HN,HK,HU,IS,IN,ID,IQ,IE,IM,IL,IT,JM,JP,JE,JO,KZ,KE,KI,KR,KW,KG,LA,LV,LB,LS,LR,LY,LI,LT,LU,MO,MG,MW,MY,MV,ML,MT,MH,MQ,MR,MU,YT,MX,FM,MD,MC,MN,ME,MS,MA,MZ,NA,NR,NP,NL,NC,NZ,NI,NE,NG,NU,NF,MP,NO,OM,PK,PW,PA,PG,PY,PE,PH,PN,PL,PT,PR,QA,MK,RO,RW,RE,BL,SH,KN,LC,MF,PM,VC,WS,SM,ST,SA,SN,RS,SC,SL,SG,SX,SK,SI,SB,SO,ZA,GS,SS,ES,LK,SD,SR,SJ,SE,CH,TW,TJ,TZ,TH,TL,TG,TK,TO,TT,TN,TR,TM,TC,TV,UG,UA,AE,GB,UM,US,UY,UZ,VU,VN,VG,VI,WF,EH,YE,ZM,ZW,AX

emailAddressstring

maxLength: 128

minLength: 0

emailAddressBccstring

maxLength: 128

minLength: 0

emailAddressCcstring

maxLength: 128

minLength: 0

firstNamestring

maxLength: 48

minLength: 0

glnstring

maxLength: 128

minLength: 0

houseAddressstring

maxLength: 128

minLength: 0

languageCodestring

Enum: aa,ab,ae,af,ak,am,an,ar,as,av,ay,az,ba,be,bg,bh,bm,bi,bn,bo,br,bs,ca,ce,ch,co,cr,cs,cu,cv,cy,da,de,dv,dz,ee,el,en,eo,es,et,eu,fa,ff,fi,fj,fo,fr,fy,ga,gd,gl,gn,gu,gv,ha,he,hi,ho,hr,ht,hu,hy,hz,ia,id,ie,ig,ii,ik,io,is,it,iu,ja,jv,ka,kg,ki,kj,kk,kl,km,kn,ko,kr,ks,ku,kv,kw,ky,la,lb,lg,li,ln,lo,lt,lu,lv,mg,mh,mi,mk,ml,mn,mr,ms,mt,my,na,nb,nd,ne,ng,nl,nn,no,nr,nv,ny,oc,oj,om,or,os,pa,pi,pl,ps,pt,qu,rm,rn,ro,ru,rw,sa,sc,sd,se,sg,si,sk,sl,sm,sn,so,sq,sr,ss,st,su,sv,sw,ta,te,tg,th,ti,tk,tl,tn,to,tr,ts,tt,tw,ty,ug,uk,ur,uz,ve,vi,vo,wa,wo,xh,yi,yo,za,zh,zu

lastNamestring

maxLength: 48

minLength: 0

phoneNumberstring

maxLength: 128

minLength: 0

statestring

maxLength: 64

minLength: 0

streetAddress1string

maxLength: 128

minLength: 0

streetAddress2string

maxLength: 128

minLength: 0

titlestring

maxLength: 24

minLength: 0

yourReferencestring

maxLength: 48

minLength: 0

zipCodestring

maxLength: 20

minLength: 0

customerNumberstring

maxLength: 48

minLength: 0

customerTypestring

Enum: PRIVATE,ORGANISATION,MUNICIPAL

customerVatIdstring

maxLength: 48

minLength: 0

regNumberstring

Organisation number for companies, social security number for persons. Needs to be in a valid format. For some countries the specified regNumber will be reformatted slightly internally to match standard formatting for the country.

maxLength: 48

minLength: 0

websiteUrlstring

maxLength: 128

minLength: 0

invoiceDatedate
invoiceNumberstring
invoicePdfUrlstring
invoicePeriodobject
endDatedate

Indicate the end date of this invoice period

startDatedate

Indicate the start date of this invoice period

isOverdueboolean
items
objectobject
additionalDetailstring
articleNumberstring

Mandatory for FREEFORM line items.

calculationModestring

Identifies which of the three Item calculation modes that this item uses. Hint: Use a deserializer that supports polymorphic deserialization and let it use this attribute to decide which sub model to use.

Enum: EX_VAT_ROUNDING_PER_ROW,EX_VAT_ROUNDING_AFTER_SUM,INC_VAT_ROUNDING_PER_ROW,EX_VAT_ROUNDING_PER_ROW,EX_VAT_ROUNDING_AFTER_SUM,INC_VAT_ROUNDING_PER_ROW

costCenterstring
descriptionstring
itemTypestring

Enum: FREEFORM,INFOLINE

positionint32
quantitynumber

Maximum 6 decimals.

salesAccountCodeint32
unitstring
vatAccountCodeint32
unitPriceExcludingVatnumber

Unit price in decimal form, excluding VAT. Maximum 6 decimals.

vatPercentagenumber

VAT percentage in decimal form. Maximum 2 decimals.

orderApproveDatedate-time
orderIdint64
orderReferenceIdstring
orderStatusstring

Enum: NEW,APPROVED,DENIED

ourReferencestring
parentInvoiceNumberint64
paymentBankAccountsarray[object]
accountHolderCountrystring

Enum: AL,DZ,AS,AD,AO,AI,AQ,AG,AR,AM,AW,AU,AT,AZ,BS,BH,BD,BB,BE,BZ,BJ,BM,BT,BO,BQ,BA,BW,BV,BR,IO,BN,BG,BF,BI,CV,KH,CM,CA,KY,CF,TD,CL,CN,CX,CC,CO,KM,CD,CG,CK,CR,HR,CW,CY,CZ,CI,DK,DJ,DM,DO,EC,EG,SV,GQ,ER,EE,SZ,ET,FK,FO,FJ,FI,FR,GF,PF,TF,GA,GM,GE,DE,GH,GI,GR,GL,GD,GP,GU,GT,GG,GN,GW,GY,HT,HM,VA,HN,HK,HU,IS,IN,ID,IQ,IE,IM,IL,IT,JM,JP,JE,JO,KZ,KE,KI,KR,KW,KG,LA,LV,LB,LS,LR,LY,LI,LT,LU,MO,MG,MW,MY,MV,ML,MT,MH,MQ,MR,MU,YT,MX,FM,MD,MC,MN,ME,MS,MA,MZ,NA,NR,NP,NL,NC,NZ,NI,NE,NG,NU,NF,MP,NO,OM,PK,PW,PA,PG,PY,PE,PH,PN,PL,PT,PR,QA,MK,RO,RW,RE,BL,SH,KN,LC,MF,PM,VC,WS,SM,ST,SA,SN,RS,SC,SL,SG,SX,SK,SI,SB,SO,ZA,GS,SS,ES,LK,SD,SR,SJ,SE,CH,TW,TJ,TZ,TH,TL,TG,TK,TO,TT,TN,TR,TM,TC,TV,UG,UA,AE,GB,UM,US,UY,UZ,VU,VN,VG,VI,WF,EH,YE,ZM,ZW,AX

accountHolderNamestring
accountNumberstring
bicstring
typestring

Enum: BANKGIRO,PLUSGIRO,IBAN,SE_GENERIC

paymentStatusstring

Enum: UNPAID,RESERVED,PARTIALLY_PAID,PAID,UNUSED,PARTIALLY_USED,USED

paymentsarray[object]
amountint64

Amount in cents, 10 SEK = 1000

bookingDatedate

Always the date the payment was booked on the account.

currencyCodestring

Enum: DKK,EUR,GBP,NOK,SEK,USD,CHF

effectiveBookingDatedate

The date the payment was booked on the account, unless it was manually mapped. In that case it is the date the mapping was done.

paymentDatedate-time
referenceNumberstring
typestring

Enum: BANK,CARD,POS,DIRECT_BANK,SWISH,KLARNA,CREDIT_INVOICE,MANUAL,WRITE_OFF,REBALANCED,EXPECTED_BAD_WRITE_OFF,BAD_DEBT_WRITE_OFF

projectstring
publicInvoiceUrlstring
referenceNumberstring
remindersarray[object]
creationTimedate-time
deliveryTypesarray[string]

Enum: NONE,EMAIL,PRINT,EINVOICE,SMS

modifiedTimedate-time
reminderNumberint32
remindersAreCancelledboolean
sellingCustomerobject
addressobject
citystring

maxLength: 48

minLength: 0

coAddressstring

maxLength: 128

minLength: 0

companyNamestring

maxLength: 128

minLength: 0

countryCodestring

Enum: AL,DZ,AS,AD,AO,AI,AQ,AG,AR,AM,AW,AU,AT,AZ,BS,BH,BD,BB,BE,BZ,BJ,BM,BT,BO,BQ,BA,BW,BV,BR,IO,BN,BG,BF,BI,CV,KH,CM,CA,KY,CF,TD,CL,CN,CX,CC,CO,KM,CD,CG,CK,CR,HR,CW,CY,CZ,CI,DK,DJ,DM,DO,EC,EG,SV,GQ,ER,EE,SZ,ET,FK,FO,FJ,FI,FR,GF,PF,TF,GA,GM,GE,DE,GH,GI,GR,GL,GD,GP,GU,GT,GG,GN,GW,GY,HT,HM,VA,HN,HK,HU,IS,IN,ID,IQ,IE,IM,IL,IT,JM,JP,JE,JO,KZ,KE,KI,KR,KW,KG,LA,LV,LB,LS,LR,LY,LI,LT,LU,MO,MG,MW,MY,MV,ML,MT,MH,MQ,MR,MU,YT,MX,FM,MD,MC,MN,ME,MS,MA,MZ,NA,NR,NP,NL,NC,NZ,NI,NE,NG,NU,NF,MP,NO,OM,PK,PW,PA,PG,PY,PE,PH,PN,PL,PT,PR,QA,MK,RO,RW,RE,BL,SH,KN,LC,MF,PM,VC,WS,SM,ST,SA,SN,RS,SC,SL,SG,SX,SK,SI,SB,SO,ZA,GS,SS,ES,LK,SD,SR,SJ,SE,CH,TW,TJ,TZ,TH,TL,TG,TK,TO,TT,TN,TR,TM,TC,TV,UG,UA,AE,GB,UM,US,UY,UZ,VU,VN,VG,VI,WF,EH,YE,ZM,ZW,AX

emailAddressstring

maxLength: 128

minLength: 0

emailAddressBccstring

maxLength: 128

minLength: 0

emailAddressCcstring

maxLength: 128

minLength: 0

firstNamestring

maxLength: 48

minLength: 0

glnstring

maxLength: 128

minLength: 0

houseAddressstring

maxLength: 128

minLength: 0

languageCodestring

Enum: aa,ab,ae,af,ak,am,an,ar,as,av,ay,az,ba,be,bg,bh,bm,bi,bn,bo,br,bs,ca,ce,ch,co,cr,cs,cu,cv,cy,da,de,dv,dz,ee,el,en,eo,es,et,eu,fa,ff,fi,fj,fo,fr,fy,ga,gd,gl,gn,gu,gv,ha,he,hi,ho,hr,ht,hu,hy,hz,ia,id,ie,ig,ii,ik,io,is,it,iu,ja,jv,ka,kg,ki,kj,kk,kl,km,kn,ko,kr,ks,ku,kv,kw,ky,la,lb,lg,li,ln,lo,lt,lu,lv,mg,mh,mi,mk,ml,mn,mr,ms,mt,my,na,nb,nd,ne,ng,nl,nn,no,nr,nv,ny,oc,oj,om,or,os,pa,pi,pl,ps,pt,qu,rm,rn,ro,ru,rw,sa,sc,sd,se,sg,si,sk,sl,sm,sn,so,sq,sr,ss,st,su,sv,sw,ta,te,tg,th,ti,tk,tl,tn,to,tr,ts,tt,tw,ty,ug,uk,ur,uz,ve,vi,vo,wa,wo,xh,yi,yo,za,zh,zu

lastNamestring

maxLength: 48

minLength: 0

phoneNumberstring

maxLength: 128

minLength: 0

statestring

maxLength: 64

minLength: 0

streetAddress1string

maxLength: 128

minLength: 0

streetAddress2string

maxLength: 128

minLength: 0

titlestring

maxLength: 24

minLength: 0

yourReferencestring

maxLength: 48

minLength: 0

zipCodestring

maxLength: 20

minLength: 0

customerNumberstring

maxLength: 48

minLength: 0

customerTypestring

Enum: PRIVATE,ORGANISATION,MUNICIPAL

customerVatIdstring

maxLength: 48

minLength: 0

regNumberstring

Organisation number for companies, social security number for persons. Needs to be in a valid format. For some countries the specified regNumber will be reformatted slightly internally to match standard formatting for the country.

maxLength: 48

minLength: 0

websiteUrlstring

maxLength: 128

minLength: 0

sitestring
statusstring

Enum: NEW,CANCELLED

storeIdstring

Deprecated. Use 'site' instead.

typestring

Enum: PREPAYMENT,NORMAL

uniqueIdstring
websiteInvoiceSeqNoint64
400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error

503

Service Unavailable

Response
Copy

Returns a credit invoice for given line items.

An Invoice created with the V2 API can only be credited using the V2 API A credit invoice can be linked to the original invoice or it can be standalone. When using the standalone credit invoice as payment for another invoice, the original invoice will not be affected - no debt will be added to the original invoice. Either invoiceNumber or referenceId must be provided

Auth
Required Scopes:READWRITE
Request Body
objectobject
deliveryTypestring

Enum: NONE,EMAIL,PRINT,EINVOICE,SMS

externalInvoiceNumberstring

Optional external invoiceNumber when this credit invoice is a mirror of credit invoice in an external system. Must be unique.

maxLength: 36

minLength: 0

invoiceDatedate

Invoice date can not be in the future. If not specified, defaults to today.

invoiceNumberint64

Required if no referenceId is provided.

itemsarray[object]

List of the items to be included on the credit invoice. All subtotalPrices will be negated.

additionalDetailstring

maxLength: 48

minLength: 0

articleNumberstring

Mandatory for FREEFORM line items.

maxLength: 64

minLength: 0

costCenterstring

maxLength: 48

minLength: 0

descriptionstring

maxLength: 128

minLength: 0

eanstring

maxLength: 64

minLength: 0

itemTypestring

Use itemType FREEFORM in item for articles to be paid. Use itemType INFOLINE if you want to add information after or before an order row to complement with free text. The position set in the items handles in which order items are shown in the invoice. When using INFOLINE, the following fields are hidden if the order results in an invoice: articleNumber, price, vat, quantity

Enum: FREEFORM,INFOLINE

positionint32
quantityint32

Needs to be at least 1

minimum: 1

salesAccountCodeint32

For FREEFORM lines with a quantity != 0, if this is set, it must be between 1000-9999

subtotalPriceint64

Subtotal price including VAT in cents, 10 SEK = 1000

subtotalVatAmountint64

Subtotal VAT amount in cents, 10 SEK = 1000

unitstring

maxLength: 16

minLength: 0

unitPriceint64

Unit price in cents including VAT, 10 SEK = 1000

unitVatAmountint64

Unit VAT amount in cents, 10 SEK = 1000

uristring

maxLength: 248

minLength: 0

vatAccountCodeint32
vatPercentageint32

VAT percentage in cents, 25% = 2500

referenceIdstring

Required if no invoiceNumber is provided.

maxLength: 64

minLength: 0

standaloneboolean

true means that this credit invoice will be a standalone credit invoice with no link to the original invoice.

POST /api/v2/orders/invoices/credit/manual
Copy
Responses
200

OK

objectobject
invoiceobject
amountToPayint64

Amount to pay in cents, 10 SEK = 1000

balanceint64

Balance of the invoice. A positive value means that there's outstanding amount for buyer to pay to seller. In cents, 10 SEK = 1000

calculationModestring

Enum: EX_VAT_ROUNDING_PER_ROW,EX_VAT_ROUNDING_AFTER_SUM,INC_VAT_ROUNDING_PER_ROW

countryCodestring

Enum: AL,DZ,AS,AD,AO,AI,AQ,AG,AR,AM,AW,AU,AT,AZ,BS,BH,BD,BB,BE,BZ,BJ,BM,BT,BO,BQ,BA,BW,BV,BR,IO,BN,BG,BF,BI,CV,KH,CM,CA,KY,CF,TD,CL,CN,CX,CC,CO,KM,CD,CG,CK,CR,HR,CW,CY,CZ,CI,DK,DJ,DM,DO,EC,EG,SV,GQ,ER,EE,SZ,ET,FK,FO,FJ,FI,FR,GF,PF,TF,GA,GM,GE,DE,GH,GI,GR,GL,GD,GP,GU,GT,GG,GN,GW,GY,HT,HM,VA,HN,HK,HU,IS,IN,ID,IQ,IE,IM,IL,IT,JM,JP,JE,JO,KZ,KE,KI,KR,KW,KG,LA,LV,LB,LS,LR,LY,LI,LT,LU,MO,MG,MW,MY,MV,ML,MT,MH,MQ,MR,MU,YT,MX,FM,MD,MC,MN,ME,MS,MA,MZ,NA,NR,NP,NL,NC,NZ,NI,NE,NG,NU,NF,MP,NO,OM,PK,PW,PA,PG,PY,PE,PH,PN,PL,PT,PR,QA,MK,RO,RW,RE,BL,SH,KN,LC,MF,PM,VC,WS,SM,ST,SA,SN,RS,SC,SL,SG,SX,SK,SI,SB,SO,ZA,GS,SS,ES,LK,SD,SR,SJ,SE,CH,TW,TJ,TZ,TH,TL,TG,TK,TO,TT,TN,TR,TM,TC,TV,UG,UA,AE,GB,UM,US,UY,UZ,VU,VN,VG,VI,WF,EH,YE,ZM,ZW,AX

creditedAmountint64
creditsInvoiceWithInvoiceNumberint64

If this is a credit invoice, this will be the invoice number of the original invoice

currencyCodestring

Enum: DKK,EUR,GBP,NOK,SEK,USD,CHF

deliveryTypestring

Enum: NONE,EMAIL,PRINT,EINVOICE,SMS

dueDatedate
externalInvoiceNumberstring
feeBalanceint64
invoiceCustomerobject
addressobject
citystring

maxLength: 48

minLength: 0

coAddressstring

maxLength: 128

minLength: 0

companyNamestring

maxLength: 128

minLength: 0

countryCodestring

Enum: AL,DZ,AS,AD,AO,AI,AQ,AG,AR,AM,AW,AU,AT,AZ,BS,BH,BD,BB,BE,BZ,BJ,BM,BT,BO,BQ,BA,BW,BV,BR,IO,BN,BG,BF,BI,CV,KH,CM,CA,KY,CF,TD,CL,CN,CX,CC,CO,KM,CD,CG,CK,CR,HR,CW,CY,CZ,CI,DK,DJ,DM,DO,EC,EG,SV,GQ,ER,EE,SZ,ET,FK,FO,FJ,FI,FR,GF,PF,TF,GA,GM,GE,DE,GH,GI,GR,GL,GD,GP,GU,GT,GG,GN,GW,GY,HT,HM,VA,HN,HK,HU,IS,IN,ID,IQ,IE,IM,IL,IT,JM,JP,JE,JO,KZ,KE,KI,KR,KW,KG,LA,LV,LB,LS,LR,LY,LI,LT,LU,MO,MG,MW,MY,MV,ML,MT,MH,MQ,MR,MU,YT,MX,FM,MD,MC,MN,ME,MS,MA,MZ,NA,NR,NP,NL,NC,NZ,NI,NE,NG,NU,NF,MP,NO,OM,PK,PW,PA,PG,PY,PE,PH,PN,PL,PT,PR,QA,MK,RO,RW,RE,BL,SH,KN,LC,MF,PM,VC,WS,SM,ST,SA,SN,RS,SC,SL,SG,SX,SK,SI,SB,SO,ZA,GS,SS,ES,LK,SD,SR,SJ,SE,CH,TW,TJ,TZ,TH,TL,TG,TK,TO,TT,TN,TR,TM,TC,TV,UG,UA,AE,GB,UM,US,UY,UZ,VU,VN,VG,VI,WF,EH,YE,ZM,ZW,AX

emailAddressstring

maxLength: 128

minLength: 0

emailAddressBccstring

maxLength: 128

minLength: 0

emailAddressCcstring

maxLength: 128

minLength: 0

firstNamestring

maxLength: 48

minLength: 0

glnstring

maxLength: 128

minLength: 0

houseAddressstring

maxLength: 128

minLength: 0

languageCodestring

Enum: aa,ab,ae,af,ak,am,an,ar,as,av,ay,az,ba,be,bg,bh,bm,bi,bn,bo,br,bs,ca,ce,ch,co,cr,cs,cu,cv,cy,da,de,dv,dz,ee,el,en,eo,es,et,eu,fa,ff,fi,fj,fo,fr,fy,ga,gd,gl,gn,gu,gv,ha,he,hi,ho,hr,ht,hu,hy,hz,ia,id,ie,ig,ii,ik,io,is,it,iu,ja,jv,ka,kg,ki,kj,kk,kl,km,kn,ko,kr,ks,ku,kv,kw,ky,la,lb,lg,li,ln,lo,lt,lu,lv,mg,mh,mi,mk,ml,mn,mr,ms,mt,my,na,nb,nd,ne,ng,nl,nn,no,nr,nv,ny,oc,oj,om,or,os,pa,pi,pl,ps,pt,qu,rm,rn,ro,ru,rw,sa,sc,sd,se,sg,si,sk,sl,sm,sn,so,sq,sr,ss,st,su,sv,sw,ta,te,tg,th,ti,tk,tl,tn,to,tr,ts,tt,tw,ty,ug,uk,ur,uz,ve,vi,vo,wa,wo,xh,yi,yo,za,zh,zu

lastNamestring

maxLength: 48

minLength: 0

phoneNumberstring

maxLength: 128

minLength: 0

statestring

maxLength: 64

minLength: 0

streetAddress1string

maxLength: 128

minLength: 0

streetAddress2string

maxLength: 128

minLength: 0

titlestring

maxLength: 24

minLength: 0

yourReferencestring

maxLength: 48

minLength: 0

zipCodestring

maxLength: 20

minLength: 0

customerNumberstring

maxLength: 48

minLength: 0

customerTypestring

Enum: PRIVATE,ORGANISATION,MUNICIPAL

customerVatIdstring

maxLength: 48

minLength: 0

regNumberstring

Organisation number for companies, social security number for persons. Needs to be in a valid format. For some countries the specified regNumber will be reformatted slightly internally to match standard formatting for the country.

maxLength: 48

minLength: 0

websiteUrlstring

maxLength: 128

minLength: 0

invoiceDatedate
invoiceNumberstring
invoicePdfUrlstring
invoicePeriodobject
endDatedate

Indicate the end date of this invoice period

startDatedate

Indicate the start date of this invoice period

isOverdueboolean
items
objectobject
additionalDetailstring
articleNumberstring

Mandatory for FREEFORM line items.

calculationModestring

Identifies which of the three Item calculation modes that this item uses. Hint: Use a deserializer that supports polymorphic deserialization and let it use this attribute to decide which sub model to use.

Enum: EX_VAT_ROUNDING_PER_ROW,EX_VAT_ROUNDING_AFTER_SUM,INC_VAT_ROUNDING_PER_ROW,EX_VAT_ROUNDING_PER_ROW,EX_VAT_ROUNDING_AFTER_SUM,INC_VAT_ROUNDING_PER_ROW

costCenterstring
descriptionstring
itemTypestring

Enum: FREEFORM,INFOLINE

positionint32
quantitynumber

Maximum 6 decimals.

salesAccountCodeint32
unitstring
vatAccountCodeint32
unitPriceExcludingVatnumber

Unit price in decimal form, excluding VAT. Maximum 6 decimals.

vatPercentagenumber

VAT percentage in decimal form. Maximum 2 decimals.

orderApproveDatedate-time
orderIdint64
orderReferenceIdstring
orderStatusstring

Enum: NEW,APPROVED,DENIED

ourReferencestring
parentInvoiceNumberint64
paymentBankAccountsarray[object]
accountHolderCountrystring

Enum: AL,DZ,AS,AD,AO,AI,AQ,AG,AR,AM,AW,AU,AT,AZ,BS,BH,BD,BB,BE,BZ,BJ,BM,BT,BO,BQ,BA,BW,BV,BR,IO,BN,BG,BF,BI,CV,KH,CM,CA,KY,CF,TD,CL,CN,CX,CC,CO,KM,CD,CG,CK,CR,HR,CW,CY,CZ,CI,DK,DJ,DM,DO,EC,EG,SV,GQ,ER,EE,SZ,ET,FK,FO,FJ,FI,FR,GF,PF,TF,GA,GM,GE,DE,GH,GI,GR,GL,GD,GP,GU,GT,GG,GN,GW,GY,HT,HM,VA,HN,HK,HU,IS,IN,ID,IQ,IE,IM,IL,IT,JM,JP,JE,JO,KZ,KE,KI,KR,KW,KG,LA,LV,LB,LS,LR,LY,LI,LT,LU,MO,MG,MW,MY,MV,ML,MT,MH,MQ,MR,MU,YT,MX,FM,MD,MC,MN,ME,MS,MA,MZ,NA,NR,NP,NL,NC,NZ,NI,NE,NG,NU,NF,MP,NO,OM,PK,PW,PA,PG,PY,PE,PH,PN,PL,PT,PR,QA,MK,RO,RW,RE,BL,SH,KN,LC,MF,PM,VC,WS,SM,ST,SA,SN,RS,SC,SL,SG,SX,SK,SI,SB,SO,ZA,GS,SS,ES,LK,SD,SR,SJ,SE,CH,TW,TJ,TZ,TH,TL,TG,TK,TO,TT,TN,TR,TM,TC,TV,UG,UA,AE,GB,UM,US,UY,UZ,VU,VN,VG,VI,WF,EH,YE,ZM,ZW,AX

accountHolderNamestring
accountNumberstring
bicstring
typestring

Enum: BANKGIRO,PLUSGIRO,IBAN,SE_GENERIC

paymentStatusstring

Enum: UNPAID,RESERVED,PARTIALLY_PAID,PAID,UNUSED,PARTIALLY_USED,USED

paymentsarray[object]
amountint64

Amount in cents, 10 SEK = 1000

bookingDatedate

Always the date the payment was booked on the account.

currencyCodestring

Enum: DKK,EUR,GBP,NOK,SEK,USD,CHF

effectiveBookingDatedate

The date the payment was booked on the account, unless it was manually mapped. In that case it is the date the mapping was done.

paymentDatedate-time
referenceNumberstring
typestring

Enum: BANK,CARD,POS,DIRECT_BANK,SWISH,KLARNA,CREDIT_INVOICE,MANUAL,WRITE_OFF,REBALANCED,EXPECTED_BAD_WRITE_OFF,BAD_DEBT_WRITE_OFF

projectstring
publicInvoiceUrlstring
referenceNumberstring
remindersarray[object]
creationTimedate-time
deliveryTypesarray[string]

Enum: NONE,EMAIL,PRINT,EINVOICE,SMS

modifiedTimedate-time
reminderNumberint32
remindersAreCancelledboolean
sellingCustomerobject
addressobject
citystring

maxLength: 48

minLength: 0

coAddressstring

maxLength: 128

minLength: 0

companyNamestring

maxLength: 128

minLength: 0

countryCodestring

Enum: AL,DZ,AS,AD,AO,AI,AQ,AG,AR,AM,AW,AU,AT,AZ,BS,BH,BD,BB,BE,BZ,BJ,BM,BT,BO,BQ,BA,BW,BV,BR,IO,BN,BG,BF,BI,CV,KH,CM,CA,KY,CF,TD,CL,CN,CX,CC,CO,KM,CD,CG,CK,CR,HR,CW,CY,CZ,CI,DK,DJ,DM,DO,EC,EG,SV,GQ,ER,EE,SZ,ET,FK,FO,FJ,FI,FR,GF,PF,TF,GA,GM,GE,DE,GH,GI,GR,GL,GD,GP,GU,GT,GG,GN,GW,GY,HT,HM,VA,HN,HK,HU,IS,IN,ID,IQ,IE,IM,IL,IT,JM,JP,JE,JO,KZ,KE,KI,KR,KW,KG,LA,LV,LB,LS,LR,LY,LI,LT,LU,MO,MG,MW,MY,MV,ML,MT,MH,MQ,MR,MU,YT,MX,FM,MD,MC,MN,ME,MS,MA,MZ,NA,NR,NP,NL,NC,NZ,NI,NE,NG,NU,NF,MP,NO,OM,PK,PW,PA,PG,PY,PE,PH,PN,PL,PT,PR,QA,MK,RO,RW,RE,BL,SH,KN,LC,MF,PM,VC,WS,SM,ST,SA,SN,RS,SC,SL,SG,SX,SK,SI,SB,SO,ZA,GS,SS,ES,LK,SD,SR,SJ,SE,CH,TW,TJ,TZ,TH,TL,TG,TK,TO,TT,TN,TR,TM,TC,TV,UG,UA,AE,GB,UM,US,UY,UZ,VU,VN,VG,VI,WF,EH,YE,ZM,ZW,AX

emailAddressstring

maxLength: 128

minLength: 0

emailAddressBccstring

maxLength: 128

minLength: 0

emailAddressCcstring

maxLength: 128

minLength: 0

firstNamestring

maxLength: 48

minLength: 0

glnstring

maxLength: 128

minLength: 0

houseAddressstring

maxLength: 128

minLength: 0

languageCodestring

Enum: aa,ab,ae,af,ak,am,an,ar,as,av,ay,az,ba,be,bg,bh,bm,bi,bn,bo,br,bs,ca,ce,ch,co,cr,cs,cu,cv,cy,da,de,dv,dz,ee,el,en,eo,es,et,eu,fa,ff,fi,fj,fo,fr,fy,ga,gd,gl,gn,gu,gv,ha,he,hi,ho,hr,ht,hu,hy,hz,ia,id,ie,ig,ii,ik,io,is,it,iu,ja,jv,ka,kg,ki,kj,kk,kl,km,kn,ko,kr,ks,ku,kv,kw,ky,la,lb,lg,li,ln,lo,lt,lu,lv,mg,mh,mi,mk,ml,mn,mr,ms,mt,my,na,nb,nd,ne,ng,nl,nn,no,nr,nv,ny,oc,oj,om,or,os,pa,pi,pl,ps,pt,qu,rm,rn,ro,ru,rw,sa,sc,sd,se,sg,si,sk,sl,sm,sn,so,sq,sr,ss,st,su,sv,sw,ta,te,tg,th,ti,tk,tl,tn,to,tr,ts,tt,tw,ty,ug,uk,ur,uz,ve,vi,vo,wa,wo,xh,yi,yo,za,zh,zu

lastNamestring

maxLength: 48

minLength: 0

phoneNumberstring

maxLength: 128

minLength: 0

statestring

maxLength: 64

minLength: 0

streetAddress1string

maxLength: 128

minLength: 0

streetAddress2string

maxLength: 128

minLength: 0

titlestring

maxLength: 24

minLength: 0

yourReferencestring

maxLength: 48

minLength: 0

zipCodestring

maxLength: 20

minLength: 0

customerNumberstring

maxLength: 48

minLength: 0

customerTypestring

Enum: PRIVATE,ORGANISATION,MUNICIPAL

customerVatIdstring

maxLength: 48

minLength: 0

regNumberstring

Organisation number for companies, social security number for persons. Needs to be in a valid format. For some countries the specified regNumber will be reformatted slightly internally to match standard formatting for the country.

maxLength: 48

minLength: 0

websiteUrlstring

maxLength: 128

minLength: 0

sitestring
statusstring

Enum: NEW,CANCELLED

storeIdstring

Deprecated. Use 'site' instead.

typestring

Enum: PREPAYMENT,NORMAL

uniqueIdstring
websiteInvoiceSeqNoint64
400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error

503

Service Unavailable

Response
Copy

Returns a credit invoice for the full amount of the provided invoice.

An Invoice created with the V2 API can only be credited using the V2 API A credit invoice can be linked to the original invoice or it can be standalone. When using the standalone credit invoice as payment for another invoice, the original invoice will not be affected - no debt will be added to the original invoice. Either invoiceNumber or referenceId must be provided

Auth
Required Scopes:READWRITE
Request Body
objectobject
deliveryTypestring

Optional delivery type. If not specified, the delivery type of the referenced invoice will be used

Enum: NONE,EMAIL,PRINT,EINVOICE,SMS

externalInvoiceNumberstring

Optional external invoiceNumber when this invoice is a mirror of an invoice in an external system. Must be unique.

maxLength: 36

minLength: 0

invoiceDatedate

Invoice date can not be in the future. If not specified, defaults to today.

invoiceNumberint64

Required if no referenceId is provided.

referenceIdstring

Required if no invoiceNumber is provided.

maxLength: 64

minLength: 0

standaloneboolean

true means that this credit invoice will be a standalone credit invoice with no link to the original invoice.

POST /api/v2/orders/invoices/credit/full
Copy
Responses
200

OK

objectobject
invoiceobject
amountToPayint64

Amount to pay in cents, 10 SEK = 1000

balanceint64

Balance of the invoice. A positive value means that there's outstanding amount for buyer to pay to seller. In cents, 10 SEK = 1000

calculationModestring

Enum: EX_VAT_ROUNDING_PER_ROW,EX_VAT_ROUNDING_AFTER_SUM,INC_VAT_ROUNDING_PER_ROW

countryCodestring

Enum: AL,DZ,AS,AD,AO,AI,AQ,AG,AR,AM,AW,AU,AT,AZ,BS,BH,BD,BB,BE,BZ,BJ,BM,BT,BO,BQ,BA,BW,BV,BR,IO,BN,BG,BF,BI,CV,KH,CM,CA,KY,CF,TD,CL,CN,CX,CC,CO,KM,CD,CG,CK,CR,HR,CW,CY,CZ,CI,DK,DJ,DM,DO,EC,EG,SV,GQ,ER,EE,SZ,ET,FK,FO,FJ,FI,FR,GF,PF,TF,GA,GM,GE,DE,GH,GI,GR,GL,GD,GP,GU,GT,GG,GN,GW,GY,HT,HM,VA,HN,HK,HU,IS,IN,ID,IQ,IE,IM,IL,IT,JM,JP,JE,JO,KZ,KE,KI,KR,KW,KG,LA,LV,LB,LS,LR,LY,LI,LT,LU,MO,MG,MW,MY,MV,ML,MT,MH,MQ,MR,MU,YT,MX,FM,MD,MC,MN,ME,MS,MA,MZ,NA,NR,NP,NL,NC,NZ,NI,NE,NG,NU,NF,MP,NO,OM,PK,PW,PA,PG,PY,PE,PH,PN,PL,PT,PR,QA,MK,RO,RW,RE,BL,SH,KN,LC,MF,PM,VC,WS,SM,ST,SA,SN,RS,SC,SL,SG,SX,SK,SI,SB,SO,ZA,GS,SS,ES,LK,SD,SR,SJ,SE,CH,TW,TJ,TZ,TH,TL,TG,TK,TO,TT,TN,TR,TM,TC,TV,UG,UA,AE,GB,UM,US,UY,UZ,VU,VN,VG,VI,WF,EH,YE,ZM,ZW,AX

creditedAmountint64
creditsInvoiceWithInvoiceNumberint64

If this is a credit invoice, this will be the invoice number of the original invoice

currencyCodestring

Enum: DKK,EUR,GBP,NOK,SEK,USD,CHF

deliveryTypestring

Enum: NONE,EMAIL,PRINT,EINVOICE,SMS

dueDatedate
externalInvoiceNumberstring
feeBalanceint64
invoiceCustomerobject
addressobject
citystring

maxLength: 48

minLength: 0

coAddressstring

maxLength: 128

minLength: 0

companyNamestring

maxLength: 128

minLength: 0

countryCodestring

Enum: AL,DZ,AS,AD,AO,AI,AQ,AG,AR,AM,AW,AU,AT,AZ,BS,BH,BD,BB,BE,BZ,BJ,BM,BT,BO,BQ,BA,BW,BV,BR,IO,BN,BG,BF,BI,CV,KH,CM,CA,KY,CF,TD,CL,CN,CX,CC,CO,KM,CD,CG,CK,CR,HR,CW,CY,CZ,CI,DK,DJ,DM,DO,EC,EG,SV,GQ,ER,EE,SZ,ET,FK,FO,FJ,FI,FR,GF,PF,TF,GA,GM,GE,DE,GH,GI,GR,GL,GD,GP,GU,GT,GG,GN,GW,GY,HT,HM,VA,HN,HK,HU,IS,IN,ID,IQ,IE,IM,IL,IT,JM,JP,JE,JO,KZ,KE,KI,KR,KW,KG,LA,LV,LB,LS,LR,LY,LI,LT,LU,MO,MG,MW,MY,MV,ML,MT,MH,MQ,MR,MU,YT,MX,FM,MD,MC,MN,ME,MS,MA,MZ,NA,NR,NP,NL,NC,NZ,NI,NE,NG,NU,NF,MP,NO,OM,PK,PW,PA,PG,PY,PE,PH,PN,PL,PT,PR,QA,MK,RO,RW,RE,BL,SH,KN,LC,MF,PM,VC,WS,SM,ST,SA,SN,RS,SC,SL,SG,SX,SK,SI,SB,SO,ZA,GS,SS,ES,LK,SD,SR,SJ,SE,CH,TW,TJ,TZ,TH,TL,TG,TK,TO,TT,TN,TR,TM,TC,TV,UG,UA,AE,GB,UM,US,UY,UZ,VU,VN,VG,VI,WF,EH,YE,ZM,ZW,AX

emailAddressstring

maxLength: 128

minLength: 0

emailAddressBccstring

maxLength: 128

minLength: 0

emailAddressCcstring

maxLength: 128

minLength: 0

firstNamestring

maxLength: 48

minLength: 0

glnstring

maxLength: 128

minLength: 0

houseAddressstring

maxLength: 128

minLength: 0

languageCodestring

Enum: aa,ab,ae,af,ak,am,an,ar,as,av,ay,az,ba,be,bg,bh,bm,bi,bn,bo,br,bs,ca,ce,ch,co,cr,cs,cu,cv,cy,da,de,dv,dz,ee,el,en,eo,es,et,eu,fa,ff,fi,fj,fo,fr,fy,ga,gd,gl,gn,gu,gv,ha,he,hi,ho,hr,ht,hu,hy,hz,ia,id,ie,ig,ii,ik,io,is,it,iu,ja,jv,ka,kg,ki,kj,kk,kl,km,kn,ko,kr,ks,ku,kv,kw,ky,la,lb,lg,li,ln,lo,lt,lu,lv,mg,mh,mi,mk,ml,mn,mr,ms,mt,my,na,nb,nd,ne,ng,nl,nn,no,nr,nv,ny,oc,oj,om,or,os,pa,pi,pl,ps,pt,qu,rm,rn,ro,ru,rw,sa,sc,sd,se,sg,si,sk,sl,sm,sn,so,sq,sr,ss,st,su,sv,sw,ta,te,tg,th,ti,tk,tl,tn,to,tr,ts,tt,tw,ty,ug,uk,ur,uz,ve,vi,vo,wa,wo,xh,yi,yo,za,zh,zu

lastNamestring

maxLength: 48

minLength: 0

phoneNumberstring

maxLength: 128

minLength: 0

statestring

maxLength: 64

minLength: 0

streetAddress1string

maxLength: 128

minLength: 0

streetAddress2string

maxLength: 128

minLength: 0

titlestring

maxLength: 24

minLength: 0

yourReferencestring

maxLength: 48

minLength: 0

zipCodestring

maxLength: 20

minLength: 0

customerNumberstring

maxLength: 48

minLength: 0

customerTypestring

Enum: PRIVATE,ORGANISATION,MUNICIPAL

customerVatIdstring

maxLength: 48

minLength: 0

regNumberstring

Organisation number for companies, social security number for persons. Needs to be in a valid format. For some countries the specified regNumber will be reformatted slightly internally to match standard formatting for the country.

maxLength: 48

minLength: 0

websiteUrlstring

maxLength: 128

minLength: 0

invoiceDatedate
invoiceNumberstring
invoicePdfUrlstring
invoicePeriodobject
endDatedate

Indicate the end date of this invoice period

startDatedate

Indicate the start date of this invoice period

isOverdueboolean
items
objectobject
additionalDetailstring
articleNumberstring

Mandatory for FREEFORM line items.

calculationModestring

Identifies which of the three Item calculation modes that this item uses. Hint: Use a deserializer that supports polymorphic deserialization and let it use this attribute to decide which sub model to use.

Enum: EX_VAT_ROUNDING_PER_ROW,EX_VAT_ROUNDING_AFTER_SUM,INC_VAT_ROUNDING_PER_ROW,EX_VAT_ROUNDING_PER_ROW,EX_VAT_ROUNDING_AFTER_SUM,INC_VAT_ROUNDING_PER_ROW

costCenterstring
descriptionstring
itemTypestring

Enum: FREEFORM,INFOLINE

positionint32
quantitynumber

Maximum 6 decimals.

salesAccountCodeint32
unitstring
vatAccountCodeint32
unitPriceExcludingVatnumber

Unit price in decimal form, excluding VAT. Maximum 6 decimals.

vatPercentagenumber

VAT percentage in decimal form. Maximum 2 decimals.

orderApproveDatedate-time
orderIdint64
orderReferenceIdstring
orderStatusstring

Enum: NEW,APPROVED,DENIED

ourReferencestring
parentInvoiceNumberint64
paymentBankAccountsarray[object]
accountHolderCountrystring

Enum: AL,DZ,AS,AD,AO,AI,AQ,AG,AR,AM,AW,AU,AT,AZ,BS,BH,BD,BB,BE,BZ,BJ,BM,BT,BO,BQ,BA,BW,BV,BR,IO,BN,BG,BF,BI,CV,KH,CM,CA,KY,CF,TD,CL,CN,CX,CC,CO,KM,CD,CG,CK,CR,HR,CW,CY,CZ,CI,DK,DJ,DM,DO,EC,EG,SV,GQ,ER,EE,SZ,ET,FK,FO,FJ,FI,FR,GF,PF,TF,GA,GM,GE,DE,GH,GI,GR,GL,GD,GP,GU,GT,GG,GN,GW,GY,HT,HM,VA,HN,HK,HU,IS,IN,ID,IQ,IE,IM,IL,IT,JM,JP,JE,JO,KZ,KE,KI,KR,KW,KG,LA,LV,LB,LS,LR,LY,LI,LT,LU,MO,MG,MW,MY,MV,ML,MT,MH,MQ,MR,MU,YT,MX,FM,MD,MC,MN,ME,MS,MA,MZ,NA,NR,NP,NL,NC,NZ,NI,NE,NG,NU,NF,MP,NO,OM,PK,PW,PA,PG,PY,PE,PH,PN,PL,PT,PR,QA,MK,RO,RW,RE,BL,SH,KN,LC,MF,PM,VC,WS,SM,ST,SA,SN,RS,SC,SL,SG,SX,SK,SI,SB,SO,ZA,GS,SS,ES,LK,SD,SR,SJ,SE,CH,TW,TJ,TZ,TH,TL,TG,TK,TO,TT,TN,TR,TM,TC,TV,UG,UA,AE,GB,UM,US,UY,UZ,VU,VN,VG,VI,WF,EH,YE,ZM,ZW,AX

accountHolderNamestring
accountNumberstring
bicstring
typestring

Enum: BANKGIRO,PLUSGIRO,IBAN,SE_GENERIC

paymentStatusstring

Enum: UNPAID,RESERVED,PARTIALLY_PAID,PAID,UNUSED,PARTIALLY_USED,USED

paymentsarray[object]
amountint64

Amount in cents, 10 SEK = 1000

bookingDatedate

Always the date the payment was booked on the account.

currencyCodestring

Enum: DKK,EUR,GBP,NOK,SEK,USD,CHF

effectiveBookingDatedate

The date the payment was booked on the account, unless it was manually mapped. In that case it is the date the mapping was done.

paymentDatedate-time
referenceNumberstring
typestring

Enum: BANK,CARD,POS,DIRECT_BANK,SWISH,KLARNA,CREDIT_INVOICE,MANUAL,WRITE_OFF,REBALANCED,EXPECTED_BAD_WRITE_OFF,BAD_DEBT_WRITE_OFF

projectstring
publicInvoiceUrlstring
referenceNumberstring
remindersarray[object]
creationTimedate-time
deliveryTypesarray[string]

Enum: NONE,EMAIL,PRINT,EINVOICE,SMS

modifiedTimedate-time
reminderNumberint32
remindersAreCancelledboolean
sellingCustomerobject
addressobject
citystring

maxLength: 48

minLength: 0

coAddressstring

maxLength: 128

minLength: 0

companyNamestring

maxLength: 128

minLength: 0

countryCodestring

Enum: AL,DZ,AS,AD,AO,AI,AQ,AG,AR,AM,AW,AU,AT,AZ,BS,BH,BD,BB,BE,BZ,BJ,BM,BT,BO,BQ,BA,BW,BV,BR,IO,BN,BG,BF,BI,CV,KH,CM,CA,KY,CF,TD,CL,CN,CX,CC,CO,KM,CD,CG,CK,CR,HR,CW,CY,CZ,CI,DK,DJ,DM,DO,EC,EG,SV,GQ,ER,EE,SZ,ET,FK,FO,FJ,FI,FR,GF,PF,TF,GA,GM,GE,DE,GH,GI,GR,GL,GD,GP,GU,GT,GG,GN,GW,GY,HT,HM,VA,HN,HK,HU,IS,IN,ID,IQ,IE,IM,IL,IT,JM,JP,JE,JO,KZ,KE,KI,KR,KW,KG,LA,LV,LB,LS,LR,LY,LI,LT,LU,MO,MG,MW,MY,MV,ML,MT,MH,MQ,MR,MU,YT,MX,FM,MD,MC,MN,ME,MS,MA,MZ,NA,NR,NP,NL,NC,NZ,NI,NE,NG,NU,NF,MP,NO,OM,PK,PW,PA,PG,PY,PE,PH,PN,PL,PT,PR,QA,MK,RO,RW,RE,BL,SH,KN,LC,MF,PM,VC,WS,SM,ST,SA,SN,RS,SC,SL,SG,SX,SK,SI,SB,SO,ZA,GS,SS,ES,LK,SD,SR,SJ,SE,CH,TW,TJ,TZ,TH,TL,TG,TK,TO,TT,TN,TR,TM,TC,TV,UG,UA,AE,GB,UM,US,UY,UZ,VU,VN,VG,VI,WF,EH,YE,ZM,ZW,AX

emailAddressstring

maxLength: 128

minLength: 0

emailAddressBccstring

maxLength: 128

minLength: 0

emailAddressCcstring

maxLength: 128

minLength: 0

firstNamestring

maxLength: 48

minLength: 0

glnstring

maxLength: 128

minLength: 0

houseAddressstring

maxLength: 128

minLength: 0

languageCodestring

Enum: aa,ab,ae,af,ak,am,an,ar,as,av,ay,az,ba,be,bg,bh,bm,bi,bn,bo,br,bs,ca,ce,ch,co,cr,cs,cu,cv,cy,da,de,dv,dz,ee,el,en,eo,es,et,eu,fa,ff,fi,fj,fo,fr,fy,ga,gd,gl,gn,gu,gv,ha,he,hi,ho,hr,ht,hu,hy,hz,ia,id,ie,ig,ii,ik,io,is,it,iu,ja,jv,ka,kg,ki,kj,kk,kl,km,kn,ko,kr,ks,ku,kv,kw,ky,la,lb,lg,li,ln,lo,lt,lu,lv,mg,mh,mi,mk,ml,mn,mr,ms,mt,my,na,nb,nd,ne,ng,nl,nn,no,nr,nv,ny,oc,oj,om,or,os,pa,pi,pl,ps,pt,qu,rm,rn,ro,ru,rw,sa,sc,sd,se,sg,si,sk,sl,sm,sn,so,sq,sr,ss,st,su,sv,sw,ta,te,tg,th,ti,tk,tl,tn,to,tr,ts,tt,tw,ty,ug,uk,ur,uz,ve,vi,vo,wa,wo,xh,yi,yo,za,zh,zu

lastNamestring

maxLength: 48

minLength: 0

phoneNumberstring

maxLength: 128

minLength: 0

statestring

maxLength: 64

minLength: 0

streetAddress1string

maxLength: 128

minLength: 0

streetAddress2string

maxLength: 128

minLength: 0

titlestring

maxLength: 24

minLength: 0

yourReferencestring

maxLength: 48

minLength: 0

zipCodestring

maxLength: 20

minLength: 0

customerNumberstring

maxLength: 48

minLength: 0

customerTypestring

Enum: PRIVATE,ORGANISATION,MUNICIPAL

customerVatIdstring

maxLength: 48

minLength: 0

regNumberstring

Organisation number for companies, social security number for persons. Needs to be in a valid format. For some countries the specified regNumber will be reformatted slightly internally to match standard formatting for the country.

maxLength: 48

minLength: 0

websiteUrlstring

maxLength: 128

minLength: 0

sitestring
statusstring

Enum: NEW,CANCELLED

storeIdstring

Deprecated. Use 'site' instead.

typestring

Enum: PREPAYMENT,NORMAL

uniqueIdstring
websiteInvoiceSeqNoint64
400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error

503

Service Unavailable

Response
Copy

Returns an invoice for a given invoice number

Note: By default, the invoice is returned in Inc-Vat format, even if the invoice was originally created with a different calculation mode. Please use the originalCalculationModeResponse flag if you don't want that. Also note: An Invoice created with the V2 API can only be fetched using the V2 API.

Auth
Required Scopes:READWRITE
Query String
invoiceNumberinteger
referenceIdstring

maxLength: 64

minLength: 0

externalInvoiceNumberstring
originalCalculationModeResponseboolean

The Items in the response are normally returned in the Inc-Vat format, even if the invoice was originally created with a different calculation mode. This flag makes it possible to get the Items in their original calculation mode in the response. If you enable this it's suggested that you use a deserializer that supports polymorphic deserialization and let the it use the Item 'calculationMode' attribute to decide which sub model to use.

GET /api/v2/orders/invoices
Copy
Responses
200

OK

objectobject
invoiceobject
amountToPayint64

Amount to pay in cents, 10 SEK = 1000

balanceint64

Balance of the invoice. A positive value means that there's outstanding amount for buyer to pay to seller. In cents, 10 SEK = 1000

calculationModestring

Enum: EX_VAT_ROUNDING_PER_ROW,EX_VAT_ROUNDING_AFTER_SUM,INC_VAT_ROUNDING_PER_ROW

countryCodestring

Enum: AL,DZ,AS,AD,AO,AI,AQ,AG,AR,AM,AW,AU,AT,AZ,BS,BH,BD,BB,BE,BZ,BJ,BM,BT,BO,BQ,BA,BW,BV,BR,IO,BN,BG,BF,BI,CV,KH,CM,CA,KY,CF,TD,CL,CN,CX,CC,CO,KM,CD,CG,CK,CR,HR,CW,CY,CZ,CI,DK,DJ,DM,DO,EC,EG,SV,GQ,ER,EE,SZ,ET,FK,FO,FJ,FI,FR,GF,PF,TF,GA,GM,GE,DE,GH,GI,GR,GL,GD,GP,GU,GT,GG,GN,GW,GY,HT,HM,VA,HN,HK,HU,IS,IN,ID,IQ,IE,IM,IL,IT,JM,JP,JE,JO,KZ,KE,KI,KR,KW,KG,LA,LV,LB,LS,LR,LY,LI,LT,LU,MO,MG,MW,MY,MV,ML,MT,MH,MQ,MR,MU,YT,MX,FM,MD,MC,MN,ME,MS,MA,MZ,NA,NR,NP,NL,NC,NZ,NI,NE,NG,NU,NF,MP,NO,OM,PK,PW,PA,PG,PY,PE,PH,PN,PL,PT,PR,QA,MK,RO,RW,RE,BL,SH,KN,LC,MF,PM,VC,WS,SM,ST,SA,SN,RS,SC,SL,SG,SX,SK,SI,SB,SO,ZA,GS,SS,ES,LK,SD,SR,SJ,SE,CH,TW,TJ,TZ,TH,TL,TG,TK,TO,TT,TN,TR,TM,TC,TV,UG,UA,AE,GB,UM,US,UY,UZ,VU,VN,VG,VI,WF,EH,YE,ZM,ZW,AX

creditedAmountint64
creditsInvoiceWithInvoiceNumberint64

If this is a credit invoice, this will be the invoice number of the original invoice

currencyCodestring

Enum: DKK,EUR,GBP,NOK,SEK,USD,CHF

deliveryTypestring

Enum: NONE,EMAIL,PRINT,EINVOICE,SMS

dueDatedate
externalInvoiceNumberstring
feeBalanceint64
invoiceCustomerobject
addressobject
citystring

maxLength: 48

minLength: 0

coAddressstring

maxLength: 128

minLength: 0

companyNamestring

maxLength: 128

minLength: 0

countryCodestring

Enum: AL,DZ,AS,AD,AO,AI,AQ,AG,AR,AM,AW,AU,AT,AZ,BS,BH,BD,BB,BE,BZ,BJ,BM,BT,BO,BQ,BA,BW,BV,BR,IO,BN,BG,BF,BI,CV,KH,CM,CA,KY,CF,TD,CL,CN,CX,CC,CO,KM,CD,CG,CK,CR,HR,CW,CY,CZ,CI,DK,DJ,DM,DO,EC,EG,SV,GQ,ER,EE,SZ,ET,FK,FO,FJ,FI,FR,GF,PF,TF,GA,GM,GE,DE,GH,GI,GR,GL,GD,GP,GU,GT,GG,GN,GW,GY,HT,HM,VA,HN,HK,HU,IS,IN,ID,IQ,IE,IM,IL,IT,JM,JP,JE,JO,KZ,KE,KI,KR,KW,KG,LA,LV,LB,LS,LR,LY,LI,LT,LU,MO,MG,MW,MY,MV,ML,MT,MH,MQ,MR,MU,YT,MX,FM,MD,MC,MN,ME,MS,MA,MZ,NA,NR,NP,NL,NC,NZ,NI,NE,NG,NU,NF,MP,NO,OM,PK,PW,PA,PG,PY,PE,PH,PN,PL,PT,PR,QA,MK,RO,RW,RE,BL,SH,KN,LC,MF,PM,VC,WS,SM,ST,SA,SN,RS,SC,SL,SG,SX,SK,SI,SB,SO,ZA,GS,SS,ES,LK,SD,SR,SJ,SE,CH,TW,TJ,TZ,TH,TL,TG,TK,TO,TT,TN,TR,TM,TC,TV,UG,UA,AE,GB,UM,US,UY,UZ,VU,VN,VG,VI,WF,EH,YE,ZM,ZW,AX

emailAddressstring

maxLength: 128

minLength: 0

emailAddressBccstring

maxLength: 128

minLength: 0

emailAddressCcstring

maxLength: 128

minLength: 0

firstNamestring

maxLength: 48

minLength: 0

glnstring

maxLength: 128

minLength: 0

houseAddressstring

maxLength: 128

minLength: 0

languageCodestring

Enum: aa,ab,ae,af,ak,am,an,ar,as,av,ay,az,ba,be,bg,bh,bm,bi,bn,bo,br,bs,ca,ce,ch,co,cr,cs,cu,cv,cy,da,de,dv,dz,ee,el,en,eo,es,et,eu,fa,ff,fi,fj,fo,fr,fy,ga,gd,gl,gn,gu,gv,ha,he,hi,ho,hr,ht,hu,hy,hz,ia,id,ie,ig,ii,ik,io,is,it,iu,ja,jv,ka,kg,ki,kj,kk,kl,km,kn,ko,kr,ks,ku,kv,kw,ky,la,lb,lg,li,ln,lo,lt,lu,lv,mg,mh,mi,mk,ml,mn,mr,ms,mt,my,na,nb,nd,ne,ng,nl,nn,no,nr,nv,ny,oc,oj,om,or,os,pa,pi,pl,ps,pt,qu,rm,rn,ro,ru,rw,sa,sc,sd,se,sg,si,sk,sl,sm,sn,so,sq,sr,ss,st,su,sv,sw,ta,te,tg,th,ti,tk,tl,tn,to,tr,ts,tt,tw,ty,ug,uk,ur,uz,ve,vi,vo,wa,wo,xh,yi,yo,za,zh,zu

lastNamestring

maxLength: 48

minLength: 0

phoneNumberstring

maxLength: 128

minLength: 0

statestring

maxLength: 64

minLength: 0

streetAddress1string

maxLength: 128

minLength: 0

streetAddress2string

maxLength: 128

minLength: 0

titlestring

maxLength: 24

minLength: 0

yourReferencestring

maxLength: 48

minLength: 0

zipCodestring

maxLength: 20

minLength: 0

customerNumberstring

maxLength: 48

minLength: 0

customerTypestring

Enum: PRIVATE,ORGANISATION,MUNICIPAL

customerVatIdstring

maxLength: 48

minLength: 0

regNumberstring

Organisation number for companies, social security number for persons. Needs to be in a valid format. For some countries the specified regNumber will be reformatted slightly internally to match standard formatting for the country.

maxLength: 48

minLength: 0

websiteUrlstring

maxLength: 128

minLength: 0

invoiceDatedate
invoiceNumberstring
invoicePdfUrlstring
invoicePeriodobject
endDatedate

Indicate the end date of this invoice period

startDatedate

Indicate the start date of this invoice period

isOverdueboolean
items
objectobject
additionalDetailstring
articleNumberstring

Mandatory for FREEFORM line items.

calculationModestring

Identifies which of the three Item calculation modes that this item uses. Hint: Use a deserializer that supports polymorphic deserialization and let it use this attribute to decide which sub model to use.

Enum: EX_VAT_ROUNDING_PER_ROW,EX_VAT_ROUNDING_AFTER_SUM,INC_VAT_ROUNDING_PER_ROW,EX_VAT_ROUNDING_PER_ROW,EX_VAT_ROUNDING_AFTER_SUM,INC_VAT_ROUNDING_PER_ROW

costCenterstring
descriptionstring
itemTypestring

Enum: FREEFORM,INFOLINE

positionint32
quantitynumber

Maximum 6 decimals.

salesAccountCodeint32
unitstring
vatAccountCodeint32
unitPriceExcludingVatnumber

Unit price in decimal form, excluding VAT. Maximum 6 decimals.

vatPercentagenumber

VAT percentage in decimal form. Maximum 2 decimals.

orderApproveDatedate-time
orderIdint64
orderReferenceIdstring
orderStatusstring

Enum: NEW,APPROVED,DENIED

ourReferencestring
parentInvoiceNumberint64
paymentBankAccountsarray[object]
accountHolderCountrystring

Enum: AL,DZ,AS,AD,AO,AI,AQ,AG,AR,AM,AW,AU,AT,AZ,BS,BH,BD,BB,BE,BZ,BJ,BM,BT,BO,BQ,BA,BW,BV,BR,IO,BN,BG,BF,BI,CV,KH,CM,CA,KY,CF,TD,CL,CN,CX,CC,CO,KM,CD,CG,CK,CR,HR,CW,CY,CZ,CI,DK,DJ,DM,DO,EC,EG,SV,GQ,ER,EE,SZ,ET,FK,FO,FJ,FI,FR,GF,PF,TF,GA,GM,GE,DE,GH,GI,GR,GL,GD,GP,GU,GT,GG,GN,GW,GY,HT,HM,VA,HN,HK,HU,IS,IN,ID,IQ,IE,IM,IL,IT,JM,JP,JE,JO,KZ,KE,KI,KR,KW,KG,LA,LV,LB,LS,LR,LY,LI,LT,LU,MO,MG,MW,MY,MV,ML,MT,MH,MQ,MR,MU,YT,MX,FM,MD,MC,MN,ME,MS,MA,MZ,NA,NR,NP,NL,NC,NZ,NI,NE,NG,NU,NF,MP,NO,OM,PK,PW,PA,PG,PY,PE,PH,PN,PL,PT,PR,QA,MK,RO,RW,RE,BL,SH,KN,LC,MF,PM,VC,WS,SM,ST,SA,SN,RS,SC,SL,SG,SX,SK,SI,SB,SO,ZA,GS,SS,ES,LK,SD,SR,SJ,SE,CH,TW,TJ,TZ,TH,TL,TG,TK,TO,TT,TN,TR,TM,TC,TV,UG,UA,AE,GB,UM,US,UY,UZ,VU,VN,VG,VI,WF,EH,YE,ZM,ZW,AX

accountHolderNamestring
accountNumberstring
bicstring
typestring

Enum: BANKGIRO,PLUSGIRO,IBAN,SE_GENERIC

paymentStatusstring

Enum: UNPAID,RESERVED,PARTIALLY_PAID,PAID,UNUSED,PARTIALLY_USED,USED

paymentsarray[object]
amountint64

Amount in cents, 10 SEK = 1000

bookingDatedate

Always the date the payment was booked on the account.

currencyCodestring

Enum: DKK,EUR,GBP,NOK,SEK,USD,CHF

effectiveBookingDatedate

The date the payment was booked on the account, unless it was manually mapped. In that case it is the date the mapping was done.

paymentDatedate-time
referenceNumberstring
typestring

Enum: BANK,CARD,POS,DIRECT_BANK,SWISH,KLARNA,CREDIT_INVOICE,MANUAL,WRITE_OFF,REBALANCED,EXPECTED_BAD_WRITE_OFF,BAD_DEBT_WRITE_OFF

projectstring
publicInvoiceUrlstring
referenceNumberstring
remindersarray[object]
creationTimedate-time
deliveryTypesarray[string]

Enum: NONE,EMAIL,PRINT,EINVOICE,SMS

modifiedTimedate-time
reminderNumberint32
remindersAreCancelledboolean
sellingCustomerobject
addressobject
citystring

maxLength: 48

minLength: 0

coAddressstring

maxLength: 128

minLength: 0

companyNamestring

maxLength: 128

minLength: 0

countryCodestring

Enum: AL,DZ,AS,AD,AO,AI,AQ,AG,AR,AM,AW,AU,AT,AZ,BS,BH,BD,BB,BE,BZ,BJ,BM,BT,BO,BQ,BA,BW,BV,BR,IO,BN,BG,BF,BI,CV,KH,CM,CA,KY,CF,TD,CL,CN,CX,CC,CO,KM,CD,CG,CK,CR,HR,CW,CY,CZ,CI,DK,DJ,DM,DO,EC,EG,SV,GQ,ER,EE,SZ,ET,FK,FO,FJ,FI,FR,GF,PF,TF,GA,GM,GE,DE,GH,GI,GR,GL,GD,GP,GU,GT,GG,GN,GW,GY,HT,HM,VA,HN,HK,HU,IS,IN,ID,IQ,IE,IM,IL,IT,JM,JP,JE,JO,KZ,KE,KI,KR,KW,KG,LA,LV,LB,LS,LR,LY,LI,LT,LU,MO,MG,MW,MY,MV,ML,MT,MH,MQ,MR,MU,YT,MX,FM,MD,MC,MN,ME,MS,MA,MZ,NA,NR,NP,NL,NC,NZ,NI,NE,NG,NU,NF,MP,NO,OM,PK,PW,PA,PG,PY,PE,PH,PN,PL,PT,PR,QA,MK,RO,RW,RE,BL,SH,KN,LC,MF,PM,VC,WS,SM,ST,SA,SN,RS,SC,SL,SG,SX,SK,SI,SB,SO,ZA,GS,SS,ES,LK,SD,SR,SJ,SE,CH,TW,TJ,TZ,TH,TL,TG,TK,TO,TT,TN,TR,TM,TC,TV,UG,UA,AE,GB,UM,US,UY,UZ,VU,VN,VG,VI,WF,EH,YE,ZM,ZW,AX

emailAddressstring

maxLength: 128

minLength: 0

emailAddressBccstring

maxLength: 128

minLength: 0

emailAddressCcstring

maxLength: 128

minLength: 0

firstNamestring

maxLength: 48

minLength: 0

glnstring

maxLength: 128

minLength: 0

houseAddressstring

maxLength: 128

minLength: 0

languageCodestring

Enum: aa,ab,ae,af,ak,am,an,ar,as,av,ay,az,ba,be,bg,bh,bm,bi,bn,bo,br,bs,ca,ce,ch,co,cr,cs,cu,cv,cy,da,de,dv,dz,ee,el,en,eo,es,et,eu,fa,ff,fi,fj,fo,fr,fy,ga,gd,gl,gn,gu,gv,ha,he,hi,ho,hr,ht,hu,hy,hz,ia,id,ie,ig,ii,ik,io,is,it,iu,ja,jv,ka,kg,ki,kj,kk,kl,km,kn,ko,kr,ks,ku,kv,kw,ky,la,lb,lg,li,ln,lo,lt,lu,lv,mg,mh,mi,mk,ml,mn,mr,ms,mt,my,na,nb,nd,ne,ng,nl,nn,no,nr,nv,ny,oc,oj,om,or,os,pa,pi,pl,ps,pt,qu,rm,rn,ro,ru,rw,sa,sc,sd,se,sg,si,sk,sl,sm,sn,so,sq,sr,ss,st,su,sv,sw,ta,te,tg,th,ti,tk,tl,tn,to,tr,ts,tt,tw,ty,ug,uk,ur,uz,ve,vi,vo,wa,wo,xh,yi,yo,za,zh,zu

lastNamestring

maxLength: 48

minLength: 0

phoneNumberstring

maxLength: 128

minLength: 0

statestring

maxLength: 64

minLength: 0

streetAddress1string

maxLength: 128

minLength: 0

streetAddress2string

maxLength: 128

minLength: 0

titlestring

maxLength: 24

minLength: 0

yourReferencestring

maxLength: 48

minLength: 0

zipCodestring

maxLength: 20

minLength: 0

customerNumberstring

maxLength: 48

minLength: 0

customerTypestring

Enum: PRIVATE,ORGANISATION,MUNICIPAL

customerVatIdstring

maxLength: 48

minLength: 0

regNumberstring

Organisation number for companies, social security number for persons. Needs to be in a valid format. For some countries the specified regNumber will be reformatted slightly internally to match standard formatting for the country.

maxLength: 48

minLength: 0

websiteUrlstring

maxLength: 128

minLength: 0

sitestring
statusstring

Enum: NEW,CANCELLED

storeIdstring

Deprecated. Use 'site' instead.

typestring

Enum: PREPAYMENT,NORMAL

uniqueIdstring
websiteInvoiceSeqNoint64
400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error

503

Service Unavailable

Response
Copy

Returns invoices where the invoice customer have the given reg number or vat id

Batch size is 20. If more invoices exists, the next invoice number is returned to be used in future requests. Note: By default, the invoice is returned in Inc-Vat format, even if the invoice was originally created with a different calculation mode. Please use the originalCalculationModeResponse flag if you don't want that. Also note: An Invoice created with the V2 API can only be fetched using the V2 API.

Auth
Query String
regNumberstring
customerVatIdstring
fromInvoiceNumberinteger
originalCalculationModeResponseboolean

The Items in the response are normally returned in the Inc-Vat format, even if the invoice was originally created with a different calculation mode. This flag makes it possible to get the Items in their original calculation mode in the response. If you enable this it's suggested that you use a deserializer that supports polymorphic deserialization and let the it use the Item 'calculationMode' attribute to decide which sub model to use.

GET /api/v2/orders/invoices/reg-number
Responses
200

OK

objectobject
invoicesarray[object]
amountToPayint64

Amount to pay in cents, 10 SEK = 1000

balanceint64

Balance of the invoice. A positive value means that there's outstanding amount for buyer to pay to seller. In cents, 10 SEK = 1000

calculationModestring

Enum: EX_VAT_ROUNDING_PER_ROW,EX_VAT_ROUNDING_AFTER_SUM,INC_VAT_ROUNDING_PER_ROW

countryCodestring

Enum: AL,DZ,AS,AD,AO,AI,AQ,AG,AR,AM,AW,AU,AT,AZ,BS,BH,BD,BB,BE,BZ,BJ,BM,BT,BO,BQ,BA,BW,BV,BR,IO,BN,BG,BF,BI,CV,KH,CM,CA,KY,CF,TD,CL,CN,CX,CC,CO,KM,CD,CG,CK,CR,HR,CW,CY,CZ,CI,DK,DJ,DM,DO,EC,EG,SV,GQ,ER,EE,SZ,ET,FK,FO,FJ,FI,FR,GF,PF,TF,GA,GM,GE,DE,GH,GI,GR,GL,GD,GP,GU,GT,GG,GN,GW,GY,HT,HM,VA,HN,HK,HU,IS,IN,ID,IQ,IE,IM,IL,IT,JM,JP,JE,JO,KZ,KE,KI,KR,KW,KG,LA,LV,LB,LS,LR,LY,LI,LT,LU,MO,MG,MW,MY,MV,ML,MT,MH,MQ,MR,MU,YT,MX,FM,MD,MC,MN,ME,MS,MA,MZ,NA,NR,NP,NL,NC,NZ,NI,NE,NG,NU,NF,MP,NO,OM,PK,PW,PA,PG,PY,PE,PH,PN,PL,PT,PR,QA,MK,RO,RW,RE,BL,SH,KN,LC,MF,PM,VC,WS,SM,ST,SA,SN,RS,SC,SL,SG,SX,SK,SI,SB,SO,ZA,GS,SS,ES,LK,SD,SR,SJ,SE,CH,TW,TJ,TZ,TH,TL,TG,TK,TO,TT,TN,TR,TM,TC,TV,UG,UA,AE,GB,UM,US,UY,UZ,VU,VN,VG,VI,WF,EH,YE,ZM,ZW,AX

creditedAmountint64
creditsInvoiceWithInvoiceNumberint64

If this is a credit invoice, this will be the invoice number of the original invoice

currencyCodestring

Enum: DKK,EUR,GBP,NOK,SEK,USD,CHF

deliveryTypestring

Enum: NONE,EMAIL,PRINT,EINVOICE,SMS

dueDatedate
externalInvoiceNumberstring
feeBalanceint64
invoiceCustomerobject
addressobject
citystring

maxLength: 48

minLength: 0

coAddressstring

maxLength: 128

minLength: 0

companyNamestring

maxLength: 128

minLength: 0

countryCodestring

Enum: AL,DZ,AS,AD,AO,AI,AQ,AG,AR,AM,AW,AU,AT,AZ,BS,BH,BD,BB,BE,BZ,BJ,BM,BT,BO,BQ,BA,BW,BV,BR,IO,BN,BG,BF,BI,CV,KH,CM,CA,KY,CF,TD,CL,CN,CX,CC,CO,KM,CD,CG,CK,CR,HR,CW,CY,CZ,CI,DK,DJ,DM,DO,EC,EG,SV,GQ,ER,EE,SZ,ET,FK,FO,FJ,FI,FR,GF,PF,TF,GA,GM,GE,DE,GH,GI,GR,GL,GD,GP,GU,GT,GG,GN,GW,GY,HT,HM,VA,HN,HK,HU,IS,IN,ID,IQ,IE,IM,IL,IT,JM,JP,JE,JO,KZ,KE,KI,KR,KW,KG,LA,LV,LB,LS,LR,LY,LI,LT,LU,MO,MG,MW,MY,MV,ML,MT,MH,MQ,MR,MU,YT,MX,FM,MD,MC,MN,ME,MS,MA,MZ,NA,NR,NP,NL,NC,NZ,NI,NE,NG,NU,NF,MP,NO,OM,PK,PW,PA,PG,PY,PE,PH,PN,PL,PT,PR,QA,MK,RO,RW,RE,BL,SH,KN,LC,MF,PM,VC,WS,SM,ST,SA,SN,RS,SC,SL,SG,SX,SK,SI,SB,SO,ZA,GS,SS,ES,LK,SD,SR,SJ,SE,CH,TW,TJ,TZ,TH,TL,TG,TK,TO,TT,TN,TR,TM,TC,TV,UG,UA,AE,GB,UM,US,UY,UZ,VU,VN,VG,VI,WF,EH,YE,ZM,ZW,AX

emailAddressstring

maxLength: 128

minLength: 0

emailAddressBccstring

maxLength: 128

minLength: 0

emailAddressCcstring

maxLength: 128

minLength: 0

firstNamestring

maxLength: 48

minLength: 0

glnstring

maxLength: 128

minLength: 0

houseAddressstring

maxLength: 128

minLength: 0

languageCodestring

Enum: aa,ab,ae,af,ak,am,an,ar,as,av,ay,az,ba,be,bg,bh,bm,bi,bn,bo,br,bs,ca,ce,ch,co,cr,cs,cu,cv,cy,da,de,dv,dz,ee,el,en,eo,es,et,eu,fa,ff,fi,fj,fo,fr,fy,ga,gd,gl,gn,gu,gv,ha,he,hi,ho,hr,ht,hu,hy,hz,ia,id,ie,ig,ii,ik,io,is,it,iu,ja,jv,ka,kg,ki,kj,kk,kl,km,kn,ko,kr,ks,ku,kv,kw,ky,la,lb,lg,li,ln,lo,lt,lu,lv,mg,mh,mi,mk,ml,mn,mr,ms,mt,my,na,nb,nd,ne,ng,nl,nn,no,nr,nv,ny,oc,oj,om,or,os,pa,pi,pl,ps,pt,qu,rm,rn,ro,ru,rw,sa,sc,sd,se,sg,si,sk,sl,sm,sn,so,sq,sr,ss,st,su,sv,sw,ta,te,tg,th,ti,tk,tl,tn,to,tr,ts,tt,tw,ty,ug,uk,ur,uz,ve,vi,vo,wa,wo,xh,yi,yo,za,zh,zu

lastNamestring

maxLength: 48

minLength: 0

phoneNumberstring

maxLength: 128

minLength: 0

statestring

maxLength: 64

minLength: 0

streetAddress1string

maxLength: 128

minLength: 0

streetAddress2string

maxLength: 128

minLength: 0

titlestring

maxLength: 24

minLength: 0

yourReferencestring

maxLength: 48

minLength: 0

zipCodestring

maxLength: 20

minLength: 0

customerNumberstring

maxLength: 48

minLength: 0

customerTypestring

Enum: PRIVATE,ORGANISATION,MUNICIPAL

customerVatIdstring

maxLength: 48

minLength: 0

regNumberstring

Organisation number for companies, social security number for persons. Needs to be in a valid format. For some countries the specified regNumber will be reformatted slightly internally to match standard formatting for the country.

maxLength: 48

minLength: 0

websiteUrlstring

maxLength: 128

minLength: 0

invoiceDatedate
invoiceNumberstring
invoicePdfUrlstring
invoicePeriodobject
endDatedate

Indicate the end date of this invoice period

startDatedate

Indicate the start date of this invoice period

isOverdueboolean
items
objectobject
additionalDetailstring
articleNumberstring

Mandatory for FREEFORM line items.

calculationModestring

Identifies which of the three Item calculation modes that this item uses. Hint: Use a deserializer that supports polymorphic deserialization and let it use this attribute to decide which sub model to use.

Enum: EX_VAT_ROUNDING_PER_ROW,EX_VAT_ROUNDING_AFTER_SUM,INC_VAT_ROUNDING_PER_ROW,EX_VAT_ROUNDING_PER_ROW,EX_VAT_ROUNDING_AFTER_SUM,INC_VAT_ROUNDING_PER_ROW

costCenterstring
descriptionstring
itemTypestring

Enum: FREEFORM,INFOLINE

positionint32
quantitynumber

Maximum 6 decimals.

salesAccountCodeint32
unitstring
vatAccountCodeint32
unitPriceExcludingVatnumber

Unit price in decimal form, excluding VAT. Maximum 6 decimals.

vatPercentagenumber

VAT percentage in decimal form. Maximum 2 decimals.

orderApproveDatedate-time
orderIdint64
orderReferenceIdstring
orderStatusstring

Enum: NEW,APPROVED,DENIED

ourReferencestring
parentInvoiceNumberint64
paymentBankAccountsarray[object]
accountHolderCountrystring

Enum: AL,DZ,AS,AD,AO,AI,AQ,AG,AR,AM,AW,AU,AT,AZ,BS,BH,BD,BB,BE,BZ,BJ,BM,BT,BO,BQ,BA,BW,BV,BR,IO,BN,BG,BF,BI,CV,KH,CM,CA,KY,CF,TD,CL,CN,CX,CC,CO,KM,CD,CG,CK,CR,HR,CW,CY,CZ,CI,DK,DJ,DM,DO,EC,EG,SV,GQ,ER,EE,SZ,ET,FK,FO,FJ,FI,FR,GF,PF,TF,GA,GM,GE,DE,GH,GI,GR,GL,GD,GP,GU,GT,GG,GN,GW,GY,HT,HM,VA,HN,HK,HU,IS,IN,ID,IQ,IE,IM,IL,IT,JM,JP,JE,JO,KZ,KE,KI,KR,KW,KG,LA,LV,LB,LS,LR,LY,LI,LT,LU,MO,MG,MW,MY,MV,ML,MT,MH,MQ,MR,MU,YT,MX,FM,MD,MC,MN,ME,MS,MA,MZ,NA,NR,NP,NL,NC,NZ,NI,NE,NG,NU,NF,MP,NO,OM,PK,PW,PA,PG,PY,PE,PH,PN,PL,PT,PR,QA,MK,RO,RW,RE,BL,SH,KN,LC,MF,PM,VC,WS,SM,ST,SA,SN,RS,SC,SL,SG,SX,SK,SI,SB,SO,ZA,GS,SS,ES,LK,SD,SR,SJ,SE,CH,TW,TJ,TZ,TH,TL,TG,TK,TO,TT,TN,TR,TM,TC,TV,UG,UA,AE,GB,UM,US,UY,UZ,VU,VN,VG,VI,WF,EH,YE,ZM,ZW,AX

accountHolderNamestring
accountNumberstring
bicstring
typestring

Enum: BANKGIRO,PLUSGIRO,IBAN,SE_GENERIC

paymentStatusstring

Enum: UNPAID,RESERVED,PARTIALLY_PAID,PAID,UNUSED,PARTIALLY_USED,USED

paymentsarray[object]
amountint64

Amount in cents, 10 SEK = 1000

bookingDatedate

Always the date the payment was booked on the account.

currencyCodestring

Enum: DKK,EUR,GBP,NOK,SEK,USD,CHF

effectiveBookingDatedate

The date the payment was booked on the account, unless it was manually mapped. In that case it is the date the mapping was done.

paymentDatedate-time
referenceNumberstring
typestring

Enum: BANK,CARD,POS,DIRECT_BANK,SWISH,KLARNA,CREDIT_INVOICE,MANUAL,WRITE_OFF,REBALANCED,EXPECTED_BAD_WRITE_OFF,BAD_DEBT_WRITE_OFF

projectstring
publicInvoiceUrlstring
referenceNumberstring
remindersarray[object]
creationTimedate-time
deliveryTypesarray[string]

Enum: NONE,EMAIL,PRINT,EINVOICE,SMS

modifiedTimedate-time
reminderNumberint32
remindersAreCancelledboolean
sellingCustomerobject
addressobject
citystring

maxLength: 48

minLength: 0

coAddressstring

maxLength: 128

minLength: 0

companyNamestring

maxLength: 128

minLength: 0

countryCodestring

Enum: AL,DZ,AS,AD,AO,AI,AQ,AG,AR,AM,AW,AU,AT,AZ,BS,BH,BD,BB,BE,BZ,BJ,BM,BT,BO,BQ,BA,BW,BV,BR,IO,BN,BG,BF,BI,CV,KH,CM,CA,KY,CF,TD,CL,CN,CX,CC,CO,KM,CD,CG,CK,CR,HR,CW,CY,CZ,CI,DK,DJ,DM,DO,EC,EG,SV,GQ,ER,EE,SZ,ET,FK,FO,FJ,FI,FR,GF,PF,TF,GA,GM,GE,DE,GH,GI,GR,GL,GD,GP,GU,GT,GG,GN,GW,GY,HT,HM,VA,HN,HK,HU,IS,IN,ID,IQ,IE,IM,IL,IT,JM,JP,JE,JO,KZ,KE,KI,KR,KW,KG,LA,LV,LB,LS,LR,LY,LI,LT,LU,MO,MG,MW,MY,MV,ML,MT,MH,MQ,MR,MU,YT,MX,FM,MD,MC,MN,ME,MS,MA,MZ,NA,NR,NP,NL,NC,NZ,NI,NE,NG,NU,NF,MP,NO,OM,PK,PW,PA,PG,PY,PE,PH,PN,PL,PT,PR,QA,MK,RO,RW,RE,BL,SH,KN,LC,MF,PM,VC,WS,SM,ST,SA,SN,RS,SC,SL,SG,SX,SK,SI,SB,SO,ZA,GS,SS,ES,LK,SD,SR,SJ,SE,CH,TW,TJ,TZ,TH,TL,TG,TK,TO,TT,TN,TR,TM,TC,TV,UG,UA,AE,GB,UM,US,UY,UZ,VU,VN,VG,VI,WF,EH,YE,ZM,ZW,AX

emailAddressstring

maxLength: 128

minLength: 0

emailAddressBccstring

maxLength: 128

minLength: 0

emailAddressCcstring

maxLength: 128

minLength: 0

firstNamestring

maxLength: 48

minLength: 0

glnstring

maxLength: 128

minLength: 0

houseAddressstring

maxLength: 128

minLength: 0

languageCodestring

Enum: aa,ab,ae,af,ak,am,an,ar,as,av,ay,az,ba,be,bg,bh,bm,bi,bn,bo,br,bs,ca,ce,ch,co,cr,cs,cu,cv,cy,da,de,dv,dz,ee,el,en,eo,es,et,eu,fa,ff,fi,fj,fo,fr,fy,ga,gd,gl,gn,gu,gv,ha,he,hi,ho,hr,ht,hu,hy,hz,ia,id,ie,ig,ii,ik,io,is,it,iu,ja,jv,ka,kg,ki,kj,kk,kl,km,kn,ko,kr,ks,ku,kv,kw,ky,la,lb,lg,li,ln,lo,lt,lu,lv,mg,mh,mi,mk,ml,mn,mr,ms,mt,my,na,nb,nd,ne,ng,nl,nn,no,nr,nv,ny,oc,oj,om,or,os,pa,pi,pl,ps,pt,qu,rm,rn,ro,ru,rw,sa,sc,sd,se,sg,si,sk,sl,sm,sn,so,sq,sr,ss,st,su,sv,sw,ta,te,tg,th,ti,tk,tl,tn,to,tr,ts,tt,tw,ty,ug,uk,ur,uz,ve,vi,vo,wa,wo,xh,yi,yo,za,zh,zu

lastNamestring

maxLength: 48

minLength: 0

phoneNumberstring

maxLength: 128

minLength: 0

statestring

maxLength: 64

minLength: 0

streetAddress1string

maxLength: 128

minLength: 0

streetAddress2string

maxLength: 128

minLength: 0

titlestring

maxLength: 24

minLength: 0

yourReferencestring

maxLength: 48

minLength: 0

zipCodestring

maxLength: 20

minLength: 0

customerNumberstring

maxLength: 48

minLength: 0

customerTypestring

Enum: PRIVATE,ORGANISATION,MUNICIPAL

customerVatIdstring

maxLength: 48

minLength: 0

regNumberstring

Organisation number for companies, social security number for persons. Needs to be in a valid format. For some countries the specified regNumber will be reformatted slightly internally to match standard formatting for the country.

maxLength: 48

minLength: 0

websiteUrlstring

maxLength: 128

minLength: 0

sitestring
statusstring

Enum: NEW,CANCELLED

storeIdstring

Deprecated. Use 'site' instead.

typestring

Enum: PREPAYMENT,NORMAL

uniqueIdstring
websiteInvoiceSeqNoint64
nextInvoiceNumberint64
400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error

503

Service Unavailable

Response

Returns all credit invoices for a given orderId or orderReferenceId

An Invoice created with the V2 API can only be fetched using the V2 API

Auth
Query String
orderIdinteger
orderReferenceIdstring

maxLength: 48

minLength: 0

GET /api/v2/orders/invoices/credit
Responses
200

OK

objectobject
invoicesarray[object]
amountToPayint64

Amount to pay in cents, 10 SEK = 1000

balanceint64

Balance of the invoice. A positive value means that there's outstanding amount for buyer to pay to seller. In cents, 10 SEK = 1000

calculationModestring

Enum: EX_VAT_ROUNDING_PER_ROW,EX_VAT_ROUNDING_AFTER_SUM,INC_VAT_ROUNDING_PER_ROW

countryCodestring

Enum: AL,DZ,AS,AD,AO,AI,AQ,AG,AR,AM,AW,AU,AT,AZ,BS,BH,BD,BB,BE,BZ,BJ,BM,BT,BO,BQ,BA,BW,BV,BR,IO,BN,BG,BF,BI,CV,KH,CM,CA,KY,CF,TD,CL,CN,CX,CC,CO,KM,CD,CG,CK,CR,HR,CW,CY,CZ,CI,DK,DJ,DM,DO,EC,EG,SV,GQ,ER,EE,SZ,ET,FK,FO,FJ,FI,FR,GF,PF,TF,GA,GM,GE,DE,GH,GI,GR,GL,GD,GP,GU,GT,GG,GN,GW,GY,HT,HM,VA,HN,HK,HU,IS,IN,ID,IQ,IE,IM,IL,IT,JM,JP,JE,JO,KZ,KE,KI,KR,KW,KG,LA,LV,LB,LS,LR,LY,LI,LT,LU,MO,MG,MW,MY,MV,ML,MT,MH,MQ,MR,MU,YT,MX,FM,MD,MC,MN,ME,MS,MA,MZ,NA,NR,NP,NL,NC,NZ,NI,NE,NG,NU,NF,MP,NO,OM,PK,PW,PA,PG,PY,PE,PH,PN,PL,PT,PR,QA,MK,RO,RW,RE,BL,SH,KN,LC,MF,PM,VC,WS,SM,ST,SA,SN,RS,SC,SL,SG,SX,SK,SI,SB,SO,ZA,GS,SS,ES,LK,SD,SR,SJ,SE,CH,TW,TJ,TZ,TH,TL,TG,TK,TO,TT,TN,TR,TM,TC,TV,UG,UA,AE,GB,UM,US,UY,UZ,VU,VN,VG,VI,WF,EH,YE,ZM,ZW,AX

creditedAmountint64
creditsInvoiceWithInvoiceNumberint64

If this is a credit invoice, this will be the invoice number of the original invoice

currencyCodestring

Enum: DKK,EUR,GBP,NOK,SEK,USD,CHF

deliveryTypestring

Enum: NONE,EMAIL,PRINT,EINVOICE,SMS

dueDatedate
externalInvoiceNumberstring
feeBalanceint64
invoiceCustomerobject
addressobject
citystring

maxLength: 48

minLength: 0

coAddressstring

maxLength: 128

minLength: 0

companyNamestring

maxLength: 128

minLength: 0

countryCodestring

Enum: AL,DZ,AS,AD,AO,AI,AQ,AG,AR,AM,AW,AU,AT,AZ,BS,BH,BD,BB,BE,BZ,BJ,BM,BT,BO,BQ,BA,BW,BV,BR,IO,BN,BG,BF,BI,CV,KH,CM,CA,KY,CF,TD,CL,CN,CX,CC,CO,KM,CD,CG,CK,CR,HR,CW,CY,CZ,CI,DK,DJ,DM,DO,EC,EG,SV,GQ,ER,EE,SZ,ET,FK,FO,FJ,FI,FR,GF,PF,TF,GA,GM,GE,DE,GH,GI,GR,GL,GD,GP,GU,GT,GG,GN,GW,GY,HT,HM,VA,HN,HK,HU,IS,IN,ID,IQ,IE,IM,IL,IT,JM,JP,JE,JO,KZ,KE,KI,KR,KW,KG,LA,LV,LB,LS,LR,LY,LI,LT,LU,MO,MG,MW,MY,MV,ML,MT,MH,MQ,MR,MU,YT,MX,FM,MD,MC,MN,ME,MS,MA,MZ,NA,NR,NP,NL,NC,NZ,NI,NE,NG,NU,NF,MP,NO,OM,PK,PW,PA,PG,PY,PE,PH,PN,PL,PT,PR,QA,MK,RO,RW,RE,BL,SH,KN,LC,MF,PM,VC,WS,SM,ST,SA,SN,RS,SC,SL,SG,SX,SK,SI,SB,SO,ZA,GS,SS,ES,LK,SD,SR,SJ,SE,CH,TW,TJ,TZ,TH,TL,TG,TK,TO,TT,TN,TR,TM,TC,TV,UG,UA,AE,GB,UM,US,UY,UZ,VU,VN,VG,VI,WF,EH,YE,ZM,ZW,AX

emailAddressstring

maxLength: 128

minLength: 0

emailAddressBccstring

maxLength: 128

minLength: 0

emailAddressCcstring

maxLength: 128

minLength: 0

firstNamestring

maxLength: 48

minLength: 0

glnstring

maxLength: 128

minLength: 0

houseAddressstring

maxLength: 128

minLength: 0

languageCodestring

Enum: aa,ab,ae,af,ak,am,an,ar,as,av,ay,az,ba,be,bg,bh,bm,bi,bn,bo,br,bs,ca,ce,ch,co,cr,cs,cu,cv,cy,da,de,dv,dz,ee,el,en,eo,es,et,eu,fa,ff,fi,fj,fo,fr,fy,ga,gd,gl,gn,gu,gv,ha,he,hi,ho,hr,ht,hu,hy,hz,ia,id,ie,ig,ii,ik,io,is,it,iu,ja,jv,ka,kg,ki,kj,kk,kl,km,kn,ko,kr,ks,ku,kv,kw,ky,la,lb,lg,li,ln,lo,lt,lu,lv,mg,mh,mi,mk,ml,mn,mr,ms,mt,my,na,nb,nd,ne,ng,nl,nn,no,nr,nv,ny,oc,oj,om,or,os,pa,pi,pl,ps,pt,qu,rm,rn,ro,ru,rw,sa,sc,sd,se,sg,si,sk,sl,sm,sn,so,sq,sr,ss,st,su,sv,sw,ta,te,tg,th,ti,tk,tl,tn,to,tr,ts,tt,tw,ty,ug,uk,ur,uz,ve,vi,vo,wa,wo,xh,yi,yo,za,zh,zu

lastNamestring

maxLength: 48

minLength: 0

phoneNumberstring

maxLength: 128

minLength: 0

statestring

maxLength: 64

minLength: 0

streetAddress1string

maxLength: 128

minLength: 0

streetAddress2string

maxLength: 128

minLength: 0

titlestring

maxLength: 24

minLength: 0

yourReferencestring

maxLength: 48

minLength: 0

zipCodestring

maxLength: 20

minLength: 0

customerNumberstring

maxLength: 48

minLength: 0

customerTypestring

Enum: PRIVATE,ORGANISATION,MUNICIPAL

customerVatIdstring

maxLength: 48

minLength: 0

regNumberstring

Organisation number for companies, social security number for persons. Needs to be in a valid format. For some countries the specified regNumber will be reformatted slightly internally to match standard formatting for the country.

maxLength: 48

minLength: 0

websiteUrlstring

maxLength: 128

minLength: 0

invoiceDatedate
invoiceNumberstring
invoicePdfUrlstring
invoicePeriodobject
endDatedate

Indicate the end date of this invoice period

startDatedate

Indicate the start date of this invoice period

isOverdueboolean
items
objectobject
additionalDetailstring
articleNumberstring

Mandatory for FREEFORM line items.

calculationModestring

Identifies which of the three Item calculation modes that this item uses. Hint: Use a deserializer that supports polymorphic deserialization and let it use this attribute to decide which sub model to use.

Enum: EX_VAT_ROUNDING_PER_ROW,EX_VAT_ROUNDING_AFTER_SUM,INC_VAT_ROUNDING_PER_ROW,EX_VAT_ROUNDING_PER_ROW,EX_VAT_ROUNDING_AFTER_SUM,INC_VAT_ROUNDING_PER_ROW

costCenterstring
descriptionstring
itemTypestring

Enum: FREEFORM,INFOLINE

positionint32
quantitynumber

Maximum 6 decimals.

salesAccountCodeint32
unitstring
vatAccountCodeint32
unitPriceExcludingVatnumber

Unit price in decimal form, excluding VAT. Maximum 6 decimals.

vatPercentagenumber

VAT percentage in decimal form. Maximum 2 decimals.

orderApproveDatedate-time
orderIdint64
orderReferenceIdstring
orderStatusstring

Enum: NEW,APPROVED,DENIED

ourReferencestring
parentInvoiceNumberint64
paymentBankAccountsarray[object]
accountHolderCountrystring

Enum: AL,DZ,AS,AD,AO,AI,AQ,AG,AR,AM,AW,AU,AT,AZ,BS,BH,BD,BB,BE,BZ,BJ,BM,BT,BO,BQ,BA,BW,BV,BR,IO,BN,BG,BF,BI,CV,KH,CM,CA,KY,CF,TD,CL,CN,CX,CC,CO,KM,CD,CG,CK,CR,HR,CW,CY,CZ,CI,DK,DJ,DM,DO,EC,EG,SV,GQ,ER,EE,SZ,ET,FK,FO,FJ,FI,FR,GF,PF,TF,GA,GM,GE,DE,GH,GI,GR,GL,GD,GP,GU,GT,GG,GN,GW,GY,HT,HM,VA,HN,HK,HU,IS,IN,ID,IQ,IE,IM,IL,IT,JM,JP,JE,JO,KZ,KE,KI,KR,KW,KG,LA,LV,LB,LS,LR,LY,LI,LT,LU,MO,MG,MW,MY,MV,ML,MT,MH,MQ,MR,MU,YT,MX,FM,MD,MC,MN,ME,MS,MA,MZ,NA,NR,NP,NL,NC,NZ,NI,NE,NG,NU,NF,MP,NO,OM,PK,PW,PA,PG,PY,PE,PH,PN,PL,PT,PR,QA,MK,RO,RW,RE,BL,SH,KN,LC,MF,PM,VC,WS,SM,ST,SA,SN,RS,SC,SL,SG,SX,SK,SI,SB,SO,ZA,GS,SS,ES,LK,SD,SR,SJ,SE,CH,TW,TJ,TZ,TH,TL,TG,TK,TO,TT,TN,TR,TM,TC,TV,UG,UA,AE,GB,UM,US,UY,UZ,VU,VN,VG,VI,WF,EH,YE,ZM,ZW,AX

accountHolderNamestring
accountNumberstring
bicstring
typestring

Enum: BANKGIRO,PLUSGIRO,IBAN,SE_GENERIC

paymentStatusstring

Enum: UNPAID,RESERVED,PARTIALLY_PAID,PAID,UNUSED,PARTIALLY_USED,USED

paymentsarray[object]
amountint64

Amount in cents, 10 SEK = 1000

bookingDatedate

Always the date the payment was booked on the account.

currencyCodestring

Enum: DKK,EUR,GBP,NOK,SEK,USD,CHF

effectiveBookingDatedate

The date the payment was booked on the account, unless it was manually mapped. In that case it is the date the mapping was done.

paymentDatedate-time
referenceNumberstring
typestring

Enum: BANK,CARD,POS,DIRECT_BANK,SWISH,KLARNA,CREDIT_INVOICE,MANUAL,WRITE_OFF,REBALANCED,EXPECTED_BAD_WRITE_OFF,BAD_DEBT_WRITE_OFF

projectstring
publicInvoiceUrlstring
referenceNumberstring
remindersarray[object]
creationTimedate-time
deliveryTypesarray[string]

Enum: NONE,EMAIL,PRINT,EINVOICE,SMS

modifiedTimedate-time
reminderNumberint32
remindersAreCancelledboolean
sellingCustomerobject
addressobject
citystring

maxLength: 48

minLength: 0

coAddressstring

maxLength: 128

minLength: 0

companyNamestring

maxLength: 128

minLength: 0

countryCodestring

Enum: AL,DZ,AS,AD,AO,AI,AQ,AG,AR,AM,AW,AU,AT,AZ,BS,BH,BD,BB,BE,BZ,BJ,BM,BT,BO,BQ,BA,BW,BV,BR,IO,BN,BG,BF,BI,CV,KH,CM,CA,KY,CF,TD,CL,CN,CX,CC,CO,KM,CD,CG,CK,CR,HR,CW,CY,CZ,CI,DK,DJ,DM,DO,EC,EG,SV,GQ,ER,EE,SZ,ET,FK,FO,FJ,FI,FR,GF,PF,TF,GA,GM,GE,DE,GH,GI,GR,GL,GD,GP,GU,GT,GG,GN,GW,GY,HT,HM,VA,HN,HK,HU,IS,IN,ID,IQ,IE,IM,IL,IT,JM,JP,JE,JO,KZ,KE,KI,KR,KW,KG,LA,LV,LB,LS,LR,LY,LI,LT,LU,MO,MG,MW,MY,MV,ML,MT,MH,MQ,MR,MU,YT,MX,FM,MD,MC,MN,ME,MS,MA,MZ,NA,NR,NP,NL,NC,NZ,NI,NE,NG,NU,NF,MP,NO,OM,PK,PW,PA,PG,PY,PE,PH,PN,PL,PT,PR,QA,MK,RO,RW,RE,BL,SH,KN,LC,MF,PM,VC,WS,SM,ST,SA,SN,RS,SC,SL,SG,SX,SK,SI,SB,SO,ZA,GS,SS,ES,LK,SD,SR,SJ,SE,CH,TW,TJ,TZ,TH,TL,TG,TK,TO,TT,TN,TR,TM,TC,TV,UG,UA,AE,GB,UM,US,UY,UZ,VU,VN,VG,VI,WF,EH,YE,ZM,ZW,AX

emailAddressstring

maxLength: 128

minLength: 0

emailAddressBccstring

maxLength: 128

minLength: 0

emailAddressCcstring

maxLength: 128

minLength: 0

firstNamestring

maxLength: 48

minLength: 0

glnstring

maxLength: 128

minLength: 0

houseAddressstring

maxLength: 128

minLength: 0

languageCodestring

Enum: aa,ab,ae,af,ak,am,an,ar,as,av,ay,az,ba,be,bg,bh,bm,bi,bn,bo,br,bs,ca,ce,ch,co,cr,cs,cu,cv,cy,da,de,dv,dz,ee,el,en,eo,es,et,eu,fa,ff,fi,fj,fo,fr,fy,ga,gd,gl,gn,gu,gv,ha,he,hi,ho,hr,ht,hu,hy,hz,ia,id,ie,ig,ii,ik,io,is,it,iu,ja,jv,ka,kg,ki,kj,kk,kl,km,kn,ko,kr,ks,ku,kv,kw,ky,la,lb,lg,li,ln,lo,lt,lu,lv,mg,mh,mi,mk,ml,mn,mr,ms,mt,my,na,nb,nd,ne,ng,nl,nn,no,nr,nv,ny,oc,oj,om,or,os,pa,pi,pl,ps,pt,qu,rm,rn,ro,ru,rw,sa,sc,sd,se,sg,si,sk,sl,sm,sn,so,sq,sr,ss,st,su,sv,sw,ta,te,tg,th,ti,tk,tl,tn,to,tr,ts,tt,tw,ty,ug,uk,ur,uz,ve,vi,vo,wa,wo,xh,yi,yo,za,zh,zu

lastNamestring

maxLength: 48

minLength: 0

phoneNumberstring

maxLength: 128

minLength: 0

statestring

maxLength: 64

minLength: 0

streetAddress1string

maxLength: 128

minLength: 0

streetAddress2string

maxLength: 128

minLength: 0

titlestring

maxLength: 24

minLength: 0

yourReferencestring

maxLength: 48

minLength: 0

zipCodestring

maxLength: 20

minLength: 0

customerNumberstring

maxLength: 48

minLength: 0

customerTypestring

Enum: PRIVATE,ORGANISATION,MUNICIPAL

customerVatIdstring

maxLength: 48

minLength: 0

regNumberstring

Organisation number for companies, social security number for persons. Needs to be in a valid format. For some countries the specified regNumber will be reformatted slightly internally to match standard formatting for the country.

maxLength: 48

minLength: 0

websiteUrlstring

maxLength: 128

minLength: 0

sitestring
statusstring

Enum: NEW,CANCELLED

storeIdstring

Deprecated. Use 'site' instead.

typestring

Enum: PREPAYMENT,NORMAL

uniqueIdstring
websiteInvoiceSeqNoint64
400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error

503

Service Unavailable

Response

Returns invoices with invoice number >= than given invoice number

Batch size is 20. If more invoices exists, the next invoice number is returned to be used in future requests. Note: By default, the invoice is returned in Inc-Vat format, even if the invoice was originally created with a different calculation mode. Please use the originalCalculationModeResponse flag if you don't want that. Also note: An Invoice created with the V2 API can only be fetched using the V2 API.

Auth
Query String
fromInvoiceNumberinteger
originalCalculationModeResponseboolean

The Items in the response are normally returned in the Inc-Vat format, even if the invoice was originally created with a different calculation mode. This flag makes it possible to get the Items in their original calculation mode in the response. If you enable this it's suggested that you use a deserializer that supports polymorphic deserialization and let the it use the Item 'calculationMode' attribute to decide which sub model to use.

GET /api/v2/orders/invoices/batch
Responses
200

OK

objectobject
invoicesarray[object]
amountToPayint64

Amount to pay in cents, 10 SEK = 1000

balanceint64

Balance of the invoice. A positive value means that there's outstanding amount for buyer to pay to seller. In cents, 10 SEK = 1000

calculationModestring

Enum: EX_VAT_ROUNDING_PER_ROW,EX_VAT_ROUNDING_AFTER_SUM,INC_VAT_ROUNDING_PER_ROW

countryCodestring

Enum: AL,DZ,AS,AD,AO,AI,AQ,AG,AR,AM,AW,AU,AT,AZ,BS,BH,BD,BB,BE,BZ,BJ,BM,BT,BO,BQ,BA,BW,BV,BR,IO,BN,BG,BF,BI,CV,KH,CM,CA,KY,CF,TD,CL,CN,CX,CC,CO,KM,CD,CG,CK,CR,HR,CW,CY,CZ,CI,DK,DJ,DM,DO,EC,EG,SV,GQ,ER,EE,SZ,ET,FK,FO,FJ,FI,FR,GF,PF,TF,GA,GM,GE,DE,GH,GI,GR,GL,GD,GP,GU,GT,GG,GN,GW,GY,HT,HM,VA,HN,HK,HU,IS,IN,ID,IQ,IE,IM,IL,IT,JM,JP,JE,JO,KZ,KE,KI,KR,KW,KG,LA,LV,LB,LS,LR,LY,LI,LT,LU,MO,MG,MW,MY,MV,ML,MT,MH,MQ,MR,MU,YT,MX,FM,MD,MC,MN,ME,MS,MA,MZ,NA,NR,NP,NL,NC,NZ,NI,NE,NG,NU,NF,MP,NO,OM,PK,PW,PA,PG,PY,PE,PH,PN,PL,PT,PR,QA,MK,RO,RW,RE,BL,SH,KN,LC,MF,PM,VC,WS,SM,ST,SA,SN,RS,SC,SL,SG,SX,SK,SI,SB,SO,ZA,GS,SS,ES,LK,SD,SR,SJ,SE,CH,TW,TJ,TZ,TH,TL,TG,TK,TO,TT,TN,TR,TM,TC,TV,UG,UA,AE,GB,UM,US,UY,UZ,VU,VN,VG,VI,WF,EH,YE,ZM,ZW,AX

creditedAmountint64
creditsInvoiceWithInvoiceNumberint64

If this is a credit invoice, this will be the invoice number of the original invoice

currencyCodestring

Enum: DKK,EUR,GBP,NOK,SEK,USD,CHF

deliveryTypestring

Enum: NONE,EMAIL,PRINT,EINVOICE,SMS

dueDatedate
externalInvoiceNumberstring
feeBalanceint64
invoiceCustomerobject
addressobject
citystring

maxLength: 48

minLength: 0

coAddressstring

maxLength: 128

minLength: 0

companyNamestring

maxLength: 128

minLength: 0

countryCodestring

Enum: AL,DZ,AS,AD,AO,AI,AQ,AG,AR,AM,AW,AU,AT,AZ,BS,BH,BD,BB,BE,BZ,BJ,BM,BT,BO,BQ,BA,BW,BV,BR,IO,BN,BG,BF,BI,CV,KH,CM,CA,KY,CF,TD,CL,CN,CX,CC,CO,KM,CD,CG,CK,CR,HR,CW,CY,CZ,CI,DK,DJ,DM,DO,EC,EG,SV,GQ,ER,EE,SZ,ET,FK,FO,FJ,FI,FR,GF,PF,TF,GA,GM,GE,DE,GH,GI,GR,GL,GD,GP,GU,GT,GG,GN,GW,GY,HT,HM,VA,HN,HK,HU,IS,IN,ID,IQ,IE,IM,IL,IT,JM,JP,JE,JO,KZ,KE,KI,KR,KW,KG,LA,LV,LB,LS,LR,LY,LI,LT,LU,MO,MG,MW,MY,MV,ML,MT,MH,MQ,MR,MU,YT,MX,FM,MD,MC,MN,ME,MS,MA,MZ,NA,NR,NP,NL,NC,NZ,NI,NE,NG,NU,NF,MP,NO,OM,PK,PW,PA,PG,PY,PE,PH,PN,PL,PT,PR,QA,MK,RO,RW,RE,BL,SH,KN,LC,MF,PM,VC,WS,SM,ST,SA,SN,RS,SC,SL,SG,SX,SK,SI,SB,SO,ZA,GS,SS,ES,LK,SD,SR,SJ,SE,CH,TW,TJ,TZ,TH,TL,TG,TK,TO,TT,TN,TR,TM,TC,TV,UG,UA,AE,GB,UM,US,UY,UZ,VU,VN,VG,VI,WF,EH,YE,ZM,ZW,AX

emailAddressstring

maxLength: 128

minLength: 0

emailAddressBccstring

maxLength: 128

minLength: 0

emailAddressCcstring

maxLength: 128

minLength: 0

firstNamestring

maxLength: 48

minLength: 0

glnstring

maxLength: 128

minLength: 0

houseAddressstring

maxLength: 128

minLength: 0

languageCodestring

Enum: aa,ab,ae,af,ak,am,an,ar,as,av,ay,az,ba,be,bg,bh,bm,bi,bn,bo,br,bs,ca,ce,ch,co,cr,cs,cu,cv,cy,da,de,dv,dz,ee,el,en,eo,es,et,eu,fa,ff,fi,fj,fo,fr,fy,ga,gd,gl,gn,gu,gv,ha,he,hi,ho,hr,ht,hu,hy,hz,ia,id,ie,ig,ii,ik,io,is,it,iu,ja,jv,ka,kg,ki,kj,kk,kl,km,kn,ko,kr,ks,ku,kv,kw,ky,la,lb,lg,li,ln,lo,lt,lu,lv,mg,mh,mi,mk,ml,mn,mr,ms,mt,my,na,nb,nd,ne,ng,nl,nn,no,nr,nv,ny,oc,oj,om,or,os,pa,pi,pl,ps,pt,qu,rm,rn,ro,ru,rw,sa,sc,sd,se,sg,si,sk,sl,sm,sn,so,sq,sr,ss,st,su,sv,sw,ta,te,tg,th,ti,tk,tl,tn,to,tr,ts,tt,tw,ty,ug,uk,ur,uz,ve,vi,vo,wa,wo,xh,yi,yo,za,zh,zu

lastNamestring

maxLength: 48

minLength: 0

phoneNumberstring

maxLength: 128

minLength: 0

statestring

maxLength: 64

minLength: 0

streetAddress1string

maxLength: 128

minLength: 0

streetAddress2string

maxLength: 128

minLength: 0

titlestring

maxLength: 24

minLength: 0

yourReferencestring

maxLength: 48

minLength: 0

zipCodestring

maxLength: 20

minLength: 0

customerNumberstring

maxLength: 48

minLength: 0

customerTypestring

Enum: PRIVATE,ORGANISATION,MUNICIPAL

customerVatIdstring

maxLength: 48

minLength: 0

regNumberstring

Organisation number for companies, social security number for persons. Needs to be in a valid format. For some countries the specified regNumber will be reformatted slightly internally to match standard formatting for the country.

maxLength: 48

minLength: 0

websiteUrlstring

maxLength: 128

minLength: 0

invoiceDatedate
invoiceNumberstring
invoicePdfUrlstring
invoicePeriodobject
endDatedate

Indicate the end date of this invoice period

startDatedate

Indicate the start date of this invoice period

isOverdueboolean
items
objectobject
additionalDetailstring
articleNumberstring

Mandatory for FREEFORM line items.

calculationModestring

Identifies which of the three Item calculation modes that this item uses. Hint: Use a deserializer that supports polymorphic deserialization and let it use this attribute to decide which sub model to use.

Enum: EX_VAT_ROUNDING_PER_ROW,EX_VAT_ROUNDING_AFTER_SUM,INC_VAT_ROUNDING_PER_ROW,EX_VAT_ROUNDING_PER_ROW,EX_VAT_ROUNDING_AFTER_SUM,INC_VAT_ROUNDING_PER_ROW

costCenterstring
descriptionstring
itemTypestring

Enum: FREEFORM,INFOLINE

positionint32
quantitynumber

Maximum 6 decimals.

salesAccountCodeint32
unitstring
vatAccountCodeint32
unitPriceExcludingVatnumber

Unit price in decimal form, excluding VAT. Maximum 6 decimals.

vatPercentagenumber

VAT percentage in decimal form. Maximum 2 decimals.

orderApproveDatedate-time
orderIdint64
orderReferenceIdstring
orderStatusstring

Enum: NEW,APPROVED,DENIED

ourReferencestring
parentInvoiceNumberint64
paymentBankAccountsarray[object]
accountHolderCountrystring

Enum: AL,DZ,AS,AD,AO,AI,AQ,AG,AR,AM,AW,AU,AT,AZ,BS,BH,BD,BB,BE,BZ,BJ,BM,BT,BO,BQ,BA,BW,BV,BR,IO,BN,BG,BF,BI,CV,KH,CM,CA,KY,CF,TD,CL,CN,CX,CC,CO,KM,CD,CG,CK,CR,HR,CW,CY,CZ,CI,DK,DJ,DM,DO,EC,EG,SV,GQ,ER,EE,SZ,ET,FK,FO,FJ,FI,FR,GF,PF,TF,GA,GM,GE,DE,GH,GI,GR,GL,GD,GP,GU,GT,GG,GN,GW,GY,HT,HM,VA,HN,HK,HU,IS,IN,ID,IQ,IE,IM,IL,IT,JM,JP,JE,JO,KZ,KE,KI,KR,KW,KG,LA,LV,LB,LS,LR,LY,LI,LT,LU,MO,MG,MW,MY,MV,ML,MT,MH,MQ,MR,MU,YT,MX,FM,MD,MC,MN,ME,MS,MA,MZ,NA,NR,NP,NL,NC,NZ,NI,NE,NG,NU,NF,MP,NO,OM,PK,PW,PA,PG,PY,PE,PH,PN,PL,PT,PR,QA,MK,RO,RW,RE,BL,SH,KN,LC,MF,PM,VC,WS,SM,ST,SA,SN,RS,SC,SL,SG,SX,SK,SI,SB,SO,ZA,GS,SS,ES,LK,SD,SR,SJ,SE,CH,TW,TJ,TZ,TH,TL,TG,TK,TO,TT,TN,TR,TM,TC,TV,UG,UA,AE,GB,UM,US,UY,UZ,VU,VN,VG,VI,WF,EH,YE,ZM,ZW,AX

accountHolderNamestring
accountNumberstring
bicstring
typestring

Enum: BANKGIRO,PLUSGIRO,IBAN,SE_GENERIC

paymentStatusstring

Enum: UNPAID,RESERVED,PARTIALLY_PAID,PAID,UNUSED,PARTIALLY_USED,USED

paymentsarray[object]
amountint64

Amount in cents, 10 SEK = 1000

bookingDatedate

Always the date the payment was booked on the account.

currencyCodestring

Enum: DKK,EUR,GBP,NOK,SEK,USD,CHF

effectiveBookingDatedate

The date the payment was booked on the account, unless it was manually mapped. In that case it is the date the mapping was done.

paymentDatedate-time
referenceNumberstring
typestring

Enum: BANK,CARD,POS,DIRECT_BANK,SWISH,KLARNA,CREDIT_INVOICE,MANUAL,WRITE_OFF,REBALANCED,EXPECTED_BAD_WRITE_OFF,BAD_DEBT_WRITE_OFF

projectstring
publicInvoiceUrlstring
referenceNumberstring
remindersarray[object]
creationTimedate-time
deliveryTypesarray[string]

Enum: NONE,EMAIL,PRINT,EINVOICE,SMS

modifiedTimedate-time
reminderNumberint32
remindersAreCancelledboolean
sellingCustomerobject
addressobject
citystring

maxLength: 48

minLength: 0

coAddressstring

maxLength: 128

minLength: 0

companyNamestring

maxLength: 128

minLength: 0

countryCodestring

Enum: AL,DZ,AS,AD,AO,AI,AQ,AG,AR,AM,AW,AU,AT,AZ,BS,BH,BD,BB,BE,BZ,BJ,BM,BT,BO,BQ,BA,BW,BV,BR,IO,BN,BG,BF,BI,CV,KH,CM,CA,KY,CF,TD,CL,CN,CX,CC,CO,KM,CD,CG,CK,CR,HR,CW,CY,CZ,CI,DK,DJ,DM,DO,EC,EG,SV,GQ,ER,EE,SZ,ET,FK,FO,FJ,FI,FR,GF,PF,TF,GA,GM,GE,DE,GH,GI,GR,GL,GD,GP,GU,GT,GG,GN,GW,GY,HT,HM,VA,HN,HK,HU,IS,IN,ID,IQ,IE,IM,IL,IT,JM,JP,JE,JO,KZ,KE,KI,KR,KW,KG,LA,LV,LB,LS,LR,LY,LI,LT,LU,MO,MG,MW,MY,MV,ML,MT,MH,MQ,MR,MU,YT,MX,FM,MD,MC,MN,ME,MS,MA,MZ,NA,NR,NP,NL,NC,NZ,NI,NE,NG,NU,NF,MP,NO,OM,PK,PW,PA,PG,PY,PE,PH,PN,PL,PT,PR,QA,MK,RO,RW,RE,BL,SH,KN,LC,MF,PM,VC,WS,SM,ST,SA,SN,RS,SC,SL,SG,SX,SK,SI,SB,SO,ZA,GS,SS,ES,LK,SD,SR,SJ,SE,CH,TW,TJ,TZ,TH,TL,TG,TK,TO,TT,TN,TR,TM,TC,TV,UG,UA,AE,GB,UM,US,UY,UZ,VU,VN,VG,VI,WF,EH,YE,ZM,ZW,AX

emailAddressstring

maxLength: 128

minLength: 0

emailAddressBccstring

maxLength: 128

minLength: 0

emailAddressCcstring

maxLength: 128

minLength: 0

firstNamestring

maxLength: 48

minLength: 0

glnstring

maxLength: 128

minLength: 0

houseAddressstring

maxLength: 128

minLength: 0

languageCodestring

Enum: aa,ab,ae,af,ak,am,an,ar,as,av,ay,az,ba,be,bg,bh,bm,bi,bn,bo,br,bs,ca,ce,ch,co,cr,cs,cu,cv,cy,da,de,dv,dz,ee,el,en,eo,es,et,eu,fa,ff,fi,fj,fo,fr,fy,ga,gd,gl,gn,gu,gv,ha,he,hi,ho,hr,ht,hu,hy,hz,ia,id,ie,ig,ii,ik,io,is,it,iu,ja,jv,ka,kg,ki,kj,kk,kl,km,kn,ko,kr,ks,ku,kv,kw,ky,la,lb,lg,li,ln,lo,lt,lu,lv,mg,mh,mi,mk,ml,mn,mr,ms,mt,my,na,nb,nd,ne,ng,nl,nn,no,nr,nv,ny,oc,oj,om,or,os,pa,pi,pl,ps,pt,qu,rm,rn,ro,ru,rw,sa,sc,sd,se,sg,si,sk,sl,sm,sn,so,sq,sr,ss,st,su,sv,sw,ta,te,tg,th,ti,tk,tl,tn,to,tr,ts,tt,tw,ty,ug,uk,ur,uz,ve,vi,vo,wa,wo,xh,yi,yo,za,zh,zu

lastNamestring

maxLength: 48

minLength: 0

phoneNumberstring

maxLength: 128

minLength: 0

statestring

maxLength: 64

minLength: 0

streetAddress1string

maxLength: 128

minLength: 0

streetAddress2string

maxLength: 128

minLength: 0

titlestring

maxLength: 24

minLength: 0

yourReferencestring

maxLength: 48

minLength: 0

zipCodestring

maxLength: 20

minLength: 0

customerNumberstring

maxLength: 48

minLength: 0

customerTypestring

Enum: PRIVATE,ORGANISATION,MUNICIPAL

customerVatIdstring

maxLength: 48

minLength: 0

regNumberstring

Organisation number for companies, social security number for persons. Needs to be in a valid format. For some countries the specified regNumber will be reformatted slightly internally to match standard formatting for the country.

maxLength: 48

minLength: 0

websiteUrlstring

maxLength: 128

minLength: 0

sitestring
statusstring

Enum: NEW,CANCELLED

storeIdstring

Deprecated. Use 'site' instead.

typestring

Enum: PREPAYMENT,NORMAL

uniqueIdstring
websiteInvoiceSeqNoint64
nextInvoiceNumberint64
400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error

503

Service Unavailable

Response