Update a draft client invoice

Authorizations

Authorization

string

header

required

Bearer authorization header: Bearer <token>, where <token> is the access token received from the authorization server at the end of the OAuth 2.0 flow.

Headers

X-Qonto-Staging-Token

string

Required only for Sandbox API requests; to get one, please sign up to the Developer Portal.

Path Parameters

string<uuid>

required

UUID of the client invoice to update.

Example:

"e3d68a1a-b23f-496a-a9a2-815089337720"

Body

application/json

All fields are optional - only provided fields will be updated.

client_id

string<uuid>

issue_date

string<date>

Example:

"2022-03-01"

performance_date

string<date>

Date the initiator has issued or shared the invoice as legally viable. The format should be YYYY-MM-DD

due_date

string<date>

Payment deadline that is added by the initiator. The format should be YYYY-MM-DD

number

string

Invoice's number. Must be unique within the organization.

Maximum string length: 40

Example:

"INV-2023-001"

purchase_order

string

Purchase order data added by the invoice’s initiator.

Maximum string length: 40

terms_and_conditions

string

Additional notes added by the invoice’s initiator.

Maximum string length: 525

header

string

Example:

"This is an example."

footer

string

Example:

"This is an example."

payment_methods

object

Payment method details for the invoice.

Show child attributes

payment_methods.iban

string

required

Beneficiary’s International Bank Account Number (IBAN). The format must follow ISO 13616, and should be a valid IBAN (must start with two letters, followed by 25 digits). The IBAN must be associated to a Qonto account.

settings

object

This collection of propertys can be optionally used to temporarily override some of the organization's properties for this one invoice.

Show child attributes

settings.vat_number

string

Example:

"FR12345678"

settings.company_leadership

string

Example:

"Jan Mueller"

settings.district_court

string

Example:

"Munich"

settings.commercial_register_number

string

Example:

"HRB12345B"

settings.tax_number

string

Example:

"123/123/1234"

Show child attributes

Maximum string length: 12

Example:

"10000.00"

Available options:

AED,

AUD,

BGN,

CAD,

CHF,

CNY,

CZK,

DKK,

EUR,

GBP,

GHS,

HKD,

HUF,

ILS,

MXN,

NOK,

NZD,

PEN,

PLN,

RON,

RSD,

SAR,

SEK,

SGD,

TRY,

USD,

ZAR,

ZMW

Example:

"EUR"

settings.transaction_type

enum<string>

Available options:

goods,

services,

goods_and_services

Example:

"goods"

settings.vat_payment_condition

enum<string>

Available options:

on_receipts,

compensated_for_sales

Example:

"on_receipts"

settings.discount_conditions

string | null

Example:

"Pas d’escompte accordé pour paiement anticipé."

settings.late_payment_penalties

string | null

Example:

"En cas de non-paiement à la date d'échéance, des pénalités calculées à trois fois le taux d’intérêt légal seront appliquées."

settings.legal_fixed_compensation

string | null

Example:

"Tout retard de paiement entraînera une indemnité forfaitaire pour frais de recouvrement de 40€."

items

object[]

Show child attributes

items.title

string

required

Item’s title. It is displayed as the first line of the item in bold in the invoice table. It indicates in a short sentence the product or service being sold.

Maximum string length: 40

items.quantity

string

required

Item’s quantity of the specific product or services being sold. For example, it can be in hours or in number of products. Decimals should be separated by a period “.”

Example:

"0.5"

items.unit_price

object

required

Show child attributes

items.unit_price.value

string

required

Price per unit of product or service sold. Decimals should be separated by a period “.”

items.unit_price.currency

string

required

Item’s currency. Currently, only value allowed is EUR. Format supported is a trigram following ISO 4217.

items.vat_rate

string

required

VAT rate applicable for that particular item. Written in decimals, separated by a period “.” For example, for a VAT of 10%, input is 0.1

Example:

"0.1"

items.description

string

Item’s description of the product or service being sold. It is added below the title of each item in the invoice table. Free format, with a maximum of 300 characters. Use \n to indicate line breaks.

Maximum string length: 1800

items.unit

string

Item’s unit. It is an optional field and allows maximum 20 characters for non Italian organizations.

For Italian organizations, documents are generated in PDF format and in XML format (automatically sent to the Italian tax authorites). In the PDF, unit will appear with a maximum of 20 characters. In the XML file, it is truncated down to the first 10 characters.
For French organizations, documents are generated under the Factur-X format (a structured PDF file with an embedded XML). For the XML file, units that have a corresponding EN16931 code (standard followed by Factur-X format) will be indicated with its relevant code. See mapping below of possible values and their corresponding code.

Possible values and corresponding EN16931 code (pursuant to the “Annexe 7” of the B2B external specifications for French e-invoicing, BT-130, allowed units of measure)

| Unit | EN16931 code | |-|| | unit | C62 | | hour | HUR | | day | DAY | | month | MON | | gram | GRM | | kilogram | KGM | | liter | LTR | | meter | MTR | | square_meter | MTK | | cubic_meter | MTQ | | ampere | AMP | | number_of_articles | NAR | | centimeter | CMT | | cubic_meter_per_hour | MQH | | gigajoule | GV | | gigawatt | A90 | | gigawatt_hour | GWH | | half_year | SAN | | joule | JOU | | kilojoule | KJO | | kilovar | KVR | | kilovolt_ampere_reactive_hour | K3 | | kilowatt | KWT | | kilowatt_hour | KWH | | megajoule | 3B | | megawatt | MAW | | megawatt_hour | MWH | | milligram | MGM | | milliliter | MLT | | millimeter | MMT | | minute | MIN | | pair | PR | | quarter | QAN | | second | SEC | | set | SET | | ton | TNE | | two_week | W4 | | watt_hour | WHR | | week | WEE | | year | ANN | | custom_input_text | ZZ |

Example:

"meter"

items.vat_exemption_reason

enum<string>

VAT exemption reason when the item’s vat_rate is equal to 0. It is required for Italian organizations only, must be indicated for each item that has a VAT rate of 0 and the code must start with N. If VAT rate is not 0, this field should not be included.

Available options:

N1,

N2,

N2.1,

N2.2,

N3,

N3.1,

N3.2,

N3.3,

N3.4,

N3.5,

N3.6,

N4,

N5,

N6,

N6.1,

N6.2,

N6.3,

N6.4,

N6.5,

N6.6,

N6.7,

N6.8,

N6.9,

N7,

S293B,

S262.1,

S259,

S283,

S261,

S262,

S263,

S19.1,

S4.1B,

S4.1A,

S4,

S13B,

S122,

S25,

S21,

S69,

S20,

S84.1.2

Maximum string length: 4

Example:

"N1"

items.discount

object

Show child attributes

items.discount.type

enum<string>

Type of the discount for that item.

Available options:

percentage,

absolute

Example:

"percentage"

items.discount.value

string

Rate or the absolute amount that will be discounted

Example:

"0.1"

report_einvoicing

boolean

For Italian organizations only
Non-Italian organizations should not include this property in the request.
Italian organizations must have e-invoicing activated to use this endpoint, no matter the value of the flag.
By default for an Italian organization that has e-invoicing activated on the Qonto app, if this field is not filled, this property is set to true and the invoice is automatically sent to Italian exchange system (Sistema di Interscambio, or SdI) as an XML e-invoice. If set to false, the invoice will not be sent to SdI.
Use the GET v2/client_invoices to retrieve its e-invoicing status under the property einvoicing_status.

payment_reporting

object

For Italian organizations only
Non-Italian organizations should not include this property in the request.
Object which relates to payment methods and conditions of the invoice.

Show child attributes

payment_reporting.conditions

enum<string>

required

Payment conditions on the invoice.

Available options:

TP01,

TP02,

TP03

Example:

"TP01"

payment_reporting.method

enum<string>

required

Payment method of the invoice.

Available options:

MP01,

MP02,

MP03,

MP04,

MP05,

MP06,

MP07,

MP08,

MP09,

MP10,

MP11,

MP12,

MP13,

MP14,

MP15,

MP16,

MP17,

MP18,

MP19,

MP20,

MP21,

MP22

Example:

"MP01"

welfare_fund

object

For Italian organizations only
Non-Italian organizations should not include this property in the request.
Object which relates to pension contributions added to the total amount to pay, applicable in some cases.
This amount is a percentage added to the total amount of the invoice pre-taxes.

Show child attributes

welfare_fund.type

enum<string>

required

Welfare fund type.

Available options:

TC01,

TC02,

TC03,

TC04,

TC05,

TC06,

TC07,

TC08,

TC09,

TC10,

TC11,

TC12,

TC13,

TC14,

TC15,

TC16,

TC17,

TC18,

TC19,

TC20,

TC21,

TC22

Example:

"TC01"

welfare_fund.rate

string

required

Welfare fund rate applicable for the invoice. Written in decimals, separated by a period “.” For example, for a rate of 1%, input is 0.01, and for a rate of 10%, input is 0.1

Required string length: 4 - 6

Example:

"0.0001"

withholding_tax

object

Only for Italian organizations and Spanish freelancers
Other organizations should not include this property in the request.
Object which relates to an amount of tax paid by the client, rather than the supplier, for specific cases.
This amount is a percentage deducted from the total amount of the invoice after VAT application.
ES freelancers need to only fill the withholding_tax rate field with their IRPF.

Show child attributes

withholding_tax.reason

enum<string>

required

Reason the withholding tax.

Available options:

RF01,

RF02,

RF03,

RF04,

RF05,

RF06

Example:

"RF01"

withholding_tax.rate

string

required

Withholding tax rate applicable for the invoice. Written in decimals, separated by a period “.” For example, for a rate of 1%, input is 0.01 and for a rate of 10%, input is 0.1

Required string length: 4 - 6

Example:

"0.01"

withholding_tax.payment_reason

string

required

Payment reason the withholding tax.

Required string length: 1 - 2

Example:

"L1"

stamp_duty_amount

string

For Italian organizations only
Non-Italian organizations should not include this property in the request.
Represents an amount (2.00 EUR) applicable on invoices where VAT is excluded and the invoice has a value exceeding 77.47 EUR.

Required string length: 4 - 15

Example:

"1.00"

discount

object

Global discount applied to the entire invoice. This discount is applied to the sum of all items (after item-level discounts, if any).

Show child attributes

discount.type

enum<string>

Type of the discount. percentage for a rate-based discount or absolute for a fixed amount discount.

Available options:

percentage,

absolute

Example:

"percentage"

discount.value

string

Rate or absolute amount that will be discounted from the invoice total.

For percentage type: Value between 0.0001 (0.01%) and 1 (100%). For example, for a 20% discount, use 0.2 or 0.20.
For absolute type: Fixed amount to be deducted. Decimals should be separated by a period "."

Example:

"0.1"

Response

Returns the client invoice identified by the id path parameter.

client_invoice

object

required

Show child attributes

client_invoice.id

string<uuid>

required

Example:

"4d5418bb-bd0d-4df4-865c-c07afab8bb48"

client_invoice.organization_id

string<uuid>

required

Example:

"4d5418bb-bd0d-4df4-865c-c07afab8bb48"

client_invoice.number

string

required

Example:

"INV001"

client_invoice.purchase_order

string

required

Purchase order data added by the invoice’s initiator.

client_invoice.status

enum<string>

required

Available options:

draft,

unpaid,

paid,

canceled

Example:

"paid"

client_invoice.invoice_url

string<uri>

required

URL of the invoice public page, accessible without authentication for 180 days after issuance, provided the invoice has not been canceled.

Example:

"https://pay.qonto.com/invoices/00000000-0000-0000-0000-000000000000"

client_invoice.contact_email

string<email>

required

E-mail address of the invoice’s initiator.

Example:

"[email protected]"

client_invoice.terms_and_conditions

string

required

The T&C data added by the invoice’s initiator.

Example:

"This is an example."

client_invoice.discount_conditions

string | null

required

Any discount for advance payment of the invoice. It is optional and is only for French organizations.

Example:

"Pas d’escompte accordé pour paiement anticipé."

client_invoice.late_payment_penalties

string | null

required

Late payment penalties applied in case of non-payment invoice. It is optional and is only for French organizations.

Example:

"En cas de non-paiement à la date d'échéance, des pénalités calculées à trois fois le taux d’intérêt légal seront appliquées."

client_invoice.legal_fixed_compensation

string | null

required

The legal fixed compensation applied in case late payment of the invoice. It is optional and is only for French organizations.

Example:

"Tout retard de paiement entraînera une indemnité forfaitaire pour frais de recouvrement de 40€."

client_invoice.header

string

required

The header text added by the credit note’s initiator.

Example:

"This is an example."

client_invoice.footer

string

required

The footer text added by the credit note’s initiator.

Example:

"This is an example."

client_invoice.currency

string

required

Example:

"EUR"

client_invoice.total_amount

object

required

Total amount that needs to be paid by the client.

Show child attributes

client_invoice.total_amount.value

string

Example:

"12.52"

client_invoice.total_amount.currency

string

Example:

"EUR"

client_invoice.total_amount_cents

integer

required

Total amount in cents that needs to be paid by the client.

Example:

1252

client_invoice.vat_amount

object

required

VAT amount that is applicable to the invoice.

Show child attributes

client_invoice.vat_amount.value

string

Example:

"0.51"

client_invoice.vat_amount.currency

string

Example:

"EUR"

client_invoice.vat_amount_cents

integer

required

VAT amount in cents that is applicable to the invoice.

Example:

51

client_invoice.issue_date

string<date>

required

Date the initiator mentioned that the invoice was created.

Example:

"2022-03-01"

client_invoice.due_date

string<date>

required

Payment’s deadline added by the initiator.

Example:

"2022-03-01"

client_invoice.performance_date

string<date>

required

deprecated

DEPRECATED: This field is deprecated. Please use performance_start_date and performance_end_date instead.

The performance date represents when the job or service was completed by the client. Date the initiator mentioned that the contents of the invoice were performed.

Example:

"2022-03-01"

client_invoice.performance_start_date

string<date>

required

Start date of the performance period mentioned by the initiator for the invoice contents.

The performance period defines the date range during which the job or service was completed by the client. This field marks the beginning of that period and can be used together with performance_end_date to create a flexible date range instead of a single fixed date.

Example:

"2022-03-01"

client_invoice.performance_end_date

string<date>

required

End date of the performance period mentioned by the initiator for the invoice contents.

This field defines the end of the performance date range, allowing the work or service to have been completed anytime between performance_start_date and performance_end_date. When used together with performance_start_date, it creates a flexible time window rather than specifying completion on a single specific date.

Example:

"2022-03-31"

client_invoice.created_at

string<date-time>

required

Date the invoice was created. Note that this is a machine date.

Example:

"2022-03-04T17:58:30+02:00"

client_invoice.finalized_at

string<date-time>

required

Date the invoice was transitioned from Draft to Unpaid status.

Example:

"2022-03-04T17:58:30+02:00"

client_invoice.paid_at

string<date-time>

required

Date on which the invoice was paid.

Example:

"2022-03-04T17:58:30+02:00"

client_invoice.stamp_duty_amount

string

required

Required string length: 4 - 15

Example:

"1.00"

client_invoice.items

object[]

required

Show child attributes

client_invoice.items.title

string

Example:

"Plastic tables"

client_invoice.items.description

string

Example:

"Plastic tables for McDonald’s restaurants"

client_invoice.items.quantity

string

Example:

"1.5"

client_invoice.items.unit

string

Example:

"meter"

client_invoice.items.unit_price

object

Amount of the price per unit. Note that an item can contain multiple units. The number of units is defined via quantity.

Show child attributes

client_invoice.items.unit_price.value

string

Example:

"10.0"

client_invoice.items.unit_price.currency

string

Example:

"EUR"

client_invoice.items.unit_price_cents

integer

Amount in cents of the price per unit. Note that an item can contain multiple units. The number of units is defined via quantity.

Example:

1000

client_invoice.items.vat_rate

string

VAT rate in decimal (0.1 for 10%) applicable to that particular item.

Example:

"0.1"

client_invoice.items.vat_exemption_reason

enum<string>

Exemption reason

Available options:

N1,

N2,

N2.1,

N2.2,

N3,

N3.1,

N3.2,

N3.3,

N3.4,

N3.5,

N3.6,

N4,

N5,

N6,

N6.1,

N6.2,

N6.3,

N6.4,

N6.5,

N6.6,

N6.7,

N6.8,

N6.9,

N7,

S293B,

S262.1,

S259,

S283,

S261,

S262,

S263,

S19.1,

S4.1B,

S4.1A,

S4,

S13B,

S122,

S25,

S21,

S69,

S20,

S84.1.2

client_invoice.items.discount

object

Show child attributes

client_invoice.items.discount.type

enum<string>

Available options:

percentage,

absolute

Example:

"percentage"

client_invoice.items.discount.value

string

Discount rate or absolute amount. For percentage, the minimum value is 0.0001 (0.01%), and the maximum value is 1 (100%). For absolute value, the maximum is determined by Quantity * Unit Price.

Example:

"0.1"

client_invoice.items.discount.amount

object

Show child attributes

client_invoice.items.discount.amount.value

string

Example:

"120"

client_invoice.items.discount.amount.currency

string

Example:

"EUR"

client_invoice.items.total_vat

object

VAT amount that is applicable to that specific item.

Show child attributes

client_invoice.items.total_vat.value

string

Example:

"120"

client_invoice.items.total_vat.currency

string

Example:

"EUR"

client_invoice.items.total_vat_cents

integer

VAT amount in cents that is applicable to that specific item.

Example:

12000

client_invoice.items.total_amount

object

Amount that needs to be paid by the client for that specific item.

Show child attributes

client_invoice.items.total_amount.value

string

Example:

"300.50"

client_invoice.items.total_amount.currency

string

Example:

"EUR"

client_invoice.items.total_amount_cents

integer

Amount in cents that needs to be paid by the client for that specific item.

Example:

30050

client_invoice.items.subtotal

object

Show child attributes

client_invoice.items.subtotal.value

string

Subtotal amount for the item without VAT. Quantity * Unit_price.

Example:

"120"

client_invoice.items.subtotal.currency

string

Example:

"EUR"

client_invoice.items.subtotal_cents

integer

Subtotal amount in cents for the item without VAT.

Example:

12000

client_invoice.client

object

required

Client that needs to pay the invoice.

Show child attributes

client_invoice.client.id

string<uuid>

Example:

"33v418bb-bd0d-4df4-865c-c07afab8bb48"

client_invoice.client.name

string

Note that this property will be returned only if the client is a company.

Example:

"McDonald's"

client_invoice.client.first_name

string

Note that this property will be returned only if the client is an individual or a freelancer.

Example:

"Jane"

client_invoice.client.last_name

string

Note that this property will be returned only if the client is an individual or a freelancer.

Example:

"Doe"

client_invoice.client.type

enum<string>

Available options:

individual,

company,

freelancer

Example:

"individual"

client_invoice.client.email

string<email>

Example:

"[email protected]"

client_invoice.client.vat_number

string

Example:

"FR32123456789"

client_invoice.client.tax_identification_number

string

Example:

"123456789"

client_invoice.client.address

string

Example:

"1 place de l’Opéra"

client_invoice.client.city

string

Example:

"Paris"

client_invoice.client.zip_code

string

Example:

"75009"

client_invoice.client.province_code

string

Province code of the client. It is required only for Italian organizations

client_invoice.client.country_code

string

Example:

"fr"

client_invoice.client.recipient_code

string

Recipient code, so that the client can receive the e-invoice in his SdI portal.

client_invoice.client.locale

string

Example:

"fr"

client_invoice.client.billing_address

object

Billing address of the client, which will be reflected on the invoice. Stores the same data as the root-level fields address fields (address, city, zip_code, province_code, country_code). Send either a billing_address object filled-in or individual root-level address fields (address, city, zip_code, province_code, country_code). When both are sent, billing_address takes precedence and overwrites root-level fields.

Show child attributes

client_invoice.client.billing_address.street_address

string

Street address section of the billing address of the client (eg street, number, floor, door, etc).

Maximum string length: 250

Example:

"123 Main Street"

client_invoice.client.billing_address.city

string

City on the billing address of the client

Maximum string length: 50

Example:

"Paris"

client_invoice.client.billing_address.zip_code

string

Zip code on the billing address of the client

Maximum string length: 20

Example:

"75009"

client_invoice.client.billing_address.province_code

string

Province code of the client's billing address. It is required only for Italian organizations.

Maximum string length: 2

client_invoice.client.billing_address.country_code

string

Country code on the billing address of the client (ISO 3166 format)

Maximum string length: 2

Example:

"FR"

client_invoice.client.delivery_address

object

Delivery address of the client. Stores the same data as the root-level fields address fields (address, city, zip_code, province_code, country_code).

Show child attributes

client_invoice.client.delivery_address.street_address

string

Street address section of the delivery address of the client. (eg street, number, floor, door, etc)

Maximum string length: 250

Example:

"123 Main Street"

client_invoice.client.delivery_address.city

string

City on the delivery address of the client

Maximum string length: 50

Example:

"Paris"

client_invoice.client.delivery_address.zip_code

string

Zip code on the delivery address of the client

Maximum string length: 20

Example:

"75009"

client_invoice.client.delivery_address.province_code

string

Province code of the client's delivery address. It is required only for Italian organizations

Maximum string length: 2

client_invoice.client.delivery_address.country_code

string

Country code on the delivery address of the client (ISO 3166 format)

Maximum string length: 2

Example:

"FR"

client_invoice.payment_methods

object[]

required

Show child attributes

client_invoice.payment_methods.beneficiary_name

string

Name of the beneficiary that will receive the invoice's payment.

Example:

"John Doe"

client_invoice.payment_methods.bic

string

Beneficiary’s International Bank Account Number.

Example:

"ABCDEFG1XXX"

client_invoice.payment_methods.iban

string

Beneficiary account's Bank Identifier.

Example:

"FR1420041010050500013M02606"

client_invoice.payment_methods.type

enum<string>

Invoice's payment method.

Available options:

transfer

Example:

"transfer"

client_invoice.credit_notes_ids

string<uuid>[]

required

If any credit notes are linked to the invoice, this represents the id of those credit notes.

client_invoice.organization

object

required

Information of the organization at the time the document was issued.

Show child attributes

client_invoice.organization.id

string<uuid>

client_invoice.organization.legal_name

string

client_invoice.organization.legal_number

string

client_invoice.organization.legal_country

string

client_invoice.organization.address_line_1

string

client_invoice.organization.address_line_2

string

client_invoice.organization.address_zipcode

string

client_invoice.organization.address_city

string

client_invoice.organization.address_country

string

client_invoice.organization.company_leadership

string

Example:

"Jan Mueller"

client_invoice.organization.district_court

string

Example:

"Munich"

client_invoice.organization.commercial_register_number

string

Is available for French and German organizations and is optional.

For French organizations, it represents RCS number (numéro Registre du Commerce et des Sociétés) of an incorporated business. For example: RCS A 123 123 123.
For German organizations, it represents the organization's commercial register number (handelsregisternummer). For example: HRB 123455 B.

Example:

"HRB12345B"

client_invoice.organization.vat_number

string

Example:

"FR123456789"

client_invoice.organization.tax_number

string

Example:

"123/123/1234"

Capital share of an incorporated business. It is optional and is only for French organizations.

Show child attributes

Maximum string length: 12

Example:

"10000.00"

Available options:

AED,

AUD,

BGN,

CAD,

CHF,

CNY,

CZK,

DKK,

EUR,

GBP,

GHS,

HKD,

HUF,

ILS,

MXN,

NOK,

NZD,

PEN,

PLN,

RON,

RSD,

SAR,

SEK,

SGD,

TRY,

USD,

ZAR,

ZMW

Example:

"EUR"

client_invoice.organization.transaction_type

enum<string>

Type of transaction performed in the invoice. It is optional and is only for French organizations.

Available options:

goods,

services,

goods_and_services

Example:

"goods"

client_invoice.organization.vat_payment_condition

enum<string>

Business’ VAT elected payment condition (whether TVA is paid on receipt or on invoice emission). There are two allowed values:

receipt which stands for “sur les encaissements” in French;
compensated_for_sales which stands for “sur les débits” in French. It is optional and is only for French organizations.

Available options:

on_receipts,

compensated_for_sales,

exempt

Example:

"on_receipts"

client_invoice.invoice_type

enum<string>

required

Available options:

standard,

deposit,

balance

Example:

"standard"

client_invoice.attachment_id

string<uuid>

Attachment UUID corresponding to that particular invoice.
When creating the invoice (by calling the POST /v2/client_invoices endpoint), the attachment is generated asynchronously; which means that you have to wait ~10s and then call the GET /v2/client_invoices/{id} endpoint to get the attachment_id.
This property enables you to get the invoice file by using the GET /v2/attachments/{id} endpoint.

Example:

"4d5418bb-bd0d-4df4-865c-c07afab8bb48"

client_invoice.discount

object

Global discount that was applied to the invoice.

Show child attributes

client_invoice.discount.type

enum<string>

Type of the discount applied.

Available options:

percentage,

absolute

Example:

"percentage"

client_invoice.discount.value

string

Rate or absolute amount that was discounted.

Example:

"0.1"

client_invoice.discount.amount

object

The calculated discount amount that was deducted from the invoice.

Show child attributes

client_invoice.discount.amount.value

string

Example:

"10.00"

client_invoice.discount.amount.currency

string

Example:

"EUR"

client_invoice.einvoicing_status

enum<string>

Available options:

pending,

submitted,

declined,

approved,

not_delivered,

submission_failed

client_invoice.welfare_fund

object

Show child attributes

client_invoice.welfare_fund.type

enum<string>

Available options:

TC01,

TC02,

TC03,

TC04,

TC05,

TC06,

TC07,

TC08,

TC09,

TC10,

TC11,

TC12,

TC13,

TC14,

TC15,

TC16,

TC17,

TC18,

TC19,

TC20,

TC21,

TC22

Example:

"TC01"

client_invoice.welfare_fund.rate

string

Required string length: 4 - 6

Example:

"0.0001"

client_invoice.withholding_tax

object

Only applicable for Italian organizations and Spanish freelancers.
Object which relates to an amount of tax paid by the client, rather than the supplier, for specific cases.
This amount is a percentage deducted from the total amount of the invoice after VAT application.
The rate field specifies the percentage of tax and amount field specifies the total amount of the tax.

Show child attributes

client_invoice.withholding_tax.reason

enum<string>

Available options:

RF01,

RF02,

RF03,

RF04,

RF05,

RF06

Example:

"RF01"

client_invoice.withholding_tax.rate

string

Required string length: 4 - 6

Example:

"0.01"

client_invoice.withholding_tax.payment_reason

string

Required string length: 1 - 2

Example:

"L1"

client_invoice.withholding_tax.amount

string

Example:

"1.00"

client_invoice.payment_reporting

object

Show child attributes

client_invoice.payment_reporting.conditions

enum<string>

Available options:

TP01,

TP02,

TP03

Example:

"TP01"

client_invoice.payment_reporting.method

enum<string>

Available options:

MP01,

MP02,

MP03,

MP04,

MP05,

MP06,

MP07,

MP08,

MP09,

MP10,

MP11,

MP12,

MP13,

MP14,

MP15,

MP16,

MP17,

MP18,

MP19,

MP20,

MP21,

MP22

Example:

"MP01"

client_invoice.einvoicing_lifecycle_events

object[]

Array of lifecycle events related to the e-invoicing process

Show child attributes

client_invoice.einvoicing_lifecycle_events.status_code

enum<integer>

Status code of the operation. - 200: Déposée (Submitted) - 201: Emise par la plateforme (Issued by the platform) - 202: Reçue de la plateforme (Received from the platform) - 203: Mise à disposition (Made available) - 204: Prise en charge (Taken over) - 205: Approuvée (Approved) - 206: Approuvée partiellement (Partially approved) - 207: En litige (In dispute) - 208: Suspendue (Suspended) - 209: Complétée (Completed) - 210: Refusée (Refused) - 211: Paiement transmis (Payment sent) - 212: Encaissée (Collected) - 213: Rejetée (Rejected) - 214: Visée (Vised)

Available options:

200,

201,

202,

203,

204,

205,

206,

207,

208,

209,

210,

211,

212,

213,

214

Example:

200

client_invoice.einvoicing_lifecycle_events.reason

string

The reason label associated with a given event

Example:

"DOUBLE FACTURE"

client_invoice.einvoicing_lifecycle_events.reason_message

string

The reason message associated with a given event (comment provided by the user generating the event)

Example:

"I already received this invoice"

client_invoice.einvoicing_lifecycle_events.timestamp

string<date-time>

The timestamp of the event

Example:

"2024-12-04T11:05:16.4497Z"

Business API

Onboarding API

Update a draft client invoice

Authorizations

Headers

Path Parameters

Body

Response