EDI Test Generator - Final Configuration

Date: October 15, 2025
Status: Finalized based on business requirements

Summary

The EDI test order generator has been finalized to include only the partners needed for testing. This configuration balances comprehensive coverage with practical testing needs.

Partners Included (20 Total)

By Category

CommerceHub - 4 partners

  • commercehub_thd_us (Home Depot US)
  • commercehub_thd_ca (Home Depot Canada)
  • commercehub_lowes_ca (Lowe's Canada)
  • commercehub_costco_ca (Costco Canada)

Amazon Seller Central - 3 partners

  • amazon_seller_central_us (Amazon US)
  • amazon_seller_central_ca (Amazon Canada)
  • amazon_seller_central_fr (Amazon France) ← Newly Added

Wayfair - 2 partners

  • wayfair_us (Wayfair US)
  • wayfair_ca (Wayfair Canada)

MFT Gateway - 3 partners

  • mft_gateway_build_com (Build.com)
  • mft_gateway_canadian_tire (Canadian Tire)
  • mft_gateway_zoro_tools (Zoro Tools)

Mirakl Sellers (European) - 7 partners

  • leroymerlin_adeo (Leroy Merlin)
  • bricodepot_es (Bricodepot Spain)
  • bricodepot_pt (Bricodepot Portugal)
  • bricomarche (Bricomarche France)
  • castorama (Castorama France)
  • leclerc (E. Leclerc)
  • maxeda (Maxeda)

Houzz - 1 partner

  • houzz / houzz_us (Houzz)

Partners Excluded

Removed - Not Needed for Testing

Amazon Vendor Central (4 partners)

These are active in production but not needed for test order generation:

  • amazon_vc_seller_api_wasn4
  • amazon_vc_seller_api_wat4d
  • amazon_vc_seller_api_watof
  • amazon_vc_seller_api_wax7v

Reason: Amazon VC testing not required. These partners remain active in production.

Other European Amazon Seller Central (7 partners)

These are active in production but not configured in generator:

  • amazon_seller_central_be (Belgium)
  • amazon_seller_central_de (Germany)
  • amazon_seller_central_es (Spain)
  • amazon_seller_central_it (Italy)
  • amazon_seller_central_nl (Netherlands)
  • amazon_seller_central_pl (Poland)
  • amazon_seller_central_se (Sweden)

Reason: Amazon FR provides sufficient European market coverage for testing.

Archived - Inactive Partners

ChannelEngine (2 partners)

  • channel_engine_america
  • channel_engine_europe

Status: active: false in orchestrator, partnership discontinued.

Amazon Seller Central UK (1 partner)

  • amazon_seller_central_uk

Status: active: false in orchestrator, market discontinued.

Recent Changes (Oct 15, 2025)

Added

  • ✅ amazon_seller_central_fr - Amazon France (for European market testing)

Removed

  • ❌ amazon_vc_seller_api_wasn4 - Amazon VC (not needed for testing)
  • ❌ amazon_vc_seller_api_wat4d - Amazon VC (not needed for testing)
  • ❌ amazon_vc_seller_api_watof - Amazon VC (not needed for testing)
  • ❌ amazon_vc_seller_api_wax7v - Amazon VC (not needed for testing)

Updated

  • Partner count: 23 → 20 active partners
  • Documentation updated to reflect final configuration
  • generate_amazon_vc method commented out (not needed)

Usage Examples

Test Amazon France Order

bundle exec rake "edi:test_orders:generate[amazon_seller_central_fr,1]"

Test All Configured Partners

bundle exec rake "edi:test_orders:generate[all,1]"

Common Testing Scenarios

# Test key US partners
bundle exec rake "edi:test_orders:generate[commercehub_thd_us,1]"
bundle exec rake "edi:test_orders:generate[amazon_seller_central_us,1]"
bundle exec rake "edi:test_orders:generate[wayfair_us,1]"

# Test European partners
bundle exec rake "edi:test_orders:generate[amazon_seller_central_fr,1]"
bundle exec rake "edi:test_orders:generate[leroymerlin_adeo,1]"

# Clean up after testing
bundle exec rake "edi:test_orders:cleanup"

Configuration Files

Primary Files

  • lib/tasks/edi_test_orders.rake - Test order generator
  • doc/features/EDI_TEST_ORDER_GENERATOR.md - User documentation

Reference Documentation

  • doc/features/EDI_INACTIVE_PARTNERS.md - Inactive partner details
  • doc/features/EDI_PARTNER_STATUS_AUDIT.md - Full audit report
  • doc/features/EDI_GENERATOR_FINAL_CONFIGURATION.md - This file

Rationale

Why 20 Partners?

The final configuration of 20 partners provides:

  1. Comprehensive Coverage: All major EDI partner types represented
  2. Geographic Diversity: US, Canada, and European markets covered
  3. Practical Testing: Focused on partners that require regular testing
  4. Maintainability: Fewer configurations to maintain and update

Why Remove Amazon VC?

Amazon Vendor Central was excluded because:

  • Different integration pattern than Seller Central
  • Less frequent testing needs
  • Production systems working reliably
  • Can add back if testing needs arise

Why Only Amazon FR for Europe?

Amazon France provides:

  • Representative European market testing
  • Different language/currency testing
  • Sufficient coverage without maintaining 8 European configs
  • Other European markets use identical data formats

Production vs Test Generator

Important: The test generator configuration does not affect production:

Environment Active Partners Notes
Production 34 partners All active partners process live orders
Test Generator 20 partners Subset for testing/development only

Production systems for Amazon VC, European Amazon markets, and other partners continue to operate normally. The test generator simply doesn't create test orders for them.

Future Considerations

If Testing Needs Change

To add a partner back:

  1. Uncomment entries in PARTNER_TO_CATALOG and PARTNERS hashes
  2. Uncomment or create generator method (e.g., generate_amazon_vc)
  3. Update documentation
  4. Test the generator for that partner

To add new European Amazon markets:

  • Use the same generate_amazon_seller method
  • Add partner key and catalog mapping
  • Should work immediately (same data format)

Monitoring

Review test generator configuration:

  • When new EDI partners are added to production
  • Quarterly (check if testing needs have changed)
  • Before major EDI system updates

Verification

To verify the current active partners in production:

bundle exec rails runner "puts Edi::BaseOrchestrator.partners.select { |k,v| v[:active] == true }.keys.sort"

To list generator-configured partners:

bundle exec rails runner "load 'lib/tasks/edi_test_orders.rake'; puts EdiTestOrderGenerator::PARTNERS.keys.sort"

Configuration Owner: Development Team
Last Updated: October 15, 2025
Next Review: January 2026