--- title: "Creates a new sales quotation." method: POST path: "/v2/salesquotation/create" tags: ["SalesQuotationDomainCommand"] --- # Creates a new sales quotation. `POST /v2/salesquotation/create` ## Headers - `x-tenant-id` string, uuid, required - `x-runas` string - `x-companyid` string ## Request body - JTLWawiVerkaufsverwaltungPublicApiDataTransferObjectsV2SalesQuotationDomainCreateSalesQuotationCommandRequest — Creates a new sales quotation. - Request - `disableAutomaticWorkflows` boolean — Indicates whether automatic workflows should be disabled for this sales quotation. - `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` JTLWawiVerkaufsverwaltungPublicApiDataTransferObjectsV2SalesQuotationDomainCreateCreateSalesQuotationAddress — Billing address details for the sales quotation. - `salutation` string — The SalesQuotationAddress Salutation - `title` string — The SalesQuotationAddress Title - `firstName` string — The SalesQuotationAddress FirstName - `lastName` string — The SalesQuotationAddress LastName - `company` string — The SalesQuotationAddress Company - `additionalCompanyLine` string — The SalesQuotationAddress AdditionalCompanyLine - `street` string — The SalesQuotationAddress Street - `additionalAddressLine` string — The SalesQuotationAddress AdditionalAddressLine - `city` string — The SalesQuotationAddress City - `postalCode` string — The SalesQuotationAddress PostalCode - `state` string — The SalesQuotationAddress State - `countryIso` string — The SalesQuotationAddress CountryISO - `postId` string — The SalesQuotationAddress PostId - `emailAddress` string — The SalesQuotationAddress EmailAddress - `phoneNumber` string — The SalesQuotationAddress PhoneNumber - `mobilePhoneNumber` string — The SalesQuotationAddress MobilePhoneNumber - `fax` string — The SalesQuotationAddress Fax - `departureCountry` JTLWawiVerkaufsverwaltungPublicApiDataTransferObjectsV2SalesQuotationDomainCreateCreateSalesQuotationDepartureCountry — Defines the departure country information for a sales quotation during its creation. - `countryIso` string — The ISO code of the departure country. - `currencyIso` string — The sales quotation departure country currency iso - `currencyFactor` number — The sales quotation departure country currency factor - `state` string — The SalesQuotation State - `externalDetails` JTLWawiVerkaufsverwaltungPublicApiDataTransferObjectsV2SalesQuotationDomainCreateCreateSalesQuotationExternalDetails — External details for the sales quotation. - `externalCreatedDate` string, date-time — The SalesQuotation ExternalCreatedDate - `externalInvoiceType` 0 | 1 | 2 — 0 = None, 1 = NoInvoiceNoOutput, 2 = NoInvoice - `externalSalesQuotationNumber` string — The SalesQuotation ExternalSalesQuotationNumber - `lineItems` JTLWawiVerkaufsverwaltungPublicApiDataTransferObjectsV2SalesQuotationDomainCreateCreateSalesQuotationLineItem[] — List of SalesQuotationLineItem - `itemId` string, uuid - `parentSalesQuotationLineItemId` 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 SalesQuotationLineItem FNSKU - `name` string — Name of the position. - `note` string — The SalesQuotationLineItem 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 quotation 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` JTLWawiVerkaufsverwaltungPublicApiDataTransferObjectsV2SalesQuotationDomainCreateCreateSalesQuotationLineItemVariant[] — List of SalesQuotationLineItemVariant - `extraWeight` number — The SalesQuotationLineItemVariant ExtraWeight - `name` string — The SalesQuotationLineItemVariant Name - `surchargeNet` number — The SalesQuotationLineItemVariant SurchargeNet - `value` string — The SalesQuotationLineItemVariant Value - `itemVariantId` string, uuid - `itemVariantValueId` string, uuid - `paymentDetails` JTLWawiVerkaufsverwaltungPublicApiDataTransferObjectsV2SalesQuotationDomainCreateCreateSalesQuotationPaymentDetails — Payment details for the new sales quotation. - `cashDiscount` number — The SalesQuotation CashDiscount - `cashDiscountDays` integer — The SalesQuotation CashDiscountDays - `financingCosts` number — The SalesQuotation FinancingCosts - `paymentDueDateInDays` integer — The SalesQuotation PaymentDueDateInDays - `currencyIso` string — The sales quotation departure country currency iso - `currencyFactor` number — The sales quotation departure country currency factor - `paymentInfo` JTLWawiVerkaufsverwaltungPublicApiDataTransferObjectsV2SalesQuotationDomainCreateCreateSalesQuotationPaymentInfo — Payment info for the new sales quotation. - `accountHolder` string — The SalesQuotationPaymentInfo AccountHolder - `bankName` string — The SalesQuotationPaymentInfo BankName - `bIC` string — The SalesQuotationPaymentInfo BIC - `creditorId` string — The SalesQuotationPaymentInfo CreditorId - `dueDate` string, date-time — The SalesQuotationPaymentInfo DueDate - `endToEndId` string — The SalesQuotationPaymentInfo EndToEndId - `iBAN` string — The SalesQuotationPaymentInfo IBAN - `mandateReference` string — The SalesQuotationPaymentInfo MandateReference - `paymentInfo` string — The SalesQuotationPaymentInfo PaymentInfo - `paymentReference` string — The SalesQuotationPaymentInfo PaymentReference - `referenceEmail` string — The SalesQuotationPaymentInfo ReferenceEmail - `shipmentAddress` JTLWawiVerkaufsverwaltungPublicApiDataTransferObjectsV2SalesQuotationDomainCreateCreateSalesQuotationAddress — Billing address details for the sales quotation. - `salutation` string — The SalesQuotationAddress Salutation - `title` string — The SalesQuotationAddress Title - `firstName` string — The SalesQuotationAddress FirstName - `lastName` string — The SalesQuotationAddress LastName - `company` string — The SalesQuotationAddress Company - `additionalCompanyLine` string — The SalesQuotationAddress AdditionalCompanyLine - `street` string — The SalesQuotationAddress Street - `additionalAddressLine` string — The SalesQuotationAddress AdditionalAddressLine - `city` string — The SalesQuotationAddress City - `postalCode` string — The SalesQuotationAddress PostalCode - `state` string — The SalesQuotationAddress State - `countryIso` string — The SalesQuotationAddress CountryISO - `postId` string — The SalesQuotationAddress PostId - `emailAddress` string — The SalesQuotationAddress EmailAddress - `phoneNumber` string — The SalesQuotationAddress PhoneNumber - `mobilePhoneNumber` string — The SalesQuotationAddress MobilePhoneNumber - `fax` string — The SalesQuotationAddress Fax - `shippingDetails` JTLWawiVerkaufsverwaltungPublicApiDataTransferObjectsV2SalesQuotationDomainCreateCreateSalesQuotationShippingDetails — Shipping details for the new sales quotation. - `deliveryFromDate` string, date-time — The SalesQuotation DeliveryFromDate - `estimatedDeliveryDate` string, date-time — The SalesQuotation EstimatedDeliveryDate - `extraWeight` number — The SalesQuotation ExtraWeight - `maxDeliveryDays` integer — The SalesQuotation MaxDeliveryDays - `shippingDate` string, date-time — The SalesQuotation ShippingDate - `shippingPriority` integer — The SalesQuotation ShippingPriority - `taxDetails` JTLWawiVerkaufsverwaltungPublicApiDataTransferObjectsV2SalesQuotationDomainCreateCreateSalesQuotationTaxDetails — Tax details for the new sales quotation. - `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` JTLWawiVerkaufsverwaltungPublicApiDataTransferObjectsV2SalesQuotationDomainCreateCreateSalesQuotationText — Text details for the new sales quotation. - `comment` string — The SalesQuotationText Comment - `customerComment` string — The SalesQuotationText CustomerComment - `printText` string — The SalesQuotationText PrintText - `processStatus` string — The SalesQuotationText ProcessStatus - `customerSalesQuotationNumber` string — The SalesQuotation CustomerSalesQuotationNumber - `customerVatId` string — The VAT ID of the customer. - `itemDescriptionType` 0 | 1 | 2 — 0 = None, 1 = Brief, 2 = Long - `languageIso` string — The SalesQuotation LanguageISO - `readOnlyType` 0 | 1 | 2 — 0 = ChangesAllowed, 1 = InvoicedExternally, 2 = ChangesForbidden - `salesQuotationDate` string, date-time — The SalesQuotation Date - `salesQuotationNumber` string — The SalesQuotation SalesQuotationNumber - `shippingMethodId` string, uuid - `vatId` string — The SalesQuotation VATId ## Response `201` Sales quotation 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/versions/f979b1ea6951/schema)