Sell with webERP

Click to search for other posts here on webERP

This is a draft chapter and is not complete.

Selling can be physical goods or intangible services. If you are selling physical goods, you will need stock before selling, either purchasing the stock directly from Suppliers or purchasing raw material to transform through a manufacturing process.

An Enterprise Resource Planning (ERP) system offers significant advantages for sales operations by centralizing customer data, product information, and pricing into a single, unified platform. This integration streamlines the entire sales process, from order entry to fulfillment, by eliminating manual data re-entry and reducing errors. Furthermore, ERP systems provide real-time visibility into inventory levels and order status, enabling sales teams to provide accurate information to customers and manage expectations effectively. The robust reporting and analytics capabilities within an ERP allow for deeper insights into sales performance, customer trends, and forecasting, empowering data-driven decision-making. Ultimately, leveraging an ERP for sales enhances efficiency, improves customer satisfaction, and drives revenue growth through optimized workflows and informed strategies.

Features of using webERP for selling include:

  • Efficiency. Items, Customers, Sales Orders, Shipping Orders, etc. are managed within one controlled system. Fix a problem once and it’s fixed everywhere.
  • Visibility. Because all data and transactions reside and are performed in a single system, it is also available to all users (subject to security roles and privileges).
  • Scalable. Readily scales with users, items, and customers, and can adapt to changing business processes.

This chapter introduces the sales cycle, starting with creating a product with initial stock, and creating a customer. Then a draft sales order or quote is created for the product, the order is confirmed, and then picked and shipped. The customer is invoiced, and finally payment is received. Concepts such as Units of Measure (UOM), Cost Price, Categories and Taxes, and Fiscal Periods are introduced along the way.

The Aircraft Wireless product will be used as an example. Documentation will be stored in the webERP Knowledge Base (integration with WackoWiki CMS).

Goals

  • Receive purchase orders from a customer.
  • Ship goods to a customer from inventory.
  • Receive payment from a customer.

Sales Terms

  • A Customer is a party who purchases goods or services from a Supplier
  • A Purchase Order is a request from a purchaser, for a specific item and according to specific terms. The purchase order is generally considered legally binding when the supplier reports the order was accepted.
  • O2C – Order to Cash – the customer sales and payment process.

Order-to-Cash (O2C) Process

The sales cycle is a sequential process that starts with identifying a prospect or lead, possibly by clicking on an online ad, answering a cold-call, or just walking into your store, progresses to a paying customer, and then repeats.

  • Identify lead
  • Quote sale of product or service
  • Convert the lead to a sale
  • Ship goods or perform service
  • Invoice customer
  • Receive payment
  • Repeat

Not all companies and circumstances require all steps, or may change the order of some steps depending on the product and customer.

The high-level sales and payment process cycle is commonly called Order to Cash, or O2C.

webERP Sales and Accounts Receivable

There are five primary tasks associated with sales orders and accounts receivable in webERP.

  • Counter Sales
    • Create order, invoice and receipt records in one process (order location is “Cash Sales Customer”).
  • Order Process
    • Enter order > Print order and dispatch note > Confirm quantities dispatched and invoiced > Print invoices and send to customers.
  • Produce and Send statements
    • Perform during month-end tasks.
  • Enter Customer Receipts
    • Enter multiple cheques in a one batch or single batch for each transaction listed on a bank statement.
  • Allocate Receipts and Credits
    • Allocations create exchange differences between invoice rate and payment rate (can be un-done and re-done at any time).
  • Step 1. Create a sales order in response to a customer purchase order.
  • Step 2. Advance Sales Order to Quototion status (the cost is determined).
  • Step 3. Advance Sales Order to Confirmed status (a contract now exists and the order can be processed).
  • Step 4. Process order.
  • Step 5. Create a Shipping Order to trigger shipping the ordered goods.
  • Step 6. Assign and pick shipment.
  • Step 7. Complete the shipment, which is a trigger for the invoicing procedure.

TODO correct flow chart per happy path. ignore price lists.

TODO add swim-lane drawing (potentially replace flow chart if superior)

User Permissions

We will login as user “mnestor” (Mary Nestor), who is assigned the Administrator security role and has permission for almost all operations. If a user with a different security role is needed it will be noted.

In actual use each user should have their own login ID and configure a password that only they know. This enabled webWEP to correctly attribute transactions and other events for tracibility. While a single user ID with all security privileges could be used, it circumvents simple role-based user controls that prevent accidental errors. Also any business planning to scale rapidly based on standardized work flows, or that operates in a regulated industry, will require individual user login IDs.

Default (out-of-the-box) security permissions will get you started but you should create bespoke security roles and token assignments based on the structure, staff and roles of your company.

Configuring user permissions is covered in more detail in the webERP User Permissions chapter.

Setup

Before customers can be created the following information is required:

  • Currencies – the currency of the customers’ account.
  • Sales Types – the sales type is combined with the currency of the customer to determine the price list applicable to the customer. Item prices are held against sales types and currencies, and each customer must reference a sales type. The sales type typically reflects if a sale is a trade sale, retail, wholesale, indent, cash sale, special sale, etc., and as many many sales types as necessary can be created. A Sales Type is required to set an Item Price and scripts may assume at least one Sales Type exists.
  • Credit Status – indicate the credit-worthiness of a customer. Each customer must reference a credit status type and some credit status records can be configured to prohibit invoicing.
  • Payment Terms – terms governing payment associated with a customer. As many terms records as necessary can be defined. The customer must reference a parcular payment terms.
  • Tax Groups – the groupings of tax authorities the supplier must collect tax for on customer sales. Each customer branch must refer to a tax group. Sales to these branches will automatically calculate the tax based on where the sale is from and the tax category of the item being invoiced.

A customer must have at least one branch. The branch determines the tax group for where product will be received (typically a specific geographic location or region), and the company location from where product will be supplied (could be the company head office address, but could be a seperate location and even potentially the company warehouse closest to the customer), which taxes may also depend on. In addition, Accounts Receivable requires customer branch information such as delivery address.

The following information must be entered before a customer branch can be created :

  • Sales Areas – for reporting and analyzing sales by area. GL integration can be configured to query the area of a customer to determine the GL account for posting sales to. Each customer branch must referance a sales area (define a “Default” area if more specific sales areas are not needed).
  • Location – somewhere stock can be held, e.g. a warehouse. Each customer branch needs to refer to the stock location for it to draw stock from.

A sales person must be designated for each company branch who is responsible for managing the sales relationship and takes credit for sales to the branch. If sales people are not necessary for your business, you can define a single salesperson naned “Default” or similar.

Currencies

Currencies that will be involved in sales and payment processes will need to be configured in webERP before they can be used.

Currency management is first covered in the Configure a company with webERP chapter.

[Main Menu > Setup > General Setup > Currency Maintenance]

Sales Types

[Main Menu > Setup > Receivable/Payables Setup > Sales Types]

Credit Status Codes

[Main Menu > Setup > Receivables/Payables Setup > Credit Status]

Payment Terms

Payment terms are the agreed-upon terms covering payment by the customer. Often the Supplier provides terms with their purchase order, which are accepted when the supplier accepts the customer’s purchase order. If the terms provided with the purchase order are not acceptable to the supplier, they must be negoiated before the purchase order is accepted.

Payment terms are first covered in the Purchasing with webERP chapter.

[Main Menu > Setup > Receivables/Payables Setup > Payment Terms]

Tax Groups

Tax groups are used to determine the taxes owed to a tax authority based on the customer and the location where the goods are received.

Payment terms are first covered in the Purchasing with webERP chapter but selling is more complicated. Tax to be collected can depend not only on the location of the seller but also the location of the buyer and where custody of goods changes.

The first customer for the Aircraft Wireless is B&E Submarines, a Canadian company operating in the province of British Columbia. B&E will be paying in advance for development costs and the first 10 Aircraft Wireless units.

B&E is located in a different province in Canada than the SCC. the SCC will need to collect 5% of a sale to B&E for GST, seperately collect 7% of a sale to B&E for BC PST and remit both to the CRA (the SCC has not registered for BC PST but will do so if the Aircraft Wireless product is a succes, afterwhich will submit BC PST directly to BC)

First, a new tax authority “CAD BC HST” and tax group “CAD BC” (using the CAD BC HST tax authority) and then B&E will be switched to the new group.

[Main Menu > Setup > General Setup > Tax Group Maintenance]

[Main Menu > Setup > General Setup > Tax Authorities and Rates Maintenance]

[Main Menu > Setup > General Setup > Tax Authorities and Rates Maintenance > CAD BC HST > Edit Rates]

[Main Menu > Setup > General Setup > Dispatch Tax Province]

Sales Areas

Sales are used when reporting on sales and at least one sales area must be defined.

The SCC creates a 000 (Default) sales area, which will be sufficient for now as the SCC does not require reporting on sales based on area.

[Main Menu > Setup > Receivables/Payables Setup > Sales Areas]

Locations

Inventory locations are locations holding stock for shipping to customers. Taxes may also be calculated based on the inventory location (the assigned Tax Province).

Inventory locations are first covered in the Manage Parts, Suppliers and BOMs with webERP chapter.

[Main Menu > Setup > Inventory Setup > Inventory Locations Maintenance]

Users must also be individually authorized to operate on an inventory location, either by user,

[Main Menu > Setup > Inventory Setup > User Authorised Inventory Locations Maintenance]

or by location.

[Main Menu > Setup > Inventory Setup > Inventory Location Authorised Users Maintenance]

Bank Accounts

Bank accounts must be defined for recording sales and payment transactions.

Bank accounts were first covered in the Purchase with webERP chapter.

[Main Menu > General Ledger > Maintenance >  Bank Accounts]

In addition to entering the bank account information, the user must also have authorization to use the bank accounts.

Bank account authorization can be accessed either by user or bank account. 

[Main Menu > General Ledger > Maintenance > User Authorized Bank Accounts]

Set Price

Items to be sold must have a set price. The price may have been set when the item was created (first covered in the Manage Parts, Suppliers and BOMs with webERP chapter), but if not a price can be entered now.

The price can be over-ridden in a sales order.

webERP includes a price list feature that is covered in more detail seperately. TODO include name of chapter.

[Main Menu > Inventory > Maintenance > Select an Item > {select item} > Maintain Pricing]

Create Customer

TODO describe creating customer. 

Create Order

TODO describe issuing order. 

TODO describe issuing order. 

Create Dispatch Note (aka Customer Packing Slip)

A Dispatch Note is an order to ship goods to a customer, and is not a record of goods having been shipped (e.g. the dispatch note may have been lost and the goods never shipped).

TODO describe a dispatch note (aka Customer Packing Slip) and its role.

First, let’s access the Dispatch Note for the order from B&E.

In this case, the Dispatch Note has been previously printed and webERP warns the user to ensure duplicate packing slips are not produced causing more than one shipment to be dispatched.

but if one is persistent, a second packing slip (dispatch note) can still be “printed” (PDF created).

Ship Order

TODO describe shipping order aka transfer custody for an item to the customer.

Confirm Dispatch and Invoice

Although a dispatch note (packing slip) has been created, actually shipping the goods (or providing the service) must be confirmed before the customer can be invoiced.

TODO describe dispatching and invoicing.

Receive Payment

TODO receive payment from customer.

Reports

A variety of reports are available for managing and understanding customers orders and paymentds, indicating item demand, open orders, and customers behind in payment.

Reports that you may find useful include:

  • Unit Sales for a Period

(submitted to webERP project by efeoli (Enrique) to illustrate test results 2024-11-11)

Change Happens

It happens that an order may need to be revised.

  • Cancel order in whole or in part for items the customer no longer requires.
  • Modify orders to mitigate reduce cost, modify delivery date, add forgotten items, substitute an item for some reason, or a multitude of other possible changes.

Summary

This completes the overview of selling with webERP. In this chapter we started by creating a product and creating initial stock we had on hand. We then created our first customer, issued a quotation to them for the product, and continued the workflow by converting the quotation to a sales order, shipping product the customer, invoicing the customer and finally accepting payment.

In the next chapter, we will take a break from operational use and dive into Accounting and Finance, and see how the buying, manufacturing and selling we’ve been doing is reflected in financial reports.

Configure a company with webERP

Click to search for other posts here on webERP

Updated for webERP v5.

webERP is mature web-based open-source ERP (Enterprise Resource Planning) software that supports best practises and multi-user business administration, purchasing, sales, manufacturing and standard double-entry accounting.

The webERP Knowledge Base stores notes and documents/files related to Items, Suppliers and Customers. webERP will be configured to use WackoWiki for its underlying CMS.

Goal

  • Configure webERP to use for the Swift Construction Company (the SCC),

    The SCC is a manufacturing company located in Calgary, Alberta, Canada, operates in Canadian funds and interacts with Canadian and international suppliers and customers.

Procedure

Log into a webERP site using the admin user credentials provided by your systems administrator (the credentials entered into the new site web auto-installer) and create a new user with administrator privileges (e.g. “mnestor” (Mary Nestor).

  • email: e.g. mnestor@swiftconstruction.com
  • system administrator privileges

The original admin user cannot be deleted because it is the start of the tracability chain.

In actual use however it is important each user has their own login with a password only they know. This allows correctly identifying the person performing an operation and provides tracibility. This is especially important if you will be using webERP in a regulated or controlled environment.

Default (out-of-the-box) security permissions generally satisfy a common demonitor of the webERP community, but eventually may be found lacking. Should that happen, it may be more efficient to develop bespoke security roles and security token assignments based on the structure, staff and relationships of the company, than to re-define the default implemention.

Some data may exist in a new database and can generally be deleted if desired to avoid user distraction and confusion.

Location

I will create a new location “Shopton” for the SCC headquarters.

[Main Menu > Setup > Inventory Setup > Inventory Locations Maintenance]

Note: Delivery Address 1 must be given a value (e.g. attempting to create a purchase order without line 1 will cause a “missing delivery address” error).

After creating the new location, change the location of the administration user to the new location (and also the location of any other users). 

Currencies

I will create a new CAD currency as some items will need to be purchased in Canadian dollars. webERP will obtain currency exchange rates from either Google or the European Central Bank (Main > Setup > General > System Preferences).

“CAD” is called the “Functional Currency” because it is the currency the Swift Construction Company operates in.

[Main Menu > Setup > General Setup > Currency Maintenance]

Company Preferences

Operating practices for a specific company are configured in the Company Preferences screen (webERP supports multiple companies and the desired company is selected at login). 

[MainMenu > Setup > General > Company Preferences]

System Parameters

General system-wide behavior is configured in the System Preferences screen. I will quickly review some interesting parameters and give more detail on a a few.

  • Db Maintenance: Daily
    • The “OPTIMIZE DATABASE” query runs daily when the first admin user logs in. Setting this to ‘Allow ‘SysAdmin Access Only” prevents normal users from logging in which can be useful when performing maintenance but users already logged in are not affected (will need to work with your server system administrator if for some reason you require that no users can be logged in except yourself).
  • Date format: Y-m-d.
    • Unless you are forced, use ISO 8601 dates for clarity over familiarity (e.g. 2017-03-08 instead of March 8, 2017 – or is that August 3rd?.
  • Frequently Ordered Items: 0.
    • I don’t know how this variable is used and will have to experiment later.
  • Sales Order Allows Same Item Multiple Times: Yes
    • In general, I don’t want to block any operations and will assume users know what they are doing (and have a backup).
  • Languages to Maintain Translations for Item Descriptions: None
    • Don’t complicate things initially.
  • Picking note must be produced before an order can be delivered: No
    • Again, don’t complicate the process to start with.
  • Auto Update Exchange Rates Daily: Automatic
    • Rates sourced from the EU.
  • Create Debtor Codes Automatically: No
    • I will use my own mnemonic codes (if set to Yes, a sequential integer will be assigned).
  • Create Supplier Codes Automatically: No
    • I will use my own mnemonic codes.
  • Country of operation: Canada
    • Used when calculating shipping costs.
  • Purchase Order Allows Same Item Multiple Times: Yes
    • I will revisit this later, but at least initially I don’t want anything to block operation.
  • Automatically authorise purchase orders if user has authority: Yes.
    • Will disable when someone else is creating new purchase orders.
  • Financial year ends on: December
    • Most common.
  • Maximum Size in KB of uploaded images: 300
    • Default value, may require new photos and screenshots to be reduced before uploading.
  • Directory to store images: part_pics
    • Same name used in weberpdemo company.
  • Directory to store reports: reports
    • Same name used in weberpdemo company.
  • Wiki application: WackoWiki
    • Items, Suppliers and Customer pages have a link to the “Wiki Product Knowledge Base” where supporting notes can be entered, including links to related information and document files (e.g. PDF, DWG, etc.). WackoWiki must be seperately installed and configured and Wiki Path provided by your system administrator.
  • Inventory Costing Method: Standard
    • webERP also supports weighted average but Standard Costing is more obvious for starting with.
  • Auto issue components: Yes
    • Automatically decrement items from stock according to the BOM for an Item when it is manufactured to reduce admin effort.
  • Prohibit Negative Stock: No
    • Keep operations non-blocking but this may be safe to assume and will enable later. I don’t know how this is implemented or if it has an effect on system performance.
  • Log Severity Level: All
    • In general, it is good to see all log entries initially for familarity and reduce later as you more familiar with system. You will need system user access to the server to vew the log files(“Path to log files” is provided by your system administrator).
  • Controlled Items Defined At Work Order Entry:
    • Yes. When set to yes, controlled items (items with individual or batch/lot identification) are defined when a work oeswe at the time of the work order creation (otherwise controlled items ) are entered at the time the finished items are received against the work order
  • Auto Create Work Orders: Yes
    • This causes work orders to be automatically created for the default factory location if a sales order is entered and cannot be satisfied by the current inventory quantity.
  • Default Factory Location: Shopton
    • The location for automatically created work orders.
  • Manager email addresses: provided by your IT services provider
    • You may want to use a common email address for manager email messages at least while becomming familiar with webERP.
  • Using Smtp Mail: credentials provided by your email service provider

[Main Menu > Setup > General > System Parameters]

Summary

This completes basic webERP configuration. More complex configuration will be explained in context. E.g. bank accounts will be presented in the contect of Purchasing or Selling.

Manage Parts, Suppliers and BOMs with webERP

Click to search for other posts here on webERP

Updated for webERP v5.

Product lifecycle management (PLM) is the process of managing a product from top-level assembly to the lowest child item, from concept through design, manufacturing and sales, sustaining engineering, and finally termination. PLM integrates people, data, processes and business systems, and provides a trustable and transparent product information backbone for operations.

Features of using webERP for PLM include:

  • Integrated data – projects, people, hours, other expenses, purchase orders, production builds, bills of materials, etc., are all conveniently managed in one system.
  • A visible, trusted, change management process providing chain of truth.
  • Scales with number of users, items and complexity of item trees.

The custom inductor in the Aircraft Wireless will be used to explore basic PLM using webERP. Documentation will be stored in the webERP Knowledge Base (integration with WackoWiki CMS).

Goals

  • Create child and parent items to model an assembly.
  • Define appropriate work centers.
  • Capture expected manufacturing labour.
  • Identify item vendor information for purchasing.
  • Identify item manufacturer information for purchasing through distribution.(manufacturer part number vs vendor part number).
  • Describe a change management process.

Items and Documentation

Some terms that will will be used include:

  • An Item is something that is sold, purchased or consumed in the operation of the SCC. It can be a tangible and physical, or intangible or virtual.
    • Items are identified using a unique Item Code and also a Part Description. The part description should also be unique but it is not imposed by webERP. After an item has been created, the fit, form and function of the item are not allowed to change. Because an item is essentially not allowed to change it does not have a revision level.
    • A Part Description is typically contructed by combining the most important attributes of the item.
  • Item Documentation describes an an item and can be revised, for example to correct errors, improve clarity or adapt to changing needs. Documents have a revision level and the revision level is updated when the document is changed following a change management process, such as an Engineering Change Order (ECO) process.
  • A Release is a milestone in the lifecycle of a product, and generally is a gate between one phase of the item lifecycle and the next (such as from design to manufacturing).

User Permissions

We will login as user “mnestor” (Mary Nestor), who is assigned the Administrator security role so it won’t be necessary to understand the inner workings of the webERP role-based user security scheme before actually working with webERP. The Administrator role has all the necessary permissions for most operations (except occassionally a user with the Accountant security role will be needed for finance related operations).

In actual use however it is important each user has their own login with a password only they know. This allows correctly identifying the person performing an operation and provides tracibility. This is especially important if you will be using webERP in a regulated or controlled environment.

The default (out-of-the-box) user permissions and security configuration will generally be sufficient to get you started. Eventually though you will want to create bespoke security roles and token assignments based on the structure, staff and relationships of your company.

Create Inventory Categories

The Swift Construction Company, like many engineering services and product companies, grew organizationally from a single-person engineering department to eventual separate mechanicals and electronics development teams. Knowing if a thing is a “mechanical thing”, or an “electronics, firmware, or basically anything but a mechanical thing” indicates which department is responsible for it.

As a result of the SCC’s organization structure, physical things are categorized as either either ELEC or MECH for either electrical or mechanical consumable raw materials and CAT for finished goods (catalogue items).

[Main Menu > Setup > Inventory Setup > Inventory Categories Maintenance]

ELEC Inventory Category

The ELEC category is used for electronics raw material items which are consumed in the production process for other items.

MECH Inventory Category

The MECH category is used for mechanical raw material items which are consumed in the production process for other other items.

CAT Inventory Category

The CAT (short for “catalogue”) are items which are sold (and either purchased or manufactured).

Define Units of Measure

An item’s Unit of Measure (UOM) specifies how the item is to be inventoried and consumed. webERP supports different purchase units, for example to purchase in US gallon jugs but inventory and consume in millilitres. 

A new unit of measure is typically created if needed when a new item is created, but knowing we will need centimeters and inches they can be added now.

[Main Menu > Setup > Inventory Setup > Units of Measure]

Create Suppliers

SCC policy is to identify and/or create a supplier when a new bought-in Item is created. A new supplier may also be created when changing suppliers for an existing Item.

Access menu [Main Menu > Payables > Maintenance > Add Supplier] to add a new supplier.

Suppliers can be imported from a CSV file which may be convenient if migrating to webERP from another system. 

We will ignore some supplier details, such as the tax group, which are not required until the item is to be purchased (this will be covered in Purchase with webERP).

[Main Menu > Payables > Maintenance > Select Supplier > Search]

Create Items

Create the inductor item as well as the items that will be in the bill of materials (BOM) for the inductor, according to the inductor design.

The SCC defines an Item Code as a 7-digit sequentially assigned integer, starting with 1000001 but written with a hyphen after the third digit for easy recollection per SCC QSP Product Lifecycle.

The Part Description follows the Noun-Adjective-Size-Modifier (NASM) rule, starting with a noun that describes the essence of the item per SCC QSR Part Name.

Item CodePart Description
100-0001WIRE, MAGNET, 38AWG, POLY
100-0002MAG, FERRITE ROD, 1/4IN X 4IN, MATL=61
100-0003TAPE, ELECTRICAL, 3/4″, BLUE, VINYL
100-0004IND, 830UH, AIRCRAFT WIRELESS

100-0001 Wire, Magnet

The unit of measure (UOM) for the wire will be centimeters (cm), which means the wire will be received, stocked (kept in inventory) and consumed measured in centimeters. However, it will be purchased by the spool, which is the supplier’s UOM (the datasheet for the wire indicates a spool has 19,300 feet).

The consumption unit of measure will generally be the most relevant for any transaction other than purchasing or inventory control. When purchasing, the unit of measure will generally be determined by the vendor, and webERP supports a separate purchase unit when creating a purchase order. This means in an inventory audit that it will be necessary to convert from the counted number of full spools, add fractions of a spool for any partial spools, and convert to centimeters. However, the conversion factor can be found in the item master purchasing data and the math is not complicated.  

[Main Menu > Inventory > Maintenance > Add A New Item]

Enter Purchasing Information

In addition to the supplier details, notice a conversion factor of 588,264 was entered. This is the multipler to convert the supplier UOM to the item UOM.

The conversion factor was determined based on the spool length of 19,300 feet according to the supplier’s and manufacturer’s datasheets.

19,300 feet × 12 inches per foot ​× 2.54 cm​ per inch = 588,264 cm

[{item} > Item Maintenance > Maintain Purchasing Data]

Enter Standard Cost

The standard cost per cm is $0.0002632.

$0.0002632 = $154.83 per spool divided by the conversion factor of 588,264 cm per spool.

A standard cost for an item of less than 0.01 per UOM in the associated currency may not produce meaningful analysis due to the precision of calculations and loss of precision due to potential truncation and rounding. In this case, for more accurate results use either inventory cost (using the selected inventory costing model) or the actual order cost taken from purchase orders.

[{item} > Item Maintenance > Maintain Standard Cost]

Upload Documentation

Upload the manufacturers’ datasheet to the Product Knowledge Base Wiki.

[{Item} > Item Inquiries > Wiki Product Knowledge Base]

Exactly what documentation should be uploaded will vary for each item, but can always be added to later should information be found wanting. Documentation can also be updated if a newer version becomes available.

For more rigorous control over manufacturing documentation, consider using SeedDMS which uses a submit, review, approval workflow.

100-0002 Mag, Ferrite

[Main Menu > Inventory > Maintenance > Add A New Item]

Enter Purchasing Information

[{item} > Item Maintenance > Maintain Purchasing Data]

Enter Standard Cost

[{item} > Item Maintenance > Maintain Standard Cost]

Upload Documentation

Upload the catalogue page, datasheet and application note to the Knowledge Base.

[{Item} > Item Inquiries > Wiki Product Knowledge Base]

100-0003 Tape

[Main Menu > Inventory > Maintenance > Add A New Item]

Enter Purchasing Information

[{Item} > Items > Item Maintenance > Maintain Purchasing Data]

Enter Standard Cost

[{Item} > Items > Item Maintenance > Maintain Standard Cost]

Upload Documentation

Upload the product datasheet and MSDS (Masterial Safety Data Sheet) to the Knowledge Base.

[{Item} > Item Inquiries > Wiki Product Knowledge Base]

100-0004 Inductor

Item 100-0004 is a custom inductor that will be manufactured using the items listed in its’ Bill of Material (BOM). An item must be explicitly specified as Manufactured in the Item Properties to enable creating a BOM.

[Main Menu > Inventory > Maintenance > Add A New Item]

Enter Standard Cost

Set the standard cost to be the total calculated cost including labor and any fixed overhead costs.

[{Item} > Item Maintenance > Maintain Standard Cost]

Enter Standard Price

If an item will be sold, it must have a price associated with it. For example, the SCC sells the 100-0004 inductor seperately as a repair item for maintenance technicians (the inductor can be damaged by a nearby lightning strike).

[{Item} > Item Maintenance > Maintain Pricing]

Create Bill of Materials

The raw materials needed to manufacture qty 1 of item 100-0004 are specified in a Bill of Materials (simply, the “BOM”). Materials listed in a BOM are also called child items or children of the parent item.

Child items on the BOM for the inductor will be auto-issue, which will simplify creating a manufacturing work order later.

[Main Menu > Manufacturing > Maintenance > Bills Of Material]

To print a BOM, use one of the available reports for the best results:

  • [Main Menu > Manufacturing > Inquiries and Reports > Bill of Material Listing ]
  • [Main Menu > Manufacturing > Inquiries and Reports > Indented Bill of Material Listing ]

Upload Documentation

Upload manufacturing process documentation such as a Work Instruction to the Knowledge Base.

[{Item} > Item Inquiries > Wiki Product Knowledge Base]

Change Management Process

As mentioned previously, convention prohibits the essence of an item (its’ fit, form and function) to be changed once created. Because an item is not allowed to change, it by definition cannot be revised and hence does not have a revision level.

However, documentation releated to an item is allowed to change. This results when improvements or changes are made to an item (but without affecting the item’s fit, form or function), or simply to correct errors or omissions. Organizations often define a two-level revision code, with the major code indicating a change to the item and the minor code indicatiing a change to the document but not the item (e.g. a correction or clarification).

An organization often defines a change management process, which generally uses a form listing the affected Items and documentation, the reason for the change, and record of approval by all affected parties.

 

Git for the color blind and other tips

Here are several tips that have helped me, someone who uses Windows most of the time and Linux some of the time, finds color coded output a visual nightmare and prefers simplicity.

Ignore File-mode Changes on Windows

Git thinks executable files have changed when going between ‘nix and Windows systems, when it’s only that the file mode is being interpreted differently. On a Windows system, set your global config (~/.gitconfig) to ignore file mode changes. You may also need to check the local (repository) configuration.

Check your global and local configs:

$ git config --global core.filemode
$ cd gitrepo
$ git config core.filemode

Set configuration to ignore file mode changes (as needed):

$ git config --global core.filemode false
$ cd gitrepo
$ git config core.filemode false

Disable Color-coded Git Output

Many developers couldn’t live without color-coded command-line output, but you may find (as I do) that less than perfect color vision combined with high ambient lighting and some screen glare results in a display that is largely incompressible.

To disable color-coded output in a particular repository::

$ git config color.ui false
$ git config color.diff false
$ git config color.status false
$ git config color.branch false
$ git config color.interactive false

To globally disable color coding, add the –global option (but be aware you may also need to configure the global ~/.config file) .

Use .gitignore

Applications can dynamically generate files, such as compiled templates, that you don’t want Git to do anything with. Achievo writes files to achievotmp/, which can be added to the project’s .gitignore file (which may already be done if you are cloning the canonical project repository in GitHub).

achievotmp/

Also, your development environment, especially is you are using an IDE (Integrated Development Environment) such as PhpStorm or NetBeans, may create its own project directory that you also want Git to ignore. Because this is developer-specific, add an entry to your global ~/.gitignore file for Git to ignore them.

.idea/

Further Reading