--- title: "Creates a new sales order." method: POST path: "/v2/salesorder/create" tags: ["SalesOrderDomainCommand"] --- # Creates a new sales order. `POST /v2/salesorder/create` ## Headers - `x-tenant-id` string, uuid, required - `x-runas` string - `x-companyid` string ## Request body - JTLWawiVerkaufsverwaltungPublicApiDataTransferObjectsV2SalesOrderDomainCreateSalesOrderCommandRequest — Creates a new sales order. - Request - `disableAutomaticWorkflows` boolean — Indicates whether automatic workflows should be disabled for this sales order. - `useBillingAddressAsShipmentAddress` boolean — Indicates whether the billing address should be used as the shipment address. If no shipment address is provided and the flag ist not set, the billing address will also be used as shipment address. If the shipment address is provided, this flag will be ignored. - `cartonItemId` string, uuid - `companyId` string, uuid — Represents a key for identifying a firm within the application. - `customerId` string, uuid — Represents a unique key for identifying a customer in the JTL system. - `onHoldReasonId` string, uuid - `paymentMethodId` string, uuid - `processColourId` string, uuid — Represents a key for identifying a color entity in the system. - `processStatusId` string, uuid - `billingAddress` JTLWawiVerkaufsverwaltungPublicApiDataTransferObjectsV2SalesOrderDomainCreateCreateSalesOrderAddress — Address details for the sales order. - `salutation` string — The SalesOrderAddress Salutation - `title` string — The SalesOrderAddress Title - `firstName` string — The SalesOrderAddress FirstName - `lastName` string — The SalesOrderAddress LastName - `company` string — The SalesOrderAddress Company - `additionalCompanyLine` string — The SalesOrderAddress AdditionalCompanyLine - `street` string — The SalesOrderAddress Street - `additionalAddressLine` string — The SalesOrderAddress AdditionalAddressLine - `city` string — The SalesOrderAddress City - `postalCode` string — The SalesOrderAddress PostalCode - `state` string — The SalesOrderAddress State - `countryIso` string — The SalesOrderAddress CountryISO - `postId` string — The SalesOrderAddress PostId - `emailAddress` string — The SalesOrderAddress EmailAddress - `phoneNumber` string — The SalesOrderAddress PhoneNumber - `mobilePhoneNumber` string — The SalesOrderAddress MobilePhoneNumber - `fax` string — The SalesOrderAddress Fax - `vatId` string — The SalesOrderAddress VAT ID - `departureCountry` JTLWawiVerkaufsverwaltungPublicApiDataTransferObjectsV2SalesOrderDomainCreateCreateSalesOrderDepartureCountry — Defines the departure country information for a sales order during its creation. - `countryIso` string — The ISO code of the departure country. - `currencyIso` string — The sales order departure country currency iso - `currencyFactor` number — The sales order departure country currency factor - `state` string — The SalesOrder State - `externalDetails` JTLWawiVerkaufsverwaltungPublicApiDataTransferObjectsV2SalesOrderDomainCreateCreateSalesOrderExternalDetails — External details for the sales order. - `externalCreatedDate` string, date-time — The SalesOrder ExternalCreatedDate - `externalInvoiceType` 0 | 1 | 2 — 0 = None, 1 = NoInvoiceNoOutput, 2 = NoInvoice - `externalSalesOrderNumber` string — The SalesOrder ExternalSalesOrderNumber - `lineItems` JTLWawiVerkaufsverwaltungPublicApiDataTransferObjectsV2SalesOrderDomainCreateCreateSalesOrderLineItem[] — List of SalesOrderLineItem - `itemId` string, uuid - `parentSalesOrderLineItemId` string, uuid - `taxClassId` string, uuid - `taxCodeId` string, uuid - `billOfMaterialsType` 0 | 1 | 2 — 0 = None, 1 = BillOfMaterials, 2 = Component - `configurationItemType` 0 | 1 | 2 — 0 = None, 1 = ConfigurationItem, 2 = Component - `discountPercent` number — The discount of the line item. - `fnSku` string — The SalesOrderLineItem FNSKU - `name` string — Name of the position. - `note` string — The SalesOrderLineItem Note - `purchasePriceNet` number — The purchase price of the item. - `quantity` number — The quantity of the line item. - `salesPriceNet` number — The net sales price of the item. Only net or gross price can be entered. The other price will then be calculated. - `salesUnit` string — The sales unit of the line item. - `sku` string — SKU of the sales order line item. - `taxRate` number — The tax rate of the line item. - `type` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 — 0 = Custom, 1 = Item, 2 = Shipping, 3 = Coupon, 4 = Voucher, 5 = Payment, 6 = ShippingSurcharge, 7 = NewCustomerCoupon, 8 = CashOnDelivery, 9 = ShippingSurchargeItem, 10 = Packing, 11 = GiftForFree, 12 = TrustedShops, 13 = InterestPremium, 14 = ProcessingFee, 15 = Carton, 16 = ReturnDelivery, 17 = MultiPurposeVoucher, 18 = MultiPurposeVoucherDigital, 19 = SinglePurposeVoucher, 20 = SinglePurposeVoucherDigital, 21 = SinglePurposeVoucherRedemption - `variants` JTLWawiVerkaufsverwaltungPublicApiDataTransferObjectsV2SalesOrderDomainCreateCreateSalesOrderLineItemVariant[] — List of SalesOrderLineItemVariant - `extraWeight` number — The SalesOrderLineItemVariant ExtraWeight - `name` string — The SalesOrderLineItemVariant Name - `surchargeNet` number — The SalesOrderLineItemVariant SurchargeNet - `value` string — The SalesOrderLineItemVariant Value - `itemVariantId` string, uuid - `itemVariantValueId` string, uuid - `paymentDetails` JTLWawiVerkaufsverwaltungPublicApiDataTransferObjectsV2SalesOrderDomainCreateCreateSalesOrderPaymentDetails — Payment details for the new sales order. - `cashDiscount` number — The SalesOrder CashDiscount - `cashDiscountDays` integer — The SalesOrder CashDiscountDays - `paymentDueDateInDays` integer — The SalesOrder PaymentDueDateInDays - `currencyIso` string — The sales order departure country currency iso - `currencyFactor` number — The sales order departure country currency factor - `paymentInfo` JTLWawiVerkaufsverwaltungPublicApiDataTransferObjectsV2SalesOrderDomainCreateCreateSalesOrderPaymentInfo — Payment info for the new sales order. - `accountHolder` string — The SalesOrderPaymentInfo AccountHolder - `bankName` string — The SalesOrderPaymentInfo BankName - `bIC` string — The SalesOrderPaymentInfo BIC - `creditorId` string — The SalesOrderPaymentInfo CreditorId - `dueDate` string, date-time — The SalesOrderPaymentInfo DueDate - `endToEndId` string — The SalesOrderPaymentInfo EndToEndId - `iBAN` string — The SalesOrderPaymentInfo IBAN - `mandateReference` string — The SalesOrderPaymentInfo MandateReference - `paymentInfo` string — The SalesOrderPaymentInfo PaymentInfo - `paymentReference` string — The SalesOrderPaymentInfo PaymentReference - `referenceEmail` string — The SalesOrderPaymentInfo ReferenceEmail - `shipmentAddress` JTLWawiVerkaufsverwaltungPublicApiDataTransferObjectsV2SalesOrderDomainCreateCreateSalesOrderAddress — Address details for the sales order. - `salutation` string — The SalesOrderAddress Salutation - `title` string — The SalesOrderAddress Title - `firstName` string — The SalesOrderAddress FirstName - `lastName` string — The SalesOrderAddress LastName - `company` string — The SalesOrderAddress Company - `additionalCompanyLine` string — The SalesOrderAddress AdditionalCompanyLine - `street` string — The SalesOrderAddress Street - `additionalAddressLine` string — The SalesOrderAddress AdditionalAddressLine - `city` string — The SalesOrderAddress City - `postalCode` string — The SalesOrderAddress PostalCode - `state` string — The SalesOrderAddress State - `countryIso` string — The SalesOrderAddress CountryISO - `postId` string — The SalesOrderAddress PostId - `emailAddress` string — The SalesOrderAddress EmailAddress - `phoneNumber` string — The SalesOrderAddress PhoneNumber - `mobilePhoneNumber` string — The SalesOrderAddress MobilePhoneNumber - `fax` string — The SalesOrderAddress Fax - `vatId` string — The SalesOrderAddress VAT ID - `shippingDetails` JTLWawiVerkaufsverwaltungPublicApiDataTransferObjectsV2SalesOrderDomainCreateCreateSalesOrderShippingDetails — Shipping details for the new sales order. - `deliveryFromDate` string, date-time — The SalesOrder DeliveryFromDate - `estimatedDeliveryDate` string, date-time — The SalesOrder EstimatedDeliveryDate - `extraWeight` number — The SalesOrder ExtraWeight - `maxDeliveryDays` integer — The SalesOrder MaxDeliveryDays - `shippingDate` string, date-time — The SalesOrder ShippingDate - `shippingPriority` integer — The SalesOrder ShippingPriority - `taxDetails` JTLWawiVerkaufsverwaltungPublicApiDataTransferObjectsV2SalesOrderDomainCreateCreateSalesOrderTaxDetails — Tax details for the new sales order. - `taxReference` 0 | 1 — 0 = ShipmentAddress, 1 = BillingAddress - `specialTaxTreatment` 0 | 1 | 2 | 3 — 0 = None, 1 = ReverseCharge, 2 = ExemptFromVat, 3 = SubjectToVat - `taxSetting` 0 | 10 | 15 | 20 — 0 = DeliveryWithVat, 10 = IntraCommunityDelivery, 15 = ExemptFromVatReverseCharge, 20 = ExemptFromVat - `text` JTLWawiVerkaufsverwaltungPublicApiDataTransferObjectsV2SalesOrderDomainCreateCreateSalesOrderText — Tax details for the new sales order. - `comment` string — The SalesOrderText Comment - `customerComment` string — The SalesOrderText CustomerComment - `printText` string — The SalesOrderText PrintText - `processStatus` string — The SalesOrderText ProcessStatus - `customerSalesOrderNumber` string — The SalesOrder CustomerSalesOrderNumber - `itemDescriptionType` 0 | 1 | 2 — 0 = None, 1 = Brief, 2 = Long - `languageIso` string — The SalesOrder LanguageISO - `readOnlyType` 0 | 1 | 2 — 0 = ChangesAllowed, 1 = InvoicedExternally, 2 = ChangesForbidden - `salesOrderDate` string, date-time — The SalesOrder Date - `salesOrderNumber` string — The SalesOrder SalesOrderNumber - `shippingMethodId` string, uuid - `vatId` string — The SalesOrder VATId ## Response `201` Sales order created successfully --- [API](https://skmtc.net/jtl-software/apis/scx-authentication-api.md) · [All operations](https://skmtc.net/jtl-software/apis/scx-authentication-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jtl-software/scx-authentication-api/revisions/f979b1ea6951/schema)