COBISOFT Documentation

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== App Options ======

COBI.wms supports a number of options that change the behavior of the app.  These are stored locally on each Android device on which COBI.wms is installed, so each device can have a different configuration.

Following is the list of supported options and their explanation.


===== Warehouse =====

==== Hide inactive warehouses ====

When enabled, this option hides all warehouses marked as inactive in SAP Business One from warehouse selection lists.  \\
Note: The warehouse(s) must be set to "inactive" in SAP Business One for this setting to have an effect.

==== Show inactive bin locations ====

When enabled, bin locations that are marked as inactive in SAP Business One will still be shown in selection lists within COBI.wms. \\
Note: The bin location must be flagged as "inactive" in SAP Business One for this setting to apply.

==== Warehouse ====

You can assign each Android device to a specific warehouse.  Select a warehouse from the drop-down menu in the options screen to assign the Android device to that warehouse, or select "none" to remove the assignment.\\
If a warehouse is selected here, this predefined warehouse will automatically be preselected in all modules when creating a document.

==== Use selected warehouse regardless of base document ====

If the Android device is assigned to a warehouse, and you're booking a document based on another document (e.g. a delivery based on a sales order, or a goods receipt based on a purchase order), then the warehouse codes specified in the lines of the base document will be ignored, and the warehouse of the device used instead.

==== Document filtering ====

Documents can be filtered based on the warehouse the device is assigned to.  This filtering can be enabled on a per-module basis (in other words, for different document types) by checking each of the **Filter: ...** options.

**These filtering options require a User Defined Field to be added:**

^ Category                      ^ Title              ^ Validation                               ^
| Marketing Documents -> Title  | ''CWMS_Warehouse'' | Link to System Object: OWHS - Warehouses |

If the option "Link to System Object" is not available, then disable the Validation and set the data type to Alphanumeric and Length to 8.

**If you added the UDF after already having installed COBI.wms, an additional step is needed to make COBI.wms recognize it:** Execute the SQL command **''DROP VIEW <nowiki>cwms__version</nowiki>''** on your SAP Business One company database (like ''SBODEMODE''), and restart the app.

**Note:** In newer versions of COBI.wms, the view ''<nowiki>cwms__version</nowiki>'' has been renamed to ''<nowiki>cwXX__version</nowiki>'' where ''XX'' stands for the current COBI.wms **minor** version, e.g. ''<nowiki>cw40__version</nowiki>'' for Version ''2.40''.  In this case, the correct SQL command would be ''DROP VIEW <nowiki>cw40__version</nowiki>''.

Note that the UDF is not actually used for all document types.  For example:

  * For Inventory Transfer Requests (in the Inventory Transfer module of the app), the From Warehouse and To Warehouse fields are used.
  * For Production Orders (in the Issue for Production and Receipt from Production modules), the standard Warehouse field is used.
  * For Pick Lists, the app actually queries the lines of each pick list and checks if there is a line matching the correct warehouse.

In those cases, the UDF value is ignored.  The UDF is only used for document types that don't have a standard way of assigning them to a warehouse via fields of the document header, such as Purchase Order (OPOR) and Sales Order (ORDR).

===== Barcode Scanning =====

==== Barcode scan via Bluetooth keyboard ====

This option needs to be enabled if you wish to use a Bluetooth-connected barcode scanner which presents itself as a keyboard to the operating system.

**Note:** Even then, not all such scanners might work properly, especially if you want to use them with GS1 barcodes such as GS1-128 or GS1-DataMatrix.  Using a built-in barcode scanner instead is strongly advised; see [[Recommended Devices]] for recommended Android scanners.

==== Scan to add quantity ====

Normally when you scan an item, the app asks you for the quantity, so you could scan an item and enter 5 to add that many units of that item to the document you're creating.  If you enable this option, the quantity field will automatically contain the number 1, and each subsequent scan of the same item will increase it by 1.  So you could scan five of the same item instead of scanning it once and manually entering the number.

This works well in conjunction with units of measurement.  If you have one EAN number for a **box** of **5 pieces** and another EAN number for a **crate** of **20 pieces** of an item, you can scan these one after another and the app will automatically calculate the various units together, yielding the correct number of total pieces.  Of course, the units and their corresponding barcodes have to be configured correctly in SAP Business One first.

If a GS1 barcode with a quantity field is scanned, it will be counted in as well.  For instance if you scan a GS1 barcode containing the GTIN for a box of 5 pieces and containing a quantity field of 3, the app will know that this means 15 pieces in total.

==== Weight in EAN/UPC codes ====
When enabled, the system attempts to extract embedded weight information from EAN or UPC barcodes. This is useful for products sold by weight, where the barcode includes both the item identifier and the weight encoded according to GS1 standards.

===== Batches and Serials =====

==== Don't show date fields ====

When enabled, optional date fields such as production date or expiration date will be hidden in batch number entry screens. This can help streamline the input process if these dates are not relevant for the workflow.

==== Expiry date is mandatory ====

If this option is enabled, you cannot add a new batch number without filling in the expiry date field.

==== Batch number details ====

Enable this option to show the following additional batch number fields in screens where you add a new batch number:

  * Batch attribute 1
  * Batch attribute 2
  * Notes

==== Serial number details ====

Enable this option to show the following additional serial number fields in screens where you add new serial numbers:

  * Lot number
  * Manufacturer serial number
  * Notes

==== Global serials ====

Theoretically, the same serial number can coincidentally appear for two different types of items.  For example, you could have a PC monitor and a printer that coincidentally have the same serial number.  If you enable this option, the app will assume that this is impossible and let you uniquely identify items by scanning only their serial numbers.

This could be useful, for example, if you have a number of items in SAP Business One that share the same GTIN because they are different variants of the same trade item.  This would render the GTIN in a scanned GS1 barcode insufficient to identify an item.  Another use-case would be if you don't have GS1 barcodes but want to identify items by scanning a single serial number only.

===== Price lists =====

A predefined price list can be selected from the dropdown menu. Once selected, this price list will be automatically applied to all documents that support price list assignment, overriding any default settings from SAP Business One.

===== Receipt =====

==== Default to Inventory UoM ====

When enabled, the default unit of measure (UoM) for receipts will be set to the item’s inventory UoM. This ensures consistency with stock-keeping units and avoids unintended conversions during the receiving process.

==== Don't show orders to DropShip-Warehouses ====

When enabled, purchase or delivery orders assigned to DropShip warehouses will be excluded from the list. This helps to avoid confusion and ensures that only relevant stock-related orders are displayed in the receipt process.

==== Show subnumber of purchase order ====

When enabled, COBI.wms displays the subnumbers of purchase orders during goods receipt. \\
This helps users clearly identify and distinguish between multiple positions on a single purchase order.

===== Picking =====

==== Pick list lines in overview ====

If this option is enabled, the first screen of the Picking module that shows the overview of pick lists will also list the lines of each pick list under it.  You might want to enable this if your pick lists have very few lines each, otherwise it makes little sense to enable this.


==== Display line details by default ====

When this option is enabled, detailed header information such as order number, customer name, delivery date, and address is displayed automatically in the pick list view. This provides immediate context for each pick list.

==== Quick picking ====

If this option is enabled, scanning an item while a pick list is open will set the corresponding line's picked quantity to the correct quantity immediately.  This means that your workflow might become more error-prone, but faster.

==== Stay in pick list after picking is completed ====

Normally, once all lines of a pick list are fully picked and the data is transmitted, the app automatically returns to the overview of all pick lists.  Enable this option to stay in a pick list even after it's finished.  (Typical use-case: transmitting the finished picking data triggers a remote print for shipping labels, after which the labels are put on the packaged goods and a photo attachment added to the pick list.)

==== Ignore sort code of bin locations ====

When enabled, the system will not use the predefined sort code of bin locations to determine the picking order. This allows users to pick items in a custom or manual sequence, regardless of the sorting logic defined in SAP Business One.

==== No batch or serial picking ====

When enabled, the system will completely skip batch and serial number handling during the picking process. This means that:

  * Batch and serial number selection view are not shown

  * Batch and serial numbers are not displayed in the pick list overview

==== Warehouse-Stock-Check ====

When enabled, the system checks the warehouse stock levels for all items listed in each pick list. In the overview screen, a warning icon (exclamation mark) will be displayed next to any pick list where one or more items cannot be fully picked due to insufficient stock.
This helps users identify issues proactively and avoid starting pick lists that cannot be completed.

==== Sort by base documents ====

When enabled, items in the pick list are grouped and displayed according to their originating base documents (e.g. sales orders or production orders). In the case of consolidated pick lists, multiple base document numbers will be shown.
Users can tap on a specific base document number to view only the items associated with that document, making it easier to track and process grouped deliveries.

==== Show if pick list is already started ====

A green 'In Progress' label is displayed in the list view once a user starts the picking process using the new 'Start Picking' button. \\
If another user tries to open a list that is already in progress, a warning message appears: 'This list is already being worked on. Continue?' \\
This helps warehouse staff avoid duplicate processing and improves transparency during ongoing operations.

==== Picking with unit ====

A new 'Pick Unit' button allows users to add or scan a pick unit, enabling picking based on predefined packaging units. \\
This improves efficiency when handling bulk or standardized packaging units.

==== Show text lines from sales orders ====

When enabled, text lines from the original sales order will be displayed during picking. \\
This provides useful information for the picker, such as special handling instructions or customer notes.
Note: Text lines are read from SAP Business One and displayed for reference only.

==== Show transport type ====

Displays the transport or shipping method (e.g. "UPS Express") during the picking process. \\
This helps logistics personnel prepare for packing and shipping according to customer preferences. \\
Note: The transport type must be defined in the sales order in SAP Business One.

==== Group similar articles ====

Groups identical items within the pick list to avoid duplicate lines. \\
This simplifies the picking process and reduces unnecessary repetition for the warehouse staff. \\
Note: Only articles with matching item codes and units are grouped.

===== Delivery =====

==== Copy delivery date from sales order ====

Normally, whenever a delivery note is booked from the app, the Due Date field of the booked delivery note will be set to the current date.  If this option is enabled, and the delivery that you're booking is based on a sales order, then the Due Date field of the sales order will be copied to the Due Date field of the delivery note.

==== Don't show documents for DropShip-Warehouses ====

When enabled, delivery documents linked to DropShip warehouses are hidden in COBI.wms. This ensures that only relevant warehouse-based deliveries are shown, preventing confusion when handling virtual or supplier-managed stock.
Note: A warehouse must be marked as a "DropShip" warehouse in SAP Business One for this filter to take effect.

==== Delivery packing slips ====

Enabling this option will allow you to fill in a packing slip for delivery notes you create.

**Note:** COBI.wms allows you to enter a weight for packaging units, but this does not use the standard weight field in SAP Business One, because that field is automatically calculated and cannot be edited.  For the weight input to work, you have to add the following UDF to your system:

^ Category                                ^ Title           ^ Data type    ^
| Marketing Documents -> Package Content  | ''CWMS_Weight'' | Numeric (11) |

The weight value will be stored into this UDF in **grams**, as an integer value.

==== Delivery packing slips / Unified workflow ====

This option allows you to merge together the picking and packing workflows inside the Delivery module.  (The Picking module becomes practically obsolete if you use this.)

Using this option requires the following UDF on the the packing slip table, to support grouping together multiple packaging units, e.g. pallet stacks:

^ Category                                ^ Title           ^ Data type    ^
| Marketing Documents -> Package Content  | ''CWMS_Stack''  | Numeric (11) |

The UDF is called "Stack" because it was originally added with the idea of supporting "sandwich pallets" (stacked pallets), but it could represent any kind of group.  E.g. you could have smaller boxes inside of larger crates, and in that case the larger crates would be identified by the "Stack" value.

==== Delivery packing slips / SSCC generation ====

With this option, you can have the app generate SSCC codes for each packing unit added to the packing slip.

There are a number of requirements for this option to work:

  - Set your company's GLN number under: Administration -> System Initialization -> Company Details
  - Create the following UDT and UDFs:

=== Required UDT ===

^ Table name   ^ Object type                       ^
| CWMS_SSCC    | No object **with auto-increment** |

This UDT is only used internally by the app to record SSCC numbers that were already generated and make sure no duplicates are used.  It does not contain any information relevant for SAP Business One users.

=== Required UDFs ===

^ Category                                ^ Title               ^ Data type          ^ Valid values ^
| Master Data -> Package Types            | ''CWMS_NeedsSSCC''  | Alphanumeric (1)   | Y / N        |
| Marketing Documents -> Package Content  | ''CWMS_SSCC''       | Alphanumeric (18)  |              |
| User Tables -> CWMS_SSCC                | ''UUID''            | Alphanumeric (36)  |              |

An SSCC will only be generated for a package if the type of the package has the ''CWMS_NeedsSSCC'' field set to ''Y''.

The actually generated SSCC will be stored in the ''CWMS_SSCC'' field of the Package Content table.

==== Delivery packing slips / Batches and Serials ====

The packing slips in SAP Business One cannot contain information about which batch/serial numbers were packed in which packing units.  Enabling this option allows you to record that information, for which you need to create a UDT called ''CWMS_PACK_BSN'' of type ''No object with auto-increment'' and the following UDFs:

^ Title            ^ Type                  ^ Mandatory? ^
| ''DocEntry''     | ''Numeric (11)''      | ✓          |
| ''LineNum''      | ''Numeric (11)''      | ✓          |
| ''PackageNum''   | ''Numeric (11)''      | ✓          |
| ''ItemCode''     | ''Alphanumeric (50)'' | ✓          |
| ''UomEntry''     | ''Numeric (11)''      | ✓          |
| ''BatchNumber''  | ''Alphanumeric (36)'' |            |
| ''SerialNumber'' | ''Alphanumeric (36)'' |            |
| ''Quantity''     | ''Quantity''          | ✓          |

==== Allow rows with quantity of 0 in the delivery ====

When enabled, the system allows delivery documents to include line items with a quantity of 0. This can be useful for retaining item structure or references in the document, even if no quantity is being delivered for specific lines.

==== Choose shipping address for delivery =====

Allows the user to manually select the shipping address during the delivery process. \\
This is useful when multiple delivery addresses exist or when a different address is required than the one stored in the sales order. \\
Note: By default, the shipping address from SAP Business One is pre-filled but can be adjusted here.

==== Hide inactive Package Types (requires UDF) ====

When enabled, this option hides package types that are marked as inactive using a specific User-Defined Field (UDF). This helps to simplify selection lists by displaying only active and relevant packaging options.

To activate this feature, a UDF must be created in SAP Business One:

 **Location:**
  Tools > Customization Tools > User-Defined Fields – Management
  Navigate to: Master Data > Package Types

 **Field Configuration:**

  * **Title:** WMS_Active
  * **Type:** Alphanumeric
  * **Length:** 1
  * **Validation:** Valid Values
    * Y – Yes (Active)
    * N – No (Inactive)
  * **Set Default Value:** Y
  * **Mandatory Field:** Checked

=====  Purchase Return =====

==== Don't show documents for DropShip-Warehouses ====

Hides all purchase return documents that are linked to DropShip warehouses. \\
This ensures that only relevant returns from physical warehouses are visible, avoiding confusion when working with supplier-managed deliveries. \\
Note: The warehouse must be marked as a "DropShip" warehouse in SAP Business One for this setting to apply.

===== Sales Return =====

==== Don't show documents for DropShip-Warehouses ====

When enabled, sales return documents related to DropShip warehouses are hidden in COBI.wms. \\
This helps users focus only on returns processed through physical warehouses and avoids unnecessary document clutter. \\
Note: The warehouse must be flagged as a "DropShip" warehouse in SAP Business One for this option to have an effect.

===== Issue for Production =====

==== Warehouse-Stock-Check ====

When enabled, the system verifies if all required materials for the production are available in stock. If not, a warning icon (exclamation mark) is shown to indicate that the production receipt cannot be completed due to missing stock quantity.

==== Show when an output has been made ====

Displays a indicator when a production output has already been posted for the related production order. \\
This gives warehouse staff immediate visibility into whether materials have already been issued. \\
Note: This information is based on the production status in SAP Business One.

===== Receipt from Production =====

==== Disallow closing of production orders ====

The final booking screen of the Receipt From Production module normally allows the user to check a checkbox to close the production order for which the receipt is being booked.  Enabling this option will hide that checkbox so COBI.wms users cannot close production orders.

==== Automatically close production orders on reaching or exceeding open quantity ====

Automatically closes a production order in SAP Business One once the reported quantity equals or exceeds the remaining open quantity. \\
This ensures that completed orders are finalized without manual intervention, reducing administrative effort. \\

===== Item Info =====

==== Show item picture ====

Displays the item’s image (if available) during item selection or lookup. \\
This supports quick visual identification, especially in warehouses with many similar-looking products. \\
Note: The image must be stored in the item master in SAP Business One.

==== Show item barcode ====

Shows the item’s barcode number(s) during lookup. \\
This helps verify correct scanning and supports barcode-based operations. \\
Note: Barcodes must be defined in the item master data in SAP Business One.

==== Show item price ====

Displays the current item price based on the selected price list. \\
This is helpful for verifying pricing during operations or customer interactions. \\
Note: Prices are retrieved from the SAP Business One price list linked to the user or warehouse.

==== Show item weight ====

Displays the weight of the item as defined in SAP Business One. \\
Useful for shipping, packing, and load planning. \\
Note: The weight must be defined in the item master data in SAP Business One.

==== Show item dimensions ====

Shows the dimensions (length, width, height) of the item. \\
This is useful for packaging, space planning, and transport calculations. \\
Note: Dimensions must be maintained in SAP Business One item master data.

==== Show default bin ====

Displays the default bin assigned to the item. \\
This helps pickers or stockers quickly locate the item within the warehouse. \\
Note: The default bin must be set in SAP Business One if bin location management is enabled.

==== Show serials/batches ====

Shows the serial or batch number details for the selected item. \\
This is critical for traceability and quality control in regulated industries.
Note: The item must be marked as serialized or batch-managed in SAP Business One.

==== Show item description ====

Displays the item’s full description, as maintained in SAP Business One. \\
This gives users additional context beyond the item code.
Note: Pulled directly from the item master data.

==== Show item stocks =====

Displays current stock levels per warehouse or bin location. \\

==== Show linked items ====

Shows linked items (e.g. components) defined in SAP Business One. \\
This is useful for assemblies, multi-part products, or items involved in production processes. \\
==== Show linked documents ====

Shows related SAP documents, such as open sales orders or purchase orders associated with the item. \\
This gives users a full context of item activity.
Note: Based on document relationships in SAP Business One.

===== Miscellaneous =====

==== Allow booking documents as draft ====

Enables saving documents as drafts instead of final postings. Useful for review and approval workflows.

==== Show non-inventory items in the item list ====

Displays items that are not defined as Stock Item, such as services, in item selection lists.

==== Negative stock allowed ====

Normally, the app prevents you from entering quantities in goods issuing documents (such as Delivery or Issue for Production) if the entered quantity is not on hand.  If you enable this option, such quantity checks will be disabled. \\
Note: SAP Business One might still block the booking of such documents if you haven't configured the system correctly.

==== Negative bin location allowed ====

Allows stock levels in bin locations to go negative during transactions. \\
Note: This option must also be enabled in SAP Business One to take effect. \\

==== Negative Quantity allowed ====

Permits entering negative quantities in transactions, e.g. for corrections or returns.
Note: This option must also be enabled in SAP Business One to take effect.

==== Auto-select default bin location of item ====

Automatically selects the default bin location defined in SAP Business One for the item.

==== Auto-select current bin location of item ====

Automatically selects the bin location where the item is currently stored, based on real-time inventory.

==== Username as document remarks ====

Automatically adds the logged-in user's name as a remark in the document. 
Note: If the scanner is configured with a device ID, the device ID will be used as the username instead.

==== Skip screen showing booked document ====

Normally after a document is booked, the app will show you an overview of the document that was booked.  In this screen you can see the document number that was assigned by SAP Business One to the new document, and have labels printed for the lines of the document.  If you have no use of that screen and wish the app to skip it, enable this option.

==== Don't allow over-quantity ====

Prevents users from entering quantities that exceed the amount in the base document.

==== Warning when min./max. inventory is exceeded or undershot ====

Displays a warning if a transaction would push the item below its minimum or above its maximum stock level.\\
//Note: Minimum and maximum inventory levels must be defined in SAP Business One.//

==== Blocking of exceed or undershoot of min./max. inventory ====

Actively blocks transactions that would violate defined minimum or maximum inventory levels.\\
//Note: Minimum and maximum inventory levels must be defined in SAP Business One.//


==== Warning when min.max. inventory is exceeded or undershot per warehouse ====

Displays a warning if the inventory level in a specific warehouse goes below the minimum or above the maximum threshold. \\
This helps users maintain stock levels within defined limits and avoid overstocking or stockouts.
Note: The min./max. inventory thresholds must be set in the item master per warehouse in SAP Business One.

==== Blocking of exceed or undershoot of min./max. inventory per warehouse ====

Prevents transactions that would result in exceeding or falling below the defined minimum or maximum inventory level in a specific warehouse. \\
This ensures strict adherence to stock level rules.
Note: This restriction only applies if min./max. values are configured in SAP Business One for the item per warehouse.

==== Show item images ====

Displays item images (if available in SAP Business One) in item selection.

==== Display FreeText field of lines ====

Shows the “FreeText” field from the document line, useful for custom notes or additional item information.

==== Hide inactive business partners ====

Hides all business partners (customers, vendors) that are marked as inactive in SAP Business One. \\
This helps streamline selection lists and prevents accidental use of deactivated records.
Note: The business partner must be marked as “inactive” in SAP Business One.

===== Session timeout (minutes) =====

Defines the duration of user inactivity (in minutes) before the app automatically logs out. A value of 0 disables the timeout.

===== Sort settings =====

==== Sort documents by: ====

Determines the default sorting order for document lists.
Available options include:

  * Document number
  * Business partner code
  * Business partner name
  * Due date

This setting helps users organize and locate documents more efficiently in the list view.

==== Sort document lines by: ====

Sets the default sorting method for lines within documents such as pick lists or receipts.
Available options include:

  * Item code
  * Item name
  * Item group
  * Warehouse / Bin location

This helps structure line items in a consistent and logical order, making it easier to process documents quickly.

==== Sort stock list by: ====

Controls the default sorting order of items in the warehouse stock overview.
Available options include:

  * Item code
  * Item name
  * In stock
  * Allocated
  * Ordered
  * Available

This helps users quickly identify and prioritize inventory based on quantity or item attributes.

===== Language & Display =====

==== Language: ====

Sets the interface language of the application.

==== Dateformat: ====

Defines how dates are displayed within the app.
//Example: DD.MM.YYYY//

==== Display density: ====

=== Override display density ===

When enabled, allows the user to manually override the system’s automatic density setting.

==== Font scale: ====

Sets the scaling factor for text size in the application interface.\\
Higher values increase readability on smaller screens.