From 3bd6d744def6cd2854f64766cb38c95ed4f86b76 Mon Sep 17 00:00:00 2001 From: erjer-odoo Date: Mon, 24 Nov 2025 09:26:15 -0800 Subject: [PATCH] [ADD] Barcode: Add documentation around retrieving EPC codes --- .../inventory_and_mrp/barcode/operations.rst | 1 + .../barcode/operations/retrieve_epcs.rst | 52 ++++++++++++++++++ .../retrieve_epcs/retrieve-from-gs1.png | Bin 0 -> 26944 bytes 3 files changed, 53 insertions(+) create mode 100644 content/applications/inventory_and_mrp/barcode/operations/retrieve_epcs.rst create mode 100644 content/applications/inventory_and_mrp/barcode/operations/retrieve_epcs/retrieve-from-gs1.png diff --git a/content/applications/inventory_and_mrp/barcode/operations.rst b/content/applications/inventory_and_mrp/barcode/operations.rst index 7b8a57bb10..95870a0f9f 100644 --- a/content/applications/inventory_and_mrp/barcode/operations.rst +++ b/content/applications/inventory_and_mrp/barcode/operations.rst @@ -16,3 +16,4 @@ Daily operations operations/gs1_nomenclature operations/gs1_usage operations/scan_rfid + operations/retrieve_epcs diff --git a/content/applications/inventory_and_mrp/barcode/operations/retrieve_epcs.rst b/content/applications/inventory_and_mrp/barcode/operations/retrieve_epcs.rst new file mode 100644 index 0000000000..d22f0e83cb --- /dev/null +++ b/content/applications/inventory_and_mrp/barcode/operations/retrieve_epcs.rst @@ -0,0 +1,52 @@ +================== +Retrieve EPC codes +================== + +.. |EPC| replace:: :abbr:`EPC (electronic product code)` +.. |RFID| replace:: :abbr:`RFID (radio frequency identification)` +.. |GS1| replace:: :abbr:`GS1 (Global Standards 1)` + +Electronic product codes (|EPC|) are globally unique identifiers assigned to specific products, +allowing items to be distinguished at the individual level. These identifiers support accurate +inventory management by enabling faster cycle counts, streamlined adjustments, and more precise +stock control. + +After EPCs are :ref:`obtained ` from |GS1|, they are +:ref:`encoded ` onto |RFID| tags, which are then applied to products +and used throughout the inventory process. + +.. seealso:: + Set up :doc:`../setup/rfid` + +.. important:: + If using Odoo 18, |GS1|'s Encoder/Decoder tool **must** be used to retrieve EPCs. + +.. _barcode/operations/retrieve_epcs_gs1: + +Retrieving EPCs from GS1 +======================== + +To retrieve an EPC to encode on a tag, use `GS1's EPC Encoder/Decoder tool +`__. + +#. Enter the GTIN-14 barcode of the product in the application identifier :guilabel:`(01)` field. +#. Enter the product's serial number in the :guilabel:`(21)` field. +#. Specify a company prefix length. +#. Specify the size of the tag and its filter value. + +.. image:: retrieve_epcs/retrieve-from-gs1.png + :alt: Complete the fields of the EPC Encoder/Decoder tool. + +.. _barcode/operations/write_epcs: + +Writing EPCs to RFID tags +========================= + +After retrieving the EPCs, you can use an RFID writer to write the EPCs onto RFID tags. The process +to write EPCs varies by RFID writer manufacturer. Refer to the RFID writer's documentation for more +information. + +.. seealso:: + - :doc:`gs1_nomenclature` + - :doc:`gs1_usage` + - :doc:`adjustments` diff --git a/content/applications/inventory_and_mrp/barcode/operations/retrieve_epcs/retrieve-from-gs1.png b/content/applications/inventory_and_mrp/barcode/operations/retrieve_epcs/retrieve-from-gs1.png new file mode 100644 index 0000000000000000000000000000000000000000..c6907da6a1295bbcb9d39484c338a89d188d9459 GIT binary patch literal 26944 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 G(EkNK%1jCX literal 0 HcmV?d00001