Maystro Delivery API for Node.js and PHP

import { createClient, isShippingError } from '@dz-delivery/core';

const maystro = createClient('maystro', {
  apiToken: process.env.MAYSTRO_API_TOKEN!,
});

try {
  const wilayas = await maystro.getWilayas();
  const communes = await maystro.getCommunes(16);

  // Stop desks / pickup points: Maystro requires communeId
  const desks = await maystro.getStopDesks({ wilayaId: 16, communeId: communes[0].id });

  const quote = await maystro.getFees({ toWilayaId: 16, toCommuneId: communes[0].id });

  const parcel = await maystro.createParcel({
    recipientName: 'Mohamed Amine',
    phone: '0550123456',
    address: 'Cité 221 lots, n°98',
    wilayaId: 16,
    communeName: 'Bab Ezzouar',
    productName: 'T-shirt',
    price: 2500,
    orderId: 'ORDER-1001',
  });
  // use parcel.trackingNumber (or parcel.id) for track / cancelParcel
  const { events } = await maystro.track(parcel.trackingNumber);
} catch (err) {
  if (isShippingError(err)) console.error(err.code, err.message);
}

use DzDelivery\ClientFactory;

$maystro = ClientFactory::create('maystro', [
    'apiToken' => getenv('MAYSTRO_API_TOKEN'),
]);

$communes = $maystro->getCommunes(16);
$desks    = $maystro->getStopDesks(['wilayaId' => 16, 'communeId' => $communes[0]->id]);
$quote    = $maystro->getFees(['toWilayaId' => 16, 'toCommuneId' => $communes[0]->id]);

$parcel = $maystro->createParcel([
    'recipientName' => 'Mohamed Amine',
    'phone'         => '0550123456',
    'address'       => 'Cité 221 lots, n°98',
    'wilayaId'      => 16,
    'communeName'   => 'Bab Ezzouar',
    'productName'   => 'T-shirt',
    'price'         => 2500,
    'orderId'       => 'ORDER-1001',
]);
$tracked = $maystro->track($parcel->trackingNumber); // or $parcel->id

import { MaystroProvider } from '@dz-delivery/core';
import { writeFileSync } from 'node:fs';

const maystro = new MaystroProvider({ apiToken: process.env.MAYSTRO_API_TOKEN! });
const { data, labelCount } = await maystro.getLabels(['172316976800001']); // tracking numbers or parcel.id
writeFileSync('labels.pdf', data); // one page per order found

use DzDelivery\Models\ClientOptions;
use DzDelivery\Providers\MaystroProvider;

$maystro = new MaystroProvider(ClientOptions::fromArray(['apiToken' => getenv('MAYSTRO_API_TOKEN')]));
$labels  = $maystro->getLabels(['172316976800001']); // tracking numbers or $parcel->id
return response($labels->data, 200, ['Content-Type' => 'application/pdf']); // Laravel

import { mapMaystroStatus } from '@dz-delivery/core';

// check the URL secret first (not signed), then: event = JSON decoded from message.data (base64)
if (event.event === 'OrderStatusChanged') {
  const status = mapMaystroStatus(event.payload.status); // 41 → 'delivered'
  // update the order whose carrier_id = event.payload.id
}

use DzDelivery\Support\StatusMapper;

// $event = JSON decoded from message.data, after checking the URL secret
if (($event['event'] ?? null) === 'OrderStatusChanged') {
    $status = StatusMapper::maystro($event['payload']['status'] ?? null); // 41 → 'delivered'
}