RouteXpress-BD

NPM Stats & Info

A Node.js library to unify and manage courier services in Bangladesh (Steadfast, Pathao, REDX).

Features

• Unified API for multiple courier providers (Steadfast, Pathao, REDX)
• Create single or bulk orders
• Fetch order status by consignment ID, invoice, or tracking code
• Manage Pathao tokens, stores, and locations
• Steadfast return requests, payments, and police stations
• REDX store management, parcel tracking, and price calculation
• Get Steadfast account balance
• Price calculation for Pathao and REDX orders

Installation

Install with npm or pnpm:

npm install routexpress-bd
# or
pnpm add routexpress-bd

Getting Started

Import and Initialize

import RouteXpress from "routexpress-bd";

const client = new RouteXpress({
  steadfast: {
    apiKey: "YOUR_STEADFAST_API_KEY",
    apiSecret: "YOUR_STEADFAST_API_SECRET",
  },
  pathao: {
    apiKey: "YOUR_PATHAO_API_KEY",
    apiSecret: "YOUR_PATHAO_API_SECRET",
    username: "YOUR_PATHAO_USERNAME",
    password: "YOUR_PATHAO_PASSWORD",
  },
  redx: {
    apiKey: "YOUR_REDX_API_KEY",
    environment: "production", // or "development"
  },
});

You can configure one, two, or all three providers. At least one must be configured.

API Reference & Usage Examples

Steadfast

1. Create Order

const response = await client.createOrder("steadfast", {
  order_details: {
    invoice: "INV90444w0144",
    recipient_name: "John Doe",
    recipient_phone: "01712344578",
    recipient_address: "123 Main Street, Dhaka",
    cod_amount: 1000,
    note: "Deliver within 3 PM",
    alternative_phone: "01712345678",
    recipient_email: "[email protected]",
    item_description: "Electronics",
    total_lot: 1,
    delivery_type: 0, // 0 = home delivery, 1 = point delivery/hub pickup
  },
});
console.log("Steadfast Order Response:", response);

2. Create Bulk Order

const response = await client.createBulkOrder("steadfast", {
  orders: [
    {
      invoice: "INV0094e8981",
      recipient_name: "John Doe",
      recipient_phone: "01712345678",
      recipient_address: "123 Main Street, Dhaka",
      cod_amount: 1000,
    },
    {
      invoice: "INV009849e82",
      recipient_name: "Jane Smith",
      recipient_phone: "01787654321",
      recipient_address: "456 Elm Street, Chittagong",
      cod_amount: 2000,
    },
  ],
});
console.log("Bulk Order Response:", response);

3. Get Order Status

By Consignment ID

const response = await client.getOrderStatus({
  provider: "steadfast",
  data: { consignment_id: "DT0905255BZNFQ" },
});
console.log("Response:", response);

By Invoice

const response = await client.statusByInvoice("INV90444344w0144");
console.log("Response:", response);

By Tracking Code

const response = await client.statusBytrackingcode("88D026EF9");
console.log("Response:", response);

4. Get Steadfast Balance

const response = await client.getSteadFastBalance();
console.log("Response:", response);

5. Create Return Request

const response = await client.createSteadfastReturnRequest({
  consignment_id: 10000042,
  reason: "Customer requested return",
});
console.log("Response:", response);

You can identify the consignment using any one of consignment_id, invoice, or tracking_code.

6. Get Single Return Request

const response = await client.getSteadfastReturnRequest(1);
console.log("Response:", response);

7. Get All Return Requests

const response = await client.getSteadfastReturnRequests();
console.log("Response:", response);

8. Get Payments

const response = await client.getSteadfastPayments();
console.log("Response:", response);

9. Get Single Payment with Consignments

const response = await client.getSteadfastSinglePayment(1);
console.log("Response:", response);

10. Get Police Stations

const response = await client.getSteadfastPoliceStations();
console.log("Response:", response);

Pathao

1. Create Access Token

const response = await client.createPathaoToken();
console.log("Access Token:", response.access_token);

2. Refresh Token

const accessTokenResponse = await client.createPathaoToken();
const refreshToken = accessTokenResponse.refresh_token;
const response = await client.createPathaoRefreshToken(refreshToken);
console.log("Response:", response);

3. Create Order

const response = await client.createOrder("pathao", {
  authToken: "YOUR_PATHAO_AUTH_TOKEN",
  store_id: 148430,
  merchant_order_id: "ORD123456",
  recipient_name: "John Doe",
  recipient_phone: "01712325678",
  recipient_address: "123 Main Street, Dhaka",
  recipient_city: 1,
  recipient_zone: 1,
  recipient_area: 1,
  delivery_type: 48,
  item_type: 2,
  special_instruction: "Handle with care",
  item_quantity: 1,
  item_weight: 0.5,
  item_description: "Electronics",
  amount_to_collect: 1000,
});
console.log("Pathao Order Response:", response);

4. Create Bulk Order

const response = await client.createBulkOrder("pathao", {
  authToken: "YOUR_PATHAO_AUTH_TOKEN",
  orders: [
    {
      store_id: 148430,
      merchant_order_id: "ORD123456",
      recipient_name: "John Doe",
      recipient_phone: "01712342578",
      recipient_address: "123 Main Street, Dhaka",
      recipient_city: 1,
      recipient_zone: 1,
      recipient_area: 1,
      delivery_type: 48,
      item_type: 2,
      special_instruction: "Handle with care",
      item_quantity: 1,
      item_weight: 0.5,
      item_description: "Electronics",
      amount_to_collect: 1000,
    },
  ],
});
console.log("Bulk Order Response:", response);

5. Get Order Status by Consignment ID

const response = await client.getOrderStatus({
  provider: "pathao",
  data: {
    consignment_id: "DT0905255BZNFQ",
    authToken: "YOUR_PATHAO_AUTH_TOKEN",
  },
});
console.log("Response:", response);

6. Create Store

const response = await client.createPathaoStore("YOUR_PATHAO_AUTH_TOKEN", {
  name: "My Store",
  contact_name: "John Doe",
  contact_number: "01712345678",
  secondary_contact: "01787654321",
  address: "123 Main Street, Dhaka",
  city_id: 1,
  zone_id: 1,
  area_id: 1,
});
console.log("Store Name:", response.store_name);

7. Get All Stores

const response = await client.getAllPathaoStore("YOUR_PATHAO_AUTH_TOKEN");
console.log("Response:", response);

8. Get Cities

const response = await client.getPathaoCity("YOUR_PATHAO_AUTH_TOKEN");
console.log("Response:", response);

9. Get Zones

const response = await client.getPathaoZone("YOUR_PATHAO_AUTH_TOKEN", 1);
console.log("Response:", response);

10. Get Areas

const response = await client.getPathaoArea("YOUR_PATHAO_AUTH_TOKEN", 1);
console.log("Response:", response);

11. Price Calculation

const response = await client.price_plane("YOUR_PATHAO_AUTH_TOKEN", {
  store_id: 148430,
  item_type: 2,
  recipient_city: 1,
  recipient_zone: 1,
  recipient_area: 1,
  delivery_type: 48,
  item_weight: 5,
  item_quantity: 1,
  amount_to_collect: 1000,
});
console.log("Response:", response);

REDX

1. Create Order

const response = await client.createOrder("redx", {
  customer_name: "John Doe",
  customer_phone: "01712345628",
  delivery_area: "Dhaka",
  delivery_area_id: 1,
  customer_address: "123 Main Street, Dhaka",
  merchant_invoice_id: "INV123456",
  cash_collection_amount: "1000",
  parcel_weight: "2",
  instruction: "Handle with care",
  value: "1500",
  pickup_store_id: "504839",
  parcel_details_json: [
    { name: "Electronics Item 1", category: "Electronics", value: "1000" },
  ],
});
console.log("Redx Order Response:", response);

2. Create Store

const response = await client.createRedXStore({
  name: "My Store",
  address: "123 Main Street, Dhaka",
  phone: "01712345678",
  area_id: "1",
});
console.log("Store Response:", response);

3. Track Parcel by Tracking Code

const response = await client.trackParcelByTrackingCode("25A510SA18UXL7");
console.log("Response:", response);

4. Get Parcel Info by Tracking Code

const response = await client.getParcelInfoByTrackingCode("25A510SA18UXL7");
console.log("Response:", response);

5. Update Parcel

const response = await client.updateParcel("25A510SA18UXL7", {
  property_name: "status",
  new_value: "cancelled",
  reason: "Customer requested change",
});
console.log("Response:", response);

6. Get All Stores

const response = await client.getRedXStores();
console.log("Response:", response);

7. Get Pickup Store Info

const response = await client.getPickupStoreInfo("504839");
console.log("Response:", response);

8. Get Area List

const response = await client.getRedXAreaList();
console.log("Response:", response);

9. Get Area by Postcode

const response = await client.getResXAreabyPostcode("1204");
console.log("Response:", response);

10. Get Area by District Name

const response = await client.getRedXAreaBYDistrict_name("Dhaka");
console.log("Response:", response);

11. Calculate Price

const response = await client.calculateRedXPrice({
  delivery_area_id: 1,
  pickup_area_id: 1,
  cash_collection_amount: 1000,
  weight: 2,
});
console.log("Response:", response);

Error Handling

All methods throw errors on failure. Use try/catch to handle errors:

try {
  const response = await client.createOrder("steadfast", orderData);
} catch (err) {
  console.error(err);
}

Best Practices

• Always keep your API keys and tokens secure. Do not hardcode them in production code.
• Use async/await and proper error handling for all API calls.
• Refer to the official documentation of each courier for more details on their specific requirements.

License

MIT

For more details, see the test/main.ts file for real usage examples.