Master Data
Company Facility
10 min
use this api to create internal company owned locations such as warehouses, factories, rdcs, or depots these are the origin points used when planning dispatch in transportone overview in your erp system, you likely manage a list of company owned locations — such as plants, fulfillment centers, or depots these are the points from which shipments are dispatched to enable transportone to plan shipments from these locations, you need to push this facility data to tms using the company facility api each facility will be identified by a unique facilitycode from your erp once created in tms, this code will be used in transport orders as the originfacilitycode transportone will not create or modify these facilities — your erp system remains the source of truth use case your erp sends a dispatch request for an order originating from whs blr 001 before you can send that order to transportone, this facility must be registered using the company facility api after it’s created, you can reference whs blr 001 in your order payload to let transportone plan the shipment data flow erp → tms when to use this when you want to create or sync origin locations from your erp system before pushing transport orders that use these locations for dispatch typical erp mapping shipping plants or warehouse codes endpoint post /api/v1/facilities headers authorization bearer \<accesstoken> x coreos access \<your access key> content type application/json authorization bearer \<accesstoken> x coreos access \<your access key> content type application/json request payload send this json body to create a company facility { "facilitycode" "whs blr 001", "facilityname" "bangalore rdc", "type" "origin", "ownership" "company", "address" { "line1" "warehouse rd", "city" "bangalore", "state" "ka", "pincode" "560048" }, "geocoordinates" { "lat" 12 9716, "lon" 77 5946 } } success response { "success" true, "message" "facility created", "facilityid" "fac123456" } field reference field type required description facilitycode string yes unique code from your erp (e g , plant id) facilityname string yes display name for internal location type string yes use "origin" for dispatch points ownership string yes always "company" for internal facilities address object yes complete address including pincode geocoordinates object optional latitude and longitude for routing logic what’s next? add a customer facility add a customer facility add external delivery locations such as customer or dealer sites sync product master sync product master provide product level data required for planning and billing set up orders set up orders
