Tracelink University

Table of contents

The full master data records for a Partner include the Partner's headquarters information, identifiers, and location master data on TraceLink. IT system administrators and app developers use these APIs to read the full master data record for a Partner and its internal locations by submitting either regulatory identifier information for the company or location or a query that finds the company or location based on the contents of one or more fields. Additionally, IT system administrators use these APIs to edit the full master data record for a Partner and its internal locations.

To ensure that Partner or Partner location master data is updated successfully, TraceLink recommends only submitting a few records at a time with each add or update request.

Get Partner Company Master Data

IT system administrators and app developers use this API to retrieve the full master data record for a partner company (e.g. name, address) based on the partner's regulatory identifier information.

Guidelines

  Attribute Type Description
header –

Required. The request header.
  headerVersion Integer

Required. The version identifier for the request. Valid value is 1.
  eventName String

Required. The fully qualified name of the request event. Valid value is masterdata-manager:get-partner-by-regulatory-identifier:v1.
  ownerId String

Required. The identifier for the company providing the app.
  dataspace String

Required. The dataspace within the environment where the request is being made. Valid value for the Production and Validation environments is default.
  appName String

Required. The application that owns the event. Valid value is masterdata-manager.
payload –

Required. The request body.
  regulatoryCompanyIdentifier String

The value of the regulatory identifier.
  regulatoryCompanyIdentifierType String

The type of the regulatory identifier.

Example

{
  "header": {
    "headerVersion": 1,
    "eventName": "masterdata-manager:get-partner-by-regulatory-identifier:v1",
    "ownerId": "00000000-0000-0000-0000-000000000000",
    "dataspace": "default",
    "appName": "masterdata-manager"
  },
  "payload": {
    "regulatoryCompanyIdentifier": "8888882021122",
    "regulatoryCompanyIdentifierType": "SGLN"
  }
}

Guidelines

  Attribute Type Description
header –

Required. The response header.
  headerVersion Integer

Required. The version identifier for the response. Valid value is 1.
  eventName String

Required. The fully qualified name of the response event. Valid value is masterdata-manager:get-partner-by-regulatory-identifier-response:v1.
  ownerId String

Required. The identifier for the company providing the app.
  isErr String

Required. Indicates whether the request was successful. Valid values:

  • true – The request was successful.
  • false – The request was not successful. The errCode field provides error information for troubleshooting.
  errCode String

Required. The status code of the request. 200_OK indicates that the request was successful.
  errMsg String

Conditionally required if the call is unsuccessful. The message associated with the error code.
  licensePlate String

Required. The unique identifier for the request and response instance.
payload –

Required. The response body.
  pagingInfo String

Required. The query paging information representing where the previous query result ended. The pagingInfo from the previous query may be used as the starting point for a new query.
  documents Array

Required. Contains the results of the query request.
    metadata Object

Required. The metadata about the object.
        schemaId String

Required. The JSON schema that defines the object.
        schemaVersion Integer

Required. The JSON schema version number.
        primaryKey String

Required. The primary key of the object.
        dataVersion Integer

Required. The current version number of the object.
        indexTarget String

Required. The index target identifier of the object.
        dbTxid Integer

Required. The transactional identifier of the object.
    payload – Required. The master data objects.
      schemaVersion String

Required. The JSON schema version number.
      data Object

Required. Contains the attributes for the object. The contents depend on the object schema specified when the event handlers were added.
        dataStatus Boolean

Required. Indicates if the master data for this location is active or inactive.

Valid values:

  • true – The master data for this location is active.
  • false – The master data for this location is inactive.
        lscS3Identifier String

Required. The identifier of the company object that S3 uses.
        isLegalEntity Boolean

Specifies if the company is a legal entity.

Valid values:

  • true – The node is a legal entity.
  • false – The node is not a legal entity.
        providerNetworkNodeIdentifier String

Required. The network node of the originating company for the master data record.
        legalEntityCode String

The legal entity code of the network node.
        companyNetworkNodeId String

Required. The network node that the record belongs to.
        regulatoryPartnerLicenses Array The Partner company's license information.
          lscLicenseIdentifier String The license identifier in Track & Trace Services.
          licenseNumber String Required. The regulatory license number for the specified Partner company.
          licenseCountry String Required. The country of the licensing agency.
          licenseIssuingAgency String The agency granting the regulatory license.
          licenseStateOrRegion String The state or region of the licensing agency.
        regulatoryPartnerIdentifiers String

Required. The list of all identifiers of the company.
          regulatoryCompanyIdentifierTypeId String Required. The identifier of the regulatory identifier type and value combination.
          regulatoryCompanyIdentifierType String

Required. The identifier type.
          isPrimaryRegulatoryIdentifier String

Required. Specifies if the given identifier is the primary identifier.
          regulatoryIdentifierValue String

Required. The identifier value.
        businessMasterDataCommon TypeDef

Required. The common business information.
          businessType String

The list of all business types of the company.

          lscBusinessVersion String

Required. The business version identifier in Track & Trace Services.
          businessName String

Required. The company's name.
          businessEmail String

The company's email address.
          businessPhone String

The company's phone number.
          businessUrl String

The URL of the company's website.
          businessTaxRegistrationCode String

The company's tax registration code.
          businessAddress TypeDef

The company's address information.
            address1 String

Required. The street address, including number and street name.
            address2 String

The second line of the street address. Any additional address information, if available.
            city String Required. The city where this Partner company is located.
            district String

The 3-digit numeric code of the district where the Partner company is located in India.
            village String

The village in which the Partner company is located.
            houseNumber String

The building, house, or unit number of the company. House numbers are usually only separated from the street address in China. For all addresses outside of China, continue to enter the building, house, or unit number in address1.
            township String

The name of the town in which the Partner company is located.
            stateOrRegion String

Required. The state, province, or region using the standard two– or three–letter abbreviation specified in the ISO 3166–2:1998 country subdivision code.
            postalCode String

Conditionally required if the country has a ZIP or other postal code. If the country does have a postal code and it is omitted, an error is generated. See Valid values for exclusions.

  • Angola, AO

  • Antigua and Barbuda, AG

  • Aruba, AW

  • Bahamas, BS

  • Belize, BZ

  • Benin, BJ

  • Botswana, BW

  • Burkina Faso, BF

  • Burundi, BI

  • Cameroon, CM

  • Central African Republic, CF

  • Comoros, KM

  • Congo, CG

  • Congo, the Democratic Republic of the, CD

  • Cook Islands, CK

  • Cote d'Ivoire, CI

  • Djibouti, DJ

  • Dominica, DM

  • Equatorial Guinea, GQ

  • Eritrea, ER

  • Fiji, FJ

  • French Southern Territories, TF

  • Gambia, GM

  • Ghana, GH

  • Grenada, GD

  • Guinea, GN

  • Guyana, GY

  • Hong Kong, HK

  • Ireland, IE

  • Jamaica, JM

  • Kenya, KE

  • Kiribati, KI

  • Macao, MO

  • Malawi, MW

  • Mali, ML

  • Mauritania, MR

  • Mauritius, MU

  • Montserrat, MS

  • Nauru, NR

  • Netherlands Antilles, AN

  • Niue, NU

  • North Korea, KP

  • Panama, PA

  • Qatar, QA

  • Rwanda, RW

  • Saint Kitts and Nevis, KN

  • Saint Lucia, LC

  • Sao Tome and Principe, ST

  • Saudi Arabia, SA

  • Seychelles, SC

  • Sierra Leone, SL

  • Solomon Islands, SB

  • Somalia, SO

  • South Africa, ZA

  • Suriname, SR

  • Syria, SY

  • Tanzania, United Republic of, TZ

  • Timor-Leste, TL

  • Tokelau, TK

  • Tonga, TO

  • Trinidad and Tobago, TT

  • Tuvalu, TV

  • Uganda, UG

  • United Arab Emirates, AE

  • Vanuatu, VU

  • Yemen, YE

  • Zimbabwe, ZW
            country String

Required. The country using the standard two–letter abbreviation specified in ISO 3166–1alpha-2:1997 country code.

  • AD – ANDORRA
  • AE – UNITED ARAB EMIRATES
  • AF – AFGHANISTAN
  • AG – ANTIGUA AND BARBUDA
  • AI – ANGUILLA
  • AL – ALBANIA
  • AM – ARMENIA
  • AN – NETHERLANDS ANTILLES
  • AO – ANGOLA
  • AQ – ANTARCTICA
  • AR – ARGENTINA
  • AS – AMERICAN SAMOA
  • AT – AUSTRIA
  • AU – AUSTRALIA
  • AW – ARUBA
  • AX – ÅLAND ISLANDS
  • AZ – AZERBAIJAN
  • BA – BOSNIA AND HERZEGOVINA
  • BB – BARBADOS
  • BD – BANGLADESH
  • BE – BELGIUM
  • BF – BURKINA FASO
  • BG – BULGARIA
  • BH – BAHRAIN
  • BI – BURUNDI
  • BJ – BENIN
  • BL – SAINT BARTHÉLEMY
  • BM – BERMUDA
  • BN – BRUNEI DARUSSALAM
  • BO – BOLIVIA, PLURINATIONAL STATE OF
  • BR – BRAZIL
  • BS – BAHAMAS
  • BT – BHUTAN
  • BV – BOUVET ISLAND
  • BW – BOTSWANA
  • BY – BELARUS
  • BZ – BELIZE
  • CA – CANADA 
  • CC – COCOS (KEELING) ISLANDS
  • CD – CONGO, THE DEMOCRATIC REPUBLIC OF THE
  • CF – CENTRAL AFRICAN REPUBLIC
  • CG – CONGO
  • CH – SWITZERLAND
  • CI – CÔTE D'IVOIRE
  • CK – COOK ISLANDS
  • CL – CHILE
  • CM – CAMEROON
  • CN – CHINA
  • CO – COLOMBIA
  • CR – COSTA RICA
  • CU – CUBA
  • CV – CAPE VERDE
  • CX – CHRISTMAS ISLAND
  • CY – CYPRUS
  • CZ – CZECH REPUBLIC
  • DE – GERMANY
  • DJ – DJIBOUTI
  • DK – DENMARK
  • DM – DOMINICA
  • DO – DOMINICAN REPUBLIC
  • DZ – ALGERIA
  • EC – ECUADOR
  • EE – ESTONIA
  • EG – EGYPT
  • EH – WESTERN SAHARA
  • ER – ERITREA
  • ES – SPAIN
  • ET – ETHIOPIA
  • FI – FINLAND
  • FJ – FIJI
  • FK – FALKLAND ISLANDS (MALVINAS)
  • FM – MICRONESIA, FEDERATED STATES OF
  • FO – FAROE ISLANDS
  • FR – FRANCE
  • GA – GABON
  • GB – UNITED KINGDOM
  • GD – GRENADA
  • GE – GEORGIA
  • GF – FRENCH GUIANA
  • GG – GUERNSEY
  • GH – GHANA
  • GI – GIBRALTAR
  • GL – GREENLAND
  • GM – GAMBIA
  • GN – GUINEA
  • GP – GUADELOUPE
  • GQ – EQUATORIAL GUINEA
  • GR – GREECE
  • GS – SOUTH GEORGIA AND THE SOUTH SANDWICH ISLANDS
  • GT – GUATEMALA
  • GU – GUAM
  • GW – GUINEA–BISSAU
  • GY – GUYANA
  • HK - HONG KONG
  • HM – HEARD ISLAND AND MCDONALD ISLANDS
  • HN – HONDURAS
  • HR – CROATIA
  • HT – HAITI
  • HU – HUNGARY
  • ID – INDONESIA
  • IE – IRELAND
  • IL – ISRAEL
  • IM – ISLE OF MAN
  • IN – INDIA
  • IO – BRITISH INDIAN OCEAN TERRITORY
  • IQ – IRAQ
  • IR – IRAN, ISLAMIC REPUBLIC OF
  • IS – ICELAND
  • IT – ITALY
  • JE – JERSEY
  • JM – JAMAICA
  • JO – JORDAN
  • JP – JAPAN
  • KE – KENYA
  • KG – KYRGYZSTAN
  • KH – CAMBODIA
  • KI – KIRIBATI
  • KM – COMOROS
  • KN – SAINT KITTS AND NEVIS
  • KP – KOREA, DEMOCRATIC PEOPLE'S REPUBLIC OF
  • KR – KOREA, REPUBLIC OF
  • KW – KUWAIT
  • KY – CAYMAN ISLANDS
  • KZ – KAZAKHSTAN
  • LA – LAO PEOPLE'S DEMOCRATIC REPUBLIC
  • LB – LEBANON
  • LC – SAINT LUCIA
  • LI – LIECHTENSTEIN
  • LK – SRI LANKA
  • LR – LIBERIA
  • LS – LESOTHO
  • LT – LITHUANIA
  • LU – LUXEMBOURG
  • LV – LATVIA
  • LY – LIBYAN ARAB JAMAHIRIYA
  • MA – MOROCCO
  • MC – MONACO
  • MD – MOLDOVA, REPUBLIC OF
  • ME – MONTENEGRO
  • MF – SAINT MARTIN
  • MG – MADAGASCAR
  • MH – MARSHALL ISLANDS
  • MK – MACEDONIA, THE FORMER YUGOSLAV REPUBLIC OF
  • ML – MALI
  • MM – MYANMAR
  • MN – MONGOLIA
  • MO – MACAO
  • MP – NORTHERN MARIANA ISLANDS
  • MQ – MARTINIQUE
  • MR – MAURITANIA
  • MS – MONTSERRAT
  • MT – MALTA
  • MU – MAURITIUS
  • MV – MALDIVES
  • MW – MALAWI 
  • MX – MEXICO
  • MY – MALAYSIA
  • MZ – MOZAMBIQUE
  • NA – NAMIBIA
  • NC – NEW CALEDONIA
  • NE – NIGER
  • NF – NORFOLK ISLAND
  • NG – NIGERIA
  • NI – NICARAGUA
  • NL – NETHERLANDS
  • NO – NORWAY
  • NP – NEPAL
  • NR – NAURU
  • NU – NIUE
  • NZ – NEW ZEALAND
  • OM – OMAN
  • PA – PANAMA
  • PE – PERU
  • PF – FRENCH POLYNESIA
  • PG – PAPUA NEW GUINEA
  • PH – PHILIPPINES
  • PK – PAKISTAN
  • PL – POLAND
  • PM – SAINT PIERRE AND MIQUELON
  • PN – PITCAIRN
  • PR – PUERTO RICO
  • PS – PALESTINIAN TERRITORY, OCCUPIED
  • PT – PORTUGAL
  • PW – PALAU
  • PY – PARAGUAY
  • QA – QATAR
  • RE – RÉUNION
  • RO – ROMANIA
  • RS – SERBIA
  • RU – RUSSIAN FEDERATION
  • RW – RWANDA
  • SA – SAUDI ARABIA
  • SB – SOLOMON ISLANDS
  • SC – SEYCHELLES
  • SD – SUDAN
  • SE – SWEDEN
  • SG – SINGAPORE
  • SH – SAINT HELENA, ASCENSION AND TRISTAN DA CUNHA
  • SI – SLOVENIA
  • SJ – SVALBARD AND JAN MAYEN
  • SK – SLOVAKIA
  • SL – SIERRA LEONE
  • SM – SAN MARINO
  • SN – SENEGAL
  • SO – SOMALIA
  • SR – SURINAME
  • ST – SAO TOME AND PRINCIPE
  • SV – EL SALVADOR
  • SY – SYRIAN ARAB REPUBLIC
  • SZ – SWAZILAND
  • TC – TURKS AND CAICOS ISLANDS
  • TD – CHAD
  • TF – FRENCH SOUTHERN TERRITORIES
  • TG – TOGO
  • TH – THAILAND
  • TJ – TAJIKISTAN
  • TK – TOKELAU
  • TL – TIMOR–LESTE
  • TM – TURKMENISTAN
  • TN – TUNISIA
  • TO – TONGA
  • TR – TURKEY
  • TT – TRINIDAD AND TOBAGO
  • TV – TUVALU
  • TW – TAIWAN
  • TZ – TANZANIA, UNITED REPUBLIC OF
  • UA – UKRAINE
  • UG – UGANDA
  • UM – UNITED STATES MINOR OUTLYING ISLANDS
  • US – UNITED STATES
  • UY – URUGUAY
  • UZ – UZBEKISTAN
  • VA – HOLY SEE (VATICAN CITY STATE)
  • VC – SAINT VINCENT AND THE GRENADINES
  • VE – VENEZUELA, BOLIVARIAN REPUBLIC OF
  • VG – VIRGIN ISLANDS, BRITISH
  • VI – VIRGIN ISLANDS, U.S.
  • VN – VIET NAM
  • VU – VANUATU
  • WF – WALLIS AND FUTUNA
  • WS – SAMOA
  • XK – KOSOVO
  • YE – YEMEN
  • YT – MAYOTTE
  • ZA – SOUTH AFRICA
  • ZM – ZAMBIA
  • ZW – ZIMBABWE
            url String The URL of the Partner company's website.
            buildingNumber String

The Partner company's building number.
            plantNumber String

The facility's plant number.
            floorNumber String

The facility's floor number.
            premisesCode String

The identifier representing a physical area within the company location (e.g. a location's second floor).
            fax String

The office's fax number.
            telephone String

The office's telephone number.
            lscAddressidentifier String

The global identifier assigned by Russian Federation Information Address System (FIAS). Maximum 36 characters, using the digits 0-9 and letters A-F.
          regulatoryContact Object

The contact information for the regulatory contact at the company.
            regulatoryContactTitle String

The regulatory contact's business title.
            regulatoryContactName String

The regulatory contact's name.
            regulatoryContactEmail String

The regulatory contact's email address.
            regulatoryContactPhone Integer

The regulatory contact's phone number.
          businessLogo Object

Information for the business logo.
            imageIdentifier String

The business logo's image identifier.
            imageMimeType String

The business logo's image mime type.
            imagefileName String

The business logo's file name.
            imagebase64 String

A readable string of the image.
        regulatoryPartnerIdentifiersDerivedField String

The result of the query when ftsInfo | value equals *index-regulatoryPartnerIdentifiersDerivedField:searchString* in the request.
        regulatoryPartnerIdentifiersWithBusinessNameDerivedField String

The result of the query when ftsInfo | value equals *index-regulatoryPartnerIdentifiersWithBusinessNameDerivedField:[searchString] in the request.
        regulatoryPartnerLicensesWithBusinessNameDerivedField String

The result of the query when ftsInfo | value equals index-regulatoryPartnerLicensesWithBusinessNameDerivedField in the request.
    schemaId String

Required. The JSON schema that defines the object.
    id String Required. The identifier of the master data object.
    objectType String Required. The type of the object. Valid value is masterdata-manager:productMasterData.
    lastUpdatedDateTime String

The identifier of the user that made the last update to the master data record.

    contextualOwnerId String Required. The identifier of the company sending the master data request.
    lastUpdatedByUserId DateTime

The identifier of the user that made the last update to the master data record.
    ownerId String

Required. The identifier of the company that owns the master data record.
    dataVersion Integer

Required. The current version number of the object.
    createdByUserId String

Required. The ID of the user that created the master data record.
    creationDateTime DateTime

Required. The date and time when the master data record was created.
  primaryKey String Required. The primary key of the object.
facets String

Required. Enables searches through a particular dataset.

Example

{
  "header": {
    "headerVersion": 1,
    "eventName": "masterdata-manager:get-partner-by-regulatory-identifier-response:v1",
    "ownerId": "00000000-0000-0000-0000-000000000000",
    "isErr": false,
    "errCode": "200_OK",
    "licensePlate": "W1thmm"
  },
  "payload": {
    "pagingInfo": null,
    "documents": [
      {
        "metadata": {
          "schemaId": "masterdata-manager:partnerMasterData",
          "schemaVersion": 1,
          "primaryKey": "masterdata-manager:partnerMasterData#471b0f7a-4759-4279-bf8e-dc74c70bd8a8",
          "dataVersion": 1,
          "indexTarget": "471b0f7a-4759-4279-bf8e-dc74c70bd8a8",
          "dbTxId": 111353
        },
        "payload": {
          "schemaVersion": 1,
          "data": {
            "dataStatus": "dataStatus",
            "lscS3Identifier": "lscS3Identifier",
            "isLegalEntity": true,
            "providerNetworkNodeIdentifier": "providerNetworkNodeIdentifier",
            "legalEntityCode": "legalEntityCode",
            "companyNetworkNodeId": "companyNetworkNodeId",
            "regulatoryPartnerLicenses": [
              {
                "lscLicenseIdentifier": "lscLicenseIdentifier",
                "licenseNumber": "licenseNumber",
                "licenseCountry": "US",
                "licenseIssuingAgency": "licenseIssuingAgency",
                "licenseStateOrRegion": "licenseStateOrRegion"
              }
            ],
            "regulatoryPartnerIdentifiers": [
              {
                "regulatoryCompanyIdentifierTypeId": "ac8b1d0b-8041-4938-bd38-0c5eeed8a28b",
                "regulatoryCompanyIdentifierType": "SGLN",
                "lscRegulatoryIdentifier": "lscRegulatoryIdentifier",
                "isPrimaryRegulatoryIdentifier": false,
                "regulatoryIdentifierValue": "8888882021122"
              }
            ],
            "businessMasterDataCommon": {
              "businessType": [
                "MANUFACTURER"
              ],
              "lscBusinessVersion": "lscBusinessVersion",
              "businessName": "businessNameTest",
              "businessEmail": "businessEmail",
              "businessPhone": "businessPhone",
              "businessUrl": "businessUrl",
              "businessTaxRegistrationCode": "businessTaxRegistrationCode",
              "businessAddress": {
                "address1": "address1",
                "address2": "address2",
                "buildingNumber": "buildingNumber",
                "plantNumber": "plantNumber",
                "floorNumber": "floorNumber",
                "houseNumber": "houseNumber",
                "city": "city",
                "village": "village",
                "township": "township",
                "district": "district",
                "state": "state",
                "postalCode": "postalCode",
                "country": "US",
                "telephone": "telephone",
                "fax": "fax",
                "url": "url",
                "lscAddressIdentifier": "lscAddressIdentifier"
              },
              "regulatoryContact": {
                "regulatoryContactTitle": "regulatoryContactTitle",
                "regulatoryContactName": "regulatoryContactName",
                "regulatoryContactEmail": "regulatoryContactEmail",
                "regulatoryContactPhone": "regulatoryContactPhone"
              },
              "businessLogo": {
                "imageIdentifier": "imageIdentifier",
                "imageMimeType": "imageMimeType",
                "imagefileName": "imagefileName",
                "imagebase64": "imagebase64"
              }
            },
            "regulatoryPartnerLicensesWithBusinessNameDerivedField": "businessNameTest licenseIssuingAgency US licenseStateOrRegion licenseNumber",
            "regulatoryPartnerIdentifiersWithBusinessNameDerivedField": "businessNameTest SGLN 8888882021122",
            "regulatoryPartnerIdentifiersDerivedField": "SGLN 8888882021122"
          },
          "schemaId": "masterdata-manager:partnerMasterData",
          "id": "471b0f7a-4759-4279-bf8e-dc74c70bd8a8",
          "objectType": "masterdata-manager:partnerMasterData",
          "lastUpdatedDateTime": 1616100835395,
          "contextualOwnerId": "00000000-0000-0000-0000-000000000000",
          "lastUpdatedByUserId": "f9f35dd0-035d-11eb-8ec8-0242ac11000c",
          "ownerId": "00000000-0000-0000-0000-000000000000",
          "dataVersion": 1,
          "createdByUserId": "f9f35dd0-035d-11eb-8ec8-0242ac11000c",
          "creationDateTime": 1616100835395
        },
        "primaryKey": "masterdata-manager:partnerMasterData#471b0f7a-4759-4279-bf8e-dc74c70bd8a8"
      }
    ],
    "facets": [
    ]
  }
}

Errors

This app uses standard HTTP response codes. If an error occurs, additional available information regarding the cause of the error is provided in the errMsg element in the relevant response.

Review TraceLink's API: Terms of Use

Add or Edit Partner Company Master Data

IT system administrators use this API to add or edit the full master data record for a Partner (e.g. name, address). IT system administrators should retrieve the existing partner company master data record, edit the values that need to change, and then submit the entire record. These APIs overwrite the full set of data previously added to the associated record.

Guidelines

Element Type Description
header – Required. The request header.
  headerVersion Integer Required. The version identifier for the request. Valid value is 1.
  eventName String Required. The fully qualified name of the request event. Valid value is masterdata-manager:add-partner:v4.
  ownerId String Required. The identifier for the Owner company associated with the request.
  appName String Required. The application that owns the event. Valid value is masterdata-manager.
  dataspace String Required. The dataspace within the environment where the request is being made. Valid value for the Production and Validation environments is default.
payload – Required. The request payload.
data Object Required. Contains the attributes for the object. The contents depend on the object schema specified when the event handlers were added.
  dataStatus String

Required. Indicates if the Partner company data is active within TraceLink.

Valid values:

  • DRAFT – The data is in a draft state but not submitted.
  • ACTIVE – The data can be used in messages and UI functions, and TraceLink pulls the data when necessary.
  • INACTIVE – The data cannot be pulled for other functions within TraceLink.
  regulatoryPartnerLicenses Array The regulatory Identifier.
    licenseStateOrRegion String

The state or region of the licensing agency.
    licenseIssuingAgency String

The agency that grants the regulatory license.

    licenseCountry String

Required. The country of the licensing agency.
    licenseNumber String

Required. The regulator license number for the location.
  regulatoryPartnerIdentifiers Array Required. The identifiers for a Partner company.
    regulatoryIdentifierValue String Required. The value ofPartner company identifier.
    isPrimaryRegulatoryIdentifier String

Required. Specifies if the given Partner identifier is the primary identifier. Only one identifier can be set as the primary identifier.

TraceLink uses the primary company identifier to identify the correct partner when the user updates the Master Data with an asynchronous message.

Valid values:

  • true – The identifier is the primary identifier.
  • false – (default) The identifier is not the primary identifier.
    regulatoryCompanyIdentifierType String

Required. The company identifier type.

  • AR_CUIT – 11-character Argentina Tax ID. Format is 00-00000000-0 (e.g. 33-56899856-8). Cannot be set as the Primary Identifier.
  • AM_TIN – 8-character Armenia Taxpayer Identification Number (e.g. 53663456). Cannot be set as the Primary Identifier.
  • BR_CNES – Brazil National Registry of Health Facilities Number (e.g. 3868249).
  • BR_CNPJ – 14-character Brazil Tax/Legal Entity ID. Format is 00.000.000/0001-00 (e.g. 71.116.165/0001-71).
  • BR_CPF – 11-character Brazil Individual Taxpayer Registration Number. Format is 000.000.000-00 (e.g. 605.085.153-00). The first 8 digits identify the company, the next 4 digits identify the branch or subsidiary ("0001" designates the headquarters), and the last 2 are check digits.
  • BR_PROF_REG – Brazil Professional Registration Number (e.g. CRODFCD9952).
  • BY_TIN – 9-character Belarus Taxpayer Identification Number (e.g. 004893223). Cannot be set as the Primary Identifier.
  • CN_CHINA_ID – Alphanumeric China identifier (e.g. 352J685B548N).
  • CN_FOREIGN_MAH – China Foreign MAH ID (e.g. 0678645).
  • CN_FOREIGN_MFR – China Foreign Manufacturer ID (e.g. 665S55D).
  • CN_USCID – China Unified Social Credit Identifier (e.g. 9771221453).
  • COMPANYID – Alphanumeric internal company identifier (e.g. KENDALL).
  • COMPANYSITEID – Alphanumeric internal location, plant, or site identifier (e.g. 465MEMPHIS).
  • DE_IFA_REG_NUM – 6-character Informationsstelle für Arzneispezialitäten (IFA) Registration Number (e.g. 548726). Cannot be set as the Primary Identifier.
  • DEA – 9-character US Drug Enforcement Agency Number (e.g. F92547851).
  • DUNS – 9-character Dunn and Bradstreet Number (e.g. 82-759-6961).
  • DUNS4 – 13-character Dunn and Bradstreet Number, which includes a 4 digit extension (e.g. 82-759-6961-KP89).
  • GCP – 6- to 12-character GS1 Global Company Prefix (e.g. 8856277).
  • GLN – 13-character Global Location Number (e.g. 8856277233311). To send and receive EPCIS messages, companies and locations need a GLN.
  • HIN – Maximum 9-alphanumeric character Health Industry Number assigned by HIBCC (e.g. 214Z65H00).
  • ID_BPOM_FACILITYID – Indonesia Facility ID (e.g. 45764574).
  • IN_COMPANY_ID – India Company ID (e.g. 5423695784236).
  • IN_GSTN – India Goods and Services Tax ID (e.g. 55876215).
  • IN_IEC – 10-character India Importer Exporter Code (e.g. 0255411222). Cannot be set as the Primary Identifier.
  • IN_LOCATION_ID – India Location ID (e.g. 65874532).
  • IN_MFR – India Manufacturing Code (e.g. 00552101).
  • IN_MRCH – India Merchant Exporter Code (e.g. 601227644).
  • IN_PAN – 10-character India Permanent Account Number. The first five characters are letters, next four numbers, last character is a letter (e.g. AFZPK7190K). Cannot be set as the Primary Identifier.
  • IN_TIN – 11-character India Taxpayer Identification Number (e.g. 95684444523). Cannot be set as the Primary Identifier.
  • KG_TIN – 14-character Kyrgyzstan Taxpayer Identification Number (e.g. 56200044505998). Cannot be set as the Primary Identifier.
  • KR_BUS_REG_NUMBER – 10-character South Korea Corporate Registration Number. Format is xxx-xx-xxxxx (e.g. 324-84-22451).
  • KR_PROVIDER_CODE – 8-character South Korea Provider Code (e.g. 45632196).
  • KZ_BIN – 12-character Kazakhstan Business Identification Number (e.g. 220110668755). Cannot be set as the Primary Identifier.
  • RU_ACCOUNT_NUMBER – 14- to 36-character Russia Account Number (e.g. 19527400000001 or 19406412-0001-000a-0000-000000000022). Cannot be set as the Primary Identifier.
  • RU_INN_FOREIGN_ENTITY – 10-character Russia Foreign Business Taxpayer Identification Number (e.g. 7744000912). Cannot be set as the Primary Identifier. Only one of the following identifier types can be assigned to an entity: RU - INN Local, RU - IN Foreign, and RU - INN Individual.
  • RU_INN_INDIV – 12-character Russia Individual Taxpayer Identification Number (e.g. 123456789001). Cannot be set as the Primary Identifier. Only one of the following identifier types can be assigned to an entity: RU - INN Local, RU - IN Foreign, and RU - INN Individual.
  • RU_INN_KPP_TAX_CODE – 9-character Russia KPP Registration Code (e.g. 771301001). Cannot be set as the Primary Identifier.
  • RU_INN_LOCAL_ENTITY – 10-character Russia Local Business Taxpayer Identification Number (e.g. 7728640746). Cannot be set as the Primary Identifier. Only one of the following identifier types can be assigned to an entity: RU - INN Local, RU - IN Foreign, and RU - INN Individual.
  • SGLN – 15-character SGLN format representation of Global Location Number:
    • Format for company entities is [CompanyPrefix].[LocationRef].0 or [CompanyPrefix]..0. The LocationRef segment is optional. If the LocationRef is included, the first two segments contain only digits separated by the dot, and must be 13 characters in total. If the LocationRef is not included, then the first segment must be 12 digits, followed by two dot seperators. The third segment should always be the digit 0. For example, 539885451928..0 or urn:epc:id:sgln:0614141.12345.0.
    • Format for location entities is [CompanyPrefix].[LocationRef].[sub-location identifier] or [CompanyPrefix]..[sub-location identifier].The LocationRef segment is optional. If the LocationRef is included, the first two segments contain only digits separated by the dot, and must be 13 characters in total. If the LocationRef is not included, then the first segment must be 12 digits, followed by two dot seperators. The third segment is always alphanumeric and can be any length, with at least one character in it preceded by the dot separator. For example, 8856277.23331.6 or 539885451928..11.
  • TRACELINK_ID – TraceLink Identification Number (e.g. KENDALLPHARM).
  • UZ_TIN – 9-character Uzbekistan Taxpayer Identification Number (e.g. 000181244). Cannot be set as the Primary Identifier.
  businessMasterDataCommon Object Required. The Partner's headquarters information.
    businessType String

Required. The different types of business the Partner conducts.

Valid values:

  • CARRYING_AND_FORWARDING_AGENT – The company facilitates the movement and transfer of goods. In India, CFAs are often involved in moving goods as interstate stock transfers.
  • CHEMIST – The company specializes in the composition of substances, may mix substances in preparation for dispensation, and has a shop selling medicines and cosmetics. Also known as a compounding facility.
  • DISTRIBUTOR – The company distributes pharmaceuticals.
  • EXPORTER – The company exports products. For customs purposes, this company makes the export declaration and sells the products to a company in another country, known as the importer.
  • HEALTHCARE_FACILITY – The company dispenses pharmaceuticals as a healthcare facility.
  • IMPORTER – The company imports products. For customs purposes, this company makes the import declaration, the shipping document names the company as consignee, and the exporter's invoice names the company as buyer.
  • LOGISTICS – The company provides logistics services (e.g. LSP, 3PL).
  • MANUFACTURER – The license holder of the pharmaceutical product (e.g. Brand Owners, Generics, MAHs, Specialty Companies).
  • PACKAGER – The company packages products.
  • PHARMACY – The company sells product directly to patients.
  • RETURNS_PROCESSOR – The company processes returns.
  • STOCKIST – The company stocks the products and then distributes them.
  • WHOLESALER – The company is a wholesaler of pharmaceuticals.
    businessName String Required. The Partner company's name.
    businessEmail String The Partner company's email address.
    businessPhone String

The Partner company's telephone number.
    businessUrl String The Partner company's URL.
    businessTaxRegistrationCode String

The Partner company's tax registration code. The code used to identify this entity for tax or other legal reporting purposes.
    businessAddress Object The Partner company's address information.
      address1 String

Required. The street address, including number and street name.
      address2 String

The second line of the street address. Any additional address information, if available.
      city String Required. The city where this Partner company is located.
      district String

The 3-digit numeric code of the district where the Partner company is located in India.
      village String

The village in which the Partner company is located.
      houseNumber String The unique number on the street for this Partner company.
      township String

The name of the town in which the Partner company is located.
      stateOrRegion String

Required. The state, province, or region using the standard two– or three–letter abbreviation specified in the ISO 3166–2:1998 country subdivision code.
      postalCode String

Conditionally required if the country has a ZIP or other postal code. If the country does have a postal code and it is omitted, an error is generated. See Valid values for exclusions.

  • Angola, AO

  • Antigua and Barbuda, AG

  • Aruba, AW

  • Bahamas, BS

  • Belize, BZ

  • Benin, BJ

  • Botswana, BW

  • Burkina Faso, BF

  • Burundi, BI

  • Cameroon, CM

  • Central African Republic, CF

  • Comoros, KM

  • Congo, CG

  • Congo, the Democratic Republic of the, CD

  • Cook Islands, CK

  • Cote d'Ivoire, CI

  • Djibouti, DJ

  • Dominica, DM

  • Equatorial Guinea, GQ

  • Eritrea, ER

  • Fiji, FJ

  • French Southern Territories, TF

  • Gambia, GM

  • Ghana, GH

  • Grenada, GD

  • Guinea, GN

  • Guyana, GY

  • Hong Kong, HK

  • Ireland, IE

  • Jamaica, JM

  • Kenya, KE

  • Kiribati, KI

  • Macao, MO

  • Malawi, MW

  • Mali, ML

  • Mauritania, MR

  • Mauritius, MU

  • Montserrat, MS

  • Nauru, NR

  • Netherlands Antilles, AN

  • Niue, NU

  • North Korea, KP

  • Panama, PA

  • Qatar, QA

  • Rwanda, RW

  • Saint Kitts and Nevis, KN

  • Saint Lucia, LC

  • Sao Tome and Principe, ST

  • Saudi Arabia, SA

  • Seychelles, SC

  • Sierra Leone, SL

  • Solomon Islands, SB

  • Somalia, SO

  • South Africa, ZA

  • Suriname, SR

  • Syria, SY

  • Tanzania, United Republic of, TZ

  • Timor-Leste, TL

  • Tokelau, TK

  • Tonga, TO

  • Trinidad and Tobago, TT

  • Tuvalu, TV

  • Uganda, UG

  • United Arab Emirates, AE

  • Vanuatu, VU

  • Yemen, YE

  • Zimbabwe, ZW
      country String

Required. The country using the standard two–letter abbreviation specified in ISO 3166–1alpha-2:1997 country code.

  • AD – ANDORRA
  • AE – UNITED ARAB EMIRATES
  • AF – AFGHANISTAN
  • AG – ANTIGUA AND BARBUDA
  • AI – ANGUILLA
  • AL – ALBANIA
  • AM – ARMENIA
  • AN – NETHERLANDS ANTILLES
  • AO – ANGOLA
  • AQ – ANTARCTICA
  • AR – ARGENTINA
  • AS – AMERICAN SAMOA
  • AT – AUSTRIA
  • AU – AUSTRALIA
  • AW – ARUBA
  • AX – ÅLAND ISLANDS
  • AZ – AZERBAIJAN
  • BA – BOSNIA AND HERZEGOVINA
  • BB – BARBADOS
  • BD – BANGLADESH
  • BE – BELGIUM
  • BF – BURKINA FASO
  • BG – BULGARIA
  • BH – BAHRAIN
  • BI – BURUNDI
  • BJ – BENIN
  • BL – SAINT BARTHÉLEMY
  • BM – BERMUDA
  • BN – BRUNEI DARUSSALAM
  • BO – BOLIVIA, PLURINATIONAL STATE OF
  • BR – BRAZIL
  • BS – BAHAMAS
  • BT – BHUTAN
  • BV – BOUVET ISLAND
  • BW – BOTSWANA
  • BY – BELARUS
  • BZ – BELIZE
  • CA – CANADA 
  • CC – COCOS (KEELING) ISLANDS
  • CD – CONGO, THE DEMOCRATIC REPUBLIC OF THE
  • CF – CENTRAL AFRICAN REPUBLIC
  • CG – CONGO
  • CH – SWITZERLAND
  • CI – CÔTE D'IVOIRE
  • CK – COOK ISLANDS
  • CL – CHILE
  • CM – CAMEROON
  • CN – CHINA
  • CO – COLOMBIA
  • CR – COSTA RICA
  • CU – CUBA
  • CV – CAPE VERDE
  • CX – CHRISTMAS ISLAND
  • CY – CYPRUS
  • CZ – CZECH REPUBLIC
  • DE – GERMANY
  • DJ – DJIBOUTI
  • DK – DENMARK
  • DM – DOMINICA
  • DO – DOMINICAN REPUBLIC
  • DZ – ALGERIA
  • EC – ECUADOR
  • EE – ESTONIA
  • EG – EGYPT
  • EH – WESTERN SAHARA
  • ER – ERITREA
  • ES – SPAIN
  • ET – ETHIOPIA
  • FI – FINLAND
  • FJ – FIJI
  • FK – FALKLAND ISLANDS (MALVINAS)
  • FM – MICRONESIA, FEDERATED STATES OF
  • FO – FAROE ISLANDS
  • FR – FRANCE
  • GA – GABON
  • GB – UNITED KINGDOM
  • GD – GRENADA
  • GE – GEORGIA
  • GF – FRENCH GUIANA
  • GG – GUERNSEY
  • GH – GHANA
  • GI – GIBRALTAR
  • GL – GREENLAND
  • GM – GAMBIA
  • GN – GUINEA
  • GP – GUADELOUPE
  • GQ – EQUATORIAL GUINEA
  • GR – GREECE
  • GS – SOUTH GEORGIA AND THE SOUTH SANDWICH ISLANDS
  • GT – GUATEMALA
  • GU – GUAM
  • GW – GUINEA–BISSAU
  • GY – GUYANA
  • HK - HONG KONG
  • HM – HEARD ISLAND AND MCDONALD ISLANDS
  • HN – HONDURAS
  • HR – CROATIA
  • HT – HAITI
  • HU – HUNGARY
  • ID – INDONESIA
  • IE – IRELAND
  • IL – ISRAEL
  • IM – ISLE OF MAN
  • IN – INDIA
  • IO – BRITISH INDIAN OCEAN TERRITORY
  • IQ – IRAQ
  • IR – IRAN, ISLAMIC REPUBLIC OF
  • IS – ICELAND
  • IT – ITALY
  • JE – JERSEY
  • JM – JAMAICA
  • JO – JORDAN
  • JP – JAPAN
  • KE – KENYA
  • KG – KYRGYZSTAN
  • KH – CAMBODIA
  • KI – KIRIBATI
  • KM – COMOROS
  • KN – SAINT KITTS AND NEVIS
  • KP – KOREA, DEMOCRATIC PEOPLE'S REPUBLIC OF
  • KR – KOREA, REPUBLIC OF
  • KW – KUWAIT
  • KY – CAYMAN ISLANDS
  • KZ – KAZAKHSTAN
  • LA – LAO PEOPLE'S DEMOCRATIC REPUBLIC
  • LB – LEBANON
  • LC – SAINT LUCIA
  • LI – LIECHTENSTEIN
  • LK – SRI LANKA
  • LR – LIBERIA
  • LS – LESOTHO
  • LT – LITHUANIA
  • LU – LUXEMBOURG
  • LV – LATVIA
  • LY – LIBYAN ARAB JAMAHIRIYA
  • MA – MOROCCO
  • MC – MONACO
  • MD – MOLDOVA, REPUBLIC OF
  • ME – MONTENEGRO
  • MF – SAINT MARTIN
  • MG – MADAGASCAR
  • MH – MARSHALL ISLANDS
  • MK – MACEDONIA, THE FORMER YUGOSLAV REPUBLIC OF
  • ML – MALI
  • MM – MYANMAR
  • MN – MONGOLIA
  • MO – MACAO
  • MP – NORTHERN MARIANA ISLANDS
  • MQ – MARTINIQUE
  • MR – MAURITANIA
  • MS – MONTSERRAT
  • MT – MALTA
  • MU – MAURITIUS
  • MV – MALDIVES
  • MW – MALAWI 
  • MX – MEXICO
  • MY – MALAYSIA
  • MZ – MOZAMBIQUE
  • NA – NAMIBIA
  • NC – NEW CALEDONIA
  • NE – NIGER
  • NF – NORFOLK ISLAND
  • NG – NIGERIA
  • NI – NICARAGUA
  • NL – NETHERLANDS
  • NO – NORWAY
  • NP – NEPAL
  • NR – NAURU
  • NU – NIUE
  • NZ – NEW ZEALAND
  • OM – OMAN
  • PA – PANAMA
  • PE – PERU
  • PF – FRENCH POLYNESIA
  • PG – PAPUA NEW GUINEA
  • PH – PHILIPPINES
  • PK – PAKISTAN
  • PL – POLAND
  • PM – SAINT PIERRE AND MIQUELON
  • PN – PITCAIRN
  • PR – PUERTO RICO
  • PS – PALESTINIAN TERRITORY, OCCUPIED
  • PT – PORTUGAL
  • PW – PALAU
  • PY – PARAGUAY
  • QA – QATAR
  • RE – RÉUNION
  • RO – ROMANIA
  • RS – SERBIA
  • RU – RUSSIAN FEDERATION
  • RW – RWANDA
  • SA – SAUDI ARABIA
  • SB – SOLOMON ISLANDS
  • SC – SEYCHELLES
  • SD – SUDAN
  • SE – SWEDEN
  • SG – SINGAPORE
  • SH – SAINT HELENA, ASCENSION AND TRISTAN DA CUNHA
  • SI – SLOVENIA
  • SJ – SVALBARD AND JAN MAYEN
  • SK – SLOVAKIA
  • SL – SIERRA LEONE
  • SM – SAN MARINO
  • SN – SENEGAL
  • SO – SOMALIA
  • SR – SURINAME
  • ST – SAO TOME AND PRINCIPE
  • SV – EL SALVADOR
  • SY – SYRIAN ARAB REPUBLIC
  • SZ – SWAZILAND
  • TC – TURKS AND CAICOS ISLANDS
  • TD – CHAD
  • TF – FRENCH SOUTHERN TERRITORIES
  • TG – TOGO
  • TH – THAILAND
  • TJ – TAJIKISTAN
  • TK – TOKELAU
  • TL – TIMOR–LESTE
  • TM – TURKMENISTAN
  • TN – TUNISIA
  • TO – TONGA
  • TR – TURKEY
  • TT – TRINIDAD AND TOBAGO
  • TV – TUVALU
  • TW – TAIWAN
  • TZ – TANZANIA, UNITED REPUBLIC OF
  • UA – UKRAINE
  • UG – UGANDA
  • UM – UNITED STATES MINOR OUTLYING ISLANDS
  • US – UNITED STATES
  • UY – URUGUAY
  • UZ – UZBEKISTAN
  • VA – HOLY SEE (VATICAN CITY STATE)
  • VC – SAINT VINCENT AND THE GRENADINES
  • VE – VENEZUELA, BOLIVARIAN REPUBLIC OF
  • VG – VIRGIN ISLANDS, BRITISH
  • VI – VIRGIN ISLANDS, U.S.
  • VN – VIET NAM
  • VU – VANUATU
  • WF – WALLIS AND FUTUNA
  • WS – SAMOA
  • XK – KOSOVO
  • YE – YEMEN
  • YT – MAYOTTE
  • ZA – SOUTH AFRICA
  • ZM – ZAMBIA
  • ZW – ZIMBABWE
      url String The URL of the Partner company's website.
      buildingNumber String The Partner company's building number.
      plantNumber String The Partner company's plant number.
      floorNumber String The Partner company's floor number.
      premisesCode String

The internal identifier associated with this Partner company (e.g. a company with 4 locations in the city of Mumbai internally refers to the 4th location as MUM4).

      fax String The Partner company's fax number.
      telephone String

The phone number of the contact person or department at the Partner company.
           
    regulatoryContact Array

The contact information for the regulatory contact at the Partner company. Each field can only appear once per Partner company.
      regulatoryContactName String

The regulatory contact's name in base64 format.
      regulatoryContactTitle String

The regulatory contact's business title.
      regulatoryContactEmail String

The regulatory contact's email address.
      regulatoryContactPhone String

The regulatory contact's phone number.

Example

{
    "header": {
        "headerVersion": 1,
        "eventName": "masterdata-manager:add-partner:v4",
        "ownerId": "bb40845c-8912-4b98-9c9a-f08bd5a9bd07",
        "dataspace": "default",
        "appName": "masterdata-manager"
    },
     "payload": {
        "id":"15af7e5b-0ce5-11ed-a271-ede41d741a85",
        "data": {
            "dataStatus": "ACTIVE",
            "companyIdentifier": [
                "bb40845c-8912-4b98-9c9a-f08bd5a9bd07"
            ],
            "regulatoryPartnerLicenses": [
            {
                "lscLicenseIdentifier": "lscLicenseIdentifier",
                "licenseStateOrRegion": "MA",
                "licenseIssuingAgency": "licenseIssuingAgency",
                "licenseCountry": "US",
                "licenseNumber": "100001"
            }
            ],
            "regulatoryPartnerIdentifiers": [
            {
                "regulatoryIdentifierValue": "1888881021124",
                "lscRegulatoryIdentifier": "lscRegulatoryIdentifier",
                "isPrimaryRegulatoryIdentifier": true,
                "regulatoryCompanyIdentifierType": "GLN"
            }
            ],
            "businessMasterDataCommon": {
                "businessType": ["MANUFACTURER"],
                "lscBusinessVersion": "lscBusinessVersion",
                "businessName": "businessName",
                "businessEmail": "m@m.com",
                "businessPhone": "businessPhone",
                "businessUrl": "businessUrl",
                "businessTaxRegistrationCode": "businessTaxRegistrationCode",
                "businessAddress": {
                    "address1": "address1",
                    "address2": "address2",
                    "buildingNumber": "buildingNumber",
                    "plantNumber": "plantNumber",
                    "floorNumber": "floorNumber",
                    "houseNumber": "houseNumber",
                    "city": "city",
                    "village": "village",
                    "township": "township",
                    "district": "district",
                    "state": "state",
                    "postalCode": "postalCode",
                    "country": "US",
                    "telephone": "telephone",
                    "fax": "fax",
                    "url": "url",
                    "lscAddressIdentifier": "lscAddressIdentifier"
                },
                "regulatoryContact": {
                    "regulatoryContactTitle": "regulatoryContactTitle",
                    "regulatoryContactName": "regulatoryContactName",
                    "regulatoryContactEmail": "m@m.com",
                    "regulatoryContactPhone": "regulatoryContactPhone"
                }
            }
        }
    }
}

Guidelines

Element Type Description
header – Required. The response header.
  headerVersion Integer Required. The version identifier for the response. Valid value is 1.
  eventName String Required. The fully qualified name of the response event. Valid value is masterdata-manager:add-partner-response:v4.
  ownerId String Required. The identifier for the Owner company associated with the request.
  isErr Boolean

Required. Indicates whether the request was successful. Valid values:

  • true – The request was successful.
  • false – The request was not successful. The errCode field provides error information for troubleshooting.
  errCode String Required. The status code of the request. 200_OK indicates that the request was successful.
  errMsg String

Conditionally required if the call is unsuccessful. The message associated with the error code.
  licensePlate String Required. The unique identifier for the request and response instance.
  exceptionName String

The exception returned for the request, if applicable.

Valid values:

  • BadRequestException – The request is missing fields or has invalid data.
  • NotFoundException – The requested information is not available.
payload – Required. The payload containing the response body. If the call is unsuccessful, payload is null.
  id String Conditionally required if the call is successful. The identifier for the new or edited Partner company.

Example

{
    "header": {
        "headerVersion": 1,
        "eventName": "masterdata-manager:add-partner-response:v4",
        "ownerId": "bb40845c-8912-4b98-9c9a-f08bd5a9bd07",
        "isErr": false,
        "errCode": "200_OK",
        "licensePlate": "AWcxNp-nDAFrJ"
    },
    "payload": {
        "id": "15af7e5b-0ce5-11ed-a271-ede41d741a85"
    }
}

Errors

Element Error Message Description
  • dataStatus
  • regulatoryCompanyIdentifierType
  • businessType

Invalid value for . Valid values are: [list of valid values, separated by commas].

 The error occurs if the value is not in the list of valid values.
regulatoryPartnerIdentifiers Identifiers must be unique. Identifier [] already exists in Company or Partner Master Data. The error occurs if the regulatoryPartnerIdentifiers specifies a primary ID that is in use but is not the primary company Id.
regulatoryPartnerIdentifiers Identifier Type has two values. Only one identifier value for each type can be added for this location, except for COMPANYID and COMPANYSITEID. The error occurs if the regulatoryPartnerIdentifiers specifies a primary ID that does not belong to the company.
isPrimaryRegulatoryIdentifier No identifiers are currently set as the primary. One identifier must be set as the primary identifier. The error occurs if no identifiers are set at the primary identifier.
isPrimaryRegulatoryIdentifier Multiple identifiers are currently set as the primary. Only one identifier can be set as the primary identifier.

The error occurs if isPrimaryRegulatoryIdentifier is set to have multiple identifiers as the primary identifier.
regulatoryPartnerLicenses

License is already assigned to another Partner company or location.

The error occurs if regulatoryPartnerLicenses is set to assign a license to more than one Partner company or location.
businessEmail An email address is not in the valid format.

The error occurs if an invalid email address is entered.

regulatoryContactEmail An email address is not in the valid format. The error occurs if an invalid email address is entered.

This app uses standard HTTP response codes. If an error occurs, additional available information regarding the cause of the error is provided in the errMsg element in the relevant response.

Review TraceLink's API: Terms of Use

Query Partner Company Master Data

IT system administrators and app developers use this message to retrieve the full master data record for a partner company (e.g. name, address).

Guidelines

  Attribute Type Description
header –

Required. The request header.
  headerVersion Integer

Required. The version identifier for the request. Valid value is1.
  eventName String

Required. The fully qualified name of the request event. Valid value ismasterdata-manager:query-partnerMasterData:v1.
  ownerId String

Required. The identifier for the company providing the app.
  dataspace String

Required. The dataspace within the environment where the request is being made. Valid value for the Production and Validation environments is default.
  appName String

Required. The application that owns the event. Valid value ismasterdata-manager.
payload –

Required. The request body.
  predicates Array

Required. The contents of the query.
    type String

Required. The type of the predicate. Valid value is PREDICATE.
    logicalOperator String

Required. The logical operator of the predicate.

Valid values:

  • AND
  • OR
  • TRUE
    clauses Array

Required. The attributes and values to include in the response message.
      type String

Required. The type of the clause. Valid value is TERM.
      comparisonOperator String

Required. The operator of the term. 

Valid values:

  • CLOSED - Search for values within a range, including the endpoints of the range
  • CLOSED_OPEN - Search for values within a range, where the range includes the lower endpoint and does not include the upper endpoint
  • DB_FTS - Perform a full-text search using the query term. Does not support wildcards.
  • EQ - Equal to
  • GE - Greater than or equal to
  • GT - Greater than
  • IN - Search for values that are included in the given list
  • LE - Less than or equal to
  • LT - Less than
  • LUCENE_FTS - Perform a Lucene search using the contents of ftsInfo. Lucene wildcards are supported.
  • NE - Not equal
  • OPEN - Search for values within a range, not including the endpoints of the range
  • OPEN_CLOSED - Search for values within a range, where the range does not include the lower endpoint and does include the upper endpoint
  • WILDCARD - Perform a search that matches the wildcard query. Supported wildcards are * and ..
      schemaId String

Required. The schema identifier of the network objects being queried.
      ftsInfo Object

Required. The Lucene query info.

        value String Required. Determines the content the query searches for. Replace "[searchString]" with the search value. Valid values:
  • index-regulatoryPartnerIdentifiersDerivedField:[searchString]
    • Simultaneously searches for the [searchString] in the following fields:
      • Identifier Type
      • Identifier Value
  • index-regulatoryPartnerIdentifiersWithBusinessNameDerivedField:[searchString]
    • Simultaneously searches for the [searchString] in the following fields:
      • Company Name
      • Identifier Type
      • Identifier Value
  • index-regulatoryPartnerLicensesWithBusinessNameDerivedField:[searchString]
    • Simultaneously searches for the [searchString] in the following fields:
      • Partner Company Name
      • Agency
      • Country
      • State or Region
      • Number
  • index-businessMasterDataCommon.businessName:[searchString]
  • index-companyIdentifier INDEX ON /data/companyIdentifier
        pageIndex Integer

Required. The index of the first page of results to display, starting at 0.
        sortField Object

Required. The method of sorting the values in the relevant indexes.

Valid values:

  • ASCENDING
  • DESCENDING
  maximumResults Integer

Required. The maximum number of results returned in the response.
  pagingInfo String

Required. The query paging information representing where the previous query result ended. The pagingInfo from the previous query may be used as the starting point for the current query.
  keyFormat String

Required. The format of the response to a key-only query.

Valid values:

  • OBJECT_ID – The object identifier of the document is returned in the response.
  • PRIMARY_KEY – The primary key of the object in schemaId#objectId format is returned in the response.

Example

{
  "header": {
    "headerVersion": 1,
    "eventName": "masterdata-manager:query-partnerMasterData:v1",
    "ownerId": "00000000-0000-0000-0000-000000000000",
    "dataspace": "default",
    "appName": "masterdata-manager"
  },
  "payload": {
    "predicates": [
      {
        "type": "PREDICATE",
        "logicalOperator": "TRUE",
        "clauses": [{
          "type": "TERM",
          "comparisonOperator": "LUCENE_FTS",
          "schemaId": "masterdata-manager:partnerMasterData",
          "ftsInfo": {
            "value": "index-regulatoryPartnerIdentifiersWithBusinessNameDerivedField:*123*",
            "pageIndex": 0,
            "sortField": {
            }
          }
        }]
      }    
    ],
    "maximumResults": 10000,
    "pagingInfo": "",
    "keyFormat": "PRIMARY_KEY"
  }
}

Guidelines

  Attribute Type Description
header –

Required. The response header.
  headerVersion Integer

Required. The version identifier for the response. Valid value is1.
  eventName String

Required. The fully qualified name of the response event. Valid value ismasterdata-manager:query-partnerMasterData:v1
  ownerId String

Required. The identifier for the company providing the app.
  isErr String

Required. Indicates whether the request was successful. Valid values:

  • true – The request was successful.
  • false – The request was not successful. The errCode field provides error information for troubleshooting.
  errCode String

Required. The status code of the request. 200_OK indicates that the request was successful.
  errMsg String

Conditionally required if the call is unsuccessful. The message associated with the error code.
  licensePlate String

Required. The unique identifier for the request and response instance.
payload –

Required. The response body.
  pagingInfo String

Required. The query paging information representing where the previous query result ended. The pagingInfo from the previous query may be used as the starting point for a new query.
  documents Array

Required. Contains the results of the query request.
    metadata Object

Required. The metadata about the object.
        schemaId String

Required. The JSON schema that defines the object.
        schemaVersion Integer

Required. The JSON schema version number.
        primaryKey String

Required. The primary key of the object.
        dataVersion Integer

Required. The current version number of the object.
        indexTarget String

Required. The index target identifier of the object.
        dbTxid Integer

Required. The transactional identifier of the object.
    payload – Required. The master data objects.
      schemaVersion String

Required. The JSON schema version number.
      data Object

Required. Contains the attributes for the object. The contents depend on the object schema specified when the event handlers were added.
        dataStatus Boolean

Required. Indicates if the master data for this location is active or inactive.

Valid values:

  • true – The master data for this location is active.
  • false – The master data for this location is inactive.
        lscS3Identifier String

Required. The identifier of the company object that S3 uses.
        isLegalEntity Boolean

Specifies if the company is a legal entity.

Valid values:

  • true – The node is a legal entity.
  • false – The node is not a legal entity.
        providerNetworkNodeIdentifier String

Required. The network node of the originating company for the master data record.
        legalEntityCode String

The legal entity code of the network node.
        companyNetworkNodeId String

Required. The network node that the record belongs to.
        regulatoryPartnerLicenses Array The Partner company's license information.
          lscLicenseIdentifier String The license identifier in Track & Trace Services.
          licenseNumber String Required. The regulatory license number for the specified Partner company.
          licenseCountry String Required. The country of the licensing agency.
          licenseIssuingAgency String The agency granting the regulatory license.
          licenseStateOrRegion String The state or region of the licensing agency.
        regulatoryPartnerIdentifiers String

Required. The list of all identifiers of the company.
          regulatoryCompanyIdentifierTypeId String Required. The identifier of the regulatory identifier type and value combination.
          regulatoryCompanyIdentifierType String

Required. The identifier type.
          isPrimaryRegulatoryIdentifier String

Required. Specifies if the given identifier is the primary identifier.
          regulatoryIdentifierValue String

Required. The identifier value.
        businessMasterDataCommon TypeDef

Required. The common business information.
          businessType String

The list of all business types of the company.

          lscBusinessVersion String

Required. The business version identifier in Track & Trace Services.
          businessName String

Required. The company's name.
          businessEmail String

The company's email address.
          businessPhone String

The company's phone number.
          businessUrl String

The URL of the company's website.
          businessTaxRegistrationCode String

The company's tax registration code.
          businessAddress TypeDef

The company's address information.
            address1 String

Required. The street address, including number and street name.
            address2 String

The second line of the street address. Any additional address information, if available.
            city String Required. The city where this Partner company is located.
            district String

The 3-digit numeric code of the district where the company is located in India.
            village String

The village in which the Partner company is located.
            houseNumber String

The building, house, or unit number of the company. House numbers are usually only separated from the street address in China. For all addresses outside of China, continue to enter the building, house, or unit number in address1.
            township String

The name of the town in which the Partner company is located.
            stateOrRegion String

Required. The state, province, or region using the standard two– or three–letter abbreviation specified in the ISO 3166–2:1998 country subdivision code.
            postalCode String

Conditionally required if the country has a ZIP or other postal code. If the country does have a postal code and it is omitted, an error is generated. See Valid values for exclusions.

  • Angola, AO

  • Antigua and Barbuda, AG

  • Aruba, AW

  • Bahamas, BS

  • Belize, BZ

  • Benin, BJ

  • Botswana, BW

  • Burkina Faso, BF

  • Burundi, BI

  • Cameroon, CM

  • Central African Republic, CF

  • Comoros, KM

  • Congo, CG

  • Congo, the Democratic Republic of the, CD

  • Cook Islands, CK

  • Cote d'Ivoire, CI

  • Djibouti, DJ

  • Dominica, DM

  • Equatorial Guinea, GQ

  • Eritrea, ER

  • Fiji, FJ

  • French Southern Territories, TF

  • Gambia, GM

  • Ghana, GH

  • Grenada, GD

  • Guinea, GN

  • Guyana, GY

  • Hong Kong, HK

  • Ireland, IE

  • Jamaica, JM

  • Kenya, KE

  • Kiribati, KI

  • Macao, MO

  • Malawi, MW

  • Mali, ML

  • Mauritania, MR

  • Mauritius, MU

  • Montserrat, MS

  • Nauru, NR

  • Netherlands Antilles, AN

  • Niue, NU

  • North Korea, KP

  • Panama, PA

  • Qatar, QA

  • Rwanda, RW

  • Saint Kitts and Nevis, KN

  • Saint Lucia, LC

  • Sao Tome and Principe, ST

  • Saudi Arabia, SA

  • Seychelles, SC

  • Sierra Leone, SL

  • Solomon Islands, SB

  • Somalia, SO

  • South Africa, ZA

  • Suriname, SR

  • Syria, SY

  • Tanzania, United Republic of, TZ

  • Timor-Leste, TL

  • Tokelau, TK

  • Tonga, TO

  • Trinidad and Tobago, TT

  • Tuvalu, TV

  • Uganda, UG

  • United Arab Emirates, AE

  • Vanuatu, VU

  • Yemen, YE

  • Zimbabwe, ZW
            country String

Required. The country using the standard two–letter abbreviation specified in ISO 3166–1alpha-2:1997 country code.

  • AD – ANDORRA
  • AE – UNITED ARAB EMIRATES
  • AF – AFGHANISTAN
  • AG – ANTIGUA AND BARBUDA
  • AI – ANGUILLA
  • AL – ALBANIA
  • AM – ARMENIA
  • AN – NETHERLANDS ANTILLES
  • AO – ANGOLA
  • AQ – ANTARCTICA
  • AR – ARGENTINA
  • AS – AMERICAN SAMOA
  • AT – AUSTRIA
  • AU – AUSTRALIA
  • AW – ARUBA
  • AX – ÅLAND ISLANDS
  • AZ – AZERBAIJAN
  • BA – BOSNIA AND HERZEGOVINA
  • BB – BARBADOS
  • BD – BANGLADESH
  • BE – BELGIUM
  • BF – BURKINA FASO
  • BG – BULGARIA
  • BH – BAHRAIN
  • BI – BURUNDI
  • BJ – BENIN
  • BL – SAINT BARTHÉLEMY
  • BM – BERMUDA
  • BN – BRUNEI DARUSSALAM
  • BO – BOLIVIA, PLURINATIONAL STATE OF
  • BR – BRAZIL
  • BS – BAHAMAS
  • BT – BHUTAN
  • BV – BOUVET ISLAND
  • BW – BOTSWANA
  • BY – BELARUS
  • BZ – BELIZE
  • CA – CANADA 
  • CC – COCOS (KEELING) ISLANDS
  • CD – CONGO, THE DEMOCRATIC REPUBLIC OF THE
  • CF – CENTRAL AFRICAN REPUBLIC
  • CG – CONGO
  • CH – SWITZERLAND
  • CI – CÔTE D'IVOIRE
  • CK – COOK ISLANDS
  • CL – CHILE
  • CM – CAMEROON
  • CN – CHINA
  • CO – COLOMBIA
  • CR – COSTA RICA
  • CU – CUBA
  • CV – CAPE VERDE
  • CX – CHRISTMAS ISLAND
  • CY – CYPRUS
  • CZ – CZECH REPUBLIC
  • DE – GERMANY
  • DJ – DJIBOUTI
  • DK – DENMARK
  • DM – DOMINICA
  • DO – DOMINICAN REPUBLIC
  • DZ – ALGERIA
  • EC – ECUADOR
  • EE – ESTONIA
  • EG – EGYPT
  • EH – WESTERN SAHARA
  • ER – ERITREA
  • ES – SPAIN
  • ET – ETHIOPIA
  • FI – FINLAND
  • FJ – FIJI
  • FK – FALKLAND ISLANDS (MALVINAS)
  • FM – MICRONESIA, FEDERATED STATES OF
  • FO – FAROE ISLANDS
  • FR – FRANCE
  • GA – GABON
  • GB – UNITED KINGDOM
  • GD – GRENADA
  • GE – GEORGIA
  • GF – FRENCH GUIANA
  • GG – GUERNSEY
  • GH – GHANA
  • GI – GIBRALTAR
  • GL – GREENLAND
  • GM – GAMBIA
  • GN – GUINEA
  • GP – GUADELOUPE
  • GQ – EQUATORIAL GUINEA
  • GR – GREECE
  • GS – SOUTH GEORGIA AND THE SOUTH SANDWICH ISLANDS
  • GT – GUATEMALA
  • GU – GUAM
  • GW – GUINEA–BISSAU
  • GY – GUYANA
  • HK - HONG KONG
  • HM – HEARD ISLAND AND MCDONALD ISLANDS
  • HN – HONDURAS
  • HR – CROATIA
  • HT – HAITI
  • HU – HUNGARY
  • ID – INDONESIA
  • IE – IRELAND
  • IL – ISRAEL
  • IM – ISLE OF MAN
  • IN – INDIA
  • IO – BRITISH INDIAN OCEAN TERRITORY
  • IQ – IRAQ
  • IR – IRAN, ISLAMIC REPUBLIC OF
  • IS – ICELAND
  • IT – ITALY
  • JE – JERSEY
  • JM – JAMAICA
  • JO – JORDAN
  • JP – JAPAN
  • KE – KENYA
  • KG – KYRGYZSTAN
  • KH – CAMBODIA
  • KI – KIRIBATI
  • KM – COMOROS
  • KN – SAINT KITTS AND NEVIS
  • KP – KOREA, DEMOCRATIC PEOPLE'S REPUBLIC OF
  • KR – KOREA, REPUBLIC OF
  • KW – KUWAIT
  • KY – CAYMAN ISLANDS
  • KZ – KAZAKHSTAN
  • LA – LAO PEOPLE'S DEMOCRATIC REPUBLIC
  • LB – LEBANON
  • LC – SAINT LUCIA
  • LI – LIECHTENSTEIN
  • LK – SRI LANKA
  • LR – LIBERIA
  • LS – LESOTHO
  • LT – LITHUANIA
  • LU – LUXEMBOURG
  • LV – LATVIA
  • LY – LIBYAN ARAB JAMAHIRIYA
  • MA – MOROCCO
  • MC – MONACO
  • MD – MOLDOVA, REPUBLIC OF
  • ME – MONTENEGRO
  • MF – SAINT MARTIN
  • MG – MADAGASCAR
  • MH – MARSHALL ISLANDS
  • MK – MACEDONIA, THE FORMER YUGOSLAV REPUBLIC OF
  • ML – MALI
  • MM – MYANMAR
  • MN – MONGOLIA
  • MO – MACAO
  • MP – NORTHERN MARIANA ISLANDS
  • MQ – MARTINIQUE
  • MR – MAURITANIA
  • MS – MONTSERRAT
  • MT – MALTA
  • MU – MAURITIUS
  • MV – MALDIVES
  • MW – MALAWI 
  • MX – MEXICO
  • MY – MALAYSIA
  • MZ – MOZAMBIQUE
  • NA – NAMIBIA
  • NC – NEW CALEDONIA
  • NE – NIGER
  • NF – NORFOLK ISLAND
  • NG – NIGERIA
  • NI – NICARAGUA
  • NL – NETHERLANDS
  • NO – NORWAY
  • NP – NEPAL
  • NR – NAURU
  • NU – NIUE
  • NZ – NEW ZEALAND
  • OM – OMAN
  • PA – PANAMA
  • PE – PERU
  • PF – FRENCH POLYNESIA
  • PG – PAPUA NEW GUINEA
  • PH – PHILIPPINES
  • PK – PAKISTAN
  • PL – POLAND
  • PM – SAINT PIERRE AND MIQUELON
  • PN – PITCAIRN
  • PR – PUERTO RICO
  • PS – PALESTINIAN TERRITORY, OCCUPIED
  • PT – PORTUGAL
  • PW – PALAU
  • PY – PARAGUAY
  • QA – QATAR
  • RE – RÉUNION
  • RO – ROMANIA
  • RS – SERBIA
  • RU – RUSSIAN FEDERATION
  • RW – RWANDA
  • SA – SAUDI ARABIA
  • SB – SOLOMON ISLANDS
  • SC – SEYCHELLES
  • SD – SUDAN
  • SE – SWEDEN
  • SG – SINGAPORE
  • SH – SAINT HELENA, ASCENSION AND TRISTAN DA CUNHA
  • SI – SLOVENIA
  • SJ – SVALBARD AND JAN MAYEN
  • SK – SLOVAKIA
  • SL – SIERRA LEONE
  • SM – SAN MARINO
  • SN – SENEGAL
  • SO – SOMALIA
  • SR – SURINAME
  • ST – SAO TOME AND PRINCIPE
  • SV – EL SALVADOR
  • SY – SYRIAN ARAB REPUBLIC
  • SZ – SWAZILAND
  • TC – TURKS AND CAICOS ISLANDS
  • TD – CHAD
  • TF – FRENCH SOUTHERN TERRITORIES
  • TG – TOGO
  • TH – THAILAND
  • TJ – TAJIKISTAN
  • TK – TOKELAU
  • TL – TIMOR–LESTE
  • TM – TURKMENISTAN
  • TN – TUNISIA
  • TO – TONGA
  • TR – TURKEY
  • TT – TRINIDAD AND TOBAGO
  • TV – TUVALU
  • TW – TAIWAN
  • TZ – TANZANIA, UNITED REPUBLIC OF
  • UA – UKRAINE
  • UG – UGANDA
  • UM – UNITED STATES MINOR OUTLYING ISLANDS
  • US – UNITED STATES
  • UY – URUGUAY
  • UZ – UZBEKISTAN
  • VA – HOLY SEE (VATICAN CITY STATE)
  • VC – SAINT VINCENT AND THE GRENADINES
  • VE – VENEZUELA, BOLIVARIAN REPUBLIC OF
  • VG – VIRGIN ISLANDS, BRITISH
  • VI – VIRGIN ISLANDS, U.S.
  • VN – VIET NAM
  • VU – VANUATU
  • WF – WALLIS AND FUTUNA
  • WS – SAMOA
  • XK – KOSOVO
  • YE – YEMEN
  • YT – MAYOTTE
  • ZA – SOUTH AFRICA
  • ZM – ZAMBIA
  • ZW – ZIMBABWE
            url String The URL of Partner company's website.
            buildingNumber String

The company's building number.
            plantNumber String

The facility's plant number.
            floorNumber String

The facility's floor number.
            premisesCode String

The identifier representing a physical area within the company location (e.g. a location's second floor).
            fax String

The office's fax number.
            telephone String

The office's telephone number.
            lscAddressidentifier String

The global identifier assigned by Russian Federation Information Address System (FIAS). Maximum 36 characters, using the digits 0-9 and letters A-F.
          regulatoryContact Object

The contact information for the regulatory contact at the company.
            regulatoryContactTitle String

The regulatory contact's business title.
            regulatoryContactName String

The regulatory contact's name.
            regulatoryContactEmail String

The regulatory contact's email address.
            regulatoryContactPhone Integer

The regulatory contact's phone number.
          businessLogo Object

Information for the business logo.
            imageIdentifier String

The business logo's image identifier.
            imageMimeType String

The business logo's image mime type.
            imagefileName String

The business logo's file name.
            imagebase64 String

A readable string of the image.
        regulatoryPartnerIdentifiersDerivedField String

The result of the query when ftsInfo | value equals *index-regulatoryPartnerIdentifiersDerivedField:searchString* in the request.
        regulatoryPartnerIdentifiersWithBusinessNameDerivedField String

The result of the query when ftsInfo | value equals *index-regulatoryPartnerIdentifiersWithBusinessNameDerivedField:[searchString] in the request.
        regulatoryPartnerLicensesWithBusinessNameDerivedField String

The result of the query when ftsInfo | value equals index-regulatoryPartnerLicensesWithBusinessNameDerivedField in the request.
    schemaId String

Required. The JSON schema that defines the object.
    id String Required. The identifier of the master data object.
    objectType String Required. The type of the object. Valid value is masterdata-manager:productMasterData.
    lastUpdatedDateTime String

The identifier of the user that made the last update to the master data record.

    contextualOwnerId String Required. The identifier of the Partner company sending the master data request.
    lastUpdatedByUserId DateTime

The identifier of the user that made the last update to the master data record.
    ownerId String

Required. The identifier of the Partner company that owns the master data record.
    dataVersion Integer

Required. The current version number of the object.
    createdByUserId String

Required. The ID of the user that created the master data record.
    creationDateTime DateTime

Required. The date and time when the master data record was created.
  primaryKey String Required. The primary key of the object.
facets String

Required. Enables searches through a particular dataset.

Example

{
  "header": {
    "headerVersion": 1,
    "eventName": "masterdata-manager:query-partnerMasterData-response:v1",
    "ownerId": "00000000-0000-0000-0000-000000000000",
    "isErr": false,
    "errCode": "200_OK",
    "licensePlate": "W1thmm"
  },
  "payload": {
    "pagingInfo": null,
    "documents": [
      {
        "metadata": {
          "schemaId": "masterdata-manager:partnerMasterData",
          "schemaVersion": 1,
          "primaryKey": "masterdata-manager:partnerMasterData#471b0f7a-4759-4279-bf8e-dc74c70bd8a8",
          "dataVersion": 1,
          "indexTarget": "471b0f7a-4759-4279-bf8e-dc74c70bd8a8",
          "dbTxId": 111353
        },
        "payload": {
          "schemaVersion": 1,
          "data": {
            "dataStatus": "dataStatus",
            "lscS3Identifier": "lscS3Identifier",
            "isLegalEntity": true,
            "providerNetworkNodeIdentifier": "providerNetworkNodeIdentifier",
            "legalEntityCode": "legalEntityCode",
            "companyNetworkNodeId": "companyNetworkNodeId",
            "regulatoryPartnerLicenses": [
              {
                "lscLicenseIdentifier": "lscLicenseIdentifier",
                "licenseNumber": "licenseNumber",
                "licenseCountry": "US",
                "licenseIssuingAgency": "licenseIssuingAgency",
                "licenseStateOrRegion": "licenseStateOrRegion"
              }
            ],
            "regulatoryPartnerIdentifiers": [
              {
                "regulatoryCompanyIdentifierTypeId": "ac8b1d0b-8041-4938-bd38-0c5eeed8a28b",
                "regulatoryCompanyIdentifierType": "SGLN",
                "lscRegulatoryIdentifier": "lscRegulatoryIdentifier",
                "isPrimaryRegulatoryIdentifier": false,
                "regulatoryIdentifierValue": "8888882021122"
              }
            ],
            "businessMasterDataCommon": {
              "businessType": [
                "MANUFACTURER"
              ],
              "lscBusinessVersion": "lscBusinessVersion",
              "businessName": "businessNameTest",
              "businessEmail": "businessEmail",
              "businessPhone": "businessPhone",
              "businessUrl": "businessUrl",
              "businessTaxRegistrationCode": "businessTaxRegistrationCode",
              "businessAddress": {
                "address1": "address1",
                "address2": "address2",
                "buildingNumber": "buildingNumber",
                "plantNumber": "plantNumber",
                "floorNumber": "floorNumber",
                "houseNumber": "houseNumber",
                "city": "city",
                "village": "village",
                "township": "township",
                "district": "district",
                "state": "state",
                "postalCode": "postalCode",
                "country": "US",
                "telephone": "telephone",
                "fax": "fax",
                "url": "url",
                "lscAddressIdentifier": "lscAddressIdentifier"
              },
              "regulatoryContact": {
                "regulatoryContactTitle": "regulatoryContactTitle",
                "regulatoryContactName": "regulatoryContactName",
                "regulatoryContactEmail": "regulatoryContactEmail",
                "regulatoryContactPhone": "regulatoryContactPhone"
              },
              "businessLogo": {
                "imageIdentifier": "imageIdentifier",
                "imageMimeType": "imageMimeType",
                "imagefileName": "imagefileName",
                "imagebase64": "imagebase64"
              }
            },
            "regulatoryPartnerLicensesWithBusinessNameDerivedField": "businessNameTest licenseIssuingAgency US licenseStateOrRegion licenseNumber",
            "regulatoryPartnerIdentifiersWithBusinessNameDerivedField": "businessNameTest SGLN 8888882021122",
            "regulatoryPartnerIdentifiersDerivedField": "SGLN 8888882021122"
          },
          "schemaId": "masterdata-manager:partnerMasterData",
          "id": "471b0f7a-4759-4279-bf8e-dc74c70bd8a8",
          "objectType": "masterdata-manager:partnerMasterData",
          "lastUpdatedDateTime": 1616100835395,
          "contextualOwnerId": "00000000-0000-0000-0000-000000000000",
          "lastUpdatedByUserId": "f9f35dd0-035d-11eb-8ec8-0242ac11000c",
          "ownerId": "00000000-0000-0000-0000-000000000000",
          "dataVersion": 1,
          "createdByUserId": "f9f35dd0-035d-11eb-8ec8-0242ac11000c",
          "creationDateTime": 1616100835395
        },
        "primaryKey": "masterdata-manager:partnerMasterData#471b0f7a-4759-4279-bf8e-dc74c70bd8a8"
      }
    ],
    "facets": [
    ]
  }
}

Errors

This app uses standard HTTP response codes. If an error occurs, additional available information regarding the cause of the error is provided in the errMsg element in the relevant response.

Review TraceLink's API: Terms of Use

Get Partner Company Location Master Data

IT system administrators and app developers use this API to retrieve the full master data record for a Partner company's location (e.g. name, address) based on the partner location's regulatory identifier information.

Guidelines

  Attribute Type Description
header –

Required. The request header.
  headerVersion Integer

Required. The version identifier for the request. Valid value is 1.
  eventName String

Required. The fully qualified name of the request event. Valid value is masterdata-manager:get-partnerLocation-by-regulatory-identifier:v1.
  ownerId String

Required. The identifier for the company providing the app.
  dataspace String

Required. The dataspace within the environment where the request is being made. Valid value for the Production and Validation environments is default.
  appName String

Required. The application that owns the event. Valid value is masterdata-manager.
payload –

Required. The request body.
  regulatoryLocationIdentifier String

The value of the regulatory identifier.
  regulatoryLocationIdentifierType String

The type of the regulatory identifier.

Example

{
  "header": {
    "headerVersion": 1,
    "eventName": "masterdata-manager:get-partnerLocation-by-regulatory-identifier:v1",
    "ownerId": "00000000-0000-0000-0000-000000000000",
    "dataspace": "default",
    "appName": "masterdata-manager"
  },
  "payload": {
    "regulatoryCompanyIdentifier": "123456",
    "regulatoryCompanyIdentifierType": "GLN"
  }
}

Guidelines

  Attribute Type Description
header –

Required. The response header.
  headerVersion Integer

Required. The version identifier for the response. Valid value is 1.
  eventName String

Required. The fully qualified name of the response event. Valid value is masterdata-manager:get-partnerLocation-by-regulatory-identifier-response:v1.
  ownerId String

Required. The identifier for the company providing the app.
  isErr String

Required. Indicates whether the request was successful. Valid values:

  • true – The request was successful.
  • false – The request was not successful. The errCode field provides error information for troubleshooting.
  errCode String

Required. The status code of the request. 200_OK indicates that the request was successful.
  errMsg String

Conditionally required if the call is unsuccessful. The message associated with the error code.
  licensePlate String

Required. The unique identifier for the request and response instance.
payload –

Required. The response body.
  pagingInfo String

Required. The query paging information representing where the previous query result ended. The pagingInfo from the previous query may be used as the starting point for a new query.
  documents Array

Required. Contains the results of the query request.
    metadata Object

Required. The metadata about the object.
      schemaId String

Required. The JSON schema that defines the object.
      schemaVersion Integer

Required. The JSON schema version number.
      primaryKey String

Required. The primary key of the object.
      dataVersion Integer

Required. The current version number of the object.
      indexTarget String

Required. The index target identifier of the object.
      dbTxid Integer

Required. The transactional identifier of the object.
    payload –

Required. The master data objects.
      schemaVersion Integer

Required. The JSON schema version number.
      data Object

Required. Contains the attributes for the object. The contents depend on the object schema specified when the event handlers were added.
        dataStatus Boolean

Required. Indicates if the master data for this location is active or inactive.

Valid values:

  • true – The master data for this location is active.
  • false – The master data for this location is inactive.
        parentLegalEntityCode String Required. The legal code of the parent network node.
        isLegalEntity Boolean

Specifies if the company is a legal entity.

Valid values:

  • true – The node is a legal entity.
  • false – The node is not a legal entity.
        legalEntityCode String

The legal entity code of the network node.
        companyNetworkNodeId String

Required. The network node that the record belongs to.
        locationNetworkNodeId String Required. The location node that owns the record.
        regulatoryLocationIdentifiers String

Required. The list of all identifiers of the company.
          regulatoryIdentifierValue String

Required. The identifier value.
          lscRegulatoryIdentifier String Required. The identifier of the regulatory identifier type and value in Track & Trace Services.
          isPrimaryRegulatoryIdentifier String

Required. Specifies if the given identifier is the primary identifier.
          regulatoryCompanyIdentifierTypeId String Required. The identifier of the regulatory identifier type and value combination.
          regulatoryCompanyIdentifierType String

Required. The identifier type.
        regulatoryLocationLicenses Array The partner location's license information.
          lscLicenseIdentifier String The license identifier in Track & Trace Services.
          licenseStateOrRegion String The state or region of the licensing agency.
          licenseIssuingAgency String The agency granting the regulatory license.
          licenseCountry String Required. The country of the licensing agency.
          licenseNumber String Required. The regulatory license number for the specified Partner company location.
        businessMasterDataCommon TypeDef

Required. The common business information.
          businessType String

The list of all business types of the company.

          lscBusinessVersion String

Required. The business version identifier in Track & Trace Services.
          businessName String

Required. The company's name.
          businessEmail String

The company's email address.
          businessPhone String

The company's phone number.
          businessUrl String

The URL of the company's website.
          businessTaxRegistrationCode String

The company's tax registration code.
          businessAddress TypeDef

The company's address information.
            address1 String

Required. The street address, including number and street name.
            address2 String

The second line of the street address. Any additional address information, if available.
            city String Required. The city where this Partner company is located.
            district String

The 3-digit numeric code of the district where the company is located in India.
            village String

The village in which the Partner company location is located in.
            houseNumber String

The building, house, or unit number of the company. House numbers are usually only separated from the street address in China. For all addresses outside of China, continue to enter the building, house, or unit number in address1.
            township String

The name of the town in which the company is located.
            stateOrRegion String

Required. The state, province, or region using the standard two– or three–letter abbreviation specified in the ISO 3166–2:1998 country subdivision code.
            postalCode String

Conditionally required if the country has a ZIP or other postal code. If the country does have a postal code and it is omitted, an error is generated. See Valid values for exclusions.

  • Angola, AO

  • Antigua and Barbuda, AG

  • Aruba, AW

  • Bahamas, BS

  • Belize, BZ

  • Benin, BJ

  • Botswana, BW

  • Burkina Faso, BF

  • Burundi, BI

  • Cameroon, CM

  • Central African Republic, CF

  • Comoros, KM

  • Congo, CG

  • Congo, the Democratic Republic of the, CD

  • Cook Islands, CK

  • Cote d'Ivoire, CI

  • Djibouti, DJ

  • Dominica, DM

  • Equatorial Guinea, GQ

  • Eritrea, ER

  • Fiji, FJ

  • French Southern Territories, TF

  • Gambia, GM

  • Ghana, GH

  • Grenada, GD

  • Guinea, GN

  • Guyana, GY

  • Hong Kong, HK

  • Ireland, IE

  • Jamaica, JM

  • Kenya, KE

  • Kiribati, KI

  • Macao, MO

  • Malawi, MW

  • Mali, ML

  • Mauritania, MR

  • Mauritius, MU

  • Montserrat, MS

  • Nauru, NR

  • Netherlands Antilles, AN

  • Niue, NU

  • North Korea, KP

  • Panama, PA

  • Qatar, QA

  • Rwanda, RW

  • Saint Kitts and Nevis, KN

  • Saint Lucia, LC

  • Sao Tome and Principe, ST

  • Saudi Arabia, SA

  • Seychelles, SC

  • Sierra Leone, SL

  • Solomon Islands, SB

  • Somalia, SO

  • South Africa, ZA

  • Suriname, SR

  • Syria, SY

  • Tanzania, United Republic of, TZ

  • Timor-Leste, TL

  • Tokelau, TK

  • Tonga, TO

  • Trinidad and Tobago, TT

  • Tuvalu, TV

  • Uganda, UG

  • United Arab Emirates, AE

  • Vanuatu, VU

  • Yemen, YE

  • Zimbabwe, ZW
            country String

Required. The country using the standard two–letter abbreviation specified in ISO 3166–1alpha-2:1997 country code.

  • AD – ANDORRA
  • AE – UNITED ARAB EMIRATES
  • AF – AFGHANISTAN
  • AG – ANTIGUA AND BARBUDA
  • AI – ANGUILLA
  • AL – ALBANIA
  • AM – ARMENIA
  • AN – NETHERLANDS ANTILLES
  • AO – ANGOLA
  • AQ – ANTARCTICA
  • AR – ARGENTINA
  • AS – AMERICAN SAMOA
  • AT – AUSTRIA
  • AU – AUSTRALIA
  • AW – ARUBA
  • AX – ÅLAND ISLANDS
  • AZ – AZERBAIJAN
  • BA – BOSNIA AND HERZEGOVINA
  • BB – BARBADOS
  • BD – BANGLADESH
  • BE – BELGIUM
  • BF – BURKINA FASO
  • BG – BULGARIA
  • BH – BAHRAIN
  • BI – BURUNDI
  • BJ – BENIN
  • BL – SAINT BARTHÉLEMY
  • BM – BERMUDA
  • BN – BRUNEI DARUSSALAM
  • BO – BOLIVIA, PLURINATIONAL STATE OF
  • BR – BRAZIL
  • BS – BAHAMAS
  • BT – BHUTAN
  • BV – BOUVET ISLAND
  • BW – BOTSWANA
  • BY – BELARUS
  • BZ – BELIZE
  • CA – CANADA 
  • CC – COCOS (KEELING) ISLANDS
  • CD – CONGO, THE DEMOCRATIC REPUBLIC OF THE
  • CF – CENTRAL AFRICAN REPUBLIC
  • CG – CONGO
  • CH – SWITZERLAND
  • CI – CÔTE D'IVOIRE
  • CK – COOK ISLANDS
  • CL – CHILE
  • CM – CAMEROON
  • CN – CHINA
  • CO – COLOMBIA
  • CR – COSTA RICA
  • CU – CUBA
  • CV – CAPE VERDE
  • CX – CHRISTMAS ISLAND
  • CY – CYPRUS
  • CZ – CZECH REPUBLIC
  • DE – GERMANY
  • DJ – DJIBOUTI
  • DK – DENMARK
  • DM – DOMINICA
  • DO – DOMINICAN REPUBLIC
  • DZ – ALGERIA
  • EC – ECUADOR
  • EE – ESTONIA
  • EG – EGYPT
  • EH – WESTERN SAHARA
  • ER – ERITREA
  • ES – SPAIN
  • ET – ETHIOPIA
  • FI – FINLAND
  • FJ – FIJI
  • FK – FALKLAND ISLANDS (MALVINAS)
  • FM – MICRONESIA, FEDERATED STATES OF
  • FO – FAROE ISLANDS
  • FR – FRANCE
  • GA – GABON
  • GB – UNITED KINGDOM
  • GD – GRENADA
  • GE – GEORGIA
  • GF – FRENCH GUIANA
  • GG – GUERNSEY
  • GH – GHANA
  • GI – GIBRALTAR
  • GL – GREENLAND
  • GM – GAMBIA
  • GN – GUINEA
  • GP – GUADELOUPE
  • GQ – EQUATORIAL GUINEA
  • GR – GREECE
  • GS – SOUTH GEORGIA AND THE SOUTH SANDWICH ISLANDS
  • GT – GUATEMALA
  • GU – GUAM
  • GW – GUINEA–BISSAU
  • GY – GUYANA
  • HK - HONG KONG
  • HM – HEARD ISLAND AND MCDONALD ISLANDS
  • HN – HONDURAS
  • HR – CROATIA
  • HT – HAITI
  • HU – HUNGARY
  • ID – INDONESIA
  • IE – IRELAND
  • IL – ISRAEL
  • IM – ISLE OF MAN
  • IN – INDIA
  • IO – BRITISH INDIAN OCEAN TERRITORY
  • IQ – IRAQ
  • IR – IRAN, ISLAMIC REPUBLIC OF
  • IS – ICELAND
  • IT – ITALY
  • JE – JERSEY
  • JM – JAMAICA
  • JO – JORDAN
  • JP – JAPAN
  • KE – KENYA
  • KG – KYRGYZSTAN
  • KH – CAMBODIA
  • KI – KIRIBATI
  • KM – COMOROS
  • KN – SAINT KITTS AND NEVIS
  • KP – KOREA, DEMOCRATIC PEOPLE'S REPUBLIC OF
  • KR – KOREA, REPUBLIC OF
  • KW – KUWAIT
  • KY – CAYMAN ISLANDS
  • KZ – KAZAKHSTAN
  • LA – LAO PEOPLE'S DEMOCRATIC REPUBLIC
  • LB – LEBANON
  • LC – SAINT LUCIA
  • LI – LIECHTENSTEIN
  • LK – SRI LANKA
  • LR – LIBERIA
  • LS – LESOTHO
  • LT – LITHUANIA
  • LU – LUXEMBOURG
  • LV – LATVIA
  • LY – LIBYAN ARAB JAMAHIRIYA
  • MA – MOROCCO
  • MC – MONACO
  • MD – MOLDOVA, REPUBLIC OF
  • ME – MONTENEGRO
  • MF – SAINT MARTIN
  • MG – MADAGASCAR
  • MH – MARSHALL ISLANDS
  • MK – MACEDONIA, THE FORMER YUGOSLAV REPUBLIC OF
  • ML – MALI
  • MM – MYANMAR
  • MN – MONGOLIA
  • MO – MACAO
  • MP – NORTHERN MARIANA ISLANDS
  • MQ – MARTINIQUE
  • MR – MAURITANIA
  • MS – MONTSERRAT
  • MT – MALTA
  • MU – MAURITIUS
  • MV – MALDIVES
  • MW – MALAWI 
  • MX – MEXICO
  • MY – MALAYSIA
  • MZ – MOZAMBIQUE
  • NA – NAMIBIA
  • NC – NEW CALEDONIA
  • NE – NIGER
  • NF – NORFOLK ISLAND
  • NG – NIGERIA
  • NI – NICARAGUA
  • NL – NETHERLANDS
  • NO – NORWAY
  • NP – NEPAL
  • NR – NAURU
  • NU – NIUE
  • NZ – NEW ZEALAND
  • OM – OMAN
  • PA – PANAMA
  • PE – PERU
  • PF – FRENCH POLYNESIA
  • PG – PAPUA NEW GUINEA
  • PH – PHILIPPINES
  • PK – PAKISTAN
  • PL – POLAND
  • PM – SAINT PIERRE AND MIQUELON
  • PN – PITCAIRN
  • PR – PUERTO RICO
  • PS – PALESTINIAN TERRITORY, OCCUPIED
  • PT – PORTUGAL
  • PW – PALAU
  • PY – PARAGUAY
  • QA – QATAR
  • RE – RÉUNION
  • RO – ROMANIA
  • RS – SERBIA
  • RU – RUSSIAN FEDERATION
  • RW – RWANDA
  • SA – SAUDI ARABIA
  • SB – SOLOMON ISLANDS
  • SC – SEYCHELLES
  • SD – SUDAN
  • SE – SWEDEN
  • SG – SINGAPORE
  • SH – SAINT HELENA, ASCENSION AND TRISTAN DA CUNHA
  • SI – SLOVENIA
  • SJ – SVALBARD AND JAN MAYEN
  • SK – SLOVAKIA
  • SL – SIERRA LEONE
  • SM – SAN MARINO
  • SN – SENEGAL
  • SO – SOMALIA
  • SR – SURINAME
  • ST – SAO TOME AND PRINCIPE
  • SV – EL SALVADOR
  • SY – SYRIAN ARAB REPUBLIC
  • SZ – SWAZILAND
  • TC – TURKS AND CAICOS ISLANDS
  • TD – CHAD
  • TF – FRENCH SOUTHERN TERRITORIES
  • TG – TOGO
  • TH – THAILAND
  • TJ – TAJIKISTAN
  • TK – TOKELAU
  • TL – TIMOR–LESTE
  • TM – TURKMENISTAN
  • TN – TUNISIA
  • TO – TONGA
  • TR – TURKEY
  • TT – TRINIDAD AND TOBAGO
  • TV – TUVALU
  • TW – TAIWAN
  • TZ – TANZANIA, UNITED REPUBLIC OF
  • UA – UKRAINE
  • UG – UGANDA
  • UM – UNITED STATES MINOR OUTLYING ISLANDS
  • US – UNITED STATES
  • UY – URUGUAY
  • UZ – UZBEKISTAN
  • VA – HOLY SEE (VATICAN CITY STATE)
  • VC – SAINT VINCENT AND THE GRENADINES
  • VE – VENEZUELA, BOLIVARIAN REPUBLIC OF
  • VG – VIRGIN ISLANDS, BRITISH
  • VI – VIRGIN ISLANDS, U.S.
  • VN – VIET NAM
  • VU – VANUATU
  • WF – WALLIS AND FUTUNA
  • WS – SAMOA
  • XK – KOSOVO
  • YE – YEMEN
  • YT – MAYOTTE
  • ZA – SOUTH AFRICA
  • ZM – ZAMBIA
  • ZW – ZIMBABWE
            url String The URL of the Partner company's website.
            buildingNumber String

The Partner company's building number.
            plantNumber String

The facility's plant number.
            floorNumber String

The facility's floor number.
            premisesCode String

The identifier representing a physical area within the company location (e.g. a location's second floor).
            fax String

The office's fax number.
            telephone String

The office's telephone number.
            lscAddressidentifier String

The global identifier assigned by Russian Federation Information Address System (FIAS). Maximum 36 characters, using the digits 0-9 and letters A-F.
          regulatoryContact Object

The contact information for the regulatory contact at the company.
            regulatoryContactTitle String

The regulatory contact's business title.
            regulatoryContactName String

The regulatory contact's name.
            regulatoryContactEmail String

The regulatory contact's email address.
            regulatoryContactPhone Integer

The regulatory contact's phone number.
        regulatoryPartnerLocationIdentifiersDerivedField String

The result of the query when ftsInfo | value equals index-regulatoryPartnerLocationIdentifiersDerivedField:[searchString] in the request.
        regulatoryPartnerLocationIdentifiersWithBusinessNameDerivedField String

The result of the query when ftsInfo | value equals index-regulatoryPartnerLocationIdentifiersWithBusinessNameDerivedField:[searchString] in the request.
        index-regulatoryPartnerLocationLicensesWithBusinessNameDerivedField String

The result of the query when ftsInfo | value equals index-regulatoryPartnerLocationLicensesWithBusinessNameDerivedField in the request.
      schemaId String

Required. The JSON schema that defines the object.
      id String Required. The identifier of the master data object.
      objectType String Required. The type of the object. Valid value is masterdata-manager:productMasterData.
      lastUpdatedDateTime String

The identifier of the user that made the last update to the master data record.

      contextualOwnerId String Required. The identifier of the Partner company sending the master data request.
      lastUpdatedByUserId DateTime

The identifier of the user that made the last update to the master data record.
      ownerId String

Required. The identifier of the Partner company that owns the master data record.
      dataVersion Integer

Required. The current version number of the object.
      createdByUserId String

Required. The ID of the user that created the master data record.
      creationDateTime DateTime

Required. The date and time when the master data record was created.
  primaryKey String Required. The primary key of the object.
facets String

Required. Enables searches through a particular dataset.

Example

{
  "header": {
    "headerVersion": 1,
    "eventName": "masterdata-manager:get-partnerLocation-by-regulatory-identifier-response-response:v1",
    "ownerId": "00000000-0000-0000-0000-000000000000",
    "isErr": false,
    "errCode": "200_OK",
    "licensePlate": "W1thmm"
  },
  "payload": {
    "pagingInfo": null,
    "documents": [
      {
        "metadata": {
          "schemaId": "masterdata-manager:partnerLocationMasterData",
          "schemaVersion": 1,
          "primaryKey": "masterdata-manager:partnerLocationMasterData#0d1d7aa7-32c5-47f0-84b8-fdfa9219e67b",
          "dataVersion": 1,
          "indexTarget": "0d1d7aa7-32c5-47f0-84b8-fdfa9219e67b",
          "dbTxId": 53948
        },
        "payload": {
          "schemaVersion": 1,
          "data": {
            "companyNetworkNodeId": "companyNetworkNodeId",
            "regulatoryCompanyIdentifiers": [
              {
                "regulatoryCompanyIdentifierTypeId": "SGLN",
                "isPrimaryRegulatoryIdentifier": false,
                "regulatoryIdentifierValue": "OneOne1"
              },
              {
                "regulatoryCompanyIdentifierTypeId": "GLN",
                "isPrimaryRegulatoryIdentifier": false,
                "regulatoryIdentifierValue": "123456"
              }
            ],
            "businessMasterDataCommon": {
              "businessType": [
                "MANUFACTURER"
              ],
              "lscBusinessVersion": "lscBusinessVersion",
              "businessName": "Time Magazin",
              "businessEmail": "businessEmail",
              "businessPhone": "businessPhone",
              "businessUrl": "businessUrl",
              "businessTaxRegistrationCode": "businessTaxRegistrationCode",
              "businessAddress": {
                "address1": "address1",
                "address2": "address2",
                "buildingNumber": "buildingNumber",
                "plantNumber": "plantNumber",
                "floorNumber": "floorNumber",
                "houseNumber": "houseNumber",
                "city": "city",
                "village": "village",
                "township": "township",
                "district": "district",
                "state": "state",
                "postalCode": "postalCode",
                "country": "US",
                "telephone": "telephone",
                "fax": "fax",
                "url": "url",
                "lscAddressIdentifier": "lscAddressIdentifier"
              },
              "regulatoryContact": {
                "regulatoryContactTitle": "regulatoryContactTitle",
                "regulatoryContactName": "regulatoryContactName",
                "regulatoryContactEmail": "regulatoryContactEmail",
                "regulatoryContactPhone": "regulatoryContactPhone"
              },
            },
            "regulatoryPartnerIdentifiersDerivedField": "SGLN OneOne1,GLN 123456",
            "regulatoryPartnerLocationIdentifiersWithBusinessNameDerivedField": "Time Magazin SGLN OneOne1,Time Magazin GLN 123456"
          },
          "schemaId": "masterdata-manager:partnerLocationMasterData",
          "id": "0d1d7aa7-32c5-47f0-84b8-fdfa9219e67b",
          "lastUpdatedDateTime": 1614028698435,
          "contextualOwnerId": "00000000-0000-0000-0000-000000000000",
          "lastUpdatedByUserId": "f9f35dd0-035d-11eb-8ec8-0242ac11000c",
          "ownerId": "00000000-0000-0000-0000-000000000000",
          "dataVersion": 1,
          "createdByUserId": "f9f35dd0-035d-11eb-8ec8-0242ac11000c",
          "creationDateTime": 1614028698435
        },
        "primaryKey": "masterdata-manager:partnerLocationMasterData#0d1d7aa7-32c5-47f0-84b8-fdfa9219e67b"
      }
    ],
    "facets": [
    ]
  }
}

Errors

This app uses standard HTTP response codes. If an error occurs, additional available information regarding the cause of the error is provided in the errMsg element in the relevant response.

Review TraceLink's API: Terms of Use

Add or Edit Partner Company Location Master Data

IT system administrators use this API to add the full master data record for a Partner company's location (e.g. name, address). IT system administrators should retrieve the existing partner company location master data record, edit the values that need to change, and then submit the entire record. These APIs overwrite the full set of data previously added to the associated record.

Guidelines

Element Type Description
header – Required. The request header.
  headerVersion Integer Required. The version identifier for the request. Valid value is 1.
  eventName String Required. The fully qualified name of the request event. Valid value is masterdata-manager:add-partnerLocation:v4.
  ownerId String Required. The identifier for the Owner company associated with the request.
  appName String Required. The application that owns the event. Valid value is masterdata-manager.
  dataspace String Required. The dataspace within the environment where the request is being made. Valid value for the Production and Validation environments is default.
payload – Required. The request body.
data Object Required. Contains the attributes for the object. The contents depend on the object schema specified when the event handlers were added.
  dataStatus String

Required. Indicates if the Partner company's location data is active within TraceLink.

Valid values:

  • DRAFT – The data is in a draft state but not submitted.
  • ACTIVE – The data can be used in messages and UI functions, and TraceLink pulls the data when necessary.
  • INACTIVE – The data cannot be pulled for other functions within TraceLink.
  regulatoryLocationIdentifiers Array Required. The identifiers for a location.
    regulatoryIdentifierValue String Required. The location identifier.
    isPrimaryRegulatoryIdentifier Boolean

Required. Indicates whether the given Partner identifier is the primary identifier. Only one identifier can be set as the primary identifier.

TraceLink uses the primary company identifier to identify the correct partner when the user updates the Master Data with an asynchronous message.

Valid values:

  • true – The identifier is the primary identifier.
  • false – (default) The identifier is not the primary identifier.
    regulatoryLocationIdentifierType String

Required. Specifies the Partner company's location identifier type.

  • AR_CUIT – 11-character Argentina Tax ID. Format is 00-00000000-0 (e.g. 33-56899856-8). Cannot be set as the Primary Identifier.
  • AM_TIN – 8-character Armenia Taxpayer Identification Number (e.g. 53663456). Cannot be set as the Primary Identifier.
  • BR_CNES – Brazil National Registry of Health Facilities Number (e.g. 3868249).
  • BR_CNPJ – 14-character Brazil Tax/Legal Entity ID. Format is 00.000.000/0001-00 (e.g. 71.116.165/0001-71).
  • BR_CPF – 11-character Brazil Individual Taxpayer Registration Number. Format is 000.000.000-00 (e.g. 605.085.153-00). The first 8 digits identify the company, the next 4 digits identify the branch or subsidiary ("0001" designates the headquarters), and the last 2 are check digits.
  • BR_PROF_REG – Brazil Professional Registration Number (e.g. CRODFCD9952).
  • BY_TIN – 9-character Belarus Taxpayer Identification Number (e.g. 004893223). Cannot be set as the Primary Identifier.
  • CN_CHINA_ID – Alphanumeric China identifier (e.g. 352J685B548N).
  • CN_FOREIGN_MAH – China Foreign MAH ID (e.g. 0678645).
  • CN_FOREIGN_MFR – China Foreign Manufacturer ID (e.g. 665S55D).
  • CN_USCID – China Unified Social Credit Identifier (e.g. 9771221453).
  • COMPANYID – Alphanumeric internal company identifier (e.g. KENDALL).
  • COMPANYSITEID – Alphanumeric internal location, plant, or site identifier (e.g. 465MEMPHIS).
  • DE_IFA_REG_NUM – 6-character Informationsstelle für Arzneispezialitäten (IFA) Registration Number (e.g. 548726). Cannot be set as the Primary Identifier.
  • DEA – 9-character US Drug Enforcement Agency Number (e.g. F92547851).
  • DUNS – 9-character Dunn and Bradstreet Number (e.g. 82-759-6961).
  • DUNS4 – 13-character Dunn and Bradstreet Number, which includes a 4 digit extension (e.g. 82-759-6961-KP89).
  • GCP – 6- to 12-character GS1 Global Company Prefix (e.g. 8856277).
  • GLN – 13-character Global Location Number (e.g. 8856277233311). To send and receive EPCIS messages, companies and locations need a GLN.
  • HIN – Maximum 9-alphanumeric character Health Industry Number assigned by HIBCC (e.g. 214Z65H00).
  • ID_BPOM_FACILITYID – Indonesia Facility ID (e.g. 45764574).
  • IN_COMPANY_ID – India Company ID (e.g. 5423695784236).
  • IN_GSTN – India Goods and Services Tax ID (e.g. 55876215).
  • IN_IEC – 10-character India Importer Exporter Code (e.g. 0255411222). Cannot be set as the Primary Identifier.
  • IN_LOCATION_ID – India Location ID (e.g. 65874532).
  • IN_MFR – India Manufacturing Code (e.g. 00552101).
  • IN_MRCH – India Merchant Exporter Code (e.g. 601227644).
  • IN_PAN – 10-character India Permanent Account Number. The first five characters are letters, next four numbers, last character is a letter (e.g. AFZPK7190K). Cannot be set as the Primary Identifier.
  • IN_TIN – 11-character India Taxpayer Identification Number (e.g. 95684444523). Cannot be set as the Primary Identifier.
  • KG_TIN – 14-character Kyrgyzstan Taxpayer Identification Number (e.g. 56200044505998). Cannot be set as the Primary Identifier.
  • KR_BUS_REG_NUMBER – 10-character South Korea Corporate Registration Number. Format is xxx-xx-xxxxx (e.g. 324-84-22451).
  • KR_PROVIDER_CODE – 8-character South Korea Provider Code (e.g. 45632196).
  • KZ_BIN – 12-character Kazakhstan Business Identification Number (e.g. 220110668755). Cannot be set as the Primary Identifier.
  • RU_ACCOUNT_NUMBER – 14- to 36-character Russia Account Number (e.g. 19527400000001 or 19406412-0001-000a-0000-000000000022). Cannot be set as the Primary Identifier.
  • RU_INN_FOREIGN_ENTITY – 10-character Russia Foreign Business Taxpayer Identification Number (e.g. 7744000912). Cannot be set as the Primary Identifier. Only one of the following identifier types can be assigned to an entity: RU - INN Local, RU - IN Foreign, and RU - INN Individual.
  • RU_INN_INDIV – 12-character Russia Individual Taxpayer Identification Number (e.g. 123456789001). Cannot be set as the Primary Identifier. Only one of the following identifier types can be assigned to an entity: RU - INN Local, RU - IN Foreign, and RU - INN Individual.
  • RU_INN_KPP_TAX_CODE – 9-character Russia KPP Registration Code (e.g. 771301001). Cannot be set as the Primary Identifier.
  • RU_INN_LOCAL_ENTITY – 10-character Russia Local Business Taxpayer Identification Number (e.g. 7728640746). Cannot be set as the Primary Identifier. Only one of the following identifier types can be assigned to an entity: RU - INN Local, RU - IN Foreign, and RU - INN Individual.
  • SGLN – 15-character SGLN format representation of Global Location Number:
    • Format for company entities is [CompanyPrefix].[LocationRef].0 or [CompanyPrefix]..0. The LocationRef segment is optional. If the LocationRef is included, the first two segments contain only digits separated by the dot, and must be 13 characters in total. If the LocationRef is not included, then the first segment must be 12 digits, followed by two dot seperators. The third segment should always be the digit 0. For example, 539885451928..0 or urn:epc:id:sgln:0614141.12345.0.
    • Format for location entities is [CompanyPrefix].[LocationRef].[sub-location identifier] or [CompanyPrefix]..[sub-location identifier].The LocationRef segment is optional. If the LocationRef is included, the first two segments contain only digits separated by the dot, and must be 13 characters in total. If the LocationRef is not included, then the first segment must be 12 digits, followed by two dot seperators. The third segment is always alphanumeric and can be any length, with at least one character in it preceded by the dot separator. For example, 8856277.23331.6 or 539885451928..11.
  • TRACELINK_ID – TraceLink Identification Number (e.g. KENDALLPHARM).
  • UZ_TIN – 9-character Uzbekistan Taxpayer Identification Number (e.g. 000181244). Cannot be set as the Primary Identifier.
  regulatoryLocationLicenses Array Required. The identifiers for a Partner company's location.
    licenseStateOrRegion String

The state or region of the licensing agency.
    licenseIssuingAgency String

The agency that grants the regulatory license.

    licenseCountry String

Required. The country of the licensing agency.
    licenseNumber String

Required. The regulator license number for the location.
  businessMasterDataCommon Array Required. The Partner's headquarters information.
    businessType Array (String)

Required. The different types of business the Partner conducts.

Valid values:

  • CARRYING_AND_FORWARDING_AGENT – The company facilitates the movement and transfer of goods. In India, CFAs are often involved in moving goods as interstate stock transfers.
  • CHEMIST – The company specializes in the composition of substances, may mix substances in preparation for dispensation, and has a shop selling medicines and cosmetics. Also known as a compounding facility.
  • DISTRIBUTOR – The company distributes pharmaceuticals.
  • EXPORTER – The company exports products. For customs purposes, this company makes the export declaration and sells the products to a company in another country, known as the importer.
  • HEALTHCARE_FACILITY – The company dispenses pharmaceuticals as a healthcare facility.
  • IMPORTER – The company imports products. For customs purposes, this company makes the import declaration, the shipping document names the company as consignee, and the exporter's invoice names the company as buyer.
  • LOGISTICS – The company provides logistics services (e.g. LSP, 3PL).
  • MANUFACTURER – The license holder of the pharmaceutical product (e.g. Brand Owners, Generics, MAHs, Specialty Companies).
  • PACKAGER – The company packages products.
  • PHARMACY – The company sells product directly to patients.
  • RETURNS_PROCESSOR – The company processes returns.
  • STOCKIST – The company stocks the products and then distributes them.
  • WHOLESALER – The company is a wholesaler of pharmaceuticals.
    businessName String Required. The Partner company location name.
    businessEmail String The Partner company location's email address.
    businessPhone String

The telephone number of the Partner location's corporate office.
    businessUrl String

The URL of the Partner company location's website.
    businessTaxRegistrationCode String

The Partner company location's tax registration code. The code used to identify this entity for tax or other legal reporting purposes.
    businessAddress String

The Partner company location's information.
      address1 String

Required. The street address, including number and street name.
      address2 String

The second line of the street address. Any additional address information, if available.
      city String

Required. The city that the Partner company location is located in.
      district String

The 3-digit numeric code of the district where the Partner company location is located in India.
      village String

The village in which the Partner company location is located in.
      houseNumber String The unique number on the street for this Partner company location.
      township String

The name of the town in which the Partner company is located.
      stateOrRegion String

Required. The state, province, or region using the standard two– or three–letter abbreviation specified in the ISO 3166–2:1998 country subdivision code.
      postalCode String

Conditionally required if the country has a ZIP or other postal code. If the country does have a postal code and it is omitted, an error is generated. See Valid values for exclusions.

  • Angola, AO

  • Antigua and Barbuda, AG

  • Aruba, AW

  • Bahamas, BS

  • Belize, BZ

  • Benin, BJ

  • Botswana, BW

  • Burkina Faso, BF

  • Burundi, BI

  • Cameroon, CM

  • Central African Republic, CF

  • Comoros, KM

  • Congo, CG

  • Congo, the Democratic Republic of the, CD

  • Cook Islands, CK

  • Cote d'Ivoire, CI

  • Djibouti, DJ

  • Dominica, DM

  • Equatorial Guinea, GQ

  • Eritrea, ER

  • Fiji, FJ

  • French Southern Territories, TF

  • Gambia, GM

  • Ghana, GH

  • Grenada, GD

  • Guinea, GN

  • Guyana, GY

  • Hong Kong, HK

  • Ireland, IE

  • Jamaica, JM

  • Kenya, KE

  • Kiribati, KI

  • Macao, MO

  • Malawi, MW

  • Mali, ML

  • Mauritania, MR

  • Mauritius, MU

  • Montserrat, MS

  • Nauru, NR

  • Netherlands Antilles, AN

  • Niue, NU

  • North Korea, KP

  • Panama, PA

  • Qatar, QA

  • Rwanda, RW

  • Saint Kitts and Nevis, KN

  • Saint Lucia, LC

  • Sao Tome and Principe, ST

  • Saudi Arabia, SA

  • Seychelles, SC

  • Sierra Leone, SL

  • Solomon Islands, SB

  • Somalia, SO

  • South Africa, ZA

  • Suriname, SR

  • Syria, SY

  • Tanzania, United Republic of, TZ

  • Timor-Leste, TL

  • Tokelau, TK

  • Tonga, TO

  • Trinidad and Tobago, TT

  • Tuvalu, TV

  • Uganda, UG

  • United Arab Emirates, AE

  • Vanuatu, VU

  • Yemen, YE

  • Zimbabwe, ZW
      country String

Required. The country using the standard two–letter abbreviation specified in ISO 3166–1alpha-2:1997 country code.

  • AD – ANDORRA
  • AE – UNITED ARAB EMIRATES
  • AF – AFGHANISTAN
  • AG – ANTIGUA AND BARBUDA
  • AI – ANGUILLA
  • AL – ALBANIA
  • AM – ARMENIA
  • AN – NETHERLANDS ANTILLES
  • AO – ANGOLA
  • AQ – ANTARCTICA
  • AR – ARGENTINA
  • AS – AMERICAN SAMOA
  • AT – AUSTRIA
  • AU – AUSTRALIA
  • AW – ARUBA
  • AX – ÅLAND ISLANDS
  • AZ – AZERBAIJAN
  • BA – BOSNIA AND HERZEGOVINA
  • BB – BARBADOS
  • BD – BANGLADESH
  • BE – BELGIUM
  • BF – BURKINA FASO
  • BG – BULGARIA
  • BH – BAHRAIN
  • BI – BURUNDI
  • BJ – BENIN
  • BL – SAINT BARTHÉLEMY
  • BM – BERMUDA
  • BN – BRUNEI DARUSSALAM
  • BO – BOLIVIA, PLURINATIONAL STATE OF
  • BR – BRAZIL
  • BS – BAHAMAS
  • BT – BHUTAN
  • BV – BOUVET ISLAND
  • BW – BOTSWANA
  • BY – BELARUS
  • BZ – BELIZE
  • CA – CANADA 
  • CC – COCOS (KEELING) ISLANDS
  • CD – CONGO, THE DEMOCRATIC REPUBLIC OF THE
  • CF – CENTRAL AFRICAN REPUBLIC
  • CG – CONGO
  • CH – SWITZERLAND
  • CI – CÔTE D'IVOIRE
  • CK – COOK ISLANDS
  • CL – CHILE
  • CM – CAMEROON
  • CN – CHINA
  • CO – COLOMBIA
  • CR – COSTA RICA
  • CU – CUBA
  • CV – CAPE VERDE
  • CX – CHRISTMAS ISLAND
  • CY – CYPRUS
  • CZ – CZECH REPUBLIC
  • DE – GERMANY
  • DJ – DJIBOUTI
  • DK – DENMARK
  • DM – DOMINICA
  • DO – DOMINICAN REPUBLIC
  • DZ – ALGERIA
  • EC – ECUADOR
  • EE – ESTONIA
  • EG – EGYPT
  • EH – WESTERN SAHARA
  • ER – ERITREA
  • ES – SPAIN
  • ET – ETHIOPIA
  • FI – FINLAND
  • FJ – FIJI
  • FK – FALKLAND ISLANDS (MALVINAS)
  • FM – MICRONESIA, FEDERATED STATES OF
  • FO – FAROE ISLANDS
  • FR – FRANCE
  • GA – GABON
  • GB – UNITED KINGDOM
  • GD – GRENADA
  • GE – GEORGIA
  • GF – FRENCH GUIANA
  • GG – GUERNSEY
  • GH – GHANA
  • GI – GIBRALTAR
  • GL – GREENLAND
  • GM – GAMBIA
  • GN – GUINEA
  • GP – GUADELOUPE
  • GQ – EQUATORIAL GUINEA
  • GR – GREECE
  • GS – SOUTH GEORGIA AND THE SOUTH SANDWICH ISLANDS
  • GT – GUATEMALA
  • GU – GUAM
  • GW – GUINEA–BISSAU
  • GY – GUYANA
  • HK - HONG KONG
  • HM – HEARD ISLAND AND MCDONALD ISLANDS
  • HN – HONDURAS
  • HR – CROATIA
  • HT – HAITI
  • HU – HUNGARY
  • ID – INDONESIA
  • IE – IRELAND
  • IL – ISRAEL
  • IM – ISLE OF MAN
  • IN – INDIA
  • IO – BRITISH INDIAN OCEAN TERRITORY
  • IQ – IRAQ
  • IR – IRAN, ISLAMIC REPUBLIC OF
  • IS – ICELAND
  • IT – ITALY
  • JE – JERSEY
  • JM – JAMAICA
  • JO – JORDAN
  • JP – JAPAN
  • KE – KENYA
  • KG – KYRGYZSTAN
  • KH – CAMBODIA
  • KI – KIRIBATI
  • KM – COMOROS
  • KN – SAINT KITTS AND NEVIS
  • KP – KOREA, DEMOCRATIC PEOPLE'S REPUBLIC OF
  • KR – KOREA, REPUBLIC OF
  • KW – KUWAIT
  • KY – CAYMAN ISLANDS
  • KZ – KAZAKHSTAN
  • LA – LAO PEOPLE'S DEMOCRATIC REPUBLIC
  • LB – LEBANON
  • LC – SAINT LUCIA
  • LI – LIECHTENSTEIN
  • LK – SRI LANKA
  • LR – LIBERIA
  • LS – LESOTHO
  • LT – LITHUANIA
  • LU – LUXEMBOURG
  • LV – LATVIA
  • LY – LIBYAN ARAB JAMAHIRIYA
  • MA – MOROCCO
  • MC – MONACO
  • MD – MOLDOVA, REPUBLIC OF
  • ME – MONTENEGRO
  • MF – SAINT MARTIN
  • MG – MADAGASCAR
  • MH – MARSHALL ISLANDS
  • MK – MACEDONIA, THE FORMER YUGOSLAV REPUBLIC OF
  • ML – MALI
  • MM – MYANMAR
  • MN – MONGOLIA
  • MO – MACAO
  • MP – NORTHERN MARIANA ISLANDS
  • MQ – MARTINIQUE
  • MR – MAURITANIA
  • MS – MONTSERRAT
  • MT – MALTA
  • MU – MAURITIUS
  • MV – MALDIVES
  • MW – MALAWI 
  • MX – MEXICO
  • MY – MALAYSIA
  • MZ – MOZAMBIQUE
  • NA – NAMIBIA
  • NC – NEW CALEDONIA
  • NE – NIGER
  • NF – NORFOLK ISLAND
  • NG – NIGERIA
  • NI – NICARAGUA
  • NL – NETHERLANDS
  • NO – NORWAY
  • NP – NEPAL
  • NR – NAURU
  • NU – NIUE
  • NZ – NEW ZEALAND
  • OM – OMAN
  • PA – PANAMA
  • PE – PERU
  • PF – FRENCH POLYNESIA
  • PG – PAPUA NEW GUINEA
  • PH – PHILIPPINES
  • PK – PAKISTAN
  • PL – POLAND
  • PM – SAINT PIERRE AND MIQUELON
  • PN – PITCAIRN
  • PR – PUERTO RICO
  • PS – PALESTINIAN TERRITORY, OCCUPIED
  • PT – PORTUGAL
  • PW – PALAU
  • PY – PARAGUAY
  • QA – QATAR
  • RE – RÉUNION
  • RO – ROMANIA
  • RS – SERBIA
  • RU – RUSSIAN FEDERATION
  • RW – RWANDA
  • SA – SAUDI ARABIA
  • SB – SOLOMON ISLANDS
  • SC – SEYCHELLES
  • SD – SUDAN
  • SE – SWEDEN
  • SG – SINGAPORE
  • SH – SAINT HELENA, ASCENSION AND TRISTAN DA CUNHA
  • SI – SLOVENIA
  • SJ – SVALBARD AND JAN MAYEN
  • SK – SLOVAKIA
  • SL – SIERRA LEONE
  • SM – SAN MARINO
  • SN – SENEGAL
  • SO – SOMALIA
  • SR – SURINAME
  • ST – SAO TOME AND PRINCIPE
  • SV – EL SALVADOR
  • SY – SYRIAN ARAB REPUBLIC
  • SZ – SWAZILAND
  • TC – TURKS AND CAICOS ISLANDS
  • TD – CHAD
  • TF – FRENCH SOUTHERN TERRITORIES
  • TG – TOGO
  • TH – THAILAND
  • TJ – TAJIKISTAN
  • TK – TOKELAU
  • TL – TIMOR–LESTE
  • TM – TURKMENISTAN
  • TN – TUNISIA
  • TO – TONGA
  • TR – TURKEY
  • TT – TRINIDAD AND TOBAGO
  • TV – TUVALU
  • TW – TAIWAN
  • TZ – TANZANIA, UNITED REPUBLIC OF
  • UA – UKRAINE
  • UG – UGANDA
  • UM – UNITED STATES MINOR OUTLYING ISLANDS
  • US – UNITED STATES
  • UY – URUGUAY
  • UZ – UZBEKISTAN
  • VA – HOLY SEE (VATICAN CITY STATE)
  • VC – SAINT VINCENT AND THE GRENADINES
  • VE – VENEZUELA, BOLIVARIAN REPUBLIC OF
  • VG – VIRGIN ISLANDS, BRITISH
  • VI – VIRGIN ISLANDS, U.S.
  • VN – VIET NAM
  • VU – VANUATU
  • WF – WALLIS AND FUTUNA
  • WS – SAMOA
  • XK – KOSOVO
  • YE – YEMEN
  • YT – MAYOTTE
  • ZA – SOUTH AFRICA
  • ZM – ZAMBIA
  • ZW – ZIMBABWE
      url String The URL of the Partner company location's website.
      buildingNumber String The Partner company location's building number.
      plantNumber String

The Partner company location's plant number.
      floorNumber String The Partner company location's floor number.
      premisesCode String

The internal identifier associated with this location (e.g. a location with 4 locations in the city of Mumbai internally refers to the 4th location as MUM4).
      fax String The Partner company location's fax number.
      telephone String

The phone number of the contact person or department at the Partner company location.
    regulatoryContact Array

The contact information for the regulatory contact at the Partner company's location. Each field can only appear once per Partner company location.
      regulatoryContactName String

The regulatory contact's name in base64 format.
      regulatoryContactTitle String

The regulatory contact's business title.
      regulatoryContactEmail String

The regulatory contact's email address.
      regulatoryContactPhone String

The regulatory contact's phone number.

Example

{
    "header": {
        "headerVersion": 1,
        "eventName": "masterdata-manager:add-partnerLocation:v4",
        "ownerId": "bb40845c-8912-4b98-9c9a-f08bd5a9bd07",
        "dataspace": "default",
        "appName": "masterdata-manager"
    },
    "payload": {
        "data": {
            "dataStatus": "ACTIVE",
            "regulatoryLocationIdentifiers": [
            {
                "regulatoryIdentifierValue": "8688884021124",
                "lscRegulatoryIdentifier": "lscRegulatoryIdentifier",
                "isPrimaryRegulatoryIdentifier": true,
                "regulatoryLocationIdentifierType": "GLN"
            }
            ],
            "regulatoryLocationLicenses": [
            {
                "licenseStateOrRegion": "MA",
                "licenseIssuingAgency": "licenseIssuingAgency",
                "licenseCountry": "US",
                "licenseNumber": "100001"
            }
            ],
            "businessMasterDataCommon": {
                "businessType": ["MANUFACTURER"],
                "businessName": "businessName",
                "businessEmail": "email.com",
                "businessPhone": "businessPhone",
                "businessUrl": "businessUrl",
                "businessTaxRegistrationCode": "businessTaxRegistrationCode",
                "businessAddress": {
                    "address1": "address1",
                    "address2": "address2",
                    "buildingNumber": "buildingNumber",
                    "plantNumber": "plantNumber",
                    "floorNumber": "floorNumber",
                    "houseNumber": "houseNumber",
                    "city": "city",
                    "district": "district",
                    "state": "state",
                    "postalCode": "postalCode",
                    "country": "US",
                    "telephone": "telephone",
                    "fax": "fax",
                    "url": "url",
                },
                "regulatoryContact": {
                    "regulatoryContactTitle": "regulatoryContactTitle",
                    "regulatoryContactName": "regulatoryContactName",
                    "regulatoryContactEmail": "email.com",
                    "regulatoryContactPhone": "regulatoryContactPhone"
                },
                "businessLogo": {
                    "imageIdentifier": "imageIdentifier",
                    "imageMimeType": "image/png",
                    "imagefileName": "imagefileName",
                    "imagebase64": "imagebase64"
                }
            }
        }
    }
}

Guidelines

Element Type Description
header – Required. The response header.
  headerVersion Integer Required. The version identifier for the response. Valid value is 1.
  eventName String Required. The fully qualified name of the response event. Valid value is masterdata-manager:add-partnerLocation-response:v4.
  ownerId String Required. The identifier for the Owner company associated with the request.
  isErr Boolean

Required. Indicates whether the request was successful. Valid values:

  • true – The request was successful.
  • false – The request was not successful. The errCode field provides error information for troubleshooting.
  errCode String Required. The status code of the request. 200_OK indicates that the request was successful.
  errMsg String

Conditionally required if the call is unsuccessful. The message associated with the error code.
  licensePlate String Required. The unique identifier for the request and response instance.
  exceptionName String

The exception returned for the request, if applicable.

Valid values:

  • BadRequestException – The request is missing fields or has invalid data.
  • NotFoundException – The requested information is not available.
payload – Required. The payload containing the response body. If the call is unsuccessful, payload is null.
  id String Conditionally required if the call is successful. The identifier for the new or edited partner company location.

Example

{
    "header": {
        "headerVersion": 1,
        "eventName": "masterdata-manager:add-partnerLocation-response:v4",
        "ownerId": "bb40845c-8912-4b98-9c9a-f08bd5a9bd07",
        "isErr": false,
        "errCode": "200_OK",
        "licensePlate": "zi4Dzj-R8do2g"
    },
    "payload": {
        "id": "342f5d98-11dc-11ed-9805-932314baeafa"
    }
}

Errors

Element Error Message Description
  • dataStatus
  • regulatoryLocationIdentifierType
  • businessType

Invalid value for . Valid values are: [list of valid values, separated by commas].

 The error occurs if the value is not in the list of valid values.
regulatoryLocationIdentifiers Identifiers must be unique. Identifier value already exists in Company or Partner Master Data. The error occurs if the regulatoryLocationIdentifiers specifies a primary ID that is in use but is not the primary Partner Id.
regulatoryLocationIdentifiers Identifier Type has two values. Only one identifier value for each type can be added for a single Partner location, except for COMPANYSITEID. The error occurs if the regulatoryLocationIdentifiers specifies a primary ID that does not belong to the Partner.
isPrimaryRegulatoryIdentifier No identifiers are currently set as the primary. One identifier must be set as the primary identifier. The error occurs if no identifiers are set at the primary identifier.
isPrimaryRegulatoryIdentifier Multiple identifiers are currently set as the primary. Only one identifier can be set as the primary identifier.

The error occurs if isPrimaryRegulatoryIdentifier is set to have multiple identifiers as the primary identifier.
partnerIdentifier A Partner company with the primary identifier [] does not exist. Make sure the identifier is set as the primary for that Partner company. The error occurs if partnerIdentifier specifies a primary identifier for a Partner company location that does not exist.
regulatoryPartnerLicenses

License is already assigned to another Partner company or location.

The error occurs if regulatoryPartnerLicenses is set to assign a license to more than one Partner company or location.
businessEmail An email address is not in the valid format.

The error occurs if an invalid email address is entered.

regulatoryContactEmail An email address is not in the valid format. The error occurs if an invalid email address is entered.

This app uses standard HTTP response codes. If an error occurs, additional available information regarding the cause of the error is provided in the errMsg element in the relevant response.

Review TraceLink's API: Terms of Use

Query Partner Company Location Master Data

IT system administrators and app developers use this API to retrieve the full master data record for a Partner company's location (e.g. name, address).

Guidelines

  Attribute Type Description
header –

Required. The request header.
  headerVersion Integer

Required. The version identifier for the request. Valid value is1.
  eventName String

Required. The fully qualified name of the request event. Valid value ismasterdata-manager:query-partnerLocationMasterData:v1
  ownerId String

Required. The identifier for the company providing the app.
  dataspace String

Required. The dataspace within the environment where the request is being made. Valid value for the Production and Validation environments is default.
  appName String

Required. The application that owns the event. Valid value ismasterdata-manager.
payload –

Required. The request body.
  predicates Array

Required. The contents of the query.
    type String

Required. The type of the predicate. Valid value is PREDICATE.
    logicalOperator String

Required. The logical operator of the predicate.

Valid values:

  • AND
  • OR
  • TRUE
    clauses Array

Required. The attributes and values to include in the response message.
      type String

Required. The type of the clause. Valid value is TERM.
      comparisonOperator String

Required. The operator of the term. 

Valid values:

  • CLOSED - Search for values within a range, including the endpoints of the range
  • CLOSED_OPEN - Search for values within a range, where the range includes the lower endpoint and does not include the upper endpoint
  • DB_FTS - Perform a full-text search using the query term. Does not support wildcards.
  • EQ - Equal to
  • GE - Greater than or equal to
  • GT - Greater than
  • IN - Search for values that are included in the given list
  • LE - Less than or equal to
  • LT - Less than
  • LUCENE_FTS - Perform a Lucene search using the contents of ftsInfo. Lucene wildcards are supported.
  • NE - Not equal
  • OPEN - Search for values within a range, not including the endpoints of the range
  • OPEN_CLOSED - Search for values within a range, where the range does not include the lower endpoint and does include the upper endpoint
  • WILDCARD - Perform a search that matches the wildcard query. Supported wildcards are * and ..
      schemaId String

Required. The schema identifier of the network objects being queried.
      ftsInfo Object

Required. The Lucene query info.

        value String

Required. Determines the content the query searches for. Replace "[searchString]" with the search value. Valid values:

  • index-regulatoryPartnerLocationIdentifiersDerivedField:[searchString]
    • Simultaneously searches for the [searchString] in the following fields:
      • Identifier Type
      • Identifier Value
  • index-regulatoryPartnerLocationIdentifiersWithBusinessNameDerivedField:[searchString]
    • Simultaneously searches for the [searchString] in the following fields:
      • Location Name
      • Identifier Type
      • Identifier Value
  • index-regulatoryPartnerLocationLicensesWithBusinessNameDerivedField:[searchString]
    • Simultaneously searches for the [searchString] in the following fields:
      • Location Name
      • Agency
      • Country
      • State or Region
      • Number
  • index-businessMasterDataCommon.businessName:[searchString]
  • index-partnerIdentifier INDEX ON /data/companyIdentifier
        pageIndex Integer

Required. The index of the first page of results to display, starting at 0.
        sortField Object

Required. The method of sorting the values in the relevant indexes.

Valid values:

  • ASCENDING
  • DESCENDING
  maximumResults Integer

Required. The maximum number of results returned in the response.
  pagingInfo String

Required. The query paging information representing where the previous query result ended. The pagingInfo from the previous query may be used as the starting point for the current query.
  keyFormat String

Required. The format of the response to a key-only query.

Valid values:

  • OBJECT_ID – The object identifier of the document is returned in the response.
  • PRIMARY_KEY – The primary key of the object in schemaId#objectId format is returned in the response.

Example

{
  "header": {
    "headerVersion": 1,
    "eventName": "masterdata-manager:query-partnerLocationMasterData:v1",
    "ownerId": "00000000-0000-0000-0000-000000000000",
    "dataspace": "default",
    "appName": "masterdata-manager"
  },
  "payload": {
    "predicates": [
      {
        "type": "PREDICATE",
        "logicalOperator": "TRUE",
        "clauses": [{
          "type": "TERM",
          "comparisonOperator": "LUCENE_FTS",
          "schemaId": "masterdata-manager:partnerLocationMasterData",
          "ftsInfo": {
            "value": "index-regulatoryPartnerLocationIdentifiersWithBusinessNameDerivedField:*123*",
            "pageIndex": 0,
            "sortField": {
            }
          }
        }]
      }    
    ],
    "maximumResults": 10000,
    "pagingInfo": "",
    "keyFormat": "PRIMARY_KEY"
  }
}

Guidelines

  Attribute Type Description
header –

Required. The response header.
  headerVersion Integer

Required. The version identifier for the response. Valid value is1.
  eventName String

Required. The fully qualified name of the response event. Valid value ismasterdata-manager:query-partnerLocationMasterData:v1.
  ownerId String

Required. The identifier for the company providing the app.
  isErr String

Required. Indicates whether the request was successful. Valid values:

  • true – The request was successful.
  • false – The request was not successful. The errCode field provides error information for troubleshooting.
  errCode String

Required. The status code of the request. 200_OK indicates that the request was successful.
  errMsg String

Conditionally required if the call is unsuccessful. The message associated with the error code.
  licensePlate String

Required. The unique identifier for the request and response instance.
payload –

Required. The response body.
  pagingInfo String

Required. The query paging information representing where the previous query result ended. The pagingInfo from the previous query may be used as the starting point for a new query.
  documents Array

Required. Contains the results of the query request.
    metadata Object

Required. The metadata about the object.
      schemaId String

Required. The JSON schema that defines the object.
      schemaVersion Integer

Required. The JSON schema version number.
      primaryKey String

Required. The primary key of the object.
      dataVersion Integer

Required. The current version number of the object.
      indexTarget String

Required. The index target identifier of the object.
      dbTxid Integer

Required. The transactional identifier of the object.
    payload –

Required. The master data objects.
      schemaVersion Integer

Required. The JSON schema version number.
      data Object

Required. Contains the attributes for the object. The contents depend on the object schema specified when the event handlers were added.
        dataStatus Boolean

Required. Indicates if the master data for this location is active or inactive.

Valid values:

  • true – The master data for this location is active.
  • false – The master data for this location is inactive.
        parentLegalEntityCode String Required. The legal code of the parent network node.
        isLegalEntity Boolean

Specifies if the company is a legal entity.

Valid values:

  • true – The node is a legal entity.
  • false – The node is not a legal entity.
        legalEntityCode String

The legal entity code of the network node.
        companyNetworkNodeId String

Required. The network node that the record belongs to.
        locationNetworkNodeId String Required. The location node that owns the record.
        regulatoryLocationIdentifiers String

Required. The list of all identifiers of the company.
          regulatoryIdentifierValue String

Required. The identifier value.
          lscRegulatoryIdentifier String Required. The identifier of the regulatory identifier type and value in Track & Trace Services.
          isPrimaryRegulatoryIdentifier String

Required. Specifies if the given identifier is the primary identifier.
          regulatoryCompanyIdentifierTypeId String Required. The identifier of the regulatory identifier type and value combination.
          regulatoryCompanyIdentifierType String

Required. The identifier type.
        regulatoryLocationLicenses Array The partner location's license information.
          lscLicenseIdentifier String The license identifier in Track & Trace Services.
          licenseStateOrRegion String The state or region of the licensing agency.
          licenseIssuingAgency String The agency granting the regulatory license.
          licenseCountry String Required. The country of the licensing agency.
          licenseNumber String Required. The regulatory license number for the specified Partner company location.
        businessMasterDataCommon TypeDef

Required. The common business information.
          businessType String

The list of all business types of the company.

          lscBusinessVersion String

Required. The business version identifier in Track & Trace Services.
          businessName String

Required. The company's name.
          businessEmail String

The company's email address.
          businessPhone String

The company's phone number.
          businessUrl String

The URL of the company's website.
          businessTaxRegistrationCode String

The company's tax registration code.
          businessAddress TypeDef

The company's address information.
            address1 String

The street address, including number and street name.
            address2 String

The second line of the street address. Any additional address information, if available.
            city String

The city in which the company is located.
            district String

The 3-digit numeric code of the district where the company is located in India.
            village String

The village in which the Partner company location is located in.
            houseNumber String

The building, house, or unit number of the company. House numbers are usually only separated from the street address in China. For all addresses outside of China, continue to enter the building, house, or unit number in address1.
            township String

The name of the town in which the company is located.
            stateOrRegion String

Required. The state, province, or region using the standard two– or three–letter abbreviation specified in the ISO 3166–2:1998 country subdivision code.
            postalCode String

Conditionally required if the country has a ZIP or other postal code. If the country does have a postal code and it is omitted, an error is generated. See Valid values for exclusions.

  • Angola, AO

  • Antigua and Barbuda, AG

  • Aruba, AW

  • Bahamas, BS

  • Belize, BZ

  • Benin, BJ

  • Botswana, BW

  • Burkina Faso, BF

  • Burundi, BI

  • Cameroon, CM

  • Central African Republic, CF

  • Comoros, KM

  • Congo, CG

  • Congo, the Democratic Republic of the, CD

  • Cook Islands, CK

  • Cote d'Ivoire, CI

  • Djibouti, DJ

  • Dominica, DM

  • Equatorial Guinea, GQ

  • Eritrea, ER

  • Fiji, FJ

  • French Southern Territories, TF

  • Gambia, GM

  • Ghana, GH

  • Grenada, GD

  • Guinea, GN

  • Guyana, GY

  • Hong Kong, HK

  • Ireland, IE

  • Jamaica, JM

  • Kenya, KE

  • Kiribati, KI

  • Macao, MO

  • Malawi, MW

  • Mali, ML

  • Mauritania, MR

  • Mauritius, MU

  • Montserrat, MS

  • Nauru, NR

  • Netherlands Antilles, AN

  • Niue, NU

  • North Korea, KP

  • Panama, PA

  • Qatar, QA

  • Rwanda, RW

  • Saint Kitts and Nevis, KN

  • Saint Lucia, LC

  • Sao Tome and Principe, ST

  • Saudi Arabia, SA

  • Seychelles, SC

  • Sierra Leone, SL

  • Solomon Islands, SB

  • Somalia, SO

  • South Africa, ZA

  • Suriname, SR

  • Syria, SY

  • Tanzania, United Republic of, TZ

  • Timor-Leste, TL

  • Tokelau, TK

  • Tonga, TO

  • Trinidad and Tobago, TT

  • Tuvalu, TV

  • Uganda, UG

  • United Arab Emirates, AE

  • Vanuatu, VU

  • Yemen, YE

  • Zimbabwe, ZW
            country String

Required. The country using the standard two–letter abbreviation specified in ISO 3166–1alpha-2:1997 country code.

  • AD – ANDORRA
  • AE – UNITED ARAB EMIRATES
  • AF – AFGHANISTAN
  • AG – ANTIGUA AND BARBUDA
  • AI – ANGUILLA
  • AL – ALBANIA
  • AM – ARMENIA
  • AN – NETHERLANDS ANTILLES
  • AO – ANGOLA
  • AQ – ANTARCTICA
  • AR – ARGENTINA
  • AS – AMERICAN SAMOA
  • AT – AUSTRIA
  • AU – AUSTRALIA
  • AW – ARUBA
  • AX – ÅLAND ISLANDS
  • AZ – AZERBAIJAN
  • BA – BOSNIA AND HERZEGOVINA
  • BB – BARBADOS
  • BD – BANGLADESH
  • BE – BELGIUM
  • BF – BURKINA FASO
  • BG – BULGARIA
  • BH – BAHRAIN
  • BI – BURUNDI
  • BJ – BENIN
  • BL – SAINT BARTHÉLEMY
  • BM – BERMUDA
  • BN – BRUNEI DARUSSALAM
  • BO – BOLIVIA, PLURINATIONAL STATE OF
  • BR – BRAZIL
  • BS – BAHAMAS
  • BT – BHUTAN
  • BV – BOUVET ISLAND
  • BW – BOTSWANA
  • BY – BELARUS
  • BZ – BELIZE
  • CA – CANADA 
  • CC – COCOS (KEELING) ISLANDS
  • CD – CONGO, THE DEMOCRATIC REPUBLIC OF THE
  • CF – CENTRAL AFRICAN REPUBLIC
  • CG – CONGO
  • CH – SWITZERLAND
  • CI – CÔTE D'IVOIRE
  • CK – COOK ISLANDS
  • CL – CHILE
  • CM – CAMEROON
  • CN – CHINA
  • CO – COLOMBIA
  • CR – COSTA RICA
  • CU – CUBA
  • CV – CAPE VERDE
  • CX – CHRISTMAS ISLAND
  • CY – CYPRUS
  • CZ – CZECH REPUBLIC
  • DE – GERMANY
  • DJ – DJIBOUTI
  • DK – DENMARK
  • DM – DOMINICA
  • DO – DOMINICAN REPUBLIC
  • DZ – ALGERIA
  • EC – ECUADOR
  • EE – ESTONIA
  • EG – EGYPT
  • EH – WESTERN SAHARA
  • ER – ERITREA
  • ES – SPAIN
  • ET – ETHIOPIA
  • FI – FINLAND
  • FJ – FIJI
  • FK – FALKLAND ISLANDS (MALVINAS)
  • FM – MICRONESIA, FEDERATED STATES OF
  • FO – FAROE ISLANDS
  • FR – FRANCE
  • GA – GABON
  • GB – UNITED KINGDOM
  • GD – GRENADA
  • GE – GEORGIA
  • GF – FRENCH GUIANA
  • GG – GUERNSEY
  • GH – GHANA
  • GI – GIBRALTAR
  • GL – GREENLAND
  • GM – GAMBIA
  • GN – GUINEA
  • GP – GUADELOUPE
  • GQ – EQUATORIAL GUINEA
  • GR – GREECE
  • GS – SOUTH GEORGIA AND THE SOUTH SANDWICH ISLANDS
  • GT – GUATEMALA
  • GU – GUAM
  • GW – GUINEA–BISSAU
  • GY – GUYANA
  • HK - HONG KONG
  • HM – HEARD ISLAND AND MCDONALD ISLANDS
  • HN – HONDURAS
  • HR – CROATIA
  • HT – HAITI
  • HU – HUNGARY
  • ID – INDONESIA
  • IE – IRELAND
  • IL – ISRAEL
  • IM – ISLE OF MAN
  • IN – INDIA
  • IO – BRITISH INDIAN OCEAN TERRITORY
  • IQ – IRAQ
  • IR – IRAN, ISLAMIC REPUBLIC OF
  • IS – ICELAND
  • IT – ITALY
  • JE – JERSEY
  • JM – JAMAICA
  • JO – JORDAN
  • JP – JAPAN
  • KE – KENYA
  • KG – KYRGYZSTAN
  • KH – CAMBODIA
  • KI – KIRIBATI
  • KM – COMOROS
  • KN – SAINT KITTS AND NEVIS
  • KP – KOREA, DEMOCRATIC PEOPLE'S REPUBLIC OF
  • KR – KOREA, REPUBLIC OF
  • KW – KUWAIT
  • KY – CAYMAN ISLANDS
  • KZ – KAZAKHSTAN
  • LA – LAO PEOPLE'S DEMOCRATIC REPUBLIC
  • LB – LEBANON
  • LC – SAINT LUCIA
  • LI – LIECHTENSTEIN
  • LK – SRI LANKA
  • LR – LIBERIA
  • LS – LESOTHO
  • LT – LITHUANIA
  • LU – LUXEMBOURG
  • LV – LATVIA
  • LY – LIBYAN ARAB JAMAHIRIYA
  • MA – MOROCCO
  • MC – MONACO
  • MD – MOLDOVA, REPUBLIC OF
  • ME – MONTENEGRO
  • MF – SAINT MARTIN
  • MG – MADAGASCAR
  • MH – MARSHALL ISLANDS
  • MK – MACEDONIA, THE FORMER YUGOSLAV REPUBLIC OF
  • ML – MALI
  • MM – MYANMAR
  • MN – MONGOLIA
  • MO – MACAO
  • MP – NORTHERN MARIANA ISLANDS
  • MQ – MARTINIQUE
  • MR – MAURITANIA
  • MS – MONTSERRAT
  • MT – MALTA
  • MU – MAURITIUS
  • MV – MALDIVES
  • MW – MALAWI 
  • MX – MEXICO
  • MY – MALAYSIA
  • MZ – MOZAMBIQUE
  • NA – NAMIBIA
  • NC – NEW CALEDONIA
  • NE – NIGER
  • NF – NORFOLK ISLAND
  • NG – NIGERIA
  • NI – NICARAGUA
  • NL – NETHERLANDS
  • NO – NORWAY
  • NP – NEPAL
  • NR – NAURU
  • NU – NIUE
  • NZ – NEW ZEALAND
  • OM – OMAN
  • PA – PANAMA
  • PE – PERU
  • PF – FRENCH POLYNESIA
  • PG – PAPUA NEW GUINEA
  • PH – PHILIPPINES
  • PK – PAKISTAN
  • PL – POLAND
  • PM – SAINT PIERRE AND MIQUELON
  • PN – PITCAIRN
  • PR – PUERTO RICO
  • PS – PALESTINIAN TERRITORY, OCCUPIED
  • PT – PORTUGAL
  • PW – PALAU
  • PY – PARAGUAY
  • QA – QATAR
  • RE – RÉUNION
  • RO – ROMANIA
  • RS – SERBIA
  • RU – RUSSIAN FEDERATION
  • RW – RWANDA
  • SA – SAUDI ARABIA
  • SB – SOLOMON ISLANDS
  • SC – SEYCHELLES
  • SD – SUDAN
  • SE – SWEDEN
  • SG – SINGAPORE
  • SH – SAINT HELENA, ASCENSION AND TRISTAN DA CUNHA
  • SI – SLOVENIA
  • SJ – SVALBARD AND JAN MAYEN
  • SK – SLOVAKIA
  • SL – SIERRA LEONE
  • SM – SAN MARINO
  • SN – SENEGAL
  • SO – SOMALIA
  • SR – SURINAME
  • ST – SAO TOME AND PRINCIPE
  • SV – EL SALVADOR
  • SY – SYRIAN ARAB REPUBLIC
  • SZ – SWAZILAND
  • TC – TURKS AND CAICOS ISLANDS
  • TD – CHAD
  • TF – FRENCH SOUTHERN TERRITORIES
  • TG – TOGO
  • TH – THAILAND
  • TJ – TAJIKISTAN
  • TK – TOKELAU
  • TL – TIMOR–LESTE
  • TM – TURKMENISTAN
  • TN – TUNISIA
  • TO – TONGA
  • TR – TURKEY
  • TT – TRINIDAD AND TOBAGO
  • TV – TUVALU
  • TW – TAIWAN
  • TZ – TANZANIA, UNITED REPUBLIC OF
  • UA – UKRAINE
  • UG – UGANDA
  • UM – UNITED STATES MINOR OUTLYING ISLANDS
  • US – UNITED STATES
  • UY – URUGUAY
  • UZ – UZBEKISTAN
  • VA – HOLY SEE (VATICAN CITY STATE)
  • VC – SAINT VINCENT AND THE GRENADINES
  • VE – VENEZUELA, BOLIVARIAN REPUBLIC OF
  • VG – VIRGIN ISLANDS, BRITISH
  • VI – VIRGIN ISLANDS, U.S.
  • VN – VIET NAM
  • VU – VANUATU
  • WF – WALLIS AND FUTUNA
  • WS – SAMOA
  • XK – KOSOVO
  • YE – YEMEN
  • YT – MAYOTTE
  • ZA – SOUTH AFRICA
  • ZM – ZAMBIA
  • ZW – ZIMBABWE
            url String The URL of the Partner company location's website.
            buildingNumber String

The Partner company's building number.
            plantNumber String

The facility's plant number.
            floorNumber String

The facility's floor number.
            premisesCode String

The identifier representing a physical area within the company location (e.g. a location's second floor).
            fax String

The office's fax number.
            telephone String

The office's telephone number.
            lscAddressidentifier String

The global identifier assigned by Russian Federation Information Address System (FIAS). Maximum 36 characters, using the digits 0-9 and letters A-F.
          regulatoryContact Object

The contact information for the regulatory contact at the company.
            regulatoryContactTitle String

The regulatory contact's business title.
            regulatoryContactName String

The regulatory contact's name.
            regulatoryContactEmail String

The regulatory contact's email address.
            regulatoryContactPhone Integer

The regulatory contact's phone number.
        regulatoryPartnerLocationIdentifiersDerivedField String

The result of the query when ftsInfo | value equals index-regulatoryPartnerLocationIdentifiersDerivedField:[searchString] in the request.
        regulatoryPartnerLocationIdentifiersWithBusinessNameDerivedField String

The result of the query when ftsInfo | value equals index-regulatoryPartnerLocationIdentifiersWithBusinessNameDerivedField:[searchString] in the request.
        index-regulatoryPartnerLocationLicensesWithBusinessNameDerivedField String

The result of the query when ftsInfo | value equals index-regulatoryPartnerLocationLicensesWithBusinessNameDerivedField in the request.
      schemaId String

Required. The JSON schema that defines the object.
      id String Required. The identifier of the master data object.
      objectType String Required. The type of the object. Valid value is masterdata-manager:productMasterData.
      lastUpdatedDateTime String

The identifier of the user that made the last update to the master data record.

      contextualOwnerId String Required. The identifier of the Partner company sending the master data request.
      lastUpdatedByUserId DateTime

The identifier of the user that made the last update to the master data record.
      ownerId String

Required. The identifier of the Partner company that owns the master data record.
      dataVersion Integer

Required. The current version number of the object.
      createdByUserId String

Required. The ID of the user that created the master data record.
      creationDateTime DateTime

Required. The date and time when the master data record was created.
  primaryKey String Required. The primary key of the object.
facets String

Required. Enables searches through a particular dataset.

Example

{
  "header": {
    "headerVersion": 1,
    "eventName": "masterdata-manager:query-partnerLocationMasterData-response:v1",
    "ownerId": "00000000-0000-0000-0000-000000000000",
    "isErr": false,
    "errCode": "200_OK",
    "licensePlate": "fjjnne"
  },
  "payload": {
    "pagingInfo": null,
    "documents": [
      {
        "metadata": {
        "schemaId": "masterdata-manager:partnerLocationMasterData",
        "schemaVersion": 1,
        "primaryKey": "masterdata-manager:partnerLocationMasterData#0d1d7aa7-32c5-47f0-84b8-fdfa9219e67b",
        "dataVersion": 1,
        "indexTarget": "0d1d7aa7-32c5-47f0-84b8-fdfa9219e67b",
        "dbTxId": 53948
      },
      "payload": {
        "schemaVersion": 1,
        "data": {
          "companyNetworkNodeId": "companyNetworkNodeId",
          "regulatoryCompanyIdentifiers": [
            {
              "regulatoryCompanyIdentifierTypeId": "SGLN",
              "isPrimaryRegulatoryIdentifier": false,
              "regulatoryIdentifierValue": "OneOne1"
            },
            {
              "regulatoryCompanyIdentifierTypeId": "GLN",
              "isPrimaryRegulatoryIdentifier": false,
              "regulatoryIdentifierValue": "123456"
            }
          ],
          "businessMasterDataCommon": {
            "businessType": [
              "MANUFACTURER"
            ],
            "lscBusinessVersion": "lscBusinessVersion",
            "businessName": "Time Magazin",
            "businessEmail": "businessEmail",
            "businessPhone": "businessPhone",
            "businessUrl": "businessUrl",
            "businessTaxRegistrationCode": "businessTaxRegistrationCode",
            "businessAddress": {
                    "address1": "address1",
                    "address2": "address2",
                    "buildingNumber": "buildingNumber",
                    "plantNumber": "plantNumber",
                    "floorNumber": "floorNumber",
                    "city": "city",
                    "district": "district",
                    "state": "state",
                    "postalCode": "postalCode",
                    "country": "US",
                    "telephone": "telephone",
                    "fax": "fax",
                    "url": "url",
            },
            "regulatoryContact": {
              "regulatoryContactTitle": "regulatoryContactTitle",
              "regulatoryContactName": "regulatoryContactName",
              "regulatoryContactEmail": "regulatoryContactEmail",
              "regulatoryContactPhone": "regulatoryContactPhone"
            },
          },
          "regulatoryPartnerIdentifiersDerivedField": "SGLN OneOne1,GLN 123456",
          "regulatoryPartnerLocationIdentifiersWithBusinessNameDerivedField": "Time Magazin SGLN OneOne1,Time Magazin GLN 123456"
        },
        "schemaId": "masterdata-manager:partnerLocationMasterData",
        "id": "0d1d7aa7-32c5-47f0-84b8-fdfa9219e67b",
        "objectType": "masterdata-manager:partnerLocationMasterData",
        "lastUpdatedDateTime": 1614028698435,
        "contextualOwnerId": "00000000-0000-0000-0000-000000000000",
        "lastUpdatedByUserId": "f9f35dd0-035d-11eb-8ec8-0242ac11000c",
        "ownerId": "00000000-0000-0000-0000-000000000000",
        "dataVersion": 1,
        "createdByUserId": "f9f35dd0-035d-11eb-8ec8-0242ac11000c",
        "creationDateTime": 1614028698435
      },
      "primaryKey": "masterdata-manager:partnerLocationMasterData#0d1d7aa7-32c5-47f0-84b8-fdfa9219e67b"
      }
    ],
    "facets": [
    ]
  }
}

Errors

This app uses standard HTTP response codes. If an error occurs, additional available information regarding the cause of the error is provided in the errMsg element in the relevant response.

Review TraceLink's API: Terms of Use

Table of contents