Reject a supplier invoice
curl --request POST \
--url https://thirdparty.qonto.com/v2/supplier_invoices/{id}/reject \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"supplier_invoice": {
"declined_note": "This invoice is not valid",
"declined_reason_code": "DOUBLON"
}
}
'import requests
url = "https://thirdparty.qonto.com/v2/supplier_invoices/{id}/reject"
payload = { "supplier_invoice": {
"declined_note": "This invoice is not valid",
"declined_reason_code": "DOUBLON"
} }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
supplier_invoice: {declined_note: 'This invoice is not valid', declined_reason_code: 'DOUBLON'}
})
};
fetch('https://thirdparty.qonto.com/v2/supplier_invoices/{id}/reject', 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/supplier_invoices/{id}/reject",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'supplier_invoice' => [
'declined_note' => 'This invoice is not valid',
'declined_reason_code' => 'DOUBLON'
]
]),
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/supplier_invoices/{id}/reject"
payload := strings.NewReader("{\n \"supplier_invoice\": {\n \"declined_note\": \"This invoice is not valid\",\n \"declined_reason_code\": \"DOUBLON\"\n }\n}")
req, _ := http.NewRequest("POST", 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.post("https://thirdparty.qonto.com/v2/supplier_invoices/{id}/reject")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"supplier_invoice\": {\n \"declined_note\": \"This invoice is not valid\",\n \"declined_reason_code\": \"DOUBLON\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://thirdparty.qonto.com/v2/supplier_invoices/{id}/reject")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"supplier_invoice\": {\n \"declined_note\": \"This invoice is not valid\",\n \"declined_reason_code\": \"DOUBLON\"\n }\n}"
response = http.request(request)
puts response.read_body{
"id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
"is_einvoice": false,
"has_discrepancies": false,
"organization_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
"file_name": "my-invoice.pdf",
"status": "to_review",
"source_type": "email",
"created_at": "2022-03-04T17:58:30+02:00",
"updated_at": "2022-03-04T17:58:30+02:00",
"attachment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"display_attachment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"declined_note": "",
"e_invoice_type": "zugferd",
"has_duplicates": false,
"supplier_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
"self_invoice_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
"issuer_name": "McDonald's",
"invoice_number": "QONTO-JAN-2022",
"supplier_name": "McDonald's",
"vat_number": "IT12345678901",
"tin_number": "1234567890",
"description": "This is an invoice for Ronald!",
"total_amount": {
"value": "22.10",
"currency": "EUR"
},
"total_amount_excluding_taxes": {
"value": "18.42",
"currency": "EUR"
},
"total_tax_amount": {
"value": "3.68",
"currency": "EUR"
},
"taxes": [
{
"tax_amount": {
"value": "3.68",
"currency": "EUR"
},
"tax_rate": "20"
}
],
"issue_date": "2022-03-01",
"due_date": "2022-03-01",
"payment_date": "2022-03-01",
"scheduled_date": "2022-03-01",
"iban": "FR1420041010050500013M02606",
"initiator_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"source": "email_forward",
"is_attachment_invoice": true,
"attachment_category": "INVOICE",
"is_attachment_non_financial": true,
"analyzed_at": "2022-03-04T17:58:30+02:00",
"matched_transactions_ids": [
"4d5418bb-bd0d-4df4-865c-c07afab8bb48"
],
"matched_transactions": [
{
"subject_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
"subject_type": "transfer",
"transaction_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48"
}
],
"transfer_ids": [
"4d5418bb-bd0d-4df4-865c-c07afab8bb48"
],
"request_transfer": {
"id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
"initiator_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"
}
],
"meta": {
"integration_type": "amazon",
"connector": "grover",
"accounting_recorded_at": "2023-11-07T05:31:56Z",
"accounting_recorded_source": "regate"
},
"supplier_snapshot": {
"id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
"name": "McDonald's",
"iban": "FR1420041010050500013M02606",
"tin": "1234567890",
"vat_number": "IT12345678901",
"email": "billing@example.com",
"currency": "EUR",
"status": "active"
},
"available_actions": {
"delete": true,
"archive": true,
"unarchive": true,
"pay": true,
"reasons": {
"pay": [
"is_credit_note"
],
"delete": [
"invalid_status"
],
"archive": [
"invalid_status"
],
"unarchive": [
"invalid_status"
]
}
},
"approval_workflow": {
"approver_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"supplier_invoice_request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"verified_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"last_approved_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"payable_amount": {
"value": "22.10",
"currency": "EUR"
},
"total_amount_credit_notes": {
"value": "22.10",
"currency": "EUR"
},
"is_credit_note": false,
"has_suggested_credit_notes": false,
"related_invoices": [
{
"id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
"invoice_number": "QONTO-JAN-2022",
"total_amount": {
"value": "22.10",
"currency": "EUR"
},
"attachment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"file_name": "my-invoice.pdf"
}
],
"suggested_transactions": [
{
"id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
"score": "0.8"
}
],
"buyer": {
"name": "Qonto SAS",
"tin": "552100554",
"vat_number": "FR89552100554",
"address": {
"street_address": "12 rue de Rivoli",
"zip_code": "75001",
"city": "Paris",
"province_code": "IDF",
"country_code": "FR"
}
},
"seller": {
"name": "ACME SAS",
"tin": "123456789",
"vat_number": "FR12345678901",
"address": {
"street_address": "12 rue de Rivoli",
"zip_code": "75001",
"city": "Paris",
"province_code": "IDF",
"country_code": "FR"
}
},
"payment_means": [
{
"type": "transfer",
"payee_name": "ACME SAS",
"code": "30"
}
]
}
Supplier Invoices
Reject a supplier invoice
OAuth scope: supplier_invoice.write
Rejects a supplier invoice. Only to_review, to_approve, and awaiting_payment invoices are eligible. On success, status is rejected. If the invoice is in any other status, the call fails with 400 Bad Request (invalid transition).
Idempotency and retries: There is no separate idempotency key; the outcome depends on the invoice’s current status. Calling again after the invoice is already rejected returns 400 (invalid transition), not a no-op success.
Rejecting French e-invoices
From 1 September 2026, rejecting a French e-invoice requires a declined_reason_code from the AFNOR list. Requests without it return 422.
This applies only when the target invoice is a French e-invoice (is_einvoice = true and organization legal country FR). All other rejects are unaffected.
POST
/
v2
/
supplier_invoices
/
{id}
/
reject
Reject a supplier invoice
curl --request POST \
--url https://thirdparty.qonto.com/v2/supplier_invoices/{id}/reject \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"supplier_invoice": {
"declined_note": "This invoice is not valid",
"declined_reason_code": "DOUBLON"
}
}
'import requests
url = "https://thirdparty.qonto.com/v2/supplier_invoices/{id}/reject"
payload = { "supplier_invoice": {
"declined_note": "This invoice is not valid",
"declined_reason_code": "DOUBLON"
} }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
supplier_invoice: {declined_note: 'This invoice is not valid', declined_reason_code: 'DOUBLON'}
})
};
fetch('https://thirdparty.qonto.com/v2/supplier_invoices/{id}/reject', 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/supplier_invoices/{id}/reject",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'supplier_invoice' => [
'declined_note' => 'This invoice is not valid',
'declined_reason_code' => 'DOUBLON'
]
]),
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/supplier_invoices/{id}/reject"
payload := strings.NewReader("{\n \"supplier_invoice\": {\n \"declined_note\": \"This invoice is not valid\",\n \"declined_reason_code\": \"DOUBLON\"\n }\n}")
req, _ := http.NewRequest("POST", 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.post("https://thirdparty.qonto.com/v2/supplier_invoices/{id}/reject")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"supplier_invoice\": {\n \"declined_note\": \"This invoice is not valid\",\n \"declined_reason_code\": \"DOUBLON\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://thirdparty.qonto.com/v2/supplier_invoices/{id}/reject")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"supplier_invoice\": {\n \"declined_note\": \"This invoice is not valid\",\n \"declined_reason_code\": \"DOUBLON\"\n }\n}"
response = http.request(request)
puts response.read_body{
"id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
"is_einvoice": false,
"has_discrepancies": false,
"organization_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
"file_name": "my-invoice.pdf",
"status": "to_review",
"source_type": "email",
"created_at": "2022-03-04T17:58:30+02:00",
"updated_at": "2022-03-04T17:58:30+02:00",
"attachment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"display_attachment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"declined_note": "",
"e_invoice_type": "zugferd",
"has_duplicates": false,
"supplier_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
"self_invoice_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
"issuer_name": "McDonald's",
"invoice_number": "QONTO-JAN-2022",
"supplier_name": "McDonald's",
"vat_number": "IT12345678901",
"tin_number": "1234567890",
"description": "This is an invoice for Ronald!",
"total_amount": {
"value": "22.10",
"currency": "EUR"
},
"total_amount_excluding_taxes": {
"value": "18.42",
"currency": "EUR"
},
"total_tax_amount": {
"value": "3.68",
"currency": "EUR"
},
"taxes": [
{
"tax_amount": {
"value": "3.68",
"currency": "EUR"
},
"tax_rate": "20"
}
],
"issue_date": "2022-03-01",
"due_date": "2022-03-01",
"payment_date": "2022-03-01",
"scheduled_date": "2022-03-01",
"iban": "FR1420041010050500013M02606",
"initiator_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"source": "email_forward",
"is_attachment_invoice": true,
"attachment_category": "INVOICE",
"is_attachment_non_financial": true,
"analyzed_at": "2022-03-04T17:58:30+02:00",
"matched_transactions_ids": [
"4d5418bb-bd0d-4df4-865c-c07afab8bb48"
],
"matched_transactions": [
{
"subject_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
"subject_type": "transfer",
"transaction_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48"
}
],
"transfer_ids": [
"4d5418bb-bd0d-4df4-865c-c07afab8bb48"
],
"request_transfer": {
"id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
"initiator_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"
}
],
"meta": {
"integration_type": "amazon",
"connector": "grover",
"accounting_recorded_at": "2023-11-07T05:31:56Z",
"accounting_recorded_source": "regate"
},
"supplier_snapshot": {
"id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
"name": "McDonald's",
"iban": "FR1420041010050500013M02606",
"tin": "1234567890",
"vat_number": "IT12345678901",
"email": "billing@example.com",
"currency": "EUR",
"status": "active"
},
"available_actions": {
"delete": true,
"archive": true,
"unarchive": true,
"pay": true,
"reasons": {
"pay": [
"is_credit_note"
],
"delete": [
"invalid_status"
],
"archive": [
"invalid_status"
],
"unarchive": [
"invalid_status"
]
}
},
"approval_workflow": {
"approver_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"supplier_invoice_request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"verified_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"last_approved_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"payable_amount": {
"value": "22.10",
"currency": "EUR"
},
"total_amount_credit_notes": {
"value": "22.10",
"currency": "EUR"
},
"is_credit_note": false,
"has_suggested_credit_notes": false,
"related_invoices": [
{
"id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
"invoice_number": "QONTO-JAN-2022",
"total_amount": {
"value": "22.10",
"currency": "EUR"
},
"attachment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"file_name": "my-invoice.pdf"
}
],
"suggested_transactions": [
{
"id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
"score": "0.8"
}
],
"buyer": {
"name": "Qonto SAS",
"tin": "552100554",
"vat_number": "FR89552100554",
"address": {
"street_address": "12 rue de Rivoli",
"zip_code": "75001",
"city": "Paris",
"province_code": "IDF",
"country_code": "FR"
}
},
"seller": {
"name": "ACME SAS",
"tin": "123456789",
"vat_number": "FR12345678901",
"address": {
"street_address": "12 rue de Rivoli",
"zip_code": "75001",
"city": "Paris",
"province_code": "IDF",
"country_code": "FR"
}
},
"payment_means": [
{
"type": "transfer",
"payee_name": "ACME SAS",
"code": "30"
}
]
}
Authorizations
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
The ID of the supplier invoice to reject
Body
application/json
Show child attributes
Show child attributes
Response
The supplier invoice
Example:
"4d5418bb-bd0d-4df4-865c-c07afab8bb48"
indicates if the invoice is an e-invoice, currently ONLY for the German organizations
Example:
false
Example:
false
Example:
"4d5418bb-bd0d-4df4-865c-c07afab8bb48"
Example:
"my-invoice.pdf"
status
Option 1 · stringOption 2 · stringOption 3 · stringOption 4 · stringOption 5 · stringOption 6 · stringOption 7 · stringOption 8 · stringOption 9 · stringOption 10 · string
required
Initial status for invoices.
Allowed value:
"to_review"Example:
"to_review"
Available options:
email, e_invoicing, direct_upload Example:
"email"
Example:
"2022-03-04T17:58:30+02:00"
Example:
"2022-03-04T17:58:30+02:00"
Note specified when invoice was archived
Available options:
zugferd, xrechnung Example:
"zugferd"
Example:
false
ID of the supplier linked to this invoice
Example:
"4d5418bb-bd0d-4df4-865c-c07afab8bb48"
ID of the related self-invoice, when applicable
Example:
"4d5418bb-bd0d-4df4-865c-c07afab8bb48"
Name of the issuer as extracted from the invoice data
Example:
"McDonald's"
Example:
"QONTO-JAN-2022"
Example:
"McDonald's"
VAT number of the invoice issuer
Example:
"IT12345678901"
Tax Identification Number (TIN) of the invoice issuer
Example:
"1234567890"
Example:
"This is an invoice for Ronald!"
Show child attributes
Show child attributes
Total invoice amount excluding taxes. Populated for e-invoices (FR, IT, DE) and for invoices where OCR extracted the pretax total; null when the value is unknown.
Show child attributes
Show child attributes
Sum of all taxes on the invoice. Populated for e-invoices (FR, IT, DE) and for invoices where OCR extracted the tax total; null when the value is unknown.
Show child attributes
Show child attributes
Per-rate tax breakdown extracted from the invoice. Populated for e-invoices (FR, IT, DE) when the source document provides a rate-by-rate summary; null or empty otherwise.
Show child attributes
Show child attributes
Example:
"2022-03-01"
Example:
"2022-03-01"
Example:
"2022-03-01"
Example:
"2022-03-01"
Example:
"FR1420041010050500013M02606"
Available options:
email_forward, e_invoicing, supplier_invoices, pay_by_invoice, integration, regate, attachments_hub, generic_upload, pay_later Example:
"email_forward"
The category of the attachment
Available options:
INVOICE, EXPENSE_RECEIPT, CARD_RECEIPT, CREDIT_CARD_RECEIPT, CREDIT_NOTE, OTHER_FINANCIAL_DOCUMENT, OTHER_NON_FINANCIAL_DOCUMENT, UNKNOWN Example:
"INVOICE"
Example:
"2022-03-04T17:58:30+02:00"
Deprecated: This field contains transfer IDs, not transaction IDs. Use matched_transactions instead.
Array of payments (transfers/transactions) linked to this invoice
Show child attributes
Show child attributes
IDs of the transfer payments associated with this invoice, if any
Example:
"4d5418bb-bd0d-4df4-865c-c07afab8bb48"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Snapshot of the supplier details captured at the time the invoice was created
Show child attributes
Show child attributes
Available actions for the invoice
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Example:
false
Example:
false
Show child attributes
Show child attributes
suggested transactions for the invoice
Show child attributes
Show child attributes
Buyer extracted from the e-invoice XML. Null when no buyer data is available (non-e-invoices or invoices where buyer extraction is not yet supported).
Show child attributes
Show child attributes
Seller extracted from the e-invoice XML. Null when no seller data is available.
Show child attributes
Show child attributes
Payment means extracted from the e-invoice XML. Empty or null when no payment means data is available.
Show child attributes
Show child attributes
Was this page helpful?