# Order insertion This endpoint enables insert the order into Shoptet, which was created in other system. You can use it for an import from an older e-shop solution, or to transfer orders from external sales channels. A large amount of info can be set, but for regular usage only a few attributes are needed. Values of other attributes are added as per their default values. The detailed information can be found in the right pane, after clicking on title "Order insertion" above (search for "Request" and "Attributes” sections). Request is sent in JSON format in its body. Simple example (detailed example can be found in call example in right pane): Whether the field is mandatory, apart from the basic definition, also depends on whether the order was created via the cash desk () or via e-shop. Some fields from invoicing, delivery and contact data are mandatory or optional, as per e-shop settings (see also e-shop administration ). When the order is created, it is checked, whether the e-shop includes products with the respective code (can be suppressed with GET parameter ), the products from the order are deducted from the stock (can be suppressed with the GET parameter ), documentation is created for the order (can be suppressed with the GET parameter ), a confirmation e-mail is sent (can be suppressed with the GET parameter ) and a webhook is executed for the new order. Parameters and are to be used only for orders that will not be changed or deleted in the future. Editing or deleting such an order can damage the consistency of warehousing. Parameter can be used to disable mandatory fields checks, but only for "historical" orders ( is older than 24 hours). Keep in mind even historical orders should be kept consistent and complete as much as possible to allow their processing for statistics, volume calculations etc. Setting the mandatory items for invoicing and the delivery address can be different between individual e-shops. The mandatory items corresponds to the settings for ordering from the basket. Parameters and allow corresponding field ( and/or ) to be . In that case, if an billing/shipping item is provided in list, field must be filled in that item. To remove products from the stock, the shop (or product) setting as to whether the inventory can be negative or not is respected. If a negative value is not permitted for shopping and the order cannot be covered from the current inventory, the order is not created and the API returns an error message in the field. The order's minimum size or maximum number of items as per the settings of e-shop are not checked. The endpoint only checks the same parameters as the order detail. The order can be inserted while using currencies setup in the eshop (see ). The exchange rate related to the eshop default currency is optional. If not provided, the current eshop exchange rate will be used. For historical orders the exchange rate should be provided using the historical value of the order's creation date. Shoptet eshops do not store historical exchange rates. Warning: for SK and CZ different exchange rate format is used. You should use the same form as you get from the endpoint . We will internally convert it to the correct format to be compatible with eshop statistics calculations. Because of the conversion, the value of in the response will be different (inverse) to the one you had sent. When entering the order, the initial welcome e-mail is always sent. Even though the order status is set differently to the initial value, the e-mail associated with a status change is not sent, but the system welcome e-mail is (to e-shop operator and customer). When creating the receipt (invoice, proforma invoice, delivery note) the receipt is created with the current date and the 14 days due date, even though is given from the past. Examples of how to work with the order and items statuses, and how to ensure the correct insertion of a discount, can be found in a separate [article at developers.shoptet.com](https://developers.shoptet.com/api/documentation/creating-order/) After the order is successfully created, you will receive a response with a 201 code and a response structure matching the order detail, which is returned by endpoint. - .. maxLength 10 characters - .. maxLength 100 characters - .. maxLength 32 characters - .. maxLength 255 characters - .. maxLength 255 characters - .. maxLength 255 characters - .. maxLength 255 characters - .. maxLength 255 characters - .. maxLength 255 characters - .. maxLength 255 characters - .. maxLength 255 characters - .. maxLength 255 characters - .. maxLength 255 characters - .. maxLength 255 characters - .. maxLength 18 characters - .. maxLength 16 characters - .. maxLength 16 characters - .. maxLength 255 characters - .. maxLength 255 characters - .. maxLength 255 characters - .. maxLength 255 characters - .. maxLength 255 characters - .. maxLength 255 characters - .. maxLength 255 characters - .. maxLength 255 characters - .. maxLength 255 characters - .. maxLength 255 characters - .. maxLength 32 characters - .. maxLength 250 characters - .. maxLength 128 characters - .. maxLength 64 characters - .. maxLength 255 characters - .. maxLength 64 characters - .. maxLength 255 characters - .. maxLength 16 characters Endpoint: POST /api/orders Version: 1.0.0 Security: shoptetAccessToken, shoptetPrivateApiToken ## Query parameters: - `suppressDocumentGeneration` (boolean) suppress the generation of linked documents. Example: true - `suppressEmailSending` (boolean) suppress sending the linked information e-mails. Example: true - `suppressProductChecking` (boolean) suppress the product existence check as per and GUID Example: true - `suppressStockMovements` (boolean) suppress deduction of the products from stock Example: true - `suppressHistoricalMandatoryFields` (boolean) set the flag that disables mandatory fields checking Example: true - `suppressHistoricalPaymentChecking` (boolean) set the flag that can be Example: true - `suppressHistoricalShippingChecking` (boolean) set the flag that can be Example: true ## Header parameters: - `Content-Type` (string, required) ## Request fields (application/json): - `data` (object, required) - `data.creationTime` (string) time of order creation. Optional, current time is the default value. - `data.code` (string) Unique identifier for an e-shop order. Caution! This does not have to be just a number, it can also contain letters, a dash, etc. - `data.language` (string) Language of order. Default: default eshop language. (optional) - `data.externalCode` (string, required) order identification within the external system (mandatory, must be unique). - `data.cashDeskOrder` (boolean) flag, if the order was created via the cash desk. Optional. is the default value. - `data.statusId` (number) Order status. Optional. If not indicated, the default status of the order is used, as per e-shop settings. If the status definition sets the payment flag, the parameter is set to . if the request also mentions , the variant has priority. If the status definition has selected the setting of item statuses, the status is also set for items. Otherwise, the initial status is the set based on e-shop defaults. If the item has status set explicitly (see below ), the value from the item shall be used. - `data.sourceId` (number,null) Order source id. Optional. If not indicated, no source will be used (null). If is positive, must also be set to , otherwise if is negative, must be set to , otherwise error will be returned. Current possible values of can be determined by calling the list of order sources endpoint. - `data.email` (string) customer e-mail (can be omitted only when ordering via cash desk). - `data.phone` (string,null) phone number of the customer. Optional, if not set as mandatory item in shop settings. - `data.birthDate` (string,null) customer birth date (optional, if not made mandatory by the e-shop settings). - `data.vatPayer` (boolean) Flag, whether the invoice was issued in VAT payer mode, or VAT non-payer mode. Optional, if not indicated, it is used as per current settings of the e-shop (only makes sense for historical orders, if e-shop changed its status form VAT payer to different or vice versa) - `data.paymentMethodGuid` (string,null) Payment method. Optional, for an order via cash desk or eshop order. Does not automatically generate payment item in the list of items, and does not check the consistency with payment item. Billing item type is mandatory if paymentMethodGuid is filled. - `data.shippingGuid` (string,null) Transport method. Optional, for an order via cash desk or eshop order. Does not automatically generate transport item in the list of items, and does not check the consistency with the transport item. Shipping item type is mandatory if shippingGuid is filled. - `data.shippingDetails` (any) additional information for transport, if any. typically ID of Zásilkovna branches, postal offices, etc. (optional) - `data.paid` (boolean,null) flag, whether the order was paid - `data.billingMethodCode` (number) Billing method identifier - see also [Invoice billing methods](#section/code-lists/invoice-billing-methods) code list. Optional. - `data.clientIPAddress` (string,null) IP address of the customer, from where the order was made - `data.customerGuid` (string,null) Customer GUID, if not done under known registered customer (optional). - `data.billingAddress` (object) invoicing address - `data.billingAddress.company` (string,null) company name. Optional, if not set as mandatory item in shop settings. - `data.billingAddress.fullName` (string,null) customer name. Optional, if not set as mandatory item in shop settings. - `data.billingAddress.street` (string,null) (string, optional) - street of the customer. Optional, if not set as mandatory item in shop settings. - `data.billingAddress.streetWithNr` (string,null) Street, including street number. Optional, if necessary, to be divided to street and street number and saved in respective fields. Use if you only have the combined data. Usually, the and will not be needed (if they are used, however, they have priority). - `data.billingAddress.houseNumber` (string,null) street number. Optional, if not set as mandatory item in shop settings. - `data.billingAddress.city` (string,null) City/Town. Optional, if not set as mandatory item in shop settings. - `data.billingAddress.district` (string,null) County. Optional, if not set as mandatory item in shop settings. - `data.billingAddress.additional` (string,null) Additional information for the address. Optional. - `data.billingAddress.zip` (string,null) ZIP or postal code. Optional, if not set as mandatory item in shop settings. - `data.billingAddress.countryCode` (string) (string, optional) - country of the customer. Optional, the default delivery country is used as the default value, taken from eshop settings. - `data.billingAddress.regionName` (string,null) region. Optional. - `data.billingAddress.regionShortcut` (string,null) region abbreviation. Optional. - `data.billingAddress.companyId` (string,null) Company registration number of the customer, if purchasing as a company. Optional. - `data.billingAddress.vatId` (string,null) VAT identification number of the customer, if purchasing on the company. - `data.billingAddress.taxId` (string,null) TAX identification number of the customer, if purchasing on the company. For Czech address, taxId must be the same as vatId, or left empty. Optional. - `data.addressesEqual` (boolean,null) flag, whether the billing and delivery addresses are the same - `data.deliveryAddress` (any) - `data.notes` (any) additional notes for the order - `data.stockId` (number) stock number. Optional, the default value is the default stock, taken from e-shop settings. In Shoptet, the only alternative to the default stock is to collect in person at the shop, otherwise the default stock is used. - `data.currency` (object, required) - `data.currency.code` (string, required) currency abbreviation. Mandatory. - `data.currency.exchangeRate` (string,null) exchange rate for main e-shop currency. - `data.vatMode` (string) VAT mode, is used by default, possible values: , *, , . Please note, that value requires eshop setting to be . - `data.items` (array) order items. The order must have at least one product item - `data.items.itemType` (string, required) Item type. Mandatory field. See also [Type of order items](#section/code-lists/types-of-order-items) code list. item type is min required. If type is present paymentMethodGuid must be provided. If type is present shippingGuid must be provided. - `data.items.name` (string) Product name (optional, but usually filled in). Mandatory only for transport and payment, for other items, it is loaded according to . - `data.items.variantName` (string) Product variant name. - `data.items.brand` (string) brand (manufacturer). Optional. - `data.items.supplierName` (string) supplier name. - `data.items.productGuid` (string) Product GUID in item. When used with the parameter, this field has no influence. - `data.items.code` (string,null) - `data.items.remark` (string) remark for the item. Optional. - `data.items.warrantyDescription` (string,null) textual description of warranty length (can be ) - `data.items.amountCompleted` (string,null) quantity of completed product - `data.items.additionalField` (string,null) additional information. Used for transport to specify the branch (can be ) - `data.items.amount` (string) amount, 3 decimal places accuracy, optional, default value . - `data.items.amountUnit` (string) unit of quantity (optional) - `data.items.weight` (string) product weight in kilograms. Maximum 3 decimal places, and maximum value of 99999. - `data.items.priceRatio` (string) discount in the form of coefficient (0.7 = 70 % of the original price, i.e. 30 % discount). Optional, default value is - `data.items.vatRate` (string, required) VAT rate ( for VAT non-payers). Mandatory. - `data.items.itemPriceWithVat` (string,null) item amount including VAT. Only one of the items or must be entered - `data.items.itemPriceWithoutVat` (string,null) item amount excluding VAT. Only one of the items or must be entered - `data.items.buyPriceWithVat` (string,null) Purchase price, including VAT. Price including tax and price excluding tax cannot be combined. This is used for profit margin calculation and statistics. - `data.items.buyPriceWithoutVat` (string,null) Purchase price, excluding VAT. Optional. Price including tax and price excluding tax cannot be combined. This is used for profit margin calculation and statistics. - `data.items.buyPriceVatRate` (string,null) VAT rate for purchase price. - `data.items.statusId` (number,null) Order item status. Optional, if not indicated, default value is guided by the order status. If the order status was indicated and this status has the flag set, then the item will have this status. Otherwise the default status of the e-shop is used. - `data.items.recyclingFeeId` (integer,null) ID of the recycling fee. - `data.items.surchargeParameters` (array) - `data.items.surchargeParameters.parameterCode` (string, required) - `data.items.surchargeParameters.valueIndex` (string, required) - `data.items.surchargeParameters.price` (string) - `data.items.consumptionTaxId` (integer,null) ID of the consumption tax. You can send this parameter, only if consumption tax module is enabled. ## Response 201 fields (application/json): - `data` (object, required) - `data.order` (object, required) - `data.order.code` (string, required) order number. Caution! This does not have to be just a number, it can also contain letters, a dash, etc. - `data.order.guid` (string, required) global unique permanent order identifier (can be for old orders) - `data.order.externalCode` (string,null, required) Identification of the order in external system (or ). - `data.order.creationTime` (string,null, required) date and time, when the order was created. ISO 8601 format. - `data.order.changeTime` (string,null, required) date and time of the order's last change. ISO 8601 format. - `data.order.email` (string,null, required) purchaser e-mail (can be ) - `data.order.phone` (string,null, required) purchaser phone number (can be ) - `data.order.birthDate` (string,null) customer's date of birth stated in the order - `data.order.clientIPAddress` (string,null, required) IP address of the client who made the order - `data.order.customerGuid` (any, required) customer identifier, if the customer is registered in the e-shop (can be ) - `data.order.cashDeskOrder` (boolean, required) flag, whether the order is from the cash desk (as opposed to the e-shop) - `data.order.stockId` (number, required) identifier of the stock, from which the order was taken - `data.order.addressesEqual` (boolean, required) flag, whether the delivery address is the same as the invoicing address - `data.order.vatPayer` (boolean, required) Is the tradesman a VAT payer, when purchasing? (can be , if this is unknown) - `data.order.vatMode` (string,null) VAT mode, for possible values see [VAT modes](#section/code-lists/vat-modes) code list - `data.order.billingMethod` (any, required) - `data.order.paymentMethod` (any, required) - `data.order.shipping` (object,null, required) - `data.order.shipping.guid` (string, required) transport type identifier - `data.order.shipping.name` (string, required) description of transport method (Czech post, PPL, in person..) - `data.order.shippingDetails` (object,null) - `data.order.shippingDetails.branchId` (string,null, required) branch identifier - `data.order.shippingDetails.shippingCompanyCode` (string,null, required) identification of the carrier - `data.order.shippingDetails.shippingServiceCode` (string,null) identification of the carrier's service - `data.order.shippingDetails.name` (string,null, required) name of the branch - `data.order.shippingDetails.note` (string,null, required) branch location note, can contain HTML - `data.order.shippingDetails.place` (string,null, required) location (specify location within address). - `data.order.shippingDetails.street` (string,null, required) street - `data.order.shippingDetails.city` (string,null, required) city/town - `data.order.shippingDetails.zipCode` (string,null, required) ZIP or postal code - `data.order.shippingDetails.countryCode` (string,null, required) country code - `data.order.shippingDetails.link` (string,null, required) link to the branch's website - `data.order.shippingDetails.latitude` (string,null, required) GPS coordinates - north latitude - `data.order.shippingDetails.longitude` (string,null, required) GPS coordinates - east longitude - `data.order.shippingDetails.carrierId` (integer,null, required) identification of the carrier - now it's used for Zasilkovna only. The value is for Czech Zasilkovna or carrier ID for Zasilkovna in the other countries. - `data.order.adminUrl` (string, required) URL to administration leading to order detail. URL keeps the administration language settings. - `data.order.status` (object,null, required) - `data.order.status.name` (string,null, required) status name - `data.order.status.id` (number, required) status identifier - `data.order.source` (object,null) source of the order - `data.order.source.name` (string,null, required) source name - `data.order.source.id` (number, required) source identifier - `data.order.price` (object, required) price of the order - `data.order.price.vat` (string,null, required) VAT value, two decimal places - `data.order.price.toPay` (string,null, required) total price to pay - `data.order.price.currencyCode` (string, required) currency code. List of available currencies within the e-shop can be found in endpoint . - `data.order.price.withoutVat` (string,null, required) price excluding tax - `data.order.price.withVat` (string,null, required) price including tax - `data.order.price.exchangeRate` (string, required) currency rate of the receipt for the default currency of the shop. This value is saved together with the price and reflects the historical value valid in the instant of the order creation. If the shop changes the default currency, the value still refers to the original currency! - `data.order.price.invoicingExchangeRate` (string) currency rate of the receipt for the default currency of the shop. This value is saved together with the price and reflects the historical value valid in the instant of the order creation. If the shop changes the default currency, the value still refers to the original currency! - `data.order.price.partialPaymentAmount` (string,null) can be value expressed in percents or as exact money value expression (with up to two decimal places) - depends on partialPaymentType value - `data.order.price.partialPaymentType` (string) 'percents' = partial payment as percentage from total price | 'absolute' = exact expression of partial payment in money - `data.order.paid` (boolean,null, required) flag, whether the order was paid. In addition to a , can also be , if the payment status is unknown. - `data.order.billingAddress` (object, required) - `data.order.billingAddress.company` (string,null, required) name of purchaser''s company (or ) - `data.order.billingAddress.fullName` (string,null, required) name of purchaser (or ) - `data.order.billingAddress.street` (string,null, required) street of purchaser (or ) - `data.order.billingAddress.houseNumber` (string,null, required) street number (or ) - `data.order.billingAddress.city` (string,null, required) city/town (village) (or ) - `data.order.billingAddress.district` (string,null, required) county (or ) - `data.order.billingAddress.additional` (string,null, required) additional address information (or ) - `data.order.billingAddress.zip` (string,null, required) ZIP or postal code (or ) - `data.order.billingAddress.countryCode` (string,null, required) tree-character ISO country code (ISO 4217) - `data.order.billingAddress.regionName` (string,null, required) region name (or ) - `data.order.billingAddress.regionShortcut` (string,null, required) region abbreviation (or ) - `data.order.billingAddress.companyId` (string,null, required) Company registration number. (can be ) - `data.order.billingAddress.vatId` (string,null, required) VAT identification number. (can be ) - `data.order.billingAddress.vatIdValidationStatus` (any) Info, whether VAT ID has been verified, enum [, , ] Enum: "unverified", "verified", "waiting", null - `data.order.billingAddress.taxId` (string,null, required) TAX identification number. For Czech address, taxId is same as vatId. (can be ) - `data.order.deliveryAddress` (object,null, required) - `data.order.onlinePaymentLink` (string,null) URL to online payment - `data.order.language` (string) language code of the order - `data.order.referer` (string,null) which page (url) has the user come from - `data.order.paymentMethods` (array) all order payment methods - `data.order.paymentMethods.itemId` (number, required) payment method identifier within order - `data.order.shippings` (array) all order shippings - `data.order.shippings.shipping` (object, required) transport method - `data.order.shippings.shipping.guid` (string,null, required) transport method identifier - `data.order.shippings.shipping.name` (string, required) description of transport method - `data.order.shippings.itemId` (number, required) transport method identifier within order - `data.order.items` (array, required) all order items - `data.order.items.productGuid` (any, required) product identifier of the item. At the time the order is created, it will be entered in this field, but when the product is deleted, the link will be lost (can be ) - `data.order.items.code` (string,null, required) identifier of the item code (product or variant). At the time the order is created, it will be entered in this field, but when the product is deleted, the link will be lost. - `data.order.items.ean` (string,null, required) EAN of the product variant (can be ) - `data.order.items.itemType` (string, required) Order item type (product, service...). See also [Types of order items](#section/code-lists/types-of-order-items) code list. - `data.order.items.productType` (string,null) Product type at the time of the order (product, product-set..). See also [Product types](#section/code-lists/product-types) code list (can be ). - `data.order.items.name` (string, required) Product name, with possible addition () - `data.order.items.variantName` (string,null, required) variant name (can be ) - `data.order.items.brand` (string,null, required) product brand (or manufacturer, possibly) - `data.order.items.remark` (string,null, required) remark - `data.order.items.weight` (string, required) weight in kg, unpacked (can be ). 3 decimal places. Maximum value 999999. - `data.order.items.additionalField` (string,null, required) additional field for remarks - `data.order.items.amount` (string,null, required) product quantity - `data.order.items.amountUnit` (string,null, required) product unit of quantity - `data.order.items.priceRatio` (string, required) price coefficient. This also represents a discount (discount means ) - `data.order.items.itemPrice` (object, required) the price of the item including the discount () and quantity (). - `data.order.items.itemPrice.vatRate` (string, required) VAT rate - `data.order.items.displayPrices` (array) - `data.order.items.purchasePrice` (any, required) purchase price of item, can be . - `data.order.items.recyclingFee` (object,null, required) recycling fee including category and price (or possibly ). - `data.order.items.recyclingFee.category` (string, required) Recycling fee category name. - `data.order.items.recyclingFee.fee` (string,null, required) Recycling fee. - `data.order.items.recyclingFee.unit` (any) Recycling fee unit. Enum: "pcs", "kg" - `data.order.items.mainImage` (object,null) - `data.order.items.mainImage.name` (string, required) image file name, also serves as an identifier for the image of the product. To assemble complete URL, it is added to the obtained from the endpoint e-shop info . - `data.order.items.mainImage.seoName` (string, required) file name modified for SEO - a short label is attached. - `data.order.items.mainImage.cdnName` (string, required) same as with attached hashed last image change time. , and can be entered in the URL - redirect will deliver the same image. - `data.order.items.mainImage.priority` (number, required) the key for the sequence of images matching the sequence in administration - it's not necessarily from the first, and the series may contain gaps. (can be ). - `data.order.items.mainImage.description` (string,null, required) description of the image (can be ). - `data.order.items.mainImage.changeTime` (string,null, required) last image change time If you are saving images together, you can use this timestamp to indicate if you need to reload the image. (can be ). - `data.order.items.stockLocation` (string,null) position in stock (can be ) - `data.order.items.supplierName` (string,null) product supplier (can be ) - `data.order.items.itemId` (number, required) order item identifier - `data.order.items.warrantyDescription` (string,null, required) textual description of warranty length (can be ) - `data.order.items.surchargeParameters` (array) items surcharge parameters, filled in order creation. Cannot be edited. - `data.order.items.surchargeParameters.parameterName` (object) surcharge parameter name's information - `data.order.items.surchargeParameters.parameterName.code` (string,null) parameters name code, can be null if already deleted - `data.order.items.surchargeParameters.parameterName.name` (string) parameters name - `data.order.items.surchargeParameters.parameterValue` (object) surcharge parameter value's information - `data.order.items.surchargeParameters.parameterValue.valueIndex` (string,null) parameters value code, can be null if already deleted - `data.order.items.surchargeParameters.parameterValue.description` (string) parameters value name - `data.order.items.surchargeParameters.parameterValue.price` (string,null) parameters value additional price - `data.order.items.specificSurchargeParameters` (array) list of specific surcharge parameters for order item detail, created from , but editable in order item detail in eshop administration or via order item detail surcharge-parameters endpoint. - `data.order.items.specificSurchargeParameters.relationId` (string, required) id which identifies relation between item and surcharge. Can be used to delete surcharge parameter related to item. - `data.order.items.specificSurchargeParameters.name` (string, required) full name of surcharge parameter. - `data.order.items.specificSurchargeParameters.price` (string,null, required) price of surcharge parameter - `data.order.items.productFlags` (array) list of product flags - `data.order.items.productFlags.code` (string, required) flag identifier - `data.order.items.productFlags.title` (string, required) flag title - `data.order.items.productFlags.system` (boolean, required) is it a system flag common for all e-shops? - `data.order.items.consumptionTax` (object,null) consumption tax of order item - `data.order.items.consumptionTax.currency` (string, required) currency code. List of available currencies within the e-shop can be found in endpoint . - `data.order.items.consumptionTax.price` (string,null, required) consumption tax value - `data.order.items.buyPrice` (any) purchase price of the item including the discount () and quantity (). (or possibly ) - `data.order.items.amountCompleted` (string,null, required) quantity of completed product. Deprecated - use section instead. - `data.order.items.surchargeParametersTexts` (array) List of custom surcharge parameters names - `data.order.notes` (object) order notes (only filled in on request if is listed) - `data.order.notes.customerRemark` (string,null, required) customer note - `data.order.notes.eshopRemark` (string,null, required) e-shop order remark. - `data.order.notes.trackingNumber` (string,null, required) shipment number - `data.order.notes.trackingUrl` (string,null, required) package trace link (can be ) - `data.order.notes.additionalFields` (array, required) can contain up to six additional fields, which can be freely used by e-shop for its individual needs. - `data.order.notes.additionalFields.index` (integer, required) sequence number - `data.order.notes.additionalFields.label` (string, required) item name. The name of the field can be edited in the e-shop administration. - `data.order.notes.additionalFields.text` (string,null, required) item value (can be ) - `data.order.preAuthorization` (object) - `data.order.preAuthorization.hasPendingPreAuthorization` (boolean, required) - `data.order.preAuthorization.preAuthorizationAmount` (string, required) pre-authorization amount of the order. If null, the order is not pre-authorized. If not present, pre-authorization is not supported. - `data.order.completion` (array) All order items completion status. Contains completion info even for product set items. - `data.order.completion.productGuid` (any, required) - `data.order.completion.name` (string, required) Product name - `data.order.completion.itemId` (number,null, required) Order item identifier. This field is null for product set items. - `data.order.completion.amountCompleted` (string,null, required) quantity of completed product - `data.order.completion.parentProductSetItemId` (number) identifier of the parent product set item, if the item is a product set item. If the item is not a product set item, this field is not present. - `errors` (array,null, required) - `errors.errorCode` (string, required) Short text error identification - `errors.message` (string, required) Descriptive error message - `errors.instance` (string, required) Identification of the entity referenced ## Response 403 fields (application/json): - `data` (object,null) - `errors` (array,null) - `errors.errorCode` (string, required) Short text error identification - `errors.message` (string, required) Descriptive error message - `errors.instance` (string, required) Identification of the entity referenced ## Response 422 fields (application/json): - `data` (object,null) - `errors` (array,null) - `errors.errorCode` (string, required) Short text error identification - `errors.message` (string, required) Descriptive error message - `errors.instance` (string, required) Identification of the entity referenced