Quick Reference for Setup
Last Updated: February 7, 2026
File: config.yaml (line 12)
package: fullhouse
Verification:
grep "^package:" config.yaml
# Expected output: package: fullhouse
Why required:
package.fullhouse directoryTable: remoteconnections
SELECT Username, RemotePassword, AccessToken
FROM remoteconnections
WHERE RemoteType = 'SHOPIFY';
Required fields:
Username: Shopify store domain (e.g., fullhouse-co-za.myshopify.com)RemotePassword: Legacy password (optional)AccessToken: Shopify Admin API access token (GraphQL 2026-01)Table: def_parameter
SELECT Value FROM def_parameter
WHERE Parameter = 'dry_run_mode' AND Block = 'SHOPIFY';
Values:
1 = Enabled (save to verification table, don't update Shopify)0 = Disabled (normal operation, update Shopify)To enable:
INSERT INTO def_parameter (Parameter, Block, Value, Description)
VALUES (
'dry_run_mode',
'SHOPIFY',
'1',
'Enable dry-run mode - save to verification table instead of Shopify'
)
ON DUPLICATE KEY UPDATE Value = '1';
To disable:
UPDATE def_parameter SET Value = '0'
WHERE Parameter = 'dry_run_mode' AND Block = 'SHOPIFY';
Table: def_parameter
SELECT Value FROM def_parameter
WHERE Parameter = 'cache_max_age_hours' AND Block = 'SHOPIFY';
Default: 24 hours
To change:
INSERT INTO def_parameter (Parameter, Block, Value, Description)
VALUES (
'cache_max_age_hours',
'SHOPIFY',
'48',
'Maximum age of cached product data in hours'
)
ON DUPLICATE KEY UPDATE Value = '48';
Before running Shopify integration:
#!/usr/bin/env python3
import sys
sys.path.append('factory.core')
import Objects
import ObjData
# Check 1: Package
ini = Objects.global_config
package = ini.Get('', 'package')
print(f"1. Package: {package}")
if package == 'fullhouse':
print(" ✅ Correct")
else:
print(f" ❌ Wrong - should be 'fullhouse'")
print()
# Check 2: Shopify credentials
db = ObjData.ObjData()
sql = """
SELECT Username, AccessToken
FROM remoteconnections
WHERE RemoteType = 'SHOPIFY'
"""
result = db.query_get_values(sql)
if result:
print(f"2. Shopify Credentials")
print(f" Store: {result[0]}")
print(f" Token: {'Present' if result[1] else 'Missing'}")
if result[1]:
print(" ✅ Configured")
else:
print(" ❌ AccessToken missing")
else:
print("2. Shopify Credentials")
print(" ❌ No credentials found")
print()
# Check 3: Dry-run mode
sql = """
SELECT Value FROM def_parameter
WHERE Parameter = 'dry_run_mode' AND Block = 'SHOPIFY'
"""
dry_run = db.query_get_value(sql)
print(f"3. Dry-run Mode: {dry_run if dry_run else 'Not set (default: disabled)'}")
if dry_run == '1':
print(" ℹ️ ENABLED - will save to verification table")
else:
print(" ℹ️ DISABLED - will update Shopify")
print()
# Check 4: Cache setting
sql = """
SELECT Value FROM def_parameter
WHERE Parameter = 'cache_max_age_hours' AND Block = 'SHOPIFY'
"""
cache_age = db.query_get_value(sql)
print(f"4. Cache Max Age: {cache_age if cache_age else '24'} hours (default: 24)")
print()
print("=" * 60)
if package == 'fullhouse' and result and result[1]:
print("✅ READY TO RUN")
else:
print("❌ CONFIGURATION INCOMPLETE")
print("\nRequired fixes:")
if package != 'fullhouse':
print(" - Set package to 'fullhouse' in config.yaml")
if not result or not result[1]:
print(" - Add Shopify AccessToken to remoteconnections table")
Save as check_config.py and run:
python check_config.py
Cause: No Shopify credentials in remoteconnections table
Fix:
INSERT INTO remoteconnections (
RemoteType,
Username,
RemotePassword,
AccessToken
) VALUES (
'SHOPIFY',
'your-store.myshopify.com',
'',
'shpat_your_access_token_here'
);
Cause: Package not set to fullhouse
Fix:
# Edit config.yaml line 12
sed -i 's/^package:.*/package: fullhouse/' config.yaml
Check:
SELECT Value FROM def_parameter
WHERE Parameter = 'dry_run_mode' AND Block = 'SHOPIFY';
Disable:
UPDATE def_parameter SET Value = '0'
WHERE Parameter = 'dry_run_mode' AND Block = 'SHOPIFY';
Instead of config.yaml, you can use environment variable:
export AXION_PACKAGE=fullhouse
This takes priority over config.yaml setting.
Verify:
import os
import Objects
# Check environment variable
env_package = os.getenv('AXION_PACKAGE')
print(f"ENV: {env_package}")
# Check loaded package
ini = Objects.global_config
loaded_package = ini.Get('', 'package')
print(f"Loaded: {loaded_package}")
Minimum required configuration:
config.yaml → package: fullhouseremoteconnections → Shopify credentials with AccessTokenOptional configuration:
def_parameter → dry_run_mode (for testing)def_parameter → cache_max_age_hours (for performance tuning)Document Version: 1.0
Date: February 7, 2026
Status: Complete