Partner APIs

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

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

Get Partner Company Master Data

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

Get Partner Company Master Data request

Guidelines

Attribute		Type	Description
header		–	Required. The request header.
	headerVersion	Integer	Required. The version identifier for the request. Valid value is `1`.
	eventName	String	Required. The fully qualified name of the request event. Valid value is `masterdata-manager:get-partner-by-regulatory-identifier:v1`.
	ownerId	String	Required. The identifier for the company providing the app.
	dataspace	String	Required. The dataspace within the environment where the request is being made. Valid value for the Production and Validation environments is `default`.
	appName	String	Required. The application that owns the event. Valid value is `masterdata-manager`.
payload		–	Required. The request body.
	regulatoryCompanyIdentifier	String	The value of the regulatory identifier.
	regulatoryCompanyIdentifierType	String	The type of the regulatory identifier.

Example

Copy

1
2
3
4
5
6
7
8
9
10
11
12
13
{
  "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"
  }
}

Get Partner Company Master Data response

Guidelines

Attribute							Type	Description
header							–	Required. The response header.
	headerVersion						Integer	Required. The version identifier for the response. Valid value is `1`.
	eventName						String	Required. The fully qualified name of the response event. Valid value is `masterdata-manager:get-partner-by-regulatory-identifier-response:v1`.
	ownerId						String	Required. The identifier for the company providing the app.
	isErr						String	Required. Indicates whether the request was successful. Valid values: `true` – The request was successful. `false` – The request was not successful. The errCode field provides error information for troubleshooting.
	errCode						String	Required. The status code of the request. `200_OK` indicates that the request was successful.
	errMsg						String	Conditionally required if the call is unsuccessful. The message associated with the error code.
	licensePlate						String	Required. The unique identifier for the request and response instance.
payload							–	Required. The response body.
	pagingInfo						String	Required. The query paging information representing where the previous query result ended. The pagingInfo from the previous query may be used as the starting point for a new query.
	documents						Array	Required. Contains the results of the query request.
		metadata					Object	Required. The metadata about the object.
				schemaId			String	Required. The JSON schema that defines the object.
				schemaVersion			Integer	Required. The JSON schema version number.
				primaryKey			String	Required. The primary key of the object.
				dataVersion			Integer	Required. The current version number of the object.
				indexTarget			String	Required. The index target identifier of the object.
				dbTxid			Integer	Required. The transactional identifier of the object.
		payload					–	Required. The master data objects.
			schemaVersion				String	Required. The JSON schema version number.
			data				Object	Required. Contains the attributes for the object. The contents depend on the object schema specified when the event handlers were added.
				dataStatus			Boolean	Required. Indicates if the master data for this location is active or inactive. Valid values: `true` – The master data for this location is active. `false` – The master data for this location is inactive.
				lscS3Identifier			String	Required. The identifier of the company object that S3 uses.
				isLegalEntity			Boolean	Specifies if the company is a legal entity. Valid values: `true` – The node is a legal entity. `false` – The node is not a legal entity.
				providerNetworkNodeIdentifier			String	Required. The network node of the originating company for the master data record.
				legalEntityCode			String	The legal entity code of the network node.
				companyNetworkNodeId			String	Required. The network node that the record belongs to.
				regulatoryPartnerLicenses			Array	The Partner company's license information.
					lscLicenseIdentifier		String	The license identifier in Track & Trace Services.
					licenseNumber		String	Required. The regulatory license number for the specified Partner company.
					licenseCountry		String	Required. The country of the licensing agency.
					licenseIssuingAgency		String	The agency granting the regulatory license.
					licenseStateOrRegion		String	The state or region of the licensing agency.
				regulatoryPartnerIdentifiers			String	Required. The list of all identifiers of the company.
					regulatoryCompanyIdentifierTypeId		String	Required. The identifier of the regulatory identifier type and value combination.
					regulatoryCompanyIdentifierType		String	Required. The identifier type.
					isPrimaryRegulatoryIdentifier		String	Required. Specifies if the given identifier is the primary identifier.
					regulatoryIdentifierValue		String	Required. The identifier value.
				businessMasterDataCommon			TypeDef	Required. The common business information.
					businessType		String	The list of all business types of the company.
					lscBusinessVersion		String	Required. The business version identifier in Track & Trace Services.
					businessName		String	Required. The company's name.
					businessEmail		String	The company's email address.
					businessPhone		String	The company's phone number.
					businessUrl		String	The URL of the company's website.
					businessTaxRegistrationCode		String	The company's tax registration code.
					businessAddress		TypeDef	The company's address information.
						address1	String	Required. The street address, including number and street name.
						address2	String	The second line of the street address. Any additional address information, if available.
						city	String	Required. The city where this Partner company is located.
						district	String	The 3-digit numeric code of the district where the Partner company is located in India.
						village	String	The village in which the Partner company is located.
						houseNumber	String	The building, house, or unit number of the company. House numbers are usually only separated from the street address in China. For all addresses outside of China, continue to enter the building, house, or unit number in address1.
						township	String	The name of the town in which the Partner company is located.
						stateOrRegion	String	Required. The state, province, or region using the standard two– or three–letter abbreviation specified in the ISO 3166–2:1998 country subdivision code.
						postalCode	String	Conditionally required if the country has a ZIP or other postal code. If the country does have a postal code and it is omitted, an error is generated. See Valid values for exclusions. 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. 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

Copy

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
{
  "header": {
    "headerVersion": 1,
    "eventName": "masterdata-manager:get-partner-by-regulatory-identifier-response:v1",
    "ownerId": "00000000-0000-0000-0000-000000000000",
    "isErr": false,
    "errCode": "200_OK",
    "licensePlate": "W1thmm"
  },
  "payload": {
    "pagingInfo": null,
    "documents": [
      {
        "metadata": {
          "schemaId": "masterdata-manager:partnerMasterData",
          "schemaVersion": 1,
          "primaryKey": "masterdata-manager:partnerMasterData#471b0f7a-4759-4279-bf8e-dc74c70bd8a8",
          "dataVersion": 1,
          "indexTarget": "471b0f7a-4759-4279-bf8e-dc74c70bd8a8",
          "dbTxId": 111353
        },
        "payload": {
          "schemaVersion": 1,
          "data": {
            "dataStatus": "dataStatus",
            "lscS3Identifier": "lscS3Identifier",
            "isLegalEntity": true,
            "providerNetworkNodeIdentifier": "providerNetworkNodeIdentifier",
            "legalEntityCode": "legalEntityCode",
            "companyNetworkNodeId": "companyNetworkNodeId",
            "regulatoryPartnerLicenses": [
              {
                "lscLicenseIdentifier": "lscLicenseIdentifier",
                "licenseNumber": "licenseNumber",
                "licenseCountry": "US",
                "licenseIssuingAgency": "licenseIssuingAgency",
                "licenseStateOrRegion": "licenseStateOrRegion"
              }
            ],
            "regulatoryPartnerIdentifiers": [
              {
                "regulatoryCompanyIdentifierTypeId": "ac8b1d0b-8041-4938-bd38-0c5eeed8a28b",
                "regulatoryCompanyIdentifierType": "SGLN",
                "lscRegulatoryIdentifier": "lscRegulatoryIdentifier",
                "isPrimaryRegulatoryIdentifier": false,
                "regulatoryIdentifierValue": "8888882021122"
              }
            ],
            "businessMasterDataCommon": {
              "businessType": [
                "MANUFACTURER"
              ],
              "lscBusinessVersion": "lscBusinessVersion",
              "businessName": "businessNameTest",
              "businessEmail": "businessEmail",
              "businessPhone": "businessPhone",
              "businessUrl": "businessUrl",
              "businessTaxRegistrationCode": "businessTaxRegistrationCode",
              "businessAddress": {
                "address1": "address1",
                "address2": "address2",
                "buildingNumber": "buildingNumber",
                "plantNumber": "plantNumber",
                "floorNumber": "floorNumber",
                "houseNumber": "houseNumber",
                "city": "city",
                "village": "village",
                "township": "township",
                "district": "district",
                "state": "state",
                "postalCode": "postalCode",
                "country": "US",
                "telephone": "telephone",
                "fax": "fax",
                "url": "url",
                "lscAddressIdentifier": "lscAddressIdentifier"
              },
              "regulatoryContact": {
                "regulatoryContactTitle": "regulatoryContactTitle",
                "regulatoryContactName": "regulatoryContactName",
                "regulatoryContactEmail": "regulatoryContactEmail",
                "regulatoryContactPhone": "regulatoryContactPhone"
              },
              "businessLogo": {
                "imageIdentifier": "imageIdentifier",
                "imageMimeType": "imageMimeType",
                "imagefileName": "imagefileName",
                "imagebase64": "imagebase64"
              }
            },
            "regulatoryPartnerLicensesWithBusinessNameDerivedField": "businessNameTest licenseIssuingAgency US licenseStateOrRegion licenseNumber",
            "regulatoryPartnerIdentifiersWithBusinessNameDerivedField": "businessNameTest SGLN 8888882021122",
            "regulatoryPartnerIdentifiersDerivedField": "SGLN 8888882021122"
          },
          "schemaId": "masterdata-manager:partnerMasterData",
          "id": "471b0f7a-4759-4279-bf8e-dc74c70bd8a8",
          "objectType": "masterdata-manager:partnerMasterData",
          "lastUpdatedDateTime": 1616100835395,
          "contextualOwnerId": "00000000-0000-0000-0000-000000000000",
          "lastUpdatedByUserId": "f9f35dd0-035d-11eb-8ec8-0242ac11000c",
          "ownerId": "00000000-0000-0000-0000-000000000000",
          "dataVersion": 1,
          "createdByUserId": "f9f35dd0-035d-11eb-8ec8-0242ac11000c",
          "creationDateTime": 1616100835395
        },
        "primaryKey": "masterdata-manager:partnerMasterData#471b0f7a-4759-4279-bf8e-dc74c70bd8a8"
      }
    ],
    "facets": [
    ]
  }
}

Errors

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

Review TraceLink's API: Terms of Use

Add or Edit Partner Company Master Data

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

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. 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. 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. 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

Copy

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
{
    "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"
                }
            }
        }
    }
}

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

Copy

1
2
3
4
5
6
7
8
9
10
11
12
13
{
    "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 <field name>. 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 [<type>] <value> 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 <type> has two values. Only one identifier value for each type can be added for this location, except for COMPANYID and COMPANYSITEID.	The error occurs if the regulatoryPartnerIdentifiers specifies a primary ID that does not belong to the company.
isPrimaryRegulatoryIdentifier	No identifiers are currently set as the primary. One identifier must be set as the primary identifier.	The error occurs if no identifiers are set at the primary identifier.
isPrimaryRegulatoryIdentifier	Multiple identifiers are currently set as the primary. Only one identifier can be set as the primary identifier.	The error occurs if isPrimaryRegulatoryIdentifier is set to have multiple identifiers as the primary identifier.
regulatoryPartnerLicenses	License is already assigned to another Partner company or location.	The error occurs if regulatoryPartnerLicenses is set to assign a license to more than one Partner company or location.
businessEmail	An email address is not in the valid format.	The error occurs if an invalid email address is entered.
regulatoryContactEmail	An email address is not in the valid format.	The error occurs if an invalid email address is entered.

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

Review TraceLink's API: Terms of Use

Query Partner Company Master Data

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

Query Partner Company Master Data request

Guidelines

Attribute					Type	Description
header					–	Required. The request header.
	headerVersion				Integer	Required. The version identifier for the request. Valid value is`1`.
	eventName				String	Required. The fully qualified name of the request event. Valid value is`masterdata-manager: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

Copy

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
{
  "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"
  }
}

Query Partner Company Master Data response

Guidelines

Attribute							Type	Description
header							–	Required. The response header.
	headerVersion						Integer	Required. The version identifier for the response. Valid value is`1`.
	eventName						String	Required. The fully qualified name of the response event. Valid value is`masterdata-manager: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. 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. 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

Copy

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
{
  "header": {
    "headerVersion": 1,
    "eventName": "masterdata-manager:query-partnerMasterData-response:v1",
    "ownerId": "00000000-0000-0000-0000-000000000000",
    "isErr": false,
    "errCode": "200_OK",
    "licensePlate": "W1thmm"
  },
  "payload": {
    "pagingInfo": null,
    "documents": [
      {
        "metadata": {
          "schemaId": "masterdata-manager:partnerMasterData",
          "schemaVersion": 1,
          "primaryKey": "masterdata-manager:partnerMasterData#471b0f7a-4759-4279-bf8e-dc74c70bd8a8",
          "dataVersion": 1,
          "indexTarget": "471b0f7a-4759-4279-bf8e-dc74c70bd8a8",
          "dbTxId": 111353
        },
        "payload": {
          "schemaVersion": 1,
          "data": {
            "dataStatus": "dataStatus",
            "lscS3Identifier": "lscS3Identifier",
            "isLegalEntity": true,
            "providerNetworkNodeIdentifier": "providerNetworkNodeIdentifier",
            "legalEntityCode": "legalEntityCode",
            "companyNetworkNodeId": "companyNetworkNodeId",
            "regulatoryPartnerLicenses": [
              {
                "lscLicenseIdentifier": "lscLicenseIdentifier",
                "licenseNumber": "licenseNumber",
                "licenseCountry": "US",
                "licenseIssuingAgency": "licenseIssuingAgency",
                "licenseStateOrRegion": "licenseStateOrRegion"
              }
            ],
            "regulatoryPartnerIdentifiers": [
              {
                "regulatoryCompanyIdentifierTypeId": "ac8b1d0b-8041-4938-bd38-0c5eeed8a28b",
                "regulatoryCompanyIdentifierType": "SGLN",
                "lscRegulatoryIdentifier": "lscRegulatoryIdentifier",
                "isPrimaryRegulatoryIdentifier": false,
                "regulatoryIdentifierValue": "8888882021122"
              }
            ],
            "businessMasterDataCommon": {
              "businessType": [
                "MANUFACTURER"
              ],
              "lscBusinessVersion": "lscBusinessVersion",
              "businessName": "businessNameTest",
              "businessEmail": "businessEmail",
              "businessPhone": "businessPhone",
              "businessUrl": "businessUrl",
              "businessTaxRegistrationCode": "businessTaxRegistrationCode",
              "businessAddress": {
                "address1": "address1",
                "address2": "address2",
                "buildingNumber": "buildingNumber",
                "plantNumber": "plantNumber",
                "floorNumber": "floorNumber",
                "houseNumber": "houseNumber",
                "city": "city",
                "village": "village",
                "township": "township",
                "district": "district",
                "state": "state",
                "postalCode": "postalCode",
                "country": "US",
                "telephone": "telephone",
                "fax": "fax",
                "url": "url",
                "lscAddressIdentifier": "lscAddressIdentifier"
              },
              "regulatoryContact": {
                "regulatoryContactTitle": "regulatoryContactTitle",
                "regulatoryContactName": "regulatoryContactName",
                "regulatoryContactEmail": "regulatoryContactEmail",
                "regulatoryContactPhone": "regulatoryContactPhone"
              },
              "businessLogo": {
                "imageIdentifier": "imageIdentifier",
                "imageMimeType": "imageMimeType",
                "imagefileName": "imagefileName",
                "imagebase64": "imagebase64"
              }
            },
            "regulatoryPartnerLicensesWithBusinessNameDerivedField": "businessNameTest licenseIssuingAgency US licenseStateOrRegion licenseNumber",
            "regulatoryPartnerIdentifiersWithBusinessNameDerivedField": "businessNameTest SGLN 8888882021122",
            "regulatoryPartnerIdentifiersDerivedField": "SGLN 8888882021122"
          },
          "schemaId": "masterdata-manager:partnerMasterData",
          "id": "471b0f7a-4759-4279-bf8e-dc74c70bd8a8",
          "objectType": "masterdata-manager:partnerMasterData",
          "lastUpdatedDateTime": 1616100835395,
          "contextualOwnerId": "00000000-0000-0000-0000-000000000000",
          "lastUpdatedByUserId": "f9f35dd0-035d-11eb-8ec8-0242ac11000c",
          "ownerId": "00000000-0000-0000-0000-000000000000",
          "dataVersion": 1,
          "createdByUserId": "f9f35dd0-035d-11eb-8ec8-0242ac11000c",
          "creationDateTime": 1616100835395
        },
        "primaryKey": "masterdata-manager:partnerMasterData#471b0f7a-4759-4279-bf8e-dc74c70bd8a8"
      }
    ],
    "facets": [
    ]
  }
}

Errors

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

Review TraceLink's API: Terms of Use

Get Partner Company Location Master Data

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

Get Partner Company Location Master Data request

Guidelines

Attribute		Type	Description
header		–	Required. The request header.
	headerVersion	Integer	Required. The version identifier for the request. Valid value is `1`.
	eventName	String	Required. The fully qualified name of the request event. Valid value is `masterdata-manager:get-partnerLocation-by-regulatory-identifier:v1`.
	ownerId	String	Required. The identifier for the company providing the app.
	dataspace	String	Required. The dataspace within the environment where the request is being made. Valid value for the Production and Validation environments is `default`.
	appName	String	Required. The application that owns the event. Valid value is `masterdata-manager`.
payload		–	Required. The request body.
	regulatoryLocationIdentifier	String	The value of the regulatory identifier.
	regulatoryLocationIdentifierType	String	The type of the regulatory identifier.

Example

Copy

1
2
3
4
5
6
7
8
9
10
11
12
13
{
  "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"
  }
}

Get Partner Company Location Master Data response

Guidelines

Attribute							Type	Description
header							–	Required. The response header.
	headerVersion						Integer	Required. The version identifier for the response. Valid value is `1`.
	eventName						String	Required. The fully qualified name of the response event. Valid value is `masterdata-manager:get-partnerLocation-by-regulatory-identifier-response:v1`.
	ownerId						String	Required. The identifier for the company providing the app.
	isErr						String	Required. Indicates whether the request was successful. Valid values: `true` – The request was successful. `false` – The request was not successful. The errCode field provides error information for troubleshooting.
	errCode						String	Required. The status code of the request. `200_OK` indicates that the request was successful.
	errMsg						String	Conditionally required if the call is unsuccessful. The message associated with the error code.
	licensePlate						String	Required. The unique identifier for the request and response instance.
payload							–	Required. The response body.
	pagingInfo						String	Required. The query paging information representing where the previous query result ended. The pagingInfo from the previous query may be used as the starting point for a new query.
	documents						Array	Required. Contains the results of the query request.
		metadata					Object	Required. The metadata about the object.
			schemaId				String	Required. The JSON schema that defines the object.
			schemaVersion				Integer	Required. The JSON schema version number.
			primaryKey				String	Required. The primary key of the object.
			dataVersion				Integer	Required. The current version number of the object.
			indexTarget				String	Required. The index target identifier of the object.
			dbTxid				Integer	Required. The transactional identifier of the object.
		payload					–	Required. The master data objects.
			schemaVersion				Integer	Required. The JSON schema version number.
			data				Object	Required. Contains the attributes for the object. The contents depend on the object schema specified when the event handlers were added.
				dataStatus			Boolean	Required. Indicates if the master data for this location is active or inactive. Valid values: `true` – The master data for this location is active. `false` – The master data for this location is inactive.
				parentLegalEntityCode			String	Required. The legal code of the parent network node.
				isLegalEntity			Boolean	Specifies if the company is a legal entity. Valid values: `true` – The node is a legal entity. `false` – The node is not a legal entity.
				legalEntityCode			String	The legal entity code of the network node.
				companyNetworkNodeId			String	Required. The network node that the record belongs to.
				locationNetworkNodeId			String	Required. The location node that owns the record.
				regulatoryLocationIdentifiers			String	Required. The list of all identifiers of the company.
					regulatoryIdentifierValue		String	Required. The identifier value.
					lscRegulatoryIdentifier		String	Required. The identifier of the regulatory identifier type and value in Track & Trace Services.
					isPrimaryRegulatoryIdentifier		String	Required. Specifies if the given identifier is the primary identifier.
					regulatoryCompanyIdentifierTypeId		String	Required. The identifier of the regulatory identifier type and value combination.
					regulatoryCompanyIdentifierType		String	Required. The identifier type.
				regulatoryLocationLicenses			Array	The partner location's license information.
					lscLicenseIdentifier		String	The license identifier in Track & Trace Services.
					licenseStateOrRegion		String	The state or region of the licensing agency.
					licenseIssuingAgency		String	The agency granting the regulatory license.
					licenseCountry		String	Required. The country of the licensing agency.
					licenseNumber		String	Required. The regulatory license number for the specified Partner company location.
				businessMasterDataCommon			TypeDef	Required. The common business information.
					businessType		String	The list of all business types of the company.
					lscBusinessVersion		String	Required. The business version identifier in Track & Trace Services.
					businessName		String	Required. The company's name.
					businessEmail		String	The company's email address.
					businessPhone		String	The company's phone number.
					businessUrl		String	The URL of the company's website.
					businessTaxRegistrationCode		String	The company's tax registration code.
					businessAddress		TypeDef	The company's address information.
						address1	String	Required. The street address, including number and street name.
						address2	String	The second line of the street address. Any additional address information, if available.
						city	String	Required. The city where this Partner company is located.
						district	String	The 3-digit numeric code of the district where the company is located in India.
						village	String	The village in which the Partner company location is located in.
						houseNumber	String	The building, house, or unit number of the company. House numbers are usually only separated from the street address in China. For all addresses outside of China, continue to enter the building, house, or unit number in address1.
						township	String	The name of the town in which the company is located.
						stateOrRegion	String	Required. The state, province, or region using the standard two– or three–letter abbreviation specified in the ISO 3166–2:1998 country subdivision code.
						postalCode	String	Conditionally required if the country has a ZIP or other postal code. If the country does have a postal code and it is omitted, an error is generated. See Valid values for exclusions. 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. 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

Copy

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
{
  "header": {
    "headerVersion": 1,
    "eventName": "masterdata-manager:get-partnerLocation-by-regulatory-identifier-response-response:v1",
    "ownerId": "00000000-0000-0000-0000-000000000000",
    "isErr": false,
    "errCode": "200_OK",
    "licensePlate": "W1thmm"
  },
  "payload": {
    "pagingInfo": null,
    "documents": [
      {
        "metadata": {
          "schemaId": "masterdata-manager:partnerLocationMasterData",
          "schemaVersion": 1,
          "primaryKey": "masterdata-manager:partnerLocationMasterData#0d1d7aa7-32c5-47f0-84b8-fdfa9219e67b",
          "dataVersion": 1,
          "indexTarget": "0d1d7aa7-32c5-47f0-84b8-fdfa9219e67b",
          "dbTxId": 53948
        },
        "payload": {
          "schemaVersion": 1,
          "data": {
            "companyNetworkNodeId": "companyNetworkNodeId",
            "regulatoryCompanyIdentifiers": [
              {
                "regulatoryCompanyIdentifierTypeId": "SGLN",
                "isPrimaryRegulatoryIdentifier": false,
                "regulatoryIdentifierValue": "OneOne1"
              },
              {
                "regulatoryCompanyIdentifierTypeId": "GLN",
                "isPrimaryRegulatoryIdentifier": false,
                "regulatoryIdentifierValue": "123456"
              }
            ],
            "businessMasterDataCommon": {
              "businessType": [
                "MANUFACTURER"
              ],
              "lscBusinessVersion": "lscBusinessVersion",
              "businessName": "Time Magazin",
              "businessEmail": "businessEmail",
              "businessPhone": "businessPhone",
              "businessUrl": "businessUrl",
              "businessTaxRegistrationCode": "businessTaxRegistrationCode",
              "businessAddress": {
                "address1": "address1",
                "address2": "address2",
                "buildingNumber": "buildingNumber",
                "plantNumber": "plantNumber",
                "floorNumber": "floorNumber",
                "houseNumber": "houseNumber",
                "city": "city",
                "village": "village",
                "township": "township",
                "district": "district",
                "state": "state",
                "postalCode": "postalCode",
                "country": "US",
                "telephone": "telephone",
                "fax": "fax",
                "url": "url",
                "lscAddressIdentifier": "lscAddressIdentifier"
              },
              "regulatoryContact": {
                "regulatoryContactTitle": "regulatoryContactTitle",
                "regulatoryContactName": "regulatoryContactName",
                "regulatoryContactEmail": "regulatoryContactEmail",
                "regulatoryContactPhone": "regulatoryContactPhone"
              },
            },
            "regulatoryPartnerIdentifiersDerivedField": "SGLN OneOne1,GLN 123456",
            "regulatoryPartnerLocationIdentifiersWithBusinessNameDerivedField": "Time Magazin SGLN OneOne1,Time Magazin GLN 123456"
          },
          "schemaId": "masterdata-manager:partnerLocationMasterData",
          "id": "0d1d7aa7-32c5-47f0-84b8-fdfa9219e67b",
          "lastUpdatedDateTime": 1614028698435,
          "contextualOwnerId": "00000000-0000-0000-0000-000000000000",
          "lastUpdatedByUserId": "f9f35dd0-035d-11eb-8ec8-0242ac11000c",
          "ownerId": "00000000-0000-0000-0000-000000000000",
          "dataVersion": 1,
          "createdByUserId": "f9f35dd0-035d-11eb-8ec8-0242ac11000c",
          "creationDateTime": 1614028698435
        },
        "primaryKey": "masterdata-manager:partnerLocationMasterData#0d1d7aa7-32c5-47f0-84b8-fdfa9219e67b"
      }
    ],
    "facets": [
    ]
  }
}

Errors

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

Review TraceLink's API: Terms of Use

Add or Edit Partner Company Location Master Data

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

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. 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. 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. 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

Copy

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
{
    "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"
                }
            }
        }
    }
}

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

Copy

1
2
3
4
5
6
7
8
9
10
11
12
13
{
    "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 <field name>. 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 <type> 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 <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 [<type>] <value> does not exist. Make sure the identifier is set as the primary for that Partner company.	The error occurs if partnerIdentifier specifies a primary identifier for a Partner company location that does not exist.
regulatoryPartnerLicenses	License is already assigned to another Partner company or location.	The error occurs if regulatoryPartnerLicenses is set to assign a license to more than one Partner company or location.
businessEmail	An email address is not in the valid format.	The error occurs if an invalid email address is entered.
regulatoryContactEmail	An email address is not in the valid format.	The error occurs if an invalid email address is entered.

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

Review TraceLink's API: Terms of Use

Query Partner Company Location Master Data

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

Query Partner Company Location Master Data request

Guidelines

Attribute					Type	Description
header					–	Required. The request header.
	headerVersion				Integer	Required. The version identifier for the request. Valid value is`1`.
	eventName				String	Required. The fully qualified name of the request event. Valid value is`masterdata-manager: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

Copy

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
{
  "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"
  }
}

Query Partner Company Location Master Data response

Guidelines

Attribute							Type	Description
header							–	Required. The response header.
	headerVersion						Integer	Required. The version identifier for the response. Valid value is`1`.
	eventName						String	Required. The fully qualified name of the response event. Valid value is`masterdata-manager: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. 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. 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

Copy

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
{
  "header": {
    "headerVersion": 1,
    "eventName": "masterdata-manager:query-partnerLocationMasterData-response:v1",
    "ownerId": "00000000-0000-0000-0000-000000000000",
    "isErr": false,
    "errCode": "200_OK",
    "licensePlate": "fjjnne"
  },
  "payload": {
    "pagingInfo": null,
    "documents": [
      {
        "metadata": {
        "schemaId": "masterdata-manager:partnerLocationMasterData",
        "schemaVersion": 1,
        "primaryKey": "masterdata-manager:partnerLocationMasterData#0d1d7aa7-32c5-47f0-84b8-fdfa9219e67b",
        "dataVersion": 1,
        "indexTarget": "0d1d7aa7-32c5-47f0-84b8-fdfa9219e67b",
        "dbTxId": 53948
      },
      "payload": {
        "schemaVersion": 1,
        "data": {
          "companyNetworkNodeId": "companyNetworkNodeId",
          "regulatoryCompanyIdentifiers": [
            {
              "regulatoryCompanyIdentifierTypeId": "SGLN",
              "isPrimaryRegulatoryIdentifier": false,
              "regulatoryIdentifierValue": "OneOne1"
            },
            {
              "regulatoryCompanyIdentifierTypeId": "GLN",
              "isPrimaryRegulatoryIdentifier": false,
              "regulatoryIdentifierValue": "123456"
            }
          ],
          "businessMasterDataCommon": {
            "businessType": [
              "MANUFACTURER"
            ],
            "lscBusinessVersion": "lscBusinessVersion",
            "businessName": "Time Magazin",
            "businessEmail": "businessEmail",
            "businessPhone": "businessPhone",
            "businessUrl": "businessUrl",
            "businessTaxRegistrationCode": "businessTaxRegistrationCode",
            "businessAddress": {
                    "address1": "address1",
                    "address2": "address2",
                    "buildingNumber": "buildingNumber",
                    "plantNumber": "plantNumber",
                    "floorNumber": "floorNumber",
                    "city": "city",
                    "district": "district",
                    "state": "state",
                    "postalCode": "postalCode",
                    "country": "US",
                    "telephone": "telephone",
                    "fax": "fax",
                    "url": "url",
            },
            "regulatoryContact": {
              "regulatoryContactTitle": "regulatoryContactTitle",
              "regulatoryContactName": "regulatoryContactName",
              "regulatoryContactEmail": "regulatoryContactEmail",
              "regulatoryContactPhone": "regulatoryContactPhone"
            },
          },
          "regulatoryPartnerIdentifiersDerivedField": "SGLN OneOne1,GLN 123456",
          "regulatoryPartnerLocationIdentifiersWithBusinessNameDerivedField": "Time Magazin SGLN OneOne1,Time Magazin GLN 123456"
        },
        "schemaId": "masterdata-manager:partnerLocationMasterData",
        "id": "0d1d7aa7-32c5-47f0-84b8-fdfa9219e67b",
        "objectType": "masterdata-manager:partnerLocationMasterData",
        "lastUpdatedDateTime": 1614028698435,
        "contextualOwnerId": "00000000-0000-0000-0000-000000000000",
        "lastUpdatedByUserId": "f9f35dd0-035d-11eb-8ec8-0242ac11000c",
        "ownerId": "00000000-0000-0000-0000-000000000000",
        "dataVersion": 1,
        "createdByUserId": "f9f35dd0-035d-11eb-8ec8-0242ac11000c",
        "creationDateTime": 1614028698435
      },
      "primaryKey": "masterdata-manager:partnerLocationMasterData#0d1d7aa7-32c5-47f0-84b8-fdfa9219e67b"
      }
    ],
    "facets": [
    ]
  }
}

Errors

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

Review TraceLink's API: Terms of Use