Create an invoice
curl --request POST \
--url https://api.chift.eu/consumers/{consumer_id}/invoicing/invoices \
--header 'Content-Type: application/json' \
--data '
{
"currency": "EUR",
"invoice_date": "2026-01-15",
"tax_amount": 42,
"untaxed_amount": 200,
"total": 242,
"lines": [],
"partner_id": "<invoicing-partner-id>",
"invoice_number": "INV-2026-0001",
"due_date": "2026-02-14",
"reference": "REF-0001",
"payment_communication": "+++000/0000/00000+++",
"customer_memo": "Thank you for your business.",
"journal_ref": {
"id": "<target-software-id>",
"model": "invoice",
"name": "Example Company S.A."
},
"italian_specificities": {
"stamp_duty_amount": 2,
"withholding_tax": {
"rate": 20,
"amount": 40
},
"welfare_fund": {
"rate": 4,
"amount": 8
},
"payment_reporting": {}
},
"spanish_specificities": {
"withholding_tax": {
"tax_rate": -19,
"tax_code": "<accounting-tax-code>",
"tax_amount": -38
}
}
}
'import requests
url = "https://api.chift.eu/consumers/{consumer_id}/invoicing/invoices"
payload = {
"currency": "EUR",
"invoice_date": "2026-01-15",
"tax_amount": 42,
"untaxed_amount": 200,
"total": 242,
"lines": [],
"partner_id": "<invoicing-partner-id>",
"invoice_number": "INV-2026-0001",
"due_date": "2026-02-14",
"reference": "REF-0001",
"payment_communication": "+++000/0000/00000+++",
"customer_memo": "Thank you for your business.",
"journal_ref": {
"id": "<target-software-id>",
"model": "invoice",
"name": "Example Company S.A."
},
"italian_specificities": {
"stamp_duty_amount": 2,
"withholding_tax": {
"rate": 20,
"amount": 40
},
"welfare_fund": {
"rate": 4,
"amount": 8
},
"payment_reporting": {}
},
"spanish_specificities": { "withholding_tax": {
"tax_rate": -19,
"tax_code": "<accounting-tax-code>",
"tax_amount": -38
} }
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
currency: 'EUR',
invoice_date: '2026-01-15',
tax_amount: 42,
untaxed_amount: 200,
total: 242,
lines: [],
partner_id: '<invoicing-partner-id>',
invoice_number: 'INV-2026-0001',
due_date: '2026-02-14',
reference: 'REF-0001',
payment_communication: '+++000/0000/00000+++',
customer_memo: 'Thank you for your business.',
journal_ref: {id: '<target-software-id>', model: 'invoice', name: 'Example Company S.A.'},
italian_specificities: {
stamp_duty_amount: 2,
withholding_tax: {rate: 20, amount: 40},
welfare_fund: {rate: 4, amount: 8},
payment_reporting: {}
},
spanish_specificities: {
withholding_tax: {tax_rate: -19, tax_code: '<accounting-tax-code>', tax_amount: -38}
}
})
};
fetch('https://api.chift.eu/consumers/{consumer_id}/invoicing/invoices', 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://api.chift.eu/consumers/{consumer_id}/invoicing/invoices",
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([
'currency' => 'EUR',
'invoice_date' => '2026-01-15',
'tax_amount' => 42,
'untaxed_amount' => 200,
'total' => 242,
'lines' => [
],
'partner_id' => '<invoicing-partner-id>',
'invoice_number' => 'INV-2026-0001',
'due_date' => '2026-02-14',
'reference' => 'REF-0001',
'payment_communication' => '+++000/0000/00000+++',
'customer_memo' => 'Thank you for your business.',
'journal_ref' => [
'id' => '<target-software-id>',
'model' => 'invoice',
'name' => 'Example Company S.A.'
],
'italian_specificities' => [
'stamp_duty_amount' => 2,
'withholding_tax' => [
'rate' => 20,
'amount' => 40
],
'welfare_fund' => [
'rate' => 4,
'amount' => 8
],
'payment_reporting' => [
]
],
'spanish_specificities' => [
'withholding_tax' => [
'tax_rate' => -19,
'tax_code' => '<accounting-tax-code>',
'tax_amount' => -38
]
]
]),
CURLOPT_HTTPHEADER => [
"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://api.chift.eu/consumers/{consumer_id}/invoicing/invoices"
payload := strings.NewReader("{\n \"currency\": \"EUR\",\n \"invoice_date\": \"2026-01-15\",\n \"tax_amount\": 42,\n \"untaxed_amount\": 200,\n \"total\": 242,\n \"lines\": [],\n \"partner_id\": \"<invoicing-partner-id>\",\n \"invoice_number\": \"INV-2026-0001\",\n \"due_date\": \"2026-02-14\",\n \"reference\": \"REF-0001\",\n \"payment_communication\": \"+++000/0000/00000+++\",\n \"customer_memo\": \"Thank you for your business.\",\n \"journal_ref\": {\n \"id\": \"<target-software-id>\",\n \"model\": \"invoice\",\n \"name\": \"Example Company S.A.\"\n },\n \"italian_specificities\": {\n \"stamp_duty_amount\": 2,\n \"withholding_tax\": {\n \"rate\": 20,\n \"amount\": 40\n },\n \"welfare_fund\": {\n \"rate\": 4,\n \"amount\": 8\n },\n \"payment_reporting\": {}\n },\n \"spanish_specificities\": {\n \"withholding_tax\": {\n \"tax_rate\": -19,\n \"tax_code\": \"<accounting-tax-code>\",\n \"tax_amount\": -38\n }\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
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://api.chift.eu/consumers/{consumer_id}/invoicing/invoices")
.header("Content-Type", "application/json")
.body("{\n \"currency\": \"EUR\",\n \"invoice_date\": \"2026-01-15\",\n \"tax_amount\": 42,\n \"untaxed_amount\": 200,\n \"total\": 242,\n \"lines\": [],\n \"partner_id\": \"<invoicing-partner-id>\",\n \"invoice_number\": \"INV-2026-0001\",\n \"due_date\": \"2026-02-14\",\n \"reference\": \"REF-0001\",\n \"payment_communication\": \"+++000/0000/00000+++\",\n \"customer_memo\": \"Thank you for your business.\",\n \"journal_ref\": {\n \"id\": \"<target-software-id>\",\n \"model\": \"invoice\",\n \"name\": \"Example Company S.A.\"\n },\n \"italian_specificities\": {\n \"stamp_duty_amount\": 2,\n \"withholding_tax\": {\n \"rate\": 20,\n \"amount\": 40\n },\n \"welfare_fund\": {\n \"rate\": 4,\n \"amount\": 8\n },\n \"payment_reporting\": {}\n },\n \"spanish_specificities\": {\n \"withholding_tax\": {\n \"tax_rate\": -19,\n \"tax_code\": \"<accounting-tax-code>\",\n \"tax_amount\": -38\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.chift.eu/consumers/{consumer_id}/invoicing/invoices")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"currency\": \"EUR\",\n \"invoice_date\": \"2026-01-15\",\n \"tax_amount\": 42,\n \"untaxed_amount\": 200,\n \"total\": 242,\n \"lines\": [],\n \"partner_id\": \"<invoicing-partner-id>\",\n \"invoice_number\": \"INV-2026-0001\",\n \"due_date\": \"2026-02-14\",\n \"reference\": \"REF-0001\",\n \"payment_communication\": \"+++000/0000/00000+++\",\n \"customer_memo\": \"Thank you for your business.\",\n \"journal_ref\": {\n \"id\": \"<target-software-id>\",\n \"model\": \"invoice\",\n \"name\": \"Example Company S.A.\"\n },\n \"italian_specificities\": {\n \"stamp_duty_amount\": 2,\n \"withholding_tax\": {\n \"rate\": 20,\n \"amount\": 40\n },\n \"welfare_fund\": {\n \"rate\": 4,\n \"amount\": 8\n },\n \"payment_reporting\": {}\n },\n \"spanish_specificities\": {\n \"withholding_tax\": {\n \"tax_rate\": -19,\n \"tax_code\": \"<accounting-tax-code>\",\n \"tax_amount\": -38\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"id": "<this-id>",
"source_ref": {
"id": "<target-software-id>",
"model": "invoice"
},
"currency": "EUR",
"invoice_type": "customer_invoice",
"status": "cancelled",
"invoice_date": "2026-01-15",
"tax_amount": 42,
"untaxed_amount": 200,
"total": 242,
"lines": [],
"partner_id": "<invoicing-partner-id>",
"invoice_number": "INV-2026-0001",
"due_date": "2026-02-14",
"reference": "REF-0001",
"payment_communication": "+++000/0000/00000+++",
"customer_memo": "Thank you for your business.",
"journal_ref": {
"id": "<target-software-id>",
"model": "invoice",
"name": "Example Company S.A."
},
"italian_specificities": {
"stamp_duty_amount": 2,
"withholding_tax": {
"rate": 20,
"amount": 40,
"reason": "RT01",
"payment_reason": "A"
},
"welfare_fund": {
"rate": 4,
"amount": 8,
"type": "TC01"
},
"payment_reporting": {
"method": "MP01",
"conditions": "TP01"
}
},
"spanish_specificities": {
"withholding_tax": {
"tax_rate": -19,
"tax_code": "<accounting-tax-code>",
"tax_amount": -38
}
},
"last_updated_on": "2026-01-15T10:30:00Z",
"outstanding_amount": 0,
"last_payment_date": "2026-02-14",
"accounting_date": "2026-01-15",
"payment_method_id": "<invoicing-payment-method-id>",
"currency_exchange_rate": 1
}{
"message": "Error while trying to perform your request",
"status": "error"
}{
"message": "Validation error",
"status": "error",
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Invoices
Create an invoice
Creates a new invoice in the invoicing system and returns the created invoice record.
POST
/
consumers
/
{consumer_id}
/
invoicing
/
invoices
Create an invoice
curl --request POST \
--url https://api.chift.eu/consumers/{consumer_id}/invoicing/invoices \
--header 'Content-Type: application/json' \
--data '
{
"currency": "EUR",
"invoice_date": "2026-01-15",
"tax_amount": 42,
"untaxed_amount": 200,
"total": 242,
"lines": [],
"partner_id": "<invoicing-partner-id>",
"invoice_number": "INV-2026-0001",
"due_date": "2026-02-14",
"reference": "REF-0001",
"payment_communication": "+++000/0000/00000+++",
"customer_memo": "Thank you for your business.",
"journal_ref": {
"id": "<target-software-id>",
"model": "invoice",
"name": "Example Company S.A."
},
"italian_specificities": {
"stamp_duty_amount": 2,
"withholding_tax": {
"rate": 20,
"amount": 40
},
"welfare_fund": {
"rate": 4,
"amount": 8
},
"payment_reporting": {}
},
"spanish_specificities": {
"withholding_tax": {
"tax_rate": -19,
"tax_code": "<accounting-tax-code>",
"tax_amount": -38
}
}
}
'import requests
url = "https://api.chift.eu/consumers/{consumer_id}/invoicing/invoices"
payload = {
"currency": "EUR",
"invoice_date": "2026-01-15",
"tax_amount": 42,
"untaxed_amount": 200,
"total": 242,
"lines": [],
"partner_id": "<invoicing-partner-id>",
"invoice_number": "INV-2026-0001",
"due_date": "2026-02-14",
"reference": "REF-0001",
"payment_communication": "+++000/0000/00000+++",
"customer_memo": "Thank you for your business.",
"journal_ref": {
"id": "<target-software-id>",
"model": "invoice",
"name": "Example Company S.A."
},
"italian_specificities": {
"stamp_duty_amount": 2,
"withholding_tax": {
"rate": 20,
"amount": 40
},
"welfare_fund": {
"rate": 4,
"amount": 8
},
"payment_reporting": {}
},
"spanish_specificities": { "withholding_tax": {
"tax_rate": -19,
"tax_code": "<accounting-tax-code>",
"tax_amount": -38
} }
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
currency: 'EUR',
invoice_date: '2026-01-15',
tax_amount: 42,
untaxed_amount: 200,
total: 242,
lines: [],
partner_id: '<invoicing-partner-id>',
invoice_number: 'INV-2026-0001',
due_date: '2026-02-14',
reference: 'REF-0001',
payment_communication: '+++000/0000/00000+++',
customer_memo: 'Thank you for your business.',
journal_ref: {id: '<target-software-id>', model: 'invoice', name: 'Example Company S.A.'},
italian_specificities: {
stamp_duty_amount: 2,
withholding_tax: {rate: 20, amount: 40},
welfare_fund: {rate: 4, amount: 8},
payment_reporting: {}
},
spanish_specificities: {
withholding_tax: {tax_rate: -19, tax_code: '<accounting-tax-code>', tax_amount: -38}
}
})
};
fetch('https://api.chift.eu/consumers/{consumer_id}/invoicing/invoices', 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://api.chift.eu/consumers/{consumer_id}/invoicing/invoices",
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([
'currency' => 'EUR',
'invoice_date' => '2026-01-15',
'tax_amount' => 42,
'untaxed_amount' => 200,
'total' => 242,
'lines' => [
],
'partner_id' => '<invoicing-partner-id>',
'invoice_number' => 'INV-2026-0001',
'due_date' => '2026-02-14',
'reference' => 'REF-0001',
'payment_communication' => '+++000/0000/00000+++',
'customer_memo' => 'Thank you for your business.',
'journal_ref' => [
'id' => '<target-software-id>',
'model' => 'invoice',
'name' => 'Example Company S.A.'
],
'italian_specificities' => [
'stamp_duty_amount' => 2,
'withholding_tax' => [
'rate' => 20,
'amount' => 40
],
'welfare_fund' => [
'rate' => 4,
'amount' => 8
],
'payment_reporting' => [
]
],
'spanish_specificities' => [
'withholding_tax' => [
'tax_rate' => -19,
'tax_code' => '<accounting-tax-code>',
'tax_amount' => -38
]
]
]),
CURLOPT_HTTPHEADER => [
"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://api.chift.eu/consumers/{consumer_id}/invoicing/invoices"
payload := strings.NewReader("{\n \"currency\": \"EUR\",\n \"invoice_date\": \"2026-01-15\",\n \"tax_amount\": 42,\n \"untaxed_amount\": 200,\n \"total\": 242,\n \"lines\": [],\n \"partner_id\": \"<invoicing-partner-id>\",\n \"invoice_number\": \"INV-2026-0001\",\n \"due_date\": \"2026-02-14\",\n \"reference\": \"REF-0001\",\n \"payment_communication\": \"+++000/0000/00000+++\",\n \"customer_memo\": \"Thank you for your business.\",\n \"journal_ref\": {\n \"id\": \"<target-software-id>\",\n \"model\": \"invoice\",\n \"name\": \"Example Company S.A.\"\n },\n \"italian_specificities\": {\n \"stamp_duty_amount\": 2,\n \"withholding_tax\": {\n \"rate\": 20,\n \"amount\": 40\n },\n \"welfare_fund\": {\n \"rate\": 4,\n \"amount\": 8\n },\n \"payment_reporting\": {}\n },\n \"spanish_specificities\": {\n \"withholding_tax\": {\n \"tax_rate\": -19,\n \"tax_code\": \"<accounting-tax-code>\",\n \"tax_amount\": -38\n }\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
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://api.chift.eu/consumers/{consumer_id}/invoicing/invoices")
.header("Content-Type", "application/json")
.body("{\n \"currency\": \"EUR\",\n \"invoice_date\": \"2026-01-15\",\n \"tax_amount\": 42,\n \"untaxed_amount\": 200,\n \"total\": 242,\n \"lines\": [],\n \"partner_id\": \"<invoicing-partner-id>\",\n \"invoice_number\": \"INV-2026-0001\",\n \"due_date\": \"2026-02-14\",\n \"reference\": \"REF-0001\",\n \"payment_communication\": \"+++000/0000/00000+++\",\n \"customer_memo\": \"Thank you for your business.\",\n \"journal_ref\": {\n \"id\": \"<target-software-id>\",\n \"model\": \"invoice\",\n \"name\": \"Example Company S.A.\"\n },\n \"italian_specificities\": {\n \"stamp_duty_amount\": 2,\n \"withholding_tax\": {\n \"rate\": 20,\n \"amount\": 40\n },\n \"welfare_fund\": {\n \"rate\": 4,\n \"amount\": 8\n },\n \"payment_reporting\": {}\n },\n \"spanish_specificities\": {\n \"withholding_tax\": {\n \"tax_rate\": -19,\n \"tax_code\": \"<accounting-tax-code>\",\n \"tax_amount\": -38\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.chift.eu/consumers/{consumer_id}/invoicing/invoices")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"currency\": \"EUR\",\n \"invoice_date\": \"2026-01-15\",\n \"tax_amount\": 42,\n \"untaxed_amount\": 200,\n \"total\": 242,\n \"lines\": [],\n \"partner_id\": \"<invoicing-partner-id>\",\n \"invoice_number\": \"INV-2026-0001\",\n \"due_date\": \"2026-02-14\",\n \"reference\": \"REF-0001\",\n \"payment_communication\": \"+++000/0000/00000+++\",\n \"customer_memo\": \"Thank you for your business.\",\n \"journal_ref\": {\n \"id\": \"<target-software-id>\",\n \"model\": \"invoice\",\n \"name\": \"Example Company S.A.\"\n },\n \"italian_specificities\": {\n \"stamp_duty_amount\": 2,\n \"withholding_tax\": {\n \"rate\": 20,\n \"amount\": 40\n },\n \"welfare_fund\": {\n \"rate\": 4,\n \"amount\": 8\n },\n \"payment_reporting\": {}\n },\n \"spanish_specificities\": {\n \"withholding_tax\": {\n \"tax_rate\": -19,\n \"tax_code\": \"<accounting-tax-code>\",\n \"tax_amount\": -38\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"id": "<this-id>",
"source_ref": {
"id": "<target-software-id>",
"model": "invoice"
},
"currency": "EUR",
"invoice_type": "customer_invoice",
"status": "cancelled",
"invoice_date": "2026-01-15",
"tax_amount": 42,
"untaxed_amount": 200,
"total": 242,
"lines": [],
"partner_id": "<invoicing-partner-id>",
"invoice_number": "INV-2026-0001",
"due_date": "2026-02-14",
"reference": "REF-0001",
"payment_communication": "+++000/0000/00000+++",
"customer_memo": "Thank you for your business.",
"journal_ref": {
"id": "<target-software-id>",
"model": "invoice",
"name": "Example Company S.A."
},
"italian_specificities": {
"stamp_duty_amount": 2,
"withholding_tax": {
"rate": 20,
"amount": 40,
"reason": "RT01",
"payment_reason": "A"
},
"welfare_fund": {
"rate": 4,
"amount": 8,
"type": "TC01"
},
"payment_reporting": {
"method": "MP01",
"conditions": "TP01"
}
},
"spanish_specificities": {
"withholding_tax": {
"tax_rate": -19,
"tax_code": "<accounting-tax-code>",
"tax_amount": -38
}
},
"last_updated_on": "2026-01-15T10:30:00Z",
"outstanding_amount": 0,
"last_payment_date": "2026-02-14",
"accounting_date": "2026-01-15",
"payment_method_id": "<invoicing-payment-method-id>",
"currency_exchange_rate": 1
}{
"message": "Error while trying to perform your request",
"status": "error"
}{
"message": "Validation error",
"status": "error",
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Learn more:
Body
application/json
Response
Successful Response