Skip to main content
Beach Depositories handles the full lifecycle of shipping — from receiving inventory into the vault to shipping items back to account holders.

​
Inbound shipments

Inbound shipments bring inventory items into the vault.

​
Process

  1. Create shipment — An inbound shipment is created with tracking and carrier information
  2. Receive — Vault staff receives the package and verifies contents
  3. Inspect — Items are inspected, cataloged, and photographed
  4. Assign — Items are assigned to the appropriate FBO account
  5. Store — Items are securely stored in the vault

​
Tracking

Each inbound shipment includes:
  • Carrier and tracking number
  • Expected and actual delivery dates
  • Declared value and insurance coverage
  • List of items received

​
Outbound shipments

Outbound shipments send inventory items from the vault to account holders.

​
Requesting an outbound shipment

Outbound shipments can be requested by:
  • Organization admins from the dashboard
  • Organization members with access to the FBO account
  • API callers via Create Outbound Request
POST /outbound-requests accepts an optional carrier-shaped destinationAddress and a shipping preference. Omit shipping (or send mode: "cheapest") to have the vault quote the lowest-cost insured service — you never have to quote first. Send mode: "selected" with a serviceCode to name a specific service; the backend re-quotes it, and prices are never accepted from the client. The stored request and later shipment expose both fields, including the resolved shipping.quote. Creating a request does not create a shipment. GET /outbound-shipments is empty until staff approve the request and operators pick the items. Inventory stays in_vault while the request is pending; openOutboundRequestId on Get Inventory Item is how the API shows “requested, not shipped.” Item status becomes pending_outbound at pick, not at request create. After pick, the originating outbound request lists those shipments in outboundShipmentIds. Carrier tracking (carrier, trackingNumber, trackingUrl) appears on the outbound shipment after a label exists.

​
Process

  1. Request — Select items and optionally a destination address and shipping preference
  2. Review — Vault staff reviews and approves the request
  3. Pick — Operators pick items from the vault (pending_outbound starts here)
  4. Pack — Items are securely packaged with appropriate insurance
  5. Ship — Package is handed off to the carrier
  6. Deliver — Tracking updates are provided until delivery

​
Insurance

All outbound shipments are insured. Coverage is determined by:
  • The declared value of the items
  • The FBO account’s max insured value
  • The organization’s max insured value

​
Return shipments

Items that have been shipped out can be returned to the vault. Return shipments follow the same intake process as inbound shipments — items are received, inspected, and reassigned to the appropriate FBO account.