Integration Architecture
Developer entry point for FlowPOS third-party adapter patterns.
Use this section when adding or troubleshooting integrations whose domain logic must stay independent from provider HTTP details.
Current provider status
| Area | Runtime status | Primary docs |
|---|---|---|
| FEL/SAT certification | digifact is merchant-selectable; infile and rpafelapi adapters are wired for specific routes; routing depends on the FEL runtime path | FEL Provider Port, FEL Provider Matrix |
| E-commerce | Shopify is implemented; WooCommerce is reserved but not registered at runtime | Ecommerce Adapter Architecture, Ecommerce Provider Port |
| Delivery marketplace | PedidosYa is implemented and registered; uber_eats is enum-only | Marketplace Architecture, Marketplace Provider Port |
| Purchase document intake | FEL XML extractor is implemented; PDF-only files stay unparsed | Purchase Document Extractor Port, Purchase Document Ingestion |
| Mobile printer vendors | Registry identifies star / epson / bixolon / sunmi; StarIO10 and Android SPP/USB adapters are registered; Epson/Bixolon/Sunmi transports are not | Printer Vendor Port, Printer Config |
| Desktop generic printing | Compiled kinds advertised on Windows/macOS without a counting record; records are lab honesty, not a Find-printers lock | Desktop generic printing, Desktop printing troubleshooting |
Hexagonal guidance
When documenting or extending an integration:
- keep domain behavior in entities, value objects, and ports
- keep use-case orchestration in application services
- keep provider HTTP formats, credentials, retries, and HMAC details in infrastructure adapters
- keep controller paths, request DTOs, and redirect behavior in interfaces docs
Do not describe an adapter-specific retry, URL, token, or webhook signature as domain behavior unless the domain port requires every provider to satisfy it.
Operational references
- Shopify operations runbook
- Shopify troubleshooting runbook
- WooCommerce adapter status
- Delivery marketplace troubleshooting
- Pack operations troubleshooting
- Implementation portal troubleshooting
- Purchase document ingestion troubleshooting
- Mobile vendor printing troubleshooting
- Desktop printing troubleshooting
- FEL certifier registry
- FEL network troubleshooting
- Retail sales FEL workflow (incl. FEL on A/R payment and the PWA print/share gate)
- Platform leads troubleshooting
Related codepaths
apps/backend/src/fel/apps/backend/src/sale-fel-on-payment/(deferred retail FEL after A/R payment)apps/backend/src/ecommerce/apps/backend/src/delivery-marketplace/apps/backend/src/purchase-document-ingestion/apps/backend/src/printer-config/apps/backend/src/cash-drawer/apps/desktop/src-tauri/src/transport/packages/printer-transport/src/vendor-profile.tspackages/global/enums/marketplace.enums.tspackages/global/consts/fel-integrated-certifiers.const.tspackages/global/consts/certifiers-urls.consts.ts