Tracelink University ## Breadcrumb 1. [Home](/) 2. [Resources](/resources/resource-center) 3. [TraceLink University](/resources/tracelink-university) # Partner APIs - [Download PDF](/node/628746/pdf) - [Share](#) - [ LinkedIn ](https://www.linkedin.com/shareArticle?mini=true&url=https://www.tracelink.com/resources/tracelink-university/partner-apis-1&title=Partner APIs&summary=The full master data records for a Partner include the Partner's headquarters information, identifiers, and location master data on TraceLink. &source=TraceLink "LinkedIn") - [ Facebook ](https://www.facebook.com/share.php?u=https://www.tracelink.com/resources/tracelink-university/partner-apis-1&t=Partner APIs "Facebook") - [ Mail ](mailto:?subject=Partner APIs+|+TraceLink&body=https://www.tracelink.com/resources/tracelink-university/partner-apis-1 "Mail") - [ Twitter ](https://twitter.com/intent/tweet?text=Partner APIs https://www.tracelink.com/resources/tracelink-university/partner-apis-1&via=TraceLink "Twitter") #### 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. ![](/sites/default/files/tech_comms/masterdata/Content/Resources/Images/global_images/note_important.png) 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. [![Closed](/sites/default/files/tech_comms/masterdata/Skins/Default/Stylesheets/Images/transparent.gif)Get Partner Company Master Data request](#)#### Guidelines ![Export to Excel](/sites/default/files/tech_comms/masterdata/Content/Resources/Images/global_images/icons/icon_download_to_excel_api.png "Export to Excel") 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 ```xml { "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" } } ``` [![Closed](/sites/default/files/tech_comms/masterdata/Skins/Default/Stylesheets/Images/transparent.gif)Get Partner Company Master Data response](#)#### Guidelines ![Export to Excel](/sites/default/files/tech_comms/masterdata/Content/Resources/Images/global_images/icons/icon_download_to_excel_api.png "Export to Excel") 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. [![Closed](/sites/default/files/tech_comms/masterdata/Skins/Default/Stylesheets/Images/transparent.gif)Valid values](#)- 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. [![Closed](/sites/default/files/tech_comms/masterdata/Skins/Default/Stylesheets/Images/transparent.gif)Valid values](#)- `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 ```xml { "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. ![](/sites/default/files/tech_comms/masterdata/Content/Resources/Images/global_images/note_tip_24x24.png) Review TraceLink's [API: Terms of Use](https://www.tracelink.com/legal-and-trust/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. [![Closed](/sites/default/files/tech_comms/masterdata/Skins/Default/Stylesheets/Images/transparent.gif)Add or Edit Partner Company Master Data request](#)#### 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. [![Closed](/sites/default/files/tech_comms/masterdata/Skins/Default/Stylesheets/Images/transparent.gif)Valid values](#)- `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. [![Closed](/sites/default/files/tech_comms/masterdata/Skins/Default/Stylesheets/Images/transparent.gif)Valid values](#)- 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. [![Closed](/sites/default/files/tech_comms/masterdata/Skins/Default/Stylesheets/Images/transparent.gif)Valid values](#)- `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 ```xml { "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" } } } } } ``` [![Closed](/sites/default/files/tech_comms/masterdata/Skins/Default/Stylesheets/Images/transparent.gif)Add or Edit Partner Company Master Data response](#)#### 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 ```xml { "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. ![](/sites/default/files/tech_comms/masterdata/Content/Resources/Images/global_images/note_tip_24x24.png) Review TraceLink's [API: Terms of Use](https://www.tracelink.com/legal-and-trust/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). [![Closed](/sites/default/files/tech_comms/masterdata/Skins/Default/Stylesheets/Images/transparent.gif)Query Partner Company Master Data request](#)#### Guidelines ![Export to Excel](/sites/default/files/tech_comms/masterdata/Content/Resources/Images/global_images/icons/icon_download_to_excel_api.png "Export to Excel") 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: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 is`masterdata-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 ```xml { "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" } } ``` [![Closed](/sites/default/files/tech_comms/masterdata/Skins/Default/Stylesheets/Images/transparent.gif)Query Partner Company Master Data response](#)#### Guidelines ![Export to Excel](/sites/default/files/tech_comms/masterdata/Content/Resources/Images/global_images/icons/icon_download_to_excel_api.png "Export to Excel") 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: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. [![Closed](/sites/default/files/tech_comms/masterdata/Skins/Default/Stylesheets/Images/transparent.gif)Valid values](#)- 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. [![Closed](/sites/default/files/tech_comms/masterdata/Skins/Default/Stylesheets/Images/transparent.gif)Valid values](#)- `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 ```xml { "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. ![](/sites/default/files/tech_comms/masterdata/Content/Resources/Images/global_images/note_tip_24x24.png) Review TraceLink's [API: Terms of Use](https://www.tracelink.com/legal-and-trust/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. [![Closed](/sites/default/files/tech_comms/masterdata/Skins/Default/Stylesheets/Images/transparent.gif)Get Partner Company Location Master Data request](#)#### Guidelines ![Export to Excel](/sites/default/files/tech_comms/masterdata/Content/Resources/Images/global_images/icons/icon_download_to_excel_api.png "Export to Excel") 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 ```xml { "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" } } ``` [![Closed](/sites/default/files/tech_comms/masterdata/Skins/Default/Stylesheets/Images/transparent.gif)Get Partner Company Location Master Data response](#)#### Guidelines ![Export to Excel](/sites/default/files/tech_comms/masterdata/Content/Resources/Images/global_images/icons/icon_download_to_excel_api.png "Export to Excel") 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. [![Closed](/sites/default/files/tech_comms/masterdata/Skins/Default/Stylesheets/Images/transparent.gif)Valid values](#)- 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. [![Closed](/sites/default/files/tech_comms/masterdata/Skins/Default/Stylesheets/Images/transparent.gif)Valid values](#)- `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 ```xml { "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. ![](/sites/default/files/tech_comms/masterdata/Content/Resources/Images/global_images/note_tip_24x24.png) Review TraceLink's [API: Terms of Use](https://www.tracelink.com/legal-and-trust/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. [![Closed](/sites/default/files/tech_comms/masterdata/Skins/Default/Stylesheets/Images/transparent.gif)Add or Edit Partner Company Location Master Data request](#)#### 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. [![Closed](/sites/default/files/tech_comms/masterdata/Skins/Default/Stylesheets/Images/transparent.gif)Valid values](#)- `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. [![Closed](/sites/default/files/tech_comms/masterdata/Skins/Default/Stylesheets/Images/transparent.gif)Valid values](#)- 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. [![Closed](/sites/default/files/tech_comms/masterdata/Skins/Default/Stylesheets/Images/transparent.gif)Valid values](#)- `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 ```xml { "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" } } } } } ``` [![Closed](/sites/default/files/tech_comms/masterdata/Skins/Default/Stylesheets/Images/transparent.gif)Add or Edit Partner Company Location Master Data response](#)#### 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 ```xml { "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. ![](/sites/default/files/tech_comms/masterdata/Content/Resources/Images/global_images/note_tip_24x24.png) Review TraceLink's [API: Terms of Use](https://www.tracelink.com/legal-and-trust/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). [![Closed](/sites/default/files/tech_comms/masterdata/Skins/Default/Stylesheets/Images/transparent.gif)Query Partner Company Location Master Data request](#)#### Guidelines ![Export to Excel](/sites/default/files/tech_comms/masterdata/Content/Resources/Images/global_images/icons/icon_download_to_excel_api.png "Export to Excel") 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: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 is`masterdata-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 ```xml { "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" } } ``` [![Closed](/sites/default/files/tech_comms/masterdata/Skins/Default/Stylesheets/Images/transparent.gif)Query Partner Company Location Master Data response](#)#### Guidelines ![Export to Excel](/sites/default/files/tech_comms/masterdata/Content/Resources/Images/global_images/icons/icon_download_to_excel_api.png "Export to Excel") 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: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. [![Closed](/sites/default/files/tech_comms/masterdata/Skins/Default/Stylesheets/Images/transparent.gif)Valid values](#)- 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. [![Closed](/sites/default/files/tech_comms/masterdata/Skins/Default/Stylesheets/Images/transparent.gif)Valid values](#)- `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 ```xml { "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. ![](/sites/default/files/tech_comms/masterdata/Content/Resources/Images/global_images/note_tip_24x24.png) Review TraceLink's [API: Terms of Use](https://www.tracelink.com/legal-and-trust/api-terms-of-use) #### Table of contents ##### Related Content [ ![Related content](https://www.tracelink.com/sites/default/files/2024-09/cloud.svg) ](/resources/tracelink-university/forecast-plan-idoc) ##### Forecast plan (IDoc) Forecasting APIs allow companies to exchange data about anticipated product demand and supply availability with upstream supply chain Partners without giving these Partners access to their serialization system of record. [View More](/resources/tracelink-university/forecast-plan-idoc) [ ![Related content](https://www.tracelink.com/sites/default/files/2024-09/cloud.svg) ](/resources/tracelink-university/forecast-plan-x12) ##### Forecast plan (X12) Forecasting APIs allow companies to exchange data about anticipated product demand and supply availability with upstream supply chain Partners without giving these Partners access to their serialization system of record. [View More](/resources/tracelink-university/forecast-plan-x12) [ ![Related content](https://www.tracelink.com/sites/default/files/2024-09/cloud.svg) ](/resources/tracelink-university/forecast-plan-response-idoc) ##### Forecast plan response (IDoc) Forecasting APIs allow companies to exchange data about anticipated product demand and supply availability with downstream supply chain Partners without giving these Partners access to their serialization system of record. [View More](/resources/tracelink-university/forecast-plan-response-idoc)