Trade Partners – User GuideFind and manage the Trade Partner list

Find and manage the Trade Partner list

Search and filter the Trade Partner List, choose its columns, download master data for selected partners and archive partners you no longer use.

Applies to: the Trade Partner List tab of the Trade Partners module under Master Data

Audience: Anyone who looks up, reviews or maintains the companies in a Wholechain account

Prerequisites: a Wholechain account and permission to view master data; permission to edit master data to archive a Trade Partner

Related: Get started with Trade Partners; Add Trade Partners; Trade Partner details; Invitations; Trade Partners FAQ; Master Data Settings; Archived; Browse and manage Locations; Reference Guide: Module overview; Reference Guide: Trade Partner List; Reference Guide: Archive and restore; Field and action reference

Purpose

See every Trade Partner in your network with its connection status, identifiers and number of Locations. Narrow a long list to the partners you need, show the columns that matter to you, download master data for selected partners and archive partners you no longer work with.

Before you begin

  • Select Trade Partners under Master Data in the left-hand navigation bar. The page opens on the Trade Partner List tab. The Invites tab sits next to it (see Invitations).
  • Your own company is in the list too. It shows (Self) after its name and is Wholechain Connected.
  • The Connection column shows one of three statuses: Wholechain Connected, Externally Connected or Not Connected. They are described under Connection values below, and in full in Get started with Trade Partners.

Read the Trade Partner List

The tab shows the number of Trade Partners beside its name, a search box, the filters Filter by TP Name(s) and Filter by Connection Status, the Add Trade Partners button, a gear icon, a table and page controls. The columns are described in the Field and action reference.

The Trade Partners list. Use search, the two filters, and Add Trade Partners at the top of the page.
The Trade Partners list. Use search, the two filters, and Add Trade Partners at the top of the page.

The Trade Partners list. Use search, the two filters, and Add Trade Partners at the top of the page.

To add partners, select Add Trade Partners (see Add Trade Partners). To open a partner's record, select its name (see Trade Partner details).

Open Trade Partner settings

Click the gear icon at the top of the Trade Partners page (or open Settings with the gear icon at the bottom of the left-hand navigation bar), which opens Master Data Settings > Trade Partner. The options there are described in Master Data Settings and are not repeated here.

Search the list

Click the search box

Click in the search box on the Trade Partner List tab.

Type part of a name, identifier, DUNS or PGLN

Type part of a name, an identifier, a DUNS number or a PGLN. The table updates as you type.

Type part of a name in the search box to narrow the list.
Type part of a name in the search box to narrow the list.

Type part of a name in the search box to narrow the list.

Search matches the Trade Partner Identifier:

Search also matches the Trade Partner Identifier.
Search also matches the Trade Partner Identifier.

Search also matches the Trade Partner Identifier.

It also matches a DUNS number:

Search also matches a DUNS number.
Search also matches a DUNS number.

Search also matches a DUNS number.

And a PGLN:

Search also matches a PGLN.
Search also matches a PGLN.

Search also matches a PGLN.

Tip. The search box placeholder reads "TP Name, TP ID, DUNS, GLN". A PGLN value is matched by search.

Filter the list

Filter by name

Select Filter by TP Name(s)

Select Filter by TP Name(s).

Choose one or more names

Choose a name from the list. Choose more than one to see partners that match any of the names you picked.

Open Filter by TP Name(s) to pick trade partners from a list.
Open Filter by TP Name(s) to pick trade partners from a list.

Open Filter by TP Name(s) to pick trade partners from a list.

You can select more than one name. The list shows trade partners that match any selected name.
You can select more than one name. The list shows trade partners that match any selected name.

You can select more than one name. The list shows trade partners that match any selected name.

Filter by connection status

Select Filter by Connection Status

Select Filter by Connection Status.

Choose one or more statuses

Choose Wholechain Connected, Externally Connected or Not Connected. You can choose more than one.

Filter by connection status: Wholechain Connected, Externally Connected or Not Connected.
Filter by connection status: Wholechain Connected, Externally Connected or Not Connected.

Filter by connection status: Wholechain Connected, Externally Connected or Not Connected.

Select two statuses to see trade partners that match either one.
Select two statuses to see trade partners that match either one.

Select two statuses to see trade partners that match either one.

Combine filters

Filters work together: a partner must match every filter you set, and the search text. If nothing matches, the table shows No Data.

Filters work together. If no trade partner matches every filter, the list shows No Data.
Filters work together. If no trade partner matches every filter, the list shows No Data.

Filters work together. If no trade partner matches every filter, the list shows No Data.

Clear filters

Remove each filter chip with its x, and clear the search box with its x. There is no single clear-all button.

Remove a filter chip or clear the search box to return to the full list.
Remove a filter chip or clear the search box to return to the full list.

Remove a filter chip or clear the search box to return to the full list.

Why it matters. Filtering lets you check, for example, which partners are not yet connected before you plan invitations.

Choose which columns to show

Open Column Display

Select the filter icon at the right end of the table header. The Column Display panel opens.

Show or hide columns

Clear the check box beside a column to hide it, or select it to show it.

Change the column order

Use the up and down arrows, or drag the handle at the left of a row, to change the column order.

Reset the columns

Select Reset to return to the default columns.

Select the filter icon at the right of the table header to open Column Display.
Select the filter icon at the right of the table header to open Column Display.

Select the filter icon at the right of the table header to open Column Display.

Use the arrows or drag handles to reorder columns, and the check boxes to show or hide them.
Use the arrows or drag handles to reorder columns, and the check boxes to show or hide them.

Use the arrows or drag handles to reorder columns, and the check boxes to show or hide them.

Tip. The panel lists both GLN and PGLN. The table column for company numbers is headed PGLN.

Download master data for selected Trade Partners

Select the Trade Partners

Tick the check box at the start of one or more rows. A selection bar appears at the bottom of the page and shows how many rows are selected.

Select Download

Select Download in the selection bar. Wholechain downloads an Excel file with the master data of the selected Trade Partners, showing all fields found on the Details tab.

For an account-wide download of master data, see Master Data Settings.

Archive a Trade Partner

Find the Trade Partner

Search or filter the list until you see the partner you want to archive.

Open the row menu

Select the ... menu at the end of the row, then select Archive. To archive several partners at once, tick their check boxes, then select Archive in the ... menu of the selection bar.

Archiving a Trade Partner also archives its Locations and removes all aliases from the partner and its Locations. Documents tagged with the partner or its Locations stay in the Documents tab, but the Trade Partner and Location tags are removed from them.

Archived Trade Partners are listed in Master Data Settings > Archived, on the Trade Partners tab. To restore them, see Archived. For the full effect of archiving, see the Reference Guide: Archive and restore.

Expected result

  • The count beside the tab name, such as Trade Partner List 2, and the footer, such as 1-2 of 2 items, match what you filtered.
  • The table shows the columns you chose, in the order you chose.
  • An archived Trade Partner is listed in Master Data Settings > Archived, together with its Locations. See Browse and manage Locations for the Locations side.

Troubleshooting

  • The table shows No Data. A partner must match every filter and the search text. Remove a filter chip with its x, and clear the search box with its x, until the partners you expect appear. There is no single clear-all button.
  • A search finds nothing. Search matches the partner name, the Trade Partner Identifier, the DUNS number and the PGLN. Check that you typed one of these.
  • A column is missing. Open Column Display (the filter icon at the right end of the table header) and tick the column, or select Reset to return to the default columns.
  • A partner is missing after archiving. Archived Trade Partners are kept in Master Data Settings > Archived. See Archived.
  • I cannot edit a Connected partner's details. See Trade Partner details and the Trade Partners FAQ.
  • Something else. Contact support@wholechain.com.

Field and action reference

Screen layout

The Trade Partner List tab shows the count of Trade Partners beside its name, a search box, the filters Filter by TP Name(s) and Filter by Connection Status, the Add Trade Partners button, the settings gear icon, a table and page controls (for example 1-7 of 7 items and a 20 / page selector).

Table columns

ColumnShown by defaultDescription
Trade Partner NameYesName of the Trade Partner. Your own company shows (Self) after its name.
Trade Partner IdentifierYesThe identifier you use for this partner, for example a supplier code from your ERP
Location(s)YesNumber of Locations that belong to the partner
ConnectionYesWholechain Connected, Externally Connected or Not Connected (see below)
DUNSYesThe partner's DUNS number. Shows a dash when empty.
PGLNYesThe partner's Party GLN. Shows a dash when empty.
Buyer/SupplierYesSupplier if you buy from the partner, Buyer if you sell to it, or SELF for your own company
TypeYesSelf for your own company; NonWholechain for partners added by form or upload
Wholechain IDYesThe unique ID Wholechain assigns once a company is connected. Blank otherwise.

Connection values

ValueMeaning
Wholechain ConnectedThe partner has a Wholechain account and your account is connected to it. You can send and receive full-chain traceability across accounts and use features such as Shared Items, Shared Locations, custom data collaboration, PO Tracker, the Ship Event Form and Labels.
Externally ConnectedThe partner is connected through another EPCIS/GDST system or a third-party integration. With EPCIS/GDST you can send and receive full-chain traceability. With a third-party integration, the partner can receive traceability data as that integration allows.
Not ConnectedThe partner is not connected in any way. You keep full control and can record traceability events on its behalf. An invitation can be sent so the partner can connect by joining Wholechain or through EPCIS/GDST.

Search and filters

The search box matches the Trade Partner name, the Trade Partner Identifier, the DUNS number and the PGLN. The table updates as you type.

FilterChoicesBehavior
Filter by TP Name(s)Any Trade Partner name; more than one can be chosenA partner matches if its name is any of the names chosen
Filter by Connection StatusWholechain Connected, Externally Connected, Not Connected; more than one can be chosenA partner matches if it has any of the statuses chosen

Filters and search combine: a partner must match every filter set and the search text. When nothing matches, the table shows No Data. Each filter chip has an x, and the search box has an x. There is no single clear-all control.

Column Display

The filter icon at the right end of the table header opens Column Display.

ControlAction
Check box beside a columnShows or hides the column
Up and down arrows, or drag handleChanges the column order
ResetReturns to the default columns

Row and selection actions

ActionWhereWhat it does
Select a nameTrade Partner Name cellOpens the Trade Partner drawer (see Trade Partner details)
View Settings... menu at the end of a rowOpens the Trade Partner's settings
Archive... menu at the end of a rowArchives the Trade Partner (see Archive and restore)
Selection barAppears at the bottom after one or more rows are ticked; shows n selectedOffers Download and a ... menu with Archive
DownloadSelection barDownloads an Excel file with the master data of the selected Trade Partners, showing all fields found on the Details tab
ArchiveSelection bar ... menuArchives the selected Trade Partners (see Archive and restore)
Add Trade PartnersTop rightOpens the Add Trade Partners drawer (see Add Trade Partners)
Gear iconTop of the pageOpens Master Data Settings > Trade Partner (see Master Data Settings)

For the full reference chapter, see Trade Partner List in the Reference Guide.

Watch the walkthrough