Create SalesOrder record
curl --request POST \
--url https://api.dualentry.com/public/v2/sales-orders/ \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"memo": "<string>",
"date": "2023-12-25",
"company_id": 123,
"customer_id": 123,
"exchange_rate": 123,
"items": [
{
"item_id": 123,
"quantity": 123,
"rate": 123,
"position": 123,
"memo": "<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": {}
},
"id": 123,
"classifications": []
}
],
"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": {},
"bill_to_address": "",
"ship_to_address": "",
"billing_address": {
"street": "<string>",
"city": "<string>",
"postal_code": "<string>",
"state": "",
"country": "",
"second_line": "",
"name": "<string>"
},
"shipping_address": {
"street": "<string>",
"city": "<string>",
"postal_code": "<string>",
"state": "",
"country": "",
"second_line": "",
"name": "<string>"
},
"custom_fields": [
{}
],
"auto_calculate_tax": "required",
"record_status": "posted",
"attachments": [],
"term_id": 123,
"reference_number": ""
}
'import requests
url = "https://api.dualentry.com/public/v2/sales-orders/"
payload = {
"memo": "<string>",
"date": "2023-12-25",
"company_id": 123,
"customer_id": 123,
"exchange_rate": 123,
"items": [
{
"item_id": 123,
"quantity": 123,
"rate": 123,
"position": 123,
"memo": "<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": {}
},
"id": 123,
"classifications": []
}
],
"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": {},
"bill_to_address": "",
"ship_to_address": "",
"billing_address": {
"street": "<string>",
"city": "<string>",
"postal_code": "<string>",
"state": "",
"country": "",
"second_line": "",
"name": "<string>"
},
"shipping_address": {
"street": "<string>",
"city": "<string>",
"postal_code": "<string>",
"state": "",
"country": "",
"second_line": "",
"name": "<string>"
},
"custom_fields": [{}],
"auto_calculate_tax": "required",
"record_status": "posted",
"attachments": [],
"term_id": 123,
"reference_number": ""
}
headers = {
"X-API-KEY": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
memo: '<string>',
date: '2023-12-25',
company_id: 123,
customer_id: 123,
exchange_rate: 123,
items: [
{
item_id: 123,
quantity: 123,
rate: 123,
position: 123,
memo: '<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: {}
},
id: 123,
classifications: []
}
],
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: {},
bill_to_address: '',
ship_to_address: '',
billing_address: {
street: '<string>',
city: '<string>',
postal_code: '<string>',
state: '',
country: '',
second_line: '',
name: '<string>'
},
shipping_address: {
street: '<string>',
city: '<string>',
postal_code: '<string>',
state: '',
country: '',
second_line: '',
name: '<string>'
},
custom_fields: [{}],
auto_calculate_tax: 'required',
record_status: 'posted',
attachments: [],
term_id: 123,
reference_number: ''
})
};
fetch('https://api.dualentry.com/public/v2/sales-orders/', 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/v2/sales-orders/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'memo' => '<string>',
'date' => '2023-12-25',
'company_id' => 123,
'customer_id' => 123,
'exchange_rate' => 123,
'items' => [
[
'item_id' => 123,
'quantity' => 123,
'rate' => 123,
'position' => 123,
'memo' => '<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' => [
]
],
'id' => 123,
'classifications' => [
]
]
],
'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' => [
],
'bill_to_address' => '',
'ship_to_address' => '',
'billing_address' => [
'street' => '<string>',
'city' => '<string>',
'postal_code' => '<string>',
'state' => '',
'country' => '',
'second_line' => '',
'name' => '<string>'
],
'shipping_address' => [
'street' => '<string>',
'city' => '<string>',
'postal_code' => '<string>',
'state' => '',
'country' => '',
'second_line' => '',
'name' => '<string>'
],
'custom_fields' => [
[
]
],
'auto_calculate_tax' => 'required',
'record_status' => 'posted',
'attachments' => [
],
'term_id' => 123,
'reference_number' => ''
]),
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/v2/sales-orders/"
payload := strings.NewReader("{\n \"memo\": \"<string>\",\n \"date\": \"2023-12-25\",\n \"company_id\": 123,\n \"customer_id\": 123,\n \"exchange_rate\": 123,\n \"items\": [\n {\n \"item_id\": 123,\n \"quantity\": 123,\n \"rate\": 123,\n \"position\": 123,\n \"memo\": \"<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 \"id\": 123,\n \"classifications\": []\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 \"bill_to_address\": \"\",\n \"ship_to_address\": \"\",\n \"billing_address\": {\n \"street\": \"<string>\",\n \"city\": \"<string>\",\n \"postal_code\": \"<string>\",\n \"state\": \"\",\n \"country\": \"\",\n \"second_line\": \"\",\n \"name\": \"<string>\"\n },\n \"shipping_address\": {\n \"street\": \"<string>\",\n \"city\": \"<string>\",\n \"postal_code\": \"<string>\",\n \"state\": \"\",\n \"country\": \"\",\n \"second_line\": \"\",\n \"name\": \"<string>\"\n },\n \"custom_fields\": [\n {}\n ],\n \"auto_calculate_tax\": \"required\",\n \"record_status\": \"posted\",\n \"attachments\": [],\n \"term_id\": 123,\n \"reference_number\": \"\"\n}")
req, _ := http.NewRequest("POST", 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.post("https://api.dualentry.com/public/v2/sales-orders/")
.header("X-API-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"memo\": \"<string>\",\n \"date\": \"2023-12-25\",\n \"company_id\": 123,\n \"customer_id\": 123,\n \"exchange_rate\": 123,\n \"items\": [\n {\n \"item_id\": 123,\n \"quantity\": 123,\n \"rate\": 123,\n \"position\": 123,\n \"memo\": \"<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 \"id\": 123,\n \"classifications\": []\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 \"bill_to_address\": \"\",\n \"ship_to_address\": \"\",\n \"billing_address\": {\n \"street\": \"<string>\",\n \"city\": \"<string>\",\n \"postal_code\": \"<string>\",\n \"state\": \"\",\n \"country\": \"\",\n \"second_line\": \"\",\n \"name\": \"<string>\"\n },\n \"shipping_address\": {\n \"street\": \"<string>\",\n \"city\": \"<string>\",\n \"postal_code\": \"<string>\",\n \"state\": \"\",\n \"country\": \"\",\n \"second_line\": \"\",\n \"name\": \"<string>\"\n },\n \"custom_fields\": [\n {}\n ],\n \"auto_calculate_tax\": \"required\",\n \"record_status\": \"posted\",\n \"attachments\": [],\n \"term_id\": 123,\n \"reference_number\": \"\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.dualentry.com/public/v2/sales-orders/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"memo\": \"<string>\",\n \"date\": \"2023-12-25\",\n \"company_id\": 123,\n \"customer_id\": 123,\n \"exchange_rate\": 123,\n \"items\": [\n {\n \"item_id\": 123,\n \"quantity\": 123,\n \"rate\": 123,\n \"position\": 123,\n \"memo\": \"<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 \"id\": 123,\n \"classifications\": []\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 \"bill_to_address\": \"\",\n \"ship_to_address\": \"\",\n \"billing_address\": {\n \"street\": \"<string>\",\n \"city\": \"<string>\",\n \"postal_code\": \"<string>\",\n \"state\": \"\",\n \"country\": \"\",\n \"second_line\": \"\",\n \"name\": \"<string>\"\n },\n \"shipping_address\": {\n \"street\": \"<string>\",\n \"city\": \"<string>\",\n \"postal_code\": \"<string>\",\n \"state\": \"\",\n \"country\": \"\",\n \"second_line\": \"\",\n \"name\": \"<string>\"\n },\n \"custom_fields\": [\n {}\n ],\n \"auto_calculate_tax\": \"required\",\n \"record_status\": \"posted\",\n \"attachments\": [],\n \"term_id\": 123,\n \"reference_number\": \"\"\n}"
response = http.request(request)
puts response.read_body{
"bill_to_address": "<string>",
"ship_to_address": "<string>",
"invoiced_status": "invoiced",
"term_id": 123,
"term_name": "<string>",
"internal_id": 123,
"number": 123,
"items": [
{
"id": 123,
"item_id": 123,
"quantity": "<string>",
"rate": "<string>",
"position": 123,
"memo": "<string>",
"quantity_invoiced": "<string>",
"quantity_due": "<string>",
"net_amount": "<string>",
"tax_amount": "<string>",
"gross_amount": "<string>",
"amount": "<string>",
"classifications": [],
"item_type": "<string>",
"hsn_sac_code": "<string>",
"tax": {
"code": "<string>",
"rate": "<string>",
"amount": "<string>",
"is_taxable": true,
"tax_exempt_amount": "<string>",
"vat_rate_id": 123,
"gst_tax_rate_id": 123,
"tax_metadata": {},
"tax_components": [
{
"component_type": "CGST",
"rate": "<string>",
"amount": "<string>",
"position": 123,
"region": "<string>"
}
],
"amount_with_tax": "<string>",
"rate_name": "<string>",
"rate_description": "<string>",
"rate_type": "<string>",
"tax_treatment": "<string>",
"valid_to": "2023-12-25"
}
}
],
"company_id": 123,
"company_name": "<string>",
"company_currency": "<string>",
"customer_id": 123,
"customer_name": "<string>",
"currency_iso_4217_code": "AED",
"exchange_rate": "<string>",
"amount": "<string>",
"invoiced_total": "<string>",
"due_total": "<string>",
"memo": "<string>",
"date": "2023-12-25",
"record_status": "draft",
"reference_number": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"billing_address": {
"street": "<string>",
"city": "<string>",
"postal_code": "<string>",
"state": "",
"country": "",
"second_line": "",
"name": "<string>"
},
"shipping_address": {
"street": "<string>",
"city": "<string>",
"postal_code": "<string>",
"state": "",
"country": "",
"second_line": "",
"name": "<string>"
},
"custom_fields": [],
"attachments": [],
"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>",
"recurring_record_number": 123
}{
"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>"
}Sales Orders
Create SalesOrder record
Create a new SalesOrder record with the provided data.
POST
/
public
/
v2
/
sales-orders
/
Create SalesOrder record
curl --request POST \
--url https://api.dualentry.com/public/v2/sales-orders/ \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"memo": "<string>",
"date": "2023-12-25",
"company_id": 123,
"customer_id": 123,
"exchange_rate": 123,
"items": [
{
"item_id": 123,
"quantity": 123,
"rate": 123,
"position": 123,
"memo": "<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": {}
},
"id": 123,
"classifications": []
}
],
"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": {},
"bill_to_address": "",
"ship_to_address": "",
"billing_address": {
"street": "<string>",
"city": "<string>",
"postal_code": "<string>",
"state": "",
"country": "",
"second_line": "",
"name": "<string>"
},
"shipping_address": {
"street": "<string>",
"city": "<string>",
"postal_code": "<string>",
"state": "",
"country": "",
"second_line": "",
"name": "<string>"
},
"custom_fields": [
{}
],
"auto_calculate_tax": "required",
"record_status": "posted",
"attachments": [],
"term_id": 123,
"reference_number": ""
}
'import requests
url = "https://api.dualentry.com/public/v2/sales-orders/"
payload = {
"memo": "<string>",
"date": "2023-12-25",
"company_id": 123,
"customer_id": 123,
"exchange_rate": 123,
"items": [
{
"item_id": 123,
"quantity": 123,
"rate": 123,
"position": 123,
"memo": "<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": {}
},
"id": 123,
"classifications": []
}
],
"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": {},
"bill_to_address": "",
"ship_to_address": "",
"billing_address": {
"street": "<string>",
"city": "<string>",
"postal_code": "<string>",
"state": "",
"country": "",
"second_line": "",
"name": "<string>"
},
"shipping_address": {
"street": "<string>",
"city": "<string>",
"postal_code": "<string>",
"state": "",
"country": "",
"second_line": "",
"name": "<string>"
},
"custom_fields": [{}],
"auto_calculate_tax": "required",
"record_status": "posted",
"attachments": [],
"term_id": 123,
"reference_number": ""
}
headers = {
"X-API-KEY": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
memo: '<string>',
date: '2023-12-25',
company_id: 123,
customer_id: 123,
exchange_rate: 123,
items: [
{
item_id: 123,
quantity: 123,
rate: 123,
position: 123,
memo: '<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: {}
},
id: 123,
classifications: []
}
],
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: {},
bill_to_address: '',
ship_to_address: '',
billing_address: {
street: '<string>',
city: '<string>',
postal_code: '<string>',
state: '',
country: '',
second_line: '',
name: '<string>'
},
shipping_address: {
street: '<string>',
city: '<string>',
postal_code: '<string>',
state: '',
country: '',
second_line: '',
name: '<string>'
},
custom_fields: [{}],
auto_calculate_tax: 'required',
record_status: 'posted',
attachments: [],
term_id: 123,
reference_number: ''
})
};
fetch('https://api.dualentry.com/public/v2/sales-orders/', 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/v2/sales-orders/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'memo' => '<string>',
'date' => '2023-12-25',
'company_id' => 123,
'customer_id' => 123,
'exchange_rate' => 123,
'items' => [
[
'item_id' => 123,
'quantity' => 123,
'rate' => 123,
'position' => 123,
'memo' => '<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' => [
]
],
'id' => 123,
'classifications' => [
]
]
],
'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' => [
],
'bill_to_address' => '',
'ship_to_address' => '',
'billing_address' => [
'street' => '<string>',
'city' => '<string>',
'postal_code' => '<string>',
'state' => '',
'country' => '',
'second_line' => '',
'name' => '<string>'
],
'shipping_address' => [
'street' => '<string>',
'city' => '<string>',
'postal_code' => '<string>',
'state' => '',
'country' => '',
'second_line' => '',
'name' => '<string>'
],
'custom_fields' => [
[
]
],
'auto_calculate_tax' => 'required',
'record_status' => 'posted',
'attachments' => [
],
'term_id' => 123,
'reference_number' => ''
]),
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/v2/sales-orders/"
payload := strings.NewReader("{\n \"memo\": \"<string>\",\n \"date\": \"2023-12-25\",\n \"company_id\": 123,\n \"customer_id\": 123,\n \"exchange_rate\": 123,\n \"items\": [\n {\n \"item_id\": 123,\n \"quantity\": 123,\n \"rate\": 123,\n \"position\": 123,\n \"memo\": \"<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 \"id\": 123,\n \"classifications\": []\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 \"bill_to_address\": \"\",\n \"ship_to_address\": \"\",\n \"billing_address\": {\n \"street\": \"<string>\",\n \"city\": \"<string>\",\n \"postal_code\": \"<string>\",\n \"state\": \"\",\n \"country\": \"\",\n \"second_line\": \"\",\n \"name\": \"<string>\"\n },\n \"shipping_address\": {\n \"street\": \"<string>\",\n \"city\": \"<string>\",\n \"postal_code\": \"<string>\",\n \"state\": \"\",\n \"country\": \"\",\n \"second_line\": \"\",\n \"name\": \"<string>\"\n },\n \"custom_fields\": [\n {}\n ],\n \"auto_calculate_tax\": \"required\",\n \"record_status\": \"posted\",\n \"attachments\": [],\n \"term_id\": 123,\n \"reference_number\": \"\"\n}")
req, _ := http.NewRequest("POST", 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.post("https://api.dualentry.com/public/v2/sales-orders/")
.header("X-API-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"memo\": \"<string>\",\n \"date\": \"2023-12-25\",\n \"company_id\": 123,\n \"customer_id\": 123,\n \"exchange_rate\": 123,\n \"items\": [\n {\n \"item_id\": 123,\n \"quantity\": 123,\n \"rate\": 123,\n \"position\": 123,\n \"memo\": \"<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 \"id\": 123,\n \"classifications\": []\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 \"bill_to_address\": \"\",\n \"ship_to_address\": \"\",\n \"billing_address\": {\n \"street\": \"<string>\",\n \"city\": \"<string>\",\n \"postal_code\": \"<string>\",\n \"state\": \"\",\n \"country\": \"\",\n \"second_line\": \"\",\n \"name\": \"<string>\"\n },\n \"shipping_address\": {\n \"street\": \"<string>\",\n \"city\": \"<string>\",\n \"postal_code\": \"<string>\",\n \"state\": \"\",\n \"country\": \"\",\n \"second_line\": \"\",\n \"name\": \"<string>\"\n },\n \"custom_fields\": [\n {}\n ],\n \"auto_calculate_tax\": \"required\",\n \"record_status\": \"posted\",\n \"attachments\": [],\n \"term_id\": 123,\n \"reference_number\": \"\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.dualentry.com/public/v2/sales-orders/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"memo\": \"<string>\",\n \"date\": \"2023-12-25\",\n \"company_id\": 123,\n \"customer_id\": 123,\n \"exchange_rate\": 123,\n \"items\": [\n {\n \"item_id\": 123,\n \"quantity\": 123,\n \"rate\": 123,\n \"position\": 123,\n \"memo\": \"<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 \"id\": 123,\n \"classifications\": []\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 \"bill_to_address\": \"\",\n \"ship_to_address\": \"\",\n \"billing_address\": {\n \"street\": \"<string>\",\n \"city\": \"<string>\",\n \"postal_code\": \"<string>\",\n \"state\": \"\",\n \"country\": \"\",\n \"second_line\": \"\",\n \"name\": \"<string>\"\n },\n \"shipping_address\": {\n \"street\": \"<string>\",\n \"city\": \"<string>\",\n \"postal_code\": \"<string>\",\n \"state\": \"\",\n \"country\": \"\",\n \"second_line\": \"\",\n \"name\": \"<string>\"\n },\n \"custom_fields\": [\n {}\n ],\n \"auto_calculate_tax\": \"required\",\n \"record_status\": \"posted\",\n \"attachments\": [],\n \"term_id\": 123,\n \"reference_number\": \"\"\n}"
response = http.request(request)
puts response.read_body{
"bill_to_address": "<string>",
"ship_to_address": "<string>",
"invoiced_status": "invoiced",
"term_id": 123,
"term_name": "<string>",
"internal_id": 123,
"number": 123,
"items": [
{
"id": 123,
"item_id": 123,
"quantity": "<string>",
"rate": "<string>",
"position": 123,
"memo": "<string>",
"quantity_invoiced": "<string>",
"quantity_due": "<string>",
"net_amount": "<string>",
"tax_amount": "<string>",
"gross_amount": "<string>",
"amount": "<string>",
"classifications": [],
"item_type": "<string>",
"hsn_sac_code": "<string>",
"tax": {
"code": "<string>",
"rate": "<string>",
"amount": "<string>",
"is_taxable": true,
"tax_exempt_amount": "<string>",
"vat_rate_id": 123,
"gst_tax_rate_id": 123,
"tax_metadata": {},
"tax_components": [
{
"component_type": "CGST",
"rate": "<string>",
"amount": "<string>",
"position": 123,
"region": "<string>"
}
],
"amount_with_tax": "<string>",
"rate_name": "<string>",
"rate_description": "<string>",
"rate_type": "<string>",
"tax_treatment": "<string>",
"valid_to": "2023-12-25"
}
}
],
"company_id": 123,
"company_name": "<string>",
"company_currency": "<string>",
"customer_id": 123,
"customer_name": "<string>",
"currency_iso_4217_code": "AED",
"exchange_rate": "<string>",
"amount": "<string>",
"invoiced_total": "<string>",
"due_total": "<string>",
"memo": "<string>",
"date": "2023-12-25",
"record_status": "draft",
"reference_number": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"billing_address": {
"street": "<string>",
"city": "<string>",
"postal_code": "<string>",
"state": "",
"country": "",
"second_line": "",
"name": "<string>"
},
"shipping_address": {
"street": "<string>",
"city": "<string>",
"postal_code": "<string>",
"state": "",
"country": "",
"second_line": "",
"name": "<string>"
},
"custom_fields": [],
"attachments": [],
"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>",
"recurring_record_number": 123
}{
"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:
255Body
application/json
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 Show child attributes
Show child attributes
Maximum string length:
2Show child attributes
Show child attributes
Show child attributes
Show child attributes
Deprecated: send the structured billing_address / shipping_address instead.
Deprecated: send the structured billing_address / shipping_address instead.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Set to "required" to calculate tax for every line and replace any supplied tax amounts before saving, or return 422 when calculation cannot complete. Omit the field to keep caller-supplied tax. The calculation supports native US sales tax (the DualEntry tax engine) and Avalara Sales Tax, VAT, and GST. Native VAT and GST return 422, because this field does not select a rate. Tax addresses: money-in uses shipping_address, then billing_address, then the customer saved address. Money-out uses ship_from_address and ship_to_address, then the vendor and company saved addresses. When a money-in payload has no address, DualEntry copies the customer saved address to billing_address and shipping_address. A money-out record saves only the ship addresses that the payload sends. Returns 422 when calculation cannot resolve a required address.
Available options:
required Available options:
draft, posted, archived Show child attributes
Show child attributes
Response
OK
Deprecated: send the structured billing_address / shipping_address instead.
Deprecated: send the structured billing_address / shipping_address instead.
Available options:
invoiced, uninvoiced, partially_invoiced Show child attributes
Show child attributes
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 ordered items
Pattern:
^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$Total quantity of items that were already invoiced
Pattern:
^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$Total quantity of items yet to be invoiced
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
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
Was this page helpful?