Push a batch of customer master records from Boomi
curl --request POST \
--url https://api.example.com/v2/integrations/providers/boomi/customers \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
[
{
"customer_code": "<string>",
"name1": "<string>",
"name2": "<string>",
"name3": "<string>",
"street": "<string>",
"house_num1": "<string>",
"house_num2": "<string>",
"post_code1": "<string>",
"city1": "<string>",
"city2": "<string>",
"region": "<string>",
"country": "<string>",
"accounting_clerk": "<string>",
"accounting_clerk_name": "<string>",
"smtp_addr": "<string>",
"tel_number": "<string>",
"telnr_long": "<string>",
"tax_jurisdiction": "<string>",
"payment_method": "<string>",
"search_term": "<string>",
"vendor_account_number": "<string>",
"company_code": "<string>"
}
]
'import requests
url = "https://api.example.com/v2/integrations/providers/boomi/customers"
payload = [
{
"customer_code": "<string>",
"name1": "<string>",
"name2": "<string>",
"name3": "<string>",
"street": "<string>",
"house_num1": "<string>",
"house_num2": "<string>",
"post_code1": "<string>",
"city1": "<string>",
"city2": "<string>",
"region": "<string>",
"country": "<string>",
"accounting_clerk": "<string>",
"accounting_clerk_name": "<string>",
"smtp_addr": "<string>",
"tel_number": "<string>",
"telnr_long": "<string>",
"tax_jurisdiction": "<string>",
"payment_method": "<string>",
"search_term": "<string>",
"vendor_account_number": "<string>",
"company_code": "<string>"
}
]
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify([
{
customer_code: '<string>',
name1: '<string>',
name2: '<string>',
name3: '<string>',
street: '<string>',
house_num1: '<string>',
house_num2: '<string>',
post_code1: '<string>',
city1: '<string>',
city2: '<string>',
region: '<string>',
country: '<string>',
accounting_clerk: '<string>',
accounting_clerk_name: '<string>',
smtp_addr: '<string>',
tel_number: '<string>',
telnr_long: '<string>',
tax_jurisdiction: '<string>',
payment_method: '<string>',
search_term: '<string>',
vendor_account_number: '<string>',
company_code: '<string>'
}
])
};
fetch('https://api.example.com/v2/integrations/providers/boomi/customers', 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.example.com/v2/integrations/providers/boomi/customers",
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([
[
'customer_code' => '<string>',
'name1' => '<string>',
'name2' => '<string>',
'name3' => '<string>',
'street' => '<string>',
'house_num1' => '<string>',
'house_num2' => '<string>',
'post_code1' => '<string>',
'city1' => '<string>',
'city2' => '<string>',
'region' => '<string>',
'country' => '<string>',
'accounting_clerk' => '<string>',
'accounting_clerk_name' => '<string>',
'smtp_addr' => '<string>',
'tel_number' => '<string>',
'telnr_long' => '<string>',
'tax_jurisdiction' => '<string>',
'payment_method' => '<string>',
'search_term' => '<string>',
'vendor_account_number' => '<string>',
'company_code' => '<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/v2/integrations/providers/boomi/customers"
payload := strings.NewReader("[\n {\n \"customer_code\": \"<string>\",\n \"name1\": \"<string>\",\n \"name2\": \"<string>\",\n \"name3\": \"<string>\",\n \"street\": \"<string>\",\n \"house_num1\": \"<string>\",\n \"house_num2\": \"<string>\",\n \"post_code1\": \"<string>\",\n \"city1\": \"<string>\",\n \"city2\": \"<string>\",\n \"region\": \"<string>\",\n \"country\": \"<string>\",\n \"accounting_clerk\": \"<string>\",\n \"accounting_clerk_name\": \"<string>\",\n \"smtp_addr\": \"<string>\",\n \"tel_number\": \"<string>\",\n \"telnr_long\": \"<string>\",\n \"tax_jurisdiction\": \"<string>\",\n \"payment_method\": \"<string>\",\n \"search_term\": \"<string>\",\n \"vendor_account_number\": \"<string>\",\n \"company_code\": \"<string>\"\n }\n]")
req, _ := http.NewRequest("POST", url, payload)
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(string(body))
}HttpResponse<String> response = Unirest.post("https://api.example.com/v2/integrations/providers/boomi/customers")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("[\n {\n \"customer_code\": \"<string>\",\n \"name1\": \"<string>\",\n \"name2\": \"<string>\",\n \"name3\": \"<string>\",\n \"street\": \"<string>\",\n \"house_num1\": \"<string>\",\n \"house_num2\": \"<string>\",\n \"post_code1\": \"<string>\",\n \"city1\": \"<string>\",\n \"city2\": \"<string>\",\n \"region\": \"<string>\",\n \"country\": \"<string>\",\n \"accounting_clerk\": \"<string>\",\n \"accounting_clerk_name\": \"<string>\",\n \"smtp_addr\": \"<string>\",\n \"tel_number\": \"<string>\",\n \"telnr_long\": \"<string>\",\n \"tax_jurisdiction\": \"<string>\",\n \"payment_method\": \"<string>\",\n \"search_term\": \"<string>\",\n \"vendor_account_number\": \"<string>\",\n \"company_code\": \"<string>\"\n }\n]")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/v2/integrations/providers/boomi/customers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "[\n {\n \"customer_code\": \"<string>\",\n \"name1\": \"<string>\",\n \"name2\": \"<string>\",\n \"name3\": \"<string>\",\n \"street\": \"<string>\",\n \"house_num1\": \"<string>\",\n \"house_num2\": \"<string>\",\n \"post_code1\": \"<string>\",\n \"city1\": \"<string>\",\n \"city2\": \"<string>\",\n \"region\": \"<string>\",\n \"country\": \"<string>\",\n \"accounting_clerk\": \"<string>\",\n \"accounting_clerk_name\": \"<string>\",\n \"smtp_addr\": \"<string>\",\n \"tel_number\": \"<string>\",\n \"telnr_long\": \"<string>\",\n \"tax_jurisdiction\": \"<string>\",\n \"payment_method\": \"<string>\",\n \"search_term\": \"<string>\",\n \"vendor_account_number\": \"<string>\",\n \"company_code\": \"<string>\"\n }\n]"
response = http.request(request)
puts response.read_body{
"received_at": "2023-11-07T05:31:56Z",
"results": [
{
"remote_id": "<string>",
"success": true,
"stuut_id": "<string>",
"error_code": "<string>",
"message": "<string>"
}
]
}{
"type": "<string>",
"status": 123,
"title": "<string>",
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
],
"detail": "<string>"
}integrations
Push a batch of customer master records from Boomi
Maximum 100 records per request. Each record is upserted by customer_code
against Partner.remote_id within the tenant resolved from the API key.
POST
/
v2
/
integrations
/
providers
/
boomi
/
customers
Push a batch of customer master records from Boomi
curl --request POST \
--url https://api.example.com/v2/integrations/providers/boomi/customers \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
[
{
"customer_code": "<string>",
"name1": "<string>",
"name2": "<string>",
"name3": "<string>",
"street": "<string>",
"house_num1": "<string>",
"house_num2": "<string>",
"post_code1": "<string>",
"city1": "<string>",
"city2": "<string>",
"region": "<string>",
"country": "<string>",
"accounting_clerk": "<string>",
"accounting_clerk_name": "<string>",
"smtp_addr": "<string>",
"tel_number": "<string>",
"telnr_long": "<string>",
"tax_jurisdiction": "<string>",
"payment_method": "<string>",
"search_term": "<string>",
"vendor_account_number": "<string>",
"company_code": "<string>"
}
]
'import requests
url = "https://api.example.com/v2/integrations/providers/boomi/customers"
payload = [
{
"customer_code": "<string>",
"name1": "<string>",
"name2": "<string>",
"name3": "<string>",
"street": "<string>",
"house_num1": "<string>",
"house_num2": "<string>",
"post_code1": "<string>",
"city1": "<string>",
"city2": "<string>",
"region": "<string>",
"country": "<string>",
"accounting_clerk": "<string>",
"accounting_clerk_name": "<string>",
"smtp_addr": "<string>",
"tel_number": "<string>",
"telnr_long": "<string>",
"tax_jurisdiction": "<string>",
"payment_method": "<string>",
"search_term": "<string>",
"vendor_account_number": "<string>",
"company_code": "<string>"
}
]
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify([
{
customer_code: '<string>',
name1: '<string>',
name2: '<string>',
name3: '<string>',
street: '<string>',
house_num1: '<string>',
house_num2: '<string>',
post_code1: '<string>',
city1: '<string>',
city2: '<string>',
region: '<string>',
country: '<string>',
accounting_clerk: '<string>',
accounting_clerk_name: '<string>',
smtp_addr: '<string>',
tel_number: '<string>',
telnr_long: '<string>',
tax_jurisdiction: '<string>',
payment_method: '<string>',
search_term: '<string>',
vendor_account_number: '<string>',
company_code: '<string>'
}
])
};
fetch('https://api.example.com/v2/integrations/providers/boomi/customers', 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.example.com/v2/integrations/providers/boomi/customers",
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([
[
'customer_code' => '<string>',
'name1' => '<string>',
'name2' => '<string>',
'name3' => '<string>',
'street' => '<string>',
'house_num1' => '<string>',
'house_num2' => '<string>',
'post_code1' => '<string>',
'city1' => '<string>',
'city2' => '<string>',
'region' => '<string>',
'country' => '<string>',
'accounting_clerk' => '<string>',
'accounting_clerk_name' => '<string>',
'smtp_addr' => '<string>',
'tel_number' => '<string>',
'telnr_long' => '<string>',
'tax_jurisdiction' => '<string>',
'payment_method' => '<string>',
'search_term' => '<string>',
'vendor_account_number' => '<string>',
'company_code' => '<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/v2/integrations/providers/boomi/customers"
payload := strings.NewReader("[\n {\n \"customer_code\": \"<string>\",\n \"name1\": \"<string>\",\n \"name2\": \"<string>\",\n \"name3\": \"<string>\",\n \"street\": \"<string>\",\n \"house_num1\": \"<string>\",\n \"house_num2\": \"<string>\",\n \"post_code1\": \"<string>\",\n \"city1\": \"<string>\",\n \"city2\": \"<string>\",\n \"region\": \"<string>\",\n \"country\": \"<string>\",\n \"accounting_clerk\": \"<string>\",\n \"accounting_clerk_name\": \"<string>\",\n \"smtp_addr\": \"<string>\",\n \"tel_number\": \"<string>\",\n \"telnr_long\": \"<string>\",\n \"tax_jurisdiction\": \"<string>\",\n \"payment_method\": \"<string>\",\n \"search_term\": \"<string>\",\n \"vendor_account_number\": \"<string>\",\n \"company_code\": \"<string>\"\n }\n]")
req, _ := http.NewRequest("POST", url, payload)
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(string(body))
}HttpResponse<String> response = Unirest.post("https://api.example.com/v2/integrations/providers/boomi/customers")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("[\n {\n \"customer_code\": \"<string>\",\n \"name1\": \"<string>\",\n \"name2\": \"<string>\",\n \"name3\": \"<string>\",\n \"street\": \"<string>\",\n \"house_num1\": \"<string>\",\n \"house_num2\": \"<string>\",\n \"post_code1\": \"<string>\",\n \"city1\": \"<string>\",\n \"city2\": \"<string>\",\n \"region\": \"<string>\",\n \"country\": \"<string>\",\n \"accounting_clerk\": \"<string>\",\n \"accounting_clerk_name\": \"<string>\",\n \"smtp_addr\": \"<string>\",\n \"tel_number\": \"<string>\",\n \"telnr_long\": \"<string>\",\n \"tax_jurisdiction\": \"<string>\",\n \"payment_method\": \"<string>\",\n \"search_term\": \"<string>\",\n \"vendor_account_number\": \"<string>\",\n \"company_code\": \"<string>\"\n }\n]")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/v2/integrations/providers/boomi/customers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "[\n {\n \"customer_code\": \"<string>\",\n \"name1\": \"<string>\",\n \"name2\": \"<string>\",\n \"name3\": \"<string>\",\n \"street\": \"<string>\",\n \"house_num1\": \"<string>\",\n \"house_num2\": \"<string>\",\n \"post_code1\": \"<string>\",\n \"city1\": \"<string>\",\n \"city2\": \"<string>\",\n \"region\": \"<string>\",\n \"country\": \"<string>\",\n \"accounting_clerk\": \"<string>\",\n \"accounting_clerk_name\": \"<string>\",\n \"smtp_addr\": \"<string>\",\n \"tel_number\": \"<string>\",\n \"telnr_long\": \"<string>\",\n \"tax_jurisdiction\": \"<string>\",\n \"payment_method\": \"<string>\",\n \"search_term\": \"<string>\",\n \"vendor_account_number\": \"<string>\",\n \"company_code\": \"<string>\"\n }\n]"
response = http.request(request)
puts response.read_body{
"received_at": "2023-11-07T05:31:56Z",
"results": [
{
"remote_id": "<string>",
"success": true,
"stuut_id": "<string>",
"error_code": "<string>",
"message": "<string>"
}
]
}{
"type": "<string>",
"status": 123,
"title": "<string>",
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
],
"detail": "<string>"
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
KNA1-KUNNR; maps to Partner.remote_id
KNA1-NAME1; maps to Partner.name
KNA1-NAME2; maps to Partner.legal_name
KNA1-NAME3; maps to Partner.name_3
ADRC-STREET
ADRC-HOUSE_NUM1
ADRC-HOUSE_NUM2; maps to Address.line2
ADRC-POST_CODE1; maps to Address.postal_code
ADRC-CITY1; maps to Address.city
ADRC-CITY2; maps to Partner.district
ADRC-REGION; maps to Address.state
ADRC-COUNTRY; ISO 3166 alpha-2
ADRC-ACCOUNTING_CLE1
ADR6-SMTP_ADDR
ADR2-TEL_NUMBER
ADR2-TELNR_LONG. Long-format / E.164 phone. If both tel_number and telnr_long are sent, telnr_long wins (Partner has a single phone field).
KNA1-TXJCD
ADRC-PAYMENT_MET1
ADRC-SEARCH_TER1
KNA1-LIFNR
BKPF-BUKRS of any document under which this customer was posted. Optional — tenant routing is via the inbound Bearer key. Stored as a custom field if provided.
⌘I