SalesTypes - methods

Create

Driver Type : SASI

Use this method to create a sales type. This method only creates a sales type. If the sales type already exists, an error message is produced and the payload is rejected.

CreateOrAmend

Driver Type : SASI

This method creates a sales type if it does not exist already and amends it if it does. Whereas the Create and Amend methods depend on you to know whether the data does or does not exist in advance, this method can be used if you are unsure.

Uwaga: Do not include Stage data in the payload for this method if there are existing Stage records for the transaction type. The update/insert of Stage records is prevented if any Stage data already exists. In this case, Stage records must be created/amended via SunSystems.

CreateReplaceOrDelete

Driver Type: SASI

Use this method to synchronize sales types. The sales type is created if it does not exist already and replaced if it does. If the sales type does not exist in the originating business unit, it is deleted.

Delete

Driver Type : SASI

Use this method to delete sales types.

Uwaga: You cannot delete a SalesTypes record if child data, such as Stage or Value data, exists. If this occurs, use the DeleteChildData method prior to using the Delete method.

DeleteChildData

Driver Type : SASI

This method deletes child data (SO Assign Preset, SO Analysis, Value, Stage) but retains the parent record (Sales Type).

It is also possible to delete 'grandchild' data. The deletion of child and grandchild data is controlled by a <DeletionFlag> node at child level. If the flag is set to Y, both child and grandchild is deleted. Otherwise, the child data is retained.

For example, the <Stage> node contains child data, and the <LedgerIFReversal> node contains grandchild data. The <DeletionFlag> node is set to Y, so the <LedgerInterfaceDefinitionCode> data is deleted first, followed by the <Stage> data:

<SalesTypes>

<SalesTypes.SalesDefinitionCode>SAL</SalesType.SalesDefinitionCode>

<Stage>

<Stage>0</Stage>

<DeletionFlag>

<DeleteStageAfterLIReversalDeleted>Y</DeleteStageAfterLIReversalDeleted>

</DeletionFlag>

<LedgerIFReversal>

<LedgerInterfaceDefinitionCode>LIDEF</LedgerInterfaceDefinitionCode>

</LedgerIFReversal>

</Stage>

</SalesTypes>

Uwaga: Stage data must be deleted in reverse order, i.e. you must not delete a stage that is defined as a Sequence on another record.

Uwaga: A SalesTypes payload deleting Sales Quantity is invalid and will return the error message "One Sales Quantity must be set per Sales Transaction Type". This is because all Order Fulfilment transaction types must have one value label that is flagged as the Quantity.

Query

Driver Type : Export

Use this method to obtain sales type details or to extract sales types data from SunSystems.