Harmony: Project Details (ItemOut)

Harmony, Technical Information

Updated at February 19th, 2025

Table of Contents

The WS4P system allows customers to enter multiple items (jobs) into a single shopping cart, to make online purchases more efficient. Details for these jobs appear under the <ItemOut> designation. Each job is given its own <ItemOut> record, so a single cXML transaction may include several <ItemOut> entries.

<ItemOut quantity="44">
      <ID domain="ws4p">907528</ID>

Each <ItemOut> lists a quantity and job ID(s) supplied by the website (domain="ws4p") and/or the MIS system (domain="mis_system"). As with all of the IDs, if the receiving system does not have an ID already in place for the newly created job, one will be generated, and then passed back to the other system the next time data for this transaction is sent.

      <ItemID>
            <SupplierPartID><![CDATA[Estimate Request]]></SupplierPartID>
      </ItemID>

The <ItemOut> record also contains a <SupplierPartID>, which corresponds with the order form or Reorder Form Library item used to place the order. In the example above, the value "Estimate Request" is used to indicate that this particular transaction was an estimate request, and not an order for an item (part/product) already in the system.

Item Details

Additional details about each job are included in the <ItemDetail> section of the cXML document (see below). These details include pricing, product description, and any information entered in the order form at the time the order was made.

      <ItemDetail>
            <UnitPrice>
                  <Money currency="USD">0.25</Money>
            </UnitPrice>
            <Description xml:lang="en">
                  <ShortName><![CDATA[Estimate Request]]></ShortName>
            </Description>
            <UnitOfMeasure>EA</UnitOfMeasure>

As with the Shopping Cart, printers are allowed to customize their order forms as they see fit. The <Extrinsic> tag is used to capture the names and values of these printshop-generated fields and pass them through to the MIS system.

            <Extrinsic name="Form Used:"><![CDATA[Estimate: Quick Estimate Form]]></Extrinsic>
            <Extrinsic name="Project Details:"><![CDATA[asdfas d]]></Extrinsic>
            <Extrinsic name="TEST"><![CDATA[32548798]]></Extrinsic>
            <Extrinsic name="Contact Name:"><![CDATA[asdfasd]]></Extrinsic>
            <Extrinsic name="Ink Color:"><![CDATA[Blue]]></Extrinsic>
            
      </ItemDetail>
            
</ItemOut>