--- title: External Companies --- ## Companies External companies are represented by the *Company* database model. Each company may be classified into the following categories: - [Customer](#customers) - [Supplier](#suppliers) - [Manufacturer](#manufacturers) !!! tip Multi Purpose A company may be allocated to multiple categories, for example, a company may be both a supplier and a customer. ### Edit Company To edit a company, click on the Edit Company icon in the actions menu. Edit the company information, and then click on Submit. !!! warning "Permission Required" The edit button will not be available to users who do not have the required permissions to edit the company ### Disable Company Rather than deleting a company, it is possible to disable it. This will prevent the company from being used in new orders, but will not remove it from the database. Additionally, any existing orders associated with the company (and other linked items such as supplier parts, for a supplier) will remain intact. Unless the company is re-enabled, it will not be available for selection in new orders. It is recommended to disable a company rather than deleting it, as this will preserve the integrity of historical data. To disable a company, simply edit the company details and set the `active` attribute to `False`: {% with id="company_disable", url="order/company_disable.png", description="Disable Company" %} {% include "img.html" %} {% endwith %} To re-enable a company, simply follow the same process and set the `active` attribute to `True`. ### Delete Company To delete a company, click on the icon under the actions menu. Confirm the deletion using the checkbox then click on Submit !!! warning "Permission Required" The edit button will not be available to users who do not have the required permissions to delete the company !!! danger "Take Care" Deleting a company instance will also remove any orders or supplied parts associated with that company! ### Contacts Each company can have multiple assigned *Contacts*. A contact identifies an individual who is associated with the company, including information such as name, email address, phone number, etc. The list of contacts associated with a particular company is available in the Contacts navigation tab: {% with id="contact_list", url="order/contact_list.png", description="Contact List" %} {% include "img.html" %} {% endwith %} A *contact* can be assigned to orders, (such as [purchase orders](./purchase_order.md) or [sales orders](./sales_order.md)). ### Addresses A company can have multiple registered addresses for use with all types of orders. An address is broken down to internationally recognised elements that are designed to allow for formatting an address according to user needs. Addresses are composed differently across the world, and InvenTree reflects this by splitting addresses into components: - Line 1: Main street address - Line 2: Extra street address line - Postal Code: Also known as ZIP code, this is normally a number 3-5 digits in length - City: The city/region tied to the postal code - Province: The larger region the address is located in. Also known as State in the US - Country: Country the address is located in, written in CAPS Here are a couple of examples of how the address structure differs by country, but these components can construct a correctly formatted address for any given country. UK address format: Recipient Line 1 Line 2 City Postal Code Country US Address Format: Recipient Line 1 Line 2 City State Postal Code Country Addresses can be accessed by the Addresses navigation tab. #### Primary Address Each company can have exactly one (1) primary address. This address is the default shown on the company profile, and the one that is automatically suggested when creating an order. Marking a new address as primary will remove the mark from the old primary address. ## Customers A *customer* is an external client to whom parts or services are sold. To access the customer page, click on the Sell navigation tab and click on Customers option in the dropdown list. !!! warning **Viewing**, **adding**, **editing** and **deleting** customers require the corresponding [Sales Orders user permissions](../settings/permissions.md) ### Add Customer Once the customer page is loaded, click on the New Customer button: the "Create new Customer" form opens. Fill-in the manufacturer information (`Company name` and `Company description` are required) then click on Submit ## Manufacturers A manufacturer is an external **producer** of parts and raw materials. !!! info **Viewing**, **adding**, **editing** and **deleting** manufacturers require the corresponding [Purchase Orders user permissions](../settings/permissions.md) To access the list of manufacturers , click on the Buy navigation tab and click on Manufacturers option in the dropdown list. {% with id="manufacturer_list", url="order/manufacturer_list.png", description="Manufacturer List" %} {% include "img.html" %} {% endwith %} ### Add Manufacturer Once the manufacturer page is loaded, click on the New Manufacturer button: the "Create new Manufacturer" form opens. Fill-in the manufacturer information (`Company name` and `Company description` are required) then click on Submit !!! info "Manufacturer vs Supplier" In the case the manufacturer sells directly to customers, you may want to enable the checkbox `is supplier` before submitting the form (you can also enable it later on). Purchase orders rely exclusively on [supplier parts](#supplier-parts), therefore the manufacturer will need to be set as a supplier too. ### Manufacturer Parts Manufacturer parts are linked to a manufacturer and defined as manufacturable items. !!! warning **Viewing**, **adding**, **editing** and **deleting** manufacturer parts require the corresponding [Purchase Orders user permissions](../settings/permissions.md) #### Add Manufacturer Part To create a manufacturer part, you have the following options: * either navigate to a Part detail page then click on the Suppliers tab * or navigate to a Manufacturer detail page then click on the Manufactured Parts tab. Whichever you pick, click on the New Manufacturer Part button to load the "Create New Manufacturer Part" form. Fill out the form with the manufacturer part information then click on Submit #### Edit Manufacturer Part To edit a manufacturer part, first access the manufacturer part detail page with one of the following options: * either navigate to a Part detail page, click on the Suppliers tab then, in the Part Manufacturers table, click on the _MPN_ link * or navigate to a Manufacturer detail page, click on the Manufactured Parts tab then click on the _MPN_ link. After the manufacturer part details are loaded, click on the icon next to the manufacturer part image. Edit the manufacturer part information then click on Submit #### Delete Manufacturer Part To delete a manufacturer part, first access the manufacturer part detail page like in the [Edit Manufacturer Part](#edit-manufacturer-part) section. After the manufacturer part details are loaded, click on the icon next to the manufacturer part image. Review the the information for the manufacturer part to be deleted, confirm the deletion using the checkbox then click on Submit ## Suppliers A supplier is an external **vendor** of parts and raw materials. To access the supplier page, click on the Buy navigation tab and click on Suppliers option in the dropdown list. {% with id="supplier_list", url="order/supplier_list.png", description="Supplier List" %} {% include "img.html" %} {% endwith %} !!! info **Viewing**, **adding**, **editing** and **deleting** suppliers require the corresponding [Purchase Orders user permissions](../settings/permissions.md) ### Add Supplier Once the supplier page is loaded, click on the New Supplier button: the "Create new Supplier" form opens. Fill-in the supplier information (`Company name` and `Company description` are required) then click on Submit !!! info "Supplier vs Manufacturer" In the case the supplier is a manufacturer who sells directly to customers, you may want to enable the checkbox `is manufacturer` before submitting the form (you can also enable it later on). ### Supplier Parts Supplier parts are linked to a supplier and defined as purchasable items. !!! warning **Viewing**, **adding**, **editing** and **deleting** supplier parts require the corresponding [Purchase Orders user permissions](../settings/permissions.md) #### Add Supplier Part To create a supplier part, you have the following options: 1. navigate to a Part detail page then click on the Suppliers tab 0. navigate to a Supplier detail page then click on the Supplied Parts tab 0. navigate to a Manufacturer detail page then click on the Supplied Parts tab. Whichever you pick, click on the New Supplier Part button to load the "Create new Supplier Part" form. Fill out the form with the supplier part information then click on Submit #### Edit Supplier Part To edit a supplier part, first access the supplier part detail page with one of the following options: 1. navigate to a Part detail page, click on the Suppliers tab then, in the Part Suppliers table, click on the corresponding _Supplier Part_ link 0. navigate to a Supplier detail page, click on the Supplied Parts tab then click on the corresponding _Supplier Part_ link 0. navigate to a Manufacturer detail page, click on the Supplied Parts tab then click on the corresponding _Supplier Part_ link. After the supplier part details are loaded, click on the icon next to the supplier part image. Edit the supplier part information then click on Submit #### Disable Supplier Part Supplier parts can be individually disabled - for example, if a supplier part is no longer available for purchase. By disabling the part in the InvenTree system, it will no longer be available for selection in new purchase orders. However, any existing purchase orders which reference the supplier part will remain intact. The "active" status of a supplier part is clearly visible within the user interface: {% with id="supplier_part_disable", url="order/disable_supplier_part.png", description="Disable Supplier Part" %} {% include "img.html" %} {% endwith %} To change the "active" status of a supplier part, simply edit the supplier part details and set the `active` attribute: {% with id="supplier_part_disable_edit", url="order/disable_supplier_part_edit.png", description="Disable Supplier Part" %} {% include "img.html" %} {% endwith %} It is recommended to disable a supplier part rather than deleting it, as this will preserve the integrity of historical data. #### Delete Supplier Part To delete a supplier part, first access the supplier part detail page like in the [Edit Supplier Part](#edit-supplier-part) section. After the supplier part details are loaded, click on the icon next to the supplier part image. Review the the information for the supplier part to be deleted, confirm the deletion using the checkbox then click on Submit #### Supplier Part Availability InvenTree supports tracking 'availability' information for supplier parts. While this information can be updated manually, it is more useful when used in conjunction with the InvenTree plugin system. A custom can periodically request availability information (via a supplier API), and update this availability information for each supplier part. If provided, availability information is displayed on the Supplier Part detail page. {% with id="supplier_part_availability", url="order/supplier_part_availability.png", maxheight="240px", description="Supplier part availability" %} {% include "img.html" %} {% endwith %} Availability information can be manually updated via the user interface: {% with id="update_availability", url="order/update_availability.png", maxheight="240px", description="Update availability" %} {% include "img.html" %} {% endwith %}