JSONService Web Service

JSONService

Click here for a complete list of operations.

CalculateTax

Primary Taxify API method. Used to calculate Tax on a shopping cart, purchase order, sales order, invoice, refund or return. Method can be called in IsCommitted=false mode for transient operations, or in IsCommitted=true mode for final transaction (to be filed).

Test

The test form is only available for requests from the local machine.

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 /Services/1.0/core/JSONService.asmx HTTP/1.1
Host: ws.taxify.co
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://taxify.co/CalculateTax"

<?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>
    <CalculateTax xmlns="http://taxify.co/">
      <CalculateTax>
        <DocumentKey>string</DocumentKey>
        <TaxDate>dateTime</TaxDate>
        <Lines>
          <TaxRequestLine>
            <LineNumber>string</LineNumber>
            <ItemKey>string</ItemKey>
            <ActualExtendedPrice>decimal</ActualExtendedPrice>
            <TaxIncludedInPrice>boolean</TaxIncludedInPrice>
            <Quantity>decimal</Quantity>
            <ItemDescription>string</ItemDescription>
            <ItemTaxabilityCode>string</ItemTaxabilityCode>
            <ItemCategories>string</ItemCategories>
            <ItemTags>string</ItemTags>
            <Options xsi:nil="true" />
          </TaxRequestLine>
          <TaxRequestLine>
            <LineNumber>string</LineNumber>
            <ItemKey>string</ItemKey>
            <ActualExtendedPrice>decimal</ActualExtendedPrice>
            <TaxIncludedInPrice>boolean</TaxIncludedInPrice>
            <Quantity>decimal</Quantity>
            <ItemDescription>string</ItemDescription>
            <ItemTaxabilityCode>string</ItemTaxabilityCode>
            <ItemCategories>string</ItemCategories>
            <ItemTags>string</ItemTags>
            <Options xsi:nil="true" />
          </TaxRequestLine>
        </Lines>
        <DestinationAddress>
          <FirstName>string</FirstName>
          <LastName>string</LastName>
          <Company>string</Company>
          <Street1>string</Street1>
          <Street2>string</Street2>
          <City>string</City>
          <Region>string</Region>
          <PostalCode>string</PostalCode>
          <Country>string</Country>
          <Email>string</Email>
          <Phone>string</Phone>
        </DestinationAddress>
        <OriginAddress>
          <FirstName>string</FirstName>
          <LastName>string</LastName>
          <Company>string</Company>
          <Street1>string</Street1>
          <Street2>string</Street2>
          <City>string</City>
          <Region>string</Region>
          <PostalCode>string</PostalCode>
          <Country>string</Country>
          <Email>string</Email>
          <Phone>string</Phone>
        </OriginAddress>
        <IsCommited>boolean</IsCommited>
        <CustomerKey>string</CustomerKey>
        <CustomerTaxabilityCode>string</CustomerTaxabilityCode>
        <CustomerRegistrationNumber>string</CustomerRegistrationNumber>
        <Tags>
          <string>string</string>
          <string>string</string>
        </Tags>
        <Options>
          <TaxRequestOption>
            <Key>string</Key>
            <Value>string</Value>
          </TaxRequestOption>
          <TaxRequestOption>
            <Key>string</Key>
            <Value>string</Value>
          </TaxRequestOption>
        </Options>
        <Discounts>
          <Discount>
            <Order>int</Order>
            <Code>string</Code>
            <Amount>decimal</Amount>
            <DiscountType>string</DiscountType>
          </Discount>
          <Discount>
            <Order>int</Order>
            <Code>string</Code>
            <Amount>decimal</Amount>
            <DiscountType>string</DiscountType>
          </Discount>
        </Discounts>
        <OverrideTaxCollectedAmount>decimal</OverrideTaxCollectedAmount>
      </CalculateTax>
    </CalculateTax>
  </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>
    <CalculateTaxResponse xmlns="http://taxify.co/" />
  </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 /Services/1.0/core/JSONService.asmx HTTP/1.1
Host: ws.taxify.co
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>
    <CalculateTax xmlns="http://taxify.co/">
      <CalculateTax>
        <DocumentKey>string</DocumentKey>
        <TaxDate>dateTime</TaxDate>
        <Lines>
          <TaxRequestLine>
            <LineNumber>string</LineNumber>
            <ItemKey>string</ItemKey>
            <ActualExtendedPrice>decimal</ActualExtendedPrice>
            <TaxIncludedInPrice>boolean</TaxIncludedInPrice>
            <Quantity>decimal</Quantity>
            <ItemDescription>string</ItemDescription>
            <ItemTaxabilityCode>string</ItemTaxabilityCode>
            <ItemCategories>string</ItemCategories>
            <ItemTags>string</ItemTags>
            <Options xsi:nil="true" />
          </TaxRequestLine>
          <TaxRequestLine>
            <LineNumber>string</LineNumber>
            <ItemKey>string</ItemKey>
            <ActualExtendedPrice>decimal</ActualExtendedPrice>
            <TaxIncludedInPrice>boolean</TaxIncludedInPrice>
            <Quantity>decimal</Quantity>
            <ItemDescription>string</ItemDescription>
            <ItemTaxabilityCode>string</ItemTaxabilityCode>
            <ItemCategories>string</ItemCategories>
            <ItemTags>string</ItemTags>
            <Options xsi:nil="true" />
          </TaxRequestLine>
        </Lines>
        <DestinationAddress>
          <FirstName>string</FirstName>
          <LastName>string</LastName>
          <Company>string</Company>
          <Street1>string</Street1>
          <Street2>string</Street2>
          <City>string</City>
          <Region>string</Region>
          <PostalCode>string</PostalCode>
          <Country>string</Country>
          <Email>string</Email>
          <Phone>string</Phone>
        </DestinationAddress>
        <OriginAddress>
          <FirstName>string</FirstName>
          <LastName>string</LastName>
          <Company>string</Company>
          <Street1>string</Street1>
          <Street2>string</Street2>
          <City>string</City>
          <Region>string</Region>
          <PostalCode>string</PostalCode>
          <Country>string</Country>
          <Email>string</Email>
          <Phone>string</Phone>
        </OriginAddress>
        <IsCommited>boolean</IsCommited>
        <CustomerKey>string</CustomerKey>
        <CustomerTaxabilityCode>string</CustomerTaxabilityCode>
        <CustomerRegistrationNumber>string</CustomerRegistrationNumber>
        <Tags>
          <string>string</string>
          <string>string</string>
        </Tags>
        <Options>
          <TaxRequestOption>
            <Key>string</Key>
            <Value>string</Value>
          </TaxRequestOption>
          <TaxRequestOption>
            <Key>string</Key>
            <Value>string</Value>
          </TaxRequestOption>
        </Options>
        <Discounts>
          <Discount>
            <Order>int</Order>
            <Code>string</Code>
            <Amount>decimal</Amount>
            <DiscountType>string</DiscountType>
          </Discount>
          <Discount>
            <Order>int</Order>
            <Code>string</Code>
            <Amount>decimal</Amount>
            <DiscountType>string</DiscountType>
          </Discount>
        </Discounts>
        <OverrideTaxCollectedAmount>decimal</OverrideTaxCollectedAmount>
      </CalculateTax>
    </CalculateTax>
  </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>
    <CalculateTaxResponse xmlns="http://taxify.co/" />
  </soap12:Body>
</soap12:Envelope>