2
0
mirror of https://github.com/inventree/InvenTree.git synced 2025-04-30 12:36:45 +00:00
InvenTree/docs/docs/barcodes/external.md
Oliver 2ffd2354eb
Documentation integration (#4653)
* Add documentation under docs/ directory

* Add CI workflow for mkdocs configuration checking

* Add documentation issue template

* update pip-tools?

* Update .gitignore files

* Fix .gitignore rules

* Improve release notes page

* remove references to old repo
2023-04-22 22:40:29 +10:00

1.9 KiB

title
title
External Barcodes

External Barcodes

In addition to defining an internal barcode format, models which have associated barcode information also allow arbitrary external (third party) barcodes to be assigned or "linked" to items in the database.

For example, you have just purchased a reel of capacitors from a supplier, which comes provided with a sufficiently unique barcode or qr-code. Instead of printing an internal barcode, the existing barcode can be scanned and linked to the specific reel (which is a Stock Item).

Linking to external barcodes allows an alternative barcode workflow, which may be especially useful when dealing with in-feed components which are received from external suppliers.

!!! tip "Dealer's Choice" The use of external barcodes is entirely up to the user, if it is deemed to be convenient.

Linking Barcodes

Via the API

Facility for barcode linking (and un-linking) is provided via the API.

  • The /api/barcode/link/ API endpoint is used to link a barcode with an existing database item
  • The /api/barcode/unlink/ API endpoint is used to unlink a barcode from an existing database item

Via the Web Interface

To link an arbitrary barcode, select the Link Barcode action as shown below:

{% with id="barcode_link_1", url="barcode/barcode_link_1.png", description="Link barcode" %} {% include 'img.html' %} {% endwith %}

{% with id="barcode_link_2", url="barcode/barcode_link_2.png", description="Link barcode" %} {% include 'img.html' %} {% endwith %}

If an item already has a linked barcode, it can be un-linked by selecting the Unlink Barcode action:

{% with id="barcode_unlink", url="barcode/barcode_unlink.png", description="Unlink barcode" %} {% include 'img.html' %} {% endwith %}

Via the App

External barcodes can be linked to (or unlinked from) database items via the mobile app