Skip to main content
POST
Create an invoice
Learn more:
  • What is an invoice? ↗
  • What is a contact? ↗
  • What is a product? ↗
  • What is a tax? ↗

Path Parameters

consumer_id
string<uuid>
required

Body

application/json
currency
string
required

Currency matching target sofware name

Example:

"EUR"

invoice_type
enum<string>
required

Invoice type

Available options:
customer_invoice,
customer_refund,
supplier_invoice,
supplier_refund
status
enum<string>
required

Status

Available options:
cancelled,
draft,
posted,
paid
invoice_date
string<date>
required

Invoicing date

Example:

"2026-01-15"

tax_amount
number
required

Taxes amount

Example:

42

untaxed_amount
number
required

Untaxed amount

Example:

200

total
number
required

Total amount incl. taxes

Example:

242

lines
InvoiceLineItem · object[]

Invoice lines

partner_id
string | null

Technical id of the vendor/customer in Chift

Example:

"<invoicing-partner-id>"

invoice_number
string | null

Number/sequence

Example:

"INV-2026-0001"

due_date
string<date> | null

Due date

Example:

"2026-02-14"

reference
string | null

Reference

Example:

"REF-0001"

payment_communication
string | null

Payment communication

Example:

"+++000/0000/00000+++"

customer_memo
string | null

Customer note/memo

Example:

"Thank you for your business."

journal_ref
FieldRef · object | null

Journal

italian_specificities
ItalianSpecificities · object | null

Specificities for Italy

spanish_specificities
SpanishSpecificities · object | null

Specificities for Spain

Response

Successful Response

id
string
required

Technical id in Chift

Example:

"<this-id>"

source_ref
Ref · object
required

Technical id in the target software

currency
string
required

Currency matching target sofware name

Example:

"EUR"

invoice_type
enum<string>
required

Invoice type

Available options:
customer_invoice,
customer_refund,
supplier_invoice,
supplier_refund,
all
status
enum<string>
required

Status

Available options:
cancelled,
draft,
posted,
paid
invoice_date
string<date>
required

Invoicing date

Example:

"2026-01-15"

tax_amount
number
required

Taxes amount

Example:

42

untaxed_amount
number
required

Untaxed amount

Example:

200

total
number
required

Total amount incl. taxes

Example:

242

lines
InvoiceLineItemOut · object[]

Invoice lines

partner_id
string | null

Technical id of the vendor/customer in Chift

Example:

"<invoicing-partner-id>"

invoice_number
string | null

Number/sequence

Example:

"INV-2026-0001"

due_date
string<date> | null

Due date

Example:

"2026-02-14"

reference
string | null

Reference

Example:

"REF-0001"

payment_communication
string | null

Payment communication

Example:

"+++000/0000/00000+++"

customer_memo
string | null

Customer note/memo

Example:

"Thank you for your business."

journal_ref
FieldRef · object | null

Journal

italian_specificities
ItalianSpecificities · object | null

Specificities for Italy

spanish_specificities
SpanishSpecificities · object | null

Specificities for Spain

last_updated_on
string<date-time> | null
Example:

"2026-01-15T10:30:00Z"

outstanding_amount
number | null

Amount left to be paid

Example:

0

last_payment_date
string<date> | null

Date of the last payment linked to the invoice

Example:

"2026-02-14"

accounting_date
string<date> | null

Accounting date

Example:

"2026-01-15"

payment_method_id
string | null

Technical id of the payment method in Chift

Example:

"<invoicing-payment-method-id>"

currency_exchange_rate
number | null
default:1

Exchange rate from the invoice currency to the connector's base currency, at the date of the invoice.