PurchasePriceBooks

This component runs the Purchase Price Book (PPBS) function and allows you to set up and maintain purchase price books.

Note: Purchase Price Book (PPBS) pages are maintained using the Purchase Price Book Pages (PPP) function or via payloads using the PurchasePriceBookPages component.

Methods

CreateOrAmend
Driver Type: SASI
This method creates a purchase price book if it does not exist already and amends it if it does.
Query
Driver Type: Export
Use this method to obtain purchase price book details or to extract purchase price book data from SunSystems. In your query you must set Price Book Type - payload element <PriceBookType> to '2' and Price Book Sequence Type - payload element <PriceBookSequenceType> to '2' .

Mandatory fields

When creating or amending a purchase price book, a value must be supplied for the Price Book Definition Code - payload element <PriceBookDefinitionCode>

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

  • Purchase Price Books
  • Purchase Price Books Analysis
  • Standard Text
  • Standard Text Language

The attachment of Standard Text is supported by the CreateOrAmend method. 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:

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