PHPackages                             akika/laravel-weevo - 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. akika/laravel-weevo

ActiveLibrary[API Development](/categories/api)

akika/laravel-weevo
===================

Weevo package for Laravel to allow merchants to connect

0.0.6(4d ago)0233↑137.5%MITPHPPHP ^8.0

Since Feb 10Pushed 4d agoCompare

[ Source](https://github.com/akikadigital/laravel-weevo)[ Packagist](https://packagist.org/packages/akika/laravel-weevo)[ Docs](https://github.com/Akika-Digital/laravel-weevo)[ RSS](/packages/akika-laravel-weevo/feed)WikiDiscussions main Synced 3d ago

READMEChangelog (6)Dependencies (12)Versions (7)Used By (0)

Laravel Weevo Package by [Akika Digital](https://akika.digital)
---------------------------------------------------------------

[](#laravel-weevo-package-by-akika-digital)

The Laravel Weevo package allows you to connect your application with the Weevo last mile delivery app.

The package automatically requests and caches the Weevo access token using the configured token TTL. You do not need to manually call `authenticate()` before creating deliveries.

System Requirements
-------------------

[](#system-requirements)

- PHP 8.1 or later
- Laravel 10.x, 11.x or 12.x

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

[](#installation)

You can install the package via composer:

```
composer require akika/laravel-weevo
```

After installing the package, publish the configuration file using the following command:

```
php artisan weevo:install
```

You can also run the following command to publish the config file

```
php artisan vendor:publish --tag=weevo-config
```

The configuration file will be published to:

```
config/weevo.php

```

Laravel automatically discovers the package. No additional service provider registration is required.

ENV Variables
-------------

[](#env-variables)

You can add the following variables to your env file. Make sure to add the requested information.

```
WEEVO_ENV=production
WEEVO_DEBUG=true
WEEVO_USERNAME=
WEEVO_API_KEY=
WEEVO_API_SECRET=
WEEVO_VERIFY_SSL=true #Option to validate. Make it false for local tests
WEEVO_TIMEOUT=30 # Default is 30
WEEVO_TOKEN_TTL=3300 # Used by the token. Default is 3300
WEEVO_RETRY_TIMES=2
WEEVO_RETRY_SLEEP=500
WEEVO_SANDBOX_URL=https://sandbox.example.com/api
WEEVO_PRODUCTION_URL=https://example.com/api
```

Facade Import
-------------

[](#facade-import)

```
use Akika\LaravelWeevo\Facades\Weevo;
```

Initialize library
------------------

[](#initialize-library)

Use the following snippet to use credentials in the config file

```
Weevo::default();
```

Use the following snippet to define the variables. Fit for multivendor support

```
$credentials = [
    'username' => 'CUSTOM_USERNAME',
    'api_key' => 'CUSTOM_API_KEY',
    'api_secret' => 'CUSTOM_API_SECRET',
];
$response = Weevo::using($credentials)
    ->createDelivery($sampleDeliveryData);
```

You can also use the credentials class as shown below:

```
use Akika\LaravelWeevo\Support\WeevoCredentials;

$response = Weevo::using(
    new WeevoCredentials(
        username: 'CUSTOM_USERNAME',
        apiKey: 'CUSTOM_API_KEY',
        apiSecret: 'CUSTOM_API_SECRET',
    )
)->createDelivery($sampleDeliveryData);
```

Create Delivery
---------------

[](#create-delivery)

Use the following function to create a delivery

```
$sampleDeliveryData = [
    "externalId" => "1234562",
    "externalShipmentId" => "1234562",
    "branch" => 'WB-00001',
    "rider" => null, //"WR-00007", // If not set, the system will assign the rider
    "dropoff" => [
        "name" => "Jane Smith",
        "phone" => "+254700000001",
        "email" => "janesmith@example.com",
        "address" => "456 Elm St, Nairobi",
        "latitude" => -1.2921,
        "longitude" => 36.8219
    ],
    'orderValue' => 300, // Optional
    "package" => [
        "weight" => 1.5,
        "dimensions" => [
            "length" => 30,
            "width" => 20,
            "height" => 10
        ]
    ],
    'items' => [ // Optional
        [
            "name" => "Item 1",
            "sku" => "123234234",
            "quantity" => 1,
            "unitPrice" => 100
        ],
        [
            "name" => "Item 2",
            "sku" => "123234235",
            "quantity" => 2,
            "unitPrice" => 200
        ]
    ],
    'vehicleType' => 'motor_bike', // Optional: bike, motor_bike, car, van, truck
    'amountCharged' => 300, // Optional
    'instructions' => 'Deliver on time', // As requested by the customer
    'slotStartAt' => '2024-06-01 10:00:00', // Optional
    'slotEndAt' => '2024-06-01 12:00:00', // Optional
    'invoicedAt' => '2024-06-01 09:00:00', // Optional
    'deliveryMode' => 'standard', // Optional
    'paymentReceivedAt' => '2024-06-01 08:00:00', // Optional
];
$response = Weevo::default()->createDelivery($sampleDeliveryData);
```

6. Mention date format
----------------------

[](#6-mention-date-format)

You use several dates.

State once:

```
> All date fields should be supplied in `Y-m-d H:i:s` format.
```

Get delivery details
--------------------

[](#get-delivery-details)

To show delivery details, pass the trip\_id in the function below:

```
$response = Weevo::default()->getDelivery("TRIP-260630-003101-7054");
```

Update Payment Status
---------------------

[](#update-payment-status)

Pass the data as shown below to update the delivery payment status

```
$result = Weevo::default()->updatePaymentStatus(
    "TRIP-260630-003101-7054",
    [
        'paymentStatus' => 'paid', // Example update data
        'paymentReceivedAt' => '2024-06-01 08:00:00' // Example update data
    ]
);
```

Delivery Statuses
-----------------

[](#delivery-statuses)

Below are the available statuses

```
case Pending = 'pending';
case Assigned = 'assigned';
case Picked = 'picked';
case InTransit = 'in_transit';
case DeliveryInitiated = 'delivery_initiated';
case PaymentRequested = 'payment_requested';
case Delivered = 'delivered';
case Failed = 'failed';
case Cancelled = 'cancelled';
case Returning = 'returning';
case Returned = 'returned';
```

### Sample Response

[](#sample-response)

All methods return json on success.

```
[
    'success' => true,
    'message' => 'Delivery created successfully.',
    'tripId' => 'TRIP-260630-003101-7054',
]
```

Error Handling
--------------

[](#error-handling)

All methods return `null` when the request fails.

```
$response = Weevo::default()->createDelivery($data);

if ($response === null) {
    // Request failed
}
```

Quality Assurance
-----------------

[](#quality-assurance)

The package is fully tested using Pest PHP and PHPUnit.

### Test Coverage

[](#test-coverage)

Current test coverage:

- ✅ 100% Line Coverage
- ✅ 100% Method Coverage
- ✅ 100% Class Coverage
- ✅ 100% Branches Coverage

Main coverage report:

[![Coverage Report](coverage.png)](coverage.png)

License
-------

[](#license)

This package is licensed under the MIT License.

###  Health Score

40

—

FairBetter than 86% of packages

Maintenance99

Actively maintained with recent releases

Popularity15

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity34

Early-stage or recently created project

 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 ~28 days

Total

6

Last Release

4d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/3b9d9e3a6ef73a3692c261d49a7a70d0362c5e83fa9a4e8765eb9309173b59b3?d=identicon)[akika.digital](/maintainers/akika.digital)

---

Top Contributors

[![fenicfelix](https://avatars.githubusercontent.com/u/7171039?v=4)](https://github.com/fenicfelix "fenicfelix (21 commits)")

---

Tags

shoppingcourierAkikaweevo

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/akika-laravel-weevo/health.svg)

```
[![Health](https://phpackages.com/badges/akika-laravel-weevo/health.svg)](https://phpackages.com/packages/akika-laravel-weevo)
```

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3355.3M346](/packages/psalm-plugin-laravel)[spatie/laravel-export

Create a static site bundle from a Laravel app

674146.0k6](/packages/spatie-laravel-export)[simplestats-io/laravel-client

Server-side analytics for Laravel that follows the full funnel from visit to registration to payment, attributed to the channel that drove it. Revenue, MRR, churn and ad-spend profit (ROAS/CAC) per channel. GDPR compliant, ad-blocker proof.

5022.0k](/packages/simplestats-io-laravel-client)[defstudio/telegraph

A laravel facade to interact with Telegram Bots

816333.9k3](/packages/defstudio-telegraph)[jasara/php-amzn-selling-partner-api

A fluent interface for Amazon's Selling Partner API in PHP

1348.7k1](/packages/jasara-php-amzn-selling-partner-api)[fleetbase/core-api

Core Framework and Resources for Fleetbase API

1235.9k20](/packages/fleetbase-core-api)

PHPackages © 2026

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