<footer id="WIX_FOOTER" style="visibility:hidden;" class><nav class="zEGd0F" aria-label="More Wix pages" data-hook="footer__wrapper"><div class="qiiRxY"><div class="qSmvZl"><a class="LtfG6S" aria-label="Wix logo, homepage" title="Wix.com" href="https://www.wix.com"><svg xmlns="http://www.w3.org/2000/svg" width="71" height="28" fill="none" viewBox="0 0 166 64"><g fill="#000" clip-path="url(#a)"><path d="M165.301 0h-9.131a7.64 7.64 0 0 0-6.323 3.352l-12.212 18.014a.82.82 0 0 1-1.356 0L124.068 3.352A7.64 7.64 0 0 0 117.745 0h-9.131l21.753 32.09L108.734 64h9.131a7.64 7.64 0 0 0 6.323-3.352l12.091-17.836a.82.82 0 0 1 1.356 0l12.091 17.836A7.64 7.64 0 0 0 156.05 64h9.131l-21.634-31.91zM89.828 6.546V64h4.364a6.546 6.546 0 0 0 6.547-6.547V0h-4.364a6.546 6.546 0 0 0-6.547 6.546M81.83 0h-3.885a9.154 9.154 0 0 0-8.928 7.126L60.33 45.318 52.725 9.666C51.318 3.077 44.557-1.367 37.639.544c-4.407 1.217-7.674 4.94-8.627 9.41L21.485 45.27 12.813 7.128A9.16 9.16 0 0 0 3.883 0H0l14.555 63.997h5.515c5.004 0 9.328-3.499 10.372-8.393l9.305-43.664c.114-.542.6-.934 1.153-.934.552 0 1.038.392 1.153.934l9.312 43.667a10.6 10.6 0 0 0 10.373 8.39h5.533z"></path></g><defs><clipPath id="a"><path fill="#fff" d="M0 0h165.305v64H0z"></path></clipPath></defs></svg></a><p class="bUSBWm">The Wix website builder offers a complete solution from enterprise-grade infrastructure and business features to advanced SEO and marketing tools–enabling anyone to create and grow online.</p><ul class="uLHFcA"><li><a href="https://www.wix.com/about/us" target="_self" class="PlWjyD">About</a></li><li><a href="https://www.wix.com/about/contact-us" target="_self" class="PlWjyD">Contact Us</a></li></ul><ul class="SUCknL FgSyBI" data-hook="social-bar__wrapper"><li><a class="ACLKzf" href="https://www.facebook.com/wix" target="_blank" aria-label="facebook" title="Facebook" data-hook="social-bar__socialLink socialLink--id_facebook"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" fill="none" viewBox="0 0 20 20"><path fill="#000" d="M10 0C-2.399.363-3.663 17.76 8.43 20v-7.03H5.876V10.06H8.43V7.845c.072-4.058 3.333-4.207 6.047-3.718v2.476H13.21c-1.249 0-1.639.775-1.639 1.57v1.888h2.788l-.445 2.909H11.57V20C23.666 17.759 22.396.362 10 0"></path></svg></a></li><li><a class="ACLKzf" href="https://www.youtube.com/user/Wix" target="_blank" aria-label="youtube" title="Youtube" data-hook="social-bar__socialLink socialLink--id_youtube"><svg xmlns="http://www.w3.org/2000/svg" width="28" height="20" fill="none" viewBox="0 0 28 20"><path fill="#000" d="M11.83.005c-2.96.056-4.594.12-6.14.237C3.805.385 3.093.511 2.475.81c-.357.173-.62.357-.92.648C.825 2.173.53 2.913.321 4.569l-.085.67a45 45 0 0 0-.162 2.222c-.099 2.083-.099 2.994 0 5.083.03.662.121 1.906.162 2.221l.085.67c.21 1.657.503 2.397 1.234 3.112.714.696 1.393.95 3.008 1.118C6.72 19.89 9.763 20 14 20c3.646 0 6.203-.073 8.31-.235 1.899-.148 2.597-.27 3.215-.57.357-.173.62-.357.92-.648.73-.715 1.025-1.455 1.234-3.111l.085-.67c.04-.316.132-1.56.162-2.222.099-2.089.099-3 0-5.083a45 45 0 0 0-.162-2.221l-.085-.67c-.21-1.657-.503-2.397-1.234-3.112C25.956.98 25.43.695 24.736.536c-.983-.23-3.269-.397-6.684-.492A295 295 0 0 0 11.83.005m.192 6.266c1.055.611 2.063 1.195 5.324 3.08.594.341 1.083.635 1.083.651 0 .014-.789.484-1.753 1.04a2861 2861 0 0 0-5.511 3.187c-.014.006-.022-1.897-.022-4.226 0-2.33.008-4.232.022-4.227.01.003.395.226.857.495"></path></svg></a></li><li><a class="ACLKzf" href="https://www.instagram.com/wix" target="_blank" aria-label="instagram" title="Instagram" data-hook="social-bar__socialLink socialLink--id_instagram"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" fill="none" viewBox="0 0 20 20"><path fill="#000" d="M5.858.07c-1.064.05-1.79.22-2.425.47-.658.256-1.215.6-1.77 1.156a4.9 4.9 0 0 0-1.15 1.772C.267 4.105.1 4.832.053 5.897s-.057 1.407-.052 4.122c.005 2.716.017 3.056.069 4.123.05 1.064.22 1.79.47 2.426.256.657.6 1.214 1.156 1.769a4.9 4.9 0 0 0 1.774 1.15c.636.245 1.363.413 2.428.46 1.064.046 1.407.057 4.122.052s3.056-.017 4.123-.068c1.067-.05 1.79-.221 2.425-.47a4.9 4.9 0 0 0 1.769-1.156 4.9 4.9 0 0 0 1.15-1.774c.246-.636.413-1.363.46-2.427.046-1.067.057-1.408.052-4.123s-.018-3.056-.068-4.122c-.05-1.067-.22-1.79-.47-2.427a4.9 4.9 0 0 0-1.156-1.769 4.9 4.9 0 0 0-1.773-1.15C15.895.269 15.168.1 14.104.054 13.039.009 12.697-.003 9.98.002S6.925.018 5.858.07m.117 18.078c-.975-.043-1.504-.205-1.857-.34-.467-.18-.8-.398-1.152-.746a3.1 3.1 0 0 1-.75-1.149c-.137-.352-.302-.881-.347-1.856-.05-1.054-.06-1.37-.066-4.04s.004-2.986.05-4.04c.042-.974.205-1.504.34-1.857.18-.468.397-.8.746-1.151a3.1 3.1 0 0 1 1.15-.75c.351-.138.88-.302 1.855-.348 1.054-.05 1.37-.06 4.04-.066s2.986.004 4.041.05c.974.043 1.505.204 1.857.34.467.18.8.397 1.151.746.352.35.568.682.75 1.15.138.35.302.88.348 1.855.05 1.054.062 1.37.066 4.04s-.004 2.986-.05 4.04c-.043.975-.205 1.504-.34 1.857a3.1 3.1 0 0 1-.747 1.152c-.349.35-.681.567-1.148.75-.352.137-.882.301-1.855.347-1.055.05-1.371.06-4.042.066s-2.985-.005-4.04-.05m8.153-13.493a1.2 1.2 0 1 0 2.4-.003 1.2 1.2 0 0 0-2.4.003M4.865 10.01a5.134 5.134 0 1 0 10.27-.02 5.134 5.134 0 0 0-10.27.02m1.802-.004a3.334 3.334 0 1 1 6.667-.013 3.334 3.334 0 0 1-6.667.013"></path></svg></a></li><li><a class="ACLKzf" href="https://www.tiktok.com/@wix" target="_blank" aria-label="tiktok" title="TikTok" data-hook="social-bar__socialLink socialLink--id_tiktok"><svg xmlns="http://www.w3.org/2000/svg" width="17" height="20" fill="none" viewBox="0 0 17 20"><path fill="#000" d="M14.46 4.009A4.8 4.8 0 0 1 12.417.873 5 5 0 0 1 12.337 0H8.986L8.98 13.78c-.057 1.544-1.294 2.782-2.811 2.782-.472 0-.916-.121-1.307-.332a2.9 2.9 0 0 1-1.51-2.558c0-1.594 1.263-2.89 2.817-2.89.29 0 .568.048.831.133v-3.51a6 6 0 0 0-.831-.062C2.767 7.343 0 10.183 0 13.672a6.37 6.37 0 0 0 2.633 5.181A6.03 6.03 0 0 0 6.17 20c3.4 0 6.168-2.839 6.168-6.329V6.683A7.83 7.83 0 0 0 17 8.222V4.783a4.55 4.55 0 0 1-2.539-.775z"></path></svg></a></li><li><a class="ACLKzf" href="https://www.pinterest.com/wixcom" target="_blank" aria-label="pinterest" title="Pinterest" data-hook="social-bar__socialLink socialLink--id_pinterest"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" fill="none" viewBox="0 0 20 20"><path fill="#000" d="M10 0C4.479 0 0 4.477 0 10a10 10 0 0 0 5.986 9.159c-.03-.699-.006-1.536.173-2.296.193-.812 1.288-5.45 1.288-5.45s-.32-.638-.32-1.581c0-1.483.86-2.59 1.928-2.59.91 0 1.35.685 1.35 1.502 0 .914-.583 2.282-.883 3.549-.25 1.06.532 1.926 1.577 1.926 1.895 0 3.172-2.434 3.172-5.317 0-2.19-1.476-3.831-4.161-3.831-3.034 0-4.923 2.261-4.923 4.788 0 .872.256 1.486.66 1.96.183.22.21.308.142.559-.048.184-.157.627-.204.802-.066.254-.271.344-.5.251-1.398-.571-2.047-2.1-2.047-3.82 0-2.842 2.395-6.247 7.145-6.247 3.819 0 6.333 2.762 6.333 5.728 0 3.923-2.182 6.854-5.398 6.854-1.079 0-2.094-.585-2.442-1.247 0 0-.581 2.304-.703 2.749-.213.77-.628 1.542-1.007 2.142.9.265 1.85.41 2.835.41C15.524 20 20 15.523 20 9.999 20 4.477 15.524 0 10 0"></path></svg></a></li><li><a class="ACLKzf" href="https://twitter.com/wix" target="_blank" aria-label="twitter" title="Twitter" data-hook="social-bar__socialLink socialLink--id_twitter"><svg xmlns="http://www.w3.org/2000/svg" width="19" height="20" fill="none" viewBox="0 0 19 20"><path fill="#000" d="m.044.063 7.352 11.022.023.034-3.667 4.39-3.71 4.44L0 20h1.677l3.241-3.881c1.783-2.134 3.242-3.88 3.245-3.88.002 0 1.169 1.745 2.592 3.88L13.344 20H19l-.023-.035-3.84-5.758c-2.1-3.148-3.82-5.73-3.82-5.737a883 883 0 0 1 3.527-4.234C16.783 1.914 18.372.01 18.372.006A28 28 0 0 0 17.54 0h-.835L13.64 3.67a1080 1080 0 0 1-3.074 3.673c-.004.001-1.11-1.65-2.457-3.67L5.658 0H0zM5.339 2.01l11.36 16.74c.005.007-.253.01-1.28.01h-1.286l-2.7-3.977L5.512 6.06C3.739 3.447 2.289 1.308 2.289 1.304s.54-.008 1.283-.008h1.281z"></path></svg></a></li><li><a class="ACLKzf" href="https://www.linkedin.com/company/wix-com?trk=biz-companies-cym" target="_blank" aria-label="linkedin" title="Linkedin" data-hook="social-bar__socialLink socialLink--id_linkedin"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" fill="none" viewBox="0 0 20 20"><path fill="#000" d="M18.522.003C15.446-.006 4.1.009 1.478.003.662.003 0 .645 0 1.435v17.133C0 19.358.662 20 1.478 20h17.044c.816 0 1.478-.641 1.478-1.432V1.435c0-.79-.662-1.432-1.478-1.432M6.078 16.738H3.085V7.735h2.993v9.003M4.582 6.506c-1.008.01-1.675-.684-1.673-1.555-.003-2.06 3.358-2.084 3.366 0 0 .864-.65 1.555-1.693 1.555M16.87 16.738h-2.993v-4.816c0-1.21-.433-2.036-1.516-2.036-1.111.04-1.663.901-1.634 1.825v5.027H7.735s.039-8.158 0-9.002h2.992l-.02 1.305c.394-.615 1.103-1.517 2.718-1.517 1.968 0 3.445 1.287 3.445 4.052z"></path></svg></a></li></ul></div><div class="lcWAzl"><div class="C2Sjqd" data-hook="column__column column--name_product"><p class="FBGLaT">Product</p><ul class="BWy7Sp "><li class="LjUlS_"><a class="KuIaYs" href="https://www.wix.com/website/templates" target="_self">Website Templates</a></li><li class="LjUlS_"><a class="KuIaYs" href="https://www.wix.com" target="_self">Website Builder</a></li><li class="LjUlS_"><a class="KuIaYs" href="https://www.wix.com/website/design" target="_self">Website Design</a></li><li class="LjUlS_"><a class="KuIaYs" href="https://www.wix.com/features/main" target="_self">Wix Features</a></li><li class="LjUlS_"><a class="KuIaYs" href="https://www.wix.com/app-market" target="_blank">App Market</a></li><li class="LjUlS_"><a class="KuIaYs" href="https://www.wix.com/free/web-hosting" target="_self">Web Hosting</a></li><li class="LjUlS_"><a class="KuIaYs" href="https://www.wix.com/domains" target="_self">Domain Names</a></li><li class="LjUlS_"><a class="KuIaYs" href="https://www.wix.com/accessibility" target="_self">Website Accessibility</a></li><li class="LjUlS_"><a class="KuIaYs" href="https://www.wix.com/app-builder" target="_self">Mobile App Builder</a></li></ul></div><div class="C2Sjqd" data-hook="column__column column--name_solutions"><p class="FBGLaT">Solutions</p><ul class="BWy7Sp "><li class="LjUlS_"><a class="KuIaYs" href="https://www.wix.com/ecommerce/online-store" target="_blank">Online Store</a></li><li class="LjUlS_"><a class="KuIaYs" href="https://www.wix.com/scheduling-software" target="_blank">Online Booking</a></li><li class="LjUlS_"><a class="KuIaYs" href="https://www.wix.com/restaurant/website" target="_self">Restaurant Website</a></li><li class="LjUlS_"><a class="KuIaYs" href="https://www.wix.com/start/blog" target="_self">Blog Website</a></li><li class="LjUlS_"><a class="KuIaYs" href="https://www.wix.com/portfolio-website" target="_self">Portfolio Website</a></li><li class="LjUlS_"><a class="KuIaYs" href="https://www.wix.com/ecommerce/website" target="_blank">eCommerce Website</a></li><li class="LjUlS_"><a class="KuIaYs" href="https://www.wix.com/studio" target="_self">Wix Studio</a></li><li class="LjUlS_"><a class="KuIaYs" href="https://www.wix.com/studio/enterprise" target="_self">Enterprise Solutions</a></li><li class="LjUlS_"><a class="KuIaYs" href="https://www.wix.com/students" target="_self">Student Website</a></li><li class="LjUlS_"><a class="KuIaYs" href="https://www.wix.com/tools" target="_self">Professional Tools</a></li><li class="LjUlS_"><a class="KuIaYs" href="https://www.wix.com/logo/maker" target="_blank">Logo Maker</a></li></ul></div><div class="C2Sjqd" data-hook="column__column column--name_learn"><p class="FBGLaT">Learn</p><ul class="BWy7Sp "><li class="LjUlS_"><a class="KuIaYs" href="https://www.wix.com/blog" target="_blank">Wix Blog</a></li><li class="LjUlS_"><a class="KuIaYs" href="https://www.wix.com/manage/privacy-security-hub" target="_self">Privacy and Security Hub</a></li><li class="LjUlS_"><a class="KuIaYs" href="https://www.wix.com/seo/learn" target="_blank">SEO Learning Hub</a></li><li class="LjUlS_"><a class="KuIaYs" href="https://www.wix.com/encyclopedia" target="_blank">Wix Encyclopedia</a></li></ul></div><div class="C2Sjqd" data-hook="column__column column--name_support"><p class="FBGLaT">Support</p><ul class="BWy7Sp "><li class="LjUlS_"><a class="KuIaYs" href="https://support.wix.com/en" target="_self">Help Center</a></li><li class="LjUlS_"><a class="KuIaYs" href="https://www.wix.com/marketplace" target="_blank">Hire a Professional</a></li><li class="LjUlS_"><a class="KuIaYs" href="https://www.wix.com/abuse" target="_self">Report Abuse</a></li><li class="LjUlS_"><a class="KuIaYs" href="https://status.wix.com" target="_self">System Status</a></li></ul></div><div class="C2Sjqd" data-hook="column__column column--name_company"><p class="FBGLaT">Company</p><ul class="BWy7Sp "><li class="LjUlS_"><a class="KuIaYs" href="https://www.wix.com/press-room/home" target="_self">Press &amp; Media</a></li><li class="LjUlS_"><a class="KuIaYs" href="https://investors.wix.com" target="_self">Investor Relations</a></li><li class="LjUlS_"><a class="KuIaYs" href="https://www.wix.com/wix-capital" target="_self">Wix Capital</a></li><li class="LjUlS_"><a class="KuIaYs" href="https://www.wix.com/about/terms-accessibility" target="_self">Accessibility Statement</a></li><li class="LjUlS_"><a class="KuIaYs" href="https://www.wix.com/about/patent-notice" target="_self">Patent Notice</a></li><li class="LjUlS_"><a class="KuIaYs" href="https://www.wix.com/about/sitemap" target="_self">Sitemap</a></li><li class="LjUlS_"><a class="KuIaYs" href="https://careers.wix.com" target="_self">Careers</a></li></ul></div></div></div><div class="PXtX5X"><div class="q2YDTr ehx5BU"><div class="JwIlOl"><div class="waU9GL"><ul class="fLy152"><li><a href="https://www.wix.com/about/terms-of-use" target="_self" class="FzJOdO">Terms of Use</a></li><li><a href="https://www.wix.com/about/privacy" target="_self" class="FzJOdO">Privacy Policy</a></li></ul><span class="GiYy1B">© 2006-2025 Wix.com, Inc</span></div></div></div></div></nav></footer>

Get to know our frameworks

Select an app template built on your preferred framework.

Build native Wix apps using a drag-and-drop editor, and add custom code for your business logic.

Streamline your app development process by coding on your local machine with your preferred IDE.

Take full control over your app's tech stack, deployment, and hosting.

App templates

Wix Blocks templates

Wix CLI templates

Self-hosted templates

Kickstart app development and get a practical foundation that you can customize and build upon with templates built for your preferred Wix framework.

Wix App Templates for Developers

This example apps can be used as a starting point for building your own app, for concrete examples of how to use Wix framework, or for inspiration.

Choose a template.<0 />Build an app.

Browse by:

How to build it step by step:

This template is built with:

Read how this template was built, step by step.

How we built this template

Deployment instructions:

Choose a package manager and run the command in your terminal.

Copy command

Before you get started, make sure you have the following:

Prerequisite steps

Get started with Wix CLI

Begin by setting up your Next.js project with your preferred hosting platform.

Select your hosting service

Start the deployment flow and set up your template repo on Netlify. After you finish set up, come back here and add your Netlify custom domain.

Copy the code from our Git repo to deploy your app on any platform that supports Next.js.

Start the deployment flow and set up your template repo on Vercel. After you finish set up, come back here and add your Vercel generated URL.

Add the base URL and give your app a name.

App details

Go to the app dashboard and test your app to ensure a smooth integration within the Wix ecosystem. <0>Learn more about app checks and testing</0>

Define your environment

Terminal

Related templates

Note

Warning

Your app name will be used as the namespace suffix.

Name your app to generate a namespace. This lets you refer to your app in code later on.

# About the Draft Orders API

The Draft Orders API acts as a complementary service to the [Orders API](fallback::https://dev.wix.com/docs/sdk/backend-modules/ecom/orders/introduction).
The draft order is a temporary version of a regular order, allowing you to make multiple fine-tuned modifications to line items, discounts, fees, shipping, and more.
When you're happy with the changes made to the draft order, you can then commit it to a new or existing order.

Learn more about the [draft order lifecycle, calculations, and totals](fallback::https://dev.wix.com/docs/sdk/backend-modules/ecom/draft-orders/lifecycle-calculations-and-totals).

The Draft Orders API eliminates the complexity of manual calculations and catalog lookups by handling these tasks automatically, allowing for a seamless workflow from draft to completed orders.

With the Draft Orders API, you can:
+ Create a draft order that can be reviewed, adjusted, saved, and then finalized into a new and approved order.
+ Generate a draft order based on an existing order, allowing you to make changes without affecting the original order. When you're done, you can commit the draft order to update the original order.
+ Add or update a draft order’s line items.
+ Set or modify a draft order’s discounts, fees, and taxes.
+ Retrieve draft orders for review or to update calculations.
+ Query draft orders and filter by status, date range, order ID, and more.

## Before you begin

It’s important to note the following points before starting to code:
+ It is not possible to pay for a draft order directly. To do so, the draft must first be committed. Then, the updated order can be paid for normally.
+ An order can only have 1 draft order associated with it at any given time. For example, using an order to create a draft order that already exists, is not allowed. Instead, the existing draft order is returned.
+ **Order limitations:**
  + Draft orders can only be created and committed if the currency and weight measurement unit match those used in the site’s business settings.
  + Orders with a `paymentStatus` of `CANCELED`, `FULLY_REFUNDED` or `PARTIALLY_REFUNDED` cannot be used to create a draft order.
  + Orders with subscription items are not editable.
+ **Line item limitations**:
  + Gift card products cannot be edited.
  + Fulfilled items are not editable.
  + Updating prices for items paid with memberships is restricted.
  + To commit a draft order, it must contain at least one line item.
  + A draft order can contain up to 300 line items (catalog and custom combined).

## Use cases

+ [Edit an existing order](fallback::https://dev.wix.com/docs/sdk/backend-modules/ecom/draft-orders/sample-flows)
+ [Create a new order from scratch](fallback::https://dev.wix.com/docs/sdk/backend-modules/ecom/draft-orders/sample-flows)
+ [Duplicate an existing order](fallback::https://dev.wix.com/docs/sdk/backend-modules/ecom/draft-orders/sample-flows)

##  Terminology

+ **Draft order:** A temporary version of an order, allowing modifications before finalization.
+ **Order:** A customer's completed request to purchase one or more items from an online store. An order holds information about purchased items, price and tax summaries, shipping and billing information, any applied discounts, and the status of payment and fulfillment.
+ **Calculated draft order:** The draft order details calculated with latest changes.
+ **Commit:** The action of finalizing a draft order, making its modifications permanent. Commit a draft order to either update the existing order, or create a regular new order.
+ **Line item:** 1 or more of the same item (product/service/event/fee) in an order; identified by an ID; can be associated with a catalog or a custom item.
+ **Discount:** A reduction applied to the whole order or to a specific item’s price.
+ **Additional fee:** An optional charge added to an order. For example, service fees or a gift-wrapping fee.

@package_metadata:@wix/ecom

To use the DraftOrders API, install the `@wix/ecom` package.

#### Install the package

Follow the installation instructions for your development environment.

| Development environment | Installation method |
|--|--|
| Wix sites (editor or IDE) | Use the [package manager](fallback::https://dev.wix.com/docs/develop-websites/articles/coding-with-velo/packages/work-with-npm-packages-in-the-editor). |
| Wix sites (local IDE) | Run `wix install @wix/ecom` using the [Wix CLI](fallback::https://dev.wix.com/docs/develop-websites/articles/coding-with-velo/packages/work-with-npm-packages-with-the-wix-cli).|
| Blocks apps | Use the same installation method as Wix sites. |
| CLI and self-hosted apps | Run `npm install @wix/ecom` or `yarn add @wix/ecom`. |
| Headless sites and apps | Run `npm install @wix/ecom` or `yarn add @wix/ecom`. |

#### Import the package

To import the package in your code:

```js
import { draftOrders } from '@wix/ecom'
```

# Sample Flows

This article shares some possible use cases your app could support, as well as a sample flow that could support each use case. This can be a helpful jumping off point as you plan your app's implementation.

## Edit an existing order

The ability to edit existing orders is crucial for merchants across various industries. In many cases, buyers change their mind, forget items, or want to change a delivery method.
In these cases you can use the Draft Orders API to save tentative modifications to an existing order and then finalize them. To do this, follow these steps:

1. Pass the order ID to [Get Order Draftability Status](fallback::https://dev.wix.com/docs/sdk/backend-modules/ecom/draft-orders/get-order-draftability-status) to check whether the order can be used to create a draft order.
   * If `orderDraftable` returns as `true`, continue to step 2.
   * If `orderDraftable` returns as `false`, refer to `nonDraftableReasons` in the response to understand why the order is not draftable.
2. Pass the order ID to [Create Draft Order](fallback::https://dev.wix.com/docs/sdk/backend-modules/ecom/draft-orders/create-draft-order). Save the newly created draft order’s ID from the response: `calculatedDraftOrder.draftOrder.id`.
3. Modify the draft order by passing the draft order ID and other relevant information to any of the editing methods. For example, [Add Line Items To Draft Order](fallback::https://dev.wix.com/docs/sdk/backend-modules/ecom/draft-orders/add-line-items-to-draft-order), [Set Discounts](fallback::https://dev.wix.com/docs/sdk/backend-modules/ecom/draft-orders/set-discounts), and [Set Shipping Info](fallback::https://dev.wix.com/docs/sdk/backend-modules/ecom/draft-orders/set-shipping-info).
4. After editing the draft order, retrieve and review the final version by passing the draft order ID to [Get Draft Order](fallback::https://dev.wix.com/docs/sdk/backend-modules/ecom/draft-orders/get-draft-order). Confirm all changes are there, and that the response does not include calculation errors.
5. To finalize the changes and update the original order, pass the draft order ID to [Commit Draft Order](fallback::https://dev.wix.com/docs/sdk/backend-modules/ecom/draft-orders/commit-draft-order). The updated order is now ready for processing, charging, or refunding.

![Draft an existing order](https://wixmp-833713b177cebf373f611808.wixmp.com/images/cb969c3275eafa97544c0cc31aede795.png)

## Create a new order from scratch

Use the Draft Orders API when you need flexibility in managing customers’ orders that don't follow the standard online checkout process.
Draft orders are ideal for handling sales made over the phone, in person, via chat, or through other direct channels, as they allow you to manually create and process orders.

The Draft Orders API allows you to add custom items for additional costs or non-inventory products, offer special pricing like discounts or wholesale rates, manage pre-orders, and re-create orders from other sales channels.
And, unlike [Create Order](fallback::https://dev.wix.com/docs/sdk/backend-modules/ecom/orders/create-order), you can save unfinished draft orders to complete later.
To do this, follow these steps:

1. Call the [Create Empty Draft Order](fallback::https://dev.wix.com/docs/sdk/backend-modules/ecom/draft-orders/create-empty-draft-order) method. This initializes a new draft order with no pre-existing data. Save the newly created draft order's ID from the response - `calculatedDraftOrder.draftOrder.id`.
2. Pass the draft order ID and relevant information to the [Add Line Items To Draft Order](fallback::https://dev.wix.com/docs/sdk/backend-modules/ecom/draft-orders/add-line-items-to-draft-order) method to add products, services or other items to the draft order.
3. To add recipient information and a shipping method to the draft order:
    1. Pass the draft order ID and relevant information to [Set Recipient Info](fallback::https://dev.wix.com/docs/sdk/backend-modules/ecom/draft-orders/set-recipient-info). This data is used to calculate the available shipping methods.
    2. Call [Set Shipping Info](fallback::https://dev.wix.com/docs/sdk/backend-modules/ecom/draft-orders/set-shipping-info) with the draft order ID and other information to set the delivery method. If the shipping method is unavailable, the response will include `calculationErrors`.
4. Create custom discounts and custom additional fees by calling [Create Custom Discounts](fallback::https://dev.wix.com/docs/sdk/backend-modules/ecom/draft-orders/create-custom-discounts) and [Create Custom Additional Fees](fallback::https://dev.wix.com/docs/sdk/backend-modules/ecom/draft-orders/create-custom-additional-fees) respectively. To apply them immediately to the draft order, specify `applyToDraftOrder: true`.
5. After making all your changes to the draft order, retrieve and review the final version by passing the draft order ID to [Get Draft Order](fallback::https://dev.wix.com/docs/sdk/backend-modules/ecom/draft-orders/get-draft-order). Confirm all changes are there, and that the response does not include calculation errors.
6. To convert the draft order into a confirmed order, pass the draft order ID to [Create Order From Draft](fallback::https://dev.wix.com/docs/sdk/backend-modules/ecom/draft-orders/create-order-from-draft). The new order is now ready for processing, charging or refunding.

![Create a new order from scratch](https://wixmp-833713b177cebf373f611808.wixmp.com/images/e94723c17669325bd79544d693905480.png)

## Duplicate an existing order

A merchant might want to duplicate an order to save time and reduce errors when creating a new order with similar details.
This can be especially useful in cases such as recurring customer purchases, re-orders with slight modifications, or when processing multiple orders with the same products, shipping details, or special pricing.  
Duplicating an order streamlines the workflow by eliminating the need to re-enter all the details manually, ensuring consistency and efficiency in managing customer transactions. To do this, follow these steps:

1. Pass the order ID to [Get Order Draftability Status](fallback::https://dev.wix.com/docs/sdk/backend-modules/ecom/draft-orders/get-order-draftability-status) to check whether the order can be used to create a draft order.
   * If `orderDraftable` returns as `true`, continue to step 2.
   * If `orderDraftable` returns as `false`, refer to `nonDraftableReasons` in the response to understand why the order is not draftable.
2. Pass the order ID to [Create Draft Order](fallback::https://dev.wix.com/docs/sdk/backend-modules/ecom/draft-orders/create-draft-order). Save the draft order ID from the response.
3. Modify the draft order by passing the draft order ID and other relevant information to any of the editing methods. For example, [Add Line Items To Draft Order](fallback::https://dev.wix.com/docs/sdk/backend-modules/ecom/draft-orders/add-line-items-to-draft-order), [Set Discounts](fallback::https://dev.wix.com/docs/sdk/backend-modules/ecom/draft-orders/set-discounts), and [Set Shipping Info](fallback::https://dev.wix.com/docs/sdk/backend-modules/ecom/draft-orders/set-shipping-info).
4. Call [Create Order From Draft](fallback::https://dev.wix.com/docs/sdk/backend-modules/ecom/draft-orders/create-order-from-draft) to convert the draft order into a new order.

![Duplicating an existing order](https://wixmp-833713b177cebf373f611808.wixmp.com/images/c7db274b2211ba678832125d362ba3cb.png)

# Lifecycle, Calculations, and Totals

## Draft Order Lifecycle

+ After a draft order is created, its status begins as `DRAFT`.
+ For every action performed on a draft order, a corresponding Draft Order [Created](fallback::https://dev.wix.com/docs/sdk/backend-modules/ecom/draft-orders/on-draft-order-created)/[Updated](fallback::https://dev.wix.com/docs/sdk/backend-modules/ecom/draft-orders/on-draft-order-updated)/[Deleted](fallback::https://dev.wix.com/docs/sdk/backend-modules/ecom/draft-orders/on-draft-order-deleted) webhook is triggered.
+ Once a draft order is committed by calling [Commit Draft Order](fallback::https://dev.wix.com/docs/sdk/backend-modules/ecom/draft-orders/commit-draft-order), its status changes to `COMMITTED`, and the [Order Updated](fallback::https://dev.wix.com/docs/sdk/backend-modules/ecom/orders/on-order-updated) webhook is triggered. The payload includes the changes made to the original order.
+ When a draft order is converted into a new approved order by calling [Create Order From Draft](fallback::https://dev.wix.com/docs/sdk/backend-modules/ecom/draft-orders/create-order-from-draft), the [Order Approved](fallback::https://dev.wix.com/docs/sdk/backend-modules/ecom/orders/on-order-approved) webhook is triggered. This initiates order-related side effects, including inventory updates, tax calculations, and relevant notifications.

![Draft Order Lifecycle](https://wixmp-833713b177cebf373f611808.wixmp.com/images/fa6ce74b7beec6c68741763ecc887ef5.png)

## Order Calculation

When editing an order, the draft order is re-calculated after each action, and reflects the most up-to-date totals and prices.

+ Newly added items, fees, and discounts are fetched with the latest prices.
+ Existing items, discounts, shipping methods and prices, as well as additional fees, keep their original price and are not automatically updated.
+ Taxes are recalculated automatically, unless the order is marked as tax-exempt.

## Order Total and Balance

When a draft order is committed, there are three possible outcomes that can affect the order's total:
1. Order total *increases*.
2. Order total *decreases*.
3. Order total remains *unchanged*.

Changes to the order’s total can affect the order balance, which represents the remaining amount to be paid. This is calculated as the order total minus any paid amounts.

When the order’s balance changes, there are 3 possible outcomes:
1. **Negative balance:** New order total is less than the amount paid. In this case, merchants can refund the difference back to their customers.
2. **Positive balance**: New order total is greater than the amount paid. Merchants can then charge the remaining order amount using appropriate methods.
3. **Zero balance**: New order total equals the amount paid, resulting in no further payment needed. Refunds or adjustments remain possible if applicable.

onDraftOrderCreated( )