> This page is for Unified.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# /sales-orders/bulk

POST https://api.merge.dev/api/accounting/v1/sales-orders/bulk
Content-Type: application/json

Creates multiple `SalesOrder` objects with the given values.

Reference: https://docs.merge.dev/merge-unified/accounting/common-models/sales-orders/async-bulk-create

## Authentication

- `Authorization` header (bearer token, required) — Token-based authentication with required prefix "Bearer"

## Servers

- `https://api.merge.dev/api` (Production, default)
- `https://api-eu.merge.dev/api` (ProductionEU)
- `https://api-ap.merge.dev/api` (ProductionAPSE1)

## Request

### Headers

- `X-Account-Token` (string, required) — Token identifying the end user.

### Body (application/json)

This endpoint expects a SalesOrderBulkRequest.

- `batch_items` (list of SalesOrderBatchItemRequest, required)

## Response

### 202

- `batch_id` (string, required) — The ID of the batch.

## Types

### SalesOrderBatchItemRequest

- `item_id` (string, required) — The third-party item ID for this model in the bulk create request
- `payload` (SalesOrderRequestRequest, required) — # The SalesOrder Object ### Description The `SalesOrder` object represents a seller's formal record and confirmation of a customer's purchase request. ### Usage Example Fetch from the `LIST SalesOrders` endpoint and view a company's sales orders.

### SalesOrderRequestRequest

# The SalesOrder Object ### Description The `SalesOrder` object represents a seller's formal record and confirmation of a customer's purchase request. ### Usage Example Fetch from the `LIST SalesOrders` endpoint and view a company's sales orders.

- `customer` (string, optional, nullable) — The customer associated with the sales order.
- `currency` (enum, optional, nullable) — The currency code for the order. The currency code in ISO 4217 format.
  - Allowed values: `XUA`, `AFN`, `AFA`, `ALL`, `ALK`, `DZD`, `ADP`, `AOA`, `AOK`, `AON`, `AOR`, `ARA`, `ARS`, `ARM`, `ARP`, `ARL`, `AMD`, `AWG`, `AUD`, `ATS`, `AZN`, `AZM`, `BSD`, `BHD`, `BDT`, `BBD`, `BYN`, `BYB`, `BYR`, `BEF`, `BEC`, `BEL`, `BZD`, `BMD`, `BTN`, `BOB`, `BOL`, `BOV`, `BOP`, `BAM`, `BAD`, `BAN`, `BWP`, `BRC`, `BRZ`, `BRE`, `BRR`, `BRN`, `BRB`, `BRL`, `GBP`, `BND`, `BGL`, `BGN`, `BGO`, `BGM`, `BUK`, `BIF`, `XPF`, `KHR`, `CAD`, `CVE`, `KYD`, `XAF`, `CLE`, `CLP`, `CLF`, `CNX`, `CNY`, `CNH`, `COP`, `COU`, `KMF`, `CDF`, `CRC`, `HRD`, `HRK`, `CUC`, `CUP`, `CYP`, `CZK`, `CSK`, `DKK`, `DJF`, `DOP`, `NLG`, `XCD`, `DDM`, `ECS`, `ECV`, `EGP`, `GQE`, `ERN`, `EEK`, `ETB`, `EUR`, `XBA`, `XEU`, `XBB`, `XBC`, `XBD`, `FKP`, `FJD`, `FIM`, `FRF`, `XFO`, `XFU`, `GMD`, `GEK`, `GEL`, `DEM`, `GHS`, `GHC`, `GIP`, `XAU`, `GRD`, `GTQ`, `GWP`, `GNF`, `GNS`, `GYD`, `HTG`, `HNL`, `HKD`, `HUF`, `IMP`, `ISK`, `ISJ`, `INR`, `IDR`, `IRR`, `IQD`, `IEP`, `ILS`, `ILP`, `ILR`, `ITL`, `JMD`, `JPY`, `JOD`, `KZT`, `KES`, `KWD`, `KGS`, `LAK`, `LVL`, `LVR`, `LBP`, `LSL`, `LRD`, `LYD`, `LTL`, `LTT`, `LUL`, `LUC`, `LUF`, `MOP`, `MKD`, `MKN`, `MGA`, `MGF`, `MWK`, `MYR`, `MVR`, `MVP`, `MLF`, `MTL`, `MTP`, `MRU`, `MRO`, `MUR`, `MXV`, `MXN`, `MXP`, `MDC`, `MDL`, `MCF`, `MNT`, `MAD`, `MAF`, `MZE`, `MZN`, `MZM`, `MMK`, `NAD`, `NPR`, `ANG`, `TWD`, `NZD`, `NIO`, `NIC`, `NGN`, `KPW`, `NOK`, `OMR`, `PKR`, `XPD`, `PAB`, `PGK`, `PYG`, `PEI`, `PEN`, `PES`, `PHP`, `XPT`, `PLN`, `PLZ`, `PTE`, `GWE`, `QAR`, `XRE`, `RHD`, `RON`, `ROL`, `RUB`, `RUR`, `RWF`, `SVC`, `WST`, `SAR`, `RSD`, `CSD`, `SCR`, `SLL`, `XAG`, `SGD`, `SKK`, `SIT`, `SBD`, `SOS`, `ZAR`, `ZAL`, `KRH`, `KRW`, `KRO`, `SSP`, `SUR`, `ESP`, `ESA`, `ESB`, `XDR`, `LKR`, `SHP`, `XSU`, `SDD`, `SDG`, `SDP`, `SRD`, `SRG`, `SZL`, `SEK`, `CHF`, `SYP`, `STN`, `STD`, `TVD`, `TJR`, `TJS`, `TZS`, `XTS`, `THB`, `XXX`, `TPE`, `TOP`, `TTD`, `TND`, `TRY`, `TRL`, `TMT`, `TMM`, `USD`, `USN`, `USS`, `UGX`, `UGS`, `UAH`, `UAK`, `AED`, `UYW`, `UYU`, `UYP`, `UYI`, `UZS`, `VUV`, `VES`, `VEB`, `VEF`, `VND`, `VNN`, `CHE`, `CHW`, `XOF`, `YDD`, `YER`, `YUN`, `YUD`, `YUM`, `YUR`, `ZWN`, `ZRN`, `ZRZ`, `ZMW`, `ZMK`, `ZWD`, `ZWR`, `ZWL`
- `exchange_rate` (string, optional, nullable) — The exchange rate applied if the order currency differs from the base currency.
- `company` (string, optional, nullable) — The subsidiary associated with the order.
- `status` (enum, optional, nullable) — The status of the sales order.
  - Allowed values: `DRAFT`, `PENDING_APPROVAL`, `OPEN`, `PARTIALLY_COMPLETED`, `COMPLETED`, `CLOSED`
- `payment_term` (string, optional, nullable) — The payment terms applied to this order.
- `memo` (string, optional, nullable) — Notes or comments attached to the order.
- `shipping_address` (string, optional, nullable) — The shipping address for the order.
- `tracking_categories` (list of string, optional)
- `issue_date` (datetime, optional, nullable) — The date the sales order was issued.
- `transaction_number` (string, optional, nullable) — The human-readable sales order number or transaction reference.
- `total` (double, optional, nullable) — Total amount of order.
- `lines` (list of SalesOrderLineRequest, optional)
- `integration_params` (map from string to any, optional, nullable)
- `linked_account_params` (map from string to any, optional, nullable)
- `remote_fields` (list of RemoteFieldRequest, optional)
- `status_native` (string, optional, nullable) — The third-party value for `status`, sent to the integration without enum normalization. Cannot be combined with `status`.

### SalesOrderLineRequest

# The SalesOrderLine Object ### Description The `SalesOrderLine` object represents a specific line item on a sales order. ### Usage Example Fetch from the `GET SalesOrder` endpoint and view a company's sales order line items.

- `remote_id` (string, optional, nullable) — The third-party API ID of the matching object.
- `description` (string, optional, nullable) — Description of the line item.
- `unit_price` (string, optional, nullable) — The unit price of the item.
- `quantity` (string, optional, nullable) — Quantity ordered for this line.
- `item` (string, optional, nullable)
- `tax_rate` (string, optional, nullable) — The tax rate of the line item.
- `tracking_categories` (list of string, optional) — The dimensions or classification tags.
- `company` (string, optional, nullable) — The subsidiary associated with the order.
- `remote_created_at` (datetime, optional, nullable) — When the third party's sales order line item was created.
- `remote_updated_at` (datetime, optional, nullable) — When the third party's sales order line item was updated.
- `integration_params` (map from string to any, optional, nullable)
- `linked_account_params` (map from string to any, optional, nullable)
- `remote_fields` (list of RemoteFieldRequest, optional)

### RemoteFieldRequest

- `remote_field_class` (string, required)
- `value` (map from string to any, optional)

## Examples

**Request**

```json
{
  "batch_items": [
    {
      "item_id": "string",
      "payload": {}
    }
  ]
}
```

**Response**

```json
{
  "batch_id": "d0a3ca3e-2d7a-44cd-a94b-bda805f23b5"
}
```

**SDK Code**

```python
import requests

url = "https://api.merge.dev/api/accounting/v1/sales-orders/bulk"

payload = { "batch_items": [
        {
            "item_id": "string",
            "payload": {}
        }
    ] }
headers = {
    "X-Account-Token": "X-Account-Token",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.json())
```

```javascript
const url = 'https://api.merge.dev/api/accounting/v1/sales-orders/bulk';
const options = {
  method: 'POST',
  headers: {
    'X-Account-Token': 'X-Account-Token',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: '{"batch_items":[{"item_id":"string","payload":{}}]}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.merge.dev/api/accounting/v1/sales-orders/bulk"

	payload := strings.NewReader("{\n  \"batch_items\": [\n    {\n      \"item_id\": \"string\",\n      \"payload\": {}\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Account-Token", "X-Account-Token")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.merge.dev/api/accounting/v1/sales-orders/bulk")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-Account-Token"] = 'X-Account-Token'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"batch_items\": [\n    {\n      \"item_id\": \"string\",\n      \"payload\": {}\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body
```

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.post("https://api.merge.dev/api/accounting/v1/sales-orders/bulk")
  .header("X-Account-Token", "X-Account-Token")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"batch_items\": [\n    {\n      \"item_id\": \"string\",\n      \"payload\": {}\n    }\n  ]\n}")
  .asString();
```

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.merge.dev/api/accounting/v1/sales-orders/bulk', [
  'body' => '{
  "batch_items": [
    {
      "item_id": "string",
      "payload": {}
    }
  ]
}',
  'headers' => [
    'Authorization' => 'Bearer <token>',
    'Content-Type' => 'application/json',
    'X-Account-Token' => 'X-Account-Token',
  ],
]);

echo $response->getBody();
```

```csharp
using RestSharp;

var client = new RestClient("https://api.merge.dev/api/accounting/v1/sales-orders/bulk");
var request = new RestRequest(Method.POST);
request.AddHeader("X-Account-Token", "X-Account-Token");
request.AddHeader("Authorization", "Bearer <token>");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{\n  \"batch_items\": [\n    {\n      \"item_id\": \"string\",\n      \"payload\": {}\n    }\n  ]\n}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let headers = [
  "X-Account-Token": "X-Account-Token",
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
]
let parameters = ["batch_items": [
    [
      "item_id": "string",
      "payload": []
    ]
  ]] as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://api.merge.dev/api/accounting/v1/sales-orders/bulk")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "POST"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```