# Fetch Supplier Gateway Record

Fetches a Supplier Gateway record by providing the necessary information and returns the fetched record.

Endpoint: POST /sgw/businesspartners/fetch
Version: 3
Security: apiKey

## Request fields (application/json):

  - `cdqId` (string)
    CDQ ID of the supplier gateway record to fetch.
    Example: "VIES:DE119267630"

  - `supplierNumber` (string)
    Supplier Number to fetch the Record.
    Example: "SUP12345"

  - `featuresOn` (array)
    List of features to be activated.
    Enum: "ENRICH_MINORITY_INDICATOR"

## Response 200 fields (application/json):

  - `cdqId` (string)
    The CDQ ID of the supplier gateway.
    Example: "VIES:DE119267630"

  - `supplierGateway` (object)
    A gateway for a supplier. 

Provides information such as: 
* status, 
* contact details, 
* certifications, 
* bank information,
* business categories.

  - `supplierGateway.Code` (string)
    Code representing the status of the supplier gateway.
    Example: "200"

  - `supplierGateway.Message` (string)
    Message providing additional information about the status of the supplier gateway.
    Example: "Supplier gateway successfully created"

  - `supplierGateway.Supplier` (object)
    Containing details about the supplier.

  - `supplierGateway.Supplier.SupplierNumber` (string)
    Unique identifier for the supplier.
    Example: "SUP12345"

  - `supplierGateway.Supplier.TaxID` (string)
    Tax identification number of the supplier.
    Example: "12-3456789"

  - `supplierGateway.Supplier.CompanyName` (string)
    Name of the supplier company.
    Example: "Acme Corporation"

  - `supplierGateway.Supplier.ContactName` (string)
    Name of the contact person at the supplier company.
    Example: "John Doe"

  - `supplierGateway.Supplier.Address` (string)
    Address of the supplier company.
    Example: "123 Main St, Springfield, IL"

  - `supplierGateway.Supplier.City` (string)
    City where the supplier company is located.
    Example: "Springfield"

  - `supplierGateway.Supplier.State` (string)
    State where the supplier company is located.
    Example: "IL"

  - `supplierGateway.Supplier.Country` (string)
    Country where the supplier company is located.
    Example: "USA"

  - `supplierGateway.Supplier.Zip` (string)
    Zip code of the supplier company's location.
    Example: "62701"

  - `supplierGateway.Supplier.ZipPlus` (string)
    Extended Zip code of the supplier company's location.
    Example: "62701-1234"

  - `supplierGateway.Supplier.Phone` (string)
    Contact phone number of the supplier company.
    Example: "(123) 456-7890"

  - `supplierGateway.Supplier.Fax` (string)
    Fax number of the supplier company.
    Example: "(123) 456-7891"

  - `supplierGateway.Supplier.Email` (string)
    Contact email of the supplier company.
    Example: "contact@acme.com"

  - `supplierGateway.Supplier.Web` (string)
    Website of the supplier company.
    Example: "https://www.acme.com"

  - `supplierGateway.Supplier.Duns` (string)
    D-U-N-S Number of the supplier company.
    Example: "15-048-3782"

  - `supplierGateway.Supplier.yearEstablished` (string)
    Year when the supplier's company was established.
    Example: "2000"

  - `supplierGateway.Supplier.NumberOfEmployee` (string)
    Number of employees in the supplier's company.
    Example: "100"

  - `supplierGateway.Supplier.Capability` (string)
    Capabilities of the supplier's company.
    Example: "Manufacturing, Distribution"

  - `supplierGateway.Supplier.Status` (string)
    Current status of the supplier company.
    Example: "Active"

  - `supplierGateway.Supplier.Acct` (string)
    Account information of the supplier company.
    Example: "ACC12345"

  - `supplierGateway.Supplier.LastAct` (string)
    Last activity recorded for the supplier company.
    Example: "2025-09-12T14:57:59Z"

  - `supplierGateway.Supplier.SBASDB` (string)
    Small Business Administration Small Disadvantaged Business information for the supplier company.
    Example: "Yes"

  - `supplierGateway.Supplier.Hub` (string)
    Historically Underutilized Business Zones (HUBZone) information for the supplier company.
    Example: "Yes"

  - `supplierGateway.Supplier.HubExp` (string)
    Expiration date of the HUBZone status for the supplier company.
    Example: "2025-09-12T14:57:59Z"

  - `supplierGateway.Supplier.Validated` (string)
    Validation status of the supplier company.
    Example: "Yes"

  - `supplierGateway.Supplier.Preg` (string)
    Preg information of the supplier company.
    Example: "PREG12345"

  - `supplierGateway.Supplier.PregStart` (string)
    Start date of the Preg status for the supplier company.
    Example: "2025-09-12T14:57:59Z"

  - `supplierGateway.Supplier.PregComp` (string)
    Completion date of the Preg status for the supplier company.
    Example: "2025-09-12T14:57:59Z"

  - `supplierGateway.Supplier.PregStat` (string)
    Status of the Preg for the supplier company.
    Example: "Completed"

  - `supplierGateway.Supplier.Mospnd18` (string)
    Mospnd18 information of the supplier company.
    Example: "MOSPND12345"

  - `supplierGateway.Supplier.Moamt18` (string)
    Moamt18 information of the supplier company.
    Example: "MOAMT12345"

  - `supplierGateway.Supplier.MasterSupplierNo` (string)
    Master supplier number of the supplier company.
    Example: "MSUP12345"

  - `supplierGateway.Supplier.Tier2Required` (string)
    Tier 2 requirements status of the supplier company.
    Example: "Yes"

  - `supplierGateway.Supplier.Categories` (array)
    Categories of business the supplier company is involved in.

  - `supplierGateway.Supplier.Categories.Name` (string)
    Name of the category.
    Example: "Manufacturing"

  - `supplierGateway.Supplier.Categories.Abbreviation` (string)
    Abbreviation of the category.
    Example: "MFG"

  - `supplierGateway.Supplier.Ethnicities` (array)
    Ethnicities associated with the supplier company.

  - `supplierGateway.Supplier.Ethnicities.Name` (string)
    Name of the ethnicity.
    Example: "Hispanic"

  - `supplierGateway.Supplier.Ethnicities.Abbreviation` (string)
    Abbreviation of the ethnicity.
    Example: "HISP"

  - `supplierGateway.Supplier.Certifications` (array)
    Certifications obtained by the supplier company.

  - `supplierGateway.Supplier.Certifications.Name` (string)
    Name of the certification.
    Example: "ISO 9001"

  - `supplierGateway.Supplier.Certifications.Abbreviation` (string)
    Abbreviation of the certification.
    Example: "ISO9K"

  - `supplierGateway.Supplier.Certifications.CertDate` (string)
    Date when the certification was obtained.
    Example: "2025-09-12T14:57:59Z"

  - `supplierGateway.Supplier.Certifications.ExpDate` (string)
    Expiration date of the certification.
    Example: "2025-09-12T14:57:59Z"

  - `supplierGateway.Supplier.Certifications.CertNo` (string)
    Certification number.
    Example: "CERT12345"

  - `supplierGateway.Supplier.Banks` (array)
    Banks associated with the supplier company.

  - `supplierGateway.Supplier.Banks.BankName` (string)
    Name of the bank.
    Example: "Bank of Springfield"

  - `supplierGateway.Supplier.Banks.AccountType` (string)
    Type of account held at the bank.
    Example: "Business Checking"

  - `supplierGateway.Supplier.Banks.AccountNumber` (string)
    Account number at the bank.
    Example: "123456789"

  - `supplierGateway.Supplier.Banks.RouteNumber` (string)
    Routing number of the bank.
    Example: "987654321"

  - `supplierGateway.Supplier.Banks.Address` (string)
    Address of the bank.
    Example: "456 Market St, Springfield, IL"

  - `supplierGateway.Supplier.Banks.CityRegion` (string)
    City or region where the bank is located.
    Example: "Springfield"

  - `supplierGateway.Supplier.Banks.StateProvince` (string)
    State or province where the bank is located.
    Example: "IL"

  - `supplierGateway.Supplier.Banks.PostalCode` (string)
    Postal code of the bank's location.
    Example: "62702"

  - `supplierGateway.Supplier.Banks.Country` (string)
    Country where the bank is located.
    Example: "USA"

  - `minorityIndicator` (object)
    The minority indicator determines the minority group to which a vendor belongs. Usually, the minority indicator is only relevant in the United States and it is used for reporting purposes only. There is a corresponding SAP field in the vendor master for maintaining the minority indicator.

This feature is as of today dependent on data provided by a US based company: SupplierGateway.

Additional documentation can be found [here](https://meta.cdq.com/Business_partner/partner_profile/minority_indicator).

  - `minorityIndicator.value` (string)
    The actual value of the minority indicator, representing the minority group.
    Example: "Social enterprise"