SwiftCD HTTP Post Order Submission

SwiftCD offers a HTTP post tool that will accept industry standard XML transmissions as valid SwiftCD orders. The detailed format, as well as sample code, confirmation response and validation information is below.

HTTP Post Order Submission Format

<?xml version="1.0" encoding="UTF-8" ?>
<SwiftCDOrders CreateDt="12/1/2001 5:00pm" BatchId="100" SubmitterId="VendorIdentification" ContactInfo="cust@vendor.com">
     <Order>
          <CustomerId>NEWC</CustomerId> 
          <TransactionDate>9/5/2001 10:00am</TransactionDate> 
          <Items>
               <CD>
                    <TrackingId>20010307-860-1</TrackingId> 
                    <LabelId>1</LabelId> 
                    <PackageId>1</PackageId>
                    <Quantity>1</Quantity> 
                    <RegKeyTitle>Unlock Code</RegKeyTitle> 
                    <RegKey>12345</RegKey> 
                    <RegFileName>regkey.txt</RegFileName> 
                    <RegFileContent>1ansrinta0-6iae0y52345</RegFileContent> 
                    <Content>
                         <Product>
                              <ProductId>123456</ProductId> 
                              <Title>Shareware CD</Title> 
                         </Product>
                    </Content>
               </CD>
          </Items>
          <Shipping>
               <Method>1</Method> 
               <FirstName>Joe</FirstName> 
               <LastName>Consumer</LastName> 
               <Company>ABC Corporation</Company> 
               <Addr1>2295 Customer Way</Addr1> 
               <Addr2>Suite 100</Addr2> 
               <City>NoWhere</City> 
               <State>GA</State> 
               <Province></Province> 
               <Country>US</Country> 
               <Zip>30155</Zip> 
               <Email>email@thenet.com</Email> 
               <Phone>(800) 555-6699</Phone> 
          </Shipping>
     </Order>
</SwiftCDOrders>

Reserved XML characters - Please be sure to encode ("escape") reserved XML characters if you need to send them in your order.  

Character	Name	Escape Code
<	less -than	&lt;
>	greater-than	&gt;
&	ampersand	&amp;
'	single -quote	&apos;
"	double-quote	&quot;

Submitting Your HTTP Post Batch to SwiftCD

After creating your SwiftCDOrders batch you can submit the batch to SwiftCD using a Standard HTTP Posting Method. The web service is available at http://www.swiftcd.com/Orders/SubmitOrders.asp

An excellent XML help document can be found here.

To send test orders, replace <Order> with <Order Test="Y" >  You will receive live responses to your HTTP post, but the order will not actually enter our production stream.

IMPORTANT:  Before you will be able to send HTTP Post orders, we must authorize your IP.  Please send us a message here, and let us know your CustomerID and the IP that you will be using to send HTTP Post orders.  If your IP is inactive for three months (no orders received for three months), we will remove your IP from the access list.  If you find that you are denied access, please let us know if you would like your IP reactivated.

Sample Code

Visual Basic and Active Server Pages Example

Function PostOrdersToSwiftCD()
Dim xmlDoc
Dim xmlHTTP 
Dim ConfirmationXML
Set xmlDoc = CreateObject("Microsoft.XMLDOM")
xmlDoc.async = False
xmlDoc.Load “C:\SwiftCDOrders.XML”
Set xmlHTTP = CreateObject("Microsoft.XMLHttp") 
xmlHTTP.Open "POST", “http://www.swiftcd.com/Orders/SubmitOrders.asp”, False 
xmlHTTP.send xmlDoc.xml 
ConfirmationXML = xmlHTTP.responseXML.xml 
Set xmlDoc = Nothing 
Set xmlHTTP = Nothing

End Function

Sample Perl Script (click here)

Sample PHP Script (click here)

Note to Linux Users:

Our server requires DOS line endings.  If you are getting a Bad Request error, before you send data, you may want to replace every instance of  "\n" with "\r\n"

Confirmation Response

After transmitting your HTTP Post batch to SwiftCD you will receive a response XML string that will contain the following:

<SwiftCDBatchResult>
<Success>Y</Success>
<Errors></Errors>
<TotalOrders>1</TotalOrders>
<TotalItems>2</TotalItems>
</SwiftCDBatchResult>

Response Element Descriptions
Success = “Y” or “N”
Errors = List of problems with the transmission
TotalOrders = Total count of Orders Element in transmission
TotalItems = Total count of CD Element in transmission

If Success = “Y” then you have successfully transmitted your orders to SwiftCD. If Success=”N” then please correct the errors specified in the <Errors> element.  The following is a list of the conditions that will cause an error:

Missing <TrackingId>
Missing <CustomerId>
Missing <LabelId>
Missing <PackageId>
Missing <Quantity>
Missing <ProductId>
Missing <FirstName>
Missing <Addr1>
Missing <City>
If country is US, missing or invalid <State>
Missing or invalid <Country>
Missing <Zip>

Could Not Load XML Error or XML Parsing Errors
Recommended Steps To Resolve XML Transmission and Parsing Errors

1. Calling code must send xml in form part of http post per RFC 1867 ( http://www.w3.org/TR/device-upload ) .

2. Check for Reserved XML Characters  ( see Reserved Characters listed above. )

3. If you are running on Linux check for line endings.  Our server requires DOS line endings.  Replace every instance of "\n" with "\r\n".

4. Check your HTTP protocol being used ( 1.0 or 1.1 ) ( http://www.w3.org/Protocols/ ). Our server uses HTTP 1.1 protocol.

5. Compare your calling source code to the working examples listed on this page.

Order Tracking
XML Orders are loaded into our system every 30 minutes. If you cannot track your order 30 minutes after transmitting your xml please verify the <Order><CustomerId> element contains your SwiftCD customerid/vendor login. If it does not match please correct your xml file and transmit again.

Questions?  Please ask them here.