Documentation Index
Fetch the complete documentation index at: https://docs.surebright.com/llms.txt
Use this file to discover all available pages before exploring further.
General Integration Questions
What SFCC permissions does SureBright need?
What SFCC permissions does SureBright need?
SureBright requires specific OAuth scopes for full integration functionality:Required Scopes:
sfcc.catalogs.rw- Read/Write access to product catalogssfcc.products.rw- Read/Write access to product datasfcc.orders.rw- Read/Write access to order informationsfcc.custom-objects.rw- Read/Write access to custom objectssfcc.jobs.rw- Read/Write access to job management
- Administrator (for cartridge deployment and configuration)
- API User (for programmatic access)
- Job Manager (for import/export operations)
Will the SureBright cartridge conflict with my existing cartridges?
Will the SureBright cartridge conflict with my existing cartridges?
The SureBright cartridge is designed to be compatible with most SFCC setups, but we take precautions:Compatibility Measures:
- Cartridge is tested with common SFCC cartridges
- Proper cartridge priority configuration prevents conflicts
- Namespaced code prevents function and variable conflicts
- Modular design allows selective feature activation
- SureBright will adjust cartridge priority settings
- We can modify specific functions if needed
- Alternative deployment methods are available
- Your existing functionality remains unaffected
How do I find my Organization ID, Realm, and Short Code in SFCC?
How do I find my Organization ID, Realm, and Short Code in SFCC?
These values are located in different parts of your SFCC Business Manager:Organization ID:
- Go to
Administration → Organization → Organization Settings - Look for “Organization ID” field
- Found in your SFCC instance URL:
https://[realm].demandware.net - Also visible in
Administration → Organization → Organization Settings
- Go to
Administration → Sites → [Your Site] → Settings - Look for “Site ID” or “Short Code” field
- Usually matches your site’s identifier
Technical Setup Questions
What if I don't have access to create API clients in Account Manager?
What if I don't have access to create API clients in Account Manager?
You’ll need to request access from your SFCC administrator or use the Full Business Manager Access approach:Required Permissions:
- Account Manager access with API client creation rights
- User management permissions for creating SureBright user account
- Business Manager administrative access
- Request temporary elevated permissions for integration setup
- Use the Full Business Manager Access approach instead
- Have your SFCC administrator create the API client and share credentials
- Contact Salesforce support for permission escalation if needed
How do I verify my inventory list and pricebook are properly assigned?
How do I verify my inventory list and pricebook are properly assigned?
Follow these steps in your SFCC Business Manager:Check Inventory List Assignment:
- Go to
Merchant Tools → Inventory → Inventory Lists - Select your inventory list
- Check “Sites” tab to ensure your site is assigned
- Note the Inventory List ID for sharing with SureBright
- Go to
Merchant Tools → Pricing → Price Books - Select your pricebook
- Check “Sites” tab to ensure your site is assigned
- Note the Pricebook ID for sharing with SureBright
- Go to
Administration → Sites → [Your Site] → Settings - Confirm inventory list and pricebook are properly configured
- Check that the site is active and properly set up
What SFCC version is required for the integration?
What SFCC version is required for the integration?
The SureBright integration is compatible with SFCC versions that support SFRA (Storefront Reference Architecture).Minimum Requirements:
- SFCC version 20.1 or later
- SFRA-based storefront
- Business Manager administrative access
- Latest SFCC version for optimal performance
- Sandbox environment for testing before production deployment
How are Surebright products created in my SFCC catalog?
How are Surebright products created in my SFCC catalog?
SureBright creates warranty products using SFCC’s standard product creation process:Product Creation Process:
- Surebright products are created as regular SFCC products
- They’re assigned to a dedicated warranty category
- Custom attributes define warranty plan types and coverage
- Products are linked to your main products via relationships
- SKUs follow a consistent naming convention
- Pricing is dynamically calculated based on product value
- Inventory is managed through your existing inventory system
- Products are automatically assigned to your site’s catalog
- You can modify warranty product descriptions
- Product availability can be controlled via inventory lists
- Warranty products integrate with your existing product management workflow
How often does product data sync between SFCC and SureBright?
How often does product data sync between SFCC and SureBright?
Product data synchronization follows this schedule:Product Export Job:
- Runs daily (recommended)
- Can be configured for different frequencies
- Exports all merchandisable products
- Updates product information in SureBright system
- Real-time processing (every 15-30 minutes)
- Immediate order data transfer
- Contract creation processing
- Status updates and tracking
- Available for immediate updates
- Useful for testing and troubleshooting
- Can be triggered from Business Manager
Storefront Display Questions
What should I do if warranty products don't appear on my storefront?
What should I do if warranty products don't appear on my storefront?
This is usually a cartridge priority or configuration issue. Follow these steps:Immediate Checks:
- Verify Cartridge Priority: Ensure SureBright cartridge has proper priority in Business Manager
- Check Site Assignment: Confirm warranty products are assigned to your site
- Review Product Status: Ensure warranty products are active and available
- Check Inventory: Verify inventory levels are sufficient
- Go to
Administration → Sites → [Your Site] → Cartridges - Check that SureBright cartridge is listed and active
- Verify cartridge priority is set correctly
- Check for any error messages or conflicts
- Contact SureBright support with specific error details
- Provide screenshots of Business Manager configuration
- Share any error logs from your SFCC instance
- Test in a different browser or incognito mode
Still Have Questions?
If you don’t see your question answered here, we’re here to help:Contact Support
Contact Your Representative
Direct SupportContact your assigned SureBright representative for immediate assistance.For urgent issues and business questions