# Salesforce user guide

> The Safecube app for Salesforce starts and stops tracking shipments from Salesforce, and shows a shipment list and shipment details with container events and location.

The Safecube app for Salesforce tracks shipments from inside Salesforce. It is a custom add-on that Safecube gives access to on request, and it must be installed and configured in Salesforce first, as described in the [Salesforce installation guide](/en/platform/integrations/salesforce-installation).

## Open the app

Once installed, the app opens by searching for **Safecube** in the Salesforce App Launcher.

## Start tracking a shipment

1. Select **New**.
2. In the dialog box, fill in:
   - **Shipment Number** (mandatory): the container number, master bill of lading number or booking number;
   - **Sealine** (recommended): the 4-letter SCAC code of the shipping line. When it is empty, Safecube tries to detect the sealine automatically, which fails in about 30% of cases.
3. Select **Save** to create one shipment, or **Save and New** to add another one.

::callout{type="warning"}
Tracking data can take a few minutes to appear. Reload the page to display it.
::

## Stop tracking a shipment

To stop tracking a shipment, select it in the shipment list and delete it. A shipment can also be deleted from its shipment view.

## Shipment list

The shipment list gives a simplified overview of all tracked shipments:

| Column             | Content                                                                  |
| ------------------ | ------------------------------------------------------------------------ |
| Shipment Number    | The tracked identifier: container, bill of lading or booking number      |
| Shipment Type      | `CT` for container, `BL` for bill of lading, `BK` for booking            |
| Shipping Status    | `PLANNED`, `IN_TRANSIT`, `DELIVERED` or `UNKNOWN`, the statuses of the Salesforce app |
| Sealine            | Name of the shipping line                                                |
| Last Modified Date | Most recent date the shipment data was updated from the shipping line    |

From the shipment list, shipments can be added, removed and searched by number or type.

## Shipment details

The shipment details open when a shipment is selected in the list.

The **top section** repeats the shipment list information: shipment number, shipment type, shipping status, sealine and last modified date.

The **left panel** lists the container events, most recent first. Each event shows:

- **Location**: where the event took place;
- **Description**: a short summary of the event;
- **Event Date**: when the event occurred;
- **Is Actual**: whether the shipping line has confirmed the event.

Events can be sorted by any column. Only the 10 most recent events are displayed by default; **View All** at the bottom displays the full event history.

The **right panel** shows the current location of the shipment on a map, with zoom in and out to locate a shipment at sea.
