Overview

Use the ShipmentListAPIV3 and ShipmentAPIV3 to manage your shipments.

Shipments

A shipment in byrd is the object composed by a packaging and a product or products that have to be picked and packed in the warehouse to be sent through a carrier to a specific recipient.

Shipment status and sub-status

Once the shipment is created it can go through different status and sub-status:

Status

Description

Possible sub-status

new

The shipment was just created.

  • *validating_address** if enabled, address is being validated.
  • *address_invalidif enabled, address check failed.
recalled**

releasing

The shipment is being released to a warehouse.

released

The shipment was released to a warehouse.

  • *reserved:**stock is reserved.
  • *allocating:** stock is being allocated for picking.
  • *allocated:** stock is allocated to a picking action.
  • *assigned:** shipment is assigned to a warehouse worker to start picking.

picking

The items of the shipment are being picked.

packaging

The shipment is being packaged.

  • *error_resolved:** if an error occurs during packaging, this substatus indicates that was fixed so the warehouse can finish the packaging.

packaged

The shipment is already packaged and labeled.

Used for some B2B shipments:

  • *label_required:** manual label is required to be created.
  • *label_uploaded:** label was created and shipment is ready to label.
  • *manual_outbound:** shipment is ready to outbound .

sent

The carrier picked up the package.

  • *claim_reported:** a customer support ticket was opened for this shipment

delivered

The package was delivered to the recipient.

  • *claim_reported:** a customer support ticket was opened for this shipment

returning

A return shipment was created for this shipment.

returned

The return shipment has arrived to the warehouse.

deleted

The shipment was deleted.

Shipment types

There are two types of shipments:

  • B2C > shipments sent to end consumers or companies but with no special requirements.
  • B2B > shipments sent to companies or other non byrd warehouses which need special requirements like sending by pallet or fill a whole insurance value for the shipment.