# Create Global Trade Item Reference

Create a reference between Global Trade Item and Business Partner.

Endpoint: POST /globaltradeitems/{gtin}/businesspartnerreferences
Version: 1
Security: apiKey

## Path parameters:

  - `gtin` (string, required)
    Unique Global Trade Item Number.
    Example: "5099206081901"

## Request fields (application/json):

  - `businessPartnerReferences` (array, required)
    List of Business Partners to be referenced.

  - `businessPartnerReferences.storageId` (string, required)
    Unique identifier of the Storage.
    Example: "72d6900fce6b326088f5d9d91049e3e6"

  - `businessPartnerReferences.dataSourceId` (string, required)
    Unique identifier for a Data Source of the Storage.
    Example: "648824a691d8d2503d65103e"

  - `businessPartnerReferences.businessPartnerId` (string, required)
    A CDQ ID identifies a business partner uniquely in the context of the Corporate Data League.
    Example: "63e635235c06b7396330fe40"

  - `businessPartnerReferences.externalId` (string)
    Arbitrary identifier type to mark customer IDs that are "external" from CDQ's perspective. This is the identifier a customer provides to identify its records.
    Example: "The ID managed in the customer's SAP systems."

## Response 200 fields (application/json):

  - `results` (array)
    List of Business Partner References that have been created.

  - `results.businessPartnerReference` (object)
    Reference between Global Trade Item and Business Partner.

  - `results.businessPartnerReference.storageId` (string)
    Unique identifier of the Storage.
    Example: "72d6900fce6b326088f5d9d91049e3e6"

  - `results.businessPartnerReference.dataSourceId` (string)
    Unique identifier for a Data Source of the Storage.
    Example: "648824a691d8d2503d65103e"

  - `results.businessPartnerReference.businessPartnerId` (string)
    A CDQ ID identifies a business partner uniquely in the context of the Corporate Data League.
    Example: "63e635235c06b7396330fe40"

  - `results.businessPartnerReference.externalId` (string)
    Arbitrary identifier type to mark customer IDs that are "external" from CDQ's perspective. This is the identifier a customer provides to identify its records.
    Example: "The ID managed in the customer's SAP systems."

  - `results.status` (string)
    Status of the create operation:
* OK - the business partner reference has been created
* DUPLICATE - the business partner reference already existed
    Example: "OK"