Authorizations
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
Required only for Sandbox API requests; to get one, please sign up to the Developer Portal.
Body
"2022-03-01"
Payment deadline that is added by the initiator. The format should be YYYY-MM-DD
Currency for the total amount of the invoice. Currently, only value allowed is EUR. Trigram following ISO 4217
"EUR"
Payment method details for the invoice.
DEPRECATED: This field is deprecated. Please use performance_start_date
and performance_end_date
instead.
The performance date represents when the job or service is expected to be completed by the client. Date the initiator has issued or shared the invoice as legally viable. The format should be YYYY-MM-DD
Start date of the performance period for the invoice. The format should be YYYY-MM-DD
.
The performance period defines the date range during which the job or service is expected to be 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.
Validation rules:
- Required if
performance_end_date
is provided - Must be less than or equal to
performance_end_date
when both are provided
Fallback behavior:
- If not provided, the system will use the deprecated
performance_date
value as fallback - If provided, this value will override the deprecated
performance_date
field
"2022-03-01"
End date of the performance period for the invoice. The format should be YYYY-MM-DD
.
This field defines the end of the performance date range, allowing clients to complete the job or service anytime between performance_start_date
and performance_end_date
. When used together with performance_start_date
, it creates a flexible time window rather than requiring completion on a specific date.
Validation rules:
- Optional field
- When provided,
performance_start_date
becomes required - Must be greater than or equal to
performance_start_date
"2022-03-31"
Invoice's status. If not filled, unpaid
will be automatically propertyd to the invoice.
draft
, unpaid
Invoice's number. Must be unique within the organization and is:
- required if automatic numbering is disabled for the authenticated organization (default setting);
- optional if automatic numbering is enabled for the authenticated organization. However, if provided, it will be used as the invoice's number.
40
"INV-2023-001"
Purchase order data added by the invoice’s initiator.
40
Additional notes added by the invoice’s initiator.
525
"This is an example."
"This is an example."
This collection of propertys can be optionally used to temporarily override some of the organization's properties for this one invoice.
- 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 propertyeinvoicing_status
.
- 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.
- 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.
- 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.
- 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.
4 - 15
"1.00"
Response
Returns the client invoice created.