> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apps.lute.co.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom Store Integration

> How to integrate custom e-commerce backends, ERPs, or storefronts with Shipdesk.

# Custom Store Integration

For custom e-commerce backends (Node.js, Python, Laravel, Go, Java), integration is straightforward using our Public REST API and Outbound Webhooks.

```mermaid theme={null}
sequenceDiagram
  participant Store as Your Store / ERP
  participant Shipdesk as Shipdesk API
  participant Courier as Courier Partner

  Store->>Shipdesk: POST /v1/rates (check quotes & serviceability)
  Store->>Shipdesk: POST /v1/orders (create order)
  Store->>Shipdesk: POST /v1/orders/{id}/assign (assign courier)
  Shipdesk->>Courier: Call carrier API (issue AWB)
  Courier-->>Shipdesk: AWB confirmed
  Shipdesk-->>Store: 200 OK (awb, carrier, mode, status)
  Store->>Shipdesk: GET /v1/orders/{id}/label (download PDF)
  Note over Courier,Shipdesk: Later: courier moves parcel
  Courier->>Shipdesk: Tracking webhook scan
  Shipdesk->>Store: Outbound webhook (shipment.status)
```

***

## Recommended Integration Flow

1. **Order Capture**: When a customer places an order on your site, call `POST /v1/orders` to stage the shipment.
2. **Carrier Selection**:
   * Use `POST /v1/couriers/available` to present carrier options and rates to your warehouse team, or
   * Use automated **Shipping Rules** configured in your Shipdesk dashboard to select the fastest or cheapest carrier automatically.
3. **Dispatch & Label**:
   * Call `POST /v1/orders/{id}/assign` to generate the AWB.
   * Stream or print the shipping label via `GET /v1/orders/{id}/label`.
4. **Subscribe to Webhooks**:
   * Listen for `shipment.status` to update your internal order tracking page.
   * Listen for `ndr.raised` to send automated WhatsApp/SMS alerts to customers to update their address or confirm reattempt dates.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.