Update a draft client invoice
curl --request PATCH \
--url https://thirdparty.qonto.com/v2/client_invoices/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data @- <<EOF
{
"client_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"upload_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
"issue_date": "2022-03-01",
"performance_date": "2023-12-25",
"performance_start_date": "2022-03-01",
"performance_end_date": "2022-03-31",
"due_date": "2023-12-25",
"number": "INV-2023-001",
"purchase_order": "<string>",
"terms_and_conditions": "<string>",
"header": "This is an example.",
"footer": "This is an example.",
"settings": {
"vat_number": "FR12345678",
"company_leadership": "Jan Mueller",
"district_court": "Munich",
"commercial_register_number": "HRB12345B",
"tax_number": "123/123/1234",
"legal_capital_share": {
"value": "10000.00",
"currency": "EUR"
},
"transaction_type": "goods",
"vat_payment_condition": "on_receipts",
"discount_conditions": "Pas d’escompte accordé pour paiement anticipé.",
"late_payment_penalties": "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.",
"legal_fixed_compensation": "Tout retard de paiement entraînera une indemnité forfaitaire pour frais de recouvrement de 40€."
},
"items": [
{
"title": "<string>",
"quantity": "0.5",
"unit_price": {
"value": "<string>",
"currency": "<string>"
},
"vat_rate": "0.1",
"description": "<string>",
"unit": "meter",
"vat_exemption_reason": "N1",
"discount": {
"type": "percentage",
"value": "0.1"
}
}
],
"report_einvoicing": true,
"stamp_duty_amount": "1.00",
"discount": {
"type": "percentage",
"value": "0.1"
}
}
EOFimport requests
url = "https://thirdparty.qonto.com/v2/client_invoices/{id}"
payload = {
"client_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"upload_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
"issue_date": "2022-03-01",
"performance_date": "2023-12-25",
"performance_start_date": "2022-03-01",
"performance_end_date": "2022-03-31",
"due_date": "2023-12-25",
"number": "INV-2023-001",
"purchase_order": "<string>",
"terms_and_conditions": "<string>",
"header": "This is an example.",
"footer": "This is an example.",
"settings": {
"vat_number": "FR12345678",
"company_leadership": "Jan Mueller",
"district_court": "Munich",
"commercial_register_number": "HRB12345B",
"tax_number": "123/123/1234",
"legal_capital_share": {
"value": "10000.00",
"currency": "EUR"
},
"transaction_type": "goods",
"vat_payment_condition": "on_receipts",
"discount_conditions": "Pas d’escompte accordé pour paiement anticipé.",
"late_payment_penalties": "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.",
"legal_fixed_compensation": "Tout retard de paiement entraînera une indemnité forfaitaire pour frais de recouvrement de 40€."
},
"items": [
{
"title": "<string>",
"quantity": "0.5",
"unit_price": {
"value": "<string>",
"currency": "<string>"
},
"vat_rate": "0.1",
"description": "<string>",
"unit": "meter",
"vat_exemption_reason": "N1",
"discount": {
"type": "percentage",
"value": "0.1"
}
}
],
"report_einvoicing": True,
"stamp_duty_amount": "1.00",
"discount": {
"type": "percentage",
"value": "0.1"
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
client_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
upload_id: '4d5418bb-bd0d-4df4-865c-c07afab8bb48',
issue_date: '2022-03-01',
performance_date: '2023-12-25',
performance_start_date: '2022-03-01',
performance_end_date: '2022-03-31',
due_date: '2023-12-25',
number: 'INV-2023-001',
purchase_order: '<string>',
terms_and_conditions: '<string>',
header: 'This is an example.',
footer: 'This is an example.',
settings: {
vat_number: 'FR12345678',
company_leadership: 'Jan Mueller',
district_court: 'Munich',
commercial_register_number: 'HRB12345B',
tax_number: '123/123/1234',
legal_capital_share: {value: '10000.00', currency: 'EUR'},
transaction_type: 'goods',
vat_payment_condition: 'on_receipts',
discount_conditions: 'Pas d’escompte accordé pour paiement anticipé.',
late_payment_penalties: '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.',
legal_fixed_compensation: 'Tout retard de paiement entraînera une indemnité forfaitaire pour frais de recouvrement de 40€.'
},
items: [
{
title: '<string>',
quantity: '0.5',
unit_price: {value: '<string>', currency: '<string>'},
vat_rate: '0.1',
description: '<string>',
unit: 'meter',
vat_exemption_reason: 'N1',
discount: {type: 'percentage', value: '0.1'}
}
],
report_einvoicing: true,
stamp_duty_amount: '1.00',
discount: {type: 'percentage', value: '0.1'}
})
};
fetch('https://thirdparty.qonto.com/v2/client_invoices/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://thirdparty.qonto.com/v2/client_invoices/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'client_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'upload_id' => '4d5418bb-bd0d-4df4-865c-c07afab8bb48',
'issue_date' => '2022-03-01',
'performance_date' => '2023-12-25',
'performance_start_date' => '2022-03-01',
'performance_end_date' => '2022-03-31',
'due_date' => '2023-12-25',
'number' => 'INV-2023-001',
'purchase_order' => '<string>',
'terms_and_conditions' => '<string>',
'header' => 'This is an example.',
'footer' => 'This is an example.',
'settings' => [
'vat_number' => 'FR12345678',
'company_leadership' => 'Jan Mueller',
'district_court' => 'Munich',
'commercial_register_number' => 'HRB12345B',
'tax_number' => '123/123/1234',
'legal_capital_share' => [
'value' => '10000.00',
'currency' => 'EUR'
],
'transaction_type' => 'goods',
'vat_payment_condition' => 'on_receipts',
'discount_conditions' => 'Pas d’escompte accordé pour paiement anticipé.',
'late_payment_penalties' => '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.',
'legal_fixed_compensation' => 'Tout retard de paiement entraînera une indemnité forfaitaire pour frais de recouvrement de 40€.'
],
'items' => [
[
'title' => '<string>',
'quantity' => '0.5',
'unit_price' => [
'value' => '<string>',
'currency' => '<string>'
],
'vat_rate' => '0.1',
'description' => '<string>',
'unit' => 'meter',
'vat_exemption_reason' => 'N1',
'discount' => [
'type' => 'percentage',
'value' => '0.1'
]
]
],
'report_einvoicing' => true,
'stamp_duty_amount' => '1.00',
'discount' => [
'type' => 'percentage',
'value' => '0.1'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://thirdparty.qonto.com/v2/client_invoices/{id}"
payload := strings.NewReader("{\n \"client_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"upload_id\": \"4d5418bb-bd0d-4df4-865c-c07afab8bb48\",\n \"issue_date\": \"2022-03-01\",\n \"performance_date\": \"2023-12-25\",\n \"performance_start_date\": \"2022-03-01\",\n \"performance_end_date\": \"2022-03-31\",\n \"due_date\": \"2023-12-25\",\n \"number\": \"INV-2023-001\",\n \"purchase_order\": \"<string>\",\n \"terms_and_conditions\": \"<string>\",\n \"header\": \"This is an example.\",\n \"footer\": \"This is an example.\",\n \"settings\": {\n \"vat_number\": \"FR12345678\",\n \"company_leadership\": \"Jan Mueller\",\n \"district_court\": \"Munich\",\n \"commercial_register_number\": \"HRB12345B\",\n \"tax_number\": \"123/123/1234\",\n \"legal_capital_share\": {\n \"value\": \"10000.00\",\n \"currency\": \"EUR\"\n },\n \"transaction_type\": \"goods\",\n \"vat_payment_condition\": \"on_receipts\",\n \"discount_conditions\": \"Pas d’escompte accordé pour paiement anticipé.\",\n \"late_payment_penalties\": \"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.\",\n \"legal_fixed_compensation\": \"Tout retard de paiement entraînera une indemnité forfaitaire pour frais de recouvrement de 40€.\"\n },\n \"items\": [\n {\n \"title\": \"<string>\",\n \"quantity\": \"0.5\",\n \"unit_price\": {\n \"value\": \"<string>\",\n \"currency\": \"<string>\"\n },\n \"vat_rate\": \"0.1\",\n \"description\": \"<string>\",\n \"unit\": \"meter\",\n \"vat_exemption_reason\": \"N1\",\n \"discount\": {\n \"type\": \"percentage\",\n \"value\": \"0.1\"\n }\n }\n ],\n \"report_einvoicing\": true,\n \"stamp_duty_amount\": \"1.00\",\n \"discount\": {\n \"type\": \"percentage\",\n \"value\": \"0.1\"\n }\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://thirdparty.qonto.com/v2/client_invoices/{id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"client_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"upload_id\": \"4d5418bb-bd0d-4df4-865c-c07afab8bb48\",\n \"issue_date\": \"2022-03-01\",\n \"performance_date\": \"2023-12-25\",\n \"performance_start_date\": \"2022-03-01\",\n \"performance_end_date\": \"2022-03-31\",\n \"due_date\": \"2023-12-25\",\n \"number\": \"INV-2023-001\",\n \"purchase_order\": \"<string>\",\n \"terms_and_conditions\": \"<string>\",\n \"header\": \"This is an example.\",\n \"footer\": \"This is an example.\",\n \"settings\": {\n \"vat_number\": \"FR12345678\",\n \"company_leadership\": \"Jan Mueller\",\n \"district_court\": \"Munich\",\n \"commercial_register_number\": \"HRB12345B\",\n \"tax_number\": \"123/123/1234\",\n \"legal_capital_share\": {\n \"value\": \"10000.00\",\n \"currency\": \"EUR\"\n },\n \"transaction_type\": \"goods\",\n \"vat_payment_condition\": \"on_receipts\",\n \"discount_conditions\": \"Pas d’escompte accordé pour paiement anticipé.\",\n \"late_payment_penalties\": \"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.\",\n \"legal_fixed_compensation\": \"Tout retard de paiement entraînera une indemnité forfaitaire pour frais de recouvrement de 40€.\"\n },\n \"items\": [\n {\n \"title\": \"<string>\",\n \"quantity\": \"0.5\",\n \"unit_price\": {\n \"value\": \"<string>\",\n \"currency\": \"<string>\"\n },\n \"vat_rate\": \"0.1\",\n \"description\": \"<string>\",\n \"unit\": \"meter\",\n \"vat_exemption_reason\": \"N1\",\n \"discount\": {\n \"type\": \"percentage\",\n \"value\": \"0.1\"\n }\n }\n ],\n \"report_einvoicing\": true,\n \"stamp_duty_amount\": \"1.00\",\n \"discount\": {\n \"type\": \"percentage\",\n \"value\": \"0.1\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://thirdparty.qonto.com/v2/client_invoices/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"client_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"upload_id\": \"4d5418bb-bd0d-4df4-865c-c07afab8bb48\",\n \"issue_date\": \"2022-03-01\",\n \"performance_date\": \"2023-12-25\",\n \"performance_start_date\": \"2022-03-01\",\n \"performance_end_date\": \"2022-03-31\",\n \"due_date\": \"2023-12-25\",\n \"number\": \"INV-2023-001\",\n \"purchase_order\": \"<string>\",\n \"terms_and_conditions\": \"<string>\",\n \"header\": \"This is an example.\",\n \"footer\": \"This is an example.\",\n \"settings\": {\n \"vat_number\": \"FR12345678\",\n \"company_leadership\": \"Jan Mueller\",\n \"district_court\": \"Munich\",\n \"commercial_register_number\": \"HRB12345B\",\n \"tax_number\": \"123/123/1234\",\n \"legal_capital_share\": {\n \"value\": \"10000.00\",\n \"currency\": \"EUR\"\n },\n \"transaction_type\": \"goods\",\n \"vat_payment_condition\": \"on_receipts\",\n \"discount_conditions\": \"Pas d’escompte accordé pour paiement anticipé.\",\n \"late_payment_penalties\": \"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.\",\n \"legal_fixed_compensation\": \"Tout retard de paiement entraînera une indemnité forfaitaire pour frais de recouvrement de 40€.\"\n },\n \"items\": [\n {\n \"title\": \"<string>\",\n \"quantity\": \"0.5\",\n \"unit_price\": {\n \"value\": \"<string>\",\n \"currency\": \"<string>\"\n },\n \"vat_rate\": \"0.1\",\n \"description\": \"<string>\",\n \"unit\": \"meter\",\n \"vat_exemption_reason\": \"N1\",\n \"discount\": {\n \"type\": \"percentage\",\n \"value\": \"0.1\"\n }\n }\n ],\n \"report_einvoicing\": true,\n \"stamp_duty_amount\": \"1.00\",\n \"discount\": {\n \"type\": \"percentage\",\n \"value\": \"0.1\"\n }\n}"
response = http.request(request)
puts response.read_body{
"client_invoice": {
"id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
"organization_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
"number": "INV001",
"purchase_order": "<string>",
"status": "paid",
"invoice_url": "https://pay.qonto.com/invoices/00000000-0000-0000-0000-000000000000",
"contact_email": "contact@qonto.com",
"terms_and_conditions": "This is an example.",
"discount_conditions": "Pas d’escompte accordé pour paiement anticipé.",
"late_payment_penalties": "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.",
"legal_fixed_compensation": "Tout retard de paiement entraînera une indemnité forfaitaire pour frais de recouvrement de 40€.",
"header": "This is an example.",
"footer": "This is an example.",
"currency": "EUR",
"total_amount": {
"value": "12.52",
"currency": "EUR"
},
"total_amount_cents": 1252,
"vat_amount": {
"value": "0.51",
"currency": "EUR"
},
"vat_amount_cents": 51,
"issue_date": "2022-03-01",
"due_date": "2022-03-01",
"performance_date": "2022-03-01",
"performance_start_date": "2022-03-01",
"performance_end_date": "2022-03-31",
"created_at": "2022-03-04T17:58:30+02:00",
"finalized_at": "2022-03-04T17:58:30+02:00",
"paid_at": "2022-03-04T17:58:30+02:00",
"stamp_duty_amount": "1.00",
"items": [
{
"title": "Plastic tables",
"description": "Plastic tables for McDonald’s restaurants",
"quantity": "1.5",
"unit": "meter",
"unit_price": {
"value": "10.0",
"currency": "EUR"
},
"unit_price_cents": 1000,
"vat_rate": "0.1",
"vat_exemption_reason": "N1",
"discount": {
"type": "percentage",
"value": "0.1",
"amount": {
"value": "120",
"currency": "EUR"
}
},
"total_vat": {
"value": "120",
"currency": "EUR"
},
"total_vat_cents": 12000,
"total_amount": {
"value": "300.50",
"currency": "EUR"
},
"total_amount_cents": 30050,
"subtotal": {
"value": "120",
"currency": "EUR"
},
"subtotal_cents": 12000
}
],
"client": {
"id": "33v418bb-bd0d-4df4-865c-c07afab8bb48",
"name": "McDonald's",
"first_name": "Jane",
"last_name": "Doe",
"type": "individual",
"email": "client@qonto.com",
"vat_number": "FR32123456789",
"tax_identification_number": "123456789",
"address": "1 place de l’Opéra",
"city": "Paris",
"zip_code": "75010",
"province_code": "<string>",
"country_code": "fr",
"recipient_code": "<string>",
"locale": "fr",
"billing_address": {
"street_address": "123 Main Street",
"city": "Paris",
"zip_code": "75010",
"province_code": "<string>",
"country_code": "FR"
},
"delivery_address": {
"street_address": "123 Main Street",
"city": "Paris",
"zip_code": "75010",
"province_code": "<string>",
"country_code": "FR"
}
},
"payment_methods": [
{
"beneficiary_name": "John Doe",
"bic": "ABCDEFG1XXX",
"iban": "FR1420041010050500013M02606",
"type": "transfer"
}
],
"credit_notes_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"organization": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"legal_name": "<string>",
"legal_number": "<string>",
"legal_country": "<string>",
"address_line_1": "<string>",
"address_line_2": "<string>",
"address_zipcode": "<string>",
"address_city": "<string>",
"address_country": "<string>",
"company_leadership": "Jan Mueller",
"district_court": "Munich",
"commercial_register_number": "HRB12345B",
"vat_number": "FR123456789",
"tax_number": "123/123/1234",
"legal_capital_share": {
"value": "10000.00",
"currency": "EUR"
},
"transaction_type": "goods",
"vat_payment_condition": "on_receipts"
},
"invoice_type": "standard",
"attachment_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
"discount": {
"type": "percentage",
"value": "0.1",
"amount": {
"value": "10.00",
"currency": "EUR"
}
},
"amount_paid": {
"value": "12.52",
"currency": "EUR"
},
"einvoicing_status": "pending",
"welfare_fund": {
"type": "TC01",
"rate": "0.0001"
},
"withholding_tax": {
"reason": "RF01",
"rate": "0.01",
"payment_reason": "L1",
"amount": "1.00"
},
"payment_reporting": {
"conditions": "TP01",
"method": "MP01"
},
"quote_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
"einvoicing_lifecycle_events": [
{
"status_code": 200,
"reason": "DOUBLE FACTURE",
"reason_message": "I already received this invoice",
"timestamp": "2024-12-04T11:05:16.4497Z"
}
]
}
}Client invoices
Update a draft client invoice
Updates the draft client invoice identified by the id path parameter.
PATCH
/
v2
/
client_invoices
/
{id}
Update a draft client invoice
curl --request PATCH \
--url https://thirdparty.qonto.com/v2/client_invoices/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data @- <<EOF
{
"client_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"upload_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
"issue_date": "2022-03-01",
"performance_date": "2023-12-25",
"performance_start_date": "2022-03-01",
"performance_end_date": "2022-03-31",
"due_date": "2023-12-25",
"number": "INV-2023-001",
"purchase_order": "<string>",
"terms_and_conditions": "<string>",
"header": "This is an example.",
"footer": "This is an example.",
"settings": {
"vat_number": "FR12345678",
"company_leadership": "Jan Mueller",
"district_court": "Munich",
"commercial_register_number": "HRB12345B",
"tax_number": "123/123/1234",
"legal_capital_share": {
"value": "10000.00",
"currency": "EUR"
},
"transaction_type": "goods",
"vat_payment_condition": "on_receipts",
"discount_conditions": "Pas d’escompte accordé pour paiement anticipé.",
"late_payment_penalties": "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.",
"legal_fixed_compensation": "Tout retard de paiement entraînera une indemnité forfaitaire pour frais de recouvrement de 40€."
},
"items": [
{
"title": "<string>",
"quantity": "0.5",
"unit_price": {
"value": "<string>",
"currency": "<string>"
},
"vat_rate": "0.1",
"description": "<string>",
"unit": "meter",
"vat_exemption_reason": "N1",
"discount": {
"type": "percentage",
"value": "0.1"
}
}
],
"report_einvoicing": true,
"stamp_duty_amount": "1.00",
"discount": {
"type": "percentage",
"value": "0.1"
}
}
EOFimport requests
url = "https://thirdparty.qonto.com/v2/client_invoices/{id}"
payload = {
"client_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"upload_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
"issue_date": "2022-03-01",
"performance_date": "2023-12-25",
"performance_start_date": "2022-03-01",
"performance_end_date": "2022-03-31",
"due_date": "2023-12-25",
"number": "INV-2023-001",
"purchase_order": "<string>",
"terms_and_conditions": "<string>",
"header": "This is an example.",
"footer": "This is an example.",
"settings": {
"vat_number": "FR12345678",
"company_leadership": "Jan Mueller",
"district_court": "Munich",
"commercial_register_number": "HRB12345B",
"tax_number": "123/123/1234",
"legal_capital_share": {
"value": "10000.00",
"currency": "EUR"
},
"transaction_type": "goods",
"vat_payment_condition": "on_receipts",
"discount_conditions": "Pas d’escompte accordé pour paiement anticipé.",
"late_payment_penalties": "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.",
"legal_fixed_compensation": "Tout retard de paiement entraînera une indemnité forfaitaire pour frais de recouvrement de 40€."
},
"items": [
{
"title": "<string>",
"quantity": "0.5",
"unit_price": {
"value": "<string>",
"currency": "<string>"
},
"vat_rate": "0.1",
"description": "<string>",
"unit": "meter",
"vat_exemption_reason": "N1",
"discount": {
"type": "percentage",
"value": "0.1"
}
}
],
"report_einvoicing": True,
"stamp_duty_amount": "1.00",
"discount": {
"type": "percentage",
"value": "0.1"
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
client_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
upload_id: '4d5418bb-bd0d-4df4-865c-c07afab8bb48',
issue_date: '2022-03-01',
performance_date: '2023-12-25',
performance_start_date: '2022-03-01',
performance_end_date: '2022-03-31',
due_date: '2023-12-25',
number: 'INV-2023-001',
purchase_order: '<string>',
terms_and_conditions: '<string>',
header: 'This is an example.',
footer: 'This is an example.',
settings: {
vat_number: 'FR12345678',
company_leadership: 'Jan Mueller',
district_court: 'Munich',
commercial_register_number: 'HRB12345B',
tax_number: '123/123/1234',
legal_capital_share: {value: '10000.00', currency: 'EUR'},
transaction_type: 'goods',
vat_payment_condition: 'on_receipts',
discount_conditions: 'Pas d’escompte accordé pour paiement anticipé.',
late_payment_penalties: '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.',
legal_fixed_compensation: 'Tout retard de paiement entraînera une indemnité forfaitaire pour frais de recouvrement de 40€.'
},
items: [
{
title: '<string>',
quantity: '0.5',
unit_price: {value: '<string>', currency: '<string>'},
vat_rate: '0.1',
description: '<string>',
unit: 'meter',
vat_exemption_reason: 'N1',
discount: {type: 'percentage', value: '0.1'}
}
],
report_einvoicing: true,
stamp_duty_amount: '1.00',
discount: {type: 'percentage', value: '0.1'}
})
};
fetch('https://thirdparty.qonto.com/v2/client_invoices/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://thirdparty.qonto.com/v2/client_invoices/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'client_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'upload_id' => '4d5418bb-bd0d-4df4-865c-c07afab8bb48',
'issue_date' => '2022-03-01',
'performance_date' => '2023-12-25',
'performance_start_date' => '2022-03-01',
'performance_end_date' => '2022-03-31',
'due_date' => '2023-12-25',
'number' => 'INV-2023-001',
'purchase_order' => '<string>',
'terms_and_conditions' => '<string>',
'header' => 'This is an example.',
'footer' => 'This is an example.',
'settings' => [
'vat_number' => 'FR12345678',
'company_leadership' => 'Jan Mueller',
'district_court' => 'Munich',
'commercial_register_number' => 'HRB12345B',
'tax_number' => '123/123/1234',
'legal_capital_share' => [
'value' => '10000.00',
'currency' => 'EUR'
],
'transaction_type' => 'goods',
'vat_payment_condition' => 'on_receipts',
'discount_conditions' => 'Pas d’escompte accordé pour paiement anticipé.',
'late_payment_penalties' => '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.',
'legal_fixed_compensation' => 'Tout retard de paiement entraînera une indemnité forfaitaire pour frais de recouvrement de 40€.'
],
'items' => [
[
'title' => '<string>',
'quantity' => '0.5',
'unit_price' => [
'value' => '<string>',
'currency' => '<string>'
],
'vat_rate' => '0.1',
'description' => '<string>',
'unit' => 'meter',
'vat_exemption_reason' => 'N1',
'discount' => [
'type' => 'percentage',
'value' => '0.1'
]
]
],
'report_einvoicing' => true,
'stamp_duty_amount' => '1.00',
'discount' => [
'type' => 'percentage',
'value' => '0.1'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://thirdparty.qonto.com/v2/client_invoices/{id}"
payload := strings.NewReader("{\n \"client_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"upload_id\": \"4d5418bb-bd0d-4df4-865c-c07afab8bb48\",\n \"issue_date\": \"2022-03-01\",\n \"performance_date\": \"2023-12-25\",\n \"performance_start_date\": \"2022-03-01\",\n \"performance_end_date\": \"2022-03-31\",\n \"due_date\": \"2023-12-25\",\n \"number\": \"INV-2023-001\",\n \"purchase_order\": \"<string>\",\n \"terms_and_conditions\": \"<string>\",\n \"header\": \"This is an example.\",\n \"footer\": \"This is an example.\",\n \"settings\": {\n \"vat_number\": \"FR12345678\",\n \"company_leadership\": \"Jan Mueller\",\n \"district_court\": \"Munich\",\n \"commercial_register_number\": \"HRB12345B\",\n \"tax_number\": \"123/123/1234\",\n \"legal_capital_share\": {\n \"value\": \"10000.00\",\n \"currency\": \"EUR\"\n },\n \"transaction_type\": \"goods\",\n \"vat_payment_condition\": \"on_receipts\",\n \"discount_conditions\": \"Pas d’escompte accordé pour paiement anticipé.\",\n \"late_payment_penalties\": \"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.\",\n \"legal_fixed_compensation\": \"Tout retard de paiement entraînera une indemnité forfaitaire pour frais de recouvrement de 40€.\"\n },\n \"items\": [\n {\n \"title\": \"<string>\",\n \"quantity\": \"0.5\",\n \"unit_price\": {\n \"value\": \"<string>\",\n \"currency\": \"<string>\"\n },\n \"vat_rate\": \"0.1\",\n \"description\": \"<string>\",\n \"unit\": \"meter\",\n \"vat_exemption_reason\": \"N1\",\n \"discount\": {\n \"type\": \"percentage\",\n \"value\": \"0.1\"\n }\n }\n ],\n \"report_einvoicing\": true,\n \"stamp_duty_amount\": \"1.00\",\n \"discount\": {\n \"type\": \"percentage\",\n \"value\": \"0.1\"\n }\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://thirdparty.qonto.com/v2/client_invoices/{id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"client_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"upload_id\": \"4d5418bb-bd0d-4df4-865c-c07afab8bb48\",\n \"issue_date\": \"2022-03-01\",\n \"performance_date\": \"2023-12-25\",\n \"performance_start_date\": \"2022-03-01\",\n \"performance_end_date\": \"2022-03-31\",\n \"due_date\": \"2023-12-25\",\n \"number\": \"INV-2023-001\",\n \"purchase_order\": \"<string>\",\n \"terms_and_conditions\": \"<string>\",\n \"header\": \"This is an example.\",\n \"footer\": \"This is an example.\",\n \"settings\": {\n \"vat_number\": \"FR12345678\",\n \"company_leadership\": \"Jan Mueller\",\n \"district_court\": \"Munich\",\n \"commercial_register_number\": \"HRB12345B\",\n \"tax_number\": \"123/123/1234\",\n \"legal_capital_share\": {\n \"value\": \"10000.00\",\n \"currency\": \"EUR\"\n },\n \"transaction_type\": \"goods\",\n \"vat_payment_condition\": \"on_receipts\",\n \"discount_conditions\": \"Pas d’escompte accordé pour paiement anticipé.\",\n \"late_payment_penalties\": \"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.\",\n \"legal_fixed_compensation\": \"Tout retard de paiement entraînera une indemnité forfaitaire pour frais de recouvrement de 40€.\"\n },\n \"items\": [\n {\n \"title\": \"<string>\",\n \"quantity\": \"0.5\",\n \"unit_price\": {\n \"value\": \"<string>\",\n \"currency\": \"<string>\"\n },\n \"vat_rate\": \"0.1\",\n \"description\": \"<string>\",\n \"unit\": \"meter\",\n \"vat_exemption_reason\": \"N1\",\n \"discount\": {\n \"type\": \"percentage\",\n \"value\": \"0.1\"\n }\n }\n ],\n \"report_einvoicing\": true,\n \"stamp_duty_amount\": \"1.00\",\n \"discount\": {\n \"type\": \"percentage\",\n \"value\": \"0.1\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://thirdparty.qonto.com/v2/client_invoices/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"client_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"upload_id\": \"4d5418bb-bd0d-4df4-865c-c07afab8bb48\",\n \"issue_date\": \"2022-03-01\",\n \"performance_date\": \"2023-12-25\",\n \"performance_start_date\": \"2022-03-01\",\n \"performance_end_date\": \"2022-03-31\",\n \"due_date\": \"2023-12-25\",\n \"number\": \"INV-2023-001\",\n \"purchase_order\": \"<string>\",\n \"terms_and_conditions\": \"<string>\",\n \"header\": \"This is an example.\",\n \"footer\": \"This is an example.\",\n \"settings\": {\n \"vat_number\": \"FR12345678\",\n \"company_leadership\": \"Jan Mueller\",\n \"district_court\": \"Munich\",\n \"commercial_register_number\": \"HRB12345B\",\n \"tax_number\": \"123/123/1234\",\n \"legal_capital_share\": {\n \"value\": \"10000.00\",\n \"currency\": \"EUR\"\n },\n \"transaction_type\": \"goods\",\n \"vat_payment_condition\": \"on_receipts\",\n \"discount_conditions\": \"Pas d’escompte accordé pour paiement anticipé.\",\n \"late_payment_penalties\": \"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.\",\n \"legal_fixed_compensation\": \"Tout retard de paiement entraînera une indemnité forfaitaire pour frais de recouvrement de 40€.\"\n },\n \"items\": [\n {\n \"title\": \"<string>\",\n \"quantity\": \"0.5\",\n \"unit_price\": {\n \"value\": \"<string>\",\n \"currency\": \"<string>\"\n },\n \"vat_rate\": \"0.1\",\n \"description\": \"<string>\",\n \"unit\": \"meter\",\n \"vat_exemption_reason\": \"N1\",\n \"discount\": {\n \"type\": \"percentage\",\n \"value\": \"0.1\"\n }\n }\n ],\n \"report_einvoicing\": true,\n \"stamp_duty_amount\": \"1.00\",\n \"discount\": {\n \"type\": \"percentage\",\n \"value\": \"0.1\"\n }\n}"
response = http.request(request)
puts response.read_body{
"client_invoice": {
"id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
"organization_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
"number": "INV001",
"purchase_order": "<string>",
"status": "paid",
"invoice_url": "https://pay.qonto.com/invoices/00000000-0000-0000-0000-000000000000",
"contact_email": "contact@qonto.com",
"terms_and_conditions": "This is an example.",
"discount_conditions": "Pas d’escompte accordé pour paiement anticipé.",
"late_payment_penalties": "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.",
"legal_fixed_compensation": "Tout retard de paiement entraînera une indemnité forfaitaire pour frais de recouvrement de 40€.",
"header": "This is an example.",
"footer": "This is an example.",
"currency": "EUR",
"total_amount": {
"value": "12.52",
"currency": "EUR"
},
"total_amount_cents": 1252,
"vat_amount": {
"value": "0.51",
"currency": "EUR"
},
"vat_amount_cents": 51,
"issue_date": "2022-03-01",
"due_date": "2022-03-01",
"performance_date": "2022-03-01",
"performance_start_date": "2022-03-01",
"performance_end_date": "2022-03-31",
"created_at": "2022-03-04T17:58:30+02:00",
"finalized_at": "2022-03-04T17:58:30+02:00",
"paid_at": "2022-03-04T17:58:30+02:00",
"stamp_duty_amount": "1.00",
"items": [
{
"title": "Plastic tables",
"description": "Plastic tables for McDonald’s restaurants",
"quantity": "1.5",
"unit": "meter",
"unit_price": {
"value": "10.0",
"currency": "EUR"
},
"unit_price_cents": 1000,
"vat_rate": "0.1",
"vat_exemption_reason": "N1",
"discount": {
"type": "percentage",
"value": "0.1",
"amount": {
"value": "120",
"currency": "EUR"
}
},
"total_vat": {
"value": "120",
"currency": "EUR"
},
"total_vat_cents": 12000,
"total_amount": {
"value": "300.50",
"currency": "EUR"
},
"total_amount_cents": 30050,
"subtotal": {
"value": "120",
"currency": "EUR"
},
"subtotal_cents": 12000
}
],
"client": {
"id": "33v418bb-bd0d-4df4-865c-c07afab8bb48",
"name": "McDonald's",
"first_name": "Jane",
"last_name": "Doe",
"type": "individual",
"email": "client@qonto.com",
"vat_number": "FR32123456789",
"tax_identification_number": "123456789",
"address": "1 place de l’Opéra",
"city": "Paris",
"zip_code": "75010",
"province_code": "<string>",
"country_code": "fr",
"recipient_code": "<string>",
"locale": "fr",
"billing_address": {
"street_address": "123 Main Street",
"city": "Paris",
"zip_code": "75010",
"province_code": "<string>",
"country_code": "FR"
},
"delivery_address": {
"street_address": "123 Main Street",
"city": "Paris",
"zip_code": "75010",
"province_code": "<string>",
"country_code": "FR"
}
},
"payment_methods": [
{
"beneficiary_name": "John Doe",
"bic": "ABCDEFG1XXX",
"iban": "FR1420041010050500013M02606",
"type": "transfer"
}
],
"credit_notes_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"organization": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"legal_name": "<string>",
"legal_number": "<string>",
"legal_country": "<string>",
"address_line_1": "<string>",
"address_line_2": "<string>",
"address_zipcode": "<string>",
"address_city": "<string>",
"address_country": "<string>",
"company_leadership": "Jan Mueller",
"district_court": "Munich",
"commercial_register_number": "HRB12345B",
"vat_number": "FR123456789",
"tax_number": "123/123/1234",
"legal_capital_share": {
"value": "10000.00",
"currency": "EUR"
},
"transaction_type": "goods",
"vat_payment_condition": "on_receipts"
},
"invoice_type": "standard",
"attachment_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
"discount": {
"type": "percentage",
"value": "0.1",
"amount": {
"value": "10.00",
"currency": "EUR"
}
},
"amount_paid": {
"value": "12.52",
"currency": "EUR"
},
"einvoicing_status": "pending",
"welfare_fund": {
"type": "TC01",
"rate": "0.0001"
},
"withholding_tax": {
"reason": "RF01",
"rate": "0.01",
"payment_reason": "L1",
"amount": "1.00"
},
"payment_reporting": {
"conditions": "TP01",
"method": "MP01"
},
"quote_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
"einvoicing_lifecycle_events": [
{
"status_code": 200,
"reason": "DOUBLE FACTURE",
"reason_message": "I already received this invoice",
"timestamp": "2024-12-04T11:05:16.4497Z"
}
]
}
}Authentication: API key OAuth 2.0
Scope:
Scope:
client_invoice.writeAuthorizations
OAuthSecretKey
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.
Path Parameters
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.
Optional ID of a previously uploaded file to attach to this invoice. The upload must have been created using the POST /v2/client_invoices/uploads endpoint.
Example:
"4d5418bb-bd0d-4df4-865c-c07afab8bb48"
Date the initiator has issued or shared the invoice as legally viable. The format should be YYYY-MM-DD.
Required on draft invoices: sending null or an empty string returns a 422 error.
Example:
"2022-03-01"
DEPRECATED: This field is deprecated. Please use performance_start_date and performance_end_date instead.
Alias of performance_start_date. The format should be YYYY-MM-DD. Ignored when performance_start_date is also provided. Send null or an empty string to clear the performance start date.
Start date of the performance period for the invoice. The format should be YYYY-MM-DD.
Validation rules:
- Required if the invoice has a
performance_end_date - Must be less than or equal to
performance_end_date
Fallback behavior:
- If not provided, the deprecated
performance_datevalue is used, when provided - If provided, this value overrides the deprecated
performance_datefield
Send null or an empty string to clear the date.
Example:
"2022-03-01"
End date of the performance period for the invoice. The format should be YYYY-MM-DD.
Validation rules:
- Requires a
performance_start_date, either provided in the request or already set on the invoice - Must be greater than or equal to
performance_start_date
Send null or an empty string to clear the date.
Example:
"2022-03-31"
Payment deadline that is added by the initiator. The format should be YYYY-MM-DD.
Required on draft invoices: sending null or an empty string returns a 422 error.
Invoice's number. Must be unique within the organization.
Maximum string length:
40Example:
"INV-2023-001"
Purchase order data added by the invoice’s initiator.
Maximum string length:
40Additional notes added by the invoice’s initiator.
Maximum string length:
525Example:
"This is an example."
Example:
"This is an example."
Payment method details for the invoice.
Show child attributes
Show child attributes
This collection of properties can be optionally used to temporarily override some of the organization's properties for this one invoice.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
- 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
GETv2/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.
Show child attributes
Show child attributes
- 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
Show child attributes
- 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
ratefield with their IRPF.
Show child attributes
Show child attributes
- 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 - 15Example:
"1.00"
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
Show child attributes
Response
Returns the client invoice identified by the id path parameter.
Show child attributes
Show child attributes
Was this page helpful?