Using Vendor Orders

Managing costs is an important part of the commodities business. The Vendor Order system in CATS is a distinctive tool to help anticipate costs, cut down on duplicative entry and streamline vendor reconciliations. The Vendor Order system leverages the standard traffic documents (delivery order, shipping instruction, etc.) as the framework for a customizable and extensible costing rubric. Defining the vendor roles that pertain to specific traffic documents, allows CATS to automatically generate the vendor charges when those traffic documents are created. Additionally, vendor order templates can be set up to mirror individual vendor's price lists.

In this wiki, you can learn:

Vendor orders represent itemized charges that could, for example, be entered on a vendor invoice. Vendor orders are generated in the process of creating traffic forms (also called traffic orders, e.g., DO, SI). Vendor orders for multiple different vendors may be generated from a single traffic form.

Each line item on a vendor order is the charge you expect your vendors to send you after performing a specific action on your inventory (loading, shrinkwrapping, customs fees, etc.).

First, you will set up pre-defined vendor roles, which specify the type of charges that relate to each traffic document type.

Further, you can set up templates for each role. CATS will use these templates to automatically calculate the amount due to each vendor based on a specific traffic form.

When you create a new traffic form, CATS will pull in all of the vendor order line items that it finds that relate to the roles and templates you have set up.

When a new Traffic Form is printed or PDF generated, CATS will pull from the vendor roles for that traffic form to create vendor orders corresponding to the inventory material. CATS will attempt to pull counterparty information automatically based on the source and/or account in the vendor templates file.

Printing the traffic form will update & display the vendor orders. To manually view the vendor orders for a traffic form, first open the traffic form you will be using. From the form's review screen, select the menu option VO to see the vendor orders that have been applied to this traffic form.

Select VO from the traffic form menu to see vendor order information.

CATS will show you a list of the vendor orders that apply to this particular traffic form.

Vendor orders that apply to this traffic screen.

The steps for determining Vendor Order line item creation are:

  1. Match the role traffic form type to this traffic form (Is it a DO? SH? etc.).
  2. Match the source counterparty code to the counterparty code on the role.
  3. Match the source counterparty code to the templates file.

This flowchart describes how CATS determines how vendor roles and templates are used to create vendor order line items on traffic forms.

Flowchart for applying vendor order line items

Here is how CATS applied all of the vendor roles and templates to create the vendor order line items on this particular DO.

Vendor order line item

On the location screen we have used to create a DO, we see the following:

Codes on Location Screen affecting Vendor Orders
  • Warehouse Code: WARYWH
  • Pier Code: WATER
  • Carrier Code: KARRIEZ
  • Customs Broker: SESAME

We also see above that our DO is for account MYSHIP.

Here are the relevant templates that were applied as vendor order line items for our IDO.

Relevant templates applied as vendor orders.

In this example, CATS pulled in the information it found from the appropriate templates. Roles with no matching template come in with no account and no rate (users will manually enter the appropriate values). Roles without account codes on them come in with no account and no rate.

Vendor Order line items must have an account and a rate in order to persist. With the rates and accounts are filled in, CATS lists the total charges that have been reserved for this traffic form.

In our example, we have un-checked the line item for Other Customs Charges and filled in the other missing account codes and rates.

Completed Vendor Order line items on the Traffic form

Pick Save to save your changes and return to the traffic form. Choose Cancel to undo changes and return to the traffic form.

Once you have entered all of the rates and picked Save, CATS will show you the total number of Vendor order line items and their charges.

Summary of charges for VO items on traffic form

If you need to add another vendor order item to this form, you can do so by selecting the Add button when in the VO (vendor order item list) screen.

Pick Add when on the VO item list screen.

Next, CATS will ask you to select an existing role. You can pick from a role, and enter the information as you would when creating a template.

You can do this if you need to add another vendor that also completed this role for this shipment (e.g., if you used two companies for a role or a company that usually does not perform a role for you did it this time).
Enter details on an existing role for this form.

Or, you can pick Cancel to enter a manual role to be applied to this one form.

You can use a manual role to add a one-time vendor order item for any unusual needs you may have for a specific shipment.
Select Cancel to create a new manual role to apply to this specific traffic form.

You will be prompted to add a new manual vendor order item. Pick Yes to proceed.

Select Yes to add a manual role.

Next, enter the details on this manual vendor order item, and pick Save to proceed.

Pick Save to add this manual vendor order item.

The new vendor order item will be displayed on the bottom of the list.

The new vendor order item with manual role will be displayed in the list.

The change in total will be displayed on the order screen in the vendor orders box.

New vendor order items totals.
  1. Open the traffic form you will be using.
  2. Select VO to see the orders to be applied to the form. CATS will show you a list of the vendor orders that apply to this particular traffic form.
  3. Add/review vendor orders for this traffic form by entering the accounts and rates.
  4. Use the checkboxes to include/exclude vendor orders.
  5. Pick Save to save your changes and return to the traffic form.
  • cats/procedures/traffic/vendororders.txt
  • Last modified: 2022/06/21 22:46
  • by wiki_admin