Zapiet Docs
Last Mile API
Last Mile API
  • Last Mile API
  • Configuring a test store
  • App setup overview
  • General endpoints
  • Authentication
  • Creating settings
  • Creating packages
  • Rate estimate
  • Creating a delivery
  • Delivery status
  • Cancel delivery
  • Creating an integration
  • Writing app listing
  • Order status
  • Tracking URLs
  • Allow variables list
  • Phone number formatting
Powered by GitBook
On this page
  • Rate request
  • Format the rate API Endpoint
  • Format the rate estimate request
  • Line item schema
  • Rate response
  • Rate identifier
  • Rate price
  • Rate currency
  • Merchant perspective
  • Testing rates

Rate estimate

PreviousCreating packagesNextCreating a delivery

Last updated 8 months ago

Rate estimate request lets you show your delivery rates directly to customers.

Rate request

We send a rate request when a customer goes to the rate page in Shopify checkout. To format the rate request:

  1. Go to the App Setup page

  2. Click Rate estimate

First, choose between 2 rate modes:

  • Manual

  • Automatic

If you don’t want to offer rate estimates, you can set the rate mode to Manual. Merchants will then need to set up rates on their own. If you set the mode to Automatic, you will need to format the rate estimate request.

Format the rate API Endpoint

The rate request is a POST to an endpoint of your choice. We will use your Staging/Production endpoint as the base, so you only need to add the missing path to your rate estimate endpoint.

If your rate estimate endpoint is completely different than the general endpoint you set up earlier, just make sure you include https:// in the URL.

Format the rate estimate request

Line item schema

If you need line items in your request, create the json for one line item in the Line item schema section. You can then pass the array of line items in the request body by using the ####{{ line_items }} liquid variable.

Rate response

Please return only 1 rate in your response.

Rate identifier

Enter the field name where you return the rate identifier. If you don’t have a rate identifier, leave the field blank.

Rate price

Select whether you return the price in Cents or Dollars, and enter the field name for the price

Rate currency

Enter the field name if you support multiple currencies, or the currency code if you return only one currency.

Merchant perspective

When a merchant sets up your integration, they can choose:

  • Whether they want to use your rates

  • To offer free delivery after a certain threshold

  • Name the rate however they want

  • Adjust the handling fee

Testing rates

The format of the request body needs to be valid JSON. We support liquid variables that are on our , and you can use any . Here’s an example request that will be prefilled automatically for you:

The only way to test rates estimate is to go through Shopify checkout while using our app. If you would like us to give you a test environment that’s ready to go, send us an email at ..

rate estimate list
liquid filter
partners@zapiet.com