Creates a new supplier.
curl --request POST \
--url https://api.jtl-cloud.com/erp/v2/suppliers \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'x-tenant-id: <x-tenant-id>' \
--data '
{
"companyName": "<string>",
"address": {
"street": "<string>",
"postalCode": "<string>",
"city": "<string>",
"countryIso": "<string>",
"salutation": "<string>",
"firstName": "<string>",
"lastName": "<string>",
"additionalCompanyLine": "<string>",
"additionalAddressLine": "<string>",
"state": "<string>"
},
"currencyIso": "<string>",
"languageIso": "<string>",
"defaultCompanyId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"defaultWarehouseId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"supplierNumber": "<string>",
"contact": {
"emailAddress": "<string>",
"phoneNumber": "<string>",
"phoneExtension": "<string>",
"faxNumber": "<string>",
"contactName": "<string>"
},
"status": "<string>",
"canDropship": true,
"supplierAccountNumber": "<string>",
"creditorNumber": 123,
"vatId": "<string>",
"freightCostAmount": 123,
"minimumOrderValueAmount": 123,
"smallQuantitySurchargeAmount": 123,
"cashDiscountPercentage": 123,
"cashDiscountDays": 123,
"paymentTermInDays": 123,
"freeShippingThresholdAmount": 123,
"deliveryTimeInDays": 123,
"website": "<string>",
"deliveryConditionNote": "<string>",
"comment": "<string>",
"isVatExempt": true,
"isExcludedFromPurchaseList": true,
"allowsDropshipCashOnDelivery": true,
"allowsDropshipFreeLineItems": true,
"vatFreePositionThresholdAmount": 123
}
'import requests
url = "https://api.jtl-cloud.com/erp/v2/suppliers"
payload = {
"companyName": "<string>",
"address": {
"street": "<string>",
"postalCode": "<string>",
"city": "<string>",
"countryIso": "<string>",
"salutation": "<string>",
"firstName": "<string>",
"lastName": "<string>",
"additionalCompanyLine": "<string>",
"additionalAddressLine": "<string>",
"state": "<string>"
},
"currencyIso": "<string>",
"languageIso": "<string>",
"defaultCompanyId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"defaultWarehouseId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"supplierNumber": "<string>",
"contact": {
"emailAddress": "<string>",
"phoneNumber": "<string>",
"phoneExtension": "<string>",
"faxNumber": "<string>",
"contactName": "<string>"
},
"status": "<string>",
"canDropship": True,
"supplierAccountNumber": "<string>",
"creditorNumber": 123,
"vatId": "<string>",
"freightCostAmount": 123,
"minimumOrderValueAmount": 123,
"smallQuantitySurchargeAmount": 123,
"cashDiscountPercentage": 123,
"cashDiscountDays": 123,
"paymentTermInDays": 123,
"freeShippingThresholdAmount": 123,
"deliveryTimeInDays": 123,
"website": "<string>",
"deliveryConditionNote": "<string>",
"comment": "<string>",
"isVatExempt": True,
"isExcludedFromPurchaseList": True,
"allowsDropshipCashOnDelivery": True,
"allowsDropshipFreeLineItems": True,
"vatFreePositionThresholdAmount": 123
}
headers = {
"x-tenant-id": "<x-tenant-id>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'x-tenant-id': '<x-tenant-id>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
companyName: '<string>',
address: {
street: '<string>',
postalCode: '<string>',
city: '<string>',
countryIso: '<string>',
salutation: '<string>',
firstName: '<string>',
lastName: '<string>',
additionalCompanyLine: '<string>',
additionalAddressLine: '<string>',
state: '<string>'
},
currencyIso: '<string>',
languageIso: '<string>',
defaultCompanyId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
defaultWarehouseId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
supplierNumber: '<string>',
contact: {
emailAddress: '<string>',
phoneNumber: '<string>',
phoneExtension: '<string>',
faxNumber: '<string>',
contactName: '<string>'
},
status: '<string>',
canDropship: true,
supplierAccountNumber: '<string>',
creditorNumber: 123,
vatId: '<string>',
freightCostAmount: 123,
minimumOrderValueAmount: 123,
smallQuantitySurchargeAmount: 123,
cashDiscountPercentage: 123,
cashDiscountDays: 123,
paymentTermInDays: 123,
freeShippingThresholdAmount: 123,
deliveryTimeInDays: 123,
website: '<string>',
deliveryConditionNote: '<string>',
comment: '<string>',
isVatExempt: true,
isExcludedFromPurchaseList: true,
allowsDropshipCashOnDelivery: true,
allowsDropshipFreeLineItems: true,
vatFreePositionThresholdAmount: 123
})
};
fetch('https://api.jtl-cloud.com/erp/v2/suppliers', 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.jtl-cloud.com/erp/v2/suppliers",
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([
'companyName' => '<string>',
'address' => [
'street' => '<string>',
'postalCode' => '<string>',
'city' => '<string>',
'countryIso' => '<string>',
'salutation' => '<string>',
'firstName' => '<string>',
'lastName' => '<string>',
'additionalCompanyLine' => '<string>',
'additionalAddressLine' => '<string>',
'state' => '<string>'
],
'currencyIso' => '<string>',
'languageIso' => '<string>',
'defaultCompanyId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'defaultWarehouseId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'supplierNumber' => '<string>',
'contact' => [
'emailAddress' => '<string>',
'phoneNumber' => '<string>',
'phoneExtension' => '<string>',
'faxNumber' => '<string>',
'contactName' => '<string>'
],
'status' => '<string>',
'canDropship' => true,
'supplierAccountNumber' => '<string>',
'creditorNumber' => 123,
'vatId' => '<string>',
'freightCostAmount' => 123,
'minimumOrderValueAmount' => 123,
'smallQuantitySurchargeAmount' => 123,
'cashDiscountPercentage' => 123,
'cashDiscountDays' => 123,
'paymentTermInDays' => 123,
'freeShippingThresholdAmount' => 123,
'deliveryTimeInDays' => 123,
'website' => '<string>',
'deliveryConditionNote' => '<string>',
'comment' => '<string>',
'isVatExempt' => true,
'isExcludedFromPurchaseList' => true,
'allowsDropshipCashOnDelivery' => true,
'allowsDropshipFreeLineItems' => true,
'vatFreePositionThresholdAmount' => 123
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"x-tenant-id: <x-tenant-id>"
],
]);
$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.jtl-cloud.com/erp/v2/suppliers"
payload := strings.NewReader("{\n \"companyName\": \"<string>\",\n \"address\": {\n \"street\": \"<string>\",\n \"postalCode\": \"<string>\",\n \"city\": \"<string>\",\n \"countryIso\": \"<string>\",\n \"salutation\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"additionalCompanyLine\": \"<string>\",\n \"additionalAddressLine\": \"<string>\",\n \"state\": \"<string>\"\n },\n \"currencyIso\": \"<string>\",\n \"languageIso\": \"<string>\",\n \"defaultCompanyId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"defaultWarehouseId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"supplierNumber\": \"<string>\",\n \"contact\": {\n \"emailAddress\": \"<string>\",\n \"phoneNumber\": \"<string>\",\n \"phoneExtension\": \"<string>\",\n \"faxNumber\": \"<string>\",\n \"contactName\": \"<string>\"\n },\n \"status\": \"<string>\",\n \"canDropship\": true,\n \"supplierAccountNumber\": \"<string>\",\n \"creditorNumber\": 123,\n \"vatId\": \"<string>\",\n \"freightCostAmount\": 123,\n \"minimumOrderValueAmount\": 123,\n \"smallQuantitySurchargeAmount\": 123,\n \"cashDiscountPercentage\": 123,\n \"cashDiscountDays\": 123,\n \"paymentTermInDays\": 123,\n \"freeShippingThresholdAmount\": 123,\n \"deliveryTimeInDays\": 123,\n \"website\": \"<string>\",\n \"deliveryConditionNote\": \"<string>\",\n \"comment\": \"<string>\",\n \"isVatExempt\": true,\n \"isExcludedFromPurchaseList\": true,\n \"allowsDropshipCashOnDelivery\": true,\n \"allowsDropshipFreeLineItems\": true,\n \"vatFreePositionThresholdAmount\": 123\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-tenant-id", "<x-tenant-id>")
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.jtl-cloud.com/erp/v2/suppliers")
.header("x-tenant-id", "<x-tenant-id>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"companyName\": \"<string>\",\n \"address\": {\n \"street\": \"<string>\",\n \"postalCode\": \"<string>\",\n \"city\": \"<string>\",\n \"countryIso\": \"<string>\",\n \"salutation\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"additionalCompanyLine\": \"<string>\",\n \"additionalAddressLine\": \"<string>\",\n \"state\": \"<string>\"\n },\n \"currencyIso\": \"<string>\",\n \"languageIso\": \"<string>\",\n \"defaultCompanyId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"defaultWarehouseId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"supplierNumber\": \"<string>\",\n \"contact\": {\n \"emailAddress\": \"<string>\",\n \"phoneNumber\": \"<string>\",\n \"phoneExtension\": \"<string>\",\n \"faxNumber\": \"<string>\",\n \"contactName\": \"<string>\"\n },\n \"status\": \"<string>\",\n \"canDropship\": true,\n \"supplierAccountNumber\": \"<string>\",\n \"creditorNumber\": 123,\n \"vatId\": \"<string>\",\n \"freightCostAmount\": 123,\n \"minimumOrderValueAmount\": 123,\n \"smallQuantitySurchargeAmount\": 123,\n \"cashDiscountPercentage\": 123,\n \"cashDiscountDays\": 123,\n \"paymentTermInDays\": 123,\n \"freeShippingThresholdAmount\": 123,\n \"deliveryTimeInDays\": 123,\n \"website\": \"<string>\",\n \"deliveryConditionNote\": \"<string>\",\n \"comment\": \"<string>\",\n \"isVatExempt\": true,\n \"isExcludedFromPurchaseList\": true,\n \"allowsDropshipCashOnDelivery\": true,\n \"allowsDropshipFreeLineItems\": true,\n \"vatFreePositionThresholdAmount\": 123\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.jtl-cloud.com/erp/v2/suppliers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-tenant-id"] = '<x-tenant-id>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"companyName\": \"<string>\",\n \"address\": {\n \"street\": \"<string>\",\n \"postalCode\": \"<string>\",\n \"city\": \"<string>\",\n \"countryIso\": \"<string>\",\n \"salutation\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"additionalCompanyLine\": \"<string>\",\n \"additionalAddressLine\": \"<string>\",\n \"state\": \"<string>\"\n },\n \"currencyIso\": \"<string>\",\n \"languageIso\": \"<string>\",\n \"defaultCompanyId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"defaultWarehouseId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"supplierNumber\": \"<string>\",\n \"contact\": {\n \"emailAddress\": \"<string>\",\n \"phoneNumber\": \"<string>\",\n \"phoneExtension\": \"<string>\",\n \"faxNumber\": \"<string>\",\n \"contactName\": \"<string>\"\n },\n \"status\": \"<string>\",\n \"canDropship\": true,\n \"supplierAccountNumber\": \"<string>\",\n \"creditorNumber\": 123,\n \"vatId\": \"<string>\",\n \"freightCostAmount\": 123,\n \"minimumOrderValueAmount\": 123,\n \"smallQuantitySurchargeAmount\": 123,\n \"cashDiscountPercentage\": 123,\n \"cashDiscountDays\": 123,\n \"paymentTermInDays\": 123,\n \"freeShippingThresholdAmount\": 123,\n \"deliveryTimeInDays\": 123,\n \"website\": \"<string>\",\n \"deliveryConditionNote\": \"<string>\",\n \"comment\": \"<string>\",\n \"isVatExempt\": true,\n \"isExcludedFromPurchaseList\": true,\n \"allowsDropshipCashOnDelivery\": true,\n \"allowsDropshipFreeLineItems\": true,\n \"vatFreePositionThresholdAmount\": 123\n}"
response = http.request(request)
puts response.read_body{
"id": "b45f6432-2462-4c6f-b00f-1d9d01000000"
}wawi
Creates a new supplier.
Creates a new supplier.
POST
/
v2
/
suppliers
Creates a new supplier.
curl --request POST \
--url https://api.jtl-cloud.com/erp/v2/suppliers \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'x-tenant-id: <x-tenant-id>' \
--data '
{
"companyName": "<string>",
"address": {
"street": "<string>",
"postalCode": "<string>",
"city": "<string>",
"countryIso": "<string>",
"salutation": "<string>",
"firstName": "<string>",
"lastName": "<string>",
"additionalCompanyLine": "<string>",
"additionalAddressLine": "<string>",
"state": "<string>"
},
"currencyIso": "<string>",
"languageIso": "<string>",
"defaultCompanyId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"defaultWarehouseId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"supplierNumber": "<string>",
"contact": {
"emailAddress": "<string>",
"phoneNumber": "<string>",
"phoneExtension": "<string>",
"faxNumber": "<string>",
"contactName": "<string>"
},
"status": "<string>",
"canDropship": true,
"supplierAccountNumber": "<string>",
"creditorNumber": 123,
"vatId": "<string>",
"freightCostAmount": 123,
"minimumOrderValueAmount": 123,
"smallQuantitySurchargeAmount": 123,
"cashDiscountPercentage": 123,
"cashDiscountDays": 123,
"paymentTermInDays": 123,
"freeShippingThresholdAmount": 123,
"deliveryTimeInDays": 123,
"website": "<string>",
"deliveryConditionNote": "<string>",
"comment": "<string>",
"isVatExempt": true,
"isExcludedFromPurchaseList": true,
"allowsDropshipCashOnDelivery": true,
"allowsDropshipFreeLineItems": true,
"vatFreePositionThresholdAmount": 123
}
'import requests
url = "https://api.jtl-cloud.com/erp/v2/suppliers"
payload = {
"companyName": "<string>",
"address": {
"street": "<string>",
"postalCode": "<string>",
"city": "<string>",
"countryIso": "<string>",
"salutation": "<string>",
"firstName": "<string>",
"lastName": "<string>",
"additionalCompanyLine": "<string>",
"additionalAddressLine": "<string>",
"state": "<string>"
},
"currencyIso": "<string>",
"languageIso": "<string>",
"defaultCompanyId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"defaultWarehouseId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"supplierNumber": "<string>",
"contact": {
"emailAddress": "<string>",
"phoneNumber": "<string>",
"phoneExtension": "<string>",
"faxNumber": "<string>",
"contactName": "<string>"
},
"status": "<string>",
"canDropship": True,
"supplierAccountNumber": "<string>",
"creditorNumber": 123,
"vatId": "<string>",
"freightCostAmount": 123,
"minimumOrderValueAmount": 123,
"smallQuantitySurchargeAmount": 123,
"cashDiscountPercentage": 123,
"cashDiscountDays": 123,
"paymentTermInDays": 123,
"freeShippingThresholdAmount": 123,
"deliveryTimeInDays": 123,
"website": "<string>",
"deliveryConditionNote": "<string>",
"comment": "<string>",
"isVatExempt": True,
"isExcludedFromPurchaseList": True,
"allowsDropshipCashOnDelivery": True,
"allowsDropshipFreeLineItems": True,
"vatFreePositionThresholdAmount": 123
}
headers = {
"x-tenant-id": "<x-tenant-id>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'x-tenant-id': '<x-tenant-id>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
companyName: '<string>',
address: {
street: '<string>',
postalCode: '<string>',
city: '<string>',
countryIso: '<string>',
salutation: '<string>',
firstName: '<string>',
lastName: '<string>',
additionalCompanyLine: '<string>',
additionalAddressLine: '<string>',
state: '<string>'
},
currencyIso: '<string>',
languageIso: '<string>',
defaultCompanyId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
defaultWarehouseId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
supplierNumber: '<string>',
contact: {
emailAddress: '<string>',
phoneNumber: '<string>',
phoneExtension: '<string>',
faxNumber: '<string>',
contactName: '<string>'
},
status: '<string>',
canDropship: true,
supplierAccountNumber: '<string>',
creditorNumber: 123,
vatId: '<string>',
freightCostAmount: 123,
minimumOrderValueAmount: 123,
smallQuantitySurchargeAmount: 123,
cashDiscountPercentage: 123,
cashDiscountDays: 123,
paymentTermInDays: 123,
freeShippingThresholdAmount: 123,
deliveryTimeInDays: 123,
website: '<string>',
deliveryConditionNote: '<string>',
comment: '<string>',
isVatExempt: true,
isExcludedFromPurchaseList: true,
allowsDropshipCashOnDelivery: true,
allowsDropshipFreeLineItems: true,
vatFreePositionThresholdAmount: 123
})
};
fetch('https://api.jtl-cloud.com/erp/v2/suppliers', 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.jtl-cloud.com/erp/v2/suppliers",
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([
'companyName' => '<string>',
'address' => [
'street' => '<string>',
'postalCode' => '<string>',
'city' => '<string>',
'countryIso' => '<string>',
'salutation' => '<string>',
'firstName' => '<string>',
'lastName' => '<string>',
'additionalCompanyLine' => '<string>',
'additionalAddressLine' => '<string>',
'state' => '<string>'
],
'currencyIso' => '<string>',
'languageIso' => '<string>',
'defaultCompanyId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'defaultWarehouseId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'supplierNumber' => '<string>',
'contact' => [
'emailAddress' => '<string>',
'phoneNumber' => '<string>',
'phoneExtension' => '<string>',
'faxNumber' => '<string>',
'contactName' => '<string>'
],
'status' => '<string>',
'canDropship' => true,
'supplierAccountNumber' => '<string>',
'creditorNumber' => 123,
'vatId' => '<string>',
'freightCostAmount' => 123,
'minimumOrderValueAmount' => 123,
'smallQuantitySurchargeAmount' => 123,
'cashDiscountPercentage' => 123,
'cashDiscountDays' => 123,
'paymentTermInDays' => 123,
'freeShippingThresholdAmount' => 123,
'deliveryTimeInDays' => 123,
'website' => '<string>',
'deliveryConditionNote' => '<string>',
'comment' => '<string>',
'isVatExempt' => true,
'isExcludedFromPurchaseList' => true,
'allowsDropshipCashOnDelivery' => true,
'allowsDropshipFreeLineItems' => true,
'vatFreePositionThresholdAmount' => 123
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"x-tenant-id: <x-tenant-id>"
],
]);
$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.jtl-cloud.com/erp/v2/suppliers"
payload := strings.NewReader("{\n \"companyName\": \"<string>\",\n \"address\": {\n \"street\": \"<string>\",\n \"postalCode\": \"<string>\",\n \"city\": \"<string>\",\n \"countryIso\": \"<string>\",\n \"salutation\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"additionalCompanyLine\": \"<string>\",\n \"additionalAddressLine\": \"<string>\",\n \"state\": \"<string>\"\n },\n \"currencyIso\": \"<string>\",\n \"languageIso\": \"<string>\",\n \"defaultCompanyId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"defaultWarehouseId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"supplierNumber\": \"<string>\",\n \"contact\": {\n \"emailAddress\": \"<string>\",\n \"phoneNumber\": \"<string>\",\n \"phoneExtension\": \"<string>\",\n \"faxNumber\": \"<string>\",\n \"contactName\": \"<string>\"\n },\n \"status\": \"<string>\",\n \"canDropship\": true,\n \"supplierAccountNumber\": \"<string>\",\n \"creditorNumber\": 123,\n \"vatId\": \"<string>\",\n \"freightCostAmount\": 123,\n \"minimumOrderValueAmount\": 123,\n \"smallQuantitySurchargeAmount\": 123,\n \"cashDiscountPercentage\": 123,\n \"cashDiscountDays\": 123,\n \"paymentTermInDays\": 123,\n \"freeShippingThresholdAmount\": 123,\n \"deliveryTimeInDays\": 123,\n \"website\": \"<string>\",\n \"deliveryConditionNote\": \"<string>\",\n \"comment\": \"<string>\",\n \"isVatExempt\": true,\n \"isExcludedFromPurchaseList\": true,\n \"allowsDropshipCashOnDelivery\": true,\n \"allowsDropshipFreeLineItems\": true,\n \"vatFreePositionThresholdAmount\": 123\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-tenant-id", "<x-tenant-id>")
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.jtl-cloud.com/erp/v2/suppliers")
.header("x-tenant-id", "<x-tenant-id>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"companyName\": \"<string>\",\n \"address\": {\n \"street\": \"<string>\",\n \"postalCode\": \"<string>\",\n \"city\": \"<string>\",\n \"countryIso\": \"<string>\",\n \"salutation\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"additionalCompanyLine\": \"<string>\",\n \"additionalAddressLine\": \"<string>\",\n \"state\": \"<string>\"\n },\n \"currencyIso\": \"<string>\",\n \"languageIso\": \"<string>\",\n \"defaultCompanyId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"defaultWarehouseId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"supplierNumber\": \"<string>\",\n \"contact\": {\n \"emailAddress\": \"<string>\",\n \"phoneNumber\": \"<string>\",\n \"phoneExtension\": \"<string>\",\n \"faxNumber\": \"<string>\",\n \"contactName\": \"<string>\"\n },\n \"status\": \"<string>\",\n \"canDropship\": true,\n \"supplierAccountNumber\": \"<string>\",\n \"creditorNumber\": 123,\n \"vatId\": \"<string>\",\n \"freightCostAmount\": 123,\n \"minimumOrderValueAmount\": 123,\n \"smallQuantitySurchargeAmount\": 123,\n \"cashDiscountPercentage\": 123,\n \"cashDiscountDays\": 123,\n \"paymentTermInDays\": 123,\n \"freeShippingThresholdAmount\": 123,\n \"deliveryTimeInDays\": 123,\n \"website\": \"<string>\",\n \"deliveryConditionNote\": \"<string>\",\n \"comment\": \"<string>\",\n \"isVatExempt\": true,\n \"isExcludedFromPurchaseList\": true,\n \"allowsDropshipCashOnDelivery\": true,\n \"allowsDropshipFreeLineItems\": true,\n \"vatFreePositionThresholdAmount\": 123\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.jtl-cloud.com/erp/v2/suppliers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-tenant-id"] = '<x-tenant-id>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"companyName\": \"<string>\",\n \"address\": {\n \"street\": \"<string>\",\n \"postalCode\": \"<string>\",\n \"city\": \"<string>\",\n \"countryIso\": \"<string>\",\n \"salutation\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"additionalCompanyLine\": \"<string>\",\n \"additionalAddressLine\": \"<string>\",\n \"state\": \"<string>\"\n },\n \"currencyIso\": \"<string>\",\n \"languageIso\": \"<string>\",\n \"defaultCompanyId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"defaultWarehouseId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"supplierNumber\": \"<string>\",\n \"contact\": {\n \"emailAddress\": \"<string>\",\n \"phoneNumber\": \"<string>\",\n \"phoneExtension\": \"<string>\",\n \"faxNumber\": \"<string>\",\n \"contactName\": \"<string>\"\n },\n \"status\": \"<string>\",\n \"canDropship\": true,\n \"supplierAccountNumber\": \"<string>\",\n \"creditorNumber\": 123,\n \"vatId\": \"<string>\",\n \"freightCostAmount\": 123,\n \"minimumOrderValueAmount\": 123,\n \"smallQuantitySurchargeAmount\": 123,\n \"cashDiscountPercentage\": 123,\n \"cashDiscountDays\": 123,\n \"paymentTermInDays\": 123,\n \"freeShippingThresholdAmount\": 123,\n \"deliveryTimeInDays\": 123,\n \"website\": \"<string>\",\n \"deliveryConditionNote\": \"<string>\",\n \"comment\": \"<string>\",\n \"isVatExempt\": true,\n \"isExcludedFromPurchaseList\": true,\n \"allowsDropshipCashOnDelivery\": true,\n \"allowsDropshipFreeLineItems\": true,\n \"vatFreePositionThresholdAmount\": 123\n}"
response = http.request(request)
puts response.read_body{
"id": "b45f6432-2462-4c6f-b00f-1d9d01000000"
}Authorizations
oauth2-authorization-codeoauth2-client-credentials
The access token received from the authorization server in the OAuth 2.0 flow.
Headers
The tenant ID for the target ERP instance.
Body
application/json
Request model for CreateSupplier command endpoint. Route parameters bind from the route, query parameters from the query string, everything else from the body.
Company name of the supplier.
Postal address of the supplier.
Show child attributes
Show child attributes
ISO code of the supplier's currency.
ISO code of the language assigned to the supplier.
Default own-company used for orders with this supplier. A supplier always has an assigned company.
Example:
"b45f6432-2462-4c6f-b00f-1d9d01000000"
Default warehouse used for orders with this supplier. A supplier always has an assigned warehouse.
Example:
"b45f6432-2462-4c6f-b00f-1d9d01000000"
Supplier number (free-text supplier identifier held at the merchant).
Contact information of the supplier.
Show child attributes
Show child attributes
Free-text status of the supplier.
Indicates whether the supplier can be used for dropshipping. Defaults to false when omitted.
The supplier's own customer number for the merchant ("Eigene Kd.-Nr.").
Creditor number of the supplier.
VAT identification number of the supplier.
Freight cost charged by the supplier.
Minimum order value required by the supplier.
Surcharge applied by the supplier for small quantities.
Cash discount percentage granted by the supplier.
Number of days within which the cash discount applies.
Payment term in days agreed with the supplier.
Order value from which the supplier ships free of charge.
Delivery time in days of the supplier.
Website URL of the supplier.
Note on the delivery conditions of the supplier.
Free-text comment on the supplier.
Indicates whether the supplier is exempt from VAT. Defaults to false when omitted.
Indicates whether the supplier is excluded from the purchase list. Defaults to false when omitted.
Indicates whether cash-on-delivery dropshipping is allowed. Defaults to false when omitted.
Indicates whether free line items are allowed in dropshipping. Defaults to false when omitted.
Order value threshold above which line items are treated as VAT-free.
Response
Supplier created successfully.
Creates a new supplier. - Response
The key of the newly created supplier.
Example:
"b45f6432-2462-4c6f-b00f-1d9d01000000"
Was this page helpful?
⌘I