Items, units, groups and vendor items

Load a purchase item with a currency rate

Select an item and apply the document currency conversion value.

Audience: Purchasing staffPermission: purchase_items or purchase_vendor_items capabilityModule v1.7.9
Exact navigationAdmin Area → Purchase → open transaction form → select item
Before you begin
  • Use an account with purchase_items or purchase_vendor_items capability and confirm the intended record or setting before making a change.
  • Follow the exact route above. If the screen or action is absent, check module activation, ownership and permissions rather than using another person’s account.
  • Use controlled test data for configuration, integration, email, AI, payment, portal or automation changes before production-wide use.

What this guide covers

Select an item and apply the document currency conversion value. The instructions reflect the supplied module’s registered menus, controller actions, views, settings and code-backed validation flow.

Exact step-by-step process

  1. Open Admin Area → Purchase → open transaction form → select item.
  2. Select the exact record or option described in this guide.
  3. Complete the displayed fields or action using the rules below.
  4. Save or submit once and resolve any validation response.
  5. Verify the resulting record, status, file, notification or integration effect.

Fields, choices and supported possibilities

Currency-rate recordCurrency/prefix code, stored rate, source/update action and log history.
ConversionThe selected document currency and currency_rate field affect purchase calculations.
Item masterCommodity/item code, description, group/subgroup, unit, purchase price, tax and purchase eligibility.
Vendor-item mappingVendor, group and selected item list, shared visibility and vendor-specific values where exposed.
Files/importAttachments, spreadsheet import rows, validation errors and generated barcode/code.

Code-backed validations and workflow rules

  • Online retrieval depends on the configured external rate source and a successful HTTP response.
  • Review a rate before recalculating live financial documents.
  • Item and vendor-item operations use separate capability groups.
  • Spreadsheet imports can create an error file for rejected rows; review it before retrying.

Expected result and verification

  • The supported load a purchase item with a currency rate flow completes without bypassing permission or validation checks.
  • The resulting record, setting, status, file, delivery event or external response is visible from the relevant workspace.
  • Unexpected validation, provider or linked-record errors are investigated before retrying.

Security, privacy and operational checks

  • Apply least privilege to purchasing, vendor, invoice, payment, return, contract and report permissions.
  • Verify vendor identity, bank/payment details, tax, currency, totals and approvals before creating financial commitments.
  • Treat public links, signatures, portal files, attachments and exported reports as controlled business records.
  • Test settings and automated jobs with controlled records before production-wide use.