GetTaxDetailByKey

Description

Retrieves a single tax detail object based on the key value supplied.

Parameters

Parameter	Type	Description
key	TaxDetailKey	The tax detail key object that specifies the tax detail to retrieve.
context	Context	Specifies information about how the method will be called.

Return Value:

Value	Type	Description
GetTaxDetailByKeyResult	TaxDetail	A tax detail object.

Interfaces

• Dynamics GP
• Common

Examples

The following C# example retrieves the tax detail object with the tax detail Id value "CANGST+PS7N0". The description is displayed in a message box.

** Legacy endpoint**

using System;
using System.Collections.Generic;
using System.Text;
using System.Windows.Forms;
using DynamicsGPWebServiceSample.DynamicsGPService;

namespace DynamicsGPWebServiceSample
{
    class Program
    {
        static void Main(string[] args)
        {
            CompanyKey companyKey;
            Context context;
            TaxDetail taxDetail;
            TaxDetailKey taxDetailKey;

            // Create an instance of the service
            DynamicsGP wsDynamicsGP = new DynamicsGP();

            // Be sure that default credentials are being used
            wsDynamicsGP.UseDefaultCredentials = true;

            // Create a context with which to call the service
            context = new Context();

            // Specify which company to use (sample company)
            companyKey = new CompanyKey();
            companyKey.Id = (-1);

            // Set up the context
            context.OrganizationKey = (OrganizationKey)companyKey;

            // Create a tax detail key
            taxDetailKey = new TaxDetailKey();
            taxDetailKey.Id = "CANGST+PS7N0";

            // Get the tax detail object
            taxDetail = wsDynamicsGP.GetTaxDetailByKey(taxDetailKey, context);

            // Display the description for the tax detail
            MessageBox.Show("Description: " + taxDetail.TaxDetailDescription);
        }
    }
}

** Native endpoint **

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.ServiceModel;
using System.Windows.Forms;
using DynamicsGPWebServiceSample.DynamicsGPService;

namespace DynamicsGPWebServiceSample
{
    class Program
    {
        static void Main(string[] args)
        {
            CompanyKey companyKey;
            Context context;
            TaxDetail taxDetail;
            TaxDetailKey taxDetailKey;

            // Create an instance of the service
            DynamicsGPClient wsDynamicsGP = new DynamicsGPClient();

            // Create a context with which to call the service
            context = new Context();

            // Specify which company to use (sample company)
            companyKey = new CompanyKey();
            companyKey.Id = (-1);

            // Set up the context object
            context.OrganizationKey = (OrganizationKey)companyKey;

            // Create a tax detail key
            taxDetailKey = new TaxDetailKey();
            taxDetailKey.Id = "CANGST+PS7N0";

            // Get the tax detauk object
            taxDetail = wsDynamicsGP.GetTaxDetailByKey(taxDetailKey, context);

            // Display the description for the tax detail
            MessageBox.Show("Description: " + taxDetail.TaxDetailDescription);

            // Close the service
            if (wsDynamicsGP.State != CommunicationState.Faulted)
            {
                wsDynamicsGP.Close();
            }
        }
    }
}