You can connect your Yahoo! Store to your own real-time tax and shipping calculation system over the Internet.

When a customer is about to place an order in your store, the system will call a CGI script which you specify. The available information about the order (which will include shipping address and the list of items) will be sent to the CGI script in the Yahoo! Order Format. The script should return two numeric values in the HTTP response headers: Tax-Charge and Shipping-Charge.

If the script returns HTTP headers Tax-Error or Shipping-Error, the value of this field will be displayed in an error message to the customer. For instance, if you return Shipping-Error: Cannot Ship UPS to Guam, the customer will be notified and will have to choose another shipping method. Please see the "Setting up a real-time script" section below, for important notes about the information your script should extract.

1. From the Store Manager, click the Tax Rates link.
2. Click the edit link next to Tax Setting.
3. Select the real-time tax configuration option and click Submit.
4. Enter the URL to your real-time script in the Configuration URL field.
5. Click Done.
6. Return to the Store Manager and publish your order settings.

Setting up a real-time script

Your scripts should be designed to extract required information, and only return errors for required keys when information is not available, or is invalid. Software on the receiving end should be set up to ignore unrecognized keys.

Here's an example script which you can modify.

We will add new keys to this format as required to support new features.

Note: If you require firewall restrictions on access to your web server, add the IP ranges for real-time integrations.