TaxCloud Web Service Base Documentation

Click here for a complete list of operations.

LookupWithRate

Determine applicable sales or use tax for items being purchased.

SOAP 1.1

The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /TaxCloud.asmx HTTP/1.1
Host: api.taxcloud.com
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://taxcloud.net/LookupWithRate"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <LookupWithRate xmlns="http://taxcloud.net">
      <apiLoginID>string</apiLoginID>
      <apiKey>string</apiKey>
      <customerID>string</customerID>
      <cartID>string</cartID>
      <cartItems>
        <CartItem>
          <Index>int</Index>
          <ItemID>string</ItemID>
          <TIC>int</TIC>
          <Price>double</Price>
          <Qty>float</Qty>
          <Tax>string</Tax>
        </CartItem>
        <CartItem>
          <Index>int</Index>
          <ItemID>string</ItemID>
          <TIC>int</TIC>
          <Price>double</Price>
          <Qty>float</Qty>
          <Tax>string</Tax>
        </CartItem>
      </cartItems>
      <origin>
        <Address1>string</Address1>
        <Address2>string</Address2>
        <City>string</City>
        <State>string</State>
        <Zip5>string</Zip5>
        <Zip4>string</Zip4>
      </origin>
      <destination>
        <Address1>string</Address1>
        <Address2>string</Address2>
        <City>string</City>
        <State>string</State>
        <Zip5>string</Zip5>
        <Zip4>string</Zip4>
      </destination>
      <exemptCert>
        <CertificateID>string</CertificateID>
        <Detail>
          <ExemptStates>
            <ExemptState xsi:nil="true" />
            <ExemptState xsi:nil="true" />
          </ExemptStates>
          <SinglePurchase>boolean</SinglePurchase>
          <SinglePurchaseOrderNumber>string</SinglePurchaseOrderNumber>
          <PurchaserFirstName>string</PurchaserFirstName>
          <PurchaserLastName>string</PurchaserLastName>
          <PurchaserTitle>string</PurchaserTitle>
          <PurchaserAddress1>string</PurchaserAddress1>
          <PurchaserAddress2>string</PurchaserAddress2>
          <PurchaserCity>string</PurchaserCity>
          <PurchaserState>string</PurchaserState>
          <PurchaserZip>string</PurchaserZip>
          <PurchaserTaxID>
            <TaxType>string</TaxType>
            <IDNumber>string</IDNumber>
            <StateOfIssue>string</StateOfIssue>
          </PurchaserTaxID>
          <PurchaserBusinessType>string</PurchaserBusinessType>
          <PurchaserBusinessTypeOtherValue>string</PurchaserBusinessTypeOtherValue>
          <PurchaserExemptionReason>string</PurchaserExemptionReason>
          <PurchaserExemptionReasonValue>string</PurchaserExemptionReasonValue>
          <CreatedDate>dateTime</CreatedDate>
        </Detail>
      </exemptCert>
      <deliveredBySeller>boolean</deliveredBySeller>
    </LookupWithRate>
  </soap:Body>
</soap:Envelope>

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <LookupWithRateResponse xmlns="http://taxcloud.net">
      <LookupWithRateResult>
        <CartID>string</CartID>
        <CartItemsRateResponse>
          <CartItemRateResponse>
            <CartItemIndex>int</CartItemIndex>
            <TaxAmount>float</TaxAmount>
            <Rate>string</Rate>
          </CartItemRateResponse>
          <CartItemRateResponse>
            <CartItemIndex>int</CartItemIndex>
            <TaxAmount>float</TaxAmount>
            <Rate>string</Rate>
          </CartItemRateResponse>
        </CartItemsRateResponse>
        <SalesTaxRates>
          <description>string</description>
          <FIPSCode1>string</FIPSCode1>
          <FIPSRate1>decimal</FIPSRate1>
          <FIPSCode2>string</FIPSCode2>
          <FIPSRate2>decimal</FIPSRate2>
          <FIPSCode3>string</FIPSCode3>
          <FIPSRate3>decimal</FIPSRate3>
          <FIPSCode4>string</FIPSCode4>
          <FIPSRate4>decimal</FIPSRate4>
          <FIPSCode5>string</FIPSCode5>
          <FIPSRate5>decimal</FIPSRate5>
          <FIPSCode6>string</FIPSCode6>
          <FIPSRate6>decimal</FIPSRate6>
          <FIPSCode7>string</FIPSCode7>
          <FIPSRate7>decimal</FIPSRate7>
          <FIPSCode8>string</FIPSCode8>
          <FIPSRate8>decimal</FIPSRate8>
          <FIPSCode9>string</FIPSCode9>
          <FIPSRate9>decimal</FIPSRate9>
          <FIPSCode10>string</FIPSCode10>
          <FIPSRate10>decimal</FIPSRate10>
          <FIPSCode11>string</FIPSCode11>
          <FIPSRate11>decimal</FIPSRate11>
          <FIPSCode12>string</FIPSCode12>
          <FIPSRate12>decimal</FIPSRate12>
          <FIPSCode13>string</FIPSCode13>
          <FIPSRate13>decimal</FIPSRate13>
          <FIPSCode14>string</FIPSCode14>
          <FIPSRate14>decimal</FIPSRate14>
          <FIPSCode15>string</FIPSCode15>
          <FIPSRate15>decimal</FIPSRate15>
          <FIPSCode16>string</FIPSCode16>
          <FIPSRate16>decimal</FIPSRate16>
          <FIPSCode17>string</FIPSCode17>
          <FIPSRate17>decimal</FIPSRate17>
          <FIPSCode18>string</FIPSCode18>
          <FIPSRate18>decimal</FIPSRate18>
          <FIPSCode19>string</FIPSCode19>
          <FIPSRate19>decimal</FIPSRate19>
          <FIPSCode20>string</FIPSCode20>
          <FIPSRate20>decimal</FIPSRate20>
        </SalesTaxRates>
      </LookupWithRateResult>
    </LookupWithRateResponse>
  </soap:Body>
</soap:Envelope>

SOAP 1.2

The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /TaxCloud.asmx HTTP/1.1
Host: api.taxcloud.com
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <LookupWithRate xmlns="http://taxcloud.net">
      <apiLoginID>string</apiLoginID>
      <apiKey>string</apiKey>
      <customerID>string</customerID>
      <cartID>string</cartID>
      <cartItems>
        <CartItem>
          <Index>int</Index>
          <ItemID>string</ItemID>
          <TIC>int</TIC>
          <Price>double</Price>
          <Qty>float</Qty>
          <Tax>string</Tax>
        </CartItem>
        <CartItem>
          <Index>int</Index>
          <ItemID>string</ItemID>
          <TIC>int</TIC>
          <Price>double</Price>
          <Qty>float</Qty>
          <Tax>string</Tax>
        </CartItem>
      </cartItems>
      <origin>
        <Address1>string</Address1>
        <Address2>string</Address2>
        <City>string</City>
        <State>string</State>
        <Zip5>string</Zip5>
        <Zip4>string</Zip4>
      </origin>
      <destination>
        <Address1>string</Address1>
        <Address2>string</Address2>
        <City>string</City>
        <State>string</State>
        <Zip5>string</Zip5>
        <Zip4>string</Zip4>
      </destination>
      <exemptCert>
        <CertificateID>string</CertificateID>
        <Detail>
          <ExemptStates>
            <ExemptState xsi:nil="true" />
            <ExemptState xsi:nil="true" />
          </ExemptStates>
          <SinglePurchase>boolean</SinglePurchase>
          <SinglePurchaseOrderNumber>string</SinglePurchaseOrderNumber>
          <PurchaserFirstName>string</PurchaserFirstName>
          <PurchaserLastName>string</PurchaserLastName>
          <PurchaserTitle>string</PurchaserTitle>
          <PurchaserAddress1>string</PurchaserAddress1>
          <PurchaserAddress2>string</PurchaserAddress2>
          <PurchaserCity>string</PurchaserCity>
          <PurchaserState>string</PurchaserState>
          <PurchaserZip>string</PurchaserZip>
          <PurchaserTaxID>
            <TaxType>string</TaxType>
            <IDNumber>string</IDNumber>
            <StateOfIssue>string</StateOfIssue>
          </PurchaserTaxID>
          <PurchaserBusinessType>string</PurchaserBusinessType>
          <PurchaserBusinessTypeOtherValue>string</PurchaserBusinessTypeOtherValue>
          <PurchaserExemptionReason>string</PurchaserExemptionReason>
          <PurchaserExemptionReasonValue>string</PurchaserExemptionReasonValue>
          <CreatedDate>dateTime</CreatedDate>
        </Detail>
      </exemptCert>
      <deliveredBySeller>boolean</deliveredBySeller>
    </LookupWithRate>
  </soap12:Body>
</soap12:Envelope>

HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <LookupWithRateResponse xmlns="http://taxcloud.net">
      <LookupWithRateResult>
        <CartID>string</CartID>
        <CartItemsRateResponse>
          <CartItemRateResponse>
            <CartItemIndex>int</CartItemIndex>
            <TaxAmount>float</TaxAmount>
            <Rate>string</Rate>
          </CartItemRateResponse>
          <CartItemRateResponse>
            <CartItemIndex>int</CartItemIndex>
            <TaxAmount>float</TaxAmount>
            <Rate>string</Rate>
          </CartItemRateResponse>
        </CartItemsRateResponse>
        <SalesTaxRates>
          <description>string</description>
          <FIPSCode1>string</FIPSCode1>
          <FIPSRate1>decimal</FIPSRate1>
          <FIPSCode2>string</FIPSCode2>
          <FIPSRate2>decimal</FIPSRate2>
          <FIPSCode3>string</FIPSCode3>
          <FIPSRate3>decimal</FIPSRate3>
          <FIPSCode4>string</FIPSCode4>
          <FIPSRate4>decimal</FIPSRate4>
          <FIPSCode5>string</FIPSCode5>
          <FIPSRate5>decimal</FIPSRate5>
          <FIPSCode6>string</FIPSCode6>
          <FIPSRate6>decimal</FIPSRate6>
          <FIPSCode7>string</FIPSCode7>
          <FIPSRate7>decimal</FIPSRate7>
          <FIPSCode8>string</FIPSCode8>
          <FIPSRate8>decimal</FIPSRate8>
          <FIPSCode9>string</FIPSCode9>
          <FIPSRate9>decimal</FIPSRate9>
          <FIPSCode10>string</FIPSCode10>
          <FIPSRate10>decimal</FIPSRate10>
          <FIPSCode11>string</FIPSCode11>
          <FIPSRate11>decimal</FIPSRate11>
          <FIPSCode12>string</FIPSCode12>
          <FIPSRate12>decimal</FIPSRate12>
          <FIPSCode13>string</FIPSCode13>
          <FIPSRate13>decimal</FIPSRate13>
          <FIPSCode14>string</FIPSCode14>
          <FIPSRate14>decimal</FIPSRate14>
          <FIPSCode15>string</FIPSCode15>
          <FIPSRate15>decimal</FIPSRate15>
          <FIPSCode16>string</FIPSCode16>
          <FIPSRate16>decimal</FIPSRate16>
          <FIPSCode17>string</FIPSCode17>
          <FIPSRate17>decimal</FIPSRate17>
          <FIPSCode18>string</FIPSCode18>
          <FIPSRate18>decimal</FIPSRate18>
          <FIPSCode19>string</FIPSCode19>
          <FIPSRate19>decimal</FIPSRate19>
          <FIPSCode20>string</FIPSCode20>
          <FIPSRate20>decimal</FIPSRate20>
        </SalesTaxRates>
      </LookupWithRateResult>
    </LookupWithRateResponse>
  </soap12:Body>
</soap12:Envelope>