Mandatory fields: SalesOrder
As sales orders can be tailored to suit customer needs, there are no fields that are always mandatory. The minimum amount of data required for entering sales orders is small. However, you should bear in mind that the actual amount needed to create meaningful orders and to progress those orders is much larger. This is wholly dependent on how your system is configured.
As a guide you will probably find that the following need to be supplied:
- Sales Definition Code
payload element:
<SalesDefinitionCode>
- Sales Order Transaction
Reference
payload element:
<SalesOrderTransactionReference>
- Either:
- User Line Number
payload element:
<LineNumber>
- Sales Order Line Number
payload element:
<SalesOrderLineNumber>
- User Line Number
- Item Code
payload element:
<ItemCode>
See individual methods for specific field requirements. SalesOrderLineNumber is never mandatory, but depending on the method, you will need either LineNumber or SalesOrderLineNumber.
Generating an Invoice
When generating an invoice, values for one or more of the following
elements in the
<GenerateInvoiceParams>
group may need to be
supplied.
-
Consolidation Group Name
payload element
<ConsolidationGroupName>
- Document Format Code
payload element
<DocumentFormatCode>
- Invoice Date
payload element
<InvoiceDate>
- Invoice Period
payload element
<InvoicePeriod>
Notes
Although the payload definition includes the
<DemandQuantity>
and
<OriginalDemandQuantity>
elements within the
<Line>
element, these must not be used when
creating or amending the Sales Order Line quantity. Instead, you must provide
it in the appropriate Value Label (<VLabnn>
) element.
As Value Labels are user-configurable you should confirm that your
values are specified in the correct
<VLabnn>
element before executing your payload.
You can determine which element to use via the following steps:
- Open Sales Type (STS) function in SunSystems.
- Key the Sales Definition Code and press 「」.
- Click 「」; a list of all value labels that exist for the Sales Definition Code is displayed.
- Open Value Labels (VLB) function in SunSystems; choose the value label you are planning to use. The Value Label Identifier holds the value label number that you should use in your payload.
For example, in the SunSystems demonstration data,
Value Label QUANTITY1 is assigned to Value Label 1. If you want to specify a Sales
Order Line Quantity in your payload, then specify the quantity value in the <VSolVlabEntry_Val>
subelement within <Vlab01>
.