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

# Reserved namespaces

# Reserved Namespaces

## Integration Namespaces

When working with integrations in CONA, use the appropriate namespace prefix for consistency and clarity.

| Integration   | Namespace Prefix | Example Usage                                       |
| ------------- | ---------------- | --------------------------------------------------- |
| CONA          | `cona_`          | `cona_invoice_id`, `cona_customer_tags`             |
| Shopify       | `shopify_`       | `shopify_order_id`, `shopify_customer_tags`         |
| PayPal        | `paypal_`        | `paypal_transaction_id`, `paypal_payer_email`       |
| Amazon        | `amazon_`        | `amazon_order_id`, `amazon_customer_tags`           |
| DATEV         | `datev_`         | `datev_invoice_id`, `datev_customer_tags`           |
| Ebay          | `ebay_`          | `ebay_order_id`, `ebay_customer_tags`               |
| SAP           | `sap_`           | `sap_invoice_id`, `sap_customer_tags`               |
| Quickbooks    | `qb_`            | `qb_invoice_id`, `qb_customer_tags`                 |
| Stripe        | `stripe_`        | `stripe_customer_id`, `stripe_payment_intent`       |
| Xero          | `xero_`          | `xero_contact_id`, `xero_invoice_number`            |
| Square        | `square_`        | `square_payment_id`, `square_location_id`           |
| Navision      | `navision_`      | `navision_invoice_id`, `navision_customer_tags`     |
| NetSuite      | `netsuite_`      | `netsuite_invoice_id`, `netsuite_customer_tags`     |
| Sage          | `sage_`          | `sage_invoice_id`, `sage_customer_tags`             |
| Zoho          | `zoho_`          | `zoho_invoice_id`, `zoho_customer_tags`             |
| BigCommerce   | `bigcommerce_`   | `bigcommerce_order_id`, `bigcommerce_customer_tags` |
| Magento       | `magento_`       | `magento_order_id`, `magento_customer_tags`         |
| WooCommerce   | `woo_`           | `woo_order_id`, `woo_customer_tags`                 |
| PrestaShop    | `presta_`        | `presta_order_id`, `presta_customer_tags`           |
| OpenCart      | `opencart_`      | `opencart_order_id`, `opencart_customer_id`         |
| Shopware      | `shopware_`      | `shopware_order_id`, `shopware_customer_number`     |
| Klarna        | `klarna_`        | `klarna_order_id`, `klarna_payment_reference`       |
| PayPalPlus    | `paypalplus_`    | `paypalplus_transaction_id`, `paypalplus_status`    |
| Adyen         | `adyen_`         | `adyen_payment_id`, `adyen_merchant_reference`      |
| Mollie        | `mollie_`        | `mollie_payment_id`, `mollie_customer_id`           |
| Worldpay      | `worldpay_`      | `worldpay_order_id`, `worldpay_transaction_id`      |
| Braintree     | `braintree_`     | `braintree_transaction_id`, `braintree_customer_id` |
| SumUp         | `sumup_`         | `sumup_transaction_id`, `sumup_payment_type`        |
| iZettle       | `izettle_`       | `izettle_order_id`, `izettle_payment_reference`     |
| Authorize.net | `authnet_`       | `authnet_transaction_id`, `authnet_customer_id`     |
| 2Checkout     | `2checkout_`     | `2checkout_sale_id`, `2checkout_payment_method`     |
| Afterpay      | `afterpay_`      | `afterpay_order_id`, `afterpay_token`               |
| Sofort        | `sofort_`        | `sofort_transaction_id`, `sofort_status`            |
| Giropay       | `giropay_`       | `giropay_transaction_id`, `giropay_result`          |
| iDEAL         | `ideal_`         | `ideal_transaction_id`, `ideal_issuer`              |
| SEPA          | `sepa_`          | `sepa_mandate_id`, `sepa_creditor_id`               |
| Bancontact    | `bancontact_`    | `bancontact_payment_id`, `bancontact_status`        |
| Alipay        | `alipay_`        | `alipay_trade_no`, `alipay_buyer_id`                |
| WeChat Pay    | `wechat_`        | `wechat_transaction_id`, `wechat_openid`            |

## Tool Slugs

| Tool         | Slug           |
| ------------ | -------------- |
| AR Recon     | `ar-recon`     |
| DATEV Export | `datev-export` |

## Usage Guidelines

### When to Use Namespaces

1. **Database Field Names**: Always prefix custom fields with the appropriate integration namespace
2. **API Parameters**: Use namespaced keys when passing integration-specific data
3. **Configuration Keys**: Apply namespaces to settings and configuration values
4. **Event Names**: Prefix events with their source integration namespace

### Best Practices

* **Consistency**: Always use the exact namespace prefix as defined in the table
* **Lowercase**: Keep all namespace prefixes in lowercase
* **Underscore Separation**: Use underscores to separate the namespace from the field name
* **Descriptive Names**: Combine namespace with clear, descriptive field names

### Examples

```javascript theme={null}
// Database field names
const customer = {
  id: "cust_001",
  shopify_customer_id: "123456789",
  stripe_customer_id: "cus_ABC123DEF456",
  paypal_payer_email: "customer@example.com",
};

// Configuration keys
const integrationSettings = {
  shopify_webhook_secret: "whsec_...",
  stripe_publishable_key: "pk_...",
  paypal_client_id: "client_...",
};

// Event names
const events = ["shopify_order_created", "stripe_payment_succeeded", "paypal_payment_completed"];
```

### Adding New Namespaces

When adding support for a new integration:

1. **Research**: Check if the integration already has a commonly used namespace convention
2. **Consistency**: Choose a namespace that follows the existing pattern (lowercase, descriptive)
3. **Documentation**: Update this table with the new namespace
4. **Team Review**: Have the team review the proposed namespace before implementation

### Reserved Prefixes

The following prefixes are reserved for CONA internal use:

* `cona_` - Core CONA system fields and identifiers
* `temp_` - Temporary fields that may be cleaned up
* `system_` - System-generated fields and metadata
* `audit_` - Audit trail and versioning fields