surtlyDocs
Example setups
PROVIDER GUIDE

Wholesale coffee and franchise supplies

Combine a public coffee warehouse with private supplies for franchise clients.

The business situation

You sell coffee to external customers and supply your franchise locations with cups, lids, and cleaning products. You want separate inventory and ordering access, within the same provider account.

In this example, Café Alba is an external customer and Franquicia Jardín is a franchise. Both client relationships are active. Warehouses are called Café and Insumos internos in the screenshots.

ClientCoffee warehouseInternal supplies warehouseStarting warehouse
Café AlbaAvailableUnavailableCafé
Franquicia JardínAvailableExplicit access grantInsumos internos

Create a public and a private warehouse

  1. Open Locations → + and create Café, with invoice code CAF and Allow Client Orders enabled.
  2. Open the saved warehouse and turn on Default. This is the provider's default.
  3. Create Insumos internos, with invoice code INT and Allow Client Orders disabled. Keep the warehouse active.

Both warehouses can hold stock. The private setting controls client access, not whether the warehouse is operational. See warehouse settings.

Café is public and the provider default; Insumos internos is active with client ordering disabled
Café is public to your active clients. Insumos internos needs an explicit client access grant.

Restrict products to their warehouse

Create your products, then open each one and use + → Stocked Location if its Stocked Locations section is not yet visible. Assign coffee products only to Café and cups, lids, and cleaning products only to Insumos internos.

Keep these products active. You do not need a Custom Availability grant for this setup: warehouse access and product location scope provide the ordering restrictions. Leave Allow orders without stock off for this example, then record incoming stock in the corresponding warehouse.

Disposable cup product with Insumos internos as its only stocked location
Vasos 12 oz is assigned only to Insumos internos. Apply the same location scope to the other internal supplies.

An empty location list means all warehouses

Adding stock to one warehouse is not the same as restricting a product to it. Set Stocked Locations explicitly. Removing the final assignment makes all warehouses eligible again; it does not disable the product. See product location scope.

Give the franchise access and a default

  1. Open Clients → Franquicia Jardín → + → Warehouse Availability.
  2. Choose Insumos internos and save. Repeat for each franchise that should have access.
  3. Edit the franchise client, set Default Warehouse to Insumos internos, and save.
Warehouse Availability form granting Franquicia Jardín access to Insumos internos
Save the warehouse grant first. A default cannot grant access to a private warehouse.
Franquicia Jardín client editor with Insumos internos selected as Default Warehouse
The franchise starts at Insumos internos but can still select the public Café warehouse.

For Café Alba, leave the client default at Provider public default warehouse and do not grant internal warehouse access. In this example, delivery addresses have no fulfillment route. A routed address would take precedence and lock the warehouse choice; use address routing only if that is intended.

You can add a Client Type dropdown with External and Franchise values to organize the clients. This custom field is a label and filter; it does not automatically grant warehouse access. Batch custom availability grants products, not warehouses.

Verify what each client can order

Use each client's ordering link to inspect the result before sharing it. Do not submit an order just to check the configuration. Provider staff can explicitly select private warehouses, so a staff-created draft does not prove the client's access restrictions.

CheckExpected result with this setup and positive stock
Open Café Alba's new orderCoffee is offered; internal supplies and the internal warehouse are unavailable.
Open Franquicia Jardín's new orderInsumos internos is selected and internal supplies are offered.
Change the franchise's Warehouse to CaféCoffee replaces the internal supply selection. Re-enter quantities after switching.
External client ordering page offering coffee without an internal warehouse choice
This is the ordering view the provider should verify for Café Alba, the external customer.
Franchise ordering page with Insumos internos selected and cups, lids, and cleaning products available
The franchise has private warehouse access. Its Warehouse selector also offers the public Café warehouse.

Adapt the setup

If franchises must not access coffee, make Café private too and grant each client only the intended warehouse. A public warehouse is available to both groups; a client default does not exclude the other warehouse. When changing an existing public warehouse to private, follow the steps to restore affected defaults and routes.

Each order uses one warehouse. A franchise needing coffee and internal supplies places two orders in this setup. Surtly does not combine stock or split a single order between the warehouses.

Warehouse selection does not create a separate price list. Use client-specific prices or assigned volume schedules if a franchise pays a different price. For products reserved for selected clients within the same warehouse, see a selected catalog with negotiated prices.

Screenshots use fictional data. Control names match the application.

On this page