### Sana Commerce Getting Started and Guides

Source: https://developer.sana-commerce.com/contracts/extensions/reference/system-page-sitemap-item-group

Resources for developers new to Sana Commerce, including initial setup and guides for integration.

```APIDOC
GettingStarted:
  Description: Guide for new developers to get started with Sana Commerce.
  URL: https://developer.sana-commerce.com/getting-started/index.html

IntegrationGuides:
  Description: Guides for integrating with the Sana Commerce platform.
  URL: https://developer.sana-commerce.com/guides/integrate/index.html
```

--------------------------------

### Sana Commerce Getting Started and Guides

Source: https://developer.sana-commerce.com/contracts/extensions/reference/weight

Resources for developers new to Sana Commerce, including initial setup and guides for integration.

```APIDOC
Getting Started:
  - Main: https://developer.sana-commerce.com/getting-started/index.html
Guides:
  - Integration: https://developer.sana-commerce.com/guides/integrate/index.html
```

--------------------------------

### Sana Commerce Getting Started Guide

Source: https://developer.sana-commerce.com/contracts/extensions/reference/basket/basket-validation-extension

The initial guide for developers new to Sana Commerce, covering setup and basic concepts.

```APIDOC
Getting Started:
  Description: Initial steps and setup for Sana Commerce development.
  Reference: https://developer.sana-commerce.com/getting-started/index.html
```

--------------------------------

### Sana Commerce Getting Started

Source: https://developer.sana-commerce.com/guides/integrate/checkout-item-line-comment/custom-display

Guides to help new developers begin with Sana Commerce, covering initial setup and fundamental concepts.

```en
https://developer.sana-commerce.com/getting-started/index.html
```

--------------------------------

### Sana Commerce Getting Started

Source: https://developer.sana-commerce.com/guides/customize/advanced-components/navigation-search

Initial steps and guidance for getting started with Sana Commerce development.

```en
https://developer.sana-commerce.com/getting-started/index.html
```

--------------------------------

### Sana Commerce Developer Getting Started and Guides

Source: https://developer.sana-commerce.com/contracts/client-apps/hooks/webstore/use-has-abilities

This section provides introductory information for developers new to Sana Commerce, including a getting started guide and various integration guides.

```html
<a href="https://developer.sana-commerce.com/getting-started/index.html">Getting Started</a>
<a href="https://developer.sana-commerce.com/guides/integrate/index.html">Guides</a>
```

--------------------------------

### Sana Commerce Installation and Configuration Guides

Source: https://developer.sana-commerce.com/guides/integrate/product/create-product-update-extension

Guides related to installation and general configuration of Sana Commerce. Covers managing Node.js installations and understanding the configuration page in Sana Admin.

```APIDOC
Managing multiple NodeJs installations:
  Description: Best practices for managing multiple Node.js installations for Sana Commerce projects.
  URL: https://developer.sana-commerce.com/guides/configurations-guides/managing-multiple-nodejs-installations.html

Configuration page in Sana Admin:
  Description: Overview of the configuration page within Sana Admin and its functionalities.
  URL: https://developer.sana-commerce.com/guides/configurations-guides/extension-configuration.html
```

--------------------------------

### Sana Commerce Getting Started and Guides

Source: https://developer.sana-commerce.com/contracts/extensions/reference/checkout-item-line-product

Provides initial steps for developers and guides for integrating with Sana Commerce, including information on extension points and client app development.

```APIDOC
Sana Commerce Developer Resources:

Getting Started:
  - Main Page: https://developer.sana-commerce.com/getting-started/index.html

Guides:
  - Integration Guide: https://developer.sana-commerce.com/guides/integrate/index.html

Extension Points:
  - Overview: https://developer.sana-commerce.com/contracts/extensions/index.html
  - Checkout Item Line Product: https://developer.sana-commerce.com/contracts/extensions/reference/checkout-item-line-product.html

Client App Development:
  - Overview: https://developer.sana-commerce.com/contracts/client-apps/index.html
  - JavaScript API: https://developer.sana-commerce.com/contracts/client-apps/javascript-apis.html
  - React Hooks (Admin): https://developer.sana-commerce.com/contracts/client-apps/hooks/admin/use-external-help-links.html
```

--------------------------------

### Sana Commerce Getting Started and Guides

Source: https://developer.sana-commerce.com/contracts/extensions/reference/payment-authorisation-adjustment-context

Resources for new developers to get started with Sana Commerce and guides for integrating with the platform.

```APIDOC
Getting Started:
  - Main Page: https://developer.sana-commerce.com/getting-started/index.html
Guides:
  - Integration Guide: https://developer.sana-commerce.com/guides/integrate/index.html
```

--------------------------------

### Sana Commerce Installation and Configuration Guides

Source: https://developer.sana-commerce.com/guides/customize/custom-system-page/index

Guides related to installation and general configuration of Sana Commerce. Covers managing Node.js installations and understanding the configuration page in Sana Admin.

```APIDOC
Managing multiple NodeJs installations:
  Description: Best practices for managing multiple Node.js installations for Sana Commerce projects.
  URL: https://developer.sana-commerce.com/guides/configurations-guides/managing-multiple-nodejs-installations.html

Configuration page in Sana Admin:
  Description: Overview of the configuration page within Sana Admin and its functionalities.
  URL: https://developer.sana-commerce.com/guides/configurations-guides/extension-configuration.html
```

--------------------------------

### Sana Commerce Installation and Configuration Guides

Source: https://developer.sana-commerce.com/guides/integrate/payment/new-psp/payment-extra-checkout-step

Guides related to installation and general configuration of Sana Commerce. Covers managing Node.js installations and understanding the configuration page in Sana Admin.

```APIDOC
Managing multiple NodeJs installations:
  Description: Best practices for managing multiple Node.js installations for Sana Commerce projects.
  URL: https://developer.sana-commerce.com/guides/configurations-guides/managing-multiple-nodejs-installations.html

Configuration page in Sana Admin:
  Description: Overview of the configuration page within Sana Admin and its functionalities.
  URL: https://developer.sana-commerce.com/guides/configurations-guides/extension-configuration.html
```

--------------------------------

### Sana Commerce Guides and Getting Started

Source: https://developer.sana-commerce.com/contracts/extensions/reference/punchout-shipping-addresses-request-context

Resources for getting started with Sana Commerce and guides for integration.

```APIDOC
Getting Started:
  url: https://developer.sana-commerce.com/getting-started/index.html
Guides:
  Integration: https://developer.sana-commerce.com/guides/integrate/index.html
```

--------------------------------

### Sana Commerce Getting Started and Guides

Source: https://developer.sana-commerce.com/contracts/extensions/reference/punchout-product

Provides introductory information and guides for developers new to Sana Commerce, covering integration and core concepts.

```APIDOC
Sana Commerce Developer Resources:

Navigation:
  - Getting Started: https://developer.sana-commerce.com/getting-started/index.html
  - Guides:
    - Integrate: https://developer.sana-commerce.com/guides/integrate/index.html
  - References: https://developer.sana-commerce.com/contracts/index.html
  - Extension Points: https://developer.sana-commerce.com/contracts/extensions/index.html
  - Punchout:
    - PunchoutProduct: https://developer.sana-commerce.com/contracts/extensions/reference/punchout-product.html

Additional Information:
  - Become a partner: https://www.sana-commerce.com/partners/
  - Sana Assistant (online): https://developer.sana-commerce.com/index.html
```

--------------------------------

### Sana Commerce Installation and Configuration Guides

Source: https://developer.sana-commerce.com/guides/integrate/cpq/index

Guides related to installation and general configuration of Sana Commerce. Covers managing Node.js installations and understanding the configuration page in Sana Admin.

```APIDOC
Managing multiple NodeJs installations:
  Description: Best practices for managing multiple Node.js installations for Sana Commerce projects.
  URL: https://developer.sana-commerce.com/guides/configurations-guides/managing-multiple-nodejs-installations.html

Configuration page in Sana Admin:
  Description: Overview of the configuration page within Sana Admin and its functionalities.
  URL: https://developer.sana-commerce.com/guides/configurations-guides/extension-configuration.html
```

--------------------------------

### Sana Commerce Installation and Configuration Guides

Source: https://developer.sana-commerce.com/guides/integrate/erp/create-connection-interceptor-listing

Guides related to installation and general configuration of Sana Commerce. Covers managing Node.js installations and understanding the configuration page in Sana Admin.

```APIDOC
Managing multiple NodeJs installations:
  Description: Best practices for managing multiple Node.js installations for Sana Commerce projects.
  URL: https://developer.sana-commerce.com/guides/configurations-guides/managing-multiple-nodejs-installations.html

Configuration page in Sana Admin:
  Description: Overview of the configuration page within Sana Admin and its functionalities.
  URL: https://developer.sana-commerce.com/guides/configurations-guides/extension-configuration.html
```

--------------------------------

### Sana Commerce Getting Started and Guides

Source: https://developer.sana-commerce.com/contracts/extensions/reference/product-data-export/models/bom-component-translation

Resources for developers to get started with Sana Commerce and explore integration guides.

```APIDOC
Getting Started:
  - Main: https://developer.sana-commerce.com/getting-started/index.html
Guides:
  - Integration: https://developer.sana-commerce.com/guides/integrate/index.html
```

--------------------------------

### Sana Commerce Installation and Configuration Guides

Source: https://developer.sana-commerce.com/guides/integrate/shipping/shipping-method-settings

Guides related to installation and general configuration of Sana Commerce. Covers managing Node.js installations and understanding the configuration page in Sana Admin.

```APIDOC
Managing multiple NodeJs installations:
  Description: Best practices for managing multiple Node.js installations for Sana Commerce projects.
  URL: https://developer.sana-commerce.com/guides/configurations-guides/managing-multiple-nodejs-installations.html

Configuration page in Sana Admin:
  Description: Overview of the configuration page within Sana Admin and its functionalities.
  URL: https://developer.sana-commerce.com/guides/configurations-guides/extension-configuration.html
```

--------------------------------

### Sana Commerce Installation and Configuration Guides

Source: https://developer.sana-commerce.com/guides/integrate/exports/product-export

Guides related to installation and general configuration of Sana Commerce. Covers managing Node.js installations and understanding the configuration page in Sana Admin.

```APIDOC
Managing multiple NodeJs installations:
  Description: Best practices for managing multiple Node.js installations for Sana Commerce projects.
  URL: https://developer.sana-commerce.com/guides/configurations-guides/managing-multiple-nodejs-installations.html

Configuration page in Sana Admin:
  Description: Overview of the configuration page within Sana Admin and its functionalities.
  URL: https://developer.sana-commerce.com/guides/configurations-guides/extension-configuration.html
```

--------------------------------

### Sana Commerce Configuration and Installation Guides

Source: https://developer.sana-commerce.com/guides/customize/advanced-components/content-block

Guides related to Sana Commerce installation, configuration, and data upgrades. Includes managing Node.js installations and understanding data upgrade processes.

```APIDOC
Managing Multiple NodeJs Installations:
  - Best practices for handling different Node.js versions.
  - Ensure compatibility and avoid conflicts.

Configuration Page in Sana Admin:
  - Overview of the configuration settings available in Sana Admin.
  - How to manage extension configurations.

Data Upgrades:
  - Introduction to data upgrade processes.
  - Understanding the internal flow and implementation path for data migrations.
```

--------------------------------

### Sana Commerce Configuration and Installation Guides

Source: https://developer.sana-commerce.com/guides/configurations-guides/use-resources

Guides related to Sana Commerce installation, configuration, and data upgrades. Includes managing Node.js installations and understanding data upgrade processes.

```APIDOC
Managing Multiple NodeJs Installations:
  - Best practices for handling different Node.js versions.
  - Ensure compatibility and avoid conflicts.

Configuration Page in Sana Admin:
  - Overview of the configuration settings available in Sana Admin.
  - How to manage extension configurations.

Data Upgrades:
  - Introduction to data upgrade processes.
  - Understanding the internal flow and implementation path for data migrations.
```

--------------------------------

### Sana Commerce Installation and Configuration Guides

Source: https://developer.sana-commerce.com/guides/configurations-guides/extension-configuration

Guides related to installation and general configuration of Sana Commerce. Covers managing Node.js installations and understanding the configuration page in Sana Admin.

```APIDOC
Managing multiple NodeJs installations:
  Description: Best practices for managing multiple Node.js installations for Sana Commerce projects.
  URL: https://developer.sana-commerce.com/guides/configurations-guides/managing-multiple-nodejs-installations.html

Configuration page in Sana Admin:
  Description: Overview of the configuration page within Sana Admin and its functionalities.
  URL: https://developer.sana-commerce.com/guides/configurations-guides/extension-configuration.html
```

--------------------------------

### Sana Commerce Installation and Configuration Guides

Source: https://developer.sana-commerce.com/guides/integrate/email/send-email

Guides related to installation and general configuration of Sana Commerce. Covers managing Node.js installations and understanding the configuration page in Sana Admin.

```APIDOC
Managing multiple NodeJs installations:
  Description: Best practices for managing multiple Node.js installations for Sana Commerce projects.
  URL: https://developer.sana-commerce.com/guides/configurations-guides/managing-multiple-nodejs-installations.html

Configuration page in Sana Admin:
  Description: Overview of the configuration page within Sana Admin and its functionalities.
  URL: https://developer.sana-commerce.com/guides/configurations-guides/extension-configuration.html
```

--------------------------------

### Sana Commerce Configuration and Installation Guides

Source: https://developer.sana-commerce.com/guides/customize/advanced-components/sales-orders-map

Guides related to Sana Commerce installation, configuration, and data upgrades. Includes managing Node.js installations and understanding data upgrade processes.

```APIDOC
Managing Multiple NodeJs Installations:
  - Best practices for handling different Node.js versions.
  - Ensure compatibility and avoid conflicts.

Configuration Page in Sana Admin:
  - Overview of the configuration settings available in Sana Admin.
  - How to manage extension configurations.

Data Upgrades:
  - Introduction to data upgrade processes.
  - Understanding the internal flow and implementation path for data migrations.
```

--------------------------------

### Sana Commerce Installation and Configuration Guides

Source: https://developer.sana-commerce.com/guides/integrate/checkout-item-line-comment/basic-custom-editor

Guides related to installation and general configuration of Sana Commerce. Covers managing Node.js installations and understanding the configuration page in Sana Admin.

```APIDOC
Managing multiple NodeJs installations:
  Description: Best practices for managing multiple Node.js installations for Sana Commerce projects.
  URL: https://developer.sana-commerce.com/guides/configurations-guides/managing-multiple-nodejs-installations.html

Configuration page in Sana Admin:
  Description: Overview of the configuration page within Sana Admin and its functionalities.
  URL: https://developer.sana-commerce.com/guides/configurations-guides/extension-configuration.html
```

--------------------------------

### Sana Commerce Installation and Configuration Guides

Source: https://developer.sana-commerce.com/guides/integrate/checkout-item-line-comment/validation-for-default-sana-editor

Guides related to installation and general configuration of Sana Commerce. Covers managing Node.js installations and understanding the configuration page in Sana Admin.

```APIDOC
Managing multiple NodeJs installations:
  Description: Best practices for managing multiple Node.js installations for Sana Commerce projects.
  URL: https://developer.sana-commerce.com/guides/configurations-guides/managing-multiple-nodejs-installations.html

Configuration page in Sana Admin:
  Description: Overview of the configuration page within Sana Admin and its functionalities.
  URL: https://developer.sana-commerce.com/guides/configurations-guides/extension-configuration.html
```

--------------------------------

### Sana Commerce Installation and Configuration

Source: https://developer.sana-commerce.com/guides/customize/index

Guides related to Sana Commerce installation and general configuration, including managing Node.js installations and understanding the configuration page in Sana Admin.

```APIDOC
Installation and Configuration:
  Managing multiple NodeJs installations: Guide for handling multiple Node.js installations.
  Configuration page in Sana Admin: Overview of the configuration page within Sana Admin.
  Extension Configuration: Details on configuring extensions.
```

--------------------------------

### Sana Commerce Installation and Configuration

Source: https://developer.sana-commerce.com/guides/integrate/index

Guides related to Sana Commerce installation and general configuration, including managing Node.js installations and understanding the configuration page in Sana Admin.

```APIDOC
Installation and Configuration:
  Managing multiple NodeJs installations: Guide for handling multiple Node.js installations.
  Configuration page in Sana Admin: Overview of the configuration page within Sana Admin.
  Extension Configuration: Details on configuring extensions.
```

--------------------------------

### Sana Commerce Getting Started and References

Source: https://developer.sana-commerce.com/guides/integrate/shipping-addresses/filter-shipping-address-options

Information on getting started with Sana Commerce development and references to API contracts.

```en
Getting Started: https://developer.sana-commerce.com/getting-started/index.html
References: https://developer.sana-commerce.com/contracts/index.html
```

--------------------------------

### Managing Multiple Node.js Installations

Source: https://developer.sana-commerce.com/guides/configurations-guides/managing-multiple-nodejs-installations

This guide explains how to manage multiple Node.js installations, which is crucial for development environments that require different Node.js versions for various projects.

```en
https://developer.sana-commerce.com/guides/configurations-guides/managing-multiple-nodejs-installations.html
```

--------------------------------

### Sana Commerce Getting Started

Source: https://developer.sana-commerce.com/guides/integrate/checkout-item-line-comment/validation-for-custom-editor

Initial steps and guidance for developers new to Sana Commerce integration.

```en
https://developer.sana-commerce.com/getting-started/index.html
```

--------------------------------

### Sana Commerce Getting Started and Guides

Source: https://developer.sana-commerce.com/contracts/extensions/reference/autocomplete-address

Provides introductory information and guides for developers new to Sana Commerce, covering integration and core concepts.

```APIDOC
Sana Commerce Developer Navigation:

Getting Started:
  - https://developer.sana-commerce.com/getting-started/index.html

Guides:
  - Integrate: https://developer.sana-commerce.com/guides/integrate/index.html

Structure of Package:
  - https://developer.sana-commerce.com/contracts/extensions/package-structure.html
```

--------------------------------

### Sana Commerce WebApp Startup Project Profiles

Source: https://developer.sana-commerce.com/getting-started/developing-an-addon/environment-setup

Describes the available profiles for running the Sana.Commerce.WebApp project, including IIS Express, Sana.Commerce.WebApp (Kestrel), and Watch mode.

```csharp
  7. Set `Sana.Commerce.WebApp` as the startup project and run it to make sure that everything has been correctly configured. There are 3 available profiles to run `Sana.Commerce.WebApp`:
     * _IIS Express_ - selected by default, which runs lightweight IIS HTTP Server integrated to Visual studio. It allows to use some IIS-related features, but this method is not fastest during development.
     * _Sana.Commerce.WebApp_ - **recommended** for development. Project profile, which runs the application using Kestrel server, which execution is faster than _IIS Express_.
     * _Watch_ - runs application in a Watch mode, which tracks source files changes and executes .NET Core CLI `run` command. Also to make application start faster, make sure that you run app without debugger attached to it unless you have a reason for that.
```

--------------------------------

### Setup Frontend Structure (React)

Source: https://developer.sana-commerce.com/getting-started/developing-an-addon/simple-cb-tutorial

Establishes the basic directory and file structure for the React UI component. This includes setting up the necessary files for a React application.

```JavaScript
// Example directory structure:
// -
//   src/
//     components/
//       SimpleContentBlock.jsx
//     index.js
//
// src/index.js:
// import React from 'react';
// import ReactDOM from 'react-dom/client';
// import SimpleContentBlock from './components/SimpleContentBlock';
// 
// const root = ReactDOM.createRoot(document.getElementById('root'));
// root.render(
//   <React.StrictMode>
//     <SimpleContentBlock />
//   </React.StrictMode>
// );

```

--------------------------------

### Sana Commerce SDK Prerequisites

Source: https://developer.sana-commerce.com/getting-started/developing-an-addon/environment-setup

Lists the essential software and tools required to set up the Sana Commerce SDK development environment. This includes Node.js, TypeScript, Git, and an IDE.

```en
Prerequisites:
  1. Node.js v20 LTS
  2. TypeScript
  3. GIT (available in PATH)
  4. Visual Studio 2022 or Visual Studio Code
  5. Sana Commerce SDK package
```

--------------------------------

### Install Client-Side Packages

Source: https://developer.sana-commerce.com/getting-started/developing-an-addon/environment-setup

Installs necessary client-side packages for the Sana Commerce web application using npm.

```bash
npm install
```

--------------------------------

### Sana Commerce Developer Documentation Navigation

Source: https://developer.sana-commerce.com/contracts/client-apps/hooks/webstore/use-load-effect

This snippet represents the navigation structure of the Sana Commerce developer documentation, highlighting key sections like Getting Started, Guides, References, Client App, React Hooks, and Webstore.

```html
<nav>
  <ul>
    <li><a href="/getting-started/index.html">Getting Started</a></li>
    <li><a href="/guides/integrate/index.html">Guides</a></li>
    <li><a href="/contracts/index.html">References</a></li>
    <li>
      Client App
      <ul>
        <li>React Hooks</li>
        <li>Webstore</li>
        <li><a href="/contracts/client-apps/hooks/webstore/use-load-effect.html">LoadEffect</a></li>
      </ul>
    </li>
  </ul>
</nav>
```

--------------------------------

### Webstore Entry Point Example - Sana Commerce Add-on

Source: https://developer.sana-commerce.com/contracts/client-apps/bundles

An example of an add-on's entry JavaScript module for Sana Commerce. It demonstrates exporting reducers, epics, content blocks, checkout item line comment components, and template field components.

```javascript
import reducer from './behavior/reducer';
import epic from './behavior/epic';
import SomeContentBlock from './components/SomeContentBlock';
import SomeCheckoutItemLineCommentEditor from './components/SomeCheckoutItemLineCommentEditor';
import SomeCheckoutItemLineCommentDisplay from './components/SomeCheckoutItemLineCommentDisplay';
import SomeTemplateFieldEditor from './components/SomeTemplateFieldEditor';
import SomeTemplateFieldDisplay from './components/SomeTemplateFieldDisplay';

const checkoutItemLineComment = {
    editor: SomeCheckoutItemLineCommentEditor,
    display: SomeCheckoutItemLineCommentDisplay,
}

export { reducer, epic, checkoutItemLineComment };

export const contentBlocks = {
    MyContentBlock: SomeContentBlock,
};

export const templateFields = {
    MyTemplateFieldEditor : { editor: SomeTemplateFieldEditor },
    MyTemplateFieldDisplay : { display: SomeTemplateFieldDisplay },
};

```

--------------------------------

### Sana Commerce Integration Guides

Source: https://developer.sana-commerce.com/guides/configurations-guides/managing-multiple-nodejs-installations

A collection of guides for integrating various functionalities into Sana Commerce, including address management, shopping basket customization, and ERP communication.

```en
https://developer.sana-commerce.com/guides/integrate/index.html
```

--------------------------------

### Create Client-Side Entry Point (JavaScript)

Source: https://developer.sana-commerce.com/getting-started/developing-an-addon/simple-cb-tutorial

The entry point for the client-side JavaScript. This file typically bootstraps the React application and mounts it to the DOM.

```JavaScript
import React from 'react';
import ReactDOM from 'react-dom/client';
import SimpleContentBlock from './components/SimpleContentBlock';

// Assuming you have a div with id='content-block-root' in your HTML
const contentBlockElement = document.getElementById('content-block-root');

if (contentBlockElement) {
  const root = ReactDOM.createRoot(contentBlockElement);
  
  // Example props, these would typically come from the backend or a data source
  const blockData = {
    title: 'My Awesome Content Block',
    description: 'This is a description for my content block.'
  };

  root.render(
    <React.StrictMode>
      <SimpleContentBlock {...blockData} />
    </React.StrictMode>
  );
}

```

--------------------------------

### Forcing Basket Recalculation

Source: https://developer.sana-commerce.com/guides/customize/advanced-components/content-block

Guide on how to force a recalculation of the shopping basket in Sana Commerce, for example, after adding comments.

```APIDOC
Basket Recalculation:
  Purpose: Triggers an update of the basket totals (subtotal, taxes, shipping) after changes like adding item comments or applying discounts.
  Triggering Recalculation:
    - Client-side: Call a basket update function after modifying item data.
    - Server-side: The system may automatically trigger recalculation upon certain events, or an API call can be made.
  API Method (Conceptual):
    - `BasketService.recalculate(basketId: string): Promise<Basket>`:
      Initiates a recalculation of the specified basket.
      Parameters:
        - basketId: The unique identifier of the shopping basket.
      Returns: A promise resolving with the updated basket object.
  Usage Example:
    - After a user adds a comment to an item and saves it, trigger `BasketService.recalculate()` to ensure prices and totals are up-to-date.
  Dependencies: Access to the basket service or relevant API endpoints.
```

--------------------------------

### Developer Portal: ClientApp Bundles

Source: https://developer.sana-commerce.com/getting-started/introduction/release-notes

Link to the ClientApp Bundles documentation.

```APIDOC
Developer Portal Documentation:
  - ClientApp Bundles: https://developer.sana-commerce.com/contracts/client-apps/bundles.html
```

--------------------------------

### Managing Node.js Installations

Source: https://developer.sana-commerce.com/guides/configurations-guides/data-upgrades/content-block-to-configuration

Guidance on managing multiple Node.js installations for development and deployment.

```en
Guide for Installation:
- Managing multiple NodeJs installations
```

--------------------------------

### Basket Change Started Event Action Creator Example

Source: https://developer.sana-commerce.com/contracts/client-apps/events/basket-change-started

Demonstrates the usage of the `basketChangeStarted` action creator within a Redux Observable epic. This example shows how to dispatch `basketChangeStarted` before an API call and `basketChangeCompleted` based on the API response, managing basket import logic.

```javascript
import { ofType } from 'redux-observable';
import { BASKET_IMPORT, basketImportFailed, basketImported } from './actions';
import { basketImportMutation } from './queries';
import { switchMap, mergeMap, map, startWith } from 'rxjs/operators';
import { basketChangeStarted, basketChangeCompleted } from 'sana/events';

export const basketImportEpic = (action$, _, { api }) => action$.pipe(
  ofType(BASKET_IMPORT),
  switchMap(action => api.graphApi(basketImportMutation, action.payload).pipe(
    map(({ basket }) => basket && basket.import),
    mergeMap(result => {
      if (result && !result.rejectedLines.length)
        return of(basketImported(), basketChangeCompleted(action.payload.length));

      return of(
        basketImportFailed(result && result.rejectedLines),
        basketChangeCompleted(0),
      );
    }),
    startWith(basketChangeStarted()),
  ),
);
```

--------------------------------

### Create Connection Interceptor

Source: https://developer.sana-commerce.com/guides/integrate/erp/create-content-element-with-online-erp-communication

Guide on creating connection interceptors for ERP integration in Sana Commerce. Covers the setup and listing of interceptors.

```en
https://developer.sana-commerce.com/guides/integrate/erp/index.html
```

```en
https://developer.sana-commerce.com/guides/integrate/erp/create-connection-interceptor-listing.html
```

--------------------------------

### Create Connection Interceptor for ERP

Source: https://developer.sana-commerce.com/guides/integrate/payment/psp/codebase

Guide on creating a connection interceptor for online ERP communication in Sana Commerce. Covers the setup and implementation.

```en
https://developer.sana-commerce.com/guides/integrate/erp/index.html
```

--------------------------------

### New Address Autocomplete Extension

Source: https://developer.sana-commerce.com/guides/integrate/erp/create-content-element-with-online-erp-communication

Guide on creating and implementing a new address autocomplete extension for Sana Commerce. Details the setup and functionality.

```en
https://developer.sana-commerce.com/guides/integrate/address-autocomplete/index.html
```

--------------------------------

### Sana Commerce Customization Guides

Source: https://developer.sana-commerce.com/guides/configurations-guides/managing-multiple-nodejs-installations

Guides for customizing various aspects of Sana Commerce, including the admin panel, advanced components, custom endpoints, system pages, and webstore forms.

```APIDOC
Customize Sana Admin Menu:
  - Modify the navigation menu in the Sana Admin panel.

Add New Sana Commerce Settings:
  - Introduce new configuration settings in the Admin panel.

Content Block:
  - Implement and manage content blocks within the webstore.

Navigation Search:
  - Customize the search functionality in the webstore navigation.

Sales Orders Map:
  - Integrate a map view for sales orders.

Product Wizard:
  - Develop a wizard for product configuration or selection.

Web store Endpoint:
  - Create custom endpoints for the webstore API.

Admin Endpoint:
  - Create custom endpoints for the admin API.

Custom System Page:
  - Develop custom system pages within Sana Commerce.

Track Field Value Change:
  - Implement logic to track changes in webstore form field values.
```

--------------------------------

### Sana Commerce Payment Integration Guides

Source: https://developer.sana-commerce.com/guides/configurations-guides/managing-multiple-nodejs-installations

Guides for integrating new payment service providers (PSPs) into Sana Commerce. Covers setting payment methods, adding extra checkout steps, syncing payment status, storing sensitive data, and collecting additional customer information.

```APIDOC
Payment Method Settings:
  - Configure payment methods for new PSPs.

Extra Checkout Step:
  - Add custom steps to the checkout process.

Sync Payment Status:
  - Implement logic to synchronize payment status between Sana Commerce and the PSP.

Store Sensitive Data:
  - Guidelines for securely storing sensitive payment information.

Collecting Additional Information:
  - Define models for collecting extra customer data during checkout.
```

--------------------------------

### New Address Autocomplete Extension

Source: https://developer.sana-commerce.com/guides/integrate/payment/psp/execution-flow

Guide on creating a new extension for address autocomplete functionality in Sana Commerce. Covers setup and implementation details.

```en
https://developer.sana-commerce.com/guides/integrate/address-autocomplete/index.html
```

--------------------------------

### New Address Autocomplete Extension

Source: https://developer.sana-commerce.com/guides/integrate/payment/psp/index

Guide for developing a new extension that provides address autocomplete functionality in Sana Commerce. Covers setup and implementation.

```en
https://developer.sana-commerce.com/guides/integrate/address-autocomplete/index.html
```

--------------------------------

### Create Connection Interceptor for ERP

Source: https://developer.sana-commerce.com/guides/integrate/payment/psp/index

Guide on creating a connection interceptor for online ERP communication in Sana Commerce. Covers the setup and purpose of interceptors.

```en
https://developer.sana-commerce.com/guides/integrate/erp/index.html
```

--------------------------------

### Create Connection Interceptor for ERP

Source: https://developer.sana-commerce.com/guides/integrate/erp/index

Guide on creating a connection interceptor for ERP systems in Sana Commerce. Covers the setup and functionality of ERP integration.

```en
https://developer.sana-commerce.com/guides/integrate/erp/index.html
```

--------------------------------

### Create Connection Interceptor for ERP

Source: https://developer.sana-commerce.com/guides/integrate/erp/create-connection-interceptor-listing

Guide on creating a connection interceptor for ERP systems in Sana Commerce. Covers the setup and functionality of ERP integration.

```en
https://developer.sana-commerce.com/guides/integrate/erp/index.html
```

--------------------------------

### Managing Node.js Installations

Source: https://developer.sana-commerce.com/guides/configurations-guides/data-upgrades/key-value-data-records

Guidance on managing multiple Node.js installations for development and deployment.

```en
Guide for Installation:
- Managing multiple NodeJs installations
```

--------------------------------

### Create Connection Interceptor for ERP

Source: https://developer.sana-commerce.com/guides/configurations-guides/uploading-files

Guide on creating a connection interceptor for ERP systems in Sana Commerce. Covers the setup and functionality of ERP communication.

```en
https://developer.sana-commerce.com/guides/integrate/erp/index.html
```

--------------------------------

### Managing Node.js Installations

Source: https://developer.sana-commerce.com/guides/configurations-guides/data-upgrades/configuration

Guidance on managing multiple Node.js installations for development and deployment.

```en
Guide for Installation:
- Managing multiple NodeJs installations
```

--------------------------------

### Managing Node.js Installations

Source: https://developer.sana-commerce.com/guides/configurations-guides/data-upgrades/content-block

Guidance on managing multiple Node.js installations for development and deployment.

```en
Guide for Installation:
- Managing multiple NodeJs installations
```

--------------------------------

### New Shipping Provider Integration

Source: https://developer.sana-commerce.com/guides/integrate/shipping/index

Comprehensive guide on how to integrate a new shipping provider with Sana Commerce. Covers the necessary steps, configurations, and code examples.

```en
https://developer.sana-commerce.com/guides/integrate/shipping/index.html
```

--------------------------------

### Implementing a New Payment Service Provider

Source: https://developer.sana-commerce.com/guides/integrate/payment/psp/codebase

A guide on how to implement a new Payment Service Provider (PSP) in Sana Commerce. Covers the initial setup and configuration.

```en
https://developer.sana-commerce.com/guides/integrate/payment/new-psp/index.html
```

--------------------------------

### Sana Commerce Shipping Integration Guides

Source: https://developer.sana-commerce.com/guides/integrate/product/create-product-update-extension

Guides for integrating shipping providers and configuring shipping-related features in Sana Commerce. Covers adding new providers, setting up method-specific settings, and managing pickup locations.

```APIDOC
New Shipping Provider:
  Description: Integrate a new shipping provider into Sana Commerce.
  URL: https://developer.sana-commerce.com/guides/integrate/shipping/index.html

Settings Per Shipping Method:
  Description: Configure specific settings for different shipping methods.
  URL: https://developer.sana-commerce.com/guides/integrate/shipping/shipping-method-settings.html

Pickup Locations:
  Description: Implement pickup location functionality for shipping extensions.
  URL: https://developer.sana-commerce.com/guides/integrate/shipping/pickup-locations-for-shipping-extension.html
```

--------------------------------

### Package Sana Add-on using .NET Core CLI

Source: https://developer.sana-commerce.com/getting-started/deploying-an-addon/packaging

This command publishes your add-on project to a specified directory, assembling it into a redistributable package. Ensure your current working directory is the SDK solution root. The output will be a .sanapkg file.

```dotnet
dotnet publish ".\Addons\Sana.Extensions.CustomHeadingContentBlock" -c Release -o ".\publish"
```

--------------------------------

### Implementing a New Payment Service Provider in Sana Commerce

Source: https://developer.sana-commerce.com/guides/integrate/payment/new-psp/payment-extra-checkout-step

A guide to implementing a new Payment Service Provider, covering the initial setup and integration steps.

```en
https://developer.sana-commerce.com/guides/integrate/payment/new-psp/index.html
```

--------------------------------

### Email Marketing Integration

Source: https://developer.sana-commerce.com/guides/customize/custom-system-page/index

This guide details how to integrate email marketing services and features within Sana Commerce. It covers the setup and usage for marketing campaigns.

```en
https://developer.sana-commerce.com/guides/integrate/email/email-marketing.html
```