OneCBridge
Overview
- Scope
- Implemented 1C/CommerceML bridge code; excludes the for_analysis reference archive
Key concepts
- Exchange Session
- Persisted state of an inbound exchange lifecycle.
- Manual Import
- Operator-initiated import path using scanning, ZIP extraction, storage, and runner services.
- Analysis Archive
- OneCBridge/for_analysis reference material; it is not runtime bridge implementation.
Structure
- Api
- Prefix/api/bridge/1c
- EndpointGET|POST /exchange
- Services
- ExchangeSessionService
- ExchangeAuditService
- IncomingPackageStorageService
- CommerceMlParser
- ImportOrchestrator
- ShopImportMapper
- ImportDeactivator
- ManualImportRunner
- PersistenceOneCBridge migrations and ExchangeSession, ExchangePackage, ExchangeLog models
- ConsoleOneCBridge import-file command
Facts
- OneCBridge manifest requires Shop ^1.0 and sets install to false. authoritative
- The provider merges module configuration, registers bridge services, migrations, API routes, console command, views, and a bridge-specific exception renderer. authoritative
- The exchange controller is exposed under /api/bridge/1c/exchange for both GET and POST through api middleware. authoritative
- Exceptions for api/bridge/1c requests are rendered with ExchangeResponseFormatter. authoritative
How-to guides
Investigate Import
- identify the exchange session/package and audit records
- trace storage, parser, orchestrator, mapper, and deactivation stages
- verify Shop data impact in a safe environment
- use the manual-import or console path only with controlled input files