Weekly Schedule

Intelligent Foods operates on a set weekly schedule. Our Menu of items is published 3 weeks in advance and changes each week. Each Menu is identified by date of the first date (Sunday) of the shipping week.

Orders may be placed up until the Menu deadline, which is (by default) Wednesday Noon Pacific before the shipping week. For example, the default ordering deadline for Menu 2021-07-11 is 2021-07-07T19:00:00Z. However, the ordering deadline may be later in the week as negotiated in our business agreement. Your assigned ordering deadline for each Menu is supplied by the deadline attribute of the Menu object returned from the Get Menu request. Orders submitted past the deadline will be rejected with an HTTP 422 order_validation_error.

Order Processing

Order placed before Wednesday Noon Pacific of the week prior to the shipping week will be accepted and queued for processing. At this time, until the order has been processed, the order.status will be ACCEPTED. ACCEPTED status order may be cancelled.

Past Wednesday Noon Pacific, Orders will be processed intermittently from that time until the Order is scheduled to be packed. The order.status of a processed Order will change from ACCEPTED to PROCESSED. Once an Order is processed, the Order may not be cancelled under normal circumstances. Please refer to Statuses and Errors for a full description of the order.status states. A PROCESSED Order indicates inventory has been reserved, a shipping label has been purchased, and the Order is schedule for packing at one of our distribution centers. Orders placed past Wednesday Noon Pacific are considered “late” orders, may be processed immediately, and therefore are ineligible for cancellation.

The following diagram illustrates our weekly schedule:

Weekly Schedule

Packing and Delivery

Intelligent Foods operates 2 distribution centers; the West Coast facility is in San Jose CA, the East Coast facility is in Westampton NJ. These 2 facilities are capable of delivering fresh food to most of the continental United States in 2 days or less. We maintain an advanced network of carriers and line hauls to ensure timely delivery.

Partners do not need to concern themselves with when or where an Order will be packed, or how the Order will be delivered. All you need to do is supply when the customer would like their Order to be delivered. We then work backwards to calculate the optimal packing day, route, and carrier. The selected carrier, along with the tracking code and tracking URL, will be provided as part of the Shipment data.

Additionally, Partners have no control over how an Order will be packed. We use a 3rd party weather service to determine the forecast temperature for the delivery zip code. This, along with the transit time, and temperature sensitivity of the specific items ordered, is used to automatically calculate a box, ice, and insulation solution that ensures food safe delivery.

Projected Shipments vs Actual Shipments

Since April 2022, Intelligent Foods charges a shipping fee PER BOX, rather than PER ORDER.

Starting with API version 1.69.0, Create Order and Simulate Create Order responses contain the attribute projected_shipments. This value indicates the number of shipments (boxes) we expect to use to pack the entire order. Due to constantly changing weather, in rare circumstances this value may differ from the actual number of boxes used at packing time.

The total shipping fee billed will always be the lesser of the two values; projected vs actual. In other words, if we use less boxes than projected, we will bill for the actual number of boxes. If we use more than projected, we will bill for the projected number of boxes.

The actual number of shipments and their details are always available after an order has moved to the PROCESSED state, and are also supplied via webhook callback.

Availability

In general, Intelligent Foods offers delivery Sunday through Thursday. However, Partners must be aware that the available delivery days vary from zip code to zip code, and week to week. It is important to query the Zip Code Availability endpoint prior to presenting delivery options to a customer. Some zip codes may have all 5 days available, while others may have only 1. We also do not service all zip codes in the United States. If a zip code is not available for delivery, the Zip Code Availability endpoint and the Create Order endpoint will return an HTTP 406 delivery_not_available_error.

The Zip Code Availability endpoint reports both the available delivery days for the Week and Zip Code, and the items that are available, unavailable, and sold-out per day. Following is an example availability response for the request https://api.sunbasket.com/partner/v1/menu/2021-07-11/availability/82001:

[
    {
        "delivery_date": "2021-07-12",
        "available": [
            "020a0fbcbf074b95887e73767c66eff8",
            ...
            "038d05112c32445aabfef6aa82c71fe6",
            "ff116edcda7642c98fd85a8c0e641bff"
        ],
        "unavailable": [
            "600c6d91cb1d4c729d61ee28587f782f",
            "7e9409ba721945f3837d5a705444335b",
            "82c306a36518420f8a991db066685cc2",
            "902caf4e41cc44a7a0e1332d1319546b"
        ],
        "sold_out": [
            "fd811f1d03794d71a67b70754c4ebc98"
        ]
    }
]

In addition to delivery day availability, Partners must be sure to filter the Menu of items using the Zip Code availability response. You should not display unavailable items to users. You may also choose to not display sold_out items, alternatively they may be displayed with a “sold-out” indicator. Item availability varies from zip code to zip code, and day to day.