Skip to content

Togo Lome Market Setup Data

Location: Lome Metro Area, Togo
Currency: XOF (West African CFA franc)
Market Launch: Q1 2025
Status: Configuration Complete - Pending Commercial Team Pricing Input

Overview

This document details the complete service configuration for the Togo Lome market launch, including 4 service plan templates across 2 subscription durations (7-day and 30-day) and 2 service tiers (Bare-bone and Lux All-Inclusive).

Setup Data Location: docs/models/bss/setup-data/Togo_Lome/

Service Architecture

Core Services (4 Total)

All service plans in the Togo market include access to the following 4 services:

  1. Swap Network Access (service-swap-network-togo-lome)
  2. Type: Fleet Access
  3. Coverage: Lome Metropolitan Area
  4. Service Hours: 24/7

  5. Quota Type: Boolean (enabled/disabled)

  6. Battery Fleet Access (service-battery-fleet-togo-lome)

  7. Type: Fleet Access
  8. Battery Types: Standard 48V, Standard 60V
  9. Quality Tier: Standard

  10. Quota Type: Boolean (enabled/disabled)

  11. Electricity Service (service-electricity-togo)

  12. Type: Consumption-based
  13. Unit of Measure: kWh (kilowatt-hours)
  14. Metering: Real-time tracking enabled

  15. Quota Type: Numeric (kWh allocation)

  16. Swap-Count Service (service-swap-count-togo)

  17. Type: Transaction-based
  18. Unit of Measure: Number of swaps
  19. Quota Type: Numeric (swap count allocation)

Service Bundles

Bundle Comparison Table

Bundle ID Name Duration Tier Swap Network Battery Fleet Electricity Quota Swap-Count Quota Business Model
bundle-togo-7day-barebone 7-Day Bare-bone 7 days Bare-bone ✅ Enabled ✅ Enabled 0 kWh 0 swaps Access + Pay-per-use
bundle-togo-7day-lux 7-Day Lux All-Inclusive 7 days Lux ✅ Enabled ✅ Enabled 70 kWh (10/day) 21 swaps (3/day) All-inclusive
bundle-togo-30day-barebone 30-Day Bare-bone 30 days Bare-bone ✅ Enabled ✅ Enabled 0 kWh 0 swaps Access + Pay-per-use
bundle-togo-30day-lux 30-Day Lux All-Inclusive 30 days Lux ✅ Enabled ✅ Enabled 300 kWh (10/day) 90 swaps (3/day) All-inclusive

Key Insights:

  • ✅ All bundles include all 4 services - difference is in quota allocation
  • 📊 Bare-bone tier: Zero quota = customers pay per use for consumption
  • 💎 Lux tier: Generous quota covering expected usage (10 kWh/day, 3 swaps/day)
  • 📅 Duration scaling: Monthly quotas are 4.3× weekly quotas (30/7 ratio)
  • 🔒 Network access: Always enabled for all tiers (boolean service, not quota-based)

Service Plan Templates

1. 7-Day Bare-bone Template

Template ID: template-togo-lome-7day-barebone-v1
File: bss-lome-7day-barebone-v1.json

Quota Configuration: - Swap Network Access: ✅ Enabled (1.0) - Battery Fleet Access: ✅ Enabled (1.0) - Electricity Service: 0 kWh (pay-per-use) - Swap-Count Service: 0 swaps (pay-per-use)

Business Model: Network access subscription with pay-per-use consumption pricing.

2. 7-Day Lux All-Inclusive Template

Template ID: template-togo-lome-7day-lux-v1
File: bss-lome-7day-lux-v1.json

Quota Configuration: - Swap Network Access: ✅ Enabled (1.0) - Battery Fleet Access: ✅ Enabled (1.0) - Electricity Service: 70 kWh (10 kWh/day × 7 days) - Swap-Count Service: 21 swaps (3 swaps/day × 7 days)

Rate Limits: - Electricity: 10 kWh per day - Swaps: 3 swaps per day

Business Model: All-inclusive subscription covering expected weekly usage.

3. 30-Day Bare-bone Template

Template ID: template-togo-lome-30day-barebone-v1
File: bss-lome-30day-barebone-v1.json

Quota Configuration: - Swap Network Access: ✅ Enabled (1.0) - Battery Fleet Access: ✅ Enabled (1.0) - Electricity Service: 0 kWh (pay-per-use) - Swap-Count Service: 0 swaps (pay-per-use)

Business Model: Monthly network access subscription with pay-per-use consumption pricing.

4. 30-Day Lux All-Inclusive Template

Template ID: template-togo-lome-30day-lux-v1
File: bss-lome-30day-lux-v1.json

Quota Configuration: - Swap Network Access: ✅ Enabled (1.0) - Battery Fleet Access: ✅ Enabled (1.0) - Electricity Service: 300 kWh (10 kWh/day × 30 days) - Swap-Count Service: 90 swaps (3 swaps/day × 30 days)

Rate Limits: - Electricity: 10 kWh per day - Swaps: 3 swaps per day

Business Model: All-inclusive monthly subscription covering expected usage.

Quota Calculation Formula

Lux Tier Formula

Electricity Quota: 

Total kWh = 10 kWh/day × Duration (days)
- 7-day: 70 kWh
- 30-day: 300 kWh

Swap-Count Quota: 

Total Swaps = 3 swaps/day × Duration (days)
- 7-day: 21 swaps
- 30-day: 90 swaps

Bare-bone Tier

  • All quotas: 0 (zero allocation)
  • Pricing model: Pay-per-use for all consumption

Contract Terms

7-Day Terms (terms-togo-7day-standard): - Billing Cycle: Weekly - Cancellation Notice: 3 days - Refund Policy: Pro-rated within first 48 hours

30-Day Terms (terms-togo-30day-standard): - Billing Cycle: Monthly - Cancellation Notice: 7 days - Refund Policy: Pro-rated within first 7 days

Legal Jurisdiction: Lome Metro Area, Togo
Governing Law: Laws of Togo
Dispute Resolution: Arbitration in Lome, Togo under Togolese Arbitration Law

Pricing Status

Pending Commercial Team Input

All pricing fields are currently set to placeholder values (0.00) with comments marked "PENDING COMMERCIAL TEAM INPUT".

Required Pricing Decisions:

  • [ ] Monthly subscription fees (7-day and 30-day tiers)
  • [ ] Deposit amounts
  • [ ] Early termination fees
  • [ ] Overage rates for electricity (XOF per kWh)
  • [ ] Overage rates for swaps (XOF per swap)
  • [ ] Damage deposits (if applicable)
  • [ ] Liability limits confirmation

File Reference

All setup data files are located in: docs/models/bss/setup-data/Togo_Lome/

Core Configuration Files

File Purpose Records
bss-lome-services.json Service definitions 4 services
bss-lome-bundles.json Bundle configurations 4 bundles
bss-lome-common-terms.json Contract terms 2 term sets

Template Files

File Template Tier Duration
bss-lome-7day-barebone-v1.json 7-Day Bare-bone Bare-bone 7 days
bss-lome-7day-lux-v1.json 7-Day Lux Lux 7 days
bss-lome-30day-barebone-v1.json 30-Day Bare-bone Bare-bone 30 days
bss-lome-30day-lux-v1.json 30-Day Lux Lux 30 days

Technical Implementation

FSM References

All templates reference standard BSS FSM definitions: - Service Cycle FSM: fsm-bss-service-cycle - Payment Cycle FSM: fsm-bss-payment-cycle

Agent Configuration

All templates use standard BSS agent configuration: - Agent Config: agent-config-bss-standard

Schema Compliance

✅ All files follow ABS Platform schema requirements: - Uses _id suffix for foreign key references - Includes required country_code, legal_jurisdiction, billing_currency - Embeds service_configurations inline with templates - Includes change_log for version tracking - No deprecated fields (e.g., monthly_quota, currency in ServicePlan)

Usage Guide

For Product Team

  1. Review quota formulas and adjust if market research suggests different usage patterns
  2. Validate service tier definitions match market positioning strategy
  3. Coordinate with commercial team for pricing input

For Commercial Team

  1. Update all pricing placeholders marked "PENDING COMMERCIAL TEAM INPUT"
  2. Consider competitive pricing in Togo market
  3. Validate liability limits and insurance requirements
  4. Set deposit and termination fee policies

For Development Team

  1. Load setup data using GraphQL mutations (see Setup Data Guide)
  2. Validate FSM references exist in system
  3. Test template instantiation with test customer accounts
  4. Verify quota calculations in service plan instances

Next Steps

  • [ ] Commercial team pricing review
  • [ ] Legal team contract terms validation
  • [ ] Operations team readiness assessment
  • [ ] System integration testing
  • [ ] Pilot customer onboarding plan
  • [ ] Launch date confirmation

Verbal Input Template

Use this template to request new setup data configurations. Fill in the blanks and provide to the development team.

SETUP DATA REQUEST

1. LOCATION & CURRENCY
   - Country: _______________
   - City/Region: _______________
   - Local Currency (ISO code): _______________

2. SUBSCRIPTION VARIANTS
   - Duration options: [ ] Weekly (7 days)  [ ] Monthly (30 days)  [ ] Other: _______________
   - Service tiers: [ ] Bare-bone  [ ] Lux  [ ] Other: _______________
   - Total variants (duration × tier): _______________

3. SERVICES (List all services to include)
   Service 1:
   - Name: _______________
   - Type: [ ] Fleet Access  [ ] Consumption  [ ] Transaction Count
   - Unit of measure: _______________
   - Description: _______________

   Service 2:
   - Name: _______________
   - Type: [ ] Fleet Access  [ ] Consumption  [ ] Transaction Count
   - Unit of measure: _______________
   - Description: _______________

   Service 3:
   - Name: _______________
   - Type: [ ] Fleet Access  [ ] Consumption  [ ] Transaction Count
   - Unit of measure: _______________
   - Description: _______________

   Service 4:
   - Name: _______________
   - Type: [ ] Fleet Access  [ ] Consumption  [ ] Transaction Count
   - Unit of measure: _______________
   - Description: _______________

4. BUNDLES (One bundle per subscription variant)
   Bundle 1:
   - Name: _______________
   - Duration: _______________
   - Tier: _______________
   - Included services: [ ] All services  [ ] Custom selection: _______________

   Bundle 2:
   - Name: _______________
   - Duration: _______________
   - Tier: _______________
   - Included services: [ ] All services  [ ] Custom selection: _______________

5. QUOTA FORMULAS
   For consumption/transaction services:

   Bare-bone tier:
   - Quota allocation: [ ] Zero (pay-per-use)  [ ] Limited: _______________

   Lux/Premium tier:
   - Daily usage expectation for Service 1: _______________ per day
   - Daily usage expectation for Service 2: _______________ per day
   - Daily usage expectation for Service 3: _______________ per day
   - Daily usage expectation for Service 4: _______________ per day

   Calculation formula:
   - Total quota = Daily usage × Duration (days)
   - Example: _______________ per day × _______________ days = _______________ total

6. PRICING GUIDANCE (Optional - can be "PENDING")
   - Subscription fees: _______________
   - Deposit amounts: _______________
   - Overage rates: _______________
   - Early termination fees: _______________

7. CONTRACT TERMS
   - Cancellation notice period: _______________ days
   - Refund policy: _______________
   - Governing law: _______________
   - Dispute resolution: _______________

8. SPECIAL REQUIREMENTS
   - Rate limits: [ ] Yes  [ ] No
     If yes, specify: _______________
   - Auto-renewal: [ ] Yes  [ ] No
   - Overage allowed: [ ] Yes  [ ] No
   - Other requirements: _______________

Example: Togo Lome Request (Completed Template)

SETUP DATA REQUEST

1. LOCATION & CURRENCY
   - Country: Togo
   - City/Region: Lome metro area
   - Local Currency (ISO code): XOF

2. SUBSCRIPTION VARIANTS
   - Duration options: [✓] Weekly (7 days)  [✓] Monthly (30 days)
   - Service tiers: [✓] Bare-bone  [✓] Lux
   - Total variants (duration × tier): 4 variants

3. SERVICES
   Service 1:
   - Name: Swap Network Access
   - Type: [✓] Fleet Access
   - Unit of measure: boolean
   - Description: Access to swap network fleet in Lome metro area

   Service 2:
   - Name: Battery Fleet Access
   - Type: [✓] Fleet Access
   - Unit of measure: boolean
   - Description: Access to battery inventory pool

   Service 3:
   - Name: Electricity Service
   - Type: [✓] Consumption
   - Unit of measure: kWh
   - Description: Battery electricity quota allocation

   Service 4:
   - Name: Swap-Count Service
   - Type: [✓] Transaction Count
   - Unit of measure: swaps
   - Description: Battery swap transaction quota

4. BUNDLES
   Bundle 1:
   - Name: 7-Day Bare-bone
   - Duration: 7 days
   - Tier: Bare-bone
   - Included services: [✓] All services

   Bundle 2:
   - Name: 7-Day Lux
   - Duration: 7 days
   - Tier: Lux
   - Included services: [✓] All services

   Bundle 3:
   - Name: 30-Day Bare-bone
   - Duration: 30 days
   - Tier: Bare-bone
   - Included services: [✓] All services

   Bundle 4:
   - Name: 30-Day Lux
   - Duration: 30 days
   - Tier: Lux
   - Included services: [✓] All services

5. QUOTA FORMULAS
   Bare-bone tier:
   - Quota allocation: [✓] Zero (pay-per-use)

   Lux tier:
   - Daily usage expectation for Electricity: 10 kWh per day
   - Daily usage expectation for Swap-Count: 3 swaps per day

   Calculation formula:
   - Electricity: 10 kWh/day × 7 days = 70 kWh (weekly) | 10 kWh/day × 30 days = 300 kWh (monthly)
   - Swaps: 3 swaps/day × 7 days = 21 swaps (weekly) | 3 swaps/day × 30 days = 90 swaps (monthly)

6. PRICING GUIDANCE
   - All pricing: PENDING COMMERCIAL TEAM INPUT

7. CONTRACT TERMS
   - Cancellation notice period: 3 days (weekly), 7 days (monthly)
   - Refund policy: Pro-rated within first 48 hours (weekly), 7 days (monthly)
   - Governing law: Laws of Togo
   - Dispute resolution: Arbitration in Lome, Togo

8. SPECIAL REQUIREMENTS
   - Rate limits: [✓] Yes - 10 kWh/day, 3 swaps/day for Lux tier
   - Auto-renewal: [✓] Yes for Lux tier, [ ] No for Bare-bone
   - Overage allowed: [✓] Yes