MDM Express API for Node.js and PHP

Install

npm install @dz-delivery/core

composer require dz-delivery/sdk

Node.js ≥ 18 (zero dependencies) or PHP ≥ 8.2 (Guzzle 7). Every carrier implements the same interface, so the same code works with the others once the client is configured; some operations are not available on every carrier and throw NOT_SUPPORTED (see the capability matrix).

MDM Express credentials

MDM Express in TypeScript / Node.js

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

const mdm = createClient('mdm', {
  apiKey: process.env.MDM_API_KEY!,
  storeId: process.env.MDM_STORE_ID!,  // STR-…
});

try {
  const quote = await mdm.getFees({ toWilayaId: 16, toCommuneId: 'Bab Ezzouar' });

  const parcel = await mdm.createParcel({
    recipientName: 'Mohamed Amine',
    phone: '0550123456',
    address: 'Cité 221 lots, n°98',
    wilayaId: 16,
    communeName: 'Bab Ezzouar',
    // products stocked at MDM: their catalog id (PRD-…)
    productList: [{ name: 'T-shirt', quantity: 1, productId: 'PRD-B5C63A' }],
    price: 2500,
  });

  const { parcel: current, events } = await mdm.track(parcel.trackingNumber);

  // Delivered parcels, filtered by MDM
  const delivered = await mdm.listParcels({ status: 'delivered', pageSize: 50 });
} catch (err) {
  if (isShippingError(err)) console.error(err.code, err.message);
}

MDM Express in PHP / Laravel

use DzDelivery\ClientFactory;
use DzDelivery\Errors\ShippingError;

$mdm = ClientFactory::create('mdm', [
    'apiKey'  => getenv('MDM_API_KEY'),
    'storeId' => getenv('MDM_STORE_ID'),
]);

try {
    $parcel = $mdm->createParcel([
        'recipientName' => 'Mohamed Amine',
        'phone'         => '0550123456',
        'address'       => 'Cité 221 lots, n°98',
        'wilayaId'      => 16,
        'communeName'   => 'Bab Ezzouar',
        'productList'   => [['name' => 'T-shirt', 'quantity' => 1, 'productId' => 'PRD-B5C63A']],
        'price'         => 2500,
    ]);

    $result = $mdm->track($parcel->trackingNumber);
} catch (ShippingError $e) {
    echo "{$e->code}: {$e->getMessage()}";
}

Full PHP guide (Laravel, errors, testing): PHP guide.

Supported methods

MDM Express statuses → unified statuses

The SDK maps MDM status slugs (read live from GET /api/v2/shipping/parcels/metadata, October 2026) to unified statuses. The status filter of listParcels uses the same table: every MDM slug of the requested status is filtered by MDM.

Full list of unified statuses and what they mean: SDK statuses.

Good to know about the MDM Express API

• Tested live (October 2026, read-only): wilayas, communes, offices, fees, list, tracking, errors.
• Fulfillment: MDM ships products stocked in its own warehouse. Every productList line must carry its MDM catalog id; an unknown product → VALIDATION_ERROR on productList.
• price is what the recipient pays: MDM adds no delivery fee on top.
• MDM has no “order reference” field: orderId is written to the notes (Ref: …). The MDM search API has no filter for it, so the SDK filters orderId on each page it reads: use listParcels({ orderId, allPages: true }) ('allPages' => true in PHP) to search every page, not just the first one.
• The baseUrl must use HTTPS.

Detailed native mapping (endpoints, fields, statuses): PROVIDERS.md.

MDM Express FAQ

Other carriers

Same interface, same normalized statuses (pending, in_transit, delivered…).

• Yalidine API
• ZRExpress API
• Maystro API
• Ecotrack · DHD API
• NoEST API
• E-com Delivery API
• Elogistia API
• Full documentation