Pitney Bowes Receiving APIs Overview

The Pitney Bowes Receiving APIs help manage packages from the moment they arrive at a facility until they are delivered to the final recipient. These APIs allow organizations to track, update, and store package details, helping to manage internal package handling efficiently.

Why Receiving APIs

  1. Track every package from arrival to final delivery.
  2. Maintain a complete history of package status and movements.
  3. Update the current package details.
  4. Quickly find packages within the system using tracking numbers or other search criteria.

How Receiving APIs Work

When a package arrives at a facility, it may have a barcode that either includes a tracking number or does not.

  1. If the barcode contains a tracking number:
    • The system searches for an existing package with the same tracking number.
    • If no package exists, a new package entry is created.
  2. If the package does not have a tracking number:
    • A new tracking number is generated.
    • A new package entry is created.
  3. Once package added to the system, It can be tracked, and its details can be updated to reflect its current status, location, or latest activity.
  4. When the package is delivered to its destination, it can be archived for record-keeping.

Step-by-Step Workflow for Receiving APIs

This section provides a structured process for handling packages using the Pitney Bowes Receiving APIs.

Step 1: Decode the Barcode on a Package

  1. Packages with barcodes must be scanned first.
  2. If the barcode contains a tracking number, use the Decode Tracking Number API to extract key details, such as:
    • Tracking number
    • Package type
    • Carrier service
    • Sender and receiver information
    • Current location
  3. The Decode API supports 2D barcodes.

Step 2: Generate a Unique Tracking Number (If Required)

  1. If a package does not have a tracking number, the user first needs to assign a unique tracking number to the package.
  2. The Generate Tracking Number API creates a unique tracking number, which serves as an identifier throughout the package lifecycle.

Step 3: Add Package to the System

  1. Every package must be added to the system using its tracking number.
  2. The system verifies that no duplicate tracking number exists. If a duplicate is found, an error is returned.
  3. Upon successful addition, the package is assigned a unique Package ID for tracking.
  4. The package is linked to relevant sender and receiver information.

Additional Information to add a Package:

Tracking Number: Each package must have a unique tracking number.

Contact ID:

  • Contacts can be of three types: Sender, Receiver, and Given To.
  • Contacts must be created first using the Add Contact API (Address Book APIs).
  • Once added, the system generates a unique Contact ID for each contact, which is used when adding a package.

Custom Fields: Additional custom details can be associated with the package. Fetch the Custom fields using the Get Custom Field API.

Inbound Site ID: If the package needs to be linked to an inbound site location, fetch the associated Inbound Site ID using the Get Inbound Sites APIs.

Step 4: Search for a Package in the System

Users can find specific packages using the Search Package API by entering tracking numbers, statuses, or metadata. This API locates packages that are in transit, waiting for pickup, or already delivered.

Step 5: Retrieve Package Details

Use the Get Package API to fetch detailed information about a package.

  1. The package can be retrieved using either its unique package ID or tracking number.
  2. The response includes the package's history, current status, current location, and latest activity.

Step 6: Update Package Information

Packages undergo several status changes as they move through the system. The Update Package API allows to:

  1. Update package details such as status, location, sender, receiver, and confirmation methods.
  2. Mark packages as DAMAGED, ARCHIVED, RECEIVED, or DELIVERED.
  3. Record location changes, damage reports, or special handling requirements.
  4. Attach images for proof of receipt.
  5. Assign a package to a specific recipient within an organization.

Step 7: Archive a Package

  1. Once a package has reached its final recipient, it can be archived for record keeping using the Archive Package API.
  2. The Archive Package API removes the package from active workflows while maintaining its record for future reference.

Retrieve Carrier List

  1. Get a list of carriers associated with specific locations using Carrier List API.
  2. This helps in knowing which carriers are responsible for incoming shipments at different facilities