Warning
This app has been replaced with Taxes App
Warning The app is work in progress. Not ready to use.
The sales tax calculation with using Avatax API.
The app uses synchronous webhooks: checkout-calculate-taxes, order-calculate-taxes, to calculate sales taxes for Saleor.
The Avatax's order transaction is created for each order (by using order-created webhook).
App installation on Saleor is described here:
- from the command line: https://docs.saleor.io/docs/3.x/developer/extending/apps/installing-apps#installing-third-party-apps
- from graphQL API: https://docs.saleor.io/docs/3.x/developer/extending/apps/installing-apps#installation-using-graphql-api
- from dashboard:
https://<saleor-domain>/apps/install?manifestUrl=https://<app-domain>/api/manifest
where manifest path is https://<app-domain>/api/manifest.
The App configuration can be done from the Saleor dashboard. After sucesfull app installation, go to saleor-dashboard -> apps -> Saleor Avatax:
API Keyis mandatory to activate the app. To generate API key, go to Avatax admin pannel -> Settings -> License and API keys -> Generate API key.Ship fromdetails are mandatory for correct tax calculation.- Enable
Activewhen you are ready to use Avatax App. - Enable
Sandboxwhen you use Avatax in sandbox mode.
Note Checkouts and orders that are related to not configured channels will be skipped by App. Taxes will not be calculated for them. Make sure that you activate Avatax App for all required channels.
The Avatax tax group can be set in Product metadata or ProductType metadata. The expected metadata field name is avatax_tax_code. The Avatax tax groups can be found here.
When the tax group is not set, the standard tax group will be used.
Update .env file:
SALEOR_DOMAIN=your-saleor-instance.com
Install dependencies pnpm install
Start local server pnpm run dev
Follow the guide how install your app and use tunneling tools like localtunnel or ngrok in order to expose your local server.
If you use saleor-dashboard and your local server is exposed, you can install your app by following this link:
[YOUR_SALEOR_DASHBOARD_URL]/apps/install?manifestUrl=[YOUR_APPS_MANIFEST_URL]
Commands build and dev would generate schema and typed functions using Saleor's GraphQL endpoint. Commit generated folder to your repo as they are necessary for queries and keeping track of the schema changes.
Learn more about GraphQL code generation.
SETTINGS_ENCRYPTION_SECRET- used to encrypt/decrypt secret data (like Password) that is stored in Saleor's App's private metadata.SALEOR_DOMAIN- Only declared Saleor domain will be allowed to fetch taxes from the app.