In addition, several Customer and Business Unit Messages have been enhanced to provide clearer change-tracking information. You can now see the following:

• Track which address type (billing or shipping) was modified when addresses are added, updated, or removed for a Customer and Business Unit.
• Compare previous and current values when an email or Customer Group is updated for a Customer.
• Identify deleted Customers by their email address.

Changes:

• [API] Added the AddressRole type.
• [API] Added the addressRoles field to the following Messages: CustomerAddressChangedMessage, CustomerAddressRemovedMessage, BusinessUnitAddressChangedMessage, BusinessUnitAddressRemovedMessage.
• [API] Added the email field to CustomerDeletedMessage.
• [API] Added the oldCustomerGroupAssignments field to CustomerGroupAssignmentsSetMessage.
• [API] Added the following Customers Messages: CustomerBillingAddressAddedMessage, CustomerBillingAddressRemovedMessage, CustomerShippingAddressAddedMessage, CustomerShippingAddressRemovedMessage, CustomerExternalIdSetMessage.
• [GraphQL API] Added the following types to the GraphQL schema: AddressRole, CustomerBillingAddressAdded, CustomerBillingAddressRemoved, CustomerShippingAddressAdded, CustomerShippingAddressRemoved, CustomerExternalIdSet.
• [GraphQL API] Added the addressRoles field to the following types: CustomerAddressChanged, CustomerAddressRemoved, BusinessUnitAddressChanged, BusinessUnitAddressRemoved.
• [GraphQL API] Added the oldEmail field to the CustomerEmailChanged type.
• [GraphQL API] Added the email field to the CustomerDeleted type.
• [GraphQL API] Added the oldCustomerGroupAssignments field to the CustomerGroupAssignmentsSet type.
• [GraphQL API] Changed the addressId field type from String to String! for the following types: CustomerAddressCustomFieldAdded, CustomerAddressCustomFieldRemoved, CustomerAddressCustomFieldChanged, CustomerAddressCustomTypeRemoved, CustomerAddressCustomTypeSet, BusinessUnitAddressCustomFieldAdded, BusinessUnitAddressCustomFieldChanged, BusinessUnitAddressCustomTypeRemoved, BusinessUnitAddressCustomTypeSet.
• [GraphQL API] Added the oldInheritedStores, oldInheritedStoresRef, inheritedStores, inheritedStoresRef fields to the BusinessUnitStoreModeChanged type.

The following changes were introduced in terms of GraphQL SDL:

extend type CustomerDeleted {
  email: String
}

extend type BusinessUnitAddressRemoved {
  addressRoles: [AddressRole!]!
}

extend type CustomerAddressChanged {
  addressRoles: [AddressRole!]!
}

extend type CustomerGroupAssignmentsSet {
  oldCustomerGroupAssignments: [CustomerGroupAssignment!]!
}

extend type CustomerAddressRemoved {
  addressRoles: [AddressRole!]!
}

extend type CustomerEmailChanged {
  oldEmail: String!
}

extend type BusinessUnitStoreModeChanged {
  inheritedStores: [Store!]
  inheritedStoresRef: [KeyReference!]
  oldInheritedStores: [Store!]
  oldInheritedStoresRef: [KeyReference!]
}

extend type BusinessUnitAddressChanged {
  addressRoles: [AddressRole!]!
}

enum AddressRole {
  Billing
  Shipping
}

type CustomerBillingAddressAdded implements MessagePayload {
  address: Address!
  type: String!
}

type CustomerBillingAddressRemoved implements MessagePayload {
  address: Address!
  type: String!
}

type CustomerShippingAddressAdded implements MessagePayload {
  address: Address!
  type: String!
}

type CustomerShippingAddressRemoved implements MessagePayload {
  address: Address!
  type: String!
}

type CustomerExternalIdSet implements MessagePayload {
  externalId: String
  type: String!
}