PHPackages                             naqel/sdk - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. naqel/sdk

ActiveLibrary[API Development](/categories/api)

naqel/sdk
=========

A PHP wrapper for Naqel's API

v0.1.7(5y ago)2209MITPHPPHP >=7.4

Since Jan 22Pushed 5y ago1 watchersCompare

[ Source](https://github.com/naqel/naqel-php)[ Packagist](https://packagist.org/packages/naqel/sdk)[ Docs](http://github.com/naqel/naqel-php)[ RSS](/packages/naqel-sdk/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (3)Versions (12)Used By (0)

naqel-php
=========

[](#naqel-php)

[![Build Status](https://camo.githubusercontent.com/ac08b36c10ca94914f72711b0a84aff424c5423b87c3afb3dbd4b6efb18e6e75/68747470733a2f2f7472617669732d63692e636f6d2f6e6171656c2f6e6171656c2d7068702e706e673f6272616e63683d6d61696e)](https://travis-ci.com/naqel/naqel-php)[![Packagist](https://camo.githubusercontent.com/3b2d91f7bac7dc0e9140360f5f05664d3ac8306aaa4cf40440a614f4b81cdd23/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6e6171656c2f73646b2e737667)](https://packagist.org/packages/naqel/sdk)[![Packagist](https://camo.githubusercontent.com/5fb39c1b1cdb764cb677644c70553c6e691b8c19b432fd18f7801f283856882d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6e6171656c2f73646b2e737667)](https://packagist.org/packages/naqel/sdk)

Documentation
-------------

[](#documentation)

The documentation for the Naqel API can be found [here](https://infotrack.naqelexpress.com/NaqelAPIServices/NaqelAPI/9.0/XMLShippingService.asmx).

### Supported PHP Versions

[](#supported-php-versions)

This library supports the following PHP implementations:

- PHP 7.4
- PHP 8.0

Installation
------------

[](#installation)

You can install **naqel-php** via a composer or by downloading the source.

### Via Composer:

[](#via-composer)

**naqel-php** is available on Packagist as the [`naqel/sdk`](https://packagist.org/packages/naqel/sdk) package:

```
composer require naqel/sdk

```

Quickstart:
-----------

[](#quickstart)

Set the configurations with your credential and information:

```
$naqel = new \Naqel\Naqel([
    'use_sandbox' => true,
    'client_id'   => '[YOUR_CLIENT_ID]',
    'password'    => '[YOUR_CLIENT_PASSWORD]',
    'version'     => '9.0',
]);

// Set your address
$clientAddress = (new \Naqel\Models\ClientAddress())
    ->setPhoneNumber('0555555555')
    ->setFirstAddress('King Abdulaziz Street')
    ->setCountryCode('KSA')
    ->setCityCode('RUH');

// Set your contact
$clientContact = (new \Naqel\Models\ClientContact())
    ->setName('Mohammad')
    ->setPhoneNumber('05xxxxxxxx');

// Attach both address and contact to Naqel instance
$naqel->setClientAddress($clientAddress);
$naqel->setClientContact($clientContact);
```

Set Consignee Info:

```
$consigneeInfo = (new \Naqel\Models\ConsigneeInfo())
    ->setConsigneeName('Abdullah')
    ->setPhoneNumber('05xxxxxxxx')
    ->setAddress('King Salman Street')
    ->setCountryCode('KSA')
    ->setCityCode('RUH');
```

Set Manifest Shipment:

```
$manifestShipment = (new \Naqel\Models\ManifestShipment())
    ->setConsigneeInfo($consigneeInfo)
    ->setBillingType(\Naqel\Constants\BillingType::ON_ACCOUNT)
    ->setLoadTypeID(\Naqel\Constants\LoadType::NON_DOCUMENT)
    ->setPiecesCount(1)
    ->setWeight(1.0);
```

Create a New Waybill w/ Manifest:

```
$waybill = \Naqel\Waybill::create($manifestShipment);
```

Or you can get a waybill instance by its number

```
$waybill = \Naqel\Waybill::create($waybill->number());
```

Get the waybill number:

```
$waybillNumber = $waybill->number();
```

Get the waybill sticker as a PDF content:

```
$sticker = $waybill->printSticker(
    \Naqel\Constants\StickerSize::FourMFourInches
);
```

Versioning
----------

[](#versioning)

`naqel-php` uses a [SemVer](https://semver.org/) for versioning. For the versions available, see the [tags on this repository](https://github.com/naqel/naqel-php/tags).

Contributing
------------

[](#contributing)

Please read [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests to us.

License
-------

[](#license)

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~2 days

Total

11

Last Release

1917d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/1556b00c7301eefff0295fd137af54f29d0b7aafae02882ae644203301d4e64f?d=identicon)[mtawil](/maintainers/mtawil)

---

Top Contributors

[![mtawil](https://avatars.githubusercontent.com/u/700753?v=4)](https://github.com/mtawil "mtawil (27 commits)")

---

Tags

apishippingnaqel

###  Code Quality

TestsPHPUnit

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/naqel-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/naqel-sdk/health.svg)](https://phpackages.com/packages/naqel-sdk)
```

###  Alternatives

[gabrielbull/ups-api

PHP UPS API

4642.4M10](/packages/gabrielbull-ups-api)[easypost/easypost-php

EasyPost Shipping API Client Library for PHP

1753.1M5](/packages/easypost-easypost-php)[shipengine/shipengine

PHP library for the ShipEngine API.

172.4k](/packages/shipengine-shipengine)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)