Update BillV2 record
curl --request PUT \
--url https://api.dualentry.com/public/v3-alpha/bills/{record_number}/ \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"date": "2023-12-25",
"company_id": 123,
"vendor_id": 123,
"ship_from_address": {
"street": "<string>",
"city": "<string>",
"postal_code": "<string>",
"state": "",
"country": "",
"second_line": "",
"name": "<string>"
},
"ship_to_address": {
"street": "<string>",
"city": "<string>",
"postal_code": "<string>",
"state": "",
"country": "",
"second_line": "",
"name": "<string>"
},
"supply_date": "2023-12-25",
"place_of_supply": "<string>",
"tax_registration_numbers": {
"company": [
{
"type": "<string>",
"number": "<string>",
"region": "<string>"
}
],
"counterparty": [
{
"type": "<string>",
"number": "<string>",
"region": "<string>"
}
]
},
"tax_metadata": {},
"custom_fields": [
{}
],
"transaction_date": "2023-12-25",
"auto_calculate_tax": "required",
"exchange_rate": 123,
"memo": "<string>",
"items": [
{
"position": 123,
"item_id": 123,
"memo": "<string>",
"rate": 123,
"quantity": 123,
"tax": {
"code": "<string>",
"rate": 123,
"amount": 123,
"is_taxable": true,
"tax_exempt_amount": 123,
"vat_rate_id": 123,
"gst_tax_rate_id": 123,
"tax_metadata": {}
},
"is_billable": false,
"billable_customer_id": 123,
"billable_project_id": 123,
"billable_markup_pct": 500,
"id": 123,
"classifications": [],
"company_id": 123,
"custom_fields": [
{}
]
}
],
"expenses": [
{
"position": 123,
"rate": 123,
"quantity": 123,
"account_number": 123,
"expense_description": "<string>",
"tax": {
"code": "<string>",
"rate": 123,
"amount": 123,
"is_taxable": true,
"tax_exempt_amount": 123,
"vat_rate_id": 123,
"gst_tax_rate_id": 123,
"tax_metadata": {}
},
"is_billable": false,
"billable_customer_id": 123,
"billable_project_id": 123,
"billable_markup_pct": 500,
"special_tax_treatment": "IMPORT_VAT",
"id": 123,
"classifications": [],
"customer_id": 123,
"vendor_id": 123,
"company_id": 123,
"custom_fields": [
{}
]
}
],
"due_date": "2023-12-25",
"term_id": 123,
"reference_number": "",
"purchase_order_number": 123,
"attachments": [],
"record_status": "posted"
}
'import requests
url = "https://api.dualentry.com/public/v3-alpha/bills/{record_number}/"
payload = {
"date": "2023-12-25",
"company_id": 123,
"vendor_id": 123,
"ship_from_address": {
"street": "<string>",
"city": "<string>",
"postal_code": "<string>",
"state": "",
"country": "",
"second_line": "",
"name": "<string>"
},
"ship_to_address": {
"street": "<string>",
"city": "<string>",
"postal_code": "<string>",
"state": "",
"country": "",
"second_line": "",
"name": "<string>"
},
"supply_date": "2023-12-25",
"place_of_supply": "<string>",
"tax_registration_numbers": {
"company": [
{
"type": "<string>",
"number": "<string>",
"region": "<string>"
}
],
"counterparty": [
{
"type": "<string>",
"number": "<string>",
"region": "<string>"
}
]
},
"tax_metadata": {},
"custom_fields": [{}],
"transaction_date": "2023-12-25",
"auto_calculate_tax": "required",
"exchange_rate": 123,
"memo": "<string>",
"items": [
{
"position": 123,
"item_id": 123,
"memo": "<string>",
"rate": 123,
"quantity": 123,
"tax": {
"code": "<string>",
"rate": 123,
"amount": 123,
"is_taxable": True,
"tax_exempt_amount": 123,
"vat_rate_id": 123,
"gst_tax_rate_id": 123,
"tax_metadata": {}
},
"is_billable": False,
"billable_customer_id": 123,
"billable_project_id": 123,
"billable_markup_pct": 500,
"id": 123,
"classifications": [],
"company_id": 123,
"custom_fields": [{}]
}
],
"expenses": [
{
"position": 123,
"rate": 123,
"quantity": 123,
"account_number": 123,
"expense_description": "<string>",
"tax": {
"code": "<string>",
"rate": 123,
"amount": 123,
"is_taxable": True,
"tax_exempt_amount": 123,
"vat_rate_id": 123,
"gst_tax_rate_id": 123,
"tax_metadata": {}
},
"is_billable": False,
"billable_customer_id": 123,
"billable_project_id": 123,
"billable_markup_pct": 500,
"special_tax_treatment": "IMPORT_VAT",
"id": 123,
"classifications": [],
"customer_id": 123,
"vendor_id": 123,
"company_id": 123,
"custom_fields": [{}]
}
],
"due_date": "2023-12-25",
"term_id": 123,
"reference_number": "",
"purchase_order_number": 123,
"attachments": [],
"record_status": "posted"
}
headers = {
"X-API-KEY": "<api-key>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
date: '2023-12-25',
company_id: 123,
vendor_id: 123,
ship_from_address: {
street: '<string>',
city: '<string>',
postal_code: '<string>',
state: '',
country: '',
second_line: '',
name: '<string>'
},
ship_to_address: {
street: '<string>',
city: '<string>',
postal_code: '<string>',
state: '',
country: '',
second_line: '',
name: '<string>'
},
supply_date: '2023-12-25',
place_of_supply: '<string>',
tax_registration_numbers: {
company: [{type: '<string>', number: '<string>', region: '<string>'}],
counterparty: [{type: '<string>', number: '<string>', region: '<string>'}]
},
tax_metadata: {},
custom_fields: [{}],
transaction_date: '2023-12-25',
auto_calculate_tax: 'required',
exchange_rate: 123,
memo: '<string>',
items: [
{
position: 123,
item_id: 123,
memo: '<string>',
rate: 123,
quantity: 123,
tax: {
code: '<string>',
rate: 123,
amount: 123,
is_taxable: true,
tax_exempt_amount: 123,
vat_rate_id: 123,
gst_tax_rate_id: 123,
tax_metadata: {}
},
is_billable: false,
billable_customer_id: 123,
billable_project_id: 123,
billable_markup_pct: 500,
id: 123,
classifications: [],
company_id: 123,
custom_fields: [{}]
}
],
expenses: [
{
position: 123,
rate: 123,
quantity: 123,
account_number: 123,
expense_description: '<string>',
tax: {
code: '<string>',
rate: 123,
amount: 123,
is_taxable: true,
tax_exempt_amount: 123,
vat_rate_id: 123,
gst_tax_rate_id: 123,
tax_metadata: {}
},
is_billable: false,
billable_customer_id: 123,
billable_project_id: 123,
billable_markup_pct: 500,
special_tax_treatment: 'IMPORT_VAT',
id: 123,
classifications: [],
customer_id: 123,
vendor_id: 123,
company_id: 123,
custom_fields: [{}]
}
],
due_date: '2023-12-25',
term_id: 123,
reference_number: '',
purchase_order_number: 123,
attachments: [],
record_status: 'posted'
})
};
fetch('https://api.dualentry.com/public/v3-alpha/bills/{record_number}/', 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.dualentry.com/public/v3-alpha/bills/{record_number}/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'date' => '2023-12-25',
'company_id' => 123,
'vendor_id' => 123,
'ship_from_address' => [
'street' => '<string>',
'city' => '<string>',
'postal_code' => '<string>',
'state' => '',
'country' => '',
'second_line' => '',
'name' => '<string>'
],
'ship_to_address' => [
'street' => '<string>',
'city' => '<string>',
'postal_code' => '<string>',
'state' => '',
'country' => '',
'second_line' => '',
'name' => '<string>'
],
'supply_date' => '2023-12-25',
'place_of_supply' => '<string>',
'tax_registration_numbers' => [
'company' => [
[
'type' => '<string>',
'number' => '<string>',
'region' => '<string>'
]
],
'counterparty' => [
[
'type' => '<string>',
'number' => '<string>',
'region' => '<string>'
]
]
],
'tax_metadata' => [
],
'custom_fields' => [
[
]
],
'transaction_date' => '2023-12-25',
'auto_calculate_tax' => 'required',
'exchange_rate' => 123,
'memo' => '<string>',
'items' => [
[
'position' => 123,
'item_id' => 123,
'memo' => '<string>',
'rate' => 123,
'quantity' => 123,
'tax' => [
'code' => '<string>',
'rate' => 123,
'amount' => 123,
'is_taxable' => true,
'tax_exempt_amount' => 123,
'vat_rate_id' => 123,
'gst_tax_rate_id' => 123,
'tax_metadata' => [
]
],
'is_billable' => false,
'billable_customer_id' => 123,
'billable_project_id' => 123,
'billable_markup_pct' => 500,
'id' => 123,
'classifications' => [
],
'company_id' => 123,
'custom_fields' => [
[
]
]
]
],
'expenses' => [
[
'position' => 123,
'rate' => 123,
'quantity' => 123,
'account_number' => 123,
'expense_description' => '<string>',
'tax' => [
'code' => '<string>',
'rate' => 123,
'amount' => 123,
'is_taxable' => true,
'tax_exempt_amount' => 123,
'vat_rate_id' => 123,
'gst_tax_rate_id' => 123,
'tax_metadata' => [
]
],
'is_billable' => false,
'billable_customer_id' => 123,
'billable_project_id' => 123,
'billable_markup_pct' => 500,
'special_tax_treatment' => 'IMPORT_VAT',
'id' => 123,
'classifications' => [
],
'customer_id' => 123,
'vendor_id' => 123,
'company_id' => 123,
'custom_fields' => [
[
]
]
]
],
'due_date' => '2023-12-25',
'term_id' => 123,
'reference_number' => '',
'purchase_order_number' => 123,
'attachments' => [
],
'record_status' => 'posted'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-KEY: <api-key>"
],
]);
$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.dualentry.com/public/v3-alpha/bills/{record_number}/"
payload := strings.NewReader("{\n \"date\": \"2023-12-25\",\n \"company_id\": 123,\n \"vendor_id\": 123,\n \"ship_from_address\": {\n \"street\": \"<string>\",\n \"city\": \"<string>\",\n \"postal_code\": \"<string>\",\n \"state\": \"\",\n \"country\": \"\",\n \"second_line\": \"\",\n \"name\": \"<string>\"\n },\n \"ship_to_address\": {\n \"street\": \"<string>\",\n \"city\": \"<string>\",\n \"postal_code\": \"<string>\",\n \"state\": \"\",\n \"country\": \"\",\n \"second_line\": \"\",\n \"name\": \"<string>\"\n },\n \"supply_date\": \"2023-12-25\",\n \"place_of_supply\": \"<string>\",\n \"tax_registration_numbers\": {\n \"company\": [\n {\n \"type\": \"<string>\",\n \"number\": \"<string>\",\n \"region\": \"<string>\"\n }\n ],\n \"counterparty\": [\n {\n \"type\": \"<string>\",\n \"number\": \"<string>\",\n \"region\": \"<string>\"\n }\n ]\n },\n \"tax_metadata\": {},\n \"custom_fields\": [\n {}\n ],\n \"transaction_date\": \"2023-12-25\",\n \"auto_calculate_tax\": \"required\",\n \"exchange_rate\": 123,\n \"memo\": \"<string>\",\n \"items\": [\n {\n \"position\": 123,\n \"item_id\": 123,\n \"memo\": \"<string>\",\n \"rate\": 123,\n \"quantity\": 123,\n \"tax\": {\n \"code\": \"<string>\",\n \"rate\": 123,\n \"amount\": 123,\n \"is_taxable\": true,\n \"tax_exempt_amount\": 123,\n \"vat_rate_id\": 123,\n \"gst_tax_rate_id\": 123,\n \"tax_metadata\": {}\n },\n \"is_billable\": false,\n \"billable_customer_id\": 123,\n \"billable_project_id\": 123,\n \"billable_markup_pct\": 500,\n \"id\": 123,\n \"classifications\": [],\n \"company_id\": 123,\n \"custom_fields\": [\n {}\n ]\n }\n ],\n \"expenses\": [\n {\n \"position\": 123,\n \"rate\": 123,\n \"quantity\": 123,\n \"account_number\": 123,\n \"expense_description\": \"<string>\",\n \"tax\": {\n \"code\": \"<string>\",\n \"rate\": 123,\n \"amount\": 123,\n \"is_taxable\": true,\n \"tax_exempt_amount\": 123,\n \"vat_rate_id\": 123,\n \"gst_tax_rate_id\": 123,\n \"tax_metadata\": {}\n },\n \"is_billable\": false,\n \"billable_customer_id\": 123,\n \"billable_project_id\": 123,\n \"billable_markup_pct\": 500,\n \"special_tax_treatment\": \"IMPORT_VAT\",\n \"id\": 123,\n \"classifications\": [],\n \"customer_id\": 123,\n \"vendor_id\": 123,\n \"company_id\": 123,\n \"custom_fields\": [\n {}\n ]\n }\n ],\n \"due_date\": \"2023-12-25\",\n \"term_id\": 123,\n \"reference_number\": \"\",\n \"purchase_order_number\": 123,\n \"attachments\": [],\n \"record_status\": \"posted\"\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("X-API-KEY", "<api-key>")
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.put("https://api.dualentry.com/public/v3-alpha/bills/{record_number}/")
.header("X-API-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"date\": \"2023-12-25\",\n \"company_id\": 123,\n \"vendor_id\": 123,\n \"ship_from_address\": {\n \"street\": \"<string>\",\n \"city\": \"<string>\",\n \"postal_code\": \"<string>\",\n \"state\": \"\",\n \"country\": \"\",\n \"second_line\": \"\",\n \"name\": \"<string>\"\n },\n \"ship_to_address\": {\n \"street\": \"<string>\",\n \"city\": \"<string>\",\n \"postal_code\": \"<string>\",\n \"state\": \"\",\n \"country\": \"\",\n \"second_line\": \"\",\n \"name\": \"<string>\"\n },\n \"supply_date\": \"2023-12-25\",\n \"place_of_supply\": \"<string>\",\n \"tax_registration_numbers\": {\n \"company\": [\n {\n \"type\": \"<string>\",\n \"number\": \"<string>\",\n \"region\": \"<string>\"\n }\n ],\n \"counterparty\": [\n {\n \"type\": \"<string>\",\n \"number\": \"<string>\",\n \"region\": \"<string>\"\n }\n ]\n },\n \"tax_metadata\": {},\n \"custom_fields\": [\n {}\n ],\n \"transaction_date\": \"2023-12-25\",\n \"auto_calculate_tax\": \"required\",\n \"exchange_rate\": 123,\n \"memo\": \"<string>\",\n \"items\": [\n {\n \"position\": 123,\n \"item_id\": 123,\n \"memo\": \"<string>\",\n \"rate\": 123,\n \"quantity\": 123,\n \"tax\": {\n \"code\": \"<string>\",\n \"rate\": 123,\n \"amount\": 123,\n \"is_taxable\": true,\n \"tax_exempt_amount\": 123,\n \"vat_rate_id\": 123,\n \"gst_tax_rate_id\": 123,\n \"tax_metadata\": {}\n },\n \"is_billable\": false,\n \"billable_customer_id\": 123,\n \"billable_project_id\": 123,\n \"billable_markup_pct\": 500,\n \"id\": 123,\n \"classifications\": [],\n \"company_id\": 123,\n \"custom_fields\": [\n {}\n ]\n }\n ],\n \"expenses\": [\n {\n \"position\": 123,\n \"rate\": 123,\n \"quantity\": 123,\n \"account_number\": 123,\n \"expense_description\": \"<string>\",\n \"tax\": {\n \"code\": \"<string>\",\n \"rate\": 123,\n \"amount\": 123,\n \"is_taxable\": true,\n \"tax_exempt_amount\": 123,\n \"vat_rate_id\": 123,\n \"gst_tax_rate_id\": 123,\n \"tax_metadata\": {}\n },\n \"is_billable\": false,\n \"billable_customer_id\": 123,\n \"billable_project_id\": 123,\n \"billable_markup_pct\": 500,\n \"special_tax_treatment\": \"IMPORT_VAT\",\n \"id\": 123,\n \"classifications\": [],\n \"customer_id\": 123,\n \"vendor_id\": 123,\n \"company_id\": 123,\n \"custom_fields\": [\n {}\n ]\n }\n ],\n \"due_date\": \"2023-12-25\",\n \"term_id\": 123,\n \"reference_number\": \"\",\n \"purchase_order_number\": 123,\n \"attachments\": [],\n \"record_status\": \"posted\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.dualentry.com/public/v3-alpha/bills/{record_number}/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"date\": \"2023-12-25\",\n \"company_id\": 123,\n \"vendor_id\": 123,\n \"ship_from_address\": {\n \"street\": \"<string>\",\n \"city\": \"<string>\",\n \"postal_code\": \"<string>\",\n \"state\": \"\",\n \"country\": \"\",\n \"second_line\": \"\",\n \"name\": \"<string>\"\n },\n \"ship_to_address\": {\n \"street\": \"<string>\",\n \"city\": \"<string>\",\n \"postal_code\": \"<string>\",\n \"state\": \"\",\n \"country\": \"\",\n \"second_line\": \"\",\n \"name\": \"<string>\"\n },\n \"supply_date\": \"2023-12-25\",\n \"place_of_supply\": \"<string>\",\n \"tax_registration_numbers\": {\n \"company\": [\n {\n \"type\": \"<string>\",\n \"number\": \"<string>\",\n \"region\": \"<string>\"\n }\n ],\n \"counterparty\": [\n {\n \"type\": \"<string>\",\n \"number\": \"<string>\",\n \"region\": \"<string>\"\n }\n ]\n },\n \"tax_metadata\": {},\n \"custom_fields\": [\n {}\n ],\n \"transaction_date\": \"2023-12-25\",\n \"auto_calculate_tax\": \"required\",\n \"exchange_rate\": 123,\n \"memo\": \"<string>\",\n \"items\": [\n {\n \"position\": 123,\n \"item_id\": 123,\n \"memo\": \"<string>\",\n \"rate\": 123,\n \"quantity\": 123,\n \"tax\": {\n \"code\": \"<string>\",\n \"rate\": 123,\n \"amount\": 123,\n \"is_taxable\": true,\n \"tax_exempt_amount\": 123,\n \"vat_rate_id\": 123,\n \"gst_tax_rate_id\": 123,\n \"tax_metadata\": {}\n },\n \"is_billable\": false,\n \"billable_customer_id\": 123,\n \"billable_project_id\": 123,\n \"billable_markup_pct\": 500,\n \"id\": 123,\n \"classifications\": [],\n \"company_id\": 123,\n \"custom_fields\": [\n {}\n ]\n }\n ],\n \"expenses\": [\n {\n \"position\": 123,\n \"rate\": 123,\n \"quantity\": 123,\n \"account_number\": 123,\n \"expense_description\": \"<string>\",\n \"tax\": {\n \"code\": \"<string>\",\n \"rate\": 123,\n \"amount\": 123,\n \"is_taxable\": true,\n \"tax_exempt_amount\": 123,\n \"vat_rate_id\": 123,\n \"gst_tax_rate_id\": 123,\n \"tax_metadata\": {}\n },\n \"is_billable\": false,\n \"billable_customer_id\": 123,\n \"billable_project_id\": 123,\n \"billable_markup_pct\": 500,\n \"special_tax_treatment\": \"IMPORT_VAT\",\n \"id\": 123,\n \"classifications\": [],\n \"customer_id\": 123,\n \"vendor_id\": 123,\n \"company_id\": 123,\n \"custom_fields\": [\n {}\n ]\n }\n ],\n \"due_date\": \"2023-12-25\",\n \"term_id\": 123,\n \"reference_number\": \"\",\n \"purchase_order_number\": 123,\n \"attachments\": [],\n \"record_status\": \"posted\"\n}"
response = http.request(request)
puts response.read_body{
"supply_date": "2023-12-25",
"tax": {
"regime": "SALES_TAX",
"data": {}
},
"transaction_ids": [
123
],
"term_id": 123,
"term_name": "<string>",
"internal_id": 123,
"number": 123,
"date": "2023-12-25",
"transaction_date": "2023-12-25",
"due_date": "2023-12-25",
"company_id": 123,
"company_name": "<string>",
"company_currency": "<string>",
"vendor_id": 123,
"vendor_name": "<string>",
"currency_iso_4217_code": "AED",
"exchange_rate": "<string>",
"memo": "<string>",
"amount": "<string>",
"amount_due": "<string>",
"paid_total": "<string>",
"record_status": "draft",
"recurring_record_number": 123,
"purchase_order_number": 123,
"reference_number": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"custom_fields": [],
"ship_from_address": {
"street": "<string>",
"city": "<string>",
"postal_code": "<string>",
"state": "",
"country": "",
"second_line": "",
"name": "<string>"
},
"ship_to_address": {
"street": "<string>",
"city": "<string>",
"postal_code": "<string>",
"state": "",
"country": "",
"second_line": "",
"name": "<string>"
},
"place_of_supply": "<string>",
"tax_registration_numbers": {
"company": [
{
"type": "<string>",
"number": "<string>",
"region": "<string>"
}
],
"counterparty": [
{
"type": "<string>",
"number": "<string>",
"region": "<string>"
}
]
},
"tax_metadata": {},
"attachments": [],
"bank_match_status": "<string>",
"reconciliation_status": "<string>",
"created_by": {
"actor_type": "<string>",
"email": "<string>",
"first_name": "<string>",
"last_name": "<string>",
"via": "<string>",
"agent_id": 123,
"agent_name": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
},
"updated_by": {
"actor_type": "<string>",
"email": "<string>",
"first_name": "<string>",
"last_name": "<string>",
"via": "<string>",
"agent_id": 123,
"agent_name": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
},
"approval_status": "<string>",
"next_approvers": [
{
"id": 123,
"first_name": "<string>",
"last_name": "<string>",
"email": "<string>",
"full_name": "<string>",
"avatar_url": "<string>"
}
],
"rejected_by": {
"id": 123,
"first_name": "<string>",
"last_name": "<string>",
"email": "<string>",
"full_name": "<string>",
"rejection_reason": "<string>"
},
"code": "<string>",
"items": [],
"expenses": [],
"items_has_more": false,
"items_count": 0,
"expenses_has_more": false,
"expenses_count": 0
}{
"errors": {},
"success": false,
"error_code": "<string>",
"error_reason": "<string>"
}{
"errors": {},
"success": false,
"error_code": "<string>",
"error_reason": "<string>"
}{
"errors": {},
"success": false,
"error_code": "<string>",
"error_reason": "<string>"
}{
"errors": {},
"success": false,
"error_code": "<string>",
"error_reason": "<string>"
}{
"errors": {},
"success": false,
"error_code": "<string>",
"error_reason": "<string>"
}Bills
Update BillV2 record
Update an existing BillV2 record with the provided data. Validates all required fields and business rules.
Side effects
- If an approval workflow matches this request, DualEntry can set
record_statusback todraft.
Additional validations
- Fails with
503if the exchange rate for the transaction date is unavailable. - Fails with
422and the error codeposting_date_after_limitifdateis after the latest posting date that your organization allows. - Fails with
422anderror_codetax_not_calculatedwhen the organization uses manual tax mode with the tax reminder on, the request posts the record, and the request sends lines but none of them carriestax. Setauto_calculate_taxtorequired, or sendtaxon the lines. - Fails with
422if you set an inactive, archived, or draft customer or vendor, or an inactive company. - Fails with
422if a line account is not available to the record’s company. - Fails with
422if you set the customer or vendor that stands for the record’s own company as a party. - A reference that the record or its linked source record already holds passes these checks.
PUT
/
public
/
v3-alpha
/
bills
/
{record_number}
/
Update BillV2 record
curl --request PUT \
--url https://api.dualentry.com/public/v3-alpha/bills/{record_number}/ \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"date": "2023-12-25",
"company_id": 123,
"vendor_id": 123,
"ship_from_address": {
"street": "<string>",
"city": "<string>",
"postal_code": "<string>",
"state": "",
"country": "",
"second_line": "",
"name": "<string>"
},
"ship_to_address": {
"street": "<string>",
"city": "<string>",
"postal_code": "<string>",
"state": "",
"country": "",
"second_line": "",
"name": "<string>"
},
"supply_date": "2023-12-25",
"place_of_supply": "<string>",
"tax_registration_numbers": {
"company": [
{
"type": "<string>",
"number": "<string>",
"region": "<string>"
}
],
"counterparty": [
{
"type": "<string>",
"number": "<string>",
"region": "<string>"
}
]
},
"tax_metadata": {},
"custom_fields": [
{}
],
"transaction_date": "2023-12-25",
"auto_calculate_tax": "required",
"exchange_rate": 123,
"memo": "<string>",
"items": [
{
"position": 123,
"item_id": 123,
"memo": "<string>",
"rate": 123,
"quantity": 123,
"tax": {
"code": "<string>",
"rate": 123,
"amount": 123,
"is_taxable": true,
"tax_exempt_amount": 123,
"vat_rate_id": 123,
"gst_tax_rate_id": 123,
"tax_metadata": {}
},
"is_billable": false,
"billable_customer_id": 123,
"billable_project_id": 123,
"billable_markup_pct": 500,
"id": 123,
"classifications": [],
"company_id": 123,
"custom_fields": [
{}
]
}
],
"expenses": [
{
"position": 123,
"rate": 123,
"quantity": 123,
"account_number": 123,
"expense_description": "<string>",
"tax": {
"code": "<string>",
"rate": 123,
"amount": 123,
"is_taxable": true,
"tax_exempt_amount": 123,
"vat_rate_id": 123,
"gst_tax_rate_id": 123,
"tax_metadata": {}
},
"is_billable": false,
"billable_customer_id": 123,
"billable_project_id": 123,
"billable_markup_pct": 500,
"special_tax_treatment": "IMPORT_VAT",
"id": 123,
"classifications": [],
"customer_id": 123,
"vendor_id": 123,
"company_id": 123,
"custom_fields": [
{}
]
}
],
"due_date": "2023-12-25",
"term_id": 123,
"reference_number": "",
"purchase_order_number": 123,
"attachments": [],
"record_status": "posted"
}
'import requests
url = "https://api.dualentry.com/public/v3-alpha/bills/{record_number}/"
payload = {
"date": "2023-12-25",
"company_id": 123,
"vendor_id": 123,
"ship_from_address": {
"street": "<string>",
"city": "<string>",
"postal_code": "<string>",
"state": "",
"country": "",
"second_line": "",
"name": "<string>"
},
"ship_to_address": {
"street": "<string>",
"city": "<string>",
"postal_code": "<string>",
"state": "",
"country": "",
"second_line": "",
"name": "<string>"
},
"supply_date": "2023-12-25",
"place_of_supply": "<string>",
"tax_registration_numbers": {
"company": [
{
"type": "<string>",
"number": "<string>",
"region": "<string>"
}
],
"counterparty": [
{
"type": "<string>",
"number": "<string>",
"region": "<string>"
}
]
},
"tax_metadata": {},
"custom_fields": [{}],
"transaction_date": "2023-12-25",
"auto_calculate_tax": "required",
"exchange_rate": 123,
"memo": "<string>",
"items": [
{
"position": 123,
"item_id": 123,
"memo": "<string>",
"rate": 123,
"quantity": 123,
"tax": {
"code": "<string>",
"rate": 123,
"amount": 123,
"is_taxable": True,
"tax_exempt_amount": 123,
"vat_rate_id": 123,
"gst_tax_rate_id": 123,
"tax_metadata": {}
},
"is_billable": False,
"billable_customer_id": 123,
"billable_project_id": 123,
"billable_markup_pct": 500,
"id": 123,
"classifications": [],
"company_id": 123,
"custom_fields": [{}]
}
],
"expenses": [
{
"position": 123,
"rate": 123,
"quantity": 123,
"account_number": 123,
"expense_description": "<string>",
"tax": {
"code": "<string>",
"rate": 123,
"amount": 123,
"is_taxable": True,
"tax_exempt_amount": 123,
"vat_rate_id": 123,
"gst_tax_rate_id": 123,
"tax_metadata": {}
},
"is_billable": False,
"billable_customer_id": 123,
"billable_project_id": 123,
"billable_markup_pct": 500,
"special_tax_treatment": "IMPORT_VAT",
"id": 123,
"classifications": [],
"customer_id": 123,
"vendor_id": 123,
"company_id": 123,
"custom_fields": [{}]
}
],
"due_date": "2023-12-25",
"term_id": 123,
"reference_number": "",
"purchase_order_number": 123,
"attachments": [],
"record_status": "posted"
}
headers = {
"X-API-KEY": "<api-key>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
date: '2023-12-25',
company_id: 123,
vendor_id: 123,
ship_from_address: {
street: '<string>',
city: '<string>',
postal_code: '<string>',
state: '',
country: '',
second_line: '',
name: '<string>'
},
ship_to_address: {
street: '<string>',
city: '<string>',
postal_code: '<string>',
state: '',
country: '',
second_line: '',
name: '<string>'
},
supply_date: '2023-12-25',
place_of_supply: '<string>',
tax_registration_numbers: {
company: [{type: '<string>', number: '<string>', region: '<string>'}],
counterparty: [{type: '<string>', number: '<string>', region: '<string>'}]
},
tax_metadata: {},
custom_fields: [{}],
transaction_date: '2023-12-25',
auto_calculate_tax: 'required',
exchange_rate: 123,
memo: '<string>',
items: [
{
position: 123,
item_id: 123,
memo: '<string>',
rate: 123,
quantity: 123,
tax: {
code: '<string>',
rate: 123,
amount: 123,
is_taxable: true,
tax_exempt_amount: 123,
vat_rate_id: 123,
gst_tax_rate_id: 123,
tax_metadata: {}
},
is_billable: false,
billable_customer_id: 123,
billable_project_id: 123,
billable_markup_pct: 500,
id: 123,
classifications: [],
company_id: 123,
custom_fields: [{}]
}
],
expenses: [
{
position: 123,
rate: 123,
quantity: 123,
account_number: 123,
expense_description: '<string>',
tax: {
code: '<string>',
rate: 123,
amount: 123,
is_taxable: true,
tax_exempt_amount: 123,
vat_rate_id: 123,
gst_tax_rate_id: 123,
tax_metadata: {}
},
is_billable: false,
billable_customer_id: 123,
billable_project_id: 123,
billable_markup_pct: 500,
special_tax_treatment: 'IMPORT_VAT',
id: 123,
classifications: [],
customer_id: 123,
vendor_id: 123,
company_id: 123,
custom_fields: [{}]
}
],
due_date: '2023-12-25',
term_id: 123,
reference_number: '',
purchase_order_number: 123,
attachments: [],
record_status: 'posted'
})
};
fetch('https://api.dualentry.com/public/v3-alpha/bills/{record_number}/', 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.dualentry.com/public/v3-alpha/bills/{record_number}/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'date' => '2023-12-25',
'company_id' => 123,
'vendor_id' => 123,
'ship_from_address' => [
'street' => '<string>',
'city' => '<string>',
'postal_code' => '<string>',
'state' => '',
'country' => '',
'second_line' => '',
'name' => '<string>'
],
'ship_to_address' => [
'street' => '<string>',
'city' => '<string>',
'postal_code' => '<string>',
'state' => '',
'country' => '',
'second_line' => '',
'name' => '<string>'
],
'supply_date' => '2023-12-25',
'place_of_supply' => '<string>',
'tax_registration_numbers' => [
'company' => [
[
'type' => '<string>',
'number' => '<string>',
'region' => '<string>'
]
],
'counterparty' => [
[
'type' => '<string>',
'number' => '<string>',
'region' => '<string>'
]
]
],
'tax_metadata' => [
],
'custom_fields' => [
[
]
],
'transaction_date' => '2023-12-25',
'auto_calculate_tax' => 'required',
'exchange_rate' => 123,
'memo' => '<string>',
'items' => [
[
'position' => 123,
'item_id' => 123,
'memo' => '<string>',
'rate' => 123,
'quantity' => 123,
'tax' => [
'code' => '<string>',
'rate' => 123,
'amount' => 123,
'is_taxable' => true,
'tax_exempt_amount' => 123,
'vat_rate_id' => 123,
'gst_tax_rate_id' => 123,
'tax_metadata' => [
]
],
'is_billable' => false,
'billable_customer_id' => 123,
'billable_project_id' => 123,
'billable_markup_pct' => 500,
'id' => 123,
'classifications' => [
],
'company_id' => 123,
'custom_fields' => [
[
]
]
]
],
'expenses' => [
[
'position' => 123,
'rate' => 123,
'quantity' => 123,
'account_number' => 123,
'expense_description' => '<string>',
'tax' => [
'code' => '<string>',
'rate' => 123,
'amount' => 123,
'is_taxable' => true,
'tax_exempt_amount' => 123,
'vat_rate_id' => 123,
'gst_tax_rate_id' => 123,
'tax_metadata' => [
]
],
'is_billable' => false,
'billable_customer_id' => 123,
'billable_project_id' => 123,
'billable_markup_pct' => 500,
'special_tax_treatment' => 'IMPORT_VAT',
'id' => 123,
'classifications' => [
],
'customer_id' => 123,
'vendor_id' => 123,
'company_id' => 123,
'custom_fields' => [
[
]
]
]
],
'due_date' => '2023-12-25',
'term_id' => 123,
'reference_number' => '',
'purchase_order_number' => 123,
'attachments' => [
],
'record_status' => 'posted'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-KEY: <api-key>"
],
]);
$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.dualentry.com/public/v3-alpha/bills/{record_number}/"
payload := strings.NewReader("{\n \"date\": \"2023-12-25\",\n \"company_id\": 123,\n \"vendor_id\": 123,\n \"ship_from_address\": {\n \"street\": \"<string>\",\n \"city\": \"<string>\",\n \"postal_code\": \"<string>\",\n \"state\": \"\",\n \"country\": \"\",\n \"second_line\": \"\",\n \"name\": \"<string>\"\n },\n \"ship_to_address\": {\n \"street\": \"<string>\",\n \"city\": \"<string>\",\n \"postal_code\": \"<string>\",\n \"state\": \"\",\n \"country\": \"\",\n \"second_line\": \"\",\n \"name\": \"<string>\"\n },\n \"supply_date\": \"2023-12-25\",\n \"place_of_supply\": \"<string>\",\n \"tax_registration_numbers\": {\n \"company\": [\n {\n \"type\": \"<string>\",\n \"number\": \"<string>\",\n \"region\": \"<string>\"\n }\n ],\n \"counterparty\": [\n {\n \"type\": \"<string>\",\n \"number\": \"<string>\",\n \"region\": \"<string>\"\n }\n ]\n },\n \"tax_metadata\": {},\n \"custom_fields\": [\n {}\n ],\n \"transaction_date\": \"2023-12-25\",\n \"auto_calculate_tax\": \"required\",\n \"exchange_rate\": 123,\n \"memo\": \"<string>\",\n \"items\": [\n {\n \"position\": 123,\n \"item_id\": 123,\n \"memo\": \"<string>\",\n \"rate\": 123,\n \"quantity\": 123,\n \"tax\": {\n \"code\": \"<string>\",\n \"rate\": 123,\n \"amount\": 123,\n \"is_taxable\": true,\n \"tax_exempt_amount\": 123,\n \"vat_rate_id\": 123,\n \"gst_tax_rate_id\": 123,\n \"tax_metadata\": {}\n },\n \"is_billable\": false,\n \"billable_customer_id\": 123,\n \"billable_project_id\": 123,\n \"billable_markup_pct\": 500,\n \"id\": 123,\n \"classifications\": [],\n \"company_id\": 123,\n \"custom_fields\": [\n {}\n ]\n }\n ],\n \"expenses\": [\n {\n \"position\": 123,\n \"rate\": 123,\n \"quantity\": 123,\n \"account_number\": 123,\n \"expense_description\": \"<string>\",\n \"tax\": {\n \"code\": \"<string>\",\n \"rate\": 123,\n \"amount\": 123,\n \"is_taxable\": true,\n \"tax_exempt_amount\": 123,\n \"vat_rate_id\": 123,\n \"gst_tax_rate_id\": 123,\n \"tax_metadata\": {}\n },\n \"is_billable\": false,\n \"billable_customer_id\": 123,\n \"billable_project_id\": 123,\n \"billable_markup_pct\": 500,\n \"special_tax_treatment\": \"IMPORT_VAT\",\n \"id\": 123,\n \"classifications\": [],\n \"customer_id\": 123,\n \"vendor_id\": 123,\n \"company_id\": 123,\n \"custom_fields\": [\n {}\n ]\n }\n ],\n \"due_date\": \"2023-12-25\",\n \"term_id\": 123,\n \"reference_number\": \"\",\n \"purchase_order_number\": 123,\n \"attachments\": [],\n \"record_status\": \"posted\"\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("X-API-KEY", "<api-key>")
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.put("https://api.dualentry.com/public/v3-alpha/bills/{record_number}/")
.header("X-API-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"date\": \"2023-12-25\",\n \"company_id\": 123,\n \"vendor_id\": 123,\n \"ship_from_address\": {\n \"street\": \"<string>\",\n \"city\": \"<string>\",\n \"postal_code\": \"<string>\",\n \"state\": \"\",\n \"country\": \"\",\n \"second_line\": \"\",\n \"name\": \"<string>\"\n },\n \"ship_to_address\": {\n \"street\": \"<string>\",\n \"city\": \"<string>\",\n \"postal_code\": \"<string>\",\n \"state\": \"\",\n \"country\": \"\",\n \"second_line\": \"\",\n \"name\": \"<string>\"\n },\n \"supply_date\": \"2023-12-25\",\n \"place_of_supply\": \"<string>\",\n \"tax_registration_numbers\": {\n \"company\": [\n {\n \"type\": \"<string>\",\n \"number\": \"<string>\",\n \"region\": \"<string>\"\n }\n ],\n \"counterparty\": [\n {\n \"type\": \"<string>\",\n \"number\": \"<string>\",\n \"region\": \"<string>\"\n }\n ]\n },\n \"tax_metadata\": {},\n \"custom_fields\": [\n {}\n ],\n \"transaction_date\": \"2023-12-25\",\n \"auto_calculate_tax\": \"required\",\n \"exchange_rate\": 123,\n \"memo\": \"<string>\",\n \"items\": [\n {\n \"position\": 123,\n \"item_id\": 123,\n \"memo\": \"<string>\",\n \"rate\": 123,\n \"quantity\": 123,\n \"tax\": {\n \"code\": \"<string>\",\n \"rate\": 123,\n \"amount\": 123,\n \"is_taxable\": true,\n \"tax_exempt_amount\": 123,\n \"vat_rate_id\": 123,\n \"gst_tax_rate_id\": 123,\n \"tax_metadata\": {}\n },\n \"is_billable\": false,\n \"billable_customer_id\": 123,\n \"billable_project_id\": 123,\n \"billable_markup_pct\": 500,\n \"id\": 123,\n \"classifications\": [],\n \"company_id\": 123,\n \"custom_fields\": [\n {}\n ]\n }\n ],\n \"expenses\": [\n {\n \"position\": 123,\n \"rate\": 123,\n \"quantity\": 123,\n \"account_number\": 123,\n \"expense_description\": \"<string>\",\n \"tax\": {\n \"code\": \"<string>\",\n \"rate\": 123,\n \"amount\": 123,\n \"is_taxable\": true,\n \"tax_exempt_amount\": 123,\n \"vat_rate_id\": 123,\n \"gst_tax_rate_id\": 123,\n \"tax_metadata\": {}\n },\n \"is_billable\": false,\n \"billable_customer_id\": 123,\n \"billable_project_id\": 123,\n \"billable_markup_pct\": 500,\n \"special_tax_treatment\": \"IMPORT_VAT\",\n \"id\": 123,\n \"classifications\": [],\n \"customer_id\": 123,\n \"vendor_id\": 123,\n \"company_id\": 123,\n \"custom_fields\": [\n {}\n ]\n }\n ],\n \"due_date\": \"2023-12-25\",\n \"term_id\": 123,\n \"reference_number\": \"\",\n \"purchase_order_number\": 123,\n \"attachments\": [],\n \"record_status\": \"posted\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.dualentry.com/public/v3-alpha/bills/{record_number}/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"date\": \"2023-12-25\",\n \"company_id\": 123,\n \"vendor_id\": 123,\n \"ship_from_address\": {\n \"street\": \"<string>\",\n \"city\": \"<string>\",\n \"postal_code\": \"<string>\",\n \"state\": \"\",\n \"country\": \"\",\n \"second_line\": \"\",\n \"name\": \"<string>\"\n },\n \"ship_to_address\": {\n \"street\": \"<string>\",\n \"city\": \"<string>\",\n \"postal_code\": \"<string>\",\n \"state\": \"\",\n \"country\": \"\",\n \"second_line\": \"\",\n \"name\": \"<string>\"\n },\n \"supply_date\": \"2023-12-25\",\n \"place_of_supply\": \"<string>\",\n \"tax_registration_numbers\": {\n \"company\": [\n {\n \"type\": \"<string>\",\n \"number\": \"<string>\",\n \"region\": \"<string>\"\n }\n ],\n \"counterparty\": [\n {\n \"type\": \"<string>\",\n \"number\": \"<string>\",\n \"region\": \"<string>\"\n }\n ]\n },\n \"tax_metadata\": {},\n \"custom_fields\": [\n {}\n ],\n \"transaction_date\": \"2023-12-25\",\n \"auto_calculate_tax\": \"required\",\n \"exchange_rate\": 123,\n \"memo\": \"<string>\",\n \"items\": [\n {\n \"position\": 123,\n \"item_id\": 123,\n \"memo\": \"<string>\",\n \"rate\": 123,\n \"quantity\": 123,\n \"tax\": {\n \"code\": \"<string>\",\n \"rate\": 123,\n \"amount\": 123,\n \"is_taxable\": true,\n \"tax_exempt_amount\": 123,\n \"vat_rate_id\": 123,\n \"gst_tax_rate_id\": 123,\n \"tax_metadata\": {}\n },\n \"is_billable\": false,\n \"billable_customer_id\": 123,\n \"billable_project_id\": 123,\n \"billable_markup_pct\": 500,\n \"id\": 123,\n \"classifications\": [],\n \"company_id\": 123,\n \"custom_fields\": [\n {}\n ]\n }\n ],\n \"expenses\": [\n {\n \"position\": 123,\n \"rate\": 123,\n \"quantity\": 123,\n \"account_number\": 123,\n \"expense_description\": \"<string>\",\n \"tax\": {\n \"code\": \"<string>\",\n \"rate\": 123,\n \"amount\": 123,\n \"is_taxable\": true,\n \"tax_exempt_amount\": 123,\n \"vat_rate_id\": 123,\n \"gst_tax_rate_id\": 123,\n \"tax_metadata\": {}\n },\n \"is_billable\": false,\n \"billable_customer_id\": 123,\n \"billable_project_id\": 123,\n \"billable_markup_pct\": 500,\n \"special_tax_treatment\": \"IMPORT_VAT\",\n \"id\": 123,\n \"classifications\": [],\n \"customer_id\": 123,\n \"vendor_id\": 123,\n \"company_id\": 123,\n \"custom_fields\": [\n {}\n ]\n }\n ],\n \"due_date\": \"2023-12-25\",\n \"term_id\": 123,\n \"reference_number\": \"\",\n \"purchase_order_number\": 123,\n \"attachments\": [],\n \"record_status\": \"posted\"\n}"
response = http.request(request)
puts response.read_body{
"supply_date": "2023-12-25",
"tax": {
"regime": "SALES_TAX",
"data": {}
},
"transaction_ids": [
123
],
"term_id": 123,
"term_name": "<string>",
"internal_id": 123,
"number": 123,
"date": "2023-12-25",
"transaction_date": "2023-12-25",
"due_date": "2023-12-25",
"company_id": 123,
"company_name": "<string>",
"company_currency": "<string>",
"vendor_id": 123,
"vendor_name": "<string>",
"currency_iso_4217_code": "AED",
"exchange_rate": "<string>",
"memo": "<string>",
"amount": "<string>",
"amount_due": "<string>",
"paid_total": "<string>",
"record_status": "draft",
"recurring_record_number": 123,
"purchase_order_number": 123,
"reference_number": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"custom_fields": [],
"ship_from_address": {
"street": "<string>",
"city": "<string>",
"postal_code": "<string>",
"state": "",
"country": "",
"second_line": "",
"name": "<string>"
},
"ship_to_address": {
"street": "<string>",
"city": "<string>",
"postal_code": "<string>",
"state": "",
"country": "",
"second_line": "",
"name": "<string>"
},
"place_of_supply": "<string>",
"tax_registration_numbers": {
"company": [
{
"type": "<string>",
"number": "<string>",
"region": "<string>"
}
],
"counterparty": [
{
"type": "<string>",
"number": "<string>",
"region": "<string>"
}
]
},
"tax_metadata": {},
"attachments": [],
"bank_match_status": "<string>",
"reconciliation_status": "<string>",
"created_by": {
"actor_type": "<string>",
"email": "<string>",
"first_name": "<string>",
"last_name": "<string>",
"via": "<string>",
"agent_id": 123,
"agent_name": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
},
"updated_by": {
"actor_type": "<string>",
"email": "<string>",
"first_name": "<string>",
"last_name": "<string>",
"via": "<string>",
"agent_id": 123,
"agent_name": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
},
"approval_status": "<string>",
"next_approvers": [
{
"id": 123,
"first_name": "<string>",
"last_name": "<string>",
"email": "<string>",
"full_name": "<string>",
"avatar_url": "<string>"
}
],
"rejected_by": {
"id": 123,
"first_name": "<string>",
"last_name": "<string>",
"email": "<string>",
"full_name": "<string>",
"rejection_reason": "<string>"
},
"code": "<string>",
"items": [],
"expenses": [],
"items_has_more": false,
"items_count": 0,
"expenses_has_more": false,
"expenses_count": 0
}{
"errors": {},
"success": false,
"error_code": "<string>",
"error_reason": "<string>"
}{
"errors": {},
"success": false,
"error_code": "<string>",
"error_reason": "<string>"
}{
"errors": {},
"success": false,
"error_code": "<string>",
"error_reason": "<string>"
}{
"errors": {},
"success": false,
"error_code": "<string>",
"error_reason": "<string>"
}{
"errors": {},
"success": false,
"error_code": "<string>",
"error_reason": "<string>"
}Authorizations
Headers
Optional. A unique value (a UUID works well) identifying this operation. If the request is repeated with the same key, the original response is replayed instead of the operation running again, so a retry cannot create a duplicate record. Results are replayable for 48 hours. Reusing a key with a different request body returns 422.
Maximum string length:
255Path Parameters
The number attribute of the record.
Body
application/json
If this vendor is intercompany, DualEntry also writes a transaction in the elimination company.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Tax point date for VAT and GST.
When the saved record uses a VAT or GST tax regime and you omit this field, DualEntry sets it to transaction_date, or to date when there is no transaction_date.
Recurring templates store the value you send. Each generated record that uses VAT or GST and has no supply date gets that default on save.
On PATCH, an omitted field keeps the stored value. Send supply_date again when you change date or transaction_date.
Maximum string length:
2Show child attributes
Show child attributes
Show child attributes
Show child attributes
Configures how to handle automatic tax calculations.
If auto_calculate_tax is unset, the tax you send on each line is stored. Set it to required to have DualEntry calculate the tax, replacing the tax on every line before it saves the record.
The calculation covers native US sales tax using DualEntry's tax engine. It also covers Avalara US sales tax, VAT, and GST.
- For native VAT and GST, leave this field unset and send the rate and the tax on each line. Set it to
requiredwhen a tax provider returns the tax. - The request fails with
422when the result is DualEntry's own VAT or GST, when the calculation cannot finish, or when a required address is still missing. - When the record has a customer, DualEntry reads
shipping_address, thenbilling_address, then the address saved on the customer. - If you send neither address, DualEntry copies the customer's saved address to
billing_addressandshipping_address. - When the record has a vendor, DualEntry reads
ship_from_addressandship_to_address, then the addresses saved on the vendor and the company. - DualEntry stores only the ship addresses you sent.
Available options:
required Available options:
AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN, BWP, BYN, BZD, CAD, CDF, CHF, CLF, CLP, CNY, COP, CRC, CUP, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ERN, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HTG, HUF, IDR, ILS, INR, IQD, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRU, MUR, MVR, MWK, MXN, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLL, SOS, SRD, STN, SVC, SYP, SZL, THB, TJS, TMT, TND, TOP, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VES, VND, VUV, WST, XAF, XAG, XAU, XCD, XDR, XOF, XPD, XPF, XPT, YER, ZAR, ZMW, ZWL If you omit this field or send null, DualEntry calculates the rate from the company base currency, the transaction currency, and the transaction date. A date of today or later uses the rate for yesterday (UTC). A rate you send is stored, including 1.0.
Maximum string length:
512Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Available options:
draft, posted, archived Response
OK
Base for record-level tax context; regime discriminates data.
Mirrors TaxResultV2Out (core.taxes.api.taxes)
Show child attributes
Show child attributes
Posting date (GL date) - the date when the transaction is recorded in the general ledger
Transaction date (inception date) - the date when the transaction actually occurred
Available options:
AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN, BWP, BYN, BZD, CAD, CDF, CHF, CLF, CLP, CNY, COP, CRC, CUP, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ERN, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HTG, HUF, IDR, ILS, INR, IQD, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRU, MUR, MVR, MWK, MXN, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLL, SOS, SRD, STN, SVC, SYP, SZL, THB, TJS, TMT, TND, TOP, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VES, VND, VUV, WST, XAF, XAG, XAU, XCD, XDR, XOF, XPD, XPF, XPT, YER, ZAR, ZMW, ZWL Pattern:
^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,16}0*$Total amount of transaction
Pattern:
^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$Amount to be paid
Pattern:
^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$Amount that was already paid by Vendor Prepayment Applications or Vendor Payments
Pattern:
^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$Available options:
draft, posted, archived Date and time the record was created
Date and time the record was last updated
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Maximum string length:
2Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Schema for audit actor information.
Show child attributes
Show child attributes
Schema for audit actor information.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Schema for rejector information including rejection reason.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Was this page helpful?