The Suppliers page is a saved list of the companies you buy inventory from. Each supplier has a name, an address, and optional contacts. When you create a purchase order, you can pick a saved supplier from Supplier List to fill in the PO's supplier details, so you don't have to type them every time.
Before you start
- Go to Inventory > Suppliers.
- What you can do depends on your role's Suppliers permissions:
| To | You need |
|---|---|
| See Suppliers in the menu and open the list | Suppliers Read and List |
| Open a supplier | Suppliers Read |
| Create a supplier | Suppliers Create (otherwise Create supplier is disabled) |
| Save changes to a supplier | Suppliers Update |
| Delete suppliers | Suppliers Delete (otherwise Delete is disabled) |
To change permissions, see Managing Roles and Permissions.
The Suppliers list
| Column | Shows |
|---|---|
| Name | The supplier name. Click it to open the supplier. |
| City, State, Country, Zip | The supplier's address. |
Use Search to find a supplier by name. Search matches part of the name and isn't case-sensitive (for example, "parts" finds "Acme Parts Co."). It doesn't search the city or other address fields.
You can show, hide and reorder columns with the columns button at the top right of the list.
Create a supplier
To create a supplier:
- Go to Inventory > Suppliers and click Create supplier.
- Enter the supplier Name.
- Under Supplier Contacts, click Add for each contact, and enter First Name, Last Name, Email and Phone Number.
- Under Address, enter Street Address, City, Zip and Country. Address2 and State are optional.
- Click Create.
Pipe17 returns you to the Suppliers list and shows a Saved message.
Field rules
| Field | Rule |
|---|---|
| Name | Required. Must be unique in your organization. |
| Supplier Contacts | Optional. You can save a supplier with no contacts. If you add a contact, all four fields are required. |
| Must be a valid email address, for example name@example.com. | |
| Phone Number | Digits, spaces, hyphens and brackets only, with an optional + at the start (for example +1 555-0100). |
| Street Address, City, Country | Required. |
| Zip | Required. Letters, digits, spaces and hyphens only. |
| Address2, State | Optional. |
Required fields can't contain only spaces. If a required field is empty or a value has the wrong format, the field turns red with Required or a message like Invalid email address under it, and the supplier isn't saved.
Country and State are free-text fields, but their values are copied to purchase orders as typed, and PO addresses expect a two-letter country code (for example, US) and, for US addresses, a two-letter state code (for example, CA). Enter them in that format.
Edit a supplier
To edit a supplier:
- Go to Inventory > Suppliers and click the supplier's name.
- On the Edit Supplier page, change the name, contacts or address.
- To add a contact, click Add.
- To remove a contact, click the trash icon at the end of its row.
- Click Save.
If you try to leave the page with unsaved changes, Pipe17 asks you to confirm.
Editing a supplier doesn't change purchase orders you already created with it. To bring an existing PO up to date:
- Open the purchase order and edit it.
- Under Supplier Info, update the supplier fields by hand. (Picking the same supplier again in Supplier List doesn't work: a supplier whose name already matches Supplier Name is greyed out.)
- Save the purchase order.
Delete suppliers
To delete one supplier:
- Open the supplier and click Delete.
- In the Delete Supplier dialog, click Confirm.
To delete several suppliers at once:
- On the Suppliers list, select the checkbox next to each supplier.
- Click Delete above the list.
- In the Delete Suppliers dialog, click Delete.
The dialog reminds you that supplier information already entered on purchase orders isn't removed. Deleting a supplier doesn't change or delete existing purchase orders. The supplier no longer appears in Supplier List on new POs or in the Supplier Name filter on the Purchase Orders list.
How suppliers work with purchase orders
Fill in a PO from a saved supplier
To use a saved supplier on a purchase order:
- Go to Inventory > Purchase Orders and click Create purchase order.
- Under Purchase Order Details > Supplier Info, open Supplier List and pick the supplier. You can type part of the name to narrow the list.
- Pipe17 fills in Supplier Name, the contact fields, and the address from the saved supplier. Check them and change anything you need for this PO.
- Finish the purchase order as usual.
Supplier List fills these purchase order fields:
| Purchase order field | Copied from the supplier |
|---|---|
| Supplier Name | Name |
| Contact First Name, Last Name, Email, Phone Number | The first contact in Supplier Contacts |
| Street Address, Address2, City, State, Zip, Country | Address |
Keep in mind:
- Only the first contact in the supplier's Supplier Contacts list is copied to the PO (first name, last name, email and phone). To use another contact, change the contact fields on the PO.
- The values are copied, not linked. You can edit them on the PO, and later changes to the supplier don't update existing POs.
- You don't have to pick a saved supplier. You can type the supplier details directly on the PO.
- Supplier Notes belongs to the PO only. Suppliers don't have a notes field.
- The supplier whose name is already in Supplier Name is greyed out in the list.
For more about purchase orders, see Purchase Orders.
Create a supplier from a purchase order
In Supplier List, choose + New Supplier to open the Create Supplier page. This leaves the purchase order form, and what you've entered on the PO isn't kept (Pipe17 asks you to confirm first). Create the supplier, then start the purchase order again.
Filter purchase orders by supplier
To see the purchase orders for one supplier:
- Go to Inventory > Purchase Orders.
- Click the Supplier Name filter and pick the supplier.
The filter shows POs whose Supplier Name exactly matches the saved supplier's name. Its list only offers saved suppliers, so a PO with a supplier name you typed by hand (and never saved as a supplier) can't be found with this filter.
Suppliers in the API
You can also create, list, fetch, update and delete suppliers with the Pipe17 API (Suppliers endpoints). The API requires a name and an address, and the name must be unique in your organization. The API's checks are lighter than the form's: individual address lines and contacts are optional, and email, phone and postal code aren't format-checked. To keep suppliers consistent, follow the Field rules above when you create them through the API.
Troubleshooting
- "The supplier name already exists."
Another supplier in your organization has the same name. Use a different name, or open the existing supplier from the list and edit it. - A field shows Required, Invalid email address, Invalid phone number or Invalid postal code, and the supplier won't save.
Fill in every required field and check the format (see Field rules above). Each contact you add needs all four fields; remove empty contact rows with the trash icon. - A supplier doesn't appear in Supplier List on a purchase order.
Type part of its name in the field to search. If it still doesn't appear, check on the Suppliers page that it exists and hasn't been deleted. -
Create supplier or Delete is greyed out.
Your role doesn't have Suppliers Create or Delete permission. Ask an admin to update your role. - I edited a supplier, but my purchase orders still show the old details.
Supplier details are copied when you pick the supplier on a PO. Update the existing PO's supplier fields by hand. - The Supplier Name filter doesn't find a PO.
The filter only matches POs whose supplier name is exactly the saved supplier's name. POs with a hand-typed supplier name that differs (even by spelling or spacing) aren't included.
Need Help?
If you need additional assistance:
- Use Ask Pippen, our AI agent, located at the top of the platform page.
- Submit a support request with as much relevant detail as possible. Learn how to submit a request.
We're here to help you succeed with your operations.
Comments
0 comments