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"
}{
"type": "https://www.rfc-editor.org/rfc/rfc7231#section-6.5.1",
"title": "One or more validation errors occurred.",
"status": 400,
"instance": "/api/route",
"traceId": "0HMPNHL0JHL76:00000001",
"detail": "<string>",
"errors": [
{
"name": "Error or field name",
"reason": "Error reason",
"code": "<string>",
"severity": "<string>"
}
]
}{
"type": "https://www.rfc-editor.org/rfc/rfc7231#section-6.5.1",
"title": "One or more validation errors occurred.",
"status": 400,
"instance": "/api/route",
"traceId": "0HMPNHL0JHL76:00000001",
"detail": "<string>",
"errors": [
{
"name": "Error or field name",
"reason": "Error reason",
"code": "<string>",
"severity": "<string>"
}
]
}{
"type": "https://www.rfc-editor.org/rfc/rfc7231#section-6.5.1",
"title": "One or more validation errors occurred.",
"status": 400,
"instance": "/api/route",
"traceId": "0HMPNHL0JHL76:00000001",
"detail": "<string>",
"errors": [
{
"name": "Error or field name",
"reason": "Error reason",
"code": "<string>",
"severity": "<string>"
}
]
}{
"type": "https://www.rfc-editor.org/rfc/rfc7231#section-6.5.1",
"title": "One or more validation errors occurred.",
"status": 400,
"instance": "/api/route",
"traceId": "0HMPNHL0JHL76:00000001",
"detail": "<string>",
"errors": [
{
"name": "Error or field name",
"reason": "Error reason",
"code": "<string>",
"severity": "<string>"
}
]
}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"
}{
"type": "https://www.rfc-editor.org/rfc/rfc7231#section-6.5.1",
"title": "One or more validation errors occurred.",
"status": 400,
"instance": "/api/route",
"traceId": "0HMPNHL0JHL76:00000001",
"detail": "<string>",
"errors": [
{
"name": "Error or field name",
"reason": "Error reason",
"code": "<string>",
"severity": "<string>"
}
]
}{
"type": "https://www.rfc-editor.org/rfc/rfc7231#section-6.5.1",
"title": "One or more validation errors occurred.",
"status": 400,
"instance": "/api/route",
"traceId": "0HMPNHL0JHL76:00000001",
"detail": "<string>",
"errors": [
{
"name": "Error or field name",
"reason": "Error reason",
"code": "<string>",
"severity": "<string>"
}
]
}{
"type": "https://www.rfc-editor.org/rfc/rfc7231#section-6.5.1",
"title": "One or more validation errors occurred.",
"status": 400,
"instance": "/api/route",
"traceId": "0HMPNHL0JHL76:00000001",
"detail": "<string>",
"errors": [
{
"name": "Error or field name",
"reason": "Error reason",
"code": "<string>",
"severity": "<string>"
}
]
}{
"type": "https://www.rfc-editor.org/rfc/rfc7231#section-6.5.1",
"title": "One or more validation errors occurred.",
"status": 400,
"instance": "/api/route",
"traceId": "0HMPNHL0JHL76:00000001",
"detail": "<string>",
"errors": [
{
"name": "Error or field name",
"reason": "Error reason",
"code": "<string>",
"severity": "<string>"
}
]
}Authorizations
oauth2-authorization-codeoauth2-client-credentials
The access token received from the authorization server in the OAuth 2.0 flow.
Headers
Optional, client-generated key for deduplicating repeated write requests. A repeated request with the same key returns the originally recorded result instead of executing the effect again.
Required string length:
1 - 255The 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?