The distance delivery method allows you to automatically charge shipping based on how many kilometers the customer's address is from your business. Instead of a fixed amount, the app calculates the delivery cost by multiplying the distance by the price per km you set.

You can also set a maximum delivery distance — orders outside that area cannot select this method.

Before You Begin

Jarbas needs to know where your business is located in order to calculate the distance to the customer. Before creating a distance delivery method:

1. Go to Settings → Store Data.
2. Confirm that the full address is filled in (street, number, neighborhood, city, and ZIP code).
3. Save. The app will automatically geocode the address.

Without a registered address, it will not be possible to save a distance delivery method.

How to Create the Delivery Method

1. In the main menu, go to Settings → Orders → Delivery Methods.
2. Tap the + button (add).
3. Fill in the fields:

Name
The name that will appear to you and to the customer at the time of the order. Examples: Motorcycle courier, City delivery, Delivery.

Amount
Enter the price per kilometer to be charged or the fixed shipping fee. For example: $2.50.

Price per km
Enable this option to indicate that the amount entered is per kilometer. With it enabled, the delivery cost is calculated as follows:

Cost = Distance (km) × Price per km

Example: customer 8 km away, price per km $2.50 → shipping = $20.00.

When this option is disabled, the entered amount is charged as a flat rate, regardless of distance.

Maximum distance
Enable this option to limit how far you deliver. Enter the distance in whole kilometers.

• Customers with an address beyond this distance will not be able to select this delivery method.
• If left disabled, there is no distance limit.

Free shipping from (optional)
Set a minimum purchase amount for shipping to be automatically free. When the order subtotal reaches or exceeds this amount, the delivery cost is set to zero.

Example: free shipping for orders over $150.00.

Show in catalog
When enabled, the method appears in the delivery options of your business's online catalog.

How It Works in Practice When Placing an Order

1. On the cart screen, tap Delivery Fee.
2. Select the distance delivery method you created.
3. The app requests the customer's address (if not already registered in their profile).
4. The system geocodes the address and calculates the straight-line distance between your business and the customer.
5. If the distance is within the configured limit, the shipping fee is calculated and added to the order total.
6. If needed, the shipping amount can be manually edited by tapping the edit icon next to the selected method.

Important Notes

Straight-line distance
The calculation uses the straight-line distance (radius) between the two addresses, not the actual route traveled by the delivery person. Keep this in mind when setting the price per km and the maximum distance.

Customer address
The customer needs to have a registered address. If there isn't one, the app will open a screen to fill it in before calculating the shipping fee.

Distance limit is checked before free shipping
If the customer's address is beyond the configured maximum distance, the delivery method cannot be selected — regardless of the order amount. Free shipping is only applied after the distance has been validated and is within the limit.

Frequently Asked Questions

Can I have more than one distance delivery method?
Yes. You can create multiple methods with different settings — for example, one for nearby deliveries with a lower price and another for longer distances with a higher price.

What if I want to charge a flat rate but still limit the distance?
Disable the "Price per km" option and enter the flat amount in the Amount field. Enable "Maximum distance" as usual. The shipping fee will be fixed, but will only appear for customers within the configured radius.

What happens if the customer doesn't have a registered address?
The app will ask for the address before calculating the shipping fee. The address provided will be saved to the customer's profile for future orders.

Can I use this method in the online catalog?
Yes, enable the "Show in catalog" option in the method's settings. Also make sure the shipping feature is enabled under Settings → Online Catalog → Delivery Methods.