Skip to content

Latest commit

 

History

History
123 lines (84 loc) · 3.16 KB

ups-tracking-api-php.md

File metadata and controls

123 lines (84 loc) · 3.16 KB

UPS Tracking API - PHP

Use PHP to track UPS shipments with UPS Tracking API.

Features

  • Real-time UPS tracking.
  • Batch UPS tracking.
  • Other features to manage your UPS tracking.

Installation

Installation is easy:

$ composer require trackingmore/trackingmore-sdk-php

Quick Start

Get the API key:

To use this API, you need to generate your API key.

  • Click here to access TrackingMore admin.
  • Go to the "Developer" section.

  • Click "Generate API Key".

  • Give a name to your API key, and click "Save" .

Then, start to track your UPS shipments.

Usage

Create a tracking (Real-time tracking):

  require('vendor/autoload.php');

  use Trackingmore\TrackingMoreException;
  use TrackingMore\Trackings;
    
  $key = 'your api key';
  $response = null;
  $trackings = new Trackings($key);
  
  try {
    $params = ['tracking_number'=>'802608005721255486','courier_code'=>'ups'];
    $response = $trackings->createTracking($params);
  } catch (TrackingMoreException $e) {
    echo $e->getMessage();
  }

  print_r($response);

Create trackings (Max. 40 tracking numbers create in one call):

    require('vendor/autoload.php');

    use Trackingmore\TrackingMoreException;
    use TrackingMore\Trackings;
    
    $key = 'your api key';
    $response = null;
    $trackings = new Trackings($key);
    
    try {
        $params = [
            ['tracking_number'=>'1ZC6G8280303220451','courier_code'=>'ups'],
            ['tracking_number'=>'1ZR8E2200404839077','courier_code'=>'ups']
        ];
        $response = $trackings->batchCreateTrackings($params);
    } catch (TrackingMoreException $e) {
        echo $e->getMessage();
    }
    
    print_r($response);

Get status of the shipment:

require('vendor/autoload.php');

use Trackingmore\TrackingMoreException;
use TrackingMore\Trackings;

$key = 'your api key';
$response = null;
$trackings = new Trackings($key);

try {
    $params = ['courier_code'=>'ups','created_date_min'=>'2023-08-23T06:00:00+00:00','created_date_max'=>'2023-09-05T07:20:42+00:00'];
    $response = $trackings->getTrackingResults($params);
} catch (TrackingMoreException $e) {
    echo $e->getMessage();
}

print_r($response);

Update a tracking by ID:

require('vendor/autoload.php');

use Trackingmore\TrackingMoreException;
use TrackingMore\Trackings;

$key = 'your api key';
$response = null;
$trackings = new Trackings($key);

try {
    $params = ['customer_name'=>'New name','note'=>'New tests order note'];
    $idString = '9a2f732e29b5ed2071d4cf6b5f4a3d19';
    $response = $trackings->updateTrackingByID($idString,$params);
} catch (TrackingMoreException $e) {
    echo $e->getMessage();
}

print_r($response);