Skip to main content

Set up Store Hours Pull

THIS FEATURE IS IN ACTIVE DEVELOPMENT - DOCUMENTATION SUBJECT TO FREQUENT CHANGE

Overview​

As part of the integration workflow, partners can implement an endpoint that allows DoorDash to pull the opening hours for a store location. This refreshes the store hours for a store, changing when Customers are able to order items from the store.

The response from this endpoint should match the Store model

Partners can trigger the job creating a Store Hours pull job by POST /api/v2/jobs with CreateJob request.

Get Started​

Step 1: Set up Endpoint Specification to Pull Store Hours​

The set up of the endpoint is:

GET /{merchant_pull_endpoint}/{store_location_id}

store_location_id is the unique Merchant Supplied ID that is configured for that store location. The endpoint will deliver the store hours for 1 single location at a time. This endpoint should be different from the Inventory pull endpoint.

Once the endpoint is ready, reach out to your Technical Account Manager to register the endpoint with DoorDash. Coming Soon: Self-serve subscription registration within the Developer Portal

Currently we support static tokens and Oauth authentication mechanisms when calling Pull endpoints. If DoorDash needs to authenticate with your endpoint using Oauth, please share the oauth endpoint with Technical Account Manager to register in DoorDash.

Step 2: Ensure that store.json response from endpoint has the correct format​

As mentioned above, the Store Hours pull request must return the response that matches Store request model

Note: The response should contain all regular and special hours for a store. DoorDash will replace the current hours of the store with the ones from the json response when calling the pull job endpoint.

Model response expected from endpoint:

{
  "merchant_supplied_store_id": "string",
  "open_hours": [
    {
      "day_index": "MON",
      "start_time": "string",
      "end_time": "string"
    }
  ],
  "special_hours": [
    {
      "date": "string",
      "start_time": "string",
      "end_time": "string",
      "closed": true
    }
  ]
}

Next Steps​

To ensure that Store Hours pull is working as expected, please reach out to support via Developer Portal or your Technical Account Manager (if applicable) to test.

Modified: 11/11/2024