Importing Sales Orders into Enapps

This task will create new sales orders in your Enapps account, from an XML file. The task does not support updating existing sales orders.

Settings

Enapps Connection

Required
The Enapps connection to use. See the Connecting to Enapps 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 Enapps. The data must be in XML format, a sample of which is shown below.

Success File

Required
The name of the file to write successfully processed records to.

Important

The XML format of the success file is different to the input file and the fail 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.

Timeout

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

Zynk Settings

See Common Task Settings

Examples

The example XML below shows all the fields that can be provided when creating a sales order in Enapps.

<?xml version="1.0" encoding="utf-8"?>
<SalesOrderCreations>
  <SalesOrderCreation>
    <ExternalId>123</ExternalId>
    <PartnerOrderId>953</PartnerOrderId>
    <PartnerRef>ZYNK0001</PartnerRef>
    <Products>
      <Product>
        <ProductId>2900</ProductId>
        <DefaultCode>PROD0001</DefaultCode>
        <Qty>1</Qty>
        <PriceUnit>10.99</PriceUnit>
      </Product>
    </Products>
    <ShopId>1</ShopId>
    <ClientOrderRef>Order 18482</ClientOrderRef>
    <ShippingDetails>
      <FirstName>John</FirstName>
      <LastName>Smith</LastName>
      <CompanyName>Zynk Software Ltd</CompanyName>
      <Country>GB</Country>
      <StreetAddress1>i6</StreetAddress1>
      <StreetAddress2>6-8 Charlotte Square</StreetAddress2>
      <TownCity>Newcastle</TownCity>
      <Postcode>NE1 4XF</Postcode>
      <DeliveryContactEmail>[email protected]</DeliveryContactEmail>
    </ShippingDetails>
  </SalesOrderCreation>
</SalesOrderCreations>

The example XML below shows the success file after a sales order has been created in Enapps.

<?xml version="1.0" encoding="utf-8"?>
<SalesOrders xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <SalesOrder>
    <Id>59081</Id>
    <ExternalId>123</ExternalId>
    <Name>SO000509</Name>
    <ClientOrderRef>Order 18482</ClientOrderRef>
    <DeliveryAddress>
      <Id>81306</Id>
      <Name>i6, Newcastle, NE1 4XF, GB, (Delivery)</Name>
    </DeliveryAddress>
    <State>draft</State>
    <AmountTotal>38.4</AmountTotal>
    <AmountTax>6.4</AmountTax>
    <AmountUntaxed>32.0</AmountUntaxed>
    <DateOrder>2025-01-28T00:00:00</DateOrder>
    <PriceList>
      <Id>1</Id>
      <Name>Public Pricelist (GBP)</Name>
    </PriceList>
    <Partner>
      <Id>953</Id>
      <Name>Zynk Software Ltd (ZYNK0001)</Name>
    </Partner>
    <Shop>
      <Id>1</Id>
      <Name>Main</Name>
    </Shop>
    <PartnerShipping>
      <Id>101633</Id>
      <Name>John Smith | Zynk Software Ltd</Name>
    </PartnerShipping>
    <PartnerOrder>
      <Id>953</Id>
      <Name>Accounts, i6, Newcastle | Zynk Software Ltd</Name>
    </PartnerOrder>
    <CreateDate>2025-01-28T10:38:52</CreateDate>
    <OrderLineIds>
      <OrderLineId>343481</OrderLineId>
    </OrderLineIds>
  </SalesOrder>
</SalesOrders>