The Perl Advent Calendar needs more articles for 2022. Submit your idea today!

NAME

WebService::Avalara::AvaTax::Service::Tax - Avalara AvaTax tax engine service via SOAP

VERSION

version 0.020

SYNOPSIS

    use WebService::Avalara::AvaTax::Service::Tax;

    my $avatax = WebService::Avalara::AvaTax::Service::Tax->new(
        username => 'avalara@example.com',
        password => 'sekrit',
    );
    my ( $answer_ref, $trace ) = $avatax->call('Ping');

DESCRIPTION

This class implements basic support for the Avalara AvaTax (http://developer.avalara.com/api-docs/soap) tax engine service using SOAP. Most of its mechanics are in WebService::Avalara::AvaTax::Role::Connection, with defaults for certain attributes as listed below.

ATTRIBUTES

uri

The URI of the WSDL file used to define the web service. Defaults to /tax/taxsvc.wsdl, with the URI base either https://avatax.avalara.net/ if is_production returns true, or https://development.avalara.net/ if it returns false.

Note that if use_wss is false, the alternate security WSDL file /tax/taxsvcaltsec.wsdl will be used instead.

port

The SOAP port identifier (not to be confused with the TCP/IP port) used in the WSDL file at "uri". Defaults to AddressSvcSoap.

service

The SOAP service name used in the WSDL file at "uri". Defaults to AddressSvc.

WORKAROUNDS FOR INCORRECT AVALARA RESPONSES

As of this writing the Avalara SOAP API returns responses that are inconsistent with the WSDL document provided. Specifically, the TaxIncluded and GeocodeType fields in the GetTaxResponse are wrongly placed in their sequences of fields. This module adds an overlay to the Avalara tax service WSDL file that attempts to work around these problems so that the responses may be successfully parsed.

SUPPORT

Perldoc

You can find documentation for this module with the perldoc command.

  perldoc WebService::Avalara::AvaTax

Websites

The following websites have more information about this module, and may be of help to you. As always, in addition to those websites please use your favorite search engine to discover more resources.

Bugs / Feature Requests

Please report any bugs or feature requests through the web interface at https://github.com/mjgardner/WebService-Avalara-AvaTax/issues. You will be automatically notified of any progress on the request by the system.

Source Code

The code is open to the world, and available for you to hack on. Please feel free to browse it and play with it, or whatever. If you want to contribute patches, please send me a diff or prod me to pull from your repository :)

https://github.com/mjgardner/WebService-Avalara-AvaTax

  git clone git://github.com/mjgardner/WebService-Avalara-AvaTax.git

AUTHOR

Mark Gardner <mjgardner@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2016 by ZipRecruiter.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.