Transfer order (#854)

* Add API version check

* Implement basic transfer order support

* add link to drawer

* Adjust dashboard display order

* Support transfer order allocation detail

* Add progress bar

* Enable scan of transfer order

lib/api.dart

@@ -330,6 +330,10 @@ class InvenTreeAPI {
   // Ref: https://github.com/inventree/InvenTree/pull/11963
   bool get supportsNewUserEndpoints => apiVersion >= 490;
 
+  // Does the server support TransferOrder model
+  // Ref: https://github.com/inventree/InvenTree/pull/11281
+  bool get supportsTransferOrders => apiVersion >= 492;
+
   // Does the server support the "creation_date" field on the StockItem model?
   // Ref: https://github.com/inventree/InvenTree/pull/12011
   bool get supportsStockItemCreationDate => apiVersion >= 496;

lib/barcode/barcode.dart

@@ -6,10 +6,12 @@ import "package:inventree/helpers.dart";
 import "package:inventree/inventree/build.dart";
 import "package:inventree/inventree/sales_order.dart";
 import "package:inventree/inventree/sentry.dart";
+import "package:inventree/inventree/transfer_order.dart";
 import "package:inventree/preferences.dart";
 import "package:inventree/widget/build/build_detail.dart";
 import "package:inventree/widget/company/manufacturer_part_detail.dart";
 import "package:inventree/widget/order/sales_order_detail.dart";
+import "package:inventree/widget/order/transfer_order_detail.dart";
 import "package:one_context/one_context.dart";
 
 import "package:inventree/api.dart";
@@ -230,6 +232,23 @@ class BarcodeScanHandler extends BarcodeHandler {
     }
   }
 
+  /*
+    * Response when a "TransferOrder" instance is scanned
+  */
+  Future<void> handleTransferOrder(int pk) async {
+    var order = await InvenTreeTransferOrder().get(pk);
+
+    if (order is InvenTreeTransferOrder &&
+        InvenTreeAPI().supportsTransferOrders) {
+      OneContext().pop();
+      OneContext().push(
+        MaterialPageRoute(
+          builder: (context) => TransferOrderDetailWidget(order),
+        ),
+      );
+    }
+  }
+
   /*
    * Response when a "PurchaseOrder" instance is scanned
    */
@@ -273,6 +292,7 @@ class BarcodeScanHandler extends BarcodeHandler {
       InvenTreeStockLocation.MODEL_TYPE,
       InvenTreeCompany.MODEL_TYPE,
       InvenTreeBuildOrder.MODEL_TYPE,
+      InvenTreeTransferOrder.MODEL_TYPE,
       InvenTreePurchaseOrder.MODEL_TYPE,
       InvenTreeSalesOrder.MODEL_TYPE,
     ];
@@ -304,6 +324,9 @@ class BarcodeScanHandler extends BarcodeHandler {
         case InvenTreeBuildOrder.MODEL_TYPE:
           await handleBuildOrder(pk);
           return;
+        case InvenTreeTransferOrder.MODEL_TYPE:
+          await handleTransferOrder(pk);
+          return;
         case InvenTreePurchaseOrder.MODEL_TYPE:
           await handlePurchaseOrder(pk);
           return;

lib/inventree/transfer_order.dart

@@ -0,0 +1,392 @@
+/*
+ * Models representing transfer orders
+ */
+
+import "package:flutter/material.dart";
+import "package:flutter_tabler_icons/flutter_tabler_icons.dart";
+
+import "package:inventree/api.dart";
+import "package:inventree/app_colors.dart";
+import "package:inventree/helpers.dart";
+import "package:inventree/inventree/model.dart";
+import "package:inventree/inventree/orders.dart";
+import "package:inventree/inventree/part.dart";
+import "package:inventree/inventree/stock.dart";
+import "package:inventree/l10.dart";
+import "package:inventree/widget/order/transfer_order_detail.dart";
+
+/*
+ * Class representing an individual TransferOrder instance
+ */
+class InvenTreeTransferOrder extends InvenTreeOrder {
+  InvenTreeTransferOrder() : super();
+
+  InvenTreeTransferOrder.fromJson(Map<String, dynamic> json)
+    : super.fromJson(json);
+
+  @override
+  InvenTreeModel createFromJson(Map<String, dynamic> json) =>
+      InvenTreeTransferOrder.fromJson(json);
+
+  // API endpoint URL
+  @override
+  String get URL => "order/transfer-order/";
+
+  static const String MODEL_TYPE = "transferorder";
+
+  @override
+  List<String> get rolesRequired => ["transfer_order"];
+
+  // Return icon for this model
+  static IconData get icon => TablerIcons.transfer;
+
+  @override
+  Future<Object?> goToDetailPage(BuildContext context) async {
+    return Navigator.push(
+      context,
+      MaterialPageRoute(builder: (context) => TransferOrderDetailWidget(this)),
+    );
+  }
+
+  @override
+  Map<String, Map<String, dynamic>> formFields() {
+    return {
+      "reference": {},
+      "description": {},
+      "project_code": {},
+      "take_from": {},
+      "destination": {"required": true},
+      "consume": {},
+      "start_date": {},
+      "target_date": {},
+      "link": {},
+      "responsible": {},
+    };
+  }
+
+  @override
+  Map<String, String> defaultFilters() {
+    return {"take_from_detail": "true", "destination_detail": "true"};
+  }
+
+  // Source location for this transfer order (may be null - any location)
+  int? get sourceLocationId {
+    int value = getInt("take_from");
+    return value > 0 ? value : null;
+  }
+
+  // Destination location for this transfer order
+  int? get destinationId {
+    int value = getInt("destination");
+    return value > 0 ? value : null;
+  }
+
+  // Should allocated stock be "consumed" rather than transferred?
+  bool get consume => getBool("consume");
+
+  bool get isPending => TransferOrderStatus.isNameIn(status, ["PENDING"]);
+
+  bool get isIssued => TransferOrderStatus.isNameIn(status, ["ISSUED"]);
+
+  bool get isOnHold => TransferOrderStatus.isNameIn(status, ["ON_HOLD"]);
+
+  bool get isComplete => TransferOrderStatus.isNameIn(status, ["COMPLETE"]);
+
+  bool get isCancelled => TransferOrderStatus.isNameIn(status, ["CANCELLED"]);
+
+  // An "open" order is one which is not complete or cancelled
+  bool get isOpen => !isComplete && !isCancelled;
+
+  // Can this order be issued?
+  bool get canIssue => isPending || isOnHold;
+
+  // Can this order be placed on hold?
+  bool get canHold => isPending || isIssued;
+
+  // Can this order be completed?
+  bool get canCompleteOrder => (isIssued || isOnHold) && !isPending;
+
+  // Can this order be cancelled?
+  bool get canCancel => isOpen;
+
+  Future<List<InvenTreeTransferOrderLineItem>> getLineItems() async {
+    final results = await InvenTreeTransferOrderLineItem().list(
+      filters: {"order": "${pk}"},
+    );
+
+    List<InvenTreeTransferOrderLineItem> items = [];
+
+    for (var result in results) {
+      if (result is InvenTreeTransferOrderLineItem) {
+        items.add(result);
+      }
+    }
+
+    return items;
+  }
+
+  /// Mark this order as "issued"
+  Future<APIResponse> issue() async {
+    return await api.post(
+      "${URL}${pk}/issue/",
+      body: {},
+      expectedStatusCode: 201,
+    );
+  }
+
+  /// Place this order on hold
+  Future<APIResponse> hold() async {
+    return await api.post(
+      "${URL}${pk}/hold/",
+      body: {},
+      expectedStatusCode: 201,
+    );
+  }
+
+  /// Mark this order as "complete"
+  Future<APIResponse> completeOrder({bool acceptIncomplete = false}) async {
+    Map<String, String> data = {
+      "accept_incomplete": acceptIncomplete.toString(),
+    };
+
+    return await api.post(
+      "${URL}${pk}/complete/",
+      body: data,
+      expectedStatusCode: 201,
+    );
+  }
+
+  /// Mark this order as "cancelled"
+  Future<APIResponse> cancel() async {
+    return await api.post(
+      "${URL}${pk}/cancel/",
+      body: {},
+      expectedStatusCode: 201,
+    );
+  }
+}
+
+/*
+ * Class representing a line item within a Transfer Order
+ */
+class InvenTreeTransferOrderLineItem extends InvenTreeOrderLine {
+  InvenTreeTransferOrderLineItem() : super();
+
+  InvenTreeTransferOrderLineItem.fromJson(Map<String, dynamic> json)
+    : super.fromJson(json);
+
+  @override
+  InvenTreeModel createFromJson(Map<String, dynamic> json) =>
+      InvenTreeTransferOrderLineItem.fromJson(json);
+
+  // API endpoint URL
+  @override
+  String get URL => "order/transfer-order-line/";
+
+  @override
+  List<String> get rolesRequired => ["transfer_order"];
+
+  @override
+  Map<String, String> defaultFilters() {
+    return {"part_detail": "true", "order_detail": "true"};
+  }
+
+  @override
+  Map<String, Map<String, dynamic>> formFields() {
+    return {
+      "order": {
+        // Cannot edit the order from here
+        "hidden": true,
+      },
+      "part": {
+        "required": true,
+        "filters": {"virtual": false},
+      },
+      "quantity": {"required": true},
+      "reference": {},
+      "target_date": {},
+      "link": {},
+      "notes": {},
+    };
+  }
+
+  // Quantity of stock allocated against this line item
+  double get allocated => getDouble("allocated");
+
+  // Quantity of stock which has actually been transferred
+  double get transferred => getDouble("transferred");
+
+  bool get isComplete => transferred >= quantity;
+
+  double get outstanding => quantity - transferred;
+
+  double get progressRatio {
+    if (quantity <= 0 || transferred <= 0) {
+      return 0;
+    }
+
+    return transferred / quantity;
+  }
+
+  String get progressString =>
+      simpleNumberString(transferred) + " / " + simpleNumberString(quantity);
+
+  InvenTreeTransferOrder? get transferOrder {
+    dynamic detail = jsondata["order_detail"];
+
+    if (detail == null) {
+      return null;
+    } else {
+      return InvenTreeTransferOrder.fromJson(detail as Map<String, dynamic>);
+    }
+  }
+}
+
+/*
+ * Class representing a single stock allocation against a Transfer Order line item
+ */
+class InvenTreeTransferOrderAllocation extends InvenTreeModel {
+  InvenTreeTransferOrderAllocation() : super();
+
+  InvenTreeTransferOrderAllocation.fromJson(Map<String, dynamic> json)
+    : super.fromJson(json);
+
+  @override
+  InvenTreeModel createFromJson(Map<String, dynamic> json) =>
+      InvenTreeTransferOrderAllocation.fromJson(json);
+
+  @override
+  String get URL => "order/transfer-order-allocation/";
+
+  static const String MODEL_TYPE = "transferorderallocation";
+
+  @override
+  List<String> get rolesRequired => ["transfer_order"];
+
+  @override
+  Map<String, String> defaultFilters() {
+    return {
+      "part_detail": "true",
+      "order_detail": "true",
+      "item_detail": "true",
+      "location_detail": "true",
+    };
+  }
+
+  double get quantity => getDouble("quantity");
+
+  int get lineId => getInt("line");
+
+  int get orderId => getInt("order");
+
+  InvenTreeTransferOrder? get order {
+    dynamic detail = jsondata["order_detail"];
+
+    if (detail == null) {
+      return null;
+    } else {
+      return InvenTreeTransferOrder.fromJson(detail as Map<String, dynamic>);
+    }
+  }
+
+  int get stockItemId => getInt("item");
+
+  InvenTreeStockItem? get stockItem {
+    dynamic detail = jsondata["item_detail"];
+
+    if (detail == null) {
+      return null;
+    } else {
+      return InvenTreeStockItem.fromJson(detail as Map<String, dynamic>);
+    }
+  }
+
+  int get partId => getInt("part");
+
+  InvenTreePart? get part {
+    dynamic detail = jsondata["part_detail"];
+
+    if (detail == null) {
+      return null;
+    } else {
+      return InvenTreePart.fromJson(detail as Map<String, dynamic>);
+    }
+  }
+
+  int get locationId => getInt("location");
+
+  InvenTreeStockLocation? get location {
+    dynamic detail = jsondata["location_detail"];
+
+    if (detail == null) {
+      return null;
+    } else {
+      return InvenTreeStockLocation.fromJson(detail as Map<String, dynamic>);
+    }
+  }
+}
+
+/*
+ * Transfer Order Status Codes
+ * Ref: https://github.com/inventree/InvenTree/blob/master/src/backend/InvenTree/order/status_codes.py
+ */
+class TransferOrderStatus {
+  // Status codes as defined in backend status_codes.py
+  static const int PENDING = 10; // Transfer order is pending / inactive
+  static const int ISSUED = 20; // Transfer order has been issued
+  static const int ON_HOLD = 25; // Transfer order is on hold
+  static const int COMPLETE = 30; // Transfer order is complete
+  static const int CANCELLED = 40; // Transfer order was cancelled
+
+  static const Map<int, String> _names = {
+    PENDING: "PENDING",
+    ISSUED: "ISSUED",
+    ON_HOLD: "ON_HOLD",
+    COMPLETE: "COMPLETE",
+    CANCELLED: "CANCELLED",
+  };
+
+  // Return the (untranslated) name associated with a given status code
+  static String name(int status) => _names[status] ?? "";
+
+  // Test if the name associated with the given code is in the provided list
+  static bool isNameIn(int status, List<String> names) {
+    return names.contains(name(status));
+  }
+
+  // Return a color based on the transfer order status
+  static Color getStatusColor(int status) {
+    switch (status) {
+      case PENDING:
+        return COLOR_GRAY_LIGHT;
+      case ISSUED:
+        return COLOR_PROGRESS;
+      case COMPLETE:
+        return COLOR_SUCCESS;
+      case CANCELLED:
+        return COLOR_DANGER;
+      case ON_HOLD:
+        return COLOR_WARNING;
+      default:
+        return COLOR_GRAY_LIGHT;
+    }
+  }
+
+  // Return a (translated) string based on the transfer order status
+  static String getStatusText(int status) {
+    switch (status) {
+      case PENDING:
+        return L10().pending;
+      case ISSUED:
+        return L10().issued;
+      case COMPLETE:
+        return L10().complete;
+      case CANCELLED:
+        return L10().cancelled;
+      case ON_HOLD:
+        return L10().onHold;
+      default:
+        return L10().unknown;
+    }
+  }
+}

lib/l10n/app_en.arb

@@ -342,6 +342,12 @@
   "configureServer": "Configure server settings",
   "@configureServer": {},
 
+  "consume": "Consume",
+  "@consume": {},
+
+  "consumeDetail": "Allocated stock will be consumed, not transferred",
+  "@consumeDetail": {},
+
   "confirmScan": "Confirm Transfer",
   "@confirmScan": {},
 
@@ -701,6 +707,12 @@
   "homeShowCustomersDescription": "Show customers button on home screen",
   "@homeShowCustomersDescription": {},
 
+  "homeShowTransfer": "Show Transfer Orders",
+  "@homeShowTransfer": {},
+
+  "homeShowTransferDescription": "Show transfer order button on home screen",
+  "@homeShowTransferDescription": {},
+
   "imageUploadFailure": "Image upload failed",
   "@imageUploadFailure": {},
 
@@ -1097,6 +1109,15 @@
   "pending": "Pending",
   "@pending": {},
 
+  "issued": "Issued",
+  "@issued": {},
+
+  "cancelled": "Cancelled",
+  "@cancelled": {},
+
+  "onHold": "On Hold",
+  "@onHold": {},
+
   "permissionAccountDenied": "Your account does not have the required permissions to perform this action",
   "@permissionAccountDenied": {},
 
@@ -1811,6 +1832,21 @@
     "description": "transfer"
   },
 
+  "transferOrder": "Transfer Order",
+  "@transferOrder": {},
+
+  "transferOrders": "Transfer Orders",
+  "@transferOrders": {},
+
+  "transferOrderCreate": "New Transfer Order",
+  "@transferOrderCreate": {},
+
+  "transferOrderEdit": "Edit Transfer Order",
+  "@transferOrderEdit": {},
+
+  "transferOrderUpdated": "Transfer order updated",
+  "@transferOrderUpdated": {},
+
   "transferStock": "Transfer Stock",
   "@transferStock": {
     "description": "transfer stock"
@@ -1852,6 +1888,9 @@
   "units": "Units",
   "@units": {},
 
+  "unknown": "Unknown",
+  "@unknown": {},
+
   "unknownResponse": "Unknown Response",
   "@unknownResponse": {},
 

lib/preferences.dart

@@ -15,6 +15,7 @@ const String INV_HOME_SHOW_BUILD = "homeShowBuild";
 const String INV_HOME_SHOW_MANUFACTURERS = "homeShowManufacturers";
 const String INV_HOME_SHOW_CUSTOMERS = "homeShowCustomers";
 const String INV_HOME_SHOW_SUPPLIERS = "homeShowSuppliers";
+const String INV_HOME_SHOW_TRANSFER = "homeShowTransfer";
 
 const String INV_SCREEN_ORIENTATION = "appScreenOrientation";
 const String INV_SHOW_PK = "showPk";

lib/settings/home_settings.dart

@@ -23,6 +23,7 @@ class _HomeScreenSettingsState extends State<HomeScreenSettingsWidget> {
   bool homeShowSuppliers = true;
   bool homeShowManufacturers = true;
   bool homeShowCustomers = true;
+  bool homeShowTransfer = true;
 
   @override
   void initState() {
@@ -63,6 +64,9 @@ class _HomeScreenSettingsState extends State<HomeScreenSettingsWidget> {
     homeShowSuppliers =
         await InvenTreeSettingsManager().getValue(INV_HOME_SHOW_SUPPLIERS, true)
             as bool;
+    homeShowTransfer =
+        await InvenTreeSettingsManager().getValue(INV_HOME_SHOW_TRANSFER, true)
+            as bool;
 
     setState(() {});
   }
@@ -154,6 +158,23 @@ class _HomeScreenSettingsState extends State<HomeScreenSettingsWidget> {
                 },
               ),
             ),
+            ListTile(
+              title: Text(L10().homeShowTransfer),
+              subtitle: Text(L10().homeShowTransferDescription),
+              leading: Icon(TablerIcons.transfer),
+              trailing: Switch(
+                value: homeShowTransfer,
+                onChanged: (bool value) {
+                  InvenTreeSettingsManager().setValue(
+                    INV_HOME_SHOW_TRANSFER,
+                    value,
+                  );
+                  setState(() {
+                    homeShowTransfer = value;
+                  });
+                },
+              ),
+            ),
             // TODO: When these features are improved, add them back in!
             // Currently, the company display does not provide any value
             /*

lib/widget/drawer.dart

@@ -10,11 +10,13 @@ import "package:inventree/inventree/part.dart";
 import "package:inventree/inventree/purchase_order.dart";
 import "package:inventree/inventree/sales_order.dart";
 import "package:inventree/inventree/stock.dart";
+import "package:inventree/inventree/transfer_order.dart";
 import "package:inventree/l10.dart";
 import "package:inventree/settings/about.dart";
 import "package:inventree/settings/settings.dart";
 import "package:inventree/widget/build/build_list.dart";
 import "package:inventree/widget/order/sales_order_list.dart";
+import "package:inventree/widget/order/transfer_order_list.dart";
 import "package:inventree/widget/part/category_display.dart";
 import "package:inventree/widget/notifications.dart";
 import "package:inventree/widget/order/purchase_order_list.dart";
@@ -162,6 +164,18 @@ class _InvenTreeDrawerState extends State<InvenTreeDrawer> {
     }
   }
 
+  void _transferOrders() {
+    _closeDrawer();
+    if (_checkConnection()) {
+      Navigator.push(
+        widget.parentContext,
+        MaterialPageRoute(
+          builder: (context) => TransferOrderListWidget(filters: {}),
+        ),
+      );
+    }
+  }
+
   void _notifications() {
     _closeDrawer();
     if (_checkConnection()) {
@@ -261,6 +275,17 @@ class _InvenTreeDrawerState extends State<InvenTreeDrawer> {
       );
     }
 
+    if (InvenTreeAPI().supportsTransferOrders &&
+        InvenTreeTransferOrder().canView) {
+      tiles.add(
+        ListTile(
+          title: Text(L10().transferOrders),
+          leading: Icon(TablerIcons.transfer, color: COLOR_ACTION),
+          onTap: _transferOrders,
+        ),
+      );
+    }
+
     if (InvenTreePurchaseOrder().canView) {
       tiles.add(
         ListTile(

lib/widget/home.dart

@@ -12,6 +12,7 @@ import "package:inventree/inventree/update_check.dart";
 import "package:inventree/inventree/purchase_order.dart";
 import "package:inventree/inventree/sales_order.dart";
 import "package:inventree/inventree/stock.dart";
+import "package:inventree/inventree/transfer_order.dart";
 import "package:inventree/preferences.dart";
 import "package:inventree/l10.dart";
 import "package:inventree/settings/select_server.dart";
@@ -24,6 +25,7 @@ import "package:inventree/widget/stock/location_display.dart";
 import "package:inventree/widget/part/part_list.dart";
 import "package:inventree/widget/order/purchase_order_list.dart";
 import "package:inventree/widget/order/sales_order_list.dart";
+import "package:inventree/widget/order/transfer_order_list.dart";
 import "package:inventree/widget/build/build_list.dart";
 import "package:inventree/widget/refreshable_state.dart";
 import "package:inventree/widget/snacks.dart";
@@ -157,6 +159,7 @@ class _InvenTreeHomePageState extends State<InvenTreeHomePage>
   bool homeShowManufacturers = false;
   bool homeShowCustomers = false;
   bool homeShowSuppliers = false;
+  bool homeShowTransfer = false;
 
   // Selected user profile
   UserProfile? _profile;
@@ -169,6 +172,8 @@ class _InvenTreeHomePageState extends State<InvenTreeHomePage>
   int? _soOverdueCount;
   int? _soOutstandingCount;
   int? _shipmentsPendingCount;
+  int? _transferOverdueCount;
+  int? _transferOutstandingCount;
 
   void _showParts(BuildContext context) {
     if (!InvenTreeAPI().checkConnection()) return;
@@ -233,6 +238,17 @@ class _InvenTreeHomePageState extends State<InvenTreeHomePage>
     );
   }
 
+  void _showTransferOrders(BuildContext context) {
+    if (!InvenTreeAPI().checkConnection()) return;
+
+    Navigator.push(
+      context,
+      MaterialPageRoute(
+        builder: (context) => TransferOrderListWidget(filters: {}),
+      ),
+    );
+  }
+
   void _showBuildOrders(BuildContext context) {
     if (!InvenTreeAPI().checkConnection()) return;
 
@@ -330,6 +346,9 @@ class _InvenTreeHomePageState extends State<InvenTreeHomePage>
     homeShowSuppliers =
         await InvenTreeSettingsManager().getValue(INV_HOME_SHOW_SUPPLIERS, true)
             as bool;
+    homeShowTransfer =
+        await InvenTreeSettingsManager().getValue(INV_HOME_SHOW_TRANSFER, true)
+            as bool;
 
     setState(() {});
 
@@ -356,6 +375,10 @@ class _InvenTreeHomePageState extends State<InvenTreeHomePage>
     final bool loadSo = homeShowSo && InvenTreeSalesOrder().canView;
     final bool loadShipments =
         homeShowShipments && InvenTreeSalesOrderShipment().canView;
+    final bool loadTransfer =
+        homeShowTransfer &&
+        InvenTreeAPI().supportsTransferOrders &&
+        InvenTreeTransferOrder().canView;
 
     int? buildOverdue;
     int? buildOutstanding;
@@ -364,6 +387,8 @@ class _InvenTreeHomePageState extends State<InvenTreeHomePage>
     int? soOverdue;
     int? soOutstanding;
     int? shipmentsPending;
+    int? transferOverdue;
+    int? transferOutstanding;
 
     final List<Future<void>> requests = [];
 
@@ -418,6 +443,21 @@ class _InvenTreeHomePageState extends State<InvenTreeHomePage>
       );
     }
 
+    if (loadTransfer) {
+      requests.add(
+        InvenTreeTransferOrder().count(filters: {"overdue": "true"}).then((c) {
+          transferOverdue = c;
+        }),
+      );
+      requests.add(
+        InvenTreeTransferOrder().count(filters: {"outstanding": "true"}).then((
+          c,
+        ) {
+          transferOutstanding = c;
+        }),
+      );
+    }
+
     await Future.wait(requests);
 
     if (!mounted) {
@@ -432,6 +472,8 @@ class _InvenTreeHomePageState extends State<InvenTreeHomePage>
       _soOverdueCount = soOverdue;
       _soOutstandingCount = soOutstanding;
       _shipmentsPendingCount = shipmentsPending;
+      _transferOverdueCount = transferOverdue;
+      _transferOutstandingCount = transferOutstanding;
     });
   }
 
@@ -571,6 +613,27 @@ class _InvenTreeHomePageState extends State<InvenTreeHomePage>
       );
     }
 
+    // Transfer orders
+    if (homeShowTransfer &&
+        InvenTreeAPI().supportsTransferOrders &&
+        InvenTreeTransferOrder().canView) {
+      tiles.add(
+        _listTile(
+          context,
+          L10().transferOrders,
+          TablerIcons.transfer,
+          callback: () {
+            _showTransferOrders(context);
+          },
+          trailing: buildOrderBadges(
+            context,
+            outstandingCount: _transferOutstandingCount,
+            overdueCount: _transferOverdueCount,
+          ),
+        ),
+      );
+    }
+
     // Purchase orders
     if (homeShowPo && InvenTreePurchaseOrder().canView) {
       tiles.add(

lib/widget/order/transfer_order_allocation_list.dart

@@ -0,0 +1,113 @@
+import "package:flutter/material.dart";
+
+import "package:inventree/api.dart";
+import "package:inventree/helpers.dart";
+import "package:inventree/inventree/model.dart";
+import "package:inventree/inventree/transfer_order.dart";
+import "package:inventree/l10.dart";
+
+import "package:inventree/widget/link_icon.dart";
+import "package:inventree/widget/paginator.dart";
+import "package:inventree/widget/refreshable_state.dart";
+
+/*
+ * Full-page widget for displaying the stock items allocated against a
+ * single Transfer Order line item
+ */
+class TransferOrderAllocationWidget extends StatefulWidget {
+  const TransferOrderAllocationWidget(this.item, {Key? key}) : super(key: key);
+
+  final InvenTreeTransferOrderLineItem item;
+
+  @override
+  _TransferOrderAllocationWidgetState createState() =>
+      _TransferOrderAllocationWidgetState();
+}
+
+class _TransferOrderAllocationWidgetState
+    extends RefreshableState<TransferOrderAllocationWidget> {
+  _TransferOrderAllocationWidgetState();
+
+  @override
+  String getAppBarTitle() => L10().allocatedStock;
+
+  @override
+  Widget getBody(BuildContext context) {
+    Map<String, String> filters = {"line": widget.item.pk.toString()};
+
+    return Column(
+      children: [
+        ListTile(
+          leading: InvenTreeAPI().getThumbnail(widget.item.partImage),
+          title: Text(widget.item.partName),
+          subtitle: Text(L10().allocatedStock),
+        ),
+        Divider(thickness: 1.25),
+        Expanded(child: PaginatedTransferOrderAllocationList(filters)),
+      ],
+    );
+  }
+}
+
+/*
+ * Paginated widget class for displaying a list of transfer order line item allocations
+ */
+class PaginatedTransferOrderAllocationList extends PaginatedSearchWidget {
+  const PaginatedTransferOrderAllocationList(Map<String, String> filters)
+    : super(filters: filters);
+
+  @override
+  String get searchTitle => L10().allocatedStock;
+
+  @override
+  _PaginatedTransferOrderAllocationListState createState() =>
+      _PaginatedTransferOrderAllocationListState();
+}
+
+class _PaginatedTransferOrderAllocationListState
+    extends PaginatedSearchState<PaginatedTransferOrderAllocationList> {
+  _PaginatedTransferOrderAllocationListState() : super();
+
+  @override
+  String get prefix => "to_allocation_";
+
+  @override
+  Map<String, String> get orderingOptions => {};
+
+  @override
+  Map<String, Map<String, dynamic>> get filterOptions => {};
+
+  @override
+  Future<InvenTreePageResponse?> requestPage(
+    int limit,
+    int offset,
+    Map<String, String> params,
+  ) async {
+    final page = await InvenTreeTransferOrderAllocation().listPaginated(
+      limit,
+      offset,
+      filters: params,
+    );
+
+    return page;
+  }
+
+  @override
+  Widget buildItem(BuildContext context, InvenTreeModel model) {
+    InvenTreeTransferOrderAllocation allocation =
+        model as InvenTreeTransferOrderAllocation;
+
+    var stockItem = allocation.stockItem;
+    var location = allocation.location;
+
+    return ListTile(
+      title: Text(stockItem?.serialOrQuantityDisplay() ?? ""),
+      subtitle: Text(location?.pathstring ?? L10().locationNotSet),
+      leading: InvenTreeAPI().getThumbnail(allocation.part?.thumbnail ?? ""),
+      trailing: LargeText(simpleNumberString(allocation.quantity)),
+      onTap: () async {
+        stockItem?.goToDetailPage(context);
+      },
+    );
+  }
+}

lib/widget/order/transfer_order_detail.dart

@@ -0,0 +1,437 @@
+import "package:flutter/material.dart";
+import "package:flutter_speed_dial/flutter_speed_dial.dart";
+import "package:flutter_tabler_icons/flutter_tabler_icons.dart";
+
+import "package:inventree/api_form.dart";
+import "package:inventree/app_colors.dart";
+import "package:inventree/l10.dart";
+
+import "package:inventree/inventree/model.dart";
+import "package:inventree/inventree/stock.dart";
+import "package:inventree/inventree/transfer_order.dart";
+
+import "package:inventree/widget/dialogs.dart";
+import "package:inventree/widget/link_icon.dart";
+import "package:inventree/widget/notes_widget.dart";
+import "package:inventree/widget/order/transfer_order_line_list.dart";
+import "package:inventree/widget/progress.dart";
+import "package:inventree/widget/refreshable_state.dart";
+import "package:inventree/widget/snacks.dart";
+
+/*
+ * Widget for viewing a single TransferOrder instance
+ */
+class TransferOrderDetailWidget extends StatefulWidget {
+  const TransferOrderDetailWidget(this.order, {Key? key}) : super(key: key);
+
+  final InvenTreeTransferOrder order;
+
+  @override
+  _TransferOrderDetailState createState() => _TransferOrderDetailState();
+}
+
+class _TransferOrderDetailState
+    extends RefreshableState<TransferOrderDetailWidget> {
+  _TransferOrderDetailState();
+
+  InvenTreeStockLocation? sourceLocation;
+  InvenTreeStockLocation? destinationLocation;
+
+  int completedLines = 0;
+
+  @override
+  String getAppBarTitle() {
+    String title = L10().transferOrder;
+
+    if (widget.order.reference.isNotEmpty) {
+      title += " - ${widget.order.reference}";
+    }
+
+    return title;
+  }
+
+  @override
+  List<Widget> appBarActions(BuildContext context) {
+    List<Widget> actions = [];
+
+    if (widget.order.canEdit) {
+      actions.add(
+        IconButton(
+          icon: Icon(TablerIcons.edit),
+          tooltip: L10().transferOrderEdit,
+          onPressed: () {
+            editOrder(context);
+          },
+        ),
+      );
+    }
+
+    return actions;
+  }
+
+  @override
+  List<SpeedDialChild> actionButtons(BuildContext context) {
+    List<SpeedDialChild> actions = [];
+
+    if (!widget.order.canEdit) {
+      return actions;
+    }
+
+    if (widget.order.canIssue) {
+      actions.add(
+        SpeedDialChild(
+          child: Icon(TablerIcons.send, color: COLOR_ACTION),
+          label: L10().issueOrder,
+          onTap: () async {
+            _issueOrder(context);
+          },
+        ),
+      );
+    }
+
+    if (widget.order.canCompleteOrder) {
+      actions.add(
+        SpeedDialChild(
+          child: Icon(TablerIcons.circle_check, color: COLOR_SUCCESS),
+          label: L10().completeOrder,
+          onTap: () async {
+            _completeOrder(context);
+          },
+        ),
+      );
+    }
+
+    if (widget.order.canHold) {
+      actions.add(
+        SpeedDialChild(
+          child: Icon(TablerIcons.player_pause, color: COLOR_WARNING),
+          label: L10().holdOrder,
+          onTap: () async {
+            _holdOrder(context);
+          },
+        ),
+      );
+    }
+
+    if (widget.order.canCancel) {
+      actions.add(
+        SpeedDialChild(
+          child: Icon(TablerIcons.circle_x, color: COLOR_DANGER),
+          label: L10().cancelOrder,
+          onTap: () async {
+            _cancelOrder(context);
+          },
+        ),
+      );
+    }
+
+    return actions;
+  }
+
+  /// Issue this order
+  Future<void> _issueOrder(BuildContext context) async {
+    confirmationDialog(
+      L10().issueOrder,
+      L10().issueOrderConfirm,
+      icon: TablerIcons.send,
+      color: COLOR_ACTION,
+      acceptText: L10().issue,
+      onAccept: () async {
+        widget.order.issue().then((dynamic) {
+          refresh(context);
+        });
+      },
+    );
+  }
+
+  /// Complete this order
+  Future<void> _completeOrder(BuildContext context) async {
+    Map<String, Map<String, dynamic>> fields = {"accept_incomplete": {}};
+
+    String url = "${widget.order.URL}${widget.order.pk}/complete/";
+
+    launchApiForm(
+      context,
+      L10().completeOrder,
+      url,
+      fields,
+      method: "POST",
+      onSuccess: (data) async {
+        refresh(context);
+      },
+    );
+  }
+
+  /// Place this order on hold
+  Future<void> _holdOrder(BuildContext context) async {
+    confirmationDialog(
+      L10().holdOrder,
+      L10().holdOrderConfirm,
+      icon: TablerIcons.player_pause,
+      color: COLOR_WARNING,
+      acceptText: L10().hold,
+      onAccept: () async {
+        widget.order.hold().then((dynamic) {
+          refresh(context);
+        });
+      },
+    );
+  }
+
+  /// Cancel this order
+  Future<void> _cancelOrder(BuildContext context) async {
+    confirmationDialog(
+      L10().cancelOrder,
+      L10().cancelOrderConfirm,
+      icon: TablerIcons.circle_x,
+      color: COLOR_DANGER,
+      acceptText: L10().cancel,
+      onAccept: () async {
+        widget.order.cancel().then((dynamic) {
+          refresh(context);
+        });
+      },
+    );
+  }
+
+  @override
+  List<SpeedDialChild> barcodeButtons(BuildContext context) {
+    // Transfer orders don't have barcode functionality yet
+    return [];
+  }
+
+  @override
+  Future<void> request(BuildContext context) async {
+    await widget.order.reload();
+
+    List<InvenTreeTransferOrderLineItem> lines = await widget.order
+        .getLineItems();
+
+    completedLines = 0;
+
+    for (var line in lines) {
+      if (line.isComplete) {
+        completedLines += 1;
+      }
+    }
+
+    if (widget.order.sourceLocationId != null) {
+      InvenTreeStockLocation().get(widget.order.sourceLocationId!).then((
+        InvenTreeModel? loc,
+      ) {
+        if (mounted) {
+          setState(() {
+            sourceLocation = loc is InvenTreeStockLocation ? loc : null;
+          });
+        }
+      });
+    } else if (mounted) {
+      setState(() {
+        sourceLocation = null;
+      });
+    }
+
+    if (widget.order.destinationId != null) {
+      InvenTreeStockLocation().get(widget.order.destinationId!).then((
+        InvenTreeModel? loc,
+      ) {
+        if (mounted) {
+          setState(() {
+            destinationLocation = loc is InvenTreeStockLocation ? loc : null;
+          });
+        }
+      });
+    } else if (mounted) {
+      setState(() {
+        destinationLocation = null;
+      });
+    }
+  }
+
+  /// Edit the currently displayed TransferOrder
+  Future<void> editOrder(BuildContext context) async {
+    var fields = widget.order.formFields();
+
+    widget.order.editForm(
+      context,
+      L10().transferOrderEdit,
+      fields: fields,
+      onSuccess: (data) async {
+        refresh(context);
+        showSnackIcon(L10().transferOrderUpdated, success: true);
+      },
+    );
+  }
+
+  Widget headerTile(BuildContext context) {
+    return Card(
+      child: ListTile(
+        title: Text(widget.order.reference),
+        subtitle: Text(widget.order.description),
+        trailing: LargeText(
+          TransferOrderStatus.getStatusText(widget.order.status),
+          color: TransferOrderStatus.getStatusColor(widget.order.status),
+        ),
+      ),
+    );
+  }
+
+  List<Widget> orderTiles(BuildContext context) {
+    List<Widget> tiles = [];
+
+    tiles.add(headerTile(context));
+
+    if (showPk) {
+      tiles.add(pkTile(widget.order.pk));
+    }
+
+    if (widget.order.hasProjectCode) {
+      tiles.add(
+        ListTile(
+          title: Text(L10().projectCode),
+          subtitle: Text(
+            "${widget.order.projectCode} - ${widget.order.projectCodeDescription}",
+          ),
+          leading: Icon(TablerIcons.list),
+        ),
+      );
+    }
+
+    if (sourceLocation != null) {
+      tiles.add(
+        ListTile(
+          title: Text(L10().sourceLocation),
+          subtitle: Text(sourceLocation!.pathstring),
+          leading: Icon(TablerIcons.map_pin, color: COLOR_ACTION),
+          trailing: LinkIcon(),
+          onTap: () => sourceLocation!.goToDetailPage(context),
+        ),
+      );
+    }
+
+    if (destinationLocation != null) {
+      tiles.add(
+        ListTile(
+          title: Text(L10().destination),
+          subtitle: Text(destinationLocation!.pathstring),
+          leading: Icon(TablerIcons.map_pin, color: COLOR_ACTION),
+          trailing: LinkIcon(),
+          onTap: () => destinationLocation!.goToDetailPage(context),
+        ),
+      );
+    }
+
+    if (widget.order.consume) {
+      tiles.add(
+        ListTile(
+          title: Text(L10().consume),
+          subtitle: Text(L10().consumeDetail),
+          leading: Icon(TablerIcons.flame, color: COLOR_WARNING),
+        ),
+      );
+    }
+
+    Color lineColor = completedLines < widget.order.lineItemCount
+        ? COLOR_WARNING
+        : COLOR_SUCCESS;
+
+    tiles.add(
+      ListTile(
+        title: Text(L10().lineItems),
+        subtitle: ProgressBar(
+          completedLines.toDouble(),
+          maximum: widget.order.lineItemCount.toDouble(),
+        ),
+        leading: Icon(TablerIcons.clipboard_check),
+        trailing: LargeText(
+          "${completedLines} / ${widget.order.lineItemCount}",
+          color: lineColor,
+        ),
+      ),
+    );
+
+    if (widget.order.creationDate.isNotEmpty) {
+      tiles.add(
+        ListTile(
+          title: Text(L10().creationDate),
+          trailing: LargeText(widget.order.creationDate),
+          leading: Icon(TablerIcons.calendar),
+        ),
+      );
+    }
+
+    if (widget.order.startDate.isNotEmpty) {
+      tiles.add(
+        ListTile(
+          title: Text(L10().startDate),
+          trailing: LargeText(widget.order.startDate),
+          leading: Icon(TablerIcons.calendar),
+        ),
+      );
+    }
+
+    if (widget.order.targetDate.isNotEmpty) {
+      tiles.add(
+        ListTile(
+          title: Text(L10().targetDate),
+          trailing: LargeText(widget.order.targetDate),
+          leading: Icon(TablerIcons.calendar),
+        ),
+      );
+    }
+
+    if (widget.order.completionDate.isNotEmpty) {
+      tiles.add(
+        ListTile(
+          title: Text(L10().completionDate),
+          trailing: LargeText(widget.order.completionDate),
+          leading: Icon(TablerIcons.calendar),
+        ),
+      );
+    }
+
+    if (widget.order.responsibleName.isNotEmpty &&
+        widget.order.responsibleLabel.isNotEmpty) {
+      tiles.add(
+        ListTile(
+          title: Text(L10().responsible),
+          leading: Icon(
+            widget.order.responsibleLabel == "group"
+                ? TablerIcons.users
+                : TablerIcons.user,
+          ),
+          trailing: LargeText(widget.order.responsibleName),
+        ),
+      );
+    }
+
+    tiles.add(
+      ListTile(
+        title: Text(L10().notes),
+        leading: Icon(TablerIcons.note, color: COLOR_ACTION),
+        trailing: LinkIcon(),
+        onTap: () {
+          Navigator.push(
+            context,
+            MaterialPageRoute(builder: (context) => NotesWidget(widget.order)),
+          );
+        },
+      ),
+    );
+
+    return tiles;
+  }
+
+  @override
+  List<Widget> getTabIcons(BuildContext context) {
+    return [Tab(text: L10().details), Tab(text: L10().parts)];
+  }
+
+  @override
+  List<Widget> getTabs(BuildContext context) {
+    return [
+      ListView(children: orderTiles(context)),
+      PaginatedTransferOrderLineList({"order": widget.order.pk.toString()}),
+    ];
+  }
+}

lib/widget/order/transfer_order_line_detail.dart

@@ -0,0 +1,180 @@
+import "package:flutter/material.dart";
+import "package:flutter_tabler_icons/flutter_tabler_icons.dart";
+
+import "package:inventree/api.dart";
+import "package:inventree/app_colors.dart";
+import "package:inventree/helpers.dart";
+import "package:inventree/l10.dart";
+
+import "package:inventree/inventree/part.dart";
+import "package:inventree/inventree/transfer_order.dart";
+
+import "package:inventree/widget/link_icon.dart";
+import "package:inventree/widget/order/transfer_order_allocation_list.dart";
+import "package:inventree/widget/progress.dart";
+import "package:inventree/widget/refreshable_state.dart";
+import "package:inventree/widget/snacks.dart";
+
+/*
+ * Widget for displaying detail view of a single TransferOrderLineItem
+ */
+class TransferOrderLineDetailWidget extends StatefulWidget {
+  const TransferOrderLineDetailWidget(this.item, {Key? key}) : super(key: key);
+
+  final InvenTreeTransferOrderLineItem item;
+
+  @override
+  _TransferOrderLineDetailState createState() =>
+      _TransferOrderLineDetailState();
+}
+
+class _TransferOrderLineDetailState
+    extends RefreshableState<TransferOrderLineDetailWidget> {
+  _TransferOrderLineDetailState();
+
+  @override
+  String getAppBarTitle() => L10().lineItem;
+
+  @override
+  List<Widget> appBarActions(BuildContext context) {
+    List<Widget> actions = [];
+
+    if (widget.item.canEdit) {
+      actions.add(
+        IconButton(
+          icon: Icon(TablerIcons.edit),
+          onPressed: () {
+            _editLineItem(context);
+          },
+        ),
+      );
+    }
+
+    return actions;
+  }
+
+  @override
+  Future<void> request(BuildContext context) async {
+    await widget.item.reload();
+  }
+
+  // Callback to edit this line item
+  Future<void> _editLineItem(BuildContext context) async {
+    var fields = widget.item.formFields();
+
+    widget.item.editForm(
+      context,
+      L10().editLineItem,
+      fields: fields,
+      onSuccess: (data) async {
+        refresh(context);
+        showSnackIcon(L10().lineItemUpdated, success: true);
+      },
+    );
+  }
+
+  @override
+  List<Widget> getTiles(BuildContext context) {
+    List<Widget> tiles = [];
+
+    if (showPk) {
+      tiles.add(pkTile(widget.item.pk));
+    }
+
+    // Reference to the part
+    tiles.add(
+      ListTile(
+        title: Text(L10().part),
+        subtitle: Text(widget.item.partName),
+        leading: InvenTreeAPI().getThumbnail(widget.item.partImage),
+        trailing: LinkIcon(),
+        onTap: () async {
+          showLoadingOverlay();
+          var part = await InvenTreePart().get(widget.item.partId);
+          hideLoadingOverlay();
+
+          if (part is InvenTreePart) {
+            part.goToDetailPage(context);
+          }
+        },
+      ),
+    );
+
+    // Transferred quantity
+    tiles.add(
+      ListTile(
+        title: Text(L10().transfer),
+        subtitle: ProgressBar(widget.item.progressRatio),
+        trailing: LargeText(
+          widget.item.progressString,
+          color: widget.item.isComplete ? COLOR_SUCCESS : COLOR_WARNING,
+        ),
+        leading: Icon(TablerIcons.progress),
+      ),
+    );
+
+    // Allocated stock items
+    tiles.add(
+      ListTile(
+        title: Text(L10().allocatedStock),
+        leading: Icon(TablerIcons.clipboard_check, color: COLOR_ACTION),
+        trailing: LinkIcon(text: simpleNumberString(widget.item.allocated)),
+        onTap: () => Navigator.push(
+          context,
+          MaterialPageRoute(
+            builder: (context) => TransferOrderAllocationWidget(widget.item),
+          ),
+        ),
+      ),
+    );
+
+    // Reference
+    if (widget.item.reference.isNotEmpty) {
+      tiles.add(
+        ListTile(
+          title: Text(L10().reference),
+          subtitle: Text(widget.item.reference),
+          leading: Icon(TablerIcons.hash),
+        ),
+      );
+    }
+
+    // Target date
+    if (widget.item.targetDate.isNotEmpty) {
+      tiles.add(
+        ListTile(
+          title: Text(L10().targetDate),
+          subtitle: Text(widget.item.targetDate),
+          leading: Icon(TablerIcons.calendar),
+        ),
+      );
+    }
+
+    // Notes
+    if (widget.item.notes.isNotEmpty) {
+      tiles.add(
+        ListTile(
+          title: Text(L10().notes),
+          subtitle: Text(widget.item.notes),
+          leading: Icon(TablerIcons.note),
+        ),
+      );
+    }
+
+    // External link
+    if (widget.item.hasLink) {
+      tiles.add(
+        ListTile(
+          title: Text(L10().link),
+          subtitle: Text(widget.item.link),
+          leading: Icon(TablerIcons.link, color: COLOR_ACTION),
+          onTap: () async {
+            await openLink(widget.item.link);
+          },
+        ),
+      );
+    }
+
+    return tiles;
+  }
+}

lib/widget/order/transfer_order_line_list.dart

@@ -0,0 +1,105 @@
+import "package:flutter/material.dart";
+
+import "package:inventree/api.dart";
+import "package:inventree/app_colors.dart";
+import "package:inventree/l10.dart";
+
+import "package:inventree/inventree/model.dart";
+import "package:inventree/inventree/transfer_order.dart";
+
+import "package:inventree/widget/link_icon.dart";
+import "package:inventree/widget/order/transfer_order_line_detail.dart";
+import "package:inventree/widget/paginator.dart";
+import "package:inventree/widget/progress.dart";
+
+/*
+ * Paginated widget class for displaying a list of parts assigned to a Transfer Order
+ */
+class PaginatedTransferOrderLineList extends PaginatedSearchWidget {
+  const PaginatedTransferOrderLineList(Map<String, String> filters)
+    : super(filters: filters);
+
+  @override
+  String get searchTitle => L10().lineItems;
+
+  @override
+  _PaginatedTransferOrderLineListState createState() =>
+      _PaginatedTransferOrderLineListState();
+}
+
+class _PaginatedTransferOrderLineListState
+    extends PaginatedSearchState<PaginatedTransferOrderLineList> {
+  _PaginatedTransferOrderLineListState() : super();
+
+  @override
+  String get prefix => "to_line_";
+
+  @override
+  Map<String, String> get orderingOptions => {
+    "part": L10().part,
+    "quantity": L10().quantity,
+    "target_date": L10().targetDate,
+  };
+
+  @override
+  Map<String, Map<String, dynamic>> get filterOptions => {
+    "completed": {
+      "label": L10().received,
+      "help_text": L10().receivedFilterDetail,
+      "tristate": true,
+    },
+    "allocated": {
+      "label": L10().allocated,
+      "help_text": L10().allocatedFilterDetail,
+      "tristate": true,
+    },
+  };
+
+  @override
+  Future<InvenTreePageResponse?> requestPage(
+    int limit,
+    int offset,
+    Map<String, String> params,
+  ) async {
+    final page = await InvenTreeTransferOrderLineItem().listPaginated(
+      limit,
+      offset,
+      filters: params,
+    );
+
+    return page;
+  }
+
+  @override
+  Widget buildItem(BuildContext context, InvenTreeModel model) {
+    InvenTreeTransferOrderLineItem item =
+        model as InvenTreeTransferOrderLineItem;
+
+    return ListTile(
+      title: Text(item.partName),
+      subtitle: Column(
+        crossAxisAlignment: CrossAxisAlignment.start,
+        children: [
+          if (item.partDescription.isNotEmpty) Text(item.partDescription),
+          ProgressBar(item.transferred, maximum: item.quantity),
+        ],
+      ),
+      leading: InvenTreeAPI().getThumbnail(item.partImage),
+      trailing: LargeText(
+        item.progressString,
+        color: item.isComplete ? COLOR_SUCCESS : COLOR_WARNING,
+      ),
+      onTap: () async {
+        showLoadingOverlay();
+        await item.reload();
+        hideLoadingOverlay();
+        Navigator.push(
+          context,
+          MaterialPageRoute(
+            builder: (context) => TransferOrderLineDetailWidget(item),
+          ),
+        );
+      },
+    );
+  }
+}

lib/widget/order/transfer_order_list.dart

@@ -0,0 +1,162 @@
+import "package:flutter/material.dart";
+import "package:flutter_speed_dial/flutter_speed_dial.dart";
+import "package:flutter_tabler_icons/flutter_tabler_icons.dart";
+
+import "package:inventree/l10.dart";
+
+import "package:inventree/inventree/model.dart";
+import "package:inventree/inventree/transfer_order.dart";
+
+import "package:inventree/widget/link_icon.dart";
+import "package:inventree/widget/paginator.dart";
+import "package:inventree/widget/refreshable_state.dart";
+
+/*
+ * Widget class for displaying a list of Transfer Orders
+ */
+class TransferOrderListWidget extends StatefulWidget {
+  const TransferOrderListWidget({this.filters = const {}, Key? key})
+    : super(key: key);
+
+  final Map<String, String> filters;
+
+  @override
+  _TransferOrderListWidgetState createState() =>
+      _TransferOrderListWidgetState();
+}
+
+class _TransferOrderListWidgetState
+    extends RefreshableState<TransferOrderListWidget> {
+  _TransferOrderListWidgetState();
+
+  @override
+  String getAppBarTitle() => L10().transferOrders;
+
+  @override
+  List<SpeedDialChild> actionButtons(BuildContext context) {
+    List<SpeedDialChild> actions = [];
+
+    if (InvenTreeTransferOrder().canCreate) {
+      actions.add(
+        SpeedDialChild(
+          child: Icon(TablerIcons.circle_plus),
+          label: L10().transferOrderCreate,
+          onTap: () {
+            _createTransferOrder(context);
+          },
+        ),
+      );
+    }
+
+    return actions;
+  }
+
+  // Launch form to create a new TransferOrder
+  Future<void> _createTransferOrder(BuildContext context) async {
+    var fields = InvenTreeTransferOrder().formFields();
+
+    InvenTreeTransferOrder().createForm(
+      context,
+      L10().transferOrderCreate,
+      fields: fields,
+      onSuccess: (result) async {
+        Map<String, dynamic> data = result as Map<String, dynamic>;
+
+        if (data.containsKey("pk")) {
+          var order = InvenTreeTransferOrder.fromJson(data);
+          order.goToDetailPage(context);
+        }
+      },
+    );
+  }
+
+  @override
+  List<SpeedDialChild> barcodeButtons(BuildContext context) {
+    // Transfer orders don't have barcode functionality yet
+    return [];
+  }
+
+  @override
+  Widget getBody(BuildContext context) {
+    return PaginatedTransferOrderList(widget.filters);
+  }
+}
+
+class PaginatedTransferOrderList extends PaginatedSearchWidget {
+  const PaginatedTransferOrderList(Map<String, String> filters)
+    : super(filters: filters);
+
+  @override
+  String get searchTitle => L10().transferOrders;
+
+  @override
+  _PaginatedTransferOrderListState createState() =>
+      _PaginatedTransferOrderListState();
+}
+
+class _PaginatedTransferOrderListState
+    extends PaginatedSearchState<PaginatedTransferOrderList> {
+  _PaginatedTransferOrderListState() : super();
+
+  @override
+  String get prefix => "to_";
+
+  @override
+  Map<String, String> get orderingOptions => {
+    "reference": L10().reference,
+    "status": L10().status,
+    "target_date": L10().targetDate,
+  };
+
+  @override
+  Map<String, Map<String, dynamic>> get filterOptions => {
+    "outstanding": {
+      "label": L10().outstanding,
+      "help_text": L10().outstandingOrderDetail,
+      "tristate": true,
+      "default": true,
+    },
+    "overdue": {
+      "label": L10().overdue,
+      "help_text": L10().overdueDetail,
+      "tristate": true,
+    },
+    "assigned_to_me": {
+      "label": L10().assignedToMe,
+      "help_text": L10().assignedToMeDetail,
+      "tristate": true,
+    },
+  };
+
+  @override
+  Future<InvenTreePageResponse?> requestPage(
+    int limit,
+    int offset,
+    Map<String, String> params,
+  ) async {
+    final page = await InvenTreeTransferOrder().listPaginated(
+      limit,
+      offset,
+      filters: params,
+    );
+
+    return page;
+  }
+
+  @override
+  Widget buildItem(BuildContext context, InvenTreeModel model) {
+    InvenTreeTransferOrder order = model as InvenTreeTransferOrder;
+
+    return ListTile(
+      title: Text(order.reference),
+      subtitle: Text(order.description),
+      trailing: LargeText(
+        TransferOrderStatus.getStatusText(order.status),
+        color: TransferOrderStatus.getStatusColor(order.status),
+      ),
+      onTap: () async {
+        order.goToDetailPage(context);
+      },
+    );
+  }
+}