Introduction > Supplier 360 SaaS data dictionary > Supplier business entity model
  

Supplier business entity model

Supplier business entity stores information about a supplier. This business entity contains some basic fields and some field groups.

General fields of Supplier business entity

The general fields store some basic information about a supplier organization such as name and date of incorporation.
The following table lists the general fields that the Supplier business entity contains:
Display Name
Internal ID
Field Type
Length
Reference Data
Description
Business Type
businessType
Lookup
NA
BusinessType
Type of business. For example, asset based or non-asset based.
Company Code
companyCode
Text
255
NA
Company code of the supplier organization.
Company Logo
companyLogo
Text
255
NA
URL of the image for the supplier organization.
Currency Type
currencyType
Lookup
NA
Currency
Currency in which the financial information is provided.
Date of Incorporation
dateOfIncorporation
Date
NA
NA
Date of incorporation of the supplier organization.
DUNS Number
dunsNumber
Text
255
NA
DUNS number of the supplier organization.
Industry Type
industryType
Lookup
NA
IndustryType
Type of industry. For example, agriculture, banking, chemicals, or communication.
NAICS Code
naicsCode
Text
255
NA
North American Industry Classification System code of the supplier organization.
Name
name
Text
255
NA
Name of the supplier organization.
Number of Employees
numberOfEmployees
Integer
NA
NA
Total number of employees in the supplier organization.
Online Catalog Flag
onlineCatalogFlag
Boolean
NA
NA
Indicates whether the supplier organization provides an online catalog.
Online Sell Flag
onlineSellFlag
Boolean
NA
NA
Indicates whether the supplier sells online.
Ownership Type
ownershipType
Lookup
NA
OwnershipType
Type of ownership for the supplier organization. For example, cooperative, private, public, or self-owned.
SIC Code
sicCode
Text
255
NA
Standard Industrial Classification code of the supplier organization.
Supplier Type
supplierType
Lookup
NA
SupplierType
Type of supplier. For example, manufacturers, exporters, or distributors.
Web Address
webAddress
Text
255
NA
Website of the supplier organization.

Address field group of Supplier business entity

The Address field group stores the postal addresses of suppliers. Postal address is a physical address associated with the supplier organization. A supplier organization can have multiple addresses.
The following table describes the fields that the Address field group contains:
Display Name
Internal ID
Field Type
Length
Reference Data
Description
Address Line 1
addressLine1
Text
200
NA
Line 1 of the postal address.
Address Line 2
addressLine2
Text
200
NA
Line 2 of the postal address.
Address Line 3
addressLine3
Text
200
NA
Line 3 of the postal address.
Address Status
addressStatus
Lookup
NA
AddressStatus
Status of the address. For example, active or inactive.
Address Type
addressType
Lookup
NA
AddressType
Type of postal address. For example, office, or shipping.
City
city
Text
50
NA
City of the postal address.
Coordinate System
coordinateSystem
Text
100
NA
Coordinate system used to determine the location of the address.
Country
country
Lookup
NA
Country
Country of the postal address.
County
county
Text
50
NA
County of the postal address.
Default Indicator
defaultIndicator
Boolean
NA
NA
Indicates whether the postal address is the default address.
End Date
effectiveEndDate
Date and Time
NA
NA
Expiry date of the address.
Enriched Indicator
enrichedIndicator
Lookup
NA
AddressEnrichedIndicator
Validation status of the address. For example, error, valid, or not validated.
Latitude
latitude
Text
20
NA
Latitude for the address.
Location Coordinate Desc
locationCoordinateDesc
Text
50
NA
Location of the address using coordinate system.
Longitude
longitude
Text
20
NA
Longitude for the address.
Postal Code
postalCode
Text
10
NA
Postal code of the address.
Postal Code Extension
postalCodeExtension
Text
10
NA
Postal code extension of the address.
Start Date
effectiveStartDate
Date and Time
NA
NA
Start date from when the address is active.
State
state
Lookup
NA
State
State of the postal address.
Usage Type
usageType
Lookup
NA
AddressUsageType
Usage type. For example, business or personal.
Verification Message
statusMessage
Text
255
NA
Validation message that the address verification service returns.
Verification Status Code
statusCode
Text
10
NA
Validation status that the address verification service returns.

Alternate Names field group of Supplier business entity

The Alternate Names field group stores the alternate names related information, such as alternate name, effective start date, and effective end date. A supplier might use different names, such as legal name, alias, and trading name. An alternative name might be active during a particular time.
The following table describes the fields that the Alternate Names field group contains:
Display Name
Internal ID
Field Type
Length
Reference Data
Description
Alternate Name
alternateName
Text
255
NA
Alternate name of the supplier organization.
Effective End Date
effectiveEndDate
Date
NA
NA
Expiry date of the alternate name.
Effective Start Date
effectiveStartDate
Date
NA
NA
Start date from when the alternate name is valid.
Name Type
nameType
Lookup
NA
AlternateNameType
Alternate name type of the supplier organization. For example, doing business as name, alias, legal name, or previous name.

Bank Details field group of Supplier business entity

The Bank Details field group stores the bank related information, such as account number, account holder, and branch of the contact.
The following table describes the fields that the Bank Details field group contains:
Display Name
Internal ID
Field Type
Length
Reference Data
Description
Account Type
accountType
Lookup
NA
NA
Type of bank account, such as savings account or current account.
Account Holder
accountHolder
Text
50
NA
Bank account holder's name.
Branch Name
branchName
Text
255
NA
Name of the branch in which the supplier organization has the account.
Account Number
accountNumber
Text
50
NA
Bank account number of the supplier organization.
Account Status
accountStatus
Lookup
NA
NA
Status of the bank account, such as active or inactive.
Bank Name
bankName
Text
255
NA
Name of the bank.
SWIFT
swift
Text
50
NA
Society for Worldwide Interbank Financial Telecommunication code.
IBAN
iban
Text
50
NA
International Bank Account Number.
Country
country
Lookup
NA
NA
Country of the bank account.
Branch Number
branchNumber
Text
50
NA
Branch number of the bank.
Check Digit
checkDigit
Text
50
NA
Error detection on identification numbers, such as bank account numbers.
Primary Indicator
primaryIndicator
Boolean
NA
NA
Indicates whether the bank account is the primary account.
Effective Start Date
effectiveStartDate
Date
NA
NA
Start date from when the bank account is valid.
Effective End Date
effectiveEndDate
Date
NA
NA
Expiry date of the bank account.

Contract field group of Supplier business entity

The Contract field group stores contract related information, such as the order number, quality, transit risk, shipment completion method, and payment type.
The following table describes the fields that the Contract field group contains:
Display Name
Internal ID
Field Type
Length
Reference Data
Description
Agreement Confidentiality
agreementConfidentiality
Boolean
NA
NA
Indicates whether the contract agreement is confidential.
Agreement Date
agreementDate
Date
NA
NA
Date when the contract agreement is drawn.
Arbitration
arbitration
Boolean
NA
NA
Indicates whether arbitration is applicable to the contract.
Country
country
Lookup
NA
Country
Country code of the contract.
Currency
currency
Lookup
NA
Currency
Currency that is specified in the contract.
Delivery Responsibility
deliveryResponsibility
Lookup
NA
DeliveryResponsibilityType
Delivery responsibility of the contract, such as customer will arrange delivery or supplier will arrange delivery.
Discount Avail
discountAvail
Boolean
NA
NA
Indicates whether discount is available for the contract.
Effective End Date
effectiveEndDate
Date
NA
NA
Effective end date of the contract.
Effective Start Date
effectiveStartDate
Date
NA
NA
Effective start date of the contract.
Force Majeure
forceMajeure
Boolean
NA
NA
Indicates whether the force majeure provision is applicable to the contract.
Language
language
Lookup
NA
Language
Language in which the contract is written.
Order Number
orderNumber
Text
255
NA
Order number of the contract.
Payment Method
paymentMethod
Lookup
NA
PaymentMethodType
Payment method, such as cash, cheque, direct debit, or file electronic transfer.
Payment Type
paymentType
Lookup
NA
PaymentType
Payment type of the contract, such as several installment payments or single lump sum payment.
Purchasing Org Code
purchaseOrgCode
Lookup
NA
PurchaseOrgCodeType
Code of the purchasing organization.
Quality
quality
Text
255
NA
Quality requirements of the product or service contract.
Return Remedy Period
returnRemedyPeriod
Text
255
NA
Return remedy period of the contract.
Return Responsibility
returnResponsibility
Lookup
NA
ReturnResponsibilityType
Return responsibility of the contract, such as customer will take responsibility for returns, or supplier will take responsibility for returns.
Shipment Completion Type
shipmentCompletionType
Lookup
NA
ShipmentCompletionType
Shipment completion type of the contract, such as upon delivery of goods to the final destination or upon delivery of goods to the shipping company.
State Law Applied
stateLawApplied
Boolean
NA
NA
Indicates whether the state law is applicable to the contract.
Transferability
transferability
Boolean
NA
NA
Indicates whether the contract is transferable.
Transit Risk
transitRisk
Text
255
N
Transit risk factors of the contract, such as loss of goods.
Tax Responsibility
taxResponsibility
Lokkup
NA
TaxResponsibilityType
Tax responsibility of the contract, such as customer will take responsibility for tax, do not include tax provision, or supplier will take responsibility for tax.
Violation Grace Period
violationGracePeriod
Text
255
NA
Violation grace period of the contact.
Warranty
warranty
Text
255
NA
Warranty of the contract.

Diversity field group of Supplier business entity

The Diversity field group stores diversity related information, such as diversity status and diversity type.
The following table describes the fields that the Diversity field group contains:
Display Name
Internal ID
Field Type
Length
Reference Data
Description
Diversity Status
diversityStatus
Boolean
NA
NA
Indicates whether the supplier organization is diverse.
Diversity Type
diversityType
Lookup
NA
DiversityType
Diversity type of the supplier organization. For example, minority business enterprise, small disadvantaged business, or women business enterprise.

Documents field group of Supplier business entity

The Documents field group stores the document related information, such as bank statement, qualification certificate, and proof of business existence.
The following table describes the fields that the Documents field group contains:
Display Name
Internal ID
Field Type
Length
Reference Data
Description
Document Link
documentLink
Text
255
NA
URL to access the document.
Document Name
documentName
Lookup
NA
DocumentType
Name of the document.
Document Type
documentType
Text
255
NA
Type of document.
File Name
fileName
Text
255
NA
Name of the file.
Valid From
validFrom
Date
NA
NA
Date from when the document is valid.
Valid To
validTo
Date
NA
NA
Date until when the document is valid.

Email field group of Supplier business entity

The Email field group stores information about the electronic addresses, such as email addresses.
The following table describes the fields that the Email field group contains:
Display Name
Internal ID
Field Type
Length
Reference Data
Description
Default Indicator
defaultIndicator
Boolean
NA
NA
Indicates whether the address is the default address.
Effective End Date
effectiveEndDate
Date and Time
NA
NA
End date for the electronic address.
Effective Start Date
effectiveStartDate
Date and Time
NA
NA
Start date for the electronic address.
Electronic Address
electronicAddress
Text
255
NA
Electronic address of the supplier organization.
Electronic Address Status
electronicAddressStatus
Lookup
NA
ElectronicAddressStatus
Status of the email address. For example, active, blocked, or not in use.
Enriched Indicator
enrichedIndicator
Boolean
NA
NA
Indicates whether the email verification service verified the electronic address.
Hygiene Status
hygieneStatus
Text
50
NA
Hygiene status for the electronic address. For example, safe to send, invalid, or spam.
Net Protect Code
netProtectCode
Text
50
NA
Net protect codes identify which service or appliance is monitoring a given network.
Usage Type
usageType
Lookup
NA
ElectronicAddressUsageType
Intended use or purpose of the electronic address. For example, business, work, or personal.
Verification Status Code
validationStatusCode
Text
50
NA
Validation status of the electronic address.
Verification Message
validationMessage
Text
50
NA
Message that the email validation service generates to indicate how valid and trusted the address is.

Executive Members field group of Supplier business entity

The Executive Members field group stores the executive members-related information, such as company name, business title, and executive type.
The following table describes the fields that the Executive Members field group contains:
Display Name
Internal ID
Field Type
Length
Reference Data
Description
Business Title
businessTitle
Text
255
NA
Business title for the executive member.
Company Name
companyName
Text
255
NA
Company name of the executive member.
Executive Type
executiveType
Lookup
NA
ExecutiveType
Type of the executive member. For example, Board of Directors, Chief Executive Officer, Chief Financial Officer, or Managing Director.
Full Name
fullName
Text
50
NA
Full name of the executive member of the supplier organization.

Financial field group of Supplier business entity

The Financial field group stores financial information of a supplier organization, such as currency, unit, and financial reliability.
The following table describes the fields that the Financial field group contains:
Display Name
Internal ID
Field Type
Length
Reference Data
Description
Amount
amount
Double
NA
NA
Total value of the finance.
Currency
currency
Lookup
NA
Currency
Currency in which the financial information is collected.
Finance Info Type
financeInfoType
Lookup
NA
FinanceInfoType
Type of financial information. For example, equity, annual income, or debt.
Finance Reliability
financeReliability
Lookup
NA
FinanceReliability
Reliability of the financial data. For example, actual or estimate.
Time Period
timePeriod
Text
255
NA
Finance period for which the data is collected.
Time Period Type
timePeriodType
Lookup
NA
TimePeriodType
Type of the finance period. For example, quarterly or yearly.
Unit
unit
Lookup
NA
FinancialUnit
Unit of the amount. For example, thousands, millions, or billions.

Identifier field group of Supplier business entity

The Identifier field group stores the identifier related information of a supplier organization, such as tax numbers, D-U-N-S number or National Provider Identifier (NPI) numbers for healthcare providers.
The following table describes the fields that the Identifier field group contains:
Display Name
Internal ID
Field Type
Length
Reference Data
Description
Effective End Date
effectiveEndDate
Date
NA
NA
Expiry date of the identifier.
Effective Start Date
effectiveStartDate
Date
NA
NA
Issued date of the identifier.
Identifier Type
identifierType
NA
NA
OrganizationIdentifierType
Type of identifier.
Identifier Value
identifierValue
Text
50
NA
Value of identifier, such as D-U-N-S number or National Provider Identifier.
Issuing Authority
issuingAuthority
Lookup
NA
IssuingAuthority
Authority that has issued the identifier to the supplier organization.
Status
status
Lookup
NA
IdentifierStatus
Status of the alternate identifier. For example, effective, disqualified, expired, or temporary.

Insurance field group of Supplier business entity

The Insurance field group stores the insurance-related information, such as the name of the insurance provider, the policy number, the insurance type, and the validity.
The following table describes the fields that the Insurance field group contains:
Display Name
Internal ID
Field Type
Length
Reference Data
Description
Currency
currency
Lookup
NA
Currency
Currency in which the supplier organization is insured.
Effective End Date
effectiveEndDate
Date
NA
NA
Expiry date of the insurance.
Effective Start Date
effectiveStartDate
Date
NA
NA
Start date of the insurance.
Insurance Holder
insuranceHolder
Text
255
NA
Name of the insurance holder.
Insurance Provider
insuranceProvider
Text
255
NA
Company that provides the insurance.
Insurance Type
insuranceType
Lookup
NA
InsuranceType
Type of insurance, such as cargo insurance, casualty, commercial auto, or shipping.
Policy Number
policyNumber
Text
100
NA
Policy number of the insurance.
Status
status
Text
255
NA
Status of the insurance. For example, active or expired.
Sub Type
subType
Lookup
NA
InsuranceSubType
Insurance subtype. For example, if the insurance type is group, the subtypes might be extended lenders mortgage, family health gold, mediexcel horizon, or platinum travel.
Unit
unit
Lookup
NA
FinancialUnit
Unit for the amount. For example, billion, million, or thousand.
Value
value
Double
NA
NA
Amount insured.

Phone field group of the Supplier business entity

The Phone field group stores the phone details, such as phone number, phone number extension, and phone type.
The following table describes the fields that the Phone field group contains:
Display Name
Internal ID
Field Type
Length
Reference Data
Description
Cell Prefix
cellPrefix
Text
1
NA
Prefix that must prepend the National Significant Number for inbound international calls.
Default Indicator
defaultIndicator
Boolean
NA
NA
Indicates whether the phone number is the default phone number.
Do Not Call Indicator
doNotCallIndicator
Boolean
NA
NA
Indicates whether the supplier is interested to receive unsolicited phone calls from marketers.
Effective End Date
effectiveEndDate
Date
NA
NA
Date until when the phone number was active or will be active.
Effective Start Date
effectiveStartDate
Date
NA
NA
Date from when the phone number is active.
Enriched Indicator
enrichedIndicator
Boolean
NA
NA
Indicates whether the phone number validation service verified the phone number.
International Format
internationalFormat
Text
50
NA
International format for the phone number.
International Prefix
internationalPrefix
Text
3
NA
Prefix used to select an international telephone circuit.
ISO
iso
Text
2
NA
ISO country code.
National Destination Code
nationalDestinationCode
Text
10
NA
Code that identifies a numbering area within a country or a group of countries.
National Format
nationalFormat
Text
50
NA
National format for the phone number.
National Prefix
nationalPrefix
Text
255
NA
Digit or combination of digits which must be dialed before an area or city code.
NDC Indicator
nationalDestinationCodeIndicator
Boolean
NA
NA
Indicates whether the phone number includes the National Destination Code.
Phone Number
phoneNumber
Text
20
NA
Phone number of the supplier organization.
Phone Number Extension
phoneNumberExtension
Text
10
NA
Extension to phone number.
Phone Type
phoneType
Lookup
NA
PhoneType
Type of phone. For example, cell, fax, freephone, landline, mobile, or pager.
Phone Usage Type
phoneUsageType
Lookup
NA
PhoneUsageType
Usage type of the phone. For example, business, customer service - group market, customer service toll free - individual market, or small group market.
Prefix Number
prefixNumber
Text
3
NA
Country dialing code.
Status
status
Lookup
NA
PhoneStatus
Status of the phone number, such as the phone number is publicly available or active.
Verification Status Code
validationStatusCode
Text
50
NA
Validation status that the phone number validation service returns.
Verification Message
validationMessage
Text
255
NA
Validation message that the phone number validation service returns.

Reference Details field group of Supplier business entity

The Reference Details field group stores the reference details, such as company name, contact name, and company contact number.
The following table describes the fields that the Reference Details field group contains:
Display Name
Internal ID
Field Type
Length
Reference Data
Description
Company Name
companyName
Text
255
NA
Name of the reference organization.
Contact Name
contactName
Text
255
NA
Name of the contact in the reference organization.
Contact Number
contactNumber
Text
255
NA
Contact number of the reference organization.

Risk Questions field group of Supplier business entity

The Risk Questions field group stores information about risk-related questions.
The following table describes the fields that the Tax field group contains:
Display Name
Internal ID
Field Type
Length
Reference Data
Description
Anti-Bribery - Will the supplier interact with government officials on behalf of the buyer?
question1
Boolean
NA
NA
Indicates whether the supplier organization interacts with government officials on behalf of the buyer.
Personally Identifiable Information - Will the supplier process or store personal information of any of the buyer's employees or customers?
question2
Boolean
NA
NA
Indicates whether the supplier organization processes or store personal information of any of the buyer's employees or customers.
Protected Health Information - Will the supplier collect and store data relating to health of any of the buyer's employees or customers?
question3
Boolean
NA
NA
Indicates whether the supplier organization collects and store data relating to health of the buyer's employees or customers.
Will the supplier interact with customers or provide any customer-facing services?
question4
Boolean
NA
NA
Indicates whether the supplier organization interacts with customers or provides any customer-facing services.

Segment field group of Supplier business entity

The Segment field group stores the segment related information, such as segment type and segment name.
The following table describes the fields that the Segment field group contains:
Display Name
Internal ID
Field Type
Length
Reference Data
Description
Segment Name
segmentName
Lookup
NA
SegmentValue
Supplier segment name.
Segment Type
segmentType
Lookup
NA
SegmentType
Segment type of the supplier organization. For example, region or supplier criticality.

Social Media field group of Supplier business entity

The Social Media field group stores information about the social media identifiers of a supplier organization.
The following table describes the fields that the Social Media field group contains:
Display Name
Internal ID
Field Type
Length
Reference Data
Description
Social Media Handle
socialMediaHandle
Text
255
NA
Social media identifier or name of the supplier organization.
Social Media Type
socialMediaType
Lookup
NA
SocialHandleType
Type of social media platform. For example, Facebook or Twitter.

Sourcing Manager field group of Supplier business entity

The Sourcing Manager field group stores the sourcing manager related information, such as name and employee ID.
The following table describes the fields that the Sourcing Manager field group contains:
Display Name
Internal ID
Field Type
Length
Reference Data
Description
Employee ID
sourcingManagerEmployeeId
Text
255
NA
Employee ID of the sourcing manager.
Name
sourcingManagerName
Text
255
NA
Name of the sourcing manager.

Stock field group of Supplier business entity

The Stock field group stores the stock related information, such as ticker symbol, exchange name, and country.
The following table describes the fields that the Stock field group contains:
Display Name
Internal ID
Field Type
Length
Reference Data
Description
Country
country
Lookup
NA
Country
Country where the stock exchange is located.
Exchange Name
exchangeName
Text
255
NA
Name of the stock exchange that trades the shares of the supplier organization.
Ticker Symbol
tickerSymbol
Text
255
NA
Abbreviation used to identify the publicly traded shares of the organization.

Supplier Alerts field group of Supplier business entity

The Supplier Alerts field group stores information, such as message, message type, and external link.
The following table describes the fields that the Supplier Alerts field group contains:
Display Name
Internal ID
Field Type
Length
Reference Data
Description
Effective End Date
effectiveEndDate
Date
NA
NA
Expiry date of the supplier alert.
Effective Start Date
effectiveStartDate
Date
NA
NA
Start date of the supplier alert.
External Link
externalLink
Text
255
NA
External link to the supplier alert message.
Message
message
Text
255
NA
Supplier alert message.
Message Type
messageType
Text
255
NA
Type of supplier alert message.

Tax field group of Supplier business entity

The Tax field group stores tax-related information, such as the taxpayer type, tax authority, taxpayer identification number, and amount of tax paid of the supplier organization.
The following table describes the fields that the Tax field group contains:
Display Name
Internal ID
Field Type
Length
Reference Data
Description
Country
country
Lookup
NA
Country
Country of taxation.
Currency
currency
Lookup
NA
Currency
Currency in which the tax is paid.
Effective End Date
effectiveEndDate
Date
NA
NA
End date of the tax period.
Effective Start Date
effectiveStartDate
Date
NA
NA
Start date of the tax period.
State
state
Lookup
NA
State
State within the country of taxation.
Tax Authority
taxAuthority
Lookup
NA
TaxAuthority
Tax authority. For example, Internal Revenue Service (IRS) or HM Revenue and Customs (HMRC).
Tax Number
taxNumber
Text
50
NA
Unique number that identifies the supplier organization for tax purposes.
Tax Number Type
taxNumberType
Lookup
NA
TaxNumberType
Type of the tax number. For example, tax number can be Individual Taxpayer Identification Number (ITIN) or Social Security Number.
Tax Paid
taxPaid
Text
50
NA
Tax amount that the supplier organization has paid.
Tax Payer Type
taxPayerType
Lookup
NA
TaxPayerType
Type of tax payer. For example, business entity, estate, or individual.