---
title: "Utilities"
space: "Integrations"
url: "https://integrations.frappe.cloud/integrations/ecommerce-integration/ecommerce-core/developer-documentation/utilities"
updated: "2026-09-10"
---

The framework provides comprehensive utility functions for common integration challenges.

#### Taxation Management

`taxation.py` - Manages tax category handling for integration transactions:

```python
DUMMY_TAX_CATEGORY = "Ecommerce Integrations - Ignore"

def get_dummy_tax_category() -> str:
    """Retrieves or creates tax category for tax-exempt integration transactions."""

def validate_tax_template(doc, method=None):
    """Prevents usage of dummy tax category in item tax templates."""
```

**Purpose:** Integrations often handle taxation at the platform level. This dummy category prevents ERPNext from applying additional tax templates to integration-generated transactions.

#### Price List Management

`price_list.py` - Manages price list isolation:

```python
DUMMY_PRICE_LIST = "Ecommerce Integrations - Ignore"

def get_dummy_price_list() -> str:
    """Retrieves or creates price list for integration transaction pricing."""

def discard_item_prices(doc, method=None):
    """Removes item prices added to dummy price list."""
```

**Purpose:** Platform-managed pricing requires isolation from ERPNext price lists. The dummy price list prevents manual price configuration from affecting integration transactions.

#### Address Mapping

`address_mapping.py` - Comprehensive address field transformation:

Provides mapping between platform address formats and ERPNext address doctypes, handling:

- International address formats
- Country/state code mapping
- Field name transformations
- Validation requirements

#### Naming Series

`naming_series.py` - Naming series generation utilities:

Generates unique identifiers for integration-generated documents following configured naming patterns.