Skip to main content
Locations represent physical places in your supply chain — supplier factories, warehouses, and sales channels. They are used as transport origins on screenings, and as the origin for materials and processes.

Look up geographical locations

Locations are anchored to a geographical place from the Målbar catalog. Call GET /v1/geographical/locations to find the publicId for the country or city you need. Save the geographical publicId (lli_ prefix) — you’ll pass it when creating a location.

Create a location

Call POST /v1/logistics/locations using the geographical publicId from above. The response includes a location publicId (trl_ prefix) — save this. You’ll use it as the transportLocation on a screening, and as the origin or destination when creating routes.

The type field

type is required. Set these fields depending on the type:
TypeFields
Suppliername, geographical, tier, own, vatNumber, externalId, supplier, address, zip, city
Warehousename, geographical, own, totalCapacity, shelfHeight, weeksRotation, address, zip, city
RetailStorename, geographical, totalCapacity, weeksRotation, address, zip, city
RetailLocationname, geographical, timeperiod, totalCapacity, weeksRotation, stores
B2Bname, geographical
FinalClientname, geographical
Unknown(no fields required — name and geographical are set automatically)
tier accepts Tier1, Tier2, Tier3, or Tier1And2. Repeat for each location in your supply chain.

Next

Create Routes →