Update BillV2 record (partial)

curl --request PATCH \
  --url https://api.dualentry.com/public/v3-alpha/bills/{record_number}/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "custom_fields": [
    {}
  ],
  "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": {},
  "auto_calculate_tax": "required",
  "company_id": 123,
  "vendor_id": 123,
  "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": [
    {
      "id": 123,
      "file_name": "<string>",
      "file_size": 123,
      "download_url": "<string>",
      "upload_url": "<string>",
      "category": "default"
    }
  ],
  "date": "2023-12-25",
  "transaction_date": "2023-12-25"
}
'

import requests

url = "https://api.dualentry.com/public/v3-alpha/bills/{record_number}/"

payload = {
    "custom_fields": [{}],
    "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": {},
    "auto_calculate_tax": "required",
    "company_id": 123,
    "vendor_id": 123,
    "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": [
        {
            "id": 123,
            "file_name": "<string>",
            "file_size": 123,
            "download_url": "<string>",
            "upload_url": "<string>",
            "category": "default"
        }
    ],
    "date": "2023-12-25",
    "transaction_date": "2023-12-25"
}
headers = {
    "X-API-KEY": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    custom_fields: [{}],
    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: {},
    auto_calculate_tax: 'required',
    company_id: 123,
    vendor_id: 123,
    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: [
      {
        id: 123,
        file_name: '<string>',
        file_size: 123,
        download_url: '<string>',
        upload_url: '<string>',
        category: 'default'
      }
    ],
    date: '2023-12-25',
    transaction_date: '2023-12-25'
  })
};

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 => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'custom_fields' => [
        [
                
        ]
    ],
    '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' => [
        
    ],
    'auto_calculate_tax' => 'required',
    'company_id' => 123,
    'vendor_id' => 123,
    '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' => [
        [
                'id' => 123,
                'file_name' => '<string>',
                'file_size' => 123,
                'download_url' => '<string>',
                'upload_url' => '<string>',
                'category' => 'default'
        ]
    ],
    'date' => '2023-12-25',
    'transaction_date' => '2023-12-25'
  ]),
  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  \"custom_fields\": [\n    {}\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  \"auto_calculate_tax\": \"required\",\n  \"company_id\": 123,\n  \"vendor_id\": 123,\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    {\n      \"id\": 123,\n      \"file_name\": \"<string>\",\n      \"file_size\": 123,\n      \"download_url\": \"<string>\",\n      \"upload_url\": \"<string>\",\n      \"category\": \"default\"\n    }\n  ],\n  \"date\": \"2023-12-25\",\n  \"transaction_date\": \"2023-12-25\"\n}")

	req, _ := http.NewRequest("PATCH", 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.patch("https://api.dualentry.com/public/v3-alpha/bills/{record_number}/")
  .header("X-API-KEY", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"custom_fields\": [\n    {}\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  \"auto_calculate_tax\": \"required\",\n  \"company_id\": 123,\n  \"vendor_id\": 123,\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    {\n      \"id\": 123,\n      \"file_name\": \"<string>\",\n      \"file_size\": 123,\n      \"download_url\": \"<string>\",\n      \"upload_url\": \"<string>\",\n      \"category\": \"default\"\n    }\n  ],\n  \"date\": \"2023-12-25\",\n  \"transaction_date\": \"2023-12-25\"\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::Patch.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"custom_fields\": [\n    {}\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  \"auto_calculate_tax\": \"required\",\n  \"company_id\": 123,\n  \"vendor_id\": 123,\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    {\n      \"id\": 123,\n      \"file_name\": \"<string>\",\n      \"file_size\": 123,\n      \"download_url\": \"<string>\",\n      \"upload_url\": \"<string>\",\n      \"category\": \"default\"\n    }\n  ],\n  \"date\": \"2023-12-25\",\n  \"transaction_date\": \"2023-12-25\"\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 (partial)

Partially update an existing BillV2 record. Send only the fields you want to change. Anything you don’t send stays as it is. Updates are subject to the same constraints as the full update endpoint: period locks, payment-applied restrictions, and approval-workflow rules apply.

Side effects

If an approval workflow matches this request, DualEntry can set record_status back to draft.

Additional validations

Fails with 503 if the exchange rate for the transaction date is unavailable.
Fails with 422 and the error code posting_date_after_limit if date is after the latest posting date that your organization allows.
Fails with 422 and error_code tax_not_calculated when 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 carries tax. Set auto_calculate_tax to required, or send tax on the lines.
Fails with 422 if you set an inactive, archived, or draft customer or vendor, or an inactive company.
Fails with 422 if a line account is not available to the record’s company.
Fails with 422 if 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.

PATCH

public

v3-alpha

bills

{record_number}

Update BillV2 record (partial)

curl --request PATCH \
  --url https://api.dualentry.com/public/v3-alpha/bills/{record_number}/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "custom_fields": [
    {}
  ],
  "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": {},
  "auto_calculate_tax": "required",
  "company_id": 123,
  "vendor_id": 123,
  "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": [
    {
      "id": 123,
      "file_name": "<string>",
      "file_size": 123,
      "download_url": "<string>",
      "upload_url": "<string>",
      "category": "default"
    }
  ],
  "date": "2023-12-25",
  "transaction_date": "2023-12-25"
}
'

import requests

url = "https://api.dualentry.com/public/v3-alpha/bills/{record_number}/"

payload = {
    "custom_fields": [{}],
    "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": {},
    "auto_calculate_tax": "required",
    "company_id": 123,
    "vendor_id": 123,
    "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": [
        {
            "id": 123,
            "file_name": "<string>",
            "file_size": 123,
            "download_url": "<string>",
            "upload_url": "<string>",
            "category": "default"
        }
    ],
    "date": "2023-12-25",
    "transaction_date": "2023-12-25"
}
headers = {
    "X-API-KEY": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    custom_fields: [{}],
    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: {},
    auto_calculate_tax: 'required',
    company_id: 123,
    vendor_id: 123,
    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: [
      {
        id: 123,
        file_name: '<string>',
        file_size: 123,
        download_url: '<string>',
        upload_url: '<string>',
        category: 'default'
      }
    ],
    date: '2023-12-25',
    transaction_date: '2023-12-25'
  })
};

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 => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'custom_fields' => [
        [
                
        ]
    ],
    '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' => [
        
    ],
    'auto_calculate_tax' => 'required',
    'company_id' => 123,
    'vendor_id' => 123,
    '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' => [
        [
                'id' => 123,
                'file_name' => '<string>',
                'file_size' => 123,
                'download_url' => '<string>',
                'upload_url' => '<string>',
                'category' => 'default'
        ]
    ],
    'date' => '2023-12-25',
    'transaction_date' => '2023-12-25'
  ]),
  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  \"custom_fields\": [\n    {}\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  \"auto_calculate_tax\": \"required\",\n  \"company_id\": 123,\n  \"vendor_id\": 123,\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    {\n      \"id\": 123,\n      \"file_name\": \"<string>\",\n      \"file_size\": 123,\n      \"download_url\": \"<string>\",\n      \"upload_url\": \"<string>\",\n      \"category\": \"default\"\n    }\n  ],\n  \"date\": \"2023-12-25\",\n  \"transaction_date\": \"2023-12-25\"\n}")

	req, _ := http.NewRequest("PATCH", 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.patch("https://api.dualentry.com/public/v3-alpha/bills/{record_number}/")
  .header("X-API-KEY", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"custom_fields\": [\n    {}\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  \"auto_calculate_tax\": \"required\",\n  \"company_id\": 123,\n  \"vendor_id\": 123,\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    {\n      \"id\": 123,\n      \"file_name\": \"<string>\",\n      \"file_size\": 123,\n      \"download_url\": \"<string>\",\n      \"upload_url\": \"<string>\",\n      \"category\": \"default\"\n    }\n  ],\n  \"date\": \"2023-12-25\",\n  \"transaction_date\": \"2023-12-25\"\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::Patch.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"custom_fields\": [\n    {}\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  \"auto_calculate_tax\": \"required\",\n  \"company_id\": 123,\n  \"vendor_id\": 123,\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    {\n      \"id\": 123,\n      \"file_name\": \"<string>\",\n      \"file_size\": 123,\n      \"download_url\": \"<string>\",\n      \"upload_url\": \"<string>\",\n      \"category\": \"default\"\n    }\n  ],\n  \"date\": \"2023-12-25\",\n  \"transaction_date\": \"2023-12-25\"\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

X-API-KEY

string

header

required

Headers

Idempotency-Key

string

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: 255

Path Parameters

record_number

integer

required

The number attribute of the record.

Body

application/json

Partial update payload for PATCH /public/bills/{number}/.

Every field is optional: send only the fields you want to change. Unset fields are left untouched on the existing record.

Updates allowed under the same constraints as PUT: period locks, payment-applied restrictions, and approval-workflow rules apply.

custom_fields

Custom Fields · object[] | null

supply_date

string<date> | null

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.

place_of_supply

string | null

Maximum string length: 2

tax_registration_numbers

TaxRegistrationNumbersSnapshot · object | null

Show child attributes

tax_metadata

object | null

Show child attributes

auto_calculate_tax

enum<string> | null

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 required when a tax provider returns the tax.
The request fails with 422 when 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, then billing_address, then the address saved on the customer.
If you send neither address, DualEntry copies the customer's saved address to billing_address and shipping_address.
When the record has a vendor, DualEntry reads ship_from_address and ship_to_address, then the addresses saved on the vendor and the company.
DualEntry stores only the ship addresses you sent.

Available options:

required

company_id

integer | null

vendor_id

integer | null

If this vendor is intercompany, DualEntry also writes a transaction in the elimination company.

currency_iso_4217_code

enum<string> | null

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

exchange_rate

If you omit this field, DualEntry keeps the stored rate. If you omit this field and you change transaction_date or currency_iso_4217_code, DualEntry calculates a new rate. This also applies when you change company_id to a company with a different base currency. A change to date also changes the transaction date when your organization does not keep the two dates independent. DualEntry stores a rate that you send, including 1.0, and calculates a new rate when you send null.

memo

string | null

Maximum string length: 512

items

PublicBillItemIn · object[] | null

Show child attributes

expenses

PublicBillExpenseIn · object[] | null

Show child attributes

due_date

string<date> | null

term_id

integer | null

reference_number

string

default:""

purchase_order_number

integer | null

attachments

AttachmentSchemaOut · object[] | null

Show child attributes

record_status

enum<string> | null

Available options:

draft,

posted,

archived

date

string<date> | null

transaction_date

string<date> | null

Response

supply_date

string<date> | null

required

tax

RecordTaxContextOut · object | null

required

Base for record-level tax context; regime discriminates data.

Mirrors TaxResultV2Out (core.taxes.api.taxes)

Show child attributes

transaction_ids

integer[]

required

term_id

integer | null

required

term_name

string

required

internal_id

integer

required

number

integer

required

date

string<date>

required

Posting date (GL date) - the date when the transaction is recorded in the general ledger

transaction_date

string<date>

required

Transaction date (inception date) - the date when the transaction actually occurred

due_date

string<date>

required

company_id

integer

required

company_name

string

required

company_currency

string

required

vendor_id

integer

required

vendor_name

string

required

currency_iso_4217_code

enum<string>

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

exchange_rate

string

required

Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,16}0*$

memo

string

required

amount

string

required

Total amount of transaction

Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$

amount_due

string

required

Amount to be paid

Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$

paid_total

string

required

Amount that was already paid by Vendor Prepayment Applications or Vendor Payments

Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$

record_status

enum<string>

required

Available options:

draft,

posted,

archived

recurring_record_number

integer | null

required

purchase_order_number

integer | null

required

reference_number

string

required

created_at

string<date-time>

required

Date and time the record was created

updated_at

string<date-time>

required

Date and time the record was last updated

custom_fields

CustomFieldValuePairOutputSchema · object[]

Show child attributes

ship_from_address

AddressSchemaOut · object | null

Show child attributes

ship_to_address

AddressSchemaOut · object | null

Show child attributes

place_of_supply

string | null

Maximum string length: 2

tax_registration_numbers

TaxRegistrationNumbersSnapshot · object | null

Show child attributes

tax_metadata

object | null

Show child attributes

attachments

PublicAttachmentSchemaOut · object[]

Show child attributes

bank_match_status

string | null

reconciliation_status

string | null

created_by

AuditActorSchemaOut · object | null

Schema for audit actor information.

Show child attributes

updated_by

AuditActorSchemaOut · object | null

Schema for audit actor information.

Show child attributes

approval_status

string | null

next_approvers

ApproverDictSchema · object[] | null

Show child attributes

rejected_by

RejectedBySchema · object | null

Schema for rejector information including rejection reason.

Show child attributes

code

string | null

items

PublicBillItemOut · object[]

Show child attributes

expenses

PublicBillExpenseOut · object[]

Show child attributes

items_has_more

boolean

default:false

items_count

integer

default:0

expenses_has_more

boolean

default:false

expenses_count

integer

default:0

Overview

Organization

Accounting Setup

Transactions

Money In

Money Out

Financial & Banking

Assets

Tax

Financial Planning

Reporting

Governance

Developers

Monitoring

OAuth

Update BillV2 record (partial)

Authorizations

Headers

Path Parameters

Body

Response