Master Data
Customer Facility
9 min
use this api to create external delivery locations such as customer warehouses, retail stores, or distribution points these are the destination points for transport orders in transportone overview your erp system manages a list of external delivery points — such as customer warehouses, distribution centers, or dealer locations these are where shipments are delivered once dispatched from your internal facilities to enable transportone to plan and execute these deliveries, you need to push customer facility data into tms using this api each facility should have a unique facilitycode from your erp once created, this code will be referenced as the destinationfacilitycode in transport orders customer facility data is owned and managed in your erp tms will not create or modify these entries use case your erp creates a dispatch for an order that needs to be delivered to a retail outlet identified as dealer 123 before sending this order to tms, you need to first create that customer location using this api once the facility is registered in tms, you can reference dealer 123 in your transport order to complete planning and routing when to use this when syncing customer ship to addresses or delivery points from your erp before sending transport orders with a delivery location to map customer master data from erp to tms, customer master delivery address endpoint post /api/v1/facilities headers json authorization bearer \<accesstoken> x coreos access \<your access key> content type application/json request payload send this json body to create a customer facility { "facilitycode" "cust hyd 001", "facilityname" "hyderabad dealer hub", "type" "destination", "ownership" "customer", "address" { "line1" "plot 42, industrial area", "city" "hyderabad", "state" "ts", "pincode" "500032" }, "geocoordinates" { "lat" 17 3850, "lon" 78 4867 } } success response { "success" true, "message" "facility created", "facilityid" "fac987654" } field reference field type required description facilitycode string ✅ unique code from your erp (e g , customer site id) facilityname string ✅ name of the customer location type string ✅ must be "destination" for customer facilities ownership string ✅ always "customer" for this api address object ✅ delivery address details geocoordinates object optional latitude and longitude of the delivery location what’s next? 👉 \[sync product master →]\( /product master) provide product level data required for planning and billing 🔙 \[back to master data overview →]\( /sync master data)
