--- title: "Basic platform configuration" slug: "basic-platform-configuration" updated: 2025-06-10T16:40:01Z published: 2025-06-10T16:40:01Z canonical: "docs.newstore.com/basic-platform-configuration" stale: true --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.newstore.com/llms.txt > Use this file to discover all available pages before exploring further. # Basic platform configuration Once we have the platform set up, it needs basic configuration to start any cash and carry transaction these not just include the [Mater Data](/v1/docs/loading-master-data) setup but also the configuration like order number sequence and associate app configurations. In this section, we will cover the basic configuration that is required to set up the platform for trade. ## Associate App configuration Associate App requires seven key configuration sections to enable core and optional functionalities: ### Capabilities Enable optional features to enhance in-store workflows: - `add_products_from_listing`: Allow adding products from the product listing page. - `send_email_receipt_from_order_history`: Allow sending email receipts from order history. ### Commerce components Configure critical commerce-related settings: - `barcode_types`: Define barcode types for scanning operations. Refer to [Configuring commerce components in NewStore Associate App](/v1/docs/configuring-commerce-components-in-newstore-associate-app) for detailed steps. ### Return process configuration Set up return-related options such as policies and workflow behavior. This will be covered in detail in [Module 2: Returns & exchanges](/v1/docs/module-2-returns-exchanges). ### UI configurations Manage visual and user-interface related preferences: - Tax exemption settings - Associate App logo (this should be in Base64 format, refer attached sample for more details.) ### Customizations Adjust the app behavior and layout via custom scripts or UI changes. Refer to [Configuring customizations in NewStore Associate App](/v1/docs/configuring-customizations-in-newstore-associate-app) for examples and use cases. ### Release toggles Control access to new or optional features: - Enable runner - Enable quantity picker ### External integration Configure loyalty program integration and authentication endpoints. > [!NOTE] > **API reference** > > - Use the [Update Associate App Configuration API](https://docs.newstore.net/api/configuration/apps/associate-app-config-api_config#tag/Associate-App-retailer-configuration/operation/getConfig) to apply these settings. > - Refer sample associate app configuration attached for reference. > > [](https://cdn.document360.io/c2d22fcd-a44b-4e1e-bf3a-84f0ffba0dbe/Images/Documentation/sample-AA-config-json.zip?sv=2026-02-06&spr=https&st=2026-11-16T04%3A23%3A33Z&se=2026-11-16T05%3A23%3A33Z&sr=c&sp=r&sig=aMRwbMk%2Fo%2F1Aq7Ld5cdzZfeb4w39zUvrdzSfzTzo47E%3D)sample-AA-config-json1.17 KB[](https://cdn.document360.io/c2d22fcd-a44b-4e1e-bf3a-84f0ffba0dbe/Images/Documentation/sample-AA-config-json.zip?sv=2026-02-06&spr=https&st=2026-11-16T04%3A23%3A33Z&se=2026-11-16T05%3A23%3A33Z&sr=c&sp=r&sig=aMRwbMk%2Fo%2F1Aq7Ld5cdzZfeb4w39zUvrdzSfzTzo47E%3D) ## Checkout configuration Establish and control checkout behavior across the platform and in Associate App. > [!NOTE] > API reference > > - Refer [Configuring checkout operations](/v1/docs/configuring-checkout-operations) for tutorial to understand the checkout configuration. ## Payment configuration To process in-store payments, configure accepted payment methods. This exercise includes: - cash - non_integrated (example, external payment terminals) > [!NOTE] > Tutorial > > - Refer to [Configuring payment options](/v1/docs/configuring-payment-options) for setup steps. > - Refund options will be addressed in [Module 2: Returns & exchanges](/v1/docs/module-2-returns-exchanges-new) ## Order ID sequence When an order is created, this configuration will determine the pattern in which the order number will be generated. > [!NOTE] > **API reference** > > - Use the [Set order ID sequence parameters](https://docs.newstore.net/api/configuration/order-management/sales_order_config/#tag/Sales-order-configuration/operation/showSalesOrderGeneratorSequence) API to configure the order number format. > - If the sequence is not set, a default using UUID v7 will be assigned. Orders will stop using this default ID once the sequence is configured. ## Financial document configuration Configure the tenant address for the retailer and the Invoice id patternso that the address will be used in different places including Invoice generation. > [!NOTE] > **API reference** > > - Use the [Create financial documents configuration](https://docs.newstore.net/api/configuration/checkout/financial_documents_config/#operation/ReplaceConfiguration) API to define invoice number and address formatting. ## Taxes NewStore platform offers a convenient tax calculation feature that can automatically determine taxes for merchandise and shipping. This feature supports four different modes, providing flexibility for various business needs. Configuration options are available at both the global and store levels, allowing for tailored settings. Additionally, the platform supports integrations with Avalara, Vertex Cloud, and custom integrations, as well as a flat rate option. The fixed rate can be configured at multiple levels. - Globally at the Tenant level - Per country level - Most granular which is the store level. > [!NOTE] > Important > > - This exercise only covers the flat rate configuration. > - Refer to [Configuring Avalara for tax calculation](/v1/docs/configuring-tax-calculation-settings) to configure Avalara for tax calculation and Avalara tax exemption class mapping. Tax committing using the productized Avalara integration is limited to in-store orders, where taxes are calculated within the NewStore platform. For more details, see [Tax committing use cases](/v1/docs/set-up-taxes#use-cases-for-tax-committing). > - Refer to [Configuring Vertex for tax calculation](/v1/docs/configuring-tax-calculation-settings#configuring-settings-for-vertex-integration) to configure Vertex for tax calculation. > - If the retailer chooses to bring their own tax engine, then refer [Setting up a custom tax provider](/v1/docs/setting-up-a-custom-tax-provider) to understand how to configure a custom tax solution. > - It’s always a best practice to configure offline tax rates to make sure if the integration to the tax engine fail, the default tax rate is used to calculate taxes. Refer [Fixed Rate fall back option configuration](/docs/configuring-tax-calculation-settings#configuring-a-fixed-tax-rate-fallback-for-external-tax-calculation-providers) to enable the config. > - [Tenant-level tax config](https://docs.newstore.net/api/configuration/f11n-taxes/taxes_config/#tag/Tenant-tax-configuration/operation/createTenantConfig) is mandatory; configure this first, before proceeding with [store-level tax setup](https://docs.newstore.net/api/configuration/f11n-taxes/taxes_config/#tag/Store-tax-configuration/operation/createStoreConfig). Configure at the global level if the settings are uniform across all stores, and at the store level if the settings are unique to each store. Use the [Taxes configuration API](https://docs.newstore.net/api/configuration/f11n-taxes/taxes_config/#tag/Store-tax-configuration/operation/createStoreConfig) to configure the fixed tax rate. ### Sample payload The following examples set the fixed tax rate at 0.05% with a tax name as `FIXED RATE`. ```json { "fixed_rate": { "tax_name": "FIXED RATE", "tax_rate": 0.05 }, "tax_calculation_strategy": "fixedrate" } ```