> ## Documentation Index
> Fetch the complete documentation index at: https://developer.jtl-software.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CreateSupplierCommandRequestInput

> Creates a new supplier. Errors: errorCode is SUPPLIER_COMPANY_NAME_REQUIRED, SUPPLIER_ADDRESS_REQUIRED, SUPPLIER_STREET_REQUIRED, SUPPLIER_POSTAL_CODE_REQUIRED, SUPPLIER_CITY_REQUIRED, SUPPLIER_COUNTRY_ISO_REQUIRED, SUPPLIER_LANGUAGE_ISO_REQUIRED, SUPPLIER_CURRENCY_ISO_REQUIRED (a required value is missing), SUPPLIER_VALUE_TOO_LONG (a value exceeds its maximum length), SUPPLIER_EMAIL_INVALID (the e-mail address is not valid), SUPPLIER_CASH_DISCOUNT_PERCENTAGE_REQUIRED (a cash discount period is set without a positive percentage), SUPPLIER_DEFAULT_COMPANY_ID_REQUIRED, SUPPLIER_DEFAULT_WAREHOUSE_ID_REQUIRED, SUPPLIER_INVALID_DEFAULT_COMPANY_ID, SUPPLIER_INVALID_DEFAULT_WAREHOUSE_ID (the default company or warehouse is missing or does not exist). - Request



**Kind**: `input`

## Fields

**`companyName`**: `String!` (required)

The company name of the supplier.

---

**`supplierNumber`**: `String`

The supplier number.

---

**`supplierAccountNumber`**: `String`

The merchant's own customer number at the supplier.

---

**`statusNote`**: `String`

A free-text note on the status of the supplier. It has no meaning for the system.

---

**`address`**: `SupplierAddressInput!` (required)

The postal address of the supplier.

---

**`contact`**: `SupplierContactInput`

The contact details of the supplier. Omitted means none.

---

**`deliveryConditions`**: `SupplierDeliveryConditionsInput`

The delivery and order conditions of the supplier. Omitted fields are empty or zero.

---

**`paymentConditions`**: `SupplierPaymentConditionsInput`

The payment conditions of the supplier. Omitted fields are empty or zero.

---

**`dropshipping`**: `SupplierDropshippingInput`

The dropshipping settings of the supplier. Sending them enables dropshipping for the supplier; omitted fields are false. Omitted means the supplier does not support dropshipping.

---

**`languageTag`**: `String!` (required)

The language of the supplier as BCP 47 tag, for example 'de' or 'de-AT'. Case does not matter on input; the output uses the canonical form (language lower case, region upper case).

---

**`currencyCode`**: `String!` (required)

The currency of the supplier as an ISO 4217 alpha-3 code, for example 'EUR'. Input is case-insensitive.

---

**`creditorNumber`**: `Int`

The creditor number of the supplier in accounting.

---

**`vatId`**: `String`

The VAT identification number of the supplier.

---

**`isVatExempt`**: `Boolean`

Whether purchases from the supplier are exempt from VAT. Omitted means false.

---

**`isExcludedFromPurchaseList`**: `Boolean`

Whether the supplier is excluded from the purchase list. Omitted means false.

---

**`defaultCompanyId`**: `ID!` (required)

The own company that purchase orders to the supplier are placed for by default. Must be an existing company.

---

**`defaultWarehouseId`**: `ID!` (required)

The warehouse that goods ordered from the supplier are delivered to by default. Must be an existing warehouse.

---

**`website`**: `String`

The website of the supplier.

---

**`comment`**: `String`

A free-text comment on the supplier.

---

**`idempotencyKey`**: `String`

Client-supplied idempotency key. When provided, a repeated request with the same key and payload replays the original result instead of re-executing the mutation.