\",\n \"first_name\": \"<first name>\",\n \"last_name\": \"<last name>\",\n \"phone_number\": \"<phone number>\",\n \"email\": \"<email>\"\n },\n \"delivery\": {\n \"destination\": {\n \"address\": {\n \"id\": \"\",\n \"city\": \"<city>\",\n \"contact\": {\n \"title\": \"<title>\",\n \"first_name\": \"<first name>\",\n \"last_name\": \"<last name>\",\n \"phone_number\": \"<phone number>\",\n \"email\": \"<email>\"\n },\n \"lines\": [\n \"<address line>\"\n ],\n \"regions\": {\n \"country\": {\n \"code\": \"<country code>\"\n }\n },\n \"zip_code\": \"<zip code>\"\n }\n },\n \"type\": \"standard\"\n },\n \"pricing_details\": {\n \"currency\": \"<currency>\",\n \"address\": {\n \"id\": \"\",\n \"city\": \"<city>\",\n \"contact\": {\n \"title\": \"<title>\",\n \"first_name\": \"<first name>\",\n \"last_name\": \"<last name>\",\n \"phone_number\": \"<phone number>\",\n \"email\": \"<email>\"\n },\n \"lines\": [\n \"<address line>\"\n ],\n \"regions\": {\n \"country\": {\n \"code\": \"<country code>\"\n }\n },\n \"zip_code\": \"<zip code>\"\n },\n \"price\": 493\n },\n \"shipping_fees\": [\n {\n \"currency\": \"<currency>\",\n \"price\": 5,\n \"original_price\": 5,\n \"taxes\": [\n {\n \"id\": \"<shipping fee line id>\"\n }\n ]\n }\n ],\n \"order_items\": [\n {\n \"item_id\": \"15707351_BK_L\",\n \"quantity\": 1,\n \"pricing_details\": {\n \"currency\": \"<currency>\",\n \"original_price\": <price>,\n \"price\": <price>,\n \"original_unit_price\": <price>,\n \"unit_price\": <price>,\n \"taxes\": [\n {\n \"id\": \"<item line id in avalara>\"\n }\n ]\n }\n },\n {\n \"item_id\": \"15707351_BK_L\",\n \"quantity\": 1,\n \"pricing_details\": {\n \"currency\": \"<currency>\",\n \"original_price\": <price>,\n \"price\": <price>,\n \"original_unit_price\": <price>,\n \"unit_price\": <price>,\n \"taxes\": [\n {\n \"id\": \"<item line id in avalara>\"\n }\n ]\n }\n }\n ]\n }\n}","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"5. Limitations","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"5.1 Migration between environements","type":"text"}]},{"type":"paragraph","content":[{"type":"status","attrs":{"color":"yellow","style":"bold","text":"12.6","localId":"ca6e7e72-e0c6-42fa-81ef-5b8d4cf74eab"}},{"text":" At the moment, global configurations can be migrated between environments but Sales Channel configurations and providers configured for them are not migrated","type":"text"}]}],"version":1}</article></body></html>

{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"style":{"value":"none"}},"macroMetadata":{"macroId":{"value":"a3c9dfa5-4f04-411b-8cdd-8d21d32a30b7"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"9e28878b-41ee-4f90-89e4-664a94ee7ff0"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"1. Principle","type":"text"}]},{"type":"paragraph","content":[{"text":"Calculation for e-commerce sales in the US depends on both the source of the stock (Sales Tax Nexus) and the destination of the order (Destination-Based sales Taxes).","type":"text"}]},{"type":"paragraph","content":[{"text":"A brand using an OMS can’t rely anymore on their e-commerce connector to a Tax provider to commit taxes as the source of the stock is known by the OMS.","type":"text"}]},{"type":"paragraph","content":[{"text":"Our tax provider connector and official connection to Avalara allows OneStock to address this issue by","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Calculing taxes for our Order In Store module","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Commiting taxes to Avalara when orders are dispatched (either for Order In Store or e-commerce orders)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Void or refund taxes to Avalara when items are canceled or returned","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"1.1 Straight fulfill order","type":"text"}]},{"type":"paragraph","content":[{"text":"The sequence explains how OneStock communicates with Avalara for the most basic use case: an order in store with the item taken from the store’s stock.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":540,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1,"alt":"mermaid-diagram-2024-12-04-095853.svg","id":"d227fc90-31e8-466e-b794-d693c5c8b922","collection":"contentId-1129316359","type":"file","height":1}}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"1.2 Home delivery order","type":"text"}]},{"type":"paragraph","content":[{"text":"The sequence shows how OneStock communicates with Avalara at different stages of the order lifecycle, explaining what is done in case the order is canceled or returned.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"wide","width":996,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1,"alt":"mermaid-diagram-2024-12-04-152234.svg","id":"0cd2bc76-57d3-474f-a689-1f9b80956e26","collection":"contentId-1129316359","type":"file","height":1}}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"1.3 Tax states in Avalara","type":"text"}]},{"type":"paragraph","content":[{"text":"Taxes can have different states in Avalara:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Uncommitted : will match a status of a paid order but that is not in a final state in OneStock (processing, orchestrating), meaning that tax values can still change.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Committed : will match a fulfilled status in OneStock. At least an item is dispatched so taxes shouldn’t be modified.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Committed (refund) : A committed tax can have a negative value. It would mean that the tax was first committed before the order is returned and refunded.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Void : Happens when an order is cancelled entirely before any tax has been committed.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"2. Configuration","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"2.1 Pre-requisites","type":"text"}]},{"type":"paragraph","content":[{"text":"Before you dig in your tax journey, be sure that you have the bellow ready with your OneStock Business Analyst.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"An Order in Store saleschannel configured","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Stores with US addresses","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A payment provider configured and payment devices for the stores","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Returns and refunds are configured for the Order in Store saleschannel","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"You will also need an access to an Avalara account. Our qualif environment is linked to Avalara in Sandbox so make sure to request this access to your Avalara contact.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"2.2 Global tax configuration","type":"text"}]},{"type":"layoutSection","marks":[{"type":"breakout","attrs":{"mode":"wide"}}],"content":[{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Removed Line Item States : states of removed line items. When items are removed before the order is fulfiled, the tax provider needs to know that it has to commit a document without the items that have been cancelled by the client.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Commitable Parcel States : states of the parcels that needs to be commited","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"On you order, parcel and line item group workflows, you will have a new action : refresh_order_taxes.","type":"text"}]},{"type":"paragraph","content":[{"text":"This action will check that all your parcels are in the commitable parcel states that you’ve configured and that remaining items are in the removed line Item States to refresh the taxes in Avalara.","type":"text"}]},{"type":"paragraph","content":[{"text":"This is done to avoid unnecessary updates in Avalara.","type":"text"}]}]},{"type":"paragraph"},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Estimation Stock location : Stock location to be used for tax calculation as the source of stock. It can be overrided by sales channel.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Taxes Included In Price : Taxes are calculated and we display full prince including taxes. It can be overrided by sales channel.","type":"text"}]}]}]}]},{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"mediaSingle","attrs":{"layout":"center","width":480,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1392,"alt":"image-20241204-142135.png","id":"3662f931-8178-4ce1-ace5-46b7b79ee0fe","collection":"contentId-1129316359","type":"file","height":760}}]},{"type":"paragraph"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"2.3 Sales Channels tax configuration","type":"text"}]},{"type":"layoutSection","marks":[{"type":"breakout","attrs":{"mode":"wide"}}],"content":[{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"mediaSingle","attrs":{"layout":"center","width":480,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":2756,"alt":"image-20250205-085745.png","id":"f34d6ea2-4306-4f48-bd8a-3bd413ccebcf","collection":"contentId-1129316359","type":"file","height":1560}}]}]},{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Estimation Stock location : Stock location to be used for tax calculation as the source of stock","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Taxes Included In Price : Taxes are calculated and we display full prince including taxes.","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"2.4 Configuring Avalara as the tax provider","type":"text"}]},{"type":"layoutSection","marks":[{"type":"breakout","attrs":{"mode":"wide"}}],"content":[{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph","content":[{"text":"Add Avalara as your tax provider in your sales channel configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"You’ll have to do it for your Order In Store sales channel but also for the e-commerce sales channel if you are about to commit the taxes for all the client’s orders.","type":"text"}]}]},{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"mediaSingle","attrs":{"layout":"center","width":480,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":2756,"alt":"image-20250205-085842.png","id":"93bc8ec5-7923-43ba-9eae-c3c98ba77eef","collection":"contentId-1129316359","type":"file","height":1560}}]}]}]},{"type":"layoutSection","marks":[{"type":"breakout","attrs":{"mode":"wide"}}],"content":[{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"mediaSingle","attrs":{"layout":"center","width":480,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":2756,"alt":"image-20250205-085924.png","id":"7b8bfc47-1b84-439b-8479-50cc650b5fd5","collection":"contentId-1129316359","type":"file","height":1560}}]}]},{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph","content":[{"text":"Our OneStock qualification environment is connected to Avalara sandbox.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Username","type":"text","marks":[{"type":"strong"}]},{"text":" : your Avalara identifier","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Password","type":"text","marks":[{"type":"strong"}]},{"text":" : your Avalara password","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"After inputting your credentials, hit test connection","type":"text"}]}]}]}]},{"type":"layoutSection","marks":[{"type":"breakout","attrs":{"mode":"wide"}}],"content":[{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"AvaTax Account Number","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"AvaTax Company Id","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"paragraph","content":[{"text":"Find those two informations in your Avalara account","type":"text"}]}]},{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"mediaSingle","attrs":{"layout":"center","width":612,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":612,"alt":"image-20241202-133433.png","id":"49e8e427-929f-47dd-8acd-d7e7d16055bd","collection":"contentId-1129316359","type":"file","height":360}}]},{"type":"mediaSingle","attrs":{"layout":"center","width":480,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":612,"alt":"image-20241202-133451.png","id":"bfc34492-a4c0-4ff9-974e-f281d6d362b8","collection":"contentId-1129316359","type":"file","height":360}}]},{"type":"paragraph"}]}]},{"type":"layoutSection","marks":[{"type":"breakout","attrs":{"mode":"wide"}}],"content":[{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"mediaSingle","attrs":{"layout":"center","width":480,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":2756,"alt":"image-20250205-090001.png","id":"fe73ce57-4b47-49bd-bc3d-fe189aa8578c","collection":"contentId-1129316359","type":"file","height":1560}}]}]},{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Disable tax recording at Avalara","type":"text","marks":[{"type":"strong"}]},{"text":" : if activated, OneStock will never commit the taxes","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Avatax Company code","type":"text","marks":[{"type":"strong"}]},{"text":" : if your test connection has been done, a dropdown will display available value from your Avalara account","type":"text"}]}]}]}]}]},{"type":"layoutSection","marks":[{"type":"breakout","attrs":{"mode":"wide"}}],"content":[{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Location code","type":"text","marks":[{"type":"strong"}]},{"text":" : the location code (defined at Avalara) used by default if not defined at stock location level. To defined at stock location level you can go to the stock location detail page on the Taxes tab","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":456,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":2756,"alt":"image-20250108-140154.png","id":"ec67009b-85ef-4cf6-b536-22f75f886424","collection":"contentId-1129316359","type":"file","height":1610}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Use endpoint identifier as location code","type":"text","marks":[{"type":"strong"}]},{"text":" : If activated, it will force the stock location id as the location code over the sales channel configuration and the stock location configuration.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Features language","type":"text","marks":[{"type":"strong"}]},{"text":" : The features language where we will search for the item data for HS Code, Item description, and Tax code","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Default description","type":"text","marks":[{"type":"strong"}]},{"text":" : default description for items if not defined in the item feature","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Description feature","type":"text","marks":[{"type":"strong"}]},{"text":" : name of the feature of the item which contains the description","type":"text"}]}]}]}]},{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"mediaSingle","attrs":{"layout":"center","width":480,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":2756,"alt":"image-20250205-090031.png","id":"bb18da8c-500f-4e0f-aba3-9840a353baee","collection":"contentId-1129316359","type":"file","height":1560}}]},{"type":"paragraph"}]}]},{"type":"layoutSection","marks":[{"type":"breakout","attrs":{"mode":"wide"}}],"content":[{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Default HS Code","type":"text","marks":[{"type":"strong"}]},{"text":" : Default ","type":"text"},{"text":"Harmonized System","type":"text","marks":[{"type":"strong"}]},{"text":" code for products if the item does not contain the HS Code feature configured bellow.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"here","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.avalara.com/eu/en/solutions/cross-border/item-classification-hs-commodity-codes.html"}}]},{"text":" to lear more about HS codes","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"here","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.tariffnumber.com/"}}]},{"text":" if you are searching the correct HS code for your product","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"HS Code feature","type":"text","marks":[{"type":"strong"}]},{"text":" : name of the product feature sent to OneStock that describe the HS code to use for this product","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Default Tax Code","type":"text","marks":[{"type":"strong"}]},{"text":" : Default tax code for items if not defined in the item feature.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Tax code feature","type":"text","marks":[{"type":"strong"}]},{"text":" : Name of the feature of the item which contains the tax code.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"here","type":"text","marks":[{"type":"link","attrs":{"href":"https://taxcode.avatax.avalara.com/"}}]},{"text":" to find valid tax codes","type":"text"}]}]}]}]}]}]},{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"mediaSingle","attrs":{"layout":"center","width":480,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":2756,"alt":"image-20250205-090235.png","id":"25ac8e97-950a-471d-a60f-41a3ff3d4d8a","collection":"contentId-1129316359","type":"file","height":1560}}]}]}]},{"type":"layoutSection","marks":[{"type":"breakout","attrs":{"mode":"wide"}}],"content":[{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph","content":[{"text":"Shipping fees","type":"text","marks":[{"type":"strong"}]},{"text":" : configure which tax code and item code needs to be used for all your delivery options on the Order In Store","type":"text"}]}]},{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"mediaSingle","attrs":{"layout":"center","width":480,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":2756,"alt":"image-20250205-090256.png","id":"b24c992e-fdc1-4b68-ab8b-329b623a83b0","collection":"contentId-1129316359","type":"file","height":1560}}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"3. Workflows","type":"text"}]},{"type":"paragraph","content":[{"text":"To correctly update your taxes at the correct timing, you will have to add some action on your project workflows.","type":"text"}]},{"type":"paragraph","content":[{"text":"We’ve introduced 3 actions to be added in different parts of your workflows. Bellow we describe our recommendation for basic implementation of the taxes on where you should add those actions.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"3.1 refresh_order_taxes","type":"text"}]},{"type":"paragraph","content":[{"text":"Workflows : ","type":"text"},{"type":"status","attrs":{"color":"neutral","style":"bold","text":"order","localId":"28742b3e-6a0f-4be7-a13e-c467e5c3a773"}},{"text":" ","type":"text"},{"type":"status","attrs":{"color":"neutral","style":"bold","text":"parcel","localId":"fb37fd34-d639-4f45-a6b8-df79cfa69d07"}},{"text":" ","type":"text"},{"type":"status","attrs":{"color":"neutral","style":"bold","text":"line item groups","localId":"2791c3fb-2d4d-4207-af7f-0dcb7ebee077"}},{"text":" ","type":"text"}]},{"type":"layoutSection","content":[{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"mediaSingle","attrs":{"layout":"center","width":354,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":2756,"alt":"image-20241202-144842.png","id":"6054016b-0a3b-4372-9802-a572b1f96dbf","collection":"contentId-1129316359","type":"file","height":1626}}]}]},{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph","content":[{"text":"Allow to create or refresh a tax document for the order linked to the entity of your workflow.","type":"text"}]},{"type":"paragraph","content":[{"text":"Should be used to update taxes for direct capture payments. In case of deferred capture, the payment service will automatically request for the tax refresh.","type":"text"}]},{"type":"paragraph","content":[{"text":"The refresh will only be done for orders that are in final states, ","type":"text"},{"text":"see 2.2 configuration","type":"text","marks":[{"type":"link","attrs":{"href":"https://onestock.atlassian.net/wiki/spaces/DOCUMENTAT/pages/1129316359/Tax+Connector+-+Avalara#2.2-Global-tax-configuration"}}]},{"text":" above.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"3.2 refund_order_taxes","type":"text"}]},{"type":"paragraph","content":[{"text":"Workflows : ","type":"text"},{"type":"status","attrs":{"color":"neutral","style":"bold","text":"line item groups","localId":"01c438ff-6d83-4fd0-969c-73eddfd6d763"}}]},{"type":"layoutSection","content":[{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"mediaSingle","attrs":{"layout":"center","width":354,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":2790,"alt":"image-20241203-151457.png","id":"23dae76c-748a-44fe-8423-fc3393d77ac8","collection":"contentId-1129316359","type":"file","height":1640}}]}]},{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph","content":[{"text":"Allow to refund taxes that have already been committed.","type":"text"}]},{"type":"paragraph","content":[{"text":"Use case to implement is for returns.","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"The action will not work on an order in store.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"3.3 void_order_taxes","type":"text"}]},{"type":"paragraph","content":[{"text":"Workflows : ","type":"text"},{"type":"status","attrs":{"color":"neutral","style":"bold","text":"order","localId":"41342328-bd14-4dfc-8313-2f1452ac9cc8"}}]},{"type":"layoutSection","content":[{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"mediaSingle","attrs":{"layout":"center","width":354,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":2790,"alt":"image-20241203-151457.png","id":"23dae76c-748a-44fe-8423-fc3393d77ac8","collection":"contentId-1129316359","type":"file","height":1640}}]}]},{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph","content":[{"text":"Allows to delete a tax document for an uncommited tax.","type":"text"}]},{"type":"paragraph","content":[{"text":"Use case is for an order that is removed without being orchestrated.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"4. Sending Avalara tax information with new orders","type":"text"}]},{"type":"paragraph","content":[{"text":"In order for OneStock to commit / void taxes that an ecommerce has declared but not committed to Avalara, the order data needs some additional informations.","type":"text"}]},{"type":"table","attrs":{"layout":"center","width":910.0,"localId":"69543b21-1ed9-478a-a4e1-fef3d56108a6"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Field","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"order.taxes_information.provider_transaction_id","type":"text"}]},{"type":"paragraph","content":[{"text":"string - mandatory","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"The transaction id in Avalara.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"order.taxes_information.exemption_code","type":"text"}]},{"type":"paragraph","content":[{"text":"string - optional","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"If there is a tax exemption for this order","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"order.shipping_fees[].taxes[].id","type":"text"}]},{"type":"paragraph","content":[{"text":"Array object - optional","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"The id for the shipping fee line in Avalara","type":"text"}]},{"type":"paragraph","content":[{"text":"In Avalara, the shipping fee is declared as an order line item. We use this to correctly commit and update the shipping fee taxes.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"order.order_items[].pricing_details.taxes[].id","type":"text"}]},{"type":"paragraph","content":[{"text":"string","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"The line id for each item in Avalara","type":"text"}]}]}]}]},{"type":"expand","attrs":{"title":"Example order payload"},"content":[{"type":"codeBlock","content":[{"text":"{\n \"order\": {\n \"id\": \"\",\n \"types\": [\n \"ffs\"\n ],\n \"taxes_information\": {\n \"provider_transaction_id\": \"\",\n \"exemption_code\": \"\"\n },\n \"sales_channel\": \"\",\n \"customer\": {\n \"title\": \"\",\n \"first_name\": \"<first name>\",\n \"last_name\": \"<last name>\",\n \"phone_number\": \"<phone number>\",\n \"email\": \"<email>\"\n },\n \"delivery\": {\n \"destination\": {\n \"address\": {\n \"id\": \"\",\n \"city\": \"<city>\",\n \"contact\": {\n \"title\": \"<title>\",\n \"first_name\": \"<first name>\",\n \"last_name\": \"<last name>\",\n \"phone_number\": \"<phone number>\",\n \"email\": \"<email>\"\n },\n \"lines\": [\n \"<address line>\"\n ],\n \"regions\": {\n \"country\": {\n \"code\": \"<country code>\"\n }\n },\n \"zip_code\": \"<zip code>\"\n }\n },\n \"type\": \"standard\"\n },\n \"pricing_details\": {\n \"currency\": \"<currency>\",\n \"address\": {\n \"id\": \"\",\n \"city\": \"<city>\",\n \"contact\": {\n \"title\": \"<title>\",\n \"first_name\": \"<first name>\",\n \"last_name\": \"<last name>\",\n \"phone_number\": \"<phone number>\",\n \"email\": \"<email>\"\n },\n \"lines\": [\n \"<address line>\"\n ],\n \"regions\": {\n \"country\": {\n \"code\": \"<country code>\"\n }\n },\n \"zip_code\": \"<zip code>\"\n },\n \"price\": 493\n },\n \"shipping_fees\": [\n {\n \"currency\": \"<currency>\",\n \"price\": 5,\n \"original_price\": 5,\n \"taxes\": [\n {\n \"id\": \"<shipping fee line id>\"\n }\n ]\n }\n ],\n \"order_items\": [\n {\n \"item_id\": \"15707351_BK_L\",\n \"quantity\": 1,\n \"pricing_details\": {\n \"currency\": \"<currency>\",\n \"original_price\": <price>,\n \"price\": <price>,\n \"original_unit_price\": <price>,\n \"unit_price\": <price>,\n \"taxes\": [\n {\n \"id\": \"<item line id in avalara>\"\n }\n ]\n }\n },\n {\n \"item_id\": \"15707351_BK_L\",\n \"quantity\": 1,\n \"pricing_details\": {\n \"currency\": \"<currency>\",\n \"original_price\": <price>,\n \"price\": <price>,\n \"original_unit_price\": <price>,\n \"unit_price\": <price>,\n \"taxes\": [\n {\n \"id\": \"<item line id in avalara>\"\n }\n ]\n }\n }\n ]\n }\n}","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"5. Limitations","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"5.1 Migration between environements","type":"text"}]},{"type":"paragraph","content":[{"type":"status","attrs":{"color":"yellow","style":"bold","text":"12.6","localId":"ca6e7e72-e0c6-42fa-81ef-5b8d4cf74eab"}},{"text":" At the moment, global configurations can be migrated between environments but Sales Channel configurations and providers configured for them are not migrated","type":"text"}]}],"version":1}</article></body></html>