-
Notifications
You must be signed in to change notification settings - Fork 2
CargoNext Editions
CargoNext is offered in three complementary editions so that organisations of any size can adopt the platform at the right level of capability and support.
- CargoNext (Community) — free and open source. The full operational backbone for forwarders, 3PLs, and shippers.
- CargoNext Plus — commercial subscription that unlocks all third-party integrations (maps, telematics, flight & vessel tracking, on-demand delivery, customs e-filing), advanced analytics, AI assistance, and enterprise governance.
- CargoNext Go — native mobile apps (iOS and Android) for drivers, warehouse operators, customers, and field sales / ops users.
Navigation: Home > Introduction > CargoNext Editions
| Edition | Audience | Distribution | Licence model |
|---|---|---|---|
| CargoNext (Community) | Solo forwarders, SMEs, evaluators, OSS community | Open source on GitHub | AGPL-3.0 (matches the current app_license in hooks.py) |
| CargoNext Plus | Mid-market and enterprise forwarders, 3PLs, BCOs | Closed source / commercial bench-app | Commercial subscription + per-site licence keys |
| CargoNext Go | Drivers, warehouse operators, customers, sales reps in the field | Native iOS / Android (PWA fallback) | Bundled with Plus; standalone app store SKUs |
The Community edition is the full operational backbone, minus paid
integrations, paid connectors, and the advanced analytics / AI surface.
Everything in this section ships in the logistics/ app today.
- Built on Frappe v16 + ERPNext v16
- Multi-company, multi-currency, multi-branch via Frappe
- Role-based permissions, fixtures shipped (
role.json,custom_html_block.json) - Web portals:
/transport-jobs,/warehouse-jobs,/stock-balance,/warehousing-portal - Wiki documentation set under
logistics/wiki_content/
- Transport Order, Transport Job, Transport Plan, Run Sheet, Transport Leg, Transport Consolidation
- Vehicle, Driver, Transport Company, Transport Terminal masters
- Capacity Reservation, Scheduling Constraints, Truck Bans, Plate Coding, Ad-hoc Factors
- Proof of Delivery (signature, photo, timestamp)
- Run Sheet Scan page
- Internal job creation from source, multi-leg routing
- Customer transport portal
- Inbound, Release, Transfer, Stocktake, VAS Orders
- Warehouse Job, Periodic Billing, Warehouse Contract
- Storage Location / Type / Environment, Handling Units, Putaway, Gate Pass
- Plate Scanner page, Count Sheet page
- Warehouse Stock Ledger, Storage Occupancy
- Sea Freight: Sea Booking, Sea Shipment, Sea Consolidation, Master Bill, Vessel, Shipping Line, CTO, Container Yard
- Air Freight: Air Booking, Air Shipment, Air Consolidation, MAWB, Airline, ULD, Dangerous Goods Declaration, Flight Route, Flight Schedule (manual entry)
- Container Management
- Declaration, Declaration Order, Permit Application, Permit Type, Exemption Certificate
- Commercial Invoice charges & lines, Commodity master, Issuing Authority, Customs Authority
- Sales Quote (separate billings per service)
- Tariff, Transport / Sea / Air / Warehousing / Customs Rate
- Cost Sheet, Change Request, Transport Lane / Zone, Weight / Qty Breaks
- Source / Operational Exchange Rate (manual entry of FX in Community)
- Job Number, Profit Center
- Recognition Policy Settings (one per company), Recognition Date Basis
- WIP / Accrual postings, Reversal on invoicing
- Profitability dialog on jobs
- Document Management (Document List Template, milestone templates, auto-populate)
- Milestone Tracking with date-based sync
- Lifecycle Templates & Stages
- Credit Management (Credit Status on Customer, Credit Hold Lift Request, hold rules per DocType)
- Cash Advance (driver advance + liquidation)
- Invoice Integration hooks (PI / SI lifecycle, WIP / accrual reversal, GL dimensions)
- Intercompany Billing & relationships (Journal Entry vs SI / PI)
- Special Projects (lifecycle, scoping, milestones, resources, deliveries)
- Exhibits (exhibit / docket lifecycle for event logistics)
- High Value (HV brand tracking)
- Sustainability (carbon footprint, energy, emission factors, goals, compliance — calculation engine only, no external auto-fetch)
- Netting (settlement groups, intercompany netting)
- Standard reports per module (executive snapshot, branch performance, owner workload, aging backlog, concentration views)
- Maps: only OSM Nominatim forward-geocoding; no commercial routing provider keys
- Telematics: only the open Traccar adapter is enabled; commercial providers are present in source but gated off
-
Flight tracking: only manual Flight Schedule entry; the OpenSky,
AviationStack, AviationEdge, and ADS-B connectors and the
*/10 * * * *sync_active_flightsscheduler job are disabled by default -
Vessel tracking: providers exist (
vessel_tracking/) but are gated off - ODDS / last-mile dispatch: Lalamove, Transportify, Pandago, GrabExpress, NinjaVan adapters are not callable in Community
- Customs e-filings: US ISF, US AMS, JP AFR, CA eManifest, Global Manifest — UI only, no live submission
- IATA Cargo-XML: queue tables exist; transmission disabled
- Mobile apps: not included (use desk pages and portal via browser only)
- Telemetry / usage analytics: none collected
Plus is an additive bench-app that activates the gated capabilities and adds enterprise-grade tooling on top of a Community install. Everything in Community remains; Plus turns on connectors, advanced analytics, AI, and governance.
- Google Maps Platform (Geocoding, Routes, Distance Matrix, Places, Static Maps)
- Mapbox (Geocoding, Directions, Matrix, Static Tiles)
- HERE Maps (Geocoding, Routing, Truck Routing, Traffic)
- OSRM self-hosted profile support
- Address auto-geocoding on save (with provider failover)
- Service-area, zone, and isochrone tooling for the Pricing Center
-
Geotab, Samsara, Wialon, Remora, Traccar Pro, and the
Custom webhook adapter — fully licensed and wired to
logistics/transport/telematics/ingest.pyandresolve.py - Live vehicle position on Transport Job, Run Sheet, and dispatcher map
- Driver behaviour, harsh-braking, idling, geofencing alerts
- Auto-stamp Transport Leg
pick_*/drop_*events from telemetry
- OpenSky, AviationStack, Aviation Edge, ADS-B Aggregator connectors enabled
- Scheduled
sync_active_flights(10-minute cron) andupdate_air_freight_jobs_with_flight_status(hourly) jobs activated - Flight Schedule master data sync, Flight Schedule Sync Log
- Auto status update on Air Booking / Air Shipment milestones
- VesselFinder, VesselAPI, Marinesia providers enabled
- Live AIS position, ETA prediction, port-call detection
- Auto status update on Sea Booking / Sea Shipment / Master Bill
- Lalamove, Transportify, Pandago, GrabExpress, NinjaVan quotation, order placement, webhook updates
- ODDS Order / Quotation desk doctypes activated
- Auto-cost back to Transport Job and Sales Quote
- US ISF (Importer Security Filing)
- US AMS (Automated Manifest System)
- JP AFR (Advance Filing Rules)
- CA eManifest (CBSA)
- Global Manifest carrier dispatch
- IATA Cargo-XML (XFWB, XFZB, XFFM, status messages)
- ACI / ACE / ENS extensions on the roadmap
- Carbon Footprint auto-calculation per shipment using GLEC and ISO 14083 factors
- Emission factor library refresh
- ESG reporting packs (CSRD, SECR, SBTi, CDP exports)
- Sustainability Goal forecasting and reduction-pathway modeller
- AI Rate Recommendation on Sales Quote (historical Tariff plus Job profitability)
- Operational FX auto-fetch from external sources (Open Exchange Rates, ECB, custom Exchange Rate Source connectors)
- Margin guardrails and approval workflows on Sales Quote
- Surcharge automation (fuel, peak season, currency)
- Auto-cost re-allocation across Internal Jobs / Intercompany
- ETA prediction (ML model trained on Transport Leg history and telematics)
- Exception management dashboard (delay, dwell, demurrage risk)
- Auto-milestone inference from telematics / AIS / ADS-B
- Recognition Policy auto-tuning across companies
- White-label theming and custom domains for the Customer Portal
- Live shipment tracking map (web)
- Quote-to-book self-service for customers
- Document e-signing on portal (POD, BL, AWB acceptance)
- Multi-language portal (EN, ES, CN, JP, AR, FR, PT and more)
- Embedded BI dashboards (per branch / service / customer)
- Scheduled report distribution and Slack / Teams alerts
- Data warehouse exports (BigQuery, Snowflake, Postgres replica)
- Webhook & event bus for all logistics doctypes
- SSO (SAML / OIDC / Azure AD / Okta / Google Workspace)
- SCIM user provisioning
- Field-level audit trail beyond Frappe's default
- Configurable approval workflows builder (visual)
- Data residency / per-region hosting controls
- 24×7 priority support with SLA
- Dedicated success manager
- Quarterly release-pinning and long-term-support (LTS) channel
- Premium connectors maintenance
A native mobile suite (iOS and Android) talking to CargoNext via the
whitelisted APIs already in logistics/transport/api.py,
logistics/warehousing/api.py, and logistics/document_management/api.py.
Ships as four role-based apps under one umbrella.
Targets the driver-mobile API surface already proven by
logistics/transport/doctype/transport_leg/test_driver_mobile_api.py —
fields such as pick_latitude, pick_longitude, pick_photo,
drop_photo, pick_signed_at, drop_signed_at.
- Run Sheet view with assigned legs for the day
- Turn-by-turn navigation (Google / Apple Maps deep-link in Go; embedded map in Go + Plus)
- Arrival / departure GPS auto-stamping
- Pickup & drop photo capture, customer / consignee signature pad
- Notes, exception codes, damage capture
- Proof of Delivery generation and offline upload queue
- Cash-on-delivery and Cash Advance liquidation entry
- Plate Coding / Truck Ban advisories
- Hours-of-service / break timer
- Push notifications (job assigned, schedule change, route deviation)
Built on logistics/warehousing/api.py and the existing Plate Scanner /
Count Sheet pages.
- Inbound receiving with barcode / QR scan, handling-unit creation
- Putaway with location scan and capacity check
- Picking / Release with wave + task lists
- Stocktake / Count Sheet on phone or rugged scanner
- VAS Order execution (step-by-step instructions with photo proof)
- Gate Pass issuance with QR check-in / out
- Plate Scanner for truck arrivals
- Offline-first with sync on reconnection
For BCOs and shippers.
- Live shipment tracking (Transport, Sea, Air) on a map
- Document inbox: BL, AWB, Declaration, Invoice
- Quote request and acceptance
- Stock Balance view for warehouse customers
- Milestone timeline with push alerts
- Booking creation for repeat lanes
- E-sign POD and invoice approvals
- In-app chat with operations
For commercial reps and ops supervisors.
- Sales Quote drafting on the go with the same Pricing Center logic
- Customer visits log (CRM-style) with geotag
- Job & shipment search with one-tap drill-down
- Approvals: credit hold lift requests, change requests, cash advance
- Live dashboards (P&L by job, WIP aging, exception count)
- Biometric login, MFA, device enrollment
- End-to-end encryption of media at rest
- Background sync, offline cache (SQLite + queued mutations)
- Push via FCM / APNs (provisioned through Plus)
- Localisation (EN, ES, CN, JP, AR, FR, PT)
- Dark mode, accessibility (WCAG 2.1)
- Tablet layouts for dispatcher and warehouse manager
- App-store distribution + MDM / Intune support for enterprise
| App | With Community | With Plus |
|---|---|---|
| Go · Driver | Manual leg updates, manual signature / photo | Auto-stamp from telematics, live map with traffic, route optimisation |
| Go · Warehouse | Scan + sync | Real-time slotting AI, voice-pick, RFID gateway |
| Go · Customer | List + simple status | Live map (vessel / flight / telematics), branded skin, e-sign |
| Go · Sales / Ops | Forms + approvals | AI rate suggestion, predictive ETAs, BI cards |
| Capability area | Community | Plus | Go |
|---|---|---|---|
| Transport / Warehousing / Customs / Sea / Air ops | Full | Full | Mobile UX |
| Sales Quote, Tariff, Cost Sheet | Full | + AI pricing, FX auto-fetch | Quote on mobile |
| Job Mgmt, WIP / Accrual, Recognition | Full | + auto-tuning, audit | View only |
| Document & Milestone management | Full | + e-sign, AI extraction | Capture |
| Credit, Cash Advance, Netting, Intercompany | Full | + approval workflows | Approvals |
| Sustainability | Manual factors | Auto + ESG packs | Capture activity |
| Customer Portal (web) | Standard | White-label, live tracking | – |
| Maps / geocoding | OSM Nominatim | Google / Mapbox / HERE / OSRM | Embedded maps |
| Telematics | Traccar OSS only | Geotab, Samsara, Wialon, Remora, custom | Driver mobile feed |
| Flight tracking | Manual | OpenSky, AviationStack, AviationEdge, ADS-B | Live in-app |
| Vessel / AIS | Manual | VesselFinder, VesselAPI, Marinesia | Live in-app |
| ODDS / last-mile | Stubs only | Lalamove, Transportify, Pandago, Grab, NinjaVan | Book in-app |
| Customs e-filings (ISF / AMS / AFR / eManifest / Cargo-XML) | UI only | Live transmission | Status only |
| SSO / SCIM / advanced audit | – | Yes | – |
| Embedded BI / data warehouse export | – | Yes | KPI cards |
| Mobile apps (iOS / Android) | – | – | Yes |
| Support | Community forum, GitHub issues | 24×7 SLA + CSM | Bundled with Plus |
| Source | Public (AGPL-3.0) | Closed source | Closed source |
-
Gating mechanism — introduce a
CargoNext Editionsingle doctype (Community / Plus / Go-only) and anis_plus_enabled()helper. Gate the connector code paths inlogistics/transport/telematics/,logistics/air_freight/flight_schedules/,logistics/sea_freight/vessel_tracking/,logistics/transport/odds/, andlogistics/customs/api/behind it. -
Repo split — keep
logistics/as the OSS app and createlogistics_plus/as the commercial bench-app that registers connectors and adds advanced doctypes. This avoids cross-licence contamination of the current AGPL-3.0 codebase. -
Mobile API contract — the work already done in
logistics/transport/api.py(RUN_SHEET_BUNDLE_LEG_FIELDS,DRIVER_LEG_UPDATE_FIELDS,_enrich_leg_for_mobile) is the right pattern. Extend the same explicit allowlist / enrichment style to warehouse, customer, and sales mobile APIs before building the Go apps. -
Marketing surface — update
README.mdand add a Wiki landing page that leads with the three-edition story so GitHub visitors immediately understand Community vs Plus vs Go.
Getting Started
- Getting Started
- Recent Platform Updates
- CargoNext v1 — Release Notes
- CargoNext v1 — Astraea Press Release
- Document Management
- Milestone Tracking
- Customer Portal
Setup and Settings
- Logistics Settings
- Credit Management
- Default Details and Relationships
- Sea Freight Settings
- Air Freight Settings
- Transport Settings
- Warehouse Settings
- Customs Settings
Sea Freight
- Sea Freight Module
- Sea Booking
- Sea Shipment
- Sea Consolidation
- Master Bill
- Shipper
- Consignee
- Container Type
- Container Management
Air Freight
Transport
- Transport Module
- Transport Order
- Transport Job
- Transport Consolidation
- Transport Leg
- Transport Plan
- Run Sheet
- Proof of Delivery
- Transport Template
- Load Type
- Transport Order — Inter-module Field Copy
Customs
Warehousing
- Warehousing Module
- Inbound Order
- Release Order
- Transfer Order
- VAS Order
- Stocktake Order
- Warehouse Job
- Warehouse Contract
- Gate Pass
- Periodic Billing
- Storage Location
- Handling Unit Type
Pricing Center
- Sales Quote
- Sales Quote — Separate Billings and Internal Job
- Change Request
- Sales Quote – Calculation Method
Job Management
- Job Management Module
- Revenue Recognition Policy — Accounts, Dates, and Charges
- Proforma GL Entries
- WIP and Accrual Reversal on Invoicing
Sustainability
Intercompany
Special Projects
Pages
Features
Reports
Glossary