====== Capture GRPO Images ======
==== Overview ====

The Image Capture allows Produmex Scan to attach photos directly to incoming logistics documents such as Goods Receipt PO and Sales Return.\\
\\
**Captured images are:**
  * Saved into SAP’s Attachment system using a structured file name format.
  * Linked in Produmex Scan internal tables for reference (note: after posting, the file path is no longer stored in the Scan table).

**Supported document flows:**
  * GRPO
  * Free GRPO
  * Sales Returns (SDN and SRR)
<callout type="warning">**Limitation:** For GRPO/Free GRPO, if Serial Number is set to "On Release Only", you cannot receive items by scanning the serial number. In this case, only the quantity can be entered, and images cannot be captured.
</callout>
==== How Image Capture Works ====
When enabled, users can take one or more pictures directly from the scanning flow. Images are validated, saved to SAP’s attachment path, and linked to the document line.

**The Image Capture process has three major steps:**

  - When a picture is taken, it is stored in the device’s memory.
  - When the entry is created, the image is saved to the database.
  - After the document is posted, the image is saved as a JPG file in the attachments folder and then it will be removed from the database.


**The capture behavior depends on the warehouse setup and item type:**
^ Warehouse / Item Type                          ^ Capture Location                         ^
| Bin-managed warehouse                          | Detail screen (bin/batch/serial screen)  |
| Non-bin-managed warehouse + batch/serial item  | Batch/serial detail screen               |
| Non-bin-managed warehouse + normal item        | Line screen (when line is selected)      |

<callout type="info">**Note:** Images are saved when the mobile client entry is created, typically when the quantity is added on the line screen. For batch/serial or bin-managed items, this occurs after clicking the Update button on the detail screen.
</callout>

**GR PO - Image Capturing is enabled on the Mobile Client:**\\
\\
{{:implementation:scan:custom:general:scan_capture_image.gif?300 |}}<callout type="info">**Note:** The Camera button becomes active only when a line is selected to which an image can be added, as you can see on the example screen recording above!</callout>
<grid></grid>
==== Produmex Scan Settings ====

An additional setting for the image capturing called **Produmex Scan Media** is available on the Add-On’s Settings screen.\\
**This tab allows users to configure:**
  * Capturing behavior
  * File naming conventions
  * Image limits

{{ :implementation:scan:custom:general:pmx_scan_media.png?nolink |}}

**Attachment file name format**\\
  * **Default:** <UserName>_<DocEntry>_<LineNum>_<BatchOrSerial>_<Timestamp>.jpg
  * Defines how each attachment file is named. Unsupported characters or spaces are automatically replaced with underscores (_).

<callout type="info">
**Important:**
  * The file name must include the following placeholders:** <UserName>, <DocEntry>, <LineNum>, and <Timestamp>**
  * The order of the placeholders can be changed, and additional text can be added to the file name.
  * **<BatchOrSerial>** is optional.
  * **<UserName>** = Employee ID.
  * <**Timestamp>** = UTC datetime or any other datetime that was set.
  * **.jpg** is required.
</callout>

**Attachment maximum file size (MB)**\\
  * **Default:** 3 MB
  * It can be modified, images larger than the set limit cannot be captured or uploaded.

**Capture images for incoming documents**\\
  * **Default:** Unchecked
  * When enabled, image capture becomes available for GRPO, Free GRPO, and Sales Returns flows.

**Maximum number of attached images per incoming document**\\
  * **Default:** 20
  * Restricts the total number of photos per document.

**Show preview when capturing images**\\
  * **Default:** Checked
  * The CameraApp will always display a preview before saving, regardless of this setting.

Once the document is posted, the physical file is saved under SAP **General Settings → Path for Attachments.** The file name is generated using the defined template, and Produmex Scan stores the final file path in its internal tables.

{{ :implementation:scan:custom:general:sap_general_setting_path.png?nolink |}}