User GuideReference ManualIntegration Scenarios
 

1.7.4. XML Message Format

See: Managing Channels - Manage a Channel

XML Wizard screen allows you to define your XML message format according to your own file format.

To define a message in XML format, select an existing template or make a copy of the generic XML template in the catalogue and following screen will be displayed.

File sample

Following is a sample XML file.

<?xml version="1.0"?>
<Document>
<SenderID>5420008199981</SenderID>
<ReceiverID>5400102000086</ReceiverID>
<DocumentDate>20080531170538</DocumentDate>
<DocumentNumber>VK20084010</DocumentNumber>
<TestIndicator>P</TestIndicator>
<DocumentLanguage>NL</DocumentLanguage>
<Version>1.1/Food</Version>
<Invoice>
<MessageReferenceNumber>VK20084010</MessageReferenceNumber>
<InvoiceHeader>
<MessageType>INV</MessageType>
<MessageNumber>VK20084010</MessageNumber>
<MessageFunction>ORI</MessageFunction>
<InvoiceCurrency>EUR</InvoiceCurrency>
<Dates>
<InvoiceDate>20080531170538</InvoiceDate>
<AccountingValueDate>20080531170538</AccountingValueDate>
<DeliveryDate>20080530170738</DeliveryDate>
<OrderDate>20080530170538</OrderDate>
</Dates>
</InvoiceHeader>
<InvoiceDetail>
<InvoiceItem>
<ItemType>GDS</ItemType>
<LineItemNumber>1</LineItemNumber>
<EANArticleNumber>95400102057205</EANArticleNumber>
</InvoiceItem>
</InvoiceDetail>
</Invoice>
</Document>

Wizard screen

When you create a new message format, you must first configure it using the following wizard.

XML Wizard screen

Figure 1.68. XML Wizard screen


An XML messsage can be set up using an XSD or a sample XML file. When uploading an Xsd you will have the possibility to select the root element and to provide additionnal imported Xsd. If you upload a sample XML file, be sure to have the most exhaustive one, it will save you modification on the generated tree. After the upload, click the corresponding Save command.

Edit screen

Once the message format sample has been uploaded, or when it is used or copied from a saved format, edit screen appears as follows.

XML Edit screen

Figure 1.69. XML Edit screen


The XSD message definition wizard has some limitations:

  • It does not handle infinite recursion.

  • It does not handle mixed content.

  • It does not handle values for maxOccurs and minOccurs larger than 9999. Large values for maxOccurs could be replaced by the value 'unbounded'.

See Message Edit Functions for further information on message definition, contextual menu and additional commands available on this screen.