Importing Order Updates into Mirakl

This task will update certain information on existing orders in your Mirakl account, based on data supplied in an XML file. It does not support creating new orders in Mirakl.

Settings

Mirakl Connection

Required
The Mirakl connection to use. See the Connecting to Mirakl article if you require more information on how to create/manage connections.

Fail File

Required
The name of the file to write failed records to. The data will be output in the same XML format as the Input File. A sample can be found below.

Input File

Required
The name of the file containing the data you want to import into Mirakl. The data must be in XML format, a sample of which is shown below.

Fail File

Required
The name of the file to write successfully imported records to. The data will be output in the same XML format as the Input File. A sample can be found below.

Prevent Reprocessing

Required
Set to 'True' to prevent the same record being processed more than once. This works based on the value of the ExternalId element provided within the Input File.

Shop ID

Optional
If your user has access to multiple shops, use this setting to specify which shop the task should use. If not specified, your default shop will be used.

Timeout

Optional
The length of time to wait for responses from the Mirakl API. If not specified, the timeout will default to 100 seconds.

Zynk Settings

See Common Task Settings

Examples

Sample output file:

<?xml version="1.0" encoding="utf-8"?>
<OrderUpdates>
  <OrderUpdate>
    <OrderId>123456789-1234567-A</OrderId>
    <Customer>
      <BillingAddress>
        <City>Newcastle</City>
        <Civility>Mr</Civility>
        <Company>Zynk Software Ltd</Company>
        <Company2>Zynk Software Ltd</Company2>
        <Country>GB</Country>
        <CountryIsoCode>GBR</CountryIsoCode>
        <FirstName>John</FirstName>
        <LastName>Smith</LastName>
        <Phone>0191 820 1484</Phone>
        <PhoneSecondary>0191 820 1484</PhoneSecondary>
        <State></State>
        <Street1>Office 16</Street1>
        <Street2>6-8 Charlotte Square</Street2>
        <ZipCode>NE1 4XF</ZipCode>
      </BillingAddress>
      <ShippingAddress>
        <AdditionalInfo>Leave package by the door</AdditionalInfo>
        <City>Newcastle</City>
        <Civility>Mr</Civility>
        <Company>Zynk Software Ltd</Company>
        <Company2>Zynk Software Ltd</Company2>
        <Country>GB</Country>
        <CountryIsoCode>GBR</CountryIsoCode>
        <FirstName>John</FirstName>
        <InternalAdditionalInfo>Signature not required</InternalAdditionalInfo>
        <LastName>Smith</LastName>
        <Phone>0191 820 1484</Phone>
        <PhoneSecondary>0191 820 1484</PhoneSecondary>
        <State></State>
        <Street1>Office 16</Street1>
        <Street2>6-8 Charlotte Square</Street2>
        <ZipCode>NE1 4XF</ZipCode>
      </ShippingAddress>
    </Customer>
    <OrderLines>
      <OrderLine>
        <EcoContributions>
          <EcoContribution>
            <EprCategoryCode>FR-DEEE</EprCategoryCode>
            <ProducerId>123456789012345</ProducerId>
            <UnitAmount>1.25</UnitAmount>
          </EcoContribution>
        </EcoContributions>
        <OrderLineId>123456789-1234567-A-1</OrderLineId>
      </OrderLine>
    </OrderLines>
    <PaymentWorkflow>PAY_ON_ACCEPTANCE</PaymentWorkflow>
    <References>
      <OrderReferenceForSeller>ORD00010341</OrderReferenceForSeller>
    </References>
    <ShippingDeadline>2026-03-10T00:00:00Z</ShippingDeadline>
    <ShopStatistics>
      <Excluded>true</Excluded>
      <Reason>Your reason</Reason>
    </ShopStatistics>
  </OrderUpdate>
</OrderUpdates>