# DMS Workflow

### System Activation and Module Configuration

1. **Enable XoroDMS App Setting**

Navigate to system settings and activate the XoroDMS App Setting to initialize the delivery management system. This single action triggers the automatic activation of all dependent modules and functionalities required for comprehensive delivery operations.

2. **Automatic Module Activation**

System automatically enables Delivery Truck Module, Shipment Delivery Module, and adds delivery- related fields to the Sales Order Centre and Invoice Centre. A new user type, "Truck Operator" is introduced to support field operations.

3. **DMS App Enablement**

Mobile application access is configured for truck operators, providing them with dedicated tools for managing deliveries in the field. This ensures seamless connectivity between ERP system and mobile operations.

The activation process is designed to be comprehensive yet straightforward, ensuring that all necessary components are properly configured without requiring extensive manual setup. Once activated, the system provides immediate access to all management features, allowing organizations to implement improved delivery workflows right away.

### **Workflow Overview**

**High-Level Flow:**

1. Enable XoroDMS and dependent modules.
2. Create Truck Operator users.
3. Configure Truck Master data.
4. Create Shipment Deliveries.
5. Execute deliveries via the DMS Mobile App.
6. Capture customer signatures.
7. Send proof-of-delivery and confirmation emails.
8. Review and verify deliveries in the Lookup Module.
9. Track delivery status and generate signed invoices in ERP.

### Truck Operator User Setup

**User Creation Options**

* Create independent Truck Operator users
* Link to existing ERP users for unified access
* Maintain consistent credential management
* Ensure security and ease of administration

**User Management Benefits**

Truck operators serve as the backbone of the delivery process, requiring proper setup and configuration to ensure smooth operations. The system supports both independent operator creation and integration with existing ERP users, providing flexibility in implementation approaches. When operators are linked to existing ERP users, they utilize the same credentials for both systems, eliminating the need for multiple login procedures and reducing administrative overhead.

<figure><img src="/files/zCyS3xqEs6bQZTFJSnYe" alt=""><figcaption></figcaption></figure>

### Delivery Truck Master Data Configuration

#### **Delivery Fleet & Vehicle Master Configuration**

**Truck Registration**

Create and maintain comprehensive records for all delivery vehicles using the **Delivery Truck** module. Each truck record captures essential vehicle details and operational parameters required for day-to-day delivery planning.

**Operator Assignment**

Assign a designated truck operator to each delivery vehicle to ensure clear accountability and defined responsibility for vehicle usage and management.

**License & Compliance Details**

Record license plate numbers and relevant regulatory information to ensure compliance and enable accurate vehicle identification throughout the delivery lifecycle.

With operators in place, administrators configure the **Delivery Truck Master Data**.

* Each truck record includes:
  * Assigned Truck Operator
  * License Plate details
* Trucks are linked to specific operators for accountability.

This configuration ensures that **every shipment has a responsible vehicle and driver** recorded in the ERP.

<figure><img src="/files/s1komQo1AXKrJScuvED0" alt=""><figcaption></figcaption></figure>

### Creating and Managing Shipment Deliveries

The **Shipment Delivery Module** enables businesses to transform orders into actionable deliveries.

#### **Order Selection**

Use comprehensive filters to identify shipped or partially shipped orders for delivery assignment based on customer location, priority, or delivery timing requirements.

#### **Assignment Method**

Select the appropriate assignment approach based on operational needs:

* **Add to Delivery** to assign complete orders in a single action.
* **Show Lines** to assign partial quantities or specific line items.

#### **Delivery Creation**

Consolidate assigned orders and allocate them to available trucks and operators, creating complete delivery packages ready for execution in the field

* Users can select **pending orders** and create deliveries.
* Shipments are assigned to specific trucks.
* Orders can be added in two modes:
  * **Add to Delivery** → Using the **Options** dropdown, you can select “Add to Delivery” to add the entire order in a single step.

<figure><img src="/files/lmy0qvel9XodpOcmjYVa" alt=""><figcaption></figcaption></figure>

* **Show Lines** → Add partial order quantities or specific product lines.

<figure><img src="/files/APkkmuGYIbZGrMxpWk7L" alt=""><figcaption></figcaption></figure>

The module provides filters for:

* Shipped orders
* Partially Shipped orders

This flexibility ensures **delivery planning matches operational needs**.

### **DMS Application Overview**

<div align="left"><figure><img src="/files/VL1ESHYXqNhnkQMU4BL3" alt=""><figcaption></figcaption></figure></div>

The DMS Application is designed to give truck operators a simple, efficient, and field-ready interface for managing deliveries. Upon logging in, operators are presented with a clear switchboard containing two main modules—each focused on a specific phase of the delivery process.

**Delivery Module**\
This module is the primary tool for managing active deliveries. Operators can:

* View the list of assigned deliveries
* Start delivery operations
* Access detailed order pages
* Send customer notifications

**Lookup Module**\
This module provides read-only access for reviewing completed deliveries and historical records. Operators can:

* Review completed deliveries
* Inspect delivery details
* Verify past delivery information
* Access delivery documentation

### Delivery Lifecycle in App:

<figure><img src="/files/keOdMpScwFIpbWQYP0Ub" alt=""><figcaption></figcaption></figure>

#### **Step 1: Login**

* The operator opens the DMS Mobile App.
* Uses ERP/DMS credentials to log in securely.
* Ensures only authorized personnel can access operational data.

#### **Step 2: Viewing Assigned Deliveries**

* The operator is presented with two options: **Delivery & Lookup**.
* The **"Delivery"** module is to view the list of assigned deliveries
* "Lookup" module is to review completed deliveries

#### **Step 3: Delivery Detail Page**

* Click on the delivery record in the **Delivery page** that you want to process. The **Delivery Detail page** opens up, where the truck operator can review all assigned delivery orders and update the delivery status for individual orders.
* Each order line includes a **Mark As Delivered** button. Selecting this option opens the **Mark Order As Delivered** pop-up window, where the operator can review delivery information and complete the delivery confirmation process.
* The pop-up window displays key delivery details such as **Delivery Number**, **Order Number**, **Invoice Number**, **Customer Name**, **Order Status**, **Delivery Address**, and **Packing Slip Number**.&#x20;
* The operator can enter the signer’s name in the **Signed By** field, capture the customer’s electronic signature using the signature canvas, and use the **Clear** button to reset and re-enter the signature if required.&#x20;

#### **Step 4: Mark as Delivered**

* Once the delivery is confirmed by clicking **Mark as delivered**, the delivery line status is updated in the system as **"Delivered"**.&#x20;

{% hint style="info" %}
**App Config:**

**Make Signer Name Mandatory for Order Delivery Confirmation:** When this setting is **enabled**, users must enter the signer's name on the "Mark Order As Delivered" page to confirm delivery.\
If the setting is **disabled**, entering the signer's name is optional, and users can mark the order as delivered without providing it.
{% endhint %}

<figure><img src="/files/SbdKpYCh9mXqaTWnOicI" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/WJIFaXGfI56usJbT747F" alt=""><figcaption></figcaption></figure>

#### **Step 5: Signature Storage & POD Management**

* Each captured signature is **instantly stored** in the system.
* Linked to the corresponding order as **Proof of Delivery (POD)**.
* Ensures:
  * Traceability
  * Accountability
  * Seamless documentation for operations and customer service

#### **Step 6: Lookup Page**

The Lookup module displays deliveries that are in **Partially Delivered** and **Delivered** statuses.

Users can:

* Review completed and partially delivered shipments
* Inspect delivery details for processed deliveries
* Verify historical delivery records for accuracy and consistency
* Access delivery documentation, including proofs of delivery

In the **Lookup Details** page, only the delivered lines for the selected delivery are displayed.

<figure><img src="/files/zMmjXv5iZ1q9OP7DpViC" alt=""><figcaption></figcaption></figure>

### Automated Customer Communication System

* **Delivery Start Notification**

Automated email sent to customers when delivery begins, providing real-time visibility into delivery status and expected arrival information.

* **Signature Collection**

An electronic signature is captured at the point of delivery using a mobile device, creating immediate digital proof of delivery completion.

* **Proof of Delivery**

Signed invoice document automatically generated and formatted with embedded customer signature for official delivery confirmation.

* **Confirmation Email**

Delivery confirmation email with signed invoice attachment automatically sent to customer, providing immediate receipt documentation.

<figure><img src="/files/vNL8oj824lpN06E0uYTb" alt=""><figcaption></figcaption></figure>

By automating these communication touchpoints, the system reduces manual administrative tasks while ensuring consistent, professional customer interaction. The immediate generation and distribution of signed delivery documents provides customers with instant access to proof-of-delivery records for their own business processes and record-keeping requirements.

### ERP Integration and Tracking Capabilities

* **Sales Order Centre Enhancement**

The Delivery Status column has been added to provide real-time tracking of delivery progress for every order. Administrators and customer service representatives can instantly view the current delivery state without switching systems.

<figure><img src="/files/gRAr8aAkJBtvcOjsOBet" alt=""><figcaption></figcaption></figure>

* **Invoice Centre**&#x20;

Enhanced interface displays delivered versus pending delivery quantities at the invoice detail level. Dedicated tab provides direct access to signed invoices, streamlining customer service and accounting operations.

<figure><img src="/files/C2O79RzEHtJXd7dsAoxT" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
The **Signed Invoices** option in the Invoice Centre is visible only when the **Enable Signature** setting is enabled in the **App Module Access** module.
{% endhint %}

* **Batch Processing Capabilities**

Print Signed Invoice feature enables the selection of multiple invoices for batch processing. Generate comprehensive proof-of-delivery document packages efficiently for bulk customer communication or compliance requirements.

### Business Impact and Operational Excellence

XoroDMS transforms delivery operations by creating a cohesive, technology-driven workflow that bridges the gap between ERP management and field execution. The system delivers faster, more reliable proof of delivery and significantly improves the customer experience with real-time notifications and immediate access to delivery documentation.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.xorosoft.com/xorodms/xorodms-delivery-management-system/dms-workflow.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
