> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clearline.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction to Import

> Sync your product catalog, categories, and promotions with ClearLine

Import endpoints allow you to synchronize your POS product catalog, categories, and promotions with the ClearLine platform. This ensures that marketing campaigns, loyalty programs, and analytics have access to up-to-date product information.

## What Can You Import?

<CardGroup cols={3}>
  <Card title="Products" icon="box" href="/api-reference/import/import-products-to-the-system">
    Product items with pricing, SKUs, categories, and manufacturer details
  </Card>

  <Card title="Categories" icon="folder-tree" href="/api-reference/import/import-products-categories-to-the-system">
    Product category hierarchies and catalog organization
  </Card>

  <Card title="Promotions" icon="badge-percent" href="/api-reference/import/import-promotions-to-the-system">
    Active promotions and special offers from your POS system
  </Card>
</CardGroup>

## Why Import Data?

Keeping your product catalog synchronized with ClearLine enables:

* **Targeted Marketing:** Create promotions based on specific products, categories, or price ranges
* **Accurate Analytics:** Track product performance and sales trends with up-to-date data
* **Dynamic Loyalty:** Configure rewards based on product purchases and categories
* **Smart Promotions:** Display relevant offers based on purchased items

## Import Strategies

<Tabs>
  <Tab title="Full Sync">
    Send your entire product catalog in a single import. **Best for:** Initial setup, major catalog changes, scheduled daily/weekly jobs
  </Tab>

  <Tab title="Incremental Updates">
    Send only new or modified items since the last import. **Best for:** Real-time inventory updates, price changes, frequent small updates
  </Tab>

  <Tab title="Event-Driven">
    Import data when specific events occur in your POS system. **Best for:** New product launches, category changes, promotion activations
  </Tab>
</Tabs>

## Import Endpoints

<CardGroup cols={2}>
  <Card title="Import Products" icon="box" href="/api-reference/import/import-products-to-the-system">
    Sync product catalog with SKUs, prices, categories, and manufacturers
  </Card>

  <Card title="Import Product Categories" icon="folder-tree" href="/api-reference/import/import-products-categories-to-the-system">
    Sync category hierarchies and catalog organization structure
  </Card>

  <Card title="Import Promotions" icon="badge-percent" href="/api-reference/import/import-promotions-to-the-system">
    Sync active promotions and special offers from your POS
  </Card>

  <Card title="Authentication" icon="key" href="/api-reference/authentication/introduction">
    Learn how to authenticate for import operations
  </Card>
</CardGroup>

## Best Practices

<AccordionGroup>
  <Accordion title="Schedule Regular Syncs" defaultOpen icon="clock">
    * **Daily full sync** for most retailers (recommended during off-peak hours)
    * **Hourly incremental** for high-volume or frequently changing catalogs - **Real-time updates** for critical changes like new products or price updates
  </Accordion>

  <Accordion title="Validate Before Importing" icon="shield-check">
    * Ensure required fields are present and not empty - Verify prices are valid positive numbers - Check that category references exist - Confirm product IDs are unique
  </Accordion>

  <Accordion title="Handle Errors Gracefully" icon="triangle-exclamation">
    * Log all import responses (successes and failures) - Retry failed imports with exponential backoff - Don't stop entire sync for individual item errors
    * Alert your team for persistent failures
  </Accordion>

  <Accordion title="Maintain Data Consistency" icon="database">
    * Use the same product IDs across all imports - Import categories before products that reference them - Include all active items in full syncs - Don't delete and re-create items unnecessarily
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Start with Product Import" icon="box" href="/api-reference/import/import-products-to-the-system">
    View complete API specification and request examples
  </Card>

  <Card title="Complete Integration Guide" icon="book-open" href="/pos-integration/products-catalog-import-to-cmc">
    Step-by-step guide with implementation details
  </Card>
</CardGroup>