Skip to main content

PET Registration

The PETS plugin adds to ACCELERO a registration of animals (pets) linked to companies. Each PET records basic data about the animal — name, species, breed, color, gender, and date of birth — and receives its own QR Code, which can be printed and read later to quickly locate the animal's registration.

Availability

This feature is provided as a plugin (pets) and must be installed and enabled by the IONGRADE technical team. Contact support to check compatibility with your version of ACCELERO.

Compatibility

Current plugin version: 0.0.2 — compatible with ACCELERO 2.16.5 and 2.16.6.


What the plugin does

FeatureWhat happens in ACCELERO
PET registrationRecords animals with name, date of birth, species, gender, breed, color, linked company, and notes
Link with companyEach PET is associated with a company registered in ACCELERO
PET QR CodeEach PET receives a QR Code with its identifier and name, which can be printed
Search by QR CodeThe camera reads a PET's QR Code and opens the corresponding registration directly
Main benefit

Centralizes the registration of animals in ACCELERO and allows locating a PET's record just by reading the QR Code with the camera, without needing to search manually.


Configuration

Navigation path: Settings > Pets

The plugin adds the Pets item to the Settings menu. There is no additional parameters screen: when you click the item, ACCELERO opens the PET listing directly.

TODO: Add Screenshot

Settings menu with the Pets item visible.


PET listing

The main screen lists all registered PETS.

TODO: Add Screenshot

PETS listing screen showing the columns (Company, PET Name, PET Species, PET Breed, Actions), the New PET button, and the more actions menu.

Columns

ColumnContent
CompanyCompany linked to the PET (the label follows the company nomenclature configured in the system)
PET NameName of the animal
PET SpeciesSelected species (Dog, Cat, Bird, Fish, Rodent, Reptile, or Other)
PET BreedProvided breed
ActionsButton to edit the registration

Screen buttons and actions

Button / ActionFunction
New PETOpens the inline form to register a new PET directly in the listing
SearchOpens the search field by PET description (name)
More actions > DeleteBulk deletes the PETS selected in the list
More actions > Search PETOpens the Search by QR Code screen

Quick registration (New PET)

The New PET button opens an inline form with the fields:

FieldDescription
PET NameName of the animal (required)
PET Date of birthDate of birth of the animal
PET SpeciesList: Dog, Cat, Bird, Fish, Rodent, Reptile, Other
PET GenderMale or Female
PET BreedBreed of the animal
PET ColorColor of the animal
CompanyCompany to which the PET is linked (required)
TODO: Add Screenshot

Inline New PET form open in the listing, with the quick registration fields.


PET editing

When you click to edit a row in the listing, the Edit PET screen opens with the animal's complete registration.

TODO: Add Screenshot

Edit PET screen showing the registration fields, the generated QR Code image, and the Print QR Code button.

Fields

FieldDescription
PET NameName of the animal (required)
PET Date of birthDate of birth of the animal
PET SpeciesDog, Cat, Bird, Fish, Rodent, Reptile, or Other
PET GenderMale or Female
PET BreedBreed of the animal
PET ColorColor of the animal
CompanyCompany linked to the PET (required)
Notes

The plugin's table also has a notes field for the PET. Its presence on the screens in use was not confirmed in the hardcode.

PET QR Code

On the editing screen, ACCELERO displays a QR Code automatically generated for the PET. This QR Code encodes the identifier (petID) and the animal's name.

ButtonFunction
SavePersists the PET registration
BackReturns to the listing
Print QR CodeGenerates a printout of the PET's QR Code for tagging/physical identification
Physical identification

Print the QR Code and attach it to the animal (e.g., on the collar) or to a record card. Then just use Search by QR Code to open the PET's registration directly.


Search by QR Code

Navigation path: in the PET listing, More actions > Search PET.

This screen uses the device's camera to read a PET's QR Code and open the corresponding registration.

TODO: Add Screenshot

Search PET by QR Code screen showing the active camera viewfinder waiting for the reading.

How it works

  1. The screen activates the device's camera (prioritizes the rear camera, when available).
  2. Upon detecting a valid PET QR Code, ACCELERO identifies the encoded petID.
  3. The system automatically redirects to the edit PET screen for the corresponding animal.
Camera permission

The reading requires access to the device's camera. In browsers, it is necessary to authorize the use of the camera when requested.


Permissions

The plugin creates dedicated permissions for PET control, which can be assigned to the operator profiles:

PermissionDescription
Pet - List allView the PET listing
Pet - EditEdit PET registrations
Pet - Create newRegister new PETS
Pet - DeleteDelete PETS

Use cases

Register a new PET

  1. Go to Settings > Pets.
  2. Click New PET.
  3. Fill in at least PET Name and Company (required fields) and the other desired data.
  4. Save. The PET now appears in the listing.

Generate and print a PET's QR Code

  1. In the listing, edit the desired PET.
  2. Check the QR Code displayed on the editing screen.
  3. Click Print QR Code to generate the printout.

Locate a PET by QR Code

  1. In the listing, open More actions > Search PET.
  2. Authorize access to the camera and point it at the PET's QR Code.
  3. ACCELERO automatically opens the registration of the read PET.

Best practices

  • Always link to a company: the link with a company is required and organizes the query of animals by company.
  • Use species from the standard list: prefer the predefined options (Dog, Cat, etc.) to keep the listing consistent; use Other only when necessary.
  • Print the QR Code at registration: generating the QR Code right after registration speeds up later physical identification.
  • Assign the correct permissions: restrict Pet - Delete only to the profiles that should actually remove registrations.

Troubleshooting

The "Pets" item does not appear in the Settings menu

Possible causes:

  • Plugin not installed or enabled.
  • Operator without the PET listing permission.

Solution:

  1. Confirm with IONGRADE whether the pets plugin is installed and enabled.
  2. Check whether the operator's profile has the Pet - List all permission.

The QR Code search does not read the code

Possible causes:

  • Camera permission denied in the browser/device.
  • No camera available.
  • Damaged or low print-quality QR Code.

Solution:

  1. Authorize access to the camera when the browser requests it.
  2. Confirm that the device has a functional camera.
  3. Reprint the QR Code from the PET editing screen, if necessary.

Integration with other modules

Companies

Each PET is mandatorily linked to a registered company. See Companies to understand the registration to which PETS are associated.

Company nomenclature

The "Company" label on the PET screens follows the company nomenclature configured in ACCELERO (which may vary depending on the system's customization).


Next Steps

  • Companies — Understand the company registration to which PETS are linked
  • Plugins — Learn more about ACCELERO's plugin system