I need an open, fully documented REST-style API that can sit between Ship ERP and our in-house Truck Management System, letting the two platforms talk to each other in real time. The core responsibilities of this new layer are:
• Real-time status updates – the moment a shipment moves, both systems must reflect it.
• Data synchronization – orders, loads, and reference data must stay consistent on both sides.
• Rate engine – an endpoint that can accept lane details, weight, and accessorial flags, then return our calculated rate instantly.
Key data points that the endpoints must expose or consume include tracking numbers, current shipment status, and system-generated rate calculations.
Technical expectations
– JSON over HTTPS; versioned endpoints.
– Token-based authentication (OAuth2 or similar).
– Clear error handling and standardized response codes.
– Swagger / OpenAPI 3.0 spec plus concise developer guide.
– Docker-compose file for local testing against mocked Ship ERP & TMS stubs.
Acceptance criteria
1. End-to-end test shows a shipment created in Ship ERP appearing in the Truck Management System within 30 seconds.
2. Rate engine returns correct tariff for three provided sample scenarios.
3. Postman collection and Swagger file match live endpoints exactly.
Hand-off items: source code (preferably Node.js or Python), infrastructure notes, and any schema mappings used. Once delivered, we will own the IP outright, so please avoid dependencies that limit licensing flexibility.
Show More