ItemCustomer

This component runs the Item Customers (ICU) function.

Methods

CreateOrAmend
Driver Type: SASI
Use this method to create or amend one or more item customers. An item customer is created if it does not exist and amended if it does.
CreateReplaceOrDelete
Driver Type: SASI
Use this method to synchronize item customer data. An item customer data is created if it does not exist already and replaced if it does. If an item customer data does not exist in the originating business unit, it is deleted.
Delete
Driver Type: SASI
Use this method to delete one or more item customers.
Query
Driver Type: Export
Use this method to obtain item customer assignment details or to extract item customer assignment data from SunSystems.

Mandatory fields

  • When creating or amending an item customer assignment, the following must be supplied:
    • Item Code - payload element <ItemCode>
    • Customer Code - payload element <CustomerCode>
  • When creating or amending the item characteristics for an item assigned to a customer, a value must be supplied for Characteristics Code - payload element <CharacteristicsCode>
Note: At runtime the component validates the payload contents to ensure that the values supplied are correct. Various combinations of values may require other elements in the payload to be specified before the payload can be processed successfully.

Related data

  • Characteristics
  • Standard Text
  • Standard Text Language
The attachment of Standard Text is supported by these methods:
  • CreateAsDraft
  • CreateOrAmend
  • CreateReplaceOrDelete
If the standard text supplied in the payload does not exist then it is created. However, it is not possible to amend existing standard text by this means; existing standard text is attached by key only, and any non-key fields in the SSC payload are ignored. Standard text can be amended using the Standard Text Language Variants function from SunSystems or the SSC component StandardTextLanguageVariants.

The standard text to be attached is language specific and therefore must be included within the StandardTextLang part of the payload in order to be detected by the SSC component, as shown in the following example:

<ItemCustomer>
	...
		<StandardText>
			<StandardTextLang>
				<Description>Delivery</Description>
				<LanguageCode>1</LanguageCode>
				<Paragraph1>Follow the special Instructions on the Invoice</Paragraph1>
				<ShortHeading>Delivery</ShortHeading>
				<StandardTextClassCode>SALES</StandardTextClassCode>
				<StandardTextCode>DELIVERY</StandardTextCode>
			</StandardTextLang>
		</StandardText>
</ItemCustomer>