> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cdslogistics.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Grasshopper

Grasshopper Integration

# Order Creation

The Grasshopper integration creates and updates orders based on the `PO Number` field.

The `PO Number` field is used to store the `CDS Order Number` also known as the `System #`

If `PO Number` does not exist, then order is created in the Grasshopper site.

If `PO Number` already exists, then order is updated in the Grasshopper site.

**Important**

When new orders and order updates are sent to the integrated Grasshopper site, duplicates will be created if the `CDS Order Number` is not found in the `PO Number` field. 

# Order Updates

If order is updated in Vision Ops, Grasshopper will include updates listed below.

* Order Cancellations
* Order Scheduled/Rescheduled
* Order Timeframes
* Order Notes
* Order Commodities 

If order is updated in Grasshopper, Vision Ops will include updates listed below.

* Order Scheduled/Rescheduled
* Order Timeframes
* Order Notes

# Order Barcodes

Barcode integration is not supported.

Orders must be scanned using CDS scanners and Grasshopper scanners.

# Order Delivery ETA (Estimated Time of Arrival)

CDS orders must be set to `Out for Delivery` to fetch order real-time ETA (Estimated Time of Arrival) by CDS applications.

Orders can be set to `Out for Delivery` in the Grasshopper scanner by drivers, or in the Grasshopper site by office staff.

Refer to sample screenshot when order is set to "Out for Delivery" and displaying ETA.

<Frame>
  <img src="https://mintcdn.com/cdslogistics/qtbcqyoWY0pCpnUP/images/image.png?fit=max&auto=format&n=qtbcqyoWY0pCpnUP&q=85&s=2e54f099451689fc20145835632c2c3b" alt="Image" width="1370" height="269" data-path="images/image.png" />
</Frame>

# Failed to Schedule Order

To schedule orders in Grasshopper, manifests must be available for the intended scheduled dates.

An email will be sent if the integration cannot schedule the order, see sample email below for reference.

> From: [donotreply@cdsalerts.com](mailto:donotreply@cdsalerts.com) \<[donotreply@cdsalerts.com](mailto:donotreply@cdsalerts.com)>
>
> Subject: Action Required: Manifest Creation Needed for Order Number 12345
>
> This is an automated notification regarding Order Number 12345.
>
> Please be advised that the order could not be automatically scheduled for 2025-12-31 due to the absence of an available manifest for that date.
>
> To proceed, please create a manifest for 2025-12-31 and ensure that Order Number 12345 is scheduled accordingly.
>
> Thank you for your attention to this matter.
>
> Sincerely,
>
> CDS Logistics

# Field Mapping

* PO Number = Vision Ops - System #
* Contact Info = Vision Ops - Consignee Name and Phone Number
* Address = Vision Ops - Consignee Address
* Service Level
  * White Glove - WG (default)
  * Threshold - THR
* Items
  * Name = Vision Ops - Commodity Code with Quantity
  * SKU = Vision Ops - CRN
  * Cubes = Vision Ops - Commodity Cubes
  * Weight = Vision Ops - Commodity Weight
* Notes = Vision Ops - Notes

<Frame>
  <img src="https://mintcdn.com/cdslogistics/qtbcqyoWY0pCpnUP/images/image-1.png?fit=max&auto=format&n=qtbcqyoWY0pCpnUP&q=85&s=80bc5f97bdaaee47ade5fd8004742622" alt="Image" width="1506" height="500" data-path="images/image-1.png" />
</Frame>

# Release Notes

## 10/22/2025

**Update**

**Items now include commodity quantity, cubes and weight**

<Frame>
  <img src="https://mintcdn.com/cdslogistics/qtbcqyoWY0pCpnUP/images/image-2.png?fit=max&auto=format&n=qtbcqyoWY0pCpnUP&q=85&s=2725a597f8325a0a73d1df682f878bb3" alt="Image" width="881" height="353" data-path="images/image-2.png" />
</Frame>
