Delivery section

The <delivery> section is where you define whether the delivery is sent automatically or manually. You can also instruct XMLDelivery to:

• Send an automatic delivery at a scheduled time
• Remove duplicate recipient addresses at the time of sending
• Send a Transactional delivery type
• Request a delivery report after a given time

The <delivery> section:

• Belongs to the Common sections and elements and is mandatory
• Is positioned within the generic campaign type (for example, <email>) section, after <recipients>, in the XML instructions file

The <delivery> section includes the following children:

Child	Type	Description	Use
schedule	element	Specify a delivery date and time for an automatic delivery. The schedule format is yyyy-mm-ddThh:mm:ss.	Optional
remove_duplicates	element	Automatically removes duplicate recipient addresses. This must be activated here, if required, regardless of the default behavior of the Web UI.	Optional
transactional	element	Sets the delivery type to transactional. The default marketing delivery type is applied, if not set.	Optional
schedule_report	element	Sets the delivery reports parameters.	Optional

Use

To define a manual or automatic delivery use the following:

• <delivery method="manual"></delivery>
  Prepares the delivery but doesn’t send it. Use the Communicate section of the Web UI to locate the delivery and start it manually.
• <delivery method="auto"></delivery>
  The delivery is sent automatically:
  • If a <schedule> is created (see Example below) the delivery is sent as defined
  • If no <schedule> is created, the delivery is sent immediately

Note:

If transactional is set:

• The group defined in the newsletter section must also be transactional
  or:
• If template_from_campaign_id in the Email message section is used, the template must be transactional

If the group or the template is the wrong type, XMLDelivery returns an error, to avoid a transactional campaign being sent by mistake.

Examples:

    <delivery method="auto">
        <schedule>2030T02:03:51</schedule>
        <remove_duplicates />
    </delivery>

    <!-- or: -->
    <delivery method="manual">
        <remove_duplicates />
    </delivery>

    <!-- or: -->
    <delivery method="manual">
        <remove_duplicates />
        <transactional />
    </delivery>