Skip to content
Documentation sections

Shipment billing

This page defines what counts as a billable shipment when using Safecube tracking services: the Safecube platform, the Webhooks API and the Container Tracking API. It also shows where an Owner or an Admin sees the shipments counted in each billing period. Short answers to frequent billing questions are in the Billing and plans FAQ.

Billing periods

A Safecube plan is billed by period of one month, starting on the day of the subscription. A workspace that subscribed on 5 October has periods from 5 October to 5 November, then from 5 November to 5 December, and so on. The end of the current period is the Next billing tile of Settings > Monitoring.

When a shipment is counted

A shipment is counted at most once per period:

  • when it is created, in the app or through the API: it is counted in the current period;
  • at the start of each new period, if it is still tracked at that moment: it is counted again in the new period.

A shipment created on 10 October and still tracked on 5 November is counted in the October period and in the November period.

Definition of a shipment

A shipment is a unique shipment number: a container number, a bill of lading (BL) number or a booking (BK) number.

Cases that count as a single shipment

  • Several tracking channels: a shipment tracked through webhooks, the Container Tracking API and the Safecube platform counts as one shipment.
  • Different shipment types or sealines: tracking the same shipment number with different shipmentType values or different sealines does not create additional billable shipments.
  • Tracking by BL or booking: a bill of lading or a booking counts as one shipment, whatever the number of containers attached to it, as long as they stay attached to it. It is the most cost-effective way to track shipments in Safecube.

Cases that count as several shipments

A bill of lading and its containers each created as separate shipments each count as a shipment. For example, one BL created, then its five containers created again on their own, count as six shipments.

Non-billable and billable shipments without data

  • A shipment for which Safecube never successfully contacts the shipping line is not billed.
  • A shipment for which the shipping line is contacted successfully but returns no data, for example because the shipment was cancelled, is billed.

When billing stops

A shipment is no longer counted in a new period once:

  • it has reached the Delivered status and has received no new event for 7 days;
  • it has been archived, manually or automatically. A shipment is archived automatically 30 days after it reaches Delivered, and an archived shipment is no longer billed, even if it was still in progress.

Archiving is described in Shipment archiving, and the updates of a delivered shipment in Update frequency.

Safecube platform and Webhooks API

The Safecube platform and the Webhooks API track added shipments continuously and automatically, so their billing stops under the conditions above.

Container Tracking API

The Container Tracking API only tracks a shipment when it is called. To stop being billed for a shipment, stop calling the Container Tracking API with its shipment number.

See the billed shipments

Settings > Monitoring is open to Owners and Admins.

  1. Select Settings at the bottom of the sidebar, then Monitoring under Workspace Settings.
  2. On the Your plan tab, the table lists the shipments counted in the current period, with their Shipment number and Counted on, the date they were counted. Both columns can be sorted, 10 rows per page.
  1. For a past period, open the Billing history tab and select the eye icon, View shipment consumptions, on its row.

The Billed shipments dialog lists the shipments of that period, with Search shipments on the shipment number and Export CSV. A search with no match reads "No shipments found".

Export the billed shipments

Select Export CSV in the Billed shipments dialog, or the download icon, Export shipment consumptions, on a row of Billing history. The file Safecube_Billing_Export.csv has two columns: shipmentNumber and createdAt, the date the shipment was counted.

Limits

  • Every export is named Safecube_Billing_Export.csv, whatever the period.
  • The table and the export do not say why a shipment was counted, at creation or at the start of the period.
  • A workspace in free trial does not see the table of counted shipments.

For questions about tracked shipments and billing, contact the Safecube support team.