The framework provides comprehensive utility functions for common integration challenges.
Taxation Management
taxation.py - Manages tax category handling for integration transactions:
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:
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.