Home Page
Services & Technology Sign Up Now! Vendor/Customer Login About SwiftCD Contact Us
 

 

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>
               <FulfillmentItem>
                    <TrackingId>20010307-860-2</TrackingId> 
                    <ProductId>Gadget #1</ProductId>
                    <Title>My Gadget</Title> 
                    <Quantity>1</Quantity> 
               </FulfillmentItem>
          </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;

Element

Level

Description

Multiple Occurrences?

Parent Element

Required

SwiftCDOrders

0

Root node for a batch of orders. 
CreateDt = Date Batch Created
BatchId = Unique Identifier for this batch
SubmitterId = Your CustomerId unless told otherwise by SwiftCD
ContactInfo = Email address or phone # of person(s) sending batch

1 per Transmission

Root

Yes

Order

1

Identifies 1 order for a given purchase

Unlimited per Batch

SwiftCDOrders

Yes

CustomerId

2

Your CustomerId/Logon created when you signed up for SwiftCD services

1 per order

Order

Yes

TransactionDate

2

Date and time this order transaction occurred.  This is for your reference only, translates to OrderDate in OrderStatus.
Format:  mm/dd/ccyy hh:mm:ss AM/PM

1 per order

Order

Yes

Items

2

Identifies Grouping for Products Ordered

1 per order

Order

Yes

CD

3

Identifies the Item as a CD

Unlimited per Items

Items

Yes

Fulfillment Item

3

Identifies the Item as a non-CD fulfillment item

Unlimited per Items

Items

Yes

TrackingId

1

Your unique tracking Id Number for this order.  This number is designated by you, and will be used for all tracking and reporting for this order.  We suggest a number which includes Date, Product ID, and a serial number.  Example:  20010115-34565-1  NOTE:  Items with the same TrackingId will be shipped together in one package.  If you want multiple items shipped together, be sure they have the same TrackingId

1 per CD/fulfillment item

Order

Yes

LabelId

4

Label Id for this CD as previously defined in the SwiftCD Vendor Area – Design CDs

1 per CD

CD

Yes

PackageId

4

Package Id for this CD as previously defined in the SwiftCD Vendor Area – Design CDs

1 per CD

CD

Yes

Mailer

4

Used only for printing on lightweight dynamic mailers

1 per CD

CD

No

Text

5

Text fields for printing on lightweight dynamic mailers

1 per Mailer

Mailer

No

Line

6

Text for printing on lightweight mailers.  Maximum 35 characters per Line, maximum 6 Lines.  Blank Line tag = blank printed line on mailer.

6 per Text

Mailer

No

Quantity

4

The number of copies ordered of this CD in this order

1 per CD/fulfillment item

CD

Yes

RegKeyTitle

4

Line 1 of the registration label.  Example: Unlock Code (maximum 60 characters per line)  Note:  #|# (pound-pipe-pound) will create a line feed on the printed label, maximum one line feed per entry.

1 per CD

CD

No

RegKey

4

Line 2 of the registration label. Example: 12345  (maximum 60 characters per line)  Note:  #|# (pound-pipe-pound) will create a line feed on the printed label, maximum one line feed per entry.

1 per CD

CD

No

RegFileName

4

Software registration file, written to root of CD

1 per CD

CD

No

RegFileContent

4

Text content of registration file, may include line feeds, maximum 5000 characters

1 per CD

CD

No

Content

4

Identifies the definition of content on the CD

1 per CD

CD

Yes

Product

5

Identifies a content item as Product

Unlimited per Content up to maximum storage capacity of CD, *or* 1 per fulfillment item

Content

Yes

ProductId

6

ProductId (PID) identifying product to SwiftCD (must be unique per CD)

1 per Product

Product

Yes

Title

6

Title of product.  If you have chosen this option in your label configuration, this text will be written on the CD at the time of production.  Used for CDs containing a single PID.

1 per Product

Product

No

Shipping

2

Identifies the product shipping information.

1 per Order

Order

Yes

Method

3

1=USPS First Class/Air Mail  
3=USPS Priority/Global Priority Mail
4=
UPS Ground (US only)
5=
UPS NextDay Air (US only)
6=
UPS WorldwideExpress
7=
UPS 2nd Day Air (US only)
8=UPS 3rd Day Air (US only)

1 per Shipping

Shipping

No

FirstName

3

FirstName of person to ship order to

1 per Shipping

Shipping

Yes

LastName

3

LastName of person to ship order to

1 per Shipping

Shipping

No

Company

3

Company name to ship order to

1 per Shipping

Shipping

No

Addr1

3

Street address to ship order to

1 per Shipping

Shipping

Yes

Addr2

3

Suite or Apartment Number of shipping address

1 per Shipping

Shipping

No

City

3

City of shipping address

1 per Shipping

Shipping

Yes

State

3

State Abbreviation, required if Country is US.
http://www.swiftcd.com/faq/State_codes.txt

1 per Shipping

Shipping

Yes

Province

3

Province if Country is not US, required if country is Canada.
http://www.swiftcd.com/faq/Canadian_provinces.txt

1 per Shipping