Customers

The Customers page lists the B2B customer records in your organization: companies, their company locations, and the individual contacts who buy for them. Each record holds the customer's addresses, payment terms, tax options, tags and linked catalogs. Most records come from an integration such as NetSuite B2B, and you can also add one from the page or through the API.

Where customer records come from

  • NetSuite B2B integration. With Pull customers from NetSuite turned on, the integration imports NetSuite companies, company locations and their contacts every 5 minutes and links them to each other. It also creates a catalog from each company location's price level. See Connect NetSuite B2B to Pipe17.
  • Shopify B2B (beta). This integration can push customers and catalogs from the app to Shopify. Contact Pipe17 support before you use it. See Connect Shopify to Pipe17.
  • The Pipe17 API (/customers).
  • The Create customer button on the Customers page (see Create a customer below).

Creating or editing a customer in Pipe17 doesn't send it to NetSuite or Shopify by itself. Each integration flow has its own setting.


Before you begin

Your role needs these Customers permissions:

To You need
See Customers in the left navigation and open the list List and Read
Open a customer's details page Read
Use Create customer Create
Save changes in View JSON Update

If you don't have Create permission, the Create customer button is disabled and its tooltip explains why. To change permissions, see Roles.


Customer types and statuses

Types

Type What it is
Company The business that buys from you, for example a retailer.
Company Location One location (such as a store or a regional office) of a company. It has its own shipping and billing address, payment terms and catalogs.
Individual A person. For B2B, it's a contact who places orders for a company location. It can also be a single consumer.
Other Any other kind of customer.

Each record is separate, with its own Customer ID. Records are linked to each other: an individual points to the company or company location it belongs to, and a company location belongs to a company. Each link has one or more roles: main contact, allow ordering, admin or assigned. The NetSuite B2B integration creates these links when it imports customers. Pipe17 doesn't link records just because their names match.

Statuses

Status Meaning
Active The customer is in use. New customers created from the page are always Active.
Inactive The customer is kept but not in use.
Deleted The customer was deleted through the API. Filter Status by Deleted to see these customers.

Find a customer

Go to Customers in the left navigation.

The Customers list

Columns

By default, the list shows Customer ID, External Customer ID (the ID in the source system, such as NetSuite), Status, Type, Company, First Name and Last Name. Click Customer ID to open the customer.

To show more columns, click the column settings icon at the top right of the list and select them. You can turn on:

Column Shows
Linked Customer Count How many companies or company locations this customer is linked to.
Catalog IDs How many catalogs are linked to the customer (a count, not the IDs).
State, Zip Code, Country From the billing address.
Email, Phone, Display Name Contact details.
Tags The customer's tags.
Payment Terms Term, days until due, and deposit percentage, for example net, 30 days, 10%.
Tax Exempt true or false.
Updated, Created When the record was last changed and when it was created in Pipe17.

The list is sorted by newest created first. Click a sortable column header to sort by that column.

Search and filters

  • Search matches Customer ID, External Customer ID, company, display name, first name, last name and email.
  • Status filters by Active, Inactive or Deleted.
  • Type filters by Company, Company Location, Individual or Other.
  • Tags filters by tag.
  • Advanced lets you build rules on other fields, for example a created date range.
  • Saved Filters saves the current filters so you can reuse them. See Saving Filters.

The Type filter


View a customer's details

Click a Customer ID in the list. The header shows the customer ID, the status, and Ext ID (the External Customer ID).

A company location's details page

Section Shows
Customer Details The customer type badge, then Contacts, Company, Address (the shipping address) and Tax ID (the tax ID, Exempt or Non-Exempt, and any tax rules). For a company or company location, Contacts lists the linked customer records (usually individuals, but any linked record, including a company, can appear), with each one's name and email (the first 3, with Show more for the rest). For an individual, it shows that person's display name and email.
Payment Information Terms (Net, Fixed, Due at Fulfillment, Due at Receipt, Unknown or Other, with the deposit percentage), payment Notes, and the Billing Address.
Linked Catalogs The catalogs assigned to this customer. Click a catalog ID to open it.
Notes The customer's notes.
Tags The customer's tags.
Event Activity View event log opens the event log for this customer in a new tab, so you can see when it was imported or updated.

Create a customer

The page creates a customer from JSON. Most organizations get customers from an integration instead, so use this for a one-off record or a test.

To create a customer:

  1. On Customers, click Create customer. The Add customer pop-up opens with a sample JSON.
  2. Edit the JSON. The sample sets firstName, lastName, type and paymentTerms. For the full list of fields, click API documentation in the pop-up.
  3. Click Save. The app creates the customer with status Active and opens its details page.

The Add customer pop-up

You can't set customerId, createdAt or updatedAt on a new customer; Pipe17 sets them. If the JSON isn't valid, or includes one of these fields, the pop-up shows an error and doesn't save.

If you set extCustomerId (the External Customer ID), it must be unique in your organization. Saving a customer with an External Customer ID that another customer already uses fails with a Duplicate key error. This applies when you create a customer and when you change it later.


View or edit a customer's JSON

To view a customer's JSON:

  1. Open the customer.
  2. Click the ⋮ menu at the top right, and then click View JSON.
  3. The Customer Source pop-up shows the Pipe17 JSON tab. Inbound Document shows the record as the integration sent it, and Outbound Document shows what Pipe17 last sent out, when there is one.

You can edit the Pipe17 JSON and click Save (this needs Customers Update permission), but only when necessary. Editing JSON skips the app's form checks (the API still checks the JSON's fields and your permissions), and the changes can affect related records and can't be undone. To save, enter a Reason for change and select I have read and acknowledge the disclaimer above. You can't change customerId, type, firstName, lastName, createdAt, updatedAt or orgKey after a customer is created. Never put card numbers or other payment credentials in notes or custom fields. If the next integration sync updates the customer (NetSuite B2B imports about every 5 minutes), it can overwrite your edit, so change the record in the source system when you can.


How customers connect to other features

  • Catalogs. A customer's Linked Catalogs decide which products and prices apply to it. The NetSuite B2B integration creates a catalog from each company location's price level.
  • Orders. B2B orders stay on Orders. With the Shopify connector, turn on Fetch company profile while pulling orders from Shopify to add the B2B company profile to pulled orders. The NetSuite B2B integration matches orders to NetSuite customers by its customer-match rules. See Connect NetSuite B2B to Pipe17.
  • Ask Pippen. On the Customers page, Ask Pippen knows which customers are listed, so you can ask about them.

You can't delete a customer from the page. Customers can be deleted through the API (DELETE /customers/{customerId}), which marks them Deleted.


Troubleshooting

  • Customers isn't in the left navigation
    Your role doesn't have List and Read permission for Customers. Ask an admin to add it.
  • The list says "There are no Customers to display" or "There are no Customers with your search criteria"
    Clear any search and filters first, and check that you're in the right organization. If the list is still empty, your organization may have no customer records yet. For NetSuite B2B, check that Pull customers from NetSuite is on, then wait up to 5 minutes.
  • Create customer is disabled
    Your role doesn't have Create permission for Customers. Hover over the button to see the reason.
  • Save in the Add customer pop-up shows "customerId cannot be set on a new customer" (or createdAt / updatedAt)
    Remove that field from the JSON and save again.
  • A company's Contacts section is empty
    No customer records are linked to it. Contacts are linked to the company or company location they belong to, so check the company location's details page.
  • A customer I created in Pipe17 doesn't appear in Shopify or NetSuite
    Creating a customer only writes the Pipe17 record. Pushing customers to Shopify needs the Shopify B2B (beta) flow. The NetSuite B2B customer flow imports into Pipe17 and doesn't push customers back to NetSuite.
  • Saving JSON on an existing customer fails
    Check that the JSON is valid, that you didn't change customerId, type, firstName, lastName, createdAt, updatedAt or orgKey, and that your role has Customers Update permission.
  • Saving a customer fails with "Duplicate key error"
    Another customer in your organization already has the same External Customer ID (extCustomerId). Use a different value, or update the existing customer instead.
  • NetSuite customers don't import
    See the troubleshooting section of Connect NetSuite B2B to Pipe17.

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.

Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Article is closed for comments.

Have more questions?
Submit a request
Share it, if you like it.