As a software or web site developer tasked with integrating CalcXML's calculator engines with your desktop or web applications, you need to have at your fingertips all the right documentation to get your job done quickly and accurately. Well, you've come to the right place!
Below you'll find links to all the documents, API documentation, and samples that are needed to make the integration a simple one. As always, we are interested in your feedback, so if you encounter problems or have suggestions on how we could improve the integration experience, please let us know.
You can integrate with CalcXML's calculators in several different ways:
CalcXML calculators are available as hyperlinks which you place on your web site. When clicked, these calculator hyperlinks can open in:
You can see examples of these different implementation options by looking at our Customer Success page.
You can control the look-and-feel of the calculator input and result pages using a css stylesheet file. We provide our base stylesheet and you can modify it as much as you like. Once you are happy with it, we'll load it up on our servers and use it for all of your hyperlinked calculators. You can also host the stylesheet on your own servers if desired and make changes to it whenever needed without having to get our support team involved. NOTE: Our support team typically gets stylesheet changes done within a 24-hour period. You can also have your company logo appear on the calculator pages.
The embedded calculator works by making an AJAX call, which then loads the desired calculator into a <div>. To place an embedded calculator on your site, add the embed code where you want the calculator to appear. Here is a sample of the embed code:
Integrating with Facebook requires the use of our Facebook app. This allows you to add a page tab to your Facebook page. To add our app to your page, use this link: https://www.facebook.com/dialog/pagetab?app_id=662673750485391&redirect_uri=https://www.calcxml.com/calculators/facebookConverter. To complete the integration, we will need the page ID of your page. To retrieve your page ID, log in to the admin account for your Facebook page. On the Pages section, click on your page. When it loads, the URL in your browser will have a number at the end. For example, https://www.facebook.com/pages/CalcXML/161488132854. That number is your page ID. Once we have that number, we can enable the calculator or multiple calculators for your Facebook page. Page admins can also set a name and image for the app.
The real strength of CalcXML's calculators is the fact that they are available as web services, giving you complete control over every aspect of the user interface. You create and host the calculator input and result pages. If desired, you can store user entered data, gather traffic statistics, gather lead generation data, or whatever else you like. You are in control.
You will need an IT staff in order to integrate using our web services, but rest assured, the integration is still quite simple for those familiar with web services. The documentation that follows will give you everything you need to have a successful web service integration.
CalcXML's calculators are divided up into 13 categories. Each calculator has unique input parameters. This web-based API documentation lets you see the details behind every calculator, providing helpful documentation and links to all relevant schemas for each calculator.
REST API documentation - Each calculator is represented in the API documents. Sample URL, requests and parameters are shown. Both JSON and XML are supported data transfer options.
CalcXML calculators can be used in any country and language. By passing in a country code and language, you tell the CalcXML calculator engine how to format the monetary amounts which will be returned. The Flash and image charts that are created are also formatted appropriately, including chart title and axis labels.
This functionality is available when integrating via web services as well as when integrating via hyperlinks. As described above, web services gives you the ability to create and host the calculator pages while hyperlinks provides a quicker time to market.
Language Codes Use the ISO 639-1 alpha-2 codes.
Country Codes Use the ISO 3166-1 alpha-2 codes.