Create invoice

POST

accounting

invoices

Test Api token:

663222ee

Test Account token:

85b30b51

Field support per integration

Please ensure the query parameters environmentName and companyId are accurately filled with the respective environment and company id to which the contact belongs. You can obtain these values by using the GET Environments and GET Companies endpoints available under the Authentication section.

Supported Request Parameters:

invoiceNumber

string

contactId

string

required

invoiceType

enum

Available options: STANDARD

currency

enum

Available options (3-letter ISO 4217):
AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN, BWP, BYR, BZD, CAD, CDF, CHF, CLP, CNY, COP, CRC, CUC, CVE, CZK, DJF, DKK, DOP, DZD, EEK, EGP, ERN, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GQE, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, IQD, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LTL, LVL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRO, MUR, MVR, MWK, MXN, MYR, MZM, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLL, SOS, SRD, SYP, SZL, THB, TJS, TMT, TND, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VEB, VND, VUV, WST, XAF, XCD, XDR, XOF, XPF, YER, ZAR, ZMK, ZWR

invoiceDate

string

ISO-8601 date format, e.g., 2024-01-01T00:00:00Z

dueDate

string

ISO-8601 date format, e.g., 2024-01-01T00:00:00Z

addresses

Address[]

lineItems

LineItem[]

As a minimum a valid contactId OR a name and countryCode must be provided. We recommend to always provide a valid address in addition in the latter case

Supported Request Parameters:

contactId

string

name

string

currency

enum

required

Available options (3-letter ISO 4217):

AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN, BWP, BYR, BZD, CAD, CDF, CHF, CLP, CNY, COP, CRC, CUC, CVE, CZK, DJF, DKK, DOP, DZD, EEK, EGP, ERN, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GQE, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, IQD, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LTL, LVL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRO, MUR, MVR, MWK, MXN, MYR, MZM, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLL, SOS, SRD, SYP, SZL, THB, TJS, TMT, TND, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VEB, VND, VUV, WST, XAF, XCD, XDR, XOF, XPF, YER, ZAR, ZMK, ZWR

invoiceDate

string

required

ISO-8601 date format, e.g., 2024-01-01T00:00:00Z

addresses

Address[]

taxRule

enum

required

Available options:

NET, GROSS, FREETAX, INTRACOMMUNITY, CONSTRUCTIONSERVICE, EXTERNALSERVICE, THIRDPARTYCOUNTRYSERVICE , THIRDPARTYCOUNTRYDELIVERY, REVERSECHARGE, VATSALES, EXPORT, NONE

lineItems

LineItem[]

required

shippingType

enum

required

Available options:

SERVICE, SERVICEPERIOD, DELIVERY, DELIVERYPERIOD, NONE

shippingDate

string

ISO-8601 date format, e.g., 2024-01-01T00:00:00Z

shippingEndDate

string

ISO-8601 date format, e.g., 2024-01-01T00:00:00Z

paymentTermDuration

number

Headers

X-API-KEY

string

API key

X-ACCOUNT-KEY

string

Account key

Query Parameters

environmentName

string

companyId

string

Body

application/json

invoiceId

string

contactId

string

name

string

reference

string

currency

enum<string>

required

Available options:

AED,

AFN,

ALL,

AMD,

ANG,

AOA,

ARS,

AUD,

AWG,

AZN,

BAM,

BBD,

BDT,

BGN,

BHD,

BIF,

BMD,

BND,

BOB,

BRL,

BSD,

BTN,

BWP,

BYR,

BZD,

CAD,

CDF,

CHF,

CLP,

CNY,

COP,

CRC,

CUC,

CVE,

CZK,

DJF,

DKK,

DOP,

DZD,

EEK,

EGP,

ERN,

ETB,

EUR,

FJD,

FKP,

GBP,

GEL,

GHS,

GIP,

GMD,

GNF,

GQE,

GTQ,

GYD,

HKD,

HNL,

HRK,

HTG,

HUF,

IDR,

ILS,

INR,

IQD,

IRR,

ISK,

JMD,

JOD,

JPY,

KES,

KGS,

KHR,

KMF,

KPW,

KRW,

KWD,

KYD,

KZT,

LAK,

LBP,

LKR,

LRD,

LSL,

LTL,

LVL,

LYD,

MAD,

MDL,

MGA,

MKD,

MMK,

MNT,

MOP,

MRO,

MUR,

MVR,

MWK,

MXN,

MYR,

MZM,

NAD,

NGN,

NIO,

NOK,

NPR,

NZD,

OMR,

PAB,

PEN,

PGK,

PHP,

PKR,

PLN,

PYG,

QAR,

RON,

RSD,

RUB,

SAR,

SBD,

SCR,

SDG,

SEK,

SGD,

SHP,

SLL,

SOS,

SRD,

SYP,

SZL,

THB,

TJS,

TMT,

TND,

TRY,

TTD,

TWD,

TZS,

UAH,

UGX,

USD,

UYU,

UZS,

VEB,

VND,

VUV,

WST,

XAF,

XCD,

XDR,

XOF,

XPF,

YER,

ZAR,

ZMK,

ZWR

invoiceDate

string

required

status

enum<string>

Available options:

DRAFT,

SUBMITTED,

AUTHORISED,

PAID,

CANCELED

invoiceType

enum<string>

Available options:

STANDARD

oneLineAddress

string

addresses

object[]

taxRule

enum<string>

Available options:

NET,

GROSS,

FREETAX,

INTRACOMMUNITY,

CONSTRUCTIONSERVICE,

EXTERNALSERVICE,

THIRDPARTYCOUNTRYSERVICE,

THIRDPARTYCOUNTRYDELIVERY,

REVERSECHARGE,

VATSALES,

EXPORT ,

NONE,

DEFAULT,

EU,

NOTEU,

SS,

CUSTOM

taxText

string

lineItems

object[]

required

grossTotalAmount

number

discountPercentage

number

shippingType

enum<string>

Available options:

SERVICE,

SERVICEPERIOD,

DELIVERY,

DELIVERYPERIOD,

NONE

shippingDate

string

shippingEndDate

string

lineAmountTypes

enum<string>

Available options:

EXCLUSIVE,

INCLUSIVE,

NOTAX

dueDate

string

paidDate

string

paymentTermDuration

number

Response

200 - application/json

Get started

Guides

Integrations

Use cases

API reference

Create invoice

Field support per integration

Headers

Query Parameters

Body

Response

Get started

Guides

Integrations

Use cases

API reference

​Field support per integration

Headers

Query Parameters

Body

Response

Field support per integration