Amend Tax Invoice - Correction of Error in Entries
Pass the corrected tax invoice content, and the API issues two invoices together: a cancellation invoice that offsets the original and a corrected invoice. In the response, issuanceKey is the corrected invoice and cancelIssuanceKey is the cancellation invoice. Retrieve each invoice and receive its webhook by its own key. The API deducts points for each invoice.
The total item supply cost must not be zero. If the total tax is neither zero nor null, it must have the same sign as the total supply cost.
If you omit supplier, the API uses the original supplier. If you send supplier, identificationNumber and taxRegistrationId must match the original. Brokered tax invoices and tax invoices whose supplied party uses a foreign registration number are not supported.
See the Amendment types guide.
The API removes invisible characters from the request text but keeps tabs, line feeds, and carriage returns. It rejects supplementary characters above U+FFFF, such as emoji, with 400. See Unsupported characters.
curl --request POST \
--url https://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/amend/misspell \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"date": "2026-05-27",
"purpose": "CLAIM",
"taxType": "TAXABLE",
"supplied": {
"identificationNumber": "0987654321",
"taxRegistrationId": null,
"organizationName": "Recipient Company",
"representativeName": "Recipient Representative",
"address": null,
"businessItem": null,
"businessType": null,
"managers": [
{
"email": "recipient@example.com",
"name": "Recipient Manager",
"telephone": null
}
]
},
"items": [
{
"date": "2026-05-27",
"name": "Corrected item",
"unitPrice": null,
"quantity": null,
"supplyCost": 100000,
"tax": 10000,
"specification": null,
"description": null
}
]
}
'import requests
url = "https://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/amend/misspell"
payload = {
"date": "2026-05-27",
"purpose": "CLAIM",
"taxType": "TAXABLE",
"supplied": {
"identificationNumber": "0987654321",
"taxRegistrationId": None,
"organizationName": "Recipient Company",
"representativeName": "Recipient Representative",
"address": None,
"businessItem": None,
"businessType": None,
"managers": [
{
"email": "recipient@example.com",
"name": "Recipient Manager",
"telephone": None
}
]
},
"items": [
{
"date": "2026-05-27",
"name": "Corrected item",
"unitPrice": None,
"quantity": None,
"supplyCost": 100000,
"tax": 10000,
"specification": None,
"description": None
}
]
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({
date: '2026-05-27',
purpose: 'CLAIM',
taxType: 'TAXABLE',
supplied: {
identificationNumber: '0987654321',
taxRegistrationId: null,
organizationName: 'Recipient Company',
representativeName: 'Recipient Representative',
address: null,
businessItem: null,
businessType: null,
managers: [{email: 'recipient@example.com', name: 'Recipient Manager', telephone: null}]
},
items: [
{
date: '2026-05-27',
name: 'Corrected item',
unitPrice: null,
quantity: null,
supplyCost: 100000,
tax: 10000,
specification: null,
description: null
}
]
})
};
fetch('https://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/amend/misspell', 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://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/amend/misspell",
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([
'date' => '2026-05-27',
'purpose' => 'CLAIM',
'taxType' => 'TAXABLE',
'supplied' => [
'identificationNumber' => '0987654321',
'taxRegistrationId' => null,
'organizationName' => 'Recipient Company',
'representativeName' => 'Recipient Representative',
'address' => null,
'businessItem' => null,
'businessType' => null,
'managers' => [
[
'email' => 'recipient@example.com',
'name' => 'Recipient Manager',
'telephone' => null
]
]
],
'items' => [
[
'date' => '2026-05-27',
'name' => 'Corrected item',
'unitPrice' => null,
'quantity' => null,
'supplyCost' => 100000,
'tax' => 10000,
'specification' => null,
'description' => null
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"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://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/amend/misspell"
payload := strings.NewReader("{\n \"date\": \"2026-05-27\",\n \"purpose\": \"CLAIM\",\n \"taxType\": \"TAXABLE\",\n \"supplied\": {\n \"identificationNumber\": \"0987654321\",\n \"taxRegistrationId\": null,\n \"organizationName\": \"Recipient Company\",\n \"representativeName\": \"Recipient Representative\",\n \"address\": null,\n \"businessItem\": null,\n \"businessType\": null,\n \"managers\": [\n {\n \"email\": \"recipient@example.com\",\n \"name\": \"Recipient Manager\",\n \"telephone\": null\n }\n ]\n },\n \"items\": [\n {\n \"date\": \"2026-05-27\",\n \"name\": \"Corrected item\",\n \"unitPrice\": null,\n \"quantity\": null,\n \"supplyCost\": 100000,\n \"tax\": 10000,\n \"specification\": null,\n \"description\": null\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Basic <encoded-value>")
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://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/amend/misspell")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"date\": \"2026-05-27\",\n \"purpose\": \"CLAIM\",\n \"taxType\": \"TAXABLE\",\n \"supplied\": {\n \"identificationNumber\": \"0987654321\",\n \"taxRegistrationId\": null,\n \"organizationName\": \"Recipient Company\",\n \"representativeName\": \"Recipient Representative\",\n \"address\": null,\n \"businessItem\": null,\n \"businessType\": null,\n \"managers\": [\n {\n \"email\": \"recipient@example.com\",\n \"name\": \"Recipient Manager\",\n \"telephone\": null\n }\n ]\n },\n \"items\": [\n {\n \"date\": \"2026-05-27\",\n \"name\": \"Corrected item\",\n \"unitPrice\": null,\n \"quantity\": null,\n \"supplyCost\": 100000,\n \"tax\": 10000,\n \"specification\": null,\n \"description\": null\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/amend/misspell")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"date\": \"2026-05-27\",\n \"purpose\": \"CLAIM\",\n \"taxType\": \"TAXABLE\",\n \"supplied\": {\n \"identificationNumber\": \"0987654321\",\n \"taxRegistrationId\": null,\n \"organizationName\": \"Recipient Company\",\n \"representativeName\": \"Recipient Representative\",\n \"address\": null,\n \"businessItem\": null,\n \"businessType\": null,\n \"managers\": [\n {\n \"email\": \"recipient@example.com\",\n \"name\": \"Recipient Manager\",\n \"telephone\": null\n }\n ]\n },\n \"items\": [\n {\n \"date\": \"2026-05-27\",\n \"name\": \"Corrected item\",\n \"unitPrice\": null,\n \"quantity\": null,\n \"supplyCost\": 100000,\n \"tax\": 10000,\n \"specification\": null,\n \"description\": null\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"issuanceKey": "8D529FAD3EBAE050B79CE943CCC7CEDE",
"cancelIssuanceKey": "8D529FAD3EBAE050B79CE943CCC7CEDE"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}Authorizations
Headers
Client reference ID for a tax invoice request. This header is optional. Enter a non-blank value between 1 and 255 characters. After this value is used with a tax invoice issuance API, the same API key cannot reuse it, regardless of the request content or endpoint. A duplicate returns 400 Bad Request with INVALID_REQUEST. If you do not receive a response, do not resend the request. Check the accepted request with the request status API.
1 - 255\SBody
TAXABLE: taxable (e-tax invoice), ZERO_RATE: zero-rate (e-tax invoice), TAX_FREE: tax-exempt (invoice). For TAXABLE the item tax cannot be null; for ZERO_RATE every item's tax must be 0. For TAX_FREE every item's tax must be null or omitted.
TAXABLE, ZERO_RATE, TAX_FREE "TAXABLE"
"ZERO_RATE"
"TAX_FREE"
curl --request POST \
--url https://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/amend/misspell \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"date": "2026-05-27",
"purpose": "CLAIM",
"taxType": "TAXABLE",
"supplied": {
"identificationNumber": "0987654321",
"taxRegistrationId": null,
"organizationName": "Recipient Company",
"representativeName": "Recipient Representative",
"address": null,
"businessItem": null,
"businessType": null,
"managers": [
{
"email": "recipient@example.com",
"name": "Recipient Manager",
"telephone": null
}
]
},
"items": [
{
"date": "2026-05-27",
"name": "Corrected item",
"unitPrice": null,
"quantity": null,
"supplyCost": 100000,
"tax": 10000,
"specification": null,
"description": null
}
]
}
'import requests
url = "https://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/amend/misspell"
payload = {
"date": "2026-05-27",
"purpose": "CLAIM",
"taxType": "TAXABLE",
"supplied": {
"identificationNumber": "0987654321",
"taxRegistrationId": None,
"organizationName": "Recipient Company",
"representativeName": "Recipient Representative",
"address": None,
"businessItem": None,
"businessType": None,
"managers": [
{
"email": "recipient@example.com",
"name": "Recipient Manager",
"telephone": None
}
]
},
"items": [
{
"date": "2026-05-27",
"name": "Corrected item",
"unitPrice": None,
"quantity": None,
"supplyCost": 100000,
"tax": 10000,
"specification": None,
"description": None
}
]
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({
date: '2026-05-27',
purpose: 'CLAIM',
taxType: 'TAXABLE',
supplied: {
identificationNumber: '0987654321',
taxRegistrationId: null,
organizationName: 'Recipient Company',
representativeName: 'Recipient Representative',
address: null,
businessItem: null,
businessType: null,
managers: [{email: 'recipient@example.com', name: 'Recipient Manager', telephone: null}]
},
items: [
{
date: '2026-05-27',
name: 'Corrected item',
unitPrice: null,
quantity: null,
supplyCost: 100000,
tax: 10000,
specification: null,
description: null
}
]
})
};
fetch('https://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/amend/misspell', 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://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/amend/misspell",
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([
'date' => '2026-05-27',
'purpose' => 'CLAIM',
'taxType' => 'TAXABLE',
'supplied' => [
'identificationNumber' => '0987654321',
'taxRegistrationId' => null,
'organizationName' => 'Recipient Company',
'representativeName' => 'Recipient Representative',
'address' => null,
'businessItem' => null,
'businessType' => null,
'managers' => [
[
'email' => 'recipient@example.com',
'name' => 'Recipient Manager',
'telephone' => null
]
]
],
'items' => [
[
'date' => '2026-05-27',
'name' => 'Corrected item',
'unitPrice' => null,
'quantity' => null,
'supplyCost' => 100000,
'tax' => 10000,
'specification' => null,
'description' => null
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"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://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/amend/misspell"
payload := strings.NewReader("{\n \"date\": \"2026-05-27\",\n \"purpose\": \"CLAIM\",\n \"taxType\": \"TAXABLE\",\n \"supplied\": {\n \"identificationNumber\": \"0987654321\",\n \"taxRegistrationId\": null,\n \"organizationName\": \"Recipient Company\",\n \"representativeName\": \"Recipient Representative\",\n \"address\": null,\n \"businessItem\": null,\n \"businessType\": null,\n \"managers\": [\n {\n \"email\": \"recipient@example.com\",\n \"name\": \"Recipient Manager\",\n \"telephone\": null\n }\n ]\n },\n \"items\": [\n {\n \"date\": \"2026-05-27\",\n \"name\": \"Corrected item\",\n \"unitPrice\": null,\n \"quantity\": null,\n \"supplyCost\": 100000,\n \"tax\": 10000,\n \"specification\": null,\n \"description\": null\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Basic <encoded-value>")
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://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/amend/misspell")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"date\": \"2026-05-27\",\n \"purpose\": \"CLAIM\",\n \"taxType\": \"TAXABLE\",\n \"supplied\": {\n \"identificationNumber\": \"0987654321\",\n \"taxRegistrationId\": null,\n \"organizationName\": \"Recipient Company\",\n \"representativeName\": \"Recipient Representative\",\n \"address\": null,\n \"businessItem\": null,\n \"businessType\": null,\n \"managers\": [\n {\n \"email\": \"recipient@example.com\",\n \"name\": \"Recipient Manager\",\n \"telephone\": null\n }\n ]\n },\n \"items\": [\n {\n \"date\": \"2026-05-27\",\n \"name\": \"Corrected item\",\n \"unitPrice\": null,\n \"quantity\": null,\n \"supplyCost\": 100000,\n \"tax\": 10000,\n \"specification\": null,\n \"description\": null\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/amend/misspell")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"date\": \"2026-05-27\",\n \"purpose\": \"CLAIM\",\n \"taxType\": \"TAXABLE\",\n \"supplied\": {\n \"identificationNumber\": \"0987654321\",\n \"taxRegistrationId\": null,\n \"organizationName\": \"Recipient Company\",\n \"representativeName\": \"Recipient Representative\",\n \"address\": null,\n \"businessItem\": null,\n \"businessType\": null,\n \"managers\": [\n {\n \"email\": \"recipient@example.com\",\n \"name\": \"Recipient Manager\",\n \"telephone\": null\n }\n ]\n },\n \"items\": [\n {\n \"date\": \"2026-05-27\",\n \"name\": \"Corrected item\",\n \"unitPrice\": null,\n \"quantity\": null,\n \"supplyCost\": 100000,\n \"tax\": 10000,\n \"specification\": null,\n \"description\": null\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"issuanceKey": "8D529FAD3EBAE050B79CE943CCC7CEDE",
"cancelIssuanceKey": "8D529FAD3EBAE050B79CE943CCC7CEDE"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}