> ## 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. - Request



**Kind**: `input`

## Fields

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

Company name of the supplier.

---

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

Postal address of the supplier.

---

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

ISO code of the supplier's currency.

---

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

ISO code of the language assigned to the supplier.

---

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

Default own-company used for orders with this supplier. A supplier always has an assigned company.

---

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

Default warehouse used for orders with this supplier. A supplier always has an assigned warehouse.

---

**`supplierNumber`**: `String`

Supplier number (free-text supplier identifier held at the merchant).

---

**`contact`**: `CreateCreateSupplierContactInput`

Contact information of the supplier.

---

**`status`**: `String`

Free-text status of the supplier.

---

**`canDropship`**: `Boolean`

Indicates whether the supplier can be used for dropshipping. Defaults to false when omitted.

---

**`supplierAccountNumber`**: `String`

The supplier's own customer number for the merchant ("Eigene Kd.-Nr.").

---

**`creditorNumber`**: `Int`

Creditor number of the supplier.

---

**`vatId`**: `String`

VAT identification number of the supplier.

---

**`freightCostAmount`**: `Decimal`

Freight cost charged by the supplier.

---

**`minimumOrderValueAmount`**: `Decimal`

Minimum order value required by the supplier.

---

**`smallQuantitySurchargeAmount`**: `Decimal`

Surcharge applied by the supplier for small quantities.

---

**`cashDiscountPercentage`**: `Decimal`

Cash discount percentage granted by the supplier.

---

**`cashDiscountDays`**: `Int`

Number of days within which the cash discount applies.

---

**`paymentTermInDays`**: `Int`

Payment term in days agreed with the supplier.

---

**`freeShippingThresholdAmount`**: `Decimal`

Order value from which the supplier ships free of charge.

---

**`deliveryTimeInDays`**: `Int`

Delivery time in days of the supplier.

---

**`website`**: `String`

Website URL of the supplier.

---

**`deliveryConditionNote`**: `String`

Note on the delivery conditions of the supplier.

---

**`comment`**: `String`

Free-text comment on the supplier.

---

**`isVatExempt`**: `Boolean`

Indicates whether the supplier is exempt from VAT. Defaults to false when omitted.

---

**`isExcludedFromPurchaseList`**: `Boolean`

Indicates whether the supplier is excluded from the purchase list. Defaults to false when omitted.

---

**`allowsDropshipCashOnDelivery`**: `Boolean`

Indicates whether cash-on-delivery dropshipping is allowed. Defaults to false when omitted.

---

**`allowsDropshipFreeLineItems`**: `Boolean`

Indicates whether free line items are allowed in dropshipping. Defaults to false when omitted.

---

**`vatFreePositionThresholdAmount`**: `Decimal`

Order value threshold above which line items are treated as VAT-free.

---

**`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.

