Vendors and Product Catalog

On this page

A vendor is a supplier. A product is the vendor-independent definition of something you can buy. A vendor product pairs one vendor with one product and holds that vendor's price, SKU, return period, return policy, and web page for the product.

Vendors and products in the Web App

The Purchasing section of the sidebar holds Vendors and Product Catalog, beside Purchase Orders and PO Items (see Purchase Orders). Vendor products have no list and no sidebar entry of their own. You open a vendor product from the product's Vendor Products grid or from the vendor's Products tab.

The toolbar of the Vendors list and of the Product Catalog list has New and Actions:

  • New lists the create actions of the class. It fetches them each time you open it, shows Loading... while it waits, and shows No Actions when the class has no create actions.
  • Actions is available when records are selected. It lists the workflow actions for the selected records under Actions, and it ends with Delete, which is available only when the selected records can be deleted.

Delete asks for confirmation first. When you may not delete the selected records, it shows "You do not have enough permissions to delete this item." instead. A delete from a grid is refused while another record still refers to the selected record through a reference that the delete does not clear, with the message "Unable to delete/modify object because it is referenced by other database object(s). To delete/modify the object, you need to remove these dependencies first." The message does not name the referring record, and the selected records after it are not deleted. A record's relationship links, attachment links, tags, and flags are removed with it and do not block the delete.

Vendor records

A vendor record is a contact card with a type, a category, and a status. The name is the one value a vendor must have. A vendor also carries a manager, who is a person, a preferred flag, and a currency. A vendor that names no currency uses the installation's default currency. Its contact details are the contact, phone, fax, email, web page, FEIN, and an address that is one free-text block.

The top of the vendor form shows the vendor's name and status, and Vendor: with the address. The General tab has these sections:

  • Details - the vendor's ID, status, name, manager, and currency.
  • Categorization - the preferred flag, workspace, type, tags, and category.
  • Custom data.
  • Contact Info - contact, FEIN, email, phone, fax, web page, and address.

The vendor form's tabs are General, Activity, Products, Purchase History, Custom Data, Related Objects, Notes, History, and Attachments.

The vendor's history records each vendor product added or deleted as Product added or Product deleted, with the product's name. Deleting a vendor deletes its vendor products and its activity.

Product catalog items

A product carries a name, model, manufacturer, part number, MSRP, warranty period and details, purchasing and stocking units of measure with a conversion factor, and a description. The manufacturer is a brand record. It also has its own status, type, and category. A product carries a product class and, for each class a purchase order line could become, a default type and category; a purchase order line carries the same values.

The top of the product form shows the product's name and status, and Product: with the product's ID. The General tab has these sections:

  • Details - name, ID, status, model, manufacturer, part number, and MSRP.
  • Categorization - workspace, type, tags, and category.
  • Warranty - the warranty period and warranty details.
  • Units of measure - the purchasing unit, the conversion factor, and the stocking unit.
  • Custom data.
  • The description, and the product's Vendor Products grid.

The product form's tabs are General, Activity, Asset Categorization, Purchase History, Custom Data, Related Objects, Notes, History, and Attachments.

Deleting a product removes it from the purchase order lines, assets, consumables, and stock rules that name it, and deletes its vendor products. A purchase history keeps those lines, without the product.

The Product Catalog list shows a built-in view only when no view is defined for products. That view shows each product's flag, ID, name, model, manufacturer, type, and status.

Vendor products

A vendor product must name both its vendor and its product, and it has its own status, type, and notes. The database has no rule that makes a vendor and product pair unique, so it does not refuse a second vendor product for the same vendor and product. A vendor product has no currency of its own: its list reads the vendor's currency and appends it to the price in the combined product-and-price and vendor-and-price values.

Two grids list vendor products:

  • The Vendor Products grid on a product's General tab lists the product's vendor products. While the form is editable, it offers New for a Vendor Product, and it has an Actions menu. Its default view shows the vendor, price, return period, return policy, and status.
  • The Products tab of a vendor lists the vendor's vendor products. Unless the form is read-only, it offers New for a Vendor Product, and it has an Actions menu. Its default view shows the product, price, web page, and status. The Actions menu ends with Delete, which is available only when the selected rows can be deleted.

In both grids, double-click a row, anywhere but its check box and its buttons, to open the vendor product's form; no preview window opens. The form opens in the current browser tab, or in a new tab when your setting to open records in a new tab is on. A row whose status is Unavailable, or whose vendor's or product's status is Inactive, is shown grayed out and struck through. When the form has unsaved changes, choosing an action from the grid's Actions menu first asks you to save or discard them.

The vendor product form shows the product and a copy-link control at the top, with the status. Its tabs are General, Notes, and Attachments; it has no Purchase History or Custom Data tab. The General tab is one block with the vendor, product, price, SKU, return policy, return period, web page, and status, in that order. Below it are the custom fields placed on the General tab. Custom fields placed on the Custom Data tab have no place on this form.

Purchase history

The Purchase History tab of a product lists the purchase order lines that carry that product. The Purchase History tab of a vendor lists the lines of purchase orders placed with that vendor. Lines of inactive purchase orders are included in both. The tab's counter counts the same lines.

  • Unlike most grid tabs on a form, Purchase History has a view picker and column filters.
  • The tab has an Actions menu without Delete, and no New button.
  • Opening a row opens the PO item form of that line.
  • When no view is defined for the tab, it shows a built-in view with each line's flag, ID, PO number, PO date, requester, vendor, product, status, quantity, quantity received, date received, and line price, sorted by ID in descending order and without sums.

Permissions

What you can do with vendors and products depends on the permissions that your security roles grant (see Security Roles). Vendors have three permissions, View, Modify, and Delete, and products have the same three. Neither has a separate permission for adding: adding a vendor is governed by Vendor View, and adding a product by Product View. Vendor products have no permissions of their own. In the Web App, editing or deleting a vendor product requires the Product Modify permission.

Statuses, types, and actions in the supplied configuration

A new 2026.1 database created with the Default Workflow contains the statuses, types, workflow actions, and views below; see Default Workflow Configuration. An upgraded database need not contain them, and an administrator may have changed them, so the names can differ. New shows No Actions for a class that has no create actions.

Vendors

Alloy Navigator itself supplies one vendor status, Inactive. In the supplied configuration, vendors have the statuses Active and Inactive and the types Distributor, Manufacturer, Retailer, Service Provider, Supplier, and Unspecified. The supplied configuration makes a vendor's status field read-only, while its type and category stay editable.

In the supplied configuration, New Vendor, captioned Vendor, opens the Create a Vendor form. The vendor class's other create action, API Vendor Creation, runs only for requests made through the API. To add a vendor:

  1. In Purchasing > Vendors, click New Vendor on the list toolbar and choose Vendor.
  2. In the Create a Vendor form, enter the Name and choose the Type. Both are required, and Type is Unspecified when the form opens. The form also has Manager, Category, Contact, Email, Fax, Phone, Web Page, and Address.
  3. Click Submit, or Submit and open.

The new vendor's activity records "New Vendor was created".

Two vendor actions change a vendor's status. Open the vendor and choose the action from the General group of the Actions panel. Each action opens the Provide a Reason form, where you can enter a comment and the time spent:

  • Mark Inactive is offered on an active vendor. It adds the activity "Marked as 'Inactive'" with the comment you enter and sets the vendor's status to Inactive.
  • Mark Active is offered on an inactive vendor. It adds the activity "Marked as 'Active'" and sets the vendor's status to Active. In the supplied configuration, Mark Active is a reopen action.

Unlike the product actions below, these two actions change only the vendor's status. The vendor's vendor products keep their statuses.

Products

Alloy Navigator itself supplies one product status, Inactive, and no product type. In the supplied configuration, products have the statuses Active and Inactive and the types IT Equipment, Office Supplies, Other, Services, and Software, and a set of product categories. The supplied configuration makes a product's status and workspace fields read-only, and it makes none of a product's fields required.

In the supplied configuration, these actions create a product:

  • New Product, captioned Product, opens the Create a Product wizard. The product class's other create action, API Product Creation, runs only for requests made through the API.
  • The product action Copy Product also creates a product.
  • The purchase order action Add Line Item, offered on a Draft purchase order, also creates the product when you choose no vendor product in its wizard and Create Item in Product Catalog is selected, as it is when the wizard opens. See Purchase Order Workflow.

Two product actions change a product's status:

  • Mark Inactive adds the activity "Marked as 'Inactive'" with the comment you enter, sets the product's status to Inactive, and sets each of the product's vendor products whose status is Available to Unavailable.
  • Mark Active adds the activity "Marked as 'Active'" and sets the product's status to Active. When its Mark Vendor Products Available check box is selected, as it is when the wizard opens, it also sets each of the product's vendor products whose status is not Available to Available, so an Out of Stock vendor product becomes Available too. In the supplied configuration, Mark Active is a reopen action. Alloy Navigator offers a reopen action only on inactive records.

On the product form, Copy Product is an icon button without a caption on the form's toolbar; its tooltip reads Copy Product. It runs on one product at a time and opens the Copy this Product form. Mark Inactive and Mark Active are in the General group of the form's Actions panel.

Vendor products

Alloy Navigator itself supplies one vendor product type, General. The supplied configuration adds the types Computer, Consumable, Hardware, Part, Service, and Software License, and the statuses Available, Out of Stock, and Unavailable. It makes a vendor product's status field read-only.

Add a vendor product

  1. On a product's Vendor Products grid or a vendor's Products tab, click New and choose Vendor Product.
  2. In Create a Vendor Product, specify Vendor and Product, both required. The form also has Price, SKU, Return Policy, Return Period, and Web Page. When you start from a product's Vendor Products grid, Product already holds that product, and you can change it.
  3. Click Submit to create the vendor product.

The menu entry runs New Vendor Product; the class's API create action is not offered in the Web App. Choosing the entry opens the form without adding a row until you submit it.

Change a vendor product's status

Three actions move a vendor product between its statuses. Each is offered in the other two statuses, and it can run on several selected rows when each of them is in one of those statuses.

  • Mark Available sets the status to Available.
  • Mark Out of Stock sets the status to Out of Stock.
  • Mark Unavailable sets the status to Unavailable.

To change the status:

  1. On a product's Vendor Products grid or a vendor's Products tab, select the rows to update.
  2. Open the grid's Actions menu and choose the action from the General group under Actions.

Views

The supplied configuration includes shared views of the Product Catalog list: List, All Products, Active, Inactive, by Product Class, Computer, Hardware, Software License, and Consumable. When you have no saved current view, the list opens on List, which shows each product's flag, ID, name, type, category, manufacturer, and model, sorted by name.

The Purchase History tabs of products and vendors have one shared view, List, and open on it. It shows each line's flag, PO number, PO date, requester, vendor, product, status, quantity, quantity received, date received, line price, and ID, newest PO date first, with the quantity, quantity received, and line price summed.