From 8535a86b618e1778e23cb1c336ca6c3b76d732b5 Mon Sep 17 00:00:00 2001 From: svc-developer Date: Tue, 30 Aug 2022 03:44:00 +0000 Subject: [PATCH] 22.8.0 --- src/Constants.php | 2137 ++++++++- src/Methods.php | 11258 ++++++++++++++++++++++---------------------- src/Models.php | 43 + 3 files changed, 7666 insertions(+), 5772 deletions(-) diff --git a/src/Constants.php b/src/Constants.php index 0a3c930..8281aef 100644 --- a/src/Constants.php +++ b/src/Constants.php @@ -28,52 +28,219 @@ class TransactionAddressType /** * Swagger Name: AvaTaxClient - * + * Casing to use for validation result */ class TextCase -{ const C_UPPER = 0; +{ + /** + * Upper case + */ + const C_UPPER = 0; + + /** + * Mixed Case + */ const C_MIXED = 1; } /** * Swagger Name: AvaTaxClient - * + * Represents the different types of transactions that AvaTax can process. */ class DocumentType -{ const C_SALESORDER = 0; +{ + /** + * Represents an estimate, or a sales order, or a quote. + * + * This document type is used before a sale has occurred to estimate the final amount of tax to be paid when the + * sale is completed. + * + * For a sales order, the `companyCode` of the transaction refers to the seller and the `customerVendorCode` refers to the buyer. + * + * This is a temporary document type and is not saved in tax history. + */ + const C_SALESORDER = 0; + + /** + * Represents a sale that has been finalized. + * + * This document type is used to record a final transaction and calculate the final tax amount with all necessary information. + * + * For a sales invoice, the `companyCode` of the transaction refers to the seller and the `customerVendorCode` refers to the buyer. + * + * This is a permanent document and is recorded in AvaTax. + */ const C_SALESINVOICE = 1; + + /** + * Represents an estimate, or a purchase order, or a quote. + * + * This document type is used before a sale has occurred to estimate the final amount of tax to be paid when the + * sale is completed. + * + * For a purchase order, the `companyCode` of the transaction refers to the buyer and the `customerVendorCode` refers to the seller. + * + * This is a temporary document type and is not saved in tax history. + */ const C_PURCHASEORDER = 2; + + /** + * Represents a sale that has been finalized. + * + * This document type is used to record a final transaction and calculate the final tax amount with all necessary information. + * + * For a purchase invoice, the `companyCode` of the transaction refers to the buyer and the `customerVendorCode` refers to the seller. + * + * This is a permanent document and is recorded in AvaTax. + */ const C_PURCHASEINVOICE = 3; + + /** + * Represents an estimate of tax to be refunded if a refund or return is processed. + * + * This document type is used before a customer chooses to request a refund for a previous sale, and it + * estimates the final amount of tax to be refunded when the refund is completed. + * + * For a return order, the `companyCode` of the transaction refers to the seller who is giving the refund + * and the `customerVendorCode` refers to the buyer who is requesting the refund. + * + * This is a temporary document type and is not saved in tax history. + */ const C_RETURNORDER = 4; + + /** + * Represents an refund that has been finalized. + * + * This document type is used when a customer chooses to request a refund for a previous sale, and it + * records the final amount of tax that has been refunded when the refund is completed. + * + * For a return invoice, the `companyCode` of the transaction refers to the seller who is giving the refund + * and the `customerVendorCode` refers to the buyer who is requesting the refund. + * + * This is a permanent document and is recorded in AvaTax. + * + * Please note that many jurisdictions around the United States have special rules about how to report refunds + * on a sales tax filing, and some refund transactions may be unable to file immediately due to credit netting + * rules. + */ const C_RETURNINVOICE = 5; + + /** + * Represents a proposed movement of inventory from one jurisdiction to another. + * + * This document type is used when physical goods are shipped from one jurisdiction to another, and it + * may cause updates in the tax liability for various jurisdictions. + * + * For an inventory transfer invoice, the `companyCode` of the transaction refers to the owner of the inventory + * that will be moved from one location to another. + * + * This is a temporary document type and is not saved in tax history. + */ const C_INVENTORYTRANSFERORDER = 6; + + /** + * Represents a movement of inventory from one jurisdiction to another that has been finalized. + * + * This document type is used when physical goods are shipped from one jurisdiction to another, and it + * may cause updates in the tax liability for various jurisdictions. + * + * For an inventory transfer invoice, the `companyCode` of the transaction refers to the owner of the inventory + * that will be moved from one location to another. + * + * This is a permanent document and is recorded in AvaTax. + */ const C_INVENTORYTRANSFERINVOICE = 7; + + /** + * Represents a VAT "Reverse Charge" mechanism transaction as defined in the European Union. + * + * A Reverse Charge transaction moves the responsibility for VAT reporting from the seller to the buyer, and + * is intended to allow simplification of commerce and reduce the reporting requirements for sellers that deliver + * goods and services into the single market. + * + * This is a temporary document type and is not saved in tax history. + */ const C_REVERSECHARGEORDER = 8; + + /** + * Represents a VAT "Reverse Charge" mechanism transaction as defined in the European Union. + * + * A Reverse Charge transaction moves the responsibility for VAT reporting from the seller to the buyer, and + * is intended to allow simplification of commerce and reduce the reporting requirements for sellers that deliver + * goods and services into the single market. + * + * This is a permanent document and is recorded in AvaTax. + */ const C_REVERSECHARGEINVOICE = 9; + + /** + * Represents a VAT "Customs Invoice". + * + * The user will enter this DocType with a TaxOverride when the VAT and ImportDuty are calculated by Customs at the border, + * and then these documents are entered later into AvaTax in order to create the balancing entries for VAT and Import Duty. + * + * This is a permanent document and is recorded in AvaTax. + */ const C_CUSTOMSINVOICE = 10; + + /** + * Represents a VAT "Customs Order". + * + * The user will enter this DocType with a TaxOverride when the VAT and ImportDuty are calculated by Customs at the border, + * and then these documents are entered later into AvaTax in order to create the balancing entries for VAT and Import Duty. + * + * This is a temporary document type and is not saved in tax history. + */ const C_CUSTOMSORDER = 11; + + /** + * Not a real document type. + * + * This value is used when querying for documents. You can specify the type `Any` in some cases to permit the + * system to find any document matching other criteria. + */ const C_ANY = -1; } /** * Swagger Name: AvaTaxClient - * + * Type of certificate preview to download */ class CertificatePreviewType -{ const C_PDF = 1; +{ + /** + * Download a full printable PDF + */ + const C_PDF = 1; + + /** + * Download a single page of the certificate in JPG format + */ const C_JPEG = 2; } /** * Swagger Name: AvaTaxClient - * + * Type of file request */ class PointOfSaleFileType -{ const C_JSON = 0; +{ + /** + * File is in Javascript Object Notation format + */ + const C_JSON = 0; + + /** + * File is in Comma Separated Values format + */ const C_CSV = 1; + + /** + * File is in Extended Markup Language format + */ const C_XML = 2; } @@ -93,7 +260,15 @@ class PointOfSalePartnerId * */ class UserDefinedFieldType -{ const C_DOCUMENT = 1; +{ + /** + * Represents document level user defined type. + */ + const C_DOCUMENT = 1; + + /** + * Represents line level user defined type. + */ const C_LINE = 2; } @@ -120,84 +295,246 @@ class POASubscriptionType const C_AVALODGING = 3; const C_MRSCOMPLIANCEMANAGER = 4; const C_AMRA = 5; + const C_MRSPREMIUM = 6; + const C_MRSPREMIER = 7; } /** * Swagger Name: AvaTaxClient - * + * Permission level of a user */ class SecurityRoleId -{ const C_NOACCESS = 0; +{ + /** + * NoAccess + */ + const C_NOACCESS = 0; + + /** + * SiteAdmin + */ const C_SITEADMIN = 1; + + /** + * AccountOperator + */ const C_ACCOUNTOPERATOR = 2; + + /** + * AccountAdmin + */ const C_ACCOUNTADMIN = 3; + + /** + * AccountUser + */ const C_ACCOUNTUSER = 4; + + /** + * SystemAdmin + */ const C_SYSTEMADMIN = 5; + + /** + * Registrar + */ const C_REGISTRAR = 6; + + /** + * CSPTester + */ const C_CSPTESTER = 7; + + /** + * CSPAdmin + */ const C_CSPADMIN = 8; + + /** + * SystemOperator + */ const C_SYSTEMOPERATOR = 9; + + /** + * TechnicalSupportUser + */ const C_TECHNICALSUPPORTUSER = 10; + + /** + * TechnicalSupportAdmin + */ const C_TECHNICALSUPPORTADMIN = 11; + + /** + * TreasuryUser + */ const C_TREASURYUSER = 12; + + /** + * TreasuryAdmin + */ const C_TREASURYADMIN = 13; + + /** + * ComplianceUser + */ const C_COMPLIANCEUSER = 14; + + /** + * ComplianceAdmin + */ const C_COMPLIANCEADMIN = 15; + + /** + * ProStoresOperator + */ const C_PROSTORESOPERATOR = 16; + + /** + * CompanyUser + */ const C_COMPANYUSER = 17; + + /** + * CompanyAdmin + */ const C_COMPANYADMIN = 18; + + /** + * ComplianceTempUser + */ const C_COMPLIANCETEMPUSER = 19; + + /** + * ComplianceRootUser + */ const C_COMPLIANCEROOTUSER = 20; + + /** + * ComplianceOperator + */ const C_COMPLIANCEOPERATOR = 21; + + /** + * SSTAdmin + */ const C_SSTADMIN = 22; + + /** + * FirmUser + */ const C_FIRMUSER = 23; + + /** + * FirmAdmin + */ const C_FIRMADMIN = 24; + + /** + * BatchServiceAdmin + */ + const C_BATCHSERVICEADMIN = 25; } /** * Swagger Name: AvaTaxClient - * + * PasswordStatusId */ class PasswordStatusId -{ const C_USERCANNOTCHANGE = 0; +{ + /** + * UserCannotChange + */ + const C_USERCANNOTCHANGE = 0; + + /** + * UserCanChange + */ const C_USERCANCHANGE = 1; + + /** + * UserMustChange + */ const C_USERMUSTCHANGE = 2; } /** * Swagger Name: AvaTaxClient - * + * Status of an Avalara account */ class AccountStatusId -{ const C_INACTIVE = 0; +{ + /** + * This account is not currently active. + */ + const C_INACTIVE = 0; + + /** + * This account is active and in use. + */ const C_ACTIVE = 1; + + /** + * This account is flagged as a test account and may be temporary. + */ const C_TEST = 2; + + /** + * The account is new and is currently in the onboarding process. + * + * An account is considered new until the account administrator has reviewed and accepted + * [Avalara's terms and conditions](https://www.avalara.com/us/en/legal/terms.html). + */ const C_NEW = 3; } /** * Swagger Name: AvaTaxClient - * + * Status of an Avalara account */ class AccountTypeId -{ const C_REGULAR = 1; +{ + /** + * Regular AvaTax account. + */ + const C_REGULAR = 1; + + /** + * Firm account. + */ const C_FIRM = 2; + + /** + * Client account created by firm. + */ const C_FIRMCLIENT = 3; } /** * Swagger Name: AvaTaxClient - * + * Represents a error code message */ class ErrorCodeId -{ const C_SERVERCONFIGURATION = 1; +{ + /** + * Server has a configuration or setup problem + */ + const C_SERVERCONFIGURATION = 1; + + /** + * User doesn't have rights to this account or company + */ const C_ACCOUNTINVALIDEXCEPTION = 2; const C_COMPANYINVALIDEXCEPTION = 3; + + /** + * Use this error message when the user is trying to fetch a single object and the object either does not exist or cannot be seen by the current user. + */ const C_ENTITYNOTFOUNDERROR = 4; const C_VALUEREQUIREDERROR = 5; const C_RANGEERROR = 6; @@ -342,6 +679,11 @@ class ErrorCodeId const C_INVALIDENTRY = 197; const C_TRANSACTIONALREADYCANCELLED = 198; const C_QUERYPARAMETEROUTOFRANGE = 199; + + /** + * Batch errors + * New batch error codes continue at 2501 + */ const C_BATCHSALESAUDITMUSTBEZIPPEDERROR = 200; const C_BATCHZIPMUSTCONTAINONEFILEERROR = 201; const C_BATCHINVALIDFILETYPEERROR = 202; @@ -351,10 +693,22 @@ class ErrorCodeId const C_BATCHMUSTCONTAINONEFILE = 206; const C_MISSINGBATCHFILECONTENT = 207; const C_BATCHCANNOTBEDELETEDWHILEPROCESSING = 208; + + /** + * BizTech error + */ const C_INTERNALSERVERERROR = 209; + + /** + * Point Of Sale API exceptions + */ const C_POINTOFSALEFILESIZE = 250; const C_POINTOFSALESETUP = 251; const C_INVALIDINPUTDATE = 252; + + /** + * Errors in Soap V1 Passthrough / GetTax calls + */ const C_GETTAXERROR = 300; const C_ADDRESSCONFLICTEXCEPTION = 301; const C_DOCUMENTCODECONFLICT = 303; @@ -369,11 +723,31 @@ class ErrorCodeId const C_INVALIDDOCUMENTTYPESTOFETCH = 315; const C_TIMEOUTREQUESTED = 316; const C_INVALIDPOSTALCODE = 317; + + /** + * Subscription error codes + */ const C_INVALIDSUBSCRIPTIONDESCRIPTION = 318; const C_INVALIDSUBSCRIPTIONTYPEID = 319; + + /** + * Represents a malformed document fetch command + */ const C_CANNOTCHANGEFILINGSTATUS = 401; + + /** + * Represents a FEIN in incorrect format. + */ const C_FEINFORMATERROR = 402; + + /** + * Represents a SQL server timeout error / deadlock error + */ const C_SERVERUNREACHABLE = 500; + + /** + * Partner API error codes + */ const C_SUBSCRIPTIONREQUIRED = 600; const C_ACCOUNTEXISTS = 601; const C_INVITATIONONLY = 602; @@ -388,6 +762,10 @@ class ErrorCodeId const C_USERALREADYEXIST = 613; const C_USERNOTFOUND = 614; const C_USERMANAGEMENTEXCEPTION = 615; + + /** + * Refund API error codes + */ const C_REFUNDTYPEANDPERCENTAGEMISMATCH = 701; const C_INVALIDDOCUMENTTYPEFORREFUND = 702; const C_REFUNDTYPEANDLINEMISMATCH = 703; @@ -397,13 +775,25 @@ class ErrorCodeId const C_LINENOOUTOFRANGE = 707; const C_REFUNDPERCENTAGEOUTOFRANGE = 708; const C_REFUNDPERCENTAGEMISSING = 709; + + /** + * Free API error codes + */ const C_MUSTUSECREATETRANSACTION = 800; const C_MUSTACCEPTTERMSANDCONDITIONS = 801; + + /** + * Filing Calendar Error Codes + */ const C_FILINGCALENDARCANNOTBEDELETED = 900; const C_INVALIDEFFECTIVEDATE = 901; const C_NONOUTLETFORM = 902; const C_OVERLAPPINGFILINGCALENDAR = 903; const C_FILINGCALENDARCANNOTBEEDITED = 904; + + /** + * Create or update transaction error codes + */ const C_CANNOTMODIFYLOCKEDTRANSACTION = 1100; const C_LINEALREADYEXISTS = 1101; const C_LINEDOESNOTEXIST = 1102; @@ -411,6 +801,10 @@ class ErrorCodeId const C_LINEDETAILSDOESNOTEXIST = 1104; const C_CANNOTCREATETRANSACTIONWITHDELETEDDATASOURCE = 1105; const C_SHIPTOREGIONREQUIREDWITHDATASOURCE = 1106; + + /** + * Exempt cert error codes + */ const C_INVALIDBUSINESSTYPE = 1200; const C_CANNOTMODIFYEXEMPTCERT = 1201; const C_CERTIFICATESERROR = 1203; @@ -432,6 +826,10 @@ class ErrorCodeId const C_BILLTOCUSTOMEREXPECTED = 1221; const C_SHIPTOCUSTOMEREXPECTED = 1222; const C_ECMSSSTCERTSREQUIRED = 1223; + + /** + * Multi document error codes + */ const C_TRANSACTIONNOTCANCELLED = 1300; const C_TOOMANYTRANSACTIONS = 1301; const C_ONLYTAXDATEOVERRIDEISALLOWED = 1302; @@ -444,9 +842,21 @@ class ErrorCodeId const C_MULTIDOCUMENTPARTIALLYLOCKED = 1312; const C_TRANSACTIONISCOMMITTED = 1313; const C_INVALIDDOCUMENTSTATUS = 1314; + + /** + * Communications Tax error codes + */ const C_COMMSCONFIGCLIENTIDMISSING = 1400; const C_COMMSCONFIGCLIENTIDBADVALUE = 1401; + + /** + * Account Activate error codes + */ const C_ACCOUNTINNEWSTATUSEXCEPTION = 1404; + + /** + * Worksheet Exception + */ const C_WORKSHEETEXCEPTION = 1405; const C_INVALIDACCOUNTOVERRIDE = 1406; const C_ACCOUNTOVERRIDENOTAUTHORIZED = 1407; @@ -454,14 +864,30 @@ class ErrorCodeId const C_USERNAMEREQUIRED = 1409; const C_INVALIDAUDITMESSAGE = 1410; const C_FIELDNOTORDERABLEERROR = 1411; + + /** + * Nexus validation error codes + */ const C_CANNOTDELETEPARENTBEFORECHILDNEXUS = 1500; const C_NEXUSCHILDDATEMISMATCH = 1501; + + /** + * Remote validation Error + */ const C_REMOTEVALIDATIONERROR = 1502; const C_CANNOTMODIFYSSTNEXUS = 1503; const C_INVALIDLOCALNEXUSTYPEID = 1504; + + /** + * Advanced rule errors + */ const C_ADVANCEDRULEREQUESTRULEERROR = 1602; const C_ADVANCEDRULERESPONSERULEERROR = 1603; const C_ADVANCEDRULEERROR = 1605; + + /** + * Miscellaneous + */ const C_TAXRULEREQUIRESNEXUS = 1701; const C_UPCCODENOTUNIQUE = 1702; const C_TAXCODEASSOCIATEDWITHITEMCODENOTFOUND = 1704; @@ -490,20 +916,45 @@ class ErrorCodeId const C_INVALIDRESTRICTIONTYPE = 1733; const C_INVALIDPARAMETER = 1734; const C_INVALIDSYSTEMCODE = 1735; + const C_NOITEMSFORCLASSIFICATION = 1736; + + /** + * SendSales API errors + */ const C_UNSUPPORTEDFILEFORMAT = 1800; const C_UNSUPPORTEDOUTPUTFILETYPE = 1801; + + /** + * TaxProfile API errors + */ const C_TAXPROFILENOTPROVIDED = 1900; const C_INVALIDTAXPROFILE = 1901; const C_COMPANYTAXPROFILEENTRYREQUIRED = 1902; const C_ERRORREADINGTAXPROFILEENTRY = 1903; + + /** + * AuditAccount API errors + */ const C_TRACEDATANOTAVAILABLE = 2000; + + /** + * Item and Nexus parameter errors + */ const C_INVALIDPARAMETERUNITMEASUREMENTTYPE = 2100; const C_PARAMETERUNITREQUIRED = 2101; const C_INVALIDPARAMETERVALUEDATATYPE = 2102; const C_INVALIDPARAMETERATTRIBUTETYPE = 2103; const C_SUBSCRIPTIONREQUIREDFORPARAMETER = 2104; + + /** + * Accounting Firm errors + */ const C_INVALIDACCOUNTTYPE = 2105; const C_INVALIDFIRMSUBSCRIPTIONS = 2106; + + /** + * Certify Company Errors + */ const C_GENERICTAXCODEFORITEM = 2200; const C_CANNOTCERTIFYCOMPANY = 2201; const C_NOVOIDEDDOCUMENTS = 2202; @@ -524,23 +975,60 @@ class ErrorCodeId const C_ALLUSCOUNTRYCODES = 2217; const C_NODOCUMENTSTOTEST = 2218; const C_NOSHIPPINGCHARGE = 2219; + + /** + * Company Controller Related Errors + */ const C_FAILEDTOUPDATECOMPANYLOCATION = 2314; const C_COMPANYLOCATIONDATERANGEOVERLAP = 2315; + + /** + * Generic validation errors + */ const C_FIELDLENGTHERROR = 2400; const C_INPUTCONTAINSBLACKLISTEDCHARACTERS = 2401; const C_CANNOTCREATENESTEDOBJECTS = 2402; + + /** + * User's SubjectId not updated by DB query + */ const C_USERSUBJECTIDNOTUPDATED = 2500; + + /** + * Batch errors + * For other batch errors, see: 200 - 208 above + */ const C_BATCHTRANSACTIONTYPEERROR = 2501; const C_BATCHTRANSACTIONLINELIMITEXCEEDED = 2502; const C_BATCHCOMPANYIDANDCOMPANYCODEMISMATCH = 2503; const C_BATCHCANNOTBECANCELLEDSTATUSERROR = 2504; const C_BATCHCANNOTBECANCELLEDFORMATERROR = 2505; const C_BATCHTYPENOTSUPPORTED = 2506; + + /** + * Parameter related errors + */ const C_INVALIDPARAMETERDATATYPE = 2600; + + /** + * Tags related error + */ const C_TAGDOESNOTEXIST = 2620; + + /** + * Object deleted message + */ const C_OBJECTDELETED = 2660; const C_ASSOCIATEDOBJECTSDELETED = 2661; + + /** + * Additional report related errors + */ const C_CANNOTDOWNLOADREPORT = 2700; + + /** + * AVT-10699 - Multi-tax custom Tax Rules (Phase 1) + */ const C_INVALIDUNITOFBASIS = 2800; const C_NOTAPPLICABLEUNITOFBASIS = 2801; const C_INVALIDRATETYPETAXTYPEMAPPING = 2802; @@ -558,162 +1046,508 @@ class ErrorCodeId /** * Swagger Name: AvaTaxClient - * + * Severity of message */ class SeverityLevel -{ const C_SUCCESS = 0; +{ + /** + * Operation succeeded + */ + const C_SUCCESS = 0; + + /** + * Warnings occured, operation succeeded + */ const C_WARNING = 1; + + /** + * Errors occured, operation failed + */ const C_ERROR = 2; + + /** + * Unexpected exceptions occurred, operation failed + */ const C_EXCEPTION = 3; } /** * Swagger Name: AvaTaxClient - * + * Jurisdiction Type */ class JurisdictionType -{ const C_COUNTRY = 0; +{ + /** + * Country + */ + const C_COUNTRY = 0; + + /** + * State + */ const C_STATE = 1; + + /** + * County + */ const C_COUNTY = 2; + + /** + * City + */ const C_CITY = 3; + + /** + * Special Tax Jurisdiction + */ const C_SPECIAL = 4; } /** * Swagger Name: AvaTaxClient - * + * The address resolution quality of an address validation result */ class ResolutionQuality -{ const C_NOTCODED = 0; +{ + /** + * Location was not geocoded + */ + const C_NOTCODED = 0; + + /** + * Location was already geocoded on the request + */ const C_EXTERNAL = 1; + + /** + * Avalara-defined country centroid + */ const C_COUNTRYCENTROID = 2; + + /** + * Avalara-defined state / province centroid + */ const C_REGIONCENTROID = 3; + + /** + * Geocoded at a level more coarse than a PostalCentroid1 + */ const C_PARTIALCENTROID = 4; + + /** + * Largest postal code (zip5 in US, left three in CA, etc + */ const C_POSTALCENTROIDGOOD = 5; + + /** + * Better postal code (zip7 in US) + */ const C_POSTALCENTROIDBETTER = 6; + + /** + * Best postal code (zip9 in US, complete postal code elsewhere) + */ const C_POSTALCENTROIDBEST = 7; + + /** + * Nearest intersection + */ const C_INTERSECTION = 8; + + /** + * Interpolated to rooftop + */ const C_INTERPOLATED = 9; + + /** + * Assumed to be rooftop level, non-interpolated + */ const C_ROOFTOP = 10; + + /** + * Pulled from a static list of geocodes for specific jurisdictions + */ const C_CONSTANT = 11; } /** * Swagger Name: AvaTaxClient - * + * Indicates whether this address refers to a person or an business */ class AddressTypeId -{ const C_LOCATION = 1; +{ + /** + * A business location, for example a store, warehouse, or office. + */ + const C_LOCATION = 1; + + /** + * A person's address who performs sales tasks for the company remotely from an office. + */ const C_SALESPERSON = 2; + + /** + * This location is a marketplace vendor that handles transactions on behalf of the company. + * When you select `Marketplace` as the address type for a location, you must then choose either + * `SellerRemitsTax` or `MarketplaceRemitsTax` to indicate which business entity is responsible + * for collecting and remitting tax for this location. + */ const C_MARKETPLACE = 3; } /** * Swagger Name: AvaTaxClient - * + * The type of address represented by this object */ class AddressCategoryId -{ const C_STOREFRONT = 1; +{ + /** + * Address refers to a storefront location + */ + const C_STOREFRONT = 1; + + /** + * Address refers to a main office of this company + */ const C_MAINOFFICE = 2; + + /** + * Address refers to a warehouse or other non-public location + */ const C_WAREHOUSE = 3; + + /** + * Address refers to a location for a single salesperson + */ const C_SALESPERSON = 4; + + /** + * Address is a type not reflected in the other lists + */ const C_OTHER = 5; + + /** + * The marketplace vendor does not collect and remit tax for transactions tied to this + * location. Use this option if you are using a marketplace vendor to handle your transactions + * and your company is responsible for collecting and remitting all taxes for transactions tied + * to this location. + */ const C_SELLERREMITSTAX = 6; + + /** + * The marketplace vendor collects and remits tax on your behalf for all transactions tied + * to this location. Use this option if your marketplace vendor already pays sales and use + * taxes on your behalf. When this option is selected, all transactions tied to this location + * will be treated as already filed, and will be listed on each sales tax return as amounts + * already paid. + */ const C_MARKETPLACEREMITSTAX = 7; + + /** + * Address refers to the mailing address of your company which is not a physical location. + */ const C_NONPHYSICAL = 8; } /** * Swagger Name: AvaTaxClient - * + * Types of jurisdiction referenced in a transaction */ class JurisTypeId -{ const C_STA = 1; +{ + /** + * State + */ + const C_STA = 1; + + /** + * County + */ const C_CTY = 2; + + /** + * City + */ const C_CIT = 3; + + /** + * Special + */ const C_STJ = 4; + + /** + * Country + */ const C_CNT = 5; } /** * Swagger Name: AvaTaxClient - * + * Describes the different types of statuses which describe an entity (company). */ class NexusTypeId -{ const C_NONE = 0; +{ + /** + * Indicates no nexus + */ + const C_NONE = 0; + + /** + * Indicates the entity is voluntarily collecting tax (default) + */ const C_SALESORSELLERSUSETAX = 1; + + /** + * Indicates the entity is required to collect tax in the state + */ const C_SALESTAX = 2; + + /** + * Indicates the entity is registered as a Volunteer in an SST state. + * Only your SST administrator may set this option. + */ const C_SSTVOLUNTEER = 3; + + /** + * Indicates the entity is registered as a Non-Volunteer in an SST state. + * Only your SST administrator may set this option. + */ const C_SSTNONVOLUNTEER = 4; } /** * Swagger Name: AvaTaxClient - * + * Sourcing */ class Sourcing -{ const C_MIXED = 42; +{ + /** + * Mixed sourcing, for states that do both origin and destination calculation + */ + const C_MIXED = 42; + + /** + * Destination + */ const C_DESTINATION = 68; + + /** + * Origin + */ const C_ORIGIN = 79; } /** * Swagger Name: AvaTaxClient - * + * Describes nexus type id */ class LocalNexusTypeId -{ const C_SELECTED = 0; +{ + /** + * Only the specific nexus objects declared for this company are declared. + */ + const C_SELECTED = 0; + + /** + * Customer declares nexus in all state administered taxing authorities. + * + * This value only takes effect if you set `hasLocalNexus` = true. + */ const C_STATEADMINISTERED = 1; + + /** + * Customer declares nexus in all local taxing authorities. + * + * This value only takes effect if you set `hasLocalNexus` = true. + */ const C_ALL = 2; } /** * Swagger Name: AvaTaxClient - * + * This data type is only used when an object must "Match" tax types. By specifying options here, + * you can indicate which tax types will match for the purposes of this object. + * For example, if you specify BothSalesAndUseTax, this value matches with both sales and seller's use tax. */ class MatchingTaxType -{ const C_E = 5; +{ + /** + * Match medical excise type + */ + const C_E = 5; + + /** + * Match Lodging tax type + */ const C_LODGING = 6; + + /** + * Match bottle tax type + */ const C_BOTTLE = 7; + + /** + * Match RentToOwn tax type + */ const C_RENTTOOWN = 8; + + /** + * BikeTax tax type + */ const C_BIKETAX = 11; + + /** + * LandedCost tax type + */ const C_LANDEDCOST = 12; + + /** + * CheckoutBag tax type + */ const C_CHECKOUTBAG = 13; + + /** + * Alcohol tax type + */ const C_ALCOHOL = 17; + + /** + * Amusement tax type + */ const C_AMUSEMENT = 20; + + /** + * Hospitality tax type + */ const C_HOSPITALITY = 21; + + /** + * RentalLeasing tax type + */ const C_RENTALLEASING = 23; + + /** + * GrossReceipts tax type + */ const C_GROSSRECEIPTS = 24; + + /** + * Mattress tax type + */ const C_MATTRESS = 25; + + /** + * Lumber tax type + */ const C_LUMBER = 27; + + /** + * Paint tax type + */ const C_PAINT = 28; + + /** + * Tires tax type + */ const C_TIRES = 29; + + /** + * Economic Incentive tax type + */ const C_EI = 30; + + /** + * Match all tax types + */ const C_ALL = 65; + + /** + * Match both Sales and Use Tax only + */ const C_BOTHSALESANDUSETAX = 66; + + /** + * Match Consumer Use Tax only + */ const C_CONSUMERUSETAX = 67; + + /** + * Match both Consumer Use and Seller's Use Tax types + */ const C_CONSUMERSUSEANDSELLERSUSETAX = 68; + + /** + * Match both Consumer Use and Sales Tax types + */ const C_CONSUMERUSEANDSALESTAX = 69; + + /** + * Match Fee tax types only + */ const C_FEE = 70; + + /** + * Match VAT Input Tax only + */ const C_VATINPUTTAX = 73; + + /** + * LightBulbs tax type + */ const C_LIGHTBULBS = 76; + + /** + * Meals tax type + */ const C_MEALS = 77; + + /** + * Match VAT Nonrecoverable Input Tax only + */ const C_VATNONRECOVERABLEINPUTTAX = 78; + + /** + * Match VAT Output Tax only + */ const C_VATOUTPUTTAX = 79; + + /** + * PIF tax type + */ const C_PIF = 80; + + /** + * Match Rental tax types only + */ const C_RENTAL = 82; + + /** + * Match Sales Tax only + */ const C_SALESTAX = 83; + + /** + * Match Seller's Use Tax only + */ const C_USETAX = 85; + + /** + * EWaste tax type + */ const C_EWASTE = 87; + + /** + * Batteries tax type + */ const C_BATTERIES = 90; } @@ -744,144 +1578,358 @@ class RateType /** * Swagger Name: AvaTaxClient - * + * Specifies the type of custom tax rule you have created. */ class TaxRuleTypeId -{ const C_RATERULE = 0; +{ + /** + * Reserved for Avalara internal usage. + */ + const C_RATERULE = 0; + + /** + * Specifies a rule that changes the rate of tax for a specified set of criteria. + * + * This rule can apply to one specific type of product (identified by `TaxCode`) or all products (identified by a null `TaxCode`). + */ const C_RATEOVERRIDERULE = 1; + + /** + * Specifies a rule that changes the tax base of a specific product. + * + * This rule can apply to one specific type of product (identified by `TaxCode`) or all products (identified by a null `TaxCode`). + */ const C_BASERULE = 2; + + /** + * Indicates that a particular product is exempt from tax due to an exempt usage reason. + * + * Amounts exempted by this rule are stored in the `exemptAmount` field on the transaction. + */ const C_EXEMPTENTITYRULE = 3; + + /** + * Specifies a rule that changes whether a product is taxable or not. + * + * This rule must be applied to a specific type of product. If you attempt to create a product taxability rule while + * leaving the `TaxCode` and `TaxCodeId` fields empty, you will get an error. + * + * A `value` field of `1` means that this tax code is taxable; `0` means it is nontaxable. + * + * Amounts that are considered not taxable according to this rule are stored in the `nonTaxableAmount` + * column in a transaction. + * + * This type of rule can also determine the rate type for a product or to apply a cap or threshold. + */ const C_PRODUCTTAXABILITYRULE = 4; + + /** + * Reserved for Avalara internal usage. + */ const C_NEXUSRULE = 5; + + /** + * RateCapRule + */ const C_RATECAPRULE = 6; + + /** + * TaxOverrideRule + */ const C_TAXOVERRIDERULE = 7; + + /** + * FeeRule + */ const C_FEERULE = 8; + + /** + * OtherRule + */ const C_OTHERRULE = 100; } /** * Swagger Name: AvaTaxClient - * + * Exempt Cert type */ class ExemptCertTypeId -{ const C_BLANKET = 0; +{ + /** + * Blanked certificate + */ + const C_BLANKET = 0; + + /** + * Single use + */ const C_SINGLEUSE = 1; } /** * Swagger Name: AvaTaxClient - * + * Status for this exempt certificate */ class ExemptCertStatusId -{ const C_INACTIVE = 0; +{ + /** + * Inactive certificate + */ + const C_INACTIVE = 0; + + /** + * Active certificate + */ const C_ACTIVE = 1; + + /** + * Expired certificate + */ const C_EXPIRED = 2; + + /** + * Revoked certificate + */ const C_REVOKED = 3; } /** * Swagger Name: AvaTaxClient - * + * Exempt certificate review status */ class ExemptCertReviewStatusId -{ const C_PENDING = 0; +{ + /** + * Review pending + */ + const C_PENDING = 0; + + /** + * Certificate was accepted + */ const C_ACCEPTED = 1; + + /** + * Certificate was rejected + */ const C_REJECTED = 2; } /** * Swagger Name: AvaTaxClient - * + * Choice of rounding level for a transaction */ class RoundingLevelId -{ const C_LINE = 0; +{ + /** + * Round tax on each line separately + */ + const C_LINE = 0; + + /** + * Round tax at the document level + */ const C_DOCUMENT = 1; } /** * Swagger Name: AvaTaxClient - * + * TaxDependencyLevelId */ class TaxDependencyLevelId -{ const C_DOCUMENT = 0; +{ + /** + * Document + */ + const C_DOCUMENT = 0; + + /** + * State + */ const C_STATE = 1; + + /** + * TaxRegion + */ const C_TAXREGION = 2; + + /** + * Address + */ const C_ADDRESS = 3; } /** * Swagger Name: AvaTaxClient - * + * A list of possible AvaFile Form Types. */ class FormTypeId -{ const C_SALESANDUSE = 0; +{ + /** + * Denotes the form type is Sales and Use Tax + */ + const C_SALESANDUSE = 0; + + /** + * Denotes the form type is Sales Tax only + */ const C_SALES = 1; + + /** + * Denotes the form type is Sellers Use Tax only + */ const C_SELLERSUSE = 2; + + /** + * Denotes the form type is Lodging Tax only + */ const C_LODGING = 3; + + /** + * Denotes the form type is Sales and Lodging Tax + */ const C_SALESANDLODGING = 4; + + /** + * Denotes the form type is Consumer Use Tax only + */ const C_CONSUMERUSE = 5; + + /** + * Denotes the form type is Resort and Rental Tax + */ const C_RESORTANDRENTAL = 6; + + /** + * Denotes the form type is Tourist and Rental Tax + */ const C_TOURISTANDRENTAL = 7; + + /** + * Denotes the form type is Prepayment + */ const C_PREPAYMENT = 8; + + /** + * Denotes the form type is Prepayment Allowance + */ const C_PREPAYMENTALLOWED = 9; } /** * Swagger Name: AvaTaxClient - * + * A list of possible AvaFile filing option types. */ class FilingOptionTypeId -{ const C_PAPER = 0; +{ + /** + * Denotes the tax return is being filed on paper. + */ + const C_PAPER = 0; + + /** + * Denotes the form can be efiled optionally. + */ const C_OPTIONALEFILE = 1; + + /** + * Denotes the form is being filed via efile. + */ const C_MANDATORYEFILE = 2; } /** * Swagger Name: AvaTaxClient - * + * A list of possible Due Date Types */ class DueDateTypeId -{ const C_BYDAY = 0; +{ + /** + * Denotes form is due on the due day + */ + const C_BYDAY = 0; + + /** + * Denotes form is due by last day of the month + */ const C_BYLASTDAY = 1; + + /** + * Denotes form is due by second to last day of the month + */ const C_BYSECONDLASTDAY = 2; } /** * Swagger Name: AvaTaxClient - * + * Indicates the rounding behavior of a form */ class RoundingTypeId -{ const C_NONE = 0; +{ + /** + * There is no rounding on the return + */ + const C_NONE = 0; + + /** + * Round to the nearest whole number + */ const C_NEAREST = 1; + + /** + * Always round up + */ const C_UP = 2; + + /** + * Always round down + */ const C_DOWN = 3; } /** * Swagger Name: AvaTaxClient - * + * Indicates the behavior of a tax form for a company with multiple places of business. + * + * Some tax authorities require that a separate form must be filed for each place of business. */ class OutletTypeId -{ const C_NONE = 0; +{ + /** + * File a single return per cycle for your entire business. + */ + const C_NONE = 0; + + /** + * You may file separate forms for each outlet; contact the tax authority for more details about location based reporting requirements. + */ const C_SCHEDULE = 1; + + /** + * You may file separate forms for each outlet; contact the tax authority for more details about location based reporting requirements. + */ const C_DUPLICATE = 2; + + /** + * File a single return, but you must have a line item for each place of business. + */ const C_CONSOLIDATED = 3; } /** * Swagger Name: AvaTaxClient - * + * The type of data contained in this batch */ class BatchType { const C_AVACERTUPDATE = 0; @@ -894,6 +1942,11 @@ class BatchType const C_SALESAUDITEXPORT = 7; const C_SSTPTESTDECKIMPORT = 8; const C_TAXRULEIMPORT = 9; + + /** + * This batch type represents tax transaction data being uploaded to AvaTax. Each line in the batch represents a single transaction + * or a line in a multi-line transaction. For reference, see [Batched Transactions in REST v2](http://developer.avalara.com/blog/2016/10/24/batch-transaction-upload-in-rest-v2) + */ const C_TRANSACTIONIMPORT = 10; const C_UPCBULKIMPORT = 11; const C_UPCVALIDATIONIMPORT = 12; @@ -903,65 +1956,182 @@ class BatchType /** * Swagger Name: AvaTaxClient - * + * The status of a batch file */ class BatchStatus -{ const C_WAITING = 0; +{ + /** + * Batch file has been received and is in the queue to be processed. + */ + const C_WAITING = 0; + + /** + * Batch file experienced system errors and cannot be processed. + */ const C_SYSTEMERRORS = 1; + + /** + * Batch file is cancelled + */ const C_CANCELLED = 2; + + /** + * Batch file has been completely processed. + */ const C_COMPLETED = 3; + + /** + * Batch file is currently being created. + */ const C_CREATING = 4; + + /** + * Batch file has been deleted. + */ const C_DELETED = 5; + + /** + * Batch file was processed with some errors. + */ const C_ERRORS = 6; + + /** + * Batch processing was paused. + */ const C_PAUSED = 7; + + /** + * Batch is currently being processed. + */ const C_PROCESSING = 8; + + /** + * Batch is currently being cancelled. + */ const C_CANCELLING = 9; } /** * Swagger Name: AvaTaxClient - * + * Represents a type of tax override requested by the customer. + * + * AvaTax allows customers to override some behavior of the AvaTax engine. When you use a + * Tax Override, you can import tax that was previously calculated and charged to the customer exactly + * as it was charged. AvaTax will record the type of override used for each transaction. */ class TaxOverrideType -{ const C_NONE = 0; +{ + /** + * AvaTax calculated the tax for this transaction, and no override occurred. + */ + const C_NONE = 0; + + /** + * AvaTax calculated tax for this transaction, but the final tax amount on the transaction was + * determined outside of AvaTax. To see the tax amounts determined by AvaTax, look at the + * `taxCalculated` field. To see the tax amounts determined by the customer's outside tax engine, + * look at the `taxAmount` field. + * + * This behavior can also occur when a customer requests a refund. For refunds calculated using the + * `RefundTransaction` API, AvaTax will ensure that the exact tax charged to the customer is refunded + * to the customer using a tax amount override. + */ const C_TAXAMOUNT = 1; + + /** + * Entity exemption was ignored (e.g. item was consumed) + */ const C_EXEMPTION = 2; + + /** + * AvaTax was instructed to calculate this transaction using the tax rules that were in effect + * on a different day than the transaction occurred. + * + * This behavior typically occurs during refunds. If the customer attempts to return a product + * without a receipt that shows the exact tax amount paid, AvaTax can calculate tax on the date + * when they believed that the product was purchased. + */ const C_TAXDATE = 3; + + /** + * To support Consumer Use Tax + */ const C_ACCRUEDTAXAMOUNT = 4; + + /** + * Derive the taxable amount from the tax amount + */ const C_DERIVETAXABLE = 5; + + /** + * This is for the documents that are calculated outside of AvaTax and passed in to AvaTax + * specifically for reporting/Returns purposes + */ const C_OUTOFHARBOR = 6; + + /** + * To support Tax Override Amount with Tax Type feature + */ const C_TAXAMOUNTBYTAXTYPE = 7; } /** * Swagger Name: AvaTaxClient - * + * This field will identify who is remitting the tax - Marketplace or Seller. */ class MarketplaceLiabilityType -{ const C_MARKETPLACE = 1; +{ + /** + * MarketPlace + */ + const C_MARKETPLACE = 1; + + /** + * Seller + */ const C_SELLER = 2; } /** * Swagger Name: AvaTaxClient - * + * Service modes for tax calculation when using an AvaLocal server. */ class ServiceMode -{ const C_AUTOMATIC = 0; +{ + /** + * Automatically use local or remote (default) + */ + const C_AUTOMATIC = 0; + + /** + * Local server only + */ const C_LOCAL = 1; + + /** + * Remote server only + */ const C_REMOTE = 2; } /** * Swagger Name: AvaTaxClient - * + * Indicates the level of detail requested from a tax API call */ class TaxDebugLevel -{ const C_NORMAL = 0; +{ + /** + * User requests the normal level of debug information when creating a tax transaction + */ + const C_NORMAL = 0; + + /** + * User requests additional diagnostic information when creating a tax transaction + */ const C_DIAGNOSTIC = 1; } @@ -971,59 +2141,152 @@ class TaxDebugLevel * */ class DeliveryTerms -{ const C_DAP = 1; +{ + /** + * Delivery At Place (DAP) implies that Duty And Tax will be paid by the Buyer or Consignee of the shipment + */ + const C_DAP = 1; + + /** + * Delivery Duty Paid (DDP) implies that Duty And Tax will be paid by the Shipper + */ const C_DDP = 2; } /** * Swagger Name: AvaTaxClient - * + * Indicates the type of adjustment that was performed on a transaction */ class AdjustmentReason -{ const C_NOTADJUSTED = 0; +{ + /** + * The transaction has not been adjusted + */ + const C_NOTADJUSTED = 0; + + /** + * A sourcing issue existed which caused the transaction to be adjusted + */ const C_SOURCINGISSUE = 1; + + /** + * Transaction was adjusted to reconcile it with a general ledger + */ const C_RECONCILEDWITHGENERALLEDGER = 2; + + /** + * Transaction was adjusted after an exemption certificate was applied + */ const C_EXEMPTCERTAPPLIED = 3; + + /** + * Transaction was adjusted when the price of an item changed + */ const C_PRICEADJUSTED = 4; + + /** + * Transaction was adjusted due to a product return + */ const C_PRODUCTRETURNED = 5; + + /** + * Transaction was adjusted due to a product exchange + */ const C_PRODUCTEXCHANGED = 6; + + /** + * Transaction was adjusted due to bad or uncollectable debt + */ const C_BADDEBT = 7; + + /** + * Transaction was adjusted for another reason not specified + */ const C_OTHER = 8; + + /** + * Offline + */ const C_OFFLINE = 9; } /** * Swagger Name: AvaTaxClient - * + * Reason code for voiding or cancelling a transaction */ class VoidReasonCode -{ const C_UNSPECIFIED = 0; +{ + /** + * Unspecified reason + */ + const C_UNSPECIFIED = 0; + + /** + * Post operation failed - Document status will be changed to unposted + */ const C_POSTFAILED = 1; + + /** + * Document deleted - If committed, document status will be changed to Cancelled. If not committed, document will be + * deleted. + */ const C_DOCDELETED = 2; + + /** + * Document has been voided and DocStatus will be set to Cancelled + */ const C_DOCVOIDED = 3; + + /** + * AdjustTax operation has been cancelled. Adjustment will be reversed. + */ const C_ADJUSTMENTCANCELLED = 4; } /** * Swagger Name: AvaTaxClient - * + * The way of delivering request */ class CertificateRequestDeliveryMethod -{ const C_EMAIL = 1; +{ + /** + * The invitation will be sent via email to the recipient's email address. + */ + const C_EMAIL = 1; + + /** + * The invitation will be sent via facsimile to the recipient's facsimile phone number. + * + * Facsimile transmission make take time to process and deliver via phone lines. + */ const C_FAX = 2; + + /** + * The request will be processed and turned into a web link (URL) which the user can click on to visit the CertExpress site and immediately + * begin entering data about their certificates. + */ const C_DOWNLOAD = 3; } /** * Swagger Name: AvaTaxClient - * + * Indicates the status of a CertExpress invitation link. */ class CertExpressInvitationStatus -{ const C_INPROGRESS = 0; +{ + /** + * The CertExpress website is currently building a landing page for the customer. Please + * wait about 10 seconds and fetch this request again to see when it will be ready. + */ + const C_INPROGRESS = 0; + + /** + * Indicates that the CertExpress invitation has been completed and is ready to use. + */ const C_READY = 1; } @@ -1033,7 +2296,17 @@ class CertExpressInvitationStatus * */ class CertCaptureProvisionStatus -{ const C_PROVISIONED = 0; +{ + /** + * Account and company are provisioned + */ + const C_PROVISIONED = 0; + + /** + * Provision job is being queued + * This could also be an indication that some companies under an account has been provisioned, while others + * under the same account has not. + */ const C_INPROGRESS = 1; const C_NOTPROVISIONED = 2; @@ -1041,96 +2314,233 @@ class CertCaptureProvisionStatus /** * Swagger Name: AvaTaxClient - * + * Indicates whether Avalara Managed Returns has begun filing for this company. */ class CompanyFilingStatus -{ const C_NOTCONFIGUREDFORCOMPLIANCE = 0; +{ + /** + * This company has not been configured for compliance + */ + const C_NOTCONFIGUREDFORCOMPLIANCE = 0; + + /** + * This company is a reporting entity, but Avalara is not currently filing tax returns for this company. + */ const C_NOTYETFILING = 1; + + /** + * The customer has requested that Avalara Managed Returns begin filing for this company, however filing has + * not yet started. Avalara's compliance team is reviewing this request and will update the company to + * first filing status when complete. + */ const C_FILINGREQUESTED = 2; + + /** + * Avalara has begun filing tax returns for this company. Normally, this status will change to `Active` after + * one month of successful filing of tax returns. + */ const C_FIRSTFILING = 3; + + /** + * Avalara currently files tax returns for this company. + */ const C_ACTIVE = 4; + + /** + * This company is not a reporting entity and cannot file taxes. To change this behavior, you must mark + * the company as a reporting entity. + */ const C_NOREPORTING = 5; + + /** + * This company is inactive + */ const C_INACTIVE = 6; } /** * Swagger Name: AvaTaxClient - * + * Visibility for a parameter. */ class Visibility -{ const C_REQUIRED = 0; +{ + /** + * Denotes the Parameter is required + */ + const C_REQUIRED = 0; + + /** + * Denotes the Parameter is recommended + */ const C_RECOMMENDED = 1; + + /** + * Denotes the Parameter is optional + */ const C_OPTIONAL = 2; + + /** + * Denotes the Parameter is conditional + */ const C_CONDITIONAL = 3; } /** * Swagger Name: AvaTaxClient - * + * Type of verification task */ class ScraperType -{ const C_LOGIN = 1; +{ + /** + * Indicates that is is a login type + */ + const C_LOGIN = 1; + + /** + * Indicates that it is a Customer DOR Data type + */ const C_CUSTOMERDORDATA = 2; } /** * Swagger Name: AvaTaxClient - * + * Jurisdiction boundary precision level found for address. This depends on the accuracy of the address + * as well as the precision level of the state provided jurisdiction boundaries. */ class BoundaryLevel -{ const C_ADDRESS = 0; +{ + /** + * Street address precision + */ + const C_ADDRESS = 0; + + /** + * 9-digit zip precision + */ const C_ZIP9 = 1; + + /** + * 5-digit zip precision + */ const C_ZIP5 = 2; } /** * Swagger Name: AvaTaxClient - * + * Status when deleting an error transaction */ class AvataxDeleteErrorTransactionStatus -{ const C_SUCCESS = 0; +{ + /** + * Successful delete + */ + const C_SUCCESS = 0; + + /** + * Failed delete + */ const C_FAILURE = 1; } /** * Swagger Name: AvaTaxClient - * + * Filing Frequency types */ class FilingFrequencyId -{ const C_MONTHLY = 1; +{ + /** + * File once per month + */ + const C_MONTHLY = 1; + + /** + * File once per three months + */ const C_QUARTERLY = 2; + + /** + * File twice per year + */ const C_SEMIANNUALLY = 3; + + /** + * File once per year + */ const C_ANNUALLY = 4; + + /** + * File every other month + */ const C_BIMONTHLY = 5; + + /** + * File only when there are documents to report + */ const C_OCCASIONAL = 6; + + /** + * File for the first two months of each quarter, then do not file on the quarterly month. + */ const C_INVERSEQUARTERLY = 7; + + /** + * File every week + */ const C_WEEKLY = 8; } /** * Swagger Name: AvaTaxClient - * + * A list of possible AvaFile filing types. */ class FilingTypeId -{ const C_PAPERRETURN = 0; +{ + /** + * Denotes the tax return is being filed on paper. + */ + const C_PAPERRETURN = 0; + + /** + * Denotes the tax return is being filed via electronic means; excludes SST electronic filing. + */ const C_ELECTRONICRETURN = 1; + + /** + * Denotes the tax return is an SST filing. + */ const C_SER = 2; + + /** + * Denotes a return is paid via EFT and filed on paper without payment. + */ const C_EFTPAPER = 3; + + /** + * Denotes a return is paid via phone and filed on paper without payment. + */ const C_PHONEPAPER = 4; + + /** + * Denotes a return is prepared but delivered to the customer for filing and payment. + */ const C_SIGNATUREREADY = 5; + + /** + * Denotes a return which is filed online but paid by check. + */ const C_EFILECHECK = 6; } /** * Swagger Name: AvaTaxClient - * + * A list of bulk account validation statuses for filing calendars. */ class BulkAccountValidationStatus { const C_NEW = 0; @@ -1141,24 +2551,60 @@ class BulkAccountValidationStatus /** * Swagger Name: AvaTaxClient - * + * Filing Request Status types */ class FilingRequestStatus -{ const C_NEW = 1; +{ + /** + * Customer is building a request for a new filing calendar + */ + const C_NEW = 1; + + /** + * Customer’s information validated before submitting to go live. All required information as per state and form selection is entered. + */ const C_VALIDATED = 2; + + /** + * Customer submitted a request for a new filing calendar + */ const C_PENDING = 3; + + /** + * Filing calender is active + */ const C_ACTIVE = 4; + + /** + * Customer requested to deactivate filing calendar + */ const C_PENDINGSTOP = 5; + + /** + * Filing calendar is inactive + */ const C_INACTIVE = 6; + + /** + * This indicates that there is a new change request. + */ const C_CHANGEREQUEST = 7; + + /** + * This indicates that the change request was approved. + */ const C_REQUESTAPPROVED = 8; + + /** + * This indicates that compliance rejected the request. + */ const C_REQUESTDENIED = 9; } /** * Swagger Name: AvaTaxClient - * + * Filing Status */ class FilingStatusId { const C_PENDINGAPPROVAL = 0; @@ -1184,10 +2630,18 @@ class FilingStatusId /** * Swagger Name: AvaTaxClient - * + * Accrual types */ class AccrualType -{ const C_FILING = 1; +{ + /** + * Filing indicates that this tax return should be filed with its tax authority by its due date. For example, if you file annually, you will have eleven months of Accrual returns and one Filing return. + */ + const C_FILING = 1; + + /** + * An Accrual filing indicates taxes that are accrued, intended to be filed on a future tax return. For example, if you file annually, you will have eleven months of Accrual returns and one Filing return. + */ const C_ACCRUAL = 2; } @@ -1217,52 +2671,104 @@ class PaymentAccountTypeId /** * Swagger Name: AvaTaxClient - * + * Indicates the type of payments */ class PaymentType -{ const C_CURRENTPERIOD = 0; +{ + /** + * The payment is for the current payment + */ + const C_CURRENTPERIOD = 0; + + /** + * The payment is a prepayment + */ const C_PREPAYMENT = 1; + + /** + * The payment is a prior payment + */ const C_PRIORPAYMENT = 2; + + /** + * The payment is a prior CSP fee + */ const C_PRIORCSPFEE = 3; } /** * Swagger Name: AvaTaxClient - * + * Filing worksheet Type */ class WorksheetTypeId -{ const C_ORIGINAL = 0; +{ + /** + * The original filing for a period + */ + const C_ORIGINAL = 0; + + /** + * Represents an amended filing for a period + */ const C_AMENDED = 1; + + /** + * Represents a test filing + */ const C_TEST = 2; } /** * Swagger Name: AvaTaxClient - * + * Account Linkage status */ class FirmClientLinkageStatus -{ const C_REQUESTED = 1; +{ + /** + * Requested + */ + const C_REQUESTED = 1; + + /** + * Approved + */ const C_APPROVED = 2; + + /** + * Rejected + */ const C_REJECTED = 3; + + /** + * Revoked + */ const C_REVOKED = 4; } /** * Swagger Name: AvaTaxClient - * + * Liability Type */ class LiabilityType -{ const C_SELLER = 0; +{ + /** + * Seller + */ + const C_SELLER = 0; + + /** + * BuyersAgent + */ const C_BUYERSAGENT = 1; } /** * Swagger Name: AvaTaxClient - * + * Represents the different types of DeemedSeller for AVT Marketplace client. */ class DeemedSellerType { const C_MARKETPLACE = 1; @@ -1272,163 +2778,448 @@ class DeemedSellerType /** * Swagger Name: AvaTaxClient - * + * The `DocumentStatus` value indicates the state of the document as it moves through the + * AvaTax document workflow. More information about the AvaTax document workflow is available + * in the [AvaTax Developer Guide](https://developer.avalara.com/avatax/dev-guide/transactions/should-i-commit). */ class DocumentStatus -{ const C_TEMPORARY = 0; +{ + /** + * Temporary document not saved (SalesOrder, PurchaseOrder). + * + * This document has not been recorded to AvaTax + */ + const C_TEMPORARY = 0; + + /** + * Saved document (SalesInvoice or PurchaseInvoice) ready to be posted. + * + * This status indicates that the transaction has been saved to AvaTax, but is not available + * to be reported on a tax filing, and has not yet been verified by a business process that + * posts transactions. + * + * To mark this transaction as `Posted`, please call `VerifyTransaction` or `SettleTransaction`. + * + * To mark this transaction as `Committed`, please call `CommitTransaction` or `SettleTransaction`. + * + * To adjust or void this transaction, call `AdjustTransaction`, `CreateOrAdjustTransaction`, or + * `VoidTransaction`. + */ const C_SAVED = 1; + + /** + * A posted document (not committed). + * + * This status indicates that the transaction has been saved to AvaTax, and has been verified + * by a business process that posts transactions, but is not ready to report on a tax filing. + * + * To mark this transaction as `Committed`, please call `CommitTransaction` or `SettleTransaction`. + * + * To adjust or void this transaction, call `AdjustTransaction`, `CreateOrAdjustTransaction`, or + * `VoidTransaction`. + */ const C_POSTED = 2; + + /** + * A posted document that has been committed. + * + * This status indicates that the transaction has been saved to AvaTax and can be reported + * on a tax filing. + * + * If you use Avalara's Managed Returns Service, these transactions will be captured and reported + * on a tax return. When this occurs, the transaction's `locked` flag will be set to true. Once + * the transaction is locked, no further changes may occur. + * + * As long as the transaction has not been locked, you may adjust or void this transaction using + * `AdjustTransaction`, `CreateOrAdjustTransaction`, or `VoidTransaction`. + */ const C_COMMITTED = 3; + + /** + * A document that has been cancelled. + * + * This status indicates that the transaction has been cancelled or voided. Cancelled and Voided + * are synonyms. + * + * When a transaction has been cancelled, it is considered to no longer exist. You are free to create + * a new transaction with the same code. + */ const C_CANCELLED = 4; + + /** + * An older version of a document that has been adjusted. + * + * When you call `AdjustTransaction`, AvaTax preserves a record of the old document as well as a record + * of the new document. The old document is changed to the status `Adjusted`, and the new document + * is created in the status you requested. + */ const C_ADJUSTED = 5; + + /** + * DEPRECATED - A document which is queued for later processing. + */ const C_QUEUED = 6; + + /** + * Indicates that this document requires approval from a governmental agency before it can be finalized. + * + * Some governments require active verification of transactions before they can be finalized. When AvaTax + * detects that a transaction must be verified with a governmental agency, this transaction will be flagged + * as `PendingApproval` until the government has certified the transaction. + */ const C_PENDINGAPPROVAL = 7; + + /** + * DEPRECATED - Represents "a document in any status" when searching. Please search using the + * [Filtering in REST](/avatax/filtering-in-rest/) documentation. + */ const C_ANY = -1; } /** * Swagger Name: AvaTaxClient - * + * Refund types */ class RefundType -{ const C_FULL = 0; +{ + /** + * Refund the whole transaction. + */ + const C_FULL = 0; + + /** + * Refund only specific lines from the original a transaction. + */ const C_PARTIAL = 1; + + /** + * Only refund the tax part of the transaction. + */ const C_TAXONLY = 2; + + /** + * Refund a percentage of the value of this transaction. + */ const C_PERCENTAGE = 3; } /** * Swagger Name: AvaTaxClient - * + * Indicates what level of auditing information is available for a transaction */ class ApiCallStatus -{ const C_ORIGINALAPICALLAVAILABLE = 0; +{ + /** + * If the original api call is availabe on S3 + */ + const C_ORIGINALAPICALLAVAILABLE = 0; + + /** + * if the original api call is not available, reconstructed api call should always be available + */ const C_RECONSTRUCTEDAPICALLAVAILABLE = 1; + + /** + * Any other api call status + */ const C_ANY = -1; } /** * Swagger Name: AvaTaxClient - * + * Comment Types */ class CommentType -{ const C_INTERNAL = 1; +{ + /** + * Internal comments are those comments only intended to be for compliance users + */ + const C_INTERNAL = 1; + + /** + * Customer comments are those comments that both compliance and the customer can read + */ const C_CUSTOMER = 2; + + /** + * A comment that has a POA Attachment on it + */ const C_POAATTACHMENT = 3; + + /** + * Used when creating Notice Comments in Returns Console + */ const C_NOTICEVOUCHER = 4; } /** * Swagger Name: AvaTaxClient - * + * Notice Customer Types */ class NoticeCustomerType -{ const C_AVATAXRETURNS = 1; +{ + /** + * AvaTax Returns + */ + const C_AVATAXRETURNS = 1; + + /** + * Stand Alone + */ const C_STANDALONE = 2; + + /** + * Strategic + */ const C_STRATEGIC = 3; + + /** + * SST + */ const C_SST = 4; + + /** + * TrustFile + */ const C_TRUSTFILE = 5; + + /** + * PWC + */ const C_PWC = 6; + + /** + * Hudson Group + */ const C_HUDSONGROUP = 7; + + /** + * MRA + */ const C_MRA = 8; + + /** + * None + */ const C_NONE = 9; } /** * Swagger Name: AvaTaxClient - * + * A list of possible AvaFile filing types for tax notices. */ class TaxNoticeFilingTypeId -{ const C_ELECTRONICRETURN = 1; +{ + /** + * Denotes the tax return is being filed via electronic means; excludes SST electronic filing. + */ + const C_ELECTRONICRETURN = 1; + + /** + * Denotes the tax return is being filed on paper. + */ const C_PAPERRETURN = 2; + + /** + * Denotes the tax return that was not filed. + */ const C_RETURNNOTFILED = 3; + + /** + * Denotes a return is paid via EFT and filed on paper without payment. + */ const C_EFTPAPER = 4; + + /** + * Denotes the tax return is an SST filing. + */ const C_SER = 5; + + /** + * Denotes the tax return is a Trudsfile-EDI filing. + */ const C_TRUSTFILEEDI = 6; + + /** + * Denotes the tax return is an uploaded file. + */ const C_UPLOADFILE = 7; + + /** + * Denotes the tax return was manually filed via paper + */ const C_PAPERMANUAL = 8; + + /** + * Denotes a cert capture return + */ const C_CERTCAPTURE = 9; + + /** + * Denotes a signature ready return + */ const C_SIGNATUREREADY = 10; } /** * Swagger Name: AvaTaxClient - * + * Filing Frequency types */ class FundingOption -{ const C_PULL = 1; +{ + /** + * Pull + */ + const C_PULL = 1; + + /** + * Wire + */ const C_WIRE = 2; } /** * Swagger Name: AvaTaxClient - * + * Filing Frequency types */ class NoticePriorityId -{ const C_IMMEDIATEATTENTIONREQUIRED = 1; +{ + /** + * Immediate Attention Required + */ + const C_IMMEDIATEATTENTIONREQUIRED = 1; + + /** + * High + */ const C_HIGH = 2; + + /** + * Normal + */ const C_NORMAL = 3; + + /** + * Low + */ const C_LOW = 4; } /** * Swagger Name: AvaTaxClient - * + * Severity level of a notification. */ class NotificationSeverityLevel -{ const C_NEUTRAL = 0; +{ + /** + * Low priority notification, Default. + */ + const C_NEUTRAL = 0; + + /** + * Medium priority notification. + */ const C_ADVISORY = 1; + + /** + * High priority notification. + */ const C_BLOCKING = 2; + + /** + * A completed notification + */ const C_COMPLETE = -1; } /** * Swagger Name: AvaTaxClient - * + * Different types of formats allowed for exporting a report */ class ReportFormat -{ const C_CSV = 0; +{ + /** + * The Comma Separated Values file format + */ + const C_CSV = 0; } /** * Swagger Name: AvaTaxClient - * + * The date filter type for report + * "RD" for Reporting Date, "DD" for Document Date, "TD" for Tax Date, "PD" for Payment Date */ class ReportDateFilter -{ const C_DOCUMENTDATE = 68; +{ + /** + * The date when the transaction is posted + */ + const C_DOCUMENTDATE = 68; + + /** + * The date when the transaction is modified + */ const C_MODIFIEDDATE = 77; + + /** + * The date when the transaction is paid for + */ const C_PAYMENTDATE = 80; + + /** + * The date when the transaction is added to report + */ const C_REPORTINGDATE = 82; + + /** + * The date when the transaction is being taxed + */ const C_TAXDATE = 84; } /** * Swagger Name: AvaTaxClient - * + * The output DocumentType for a report */ class ReportDocType -{ const C_CONSUMERUSE = 67; +{ + /** + * Output all ConsumerUse tax transactions in the report + */ + const C_CONSUMERUSE = 67; + + /** + * Output all Sales tax transactions in the report + */ const C_SALES = 83; } /** * Swagger Name: AvaTaxClient - * + * Defines report source. */ class ReportSource -{ const C_SNOWFLAKE = 0; +{ + /** + * snowflake + */ + const C_SNOWFLAKE = 0; + + /** + * mongodb + */ const C_MONGODB = 1; } @@ -1449,7 +3240,15 @@ class SendSalesOutputFileFormat * */ class SendSalesFileType -{ const C_CSV = 0; +{ + /** + * File is in Comma Separated Values format + */ + const C_CSV = 0; + + /** + * File is in Javascript Object Notation format + */ const C_JSON = 1; } @@ -1459,34 +3258,86 @@ class SendSalesFileType * */ class UserDefinedFieldDataType -{ const C_STRING = 0; +{ + /** + * Represents String dataType + */ + const C_STRING = 0; + + /** + * Represents Number dataType + */ const C_NUMBER = 1; + + /** + * Represents Date dataType + */ const C_DATE = 2; + + /** + * Represents Boolean dataType + */ const C_BOOLEAN = 3; } /** * Swagger Name: AvaTaxClient - * + * Indicates the level of companies that can be accessed */ class CompanyAccessLevel -{ const C_NONE = 0; +{ + /** + * No permission to access companies. + */ + const C_NONE = 0; + + /** + * Permission to access a single company and its children. + */ const C_SINGLECOMPANY = 1; + + /** + * Permission to access all companies in a single account. + */ const C_SINGLEACCOUNT = 2; + + /** + * Permission to access all companies in all accounts. Reserved for system administration tasks. + */ const C_ALLCOMPANIES = 3; + + /** + * Permission to access all companies in all accounts managed by a firm account. + */ const C_FIRMMANAGEDACCOUNTS = 4; } /** * Swagger Name: AvaTaxClient - * + * Represents the type of authentication provided to the API call */ class AuthenticationTypeId -{ const C_NONE = 0; +{ + /** + * This API call was not authenticated. + */ + const C_NONE = 0; + + /** + * This API call was authenticated by your username/password. + */ const C_USERNAMEPASSWORD = 1; + + /** + * This API call was authenticated by your Avalara Account ID and private license key. + */ const C_ACCOUNTIDLICENSEKEY = 2; + + /** + * This API call was authenticated by OpenID Bearer Token. + */ const C_OPENIDBEARERTOKEN = 3; } diff --git a/src/Methods.php b/src/Methods.php index 4ec76e7..93ad838 100644 --- a/src/Methods.php +++ b/src/Methods.php @@ -23,27 +23,27 @@ class AvaTaxClient extends AvaTaxClientBase /** * Reset this account's license key * - * Resets the existing license key for this account to a new key. - * - * To reset your account, you must specify the ID of the account you wish to reset and confirm the action. - * - * This API is only available to account administrators for the account in question, and may only be called after - * an account has been activated by reading and accepting Avalara's terms and conditions. To activate your account - * please log onto the AvaTax website or call the `ActivateAccount` API. - * - * You can only reset license with 'Default' license key name. - * Resetting a license key cannot be undone. Any previous license keys will immediately cease to work when a new key is created. - * - * When you call this API, all account administrators for this account will receive an email with the newly updated license key. - * The email will specify which user reset the license key and it will contain the new key to use to update your connectors. - * Note: The reset license key functionality will only be available for existing active license key i.e. when you reset license key for the account, the Default license key will be reset.The reset license key functionality is not available for newly created license keys i.e. license keys other than Default - * - * ### Security Policies - * + * Resets the existing license key for this account to a new key. + * + * To reset your account, you must specify the ID of the account you wish to reset and confirm the action. + * + * This API is only available to account administrators for the account in question, and may only be called after + * an account has been activated by reading and accepting Avalara's terms and conditions. To activate your account + * please log onto the AvaTax website or call the `ActivateAccount` API. + * + * You can only reset license with 'Default' license key name. + * Resetting a license key cannot be undone. Any previous license keys will immediately cease to work when a new key is created. + * + * When you call this API, all account administrators for this account will receive an email with the newly updated license key. + * The email will specify which user reset the license key and it will contain the new key to use to update your connectors. + * Note: The reset license key functionality will only be available for existing active license key i.e. when you reset license key for the account, the Default license key will be reset.The reset license key functionality is not available for newly created license keys i.e. license keys other than Default + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $id The ID of the account you wish to update. + * + * @param int $id The ID of the account you wish to update. * @param ResetLicenseKeyModel $model A request confirming that you wish to reset the license key of this account. * @return LicenseKeyModel */ @@ -53,29 +53,29 @@ public function accountResetLicenseKey($id, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Activate an account by accepting terms and conditions * - * Activate the account specified by the unique accountId number. - * - * This activation request can only be called by account administrators. You must indicate - * that you have read and accepted Avalara's terms and conditions to call this API. - * - * Once you have activated your account, use the `AccountResetLicenseKey` API to generate - * a license key for your account. - * - * If you have not read or accepted the terms and conditions, this API call will return the - * unchanged account model. - * - * ### Security Policies - * + * Activate the account specified by the unique accountId number. + * + * This activation request can only be called by account administrators. You must indicate + * that you have read and accepted Avalara's terms and conditions to call this API. + * + * Once you have activated your account, use the `AccountResetLicenseKey` API to generate + * a license key for your account. + * + * If you have not read or accepted the terms and conditions, this API call will return the + * unchanged account model. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $id The ID of the account to activate + * + * @param int $id The ID of the account to activate * @param ActivateAccountModel $model The activation request * @return AccountModel */ @@ -85,36 +85,36 @@ public function activateAccount($id, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Retrieve audit history for an account. * - * Retrieve audit trace history for an account. - * - * Your audit trace history contains a record of all API calls made against the AvaTax REST API that returned an error. You can use this API to investigate - * problems and see exactly what information was sent back and forth between your code and AvaTax. - * - * When specifying a start and end datetime, please include a valid timezone indicator, such as the "Z" present in the examples for the start and end query parameters. - * You can learn more about valid time zone designators at https://en.wikipedia.org/wiki/ISO_8601#Time_zone_designators. - * - * This API enforces limits to the amount of data retrieved. These limits are subject to change. - * - * * You may request data from a maximum of a one-hour time period. - * * The amount of data and number of API calls returned by this API are limited and may be adjusted at any time. - * * Old records may be migrated out of immediately available storage. To request older data, please contact your account manager. - * * New records must migrate to available storage before they can be retrieved. You may need to wait a period of time before newly created records can be fetched. - * - * ### Security Policies - * + * Retrieve audit trace history for an account. + * + * Your audit trace history contains a record of all API calls made against the AvaTax REST API that returned an error. You can use this API to investigate + * problems and see exactly what information was sent back and forth between your code and AvaTax. + * + * When specifying a start and end datetime, please include a valid timezone indicator, such as the "Z" present in the examples for the start and end query parameters. + * You can learn more about valid time zone designators at https://en.wikipedia.org/wiki/ISO_8601#Time_zone_designators. + * + * This API enforces limits to the amount of data retrieved. These limits are subject to change. + * + * * You may request data from a maximum of a one-hour time period. + * * The amount of data and number of API calls returned by this API are limited and may be adjusted at any time. + * * Old records may be migrated out of immediately available storage. To request older data, please contact your account manager. + * * New records must migrate to available storage before they can be retrieved. You may need to wait a period of time before newly created records can be fetched. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * - * @param int $id The ID of the account you wish to audit. - * @param string $start The start datetime of audit history you with to retrieve, e.g. "2018-06-08T17:00:00Z". Defaults to the past 15 minutes. - * @param string $end The end datetime of audit history you with to retrieve, e.g. "2018-06-08T17:15:00Z. Defaults to the current time. Maximum of an hour after the start time. - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * + * @param int $id The ID of the account you wish to audit. + * @param string $start The start datetime of audit history you with to retrieve, e.g. "2018-06-08T17:00:00Z". Defaults to the past 15 minutes. + * @param string $end The end datetime of audit history you with to retrieve, e.g. "2018-06-08T17:15:00Z. Defaults to the current time. Maximum of an hour after the start time. + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @return FetchResult */ @@ -124,29 +124,29 @@ public function auditAccount($id, $start, $end, $top=null, $skip=null) { 'query' => ['start' => $start, 'end' => $end, '$top' => $top, '$skip' => $skip], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Create license key for this account * - * Creates a new license key for this account. - * - * To create a license key for your account, you must specify the ID of the account and license key name. - * - * This API is only available to account administrators for the account in question, and may only be called after - * an account has been activated by reading and accepting Avalara's terms and conditions. To activate your account - * please log onto the AvaTax website or call the `ActivateAccount` API. - * - * You will reference this key using license key name. The existing license key will be using 'Default' as license key name. - * Hence make sure that the license key name is unique per account considering the existing license key name 'Default' - * - * ### Security Policies - * + * Creates a new license key for this account. + * + * To create a license key for your account, you must specify the ID of the account and license key name. + * + * This API is only available to account administrators for the account in question, and may only be called after + * an account has been activated by reading and accepting Avalara's terms and conditions. To activate your account + * please log onto the AvaTax website or call the `ActivateAccount` API. + * + * You will reference this key using license key name. The existing license key will be using 'Default' as license key name. + * Hence make sure that the license key name is unique per account considering the existing license key name 'Default' + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $id The ID of the account you wish to update. + * + * @param int $id The ID of the account you wish to update. * @param AccountLicenseKeyModel $model * @return LicenseKeyModel */ @@ -156,24 +156,24 @@ public function createLicenseKey($id, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Delete license key for this account by license key name * - * Deletes the license key for this account using license key name. - * - * To delete a license key for your account, you must specify the accountID of the account and license key name. - * - * This API is only available to account administrators for the account in question. - * - * ### Security Policies - * + * Deletes the license key for this account using license key name. + * + * To delete a license key for your account, you must specify the accountID of the account and license key name. + * + * This API is only available to account administrators for the account in question. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $id The ID of the account you wish to update. + * + * @param int $id The ID of the account you wish to update. * @param string $licensekeyname The license key name you wish to update. * @return ErrorDetail[] */ @@ -183,24 +183,24 @@ public function deleteLicenseKey($id, $licensekeyname) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'DELETE', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'DELETE', $guzzleParams,'22.8.0' ); } /** * Retrieve a single account * - * Get the account object identified by this URL. - * You may use the '$include' parameter to fetch additional nested data: - * - * * Subscriptions - * * Users - * - * ### Security Policies - * + * Get the account object identified by this URL. + * You may use the '$include' parameter to fetch additional nested data: + * + * * Subscriptions + * * Users + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * - * @param int $id The ID of the account to retrieve + * + * @param int $id The ID of the account to retrieve * @param string $include A comma separated list of special fetch options * @return AccountModel */ @@ -210,30 +210,30 @@ public function getAccount($id, $include=null) { 'query' => ['$include' => $include], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Get configuration settings for this account * - * Retrieve a list of all configuration settings tied to this account. - * - * Configuration settings provide you with the ability to control features of your account and of your - * tax software. The category names `TaxServiceConfig` and `AddressServiceConfig` are reserved for - * Avalara internal software configuration values; to store your own account-level settings, please - * create a new category name that begins with `X-`, for example, `X-MyCustomCategory`. - * - * Account settings are permanent settings that cannot be deleted. You can set the value of an - * account setting to null if desired. - * - * Avalara-based account settings for `TaxServiceConfig` and `AddressServiceConfig` affect your account's - * tax calculation and address resolution, and should only be changed with care. - * - * ### Security Policies - * + * Retrieve a list of all configuration settings tied to this account. + * + * Configuration settings provide you with the ability to control features of your account and of your + * tax software. The category names `TaxServiceConfig` and `AddressServiceConfig` are reserved for + * Avalara internal software configuration values; to store your own account-level settings, please + * create a new category name that begins with `X-`, for example, `X-MyCustomCategory`. + * + * Account settings are permanent settings that cannot be deleted. You can set the value of an + * account setting to null if desired. + * + * Avalara-based account settings for `TaxServiceConfig` and `AddressServiceConfig` affect your account's + * tax calculation and address resolution, and should only be changed with care. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * + * * @param int $id * @return AccountConfigurationModel[] */ @@ -243,18 +243,18 @@ public function getAccountConfiguration($id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve license key by license key name * - * ### Security Policies - * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * - * @param int $id The ID of the account to retrieve + * + * @param int $id The ID of the account to retrieve * @param string $licensekeyname The ID of the account to retrieve * @return AccountLicenseKeyModel */ @@ -264,19 +264,19 @@ public function getLicenseKey($id, $licensekeyname) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve all license keys for this account * - * Gets list of all the license keys used by the account. - * - * ### Security Policies - * + * Gets list of all the license keys used by the account. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * + * * @param int $id The ID of the account to retrieve * @return AccountLicenseKeyModel[] */ @@ -286,34 +286,34 @@ public function getLicenseKeys($id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve all accounts * - * List all account objects that can be seen by the current user. - * - * This API lists all accounts you are allowed to see. In general, most users will only be able to see their own account. - * - * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . - * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. - * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: - * - * * Subscriptions - * * Users - * - * For more information about filtering in REST, please see the documentation at http://developer.avalara.com/avatax/filtering-in-rest/ . - * - * ### Security Policies - * + * List all account objects that can be seen by the current user. + * + * This API lists all accounts you are allowed to see. In general, most users will only be able to see their own account. + * + * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . + * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. + * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: + * + * * Subscriptions + * * Users + * + * For more information about filtering in REST, please see the documentation at http://developer.avalara.com/avatax/filtering-in-rest/ . + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * - * @param string $include A comma separated list of objects to fetch underneath this account. Any object with a URL path underneath this account can be fetched by specifying its name. - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* subscriptions, users - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $include A comma separated list of objects to fetch underneath this account. Any object with a URL path underneath this account can be fetched by specifying its name. + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* subscriptions, users + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -323,31 +323,31 @@ public function queryAccounts($include=null, $filter=null, $top=null, $skip=null 'query' => ['$include' => $include, '$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Change configuration settings for this account * - * Update configuration settings tied to this account. - * - * Configuration settings provide you with the ability to control features of your account and of your - * tax software. The category names `TaxServiceConfig` and `AddressServiceConfig` are reserved for - * Avalara internal software configuration values; to store your own account-level settings, please - * create a new category name that begins with `X-`, for example, `X-MyCustomCategory`. - * - * Account settings are permanent settings that cannot be deleted. You can set the value of an - * account setting to null if desired. - * - * Avalara-based account settings for `TaxServiceConfig` and `AddressServiceConfig` affect your account's - * tax calculation and address resolution, and should only be changed with care. - * - * ### Security Policies - * + * Update configuration settings tied to this account. + * + * Configuration settings provide you with the ability to control features of your account and of your + * tax software. The category names `TaxServiceConfig` and `AddressServiceConfig` are reserved for + * Avalara internal software configuration values; to store your own account-level settings, please + * create a new category name that begins with `X-`, for example, `X-MyCustomCategory`. + * + * Account settings are permanent settings that cannot be deleted. You can set the value of an + * account setting to null if desired. + * + * Avalara-based account settings for `TaxServiceConfig` and `AddressServiceConfig` affect your account's + * tax calculation and address resolution, and should only be changed with care. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $id + * + * @param int $id * @param AccountConfigurationModel[] $model * @return AccountConfigurationModel[] */ @@ -357,37 +357,37 @@ public function setAccountConfiguration($id, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Retrieve geolocation information for a specified address * - * Resolve an address against Avalara's address-validation system. If the address can be resolved, this API - * provides the latitude and longitude of the resolved location. The value 'resolutionQuality' can be used - * to identify how closely this address can be located. If the address cannot be clearly located, use the - * 'messages' structure to learn more about problems with this address. - * This is the same API as the POST /api/v2/addresses/resolve endpoint. - * Both verbs are supported to provide for flexible implementation. - * - * In order to get any evaluation for an address, please provide at least one of the following fields/pairs: - * 1. postal code - * 2. line1 + city + region - * 3. line1 + postal code - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * Resolve an address against Avalara's address-validation system. If the address can be resolved, this API + * provides the latitude and longitude of the resolved location. The value 'resolutionQuality' can be used + * to identify how closely this address can be located. If the address cannot be clearly located, use the + * 'messages' structure to learn more about problems with this address. + * This is the same API as the POST /api/v2/addresses/resolve endpoint. + * Both verbs are supported to provide for flexible implementation. + * + * In order to get any evaluation for an address, please provide at least one of the following fields/pairs: + * 1. postal code + * 2. line1 + city + region + * 3. line1 + postal code + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AutoAddress. * Swagger Name: AvaTaxClient - * - * @param string $line1 Line 1 - * @param string $line2 Line 2 - * @param string $line3 Line 3 - * @param string $city City - * @param string $region State / Province / Region - * @param string $postalCode Postal Code / Zip Code - * @param string $country Two character ISO 3166 Country Code (see /api/v2/definitions/countries for a full list) + * + * @param string $line1 Line 1 + * @param string $line2 Line 2 + * @param string $line3 Line 3 + * @param string $city City + * @param string $region State / Province / Region + * @param string $postalCode Postal Code / Zip Code + * @param string $country Two character ISO 3166 Country Code (see /api/v2/definitions/countries for a full list) * @param string $textCase selectable text case for address validation (See TextCase::* for a list of allowable values) * @return AddressResolutionModel */ @@ -397,25 +397,25 @@ public function resolveAddress($line1, $line2, $line3, $city, $region, $postalCo 'query' => ['line1' => $line1, 'line2' => $line2, 'line3' => $line3, 'city' => $city, 'region' => $region, 'postalCode' => $postalCode, 'country' => $country, 'textCase' => $textCase], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve geolocation information for a specified address * - * Resolve an address against Avalara's address-validation system. If the address can be resolved, this API - * provides the latitude and longitude of the resolved location. The value 'resolutionQuality' can be used - * to identify how closely this address can be located. If the address cannot be clearly located, use the - * 'messages' structure to learn more about problems with this address. - * This is the same API as the GET /api/v2/addresses/resolve endpoint. - * Both verbs are supported to provide for flexible implementation. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * Resolve an address against Avalara's address-validation system. If the address can be resolved, this API + * provides the latitude and longitude of the resolved location. The value 'resolutionQuality' can be used + * to identify how closely this address can be located. If the address cannot be clearly located, use the + * 'messages' structure to learn more about problems with this address. + * This is the same API as the GET /api/v2/addresses/resolve endpoint. + * Both verbs are supported to provide for flexible implementation. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AutoAddress. * Swagger Name: AvaTaxClient - * + * * @param AddressValidationInfo $model The address to resolve * @return AddressResolutionModel */ @@ -425,7 +425,7 @@ public function resolveAddressPost($model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** @@ -433,9 +433,9 @@ public function resolveAddressPost($model) { * * * Swagger Name: AvaTaxClient - * - * @param int $accountId The ID of the account for the company - * @param int $companyId The ID of the company for which the lookup file is to be created + * + * @param int $accountId The ID of the account for the company + * @param int $companyId The ID of the company for which the lookup file is to be created * @param AdvancedRuleLookupFileModel $model The lookup file you wish to create * @return AdvancedRuleLookupFileModel */ @@ -445,7 +445,7 @@ public function createCompanyLookupFile($accountId, $companyId, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** @@ -453,8 +453,8 @@ public function createCompanyLookupFile($accountId, $companyId, $model) { * * * Swagger Name: AvaTaxClient - * - * @param int $accountId The ID of the account for the company the lookup file is for + * + * @param int $accountId The ID of the account for the company the lookup file is for * @param string $id The unique ID/GUID for the company lookup file to be deleted * @return ErrorDetail[] */ @@ -464,7 +464,7 @@ public function deleteLookupFile($accountId, $id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'DELETE', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'DELETE', $guzzleParams,'22.8.0' ); } /** @@ -472,8 +472,8 @@ public function deleteLookupFile($accountId, $id) { * * * Swagger Name: AvaTaxClient - * - * @param int $accountId The account ID for the company + * + * @param int $accountId The account ID for the company * @param int $companyId The ID of the company for which to retrieve lookup files * @return FetchResult */ @@ -483,7 +483,7 @@ public function getCompanyLookupFiles($accountId, $companyId) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** @@ -491,8 +491,8 @@ public function getCompanyLookupFiles($accountId, $companyId) { * * * Swagger Name: AvaTaxClient - * - * @param int $accountId The ID of the account for the lookup file + * + * @param int $accountId The ID of the account for the lookup file * @param string $id The unique ID/GUID of the company lookup file to return * @return AdvancedRuleLookupFileModel */ @@ -502,7 +502,7 @@ public function getLookupFile($accountId, $id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** @@ -510,9 +510,9 @@ public function getLookupFile($accountId, $id) { * * * Swagger Name: AvaTaxClient - * - * @param int $accountId The ID of the account for the company the lookup file is for - * @param string $id The unique ID/GUID of the company lookup file to be updated + * + * @param int $accountId The ID of the account for the company the lookup file is for + * @param string $id The unique ID/GUID of the company lookup file to be updated * @param AdvancedRuleLookupFileModel $model The new values to update the lookup file * @return AdvancedRuleLookupFileModel */ @@ -522,21 +522,21 @@ public function updateLookupFile($accountId, $id, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'PUT', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'PUT', $guzzleParams,'22.8.0' ); } /** * Create a new AvaFileForm * - * Create one or more AvaFileForms - * A 'AvaFileForm' represents a form supported by our returns team - * - * ### Security Policies - * - * * This API requires the user role Compliance Root User. + * Create one or more AvaFileForms + * A 'AvaFileForm' represents a form supported by our returns team + * + * ### Security Policies + * + * * This API requires the user role Compliance Root User. * * This API depends on the following active services:*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged. * Swagger Name: AvaTaxClient - * + * * @param AvaFileFormModel[] $model The AvaFileForm you wish to create. * @return AvaFileFormModel[] */ @@ -546,20 +546,20 @@ public function createAvaFileForms($model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Delete a single AvaFileForm * - * Marks the existing AvaFileForm object at this URL as deleted. - * - * ### Security Policies - * - * * This API requires one of the following user roles: Compliance Root User, ComplianceUser, FirmAdmin. + * Marks the existing AvaFileForm object at this URL as deleted. + * + * ### Security Policies + * + * * This API requires one of the following user roles: Compliance Root User, ComplianceUser, FirmAdmin. * * This API depends on the following active services:*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged. * Swagger Name: AvaTaxClient - * + * * @param int $id The ID of the AvaFileForm you wish to delete. * @return ErrorDetail[] */ @@ -569,20 +569,20 @@ public function deleteAvaFileForm($id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'DELETE', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'DELETE', $guzzleParams,'22.8.0' ); } /** * Retrieve a single AvaFileForm * - * Get the AvaFileForm object identified by this URL. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, Compliance Temp User, ComplianceAdmin, ComplianceUser, FirmAdmin, FirmUser, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin. + * Get the AvaFileForm object identified by this URL. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, Compliance Temp User, ComplianceAdmin, ComplianceUser, FirmAdmin, FirmUser, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin. * * This API depends on the following active services:*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged. * Swagger Name: AvaTaxClient - * + * * @param int $id The primary key of this AvaFileForm * @return AvaFileFormModel */ @@ -592,24 +592,24 @@ public function getAvaFileForm($id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve all AvaFileForms * - * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . - * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, Compliance Temp User, ComplianceAdmin, ComplianceUser, FirmAdmin, FirmUser, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin. + * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . + * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, Compliance Temp User, ComplianceAdmin, ComplianceUser, FirmAdmin, FirmUser, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin. * * This API depends on the following active services:*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* outletTypeId - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* outletTypeId + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -619,22 +619,22 @@ public function queryAvaFileForms($filter=null, $top=null, $skip=null, $orderBy= 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Update a AvaFileForm * - * All data from the existing object will be replaced with data in the object you PUT. - * To set a field's value to null, you may either set its value to null or omit that field from the object you post. - * - * ### Security Policies - * - * * This API requires the user role Compliance Root User. + * All data from the existing object will be replaced with data in the object you PUT. + * To set a field's value to null, you may either set its value to null or omit that field from the object you post. + * + * ### Security Policies + * + * * This API requires the user role Compliance Root User. * * This API depends on the following active services:*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged. * Swagger Name: AvaTaxClient - * - * @param int $id The ID of the AvaFileForm you wish to update + * + * @param int $id The ID of the AvaFileForm you wish to update * @param AvaFileFormModel $model The AvaFileForm model you wish to update. * @return AvaFileFormModel */ @@ -644,31 +644,31 @@ public function updateAvaFileForm($id, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'PUT', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'PUT', $guzzleParams,'22.8.0' ); } /** * Cancel an in progress batch * - * Marks the in progress batch identified by this URL as cancelled. - * - * Only JSON batches can be cancelled. If you attempt to cancel a file batch, you will receive an error message. - * - * Only in progress batches can be cancelled. If you attempt to cancel a batch that its status is not Waiting or Processing, you will receive an error message. - * Cancelling an in progress batch does not delete any transactions that were created before the cancellation. - * - * Because the batch system processes with a degree of concurrency, and - * because of batch sizes in the queue vary, AvaTax API is unable to accurately - * predict when a batch will complete. If high performance processing is - * required, please use the - * [CreateTransaction API](https://developer.avalara.com/api-reference/avatax/rest/v2/methods/Transactions/CreateTransaction/). - * - * ### Security Policies - * + * Marks the in progress batch identified by this URL as cancelled. + * + * Only JSON batches can be cancelled. If you attempt to cancel a file batch, you will receive an error message. + * + * Only in progress batches can be cancelled. If you attempt to cancel a batch that its status is not Waiting or Processing, you will receive an error message. + * Cancelling an in progress batch does not delete any transactions that were created before the cancellation. + * + * Because the batch system processes with a degree of concurrency, and + * because of batch sizes in the queue vary, AvaTax API is unable to accurately + * predict when a batch will complete. If high performance processing is + * required, please use the + * [CreateTransaction API](https://developer.avalara.com/api-reference/avatax/rest/v2/methods/Transactions/CreateTransaction/). + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountOperator, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this batch. + * + * @param int $companyId The ID of the company that owns this batch. * @param int $id The ID of the batch to cancel. * @return BatchModel */ @@ -678,38 +678,38 @@ public function cancelBatch($companyId, $id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Create a new batch * - * Create one or more new batch objects attached to this company. - * - * Each batch object may have one or more file objects (currently only one file is supported). - * - * When a batch is created, it is added to the AvaTax Batch Queue and will be - * processed as quickly as possible in the order it was received. To check the - * status of a batch, fetch the batch and retrieve the results of the batch - * operation. - * - * Because the batch system processes with a degree of concurrency, and - * because of batch sizes in the queue vary, AvaTax API is unable to accurately - * predict when a batch will complete. If high performance processing is - * required, please use the - * [CreateTransaction API](https://developer.avalara.com/api-reference/avatax/rest/v2/methods/Transactions/CreateTransaction/). - * - * The maximum content length of the request body is limited to 28.6 MB. If this limit - * is exceeded, a 404 Not Found status will be returned (possibly with a CORS error if - * the API is called from a browser). In this situation, please split the request into - * smaller batches. - * - * ### Security Policies - * + * Create one or more new batch objects attached to this company. + * + * Each batch object may have one or more file objects (currently only one file is supported). + * + * When a batch is created, it is added to the AvaTax Batch Queue and will be + * processed as quickly as possible in the order it was received. To check the + * status of a batch, fetch the batch and retrieve the results of the batch + * operation. + * + * Because the batch system processes with a degree of concurrency, and + * because of batch sizes in the queue vary, AvaTax API is unable to accurately + * predict when a batch will complete. If high performance processing is + * required, please use the + * [CreateTransaction API](https://developer.avalara.com/api-reference/avatax/rest/v2/methods/Transactions/CreateTransaction/). + * + * The maximum content length of the request body is limited to 28.6 MB. If this limit + * is exceeded, a 404 Not Found status will be returned (possibly with a CORS error if + * the API is called from a browser). In this situation, please split the request into + * smaller batches. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountOperator, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this batch. + * + * @param int $companyId The ID of the company that owns this batch. * @param BatchModel[] $model The batch you wish to create. * @return BatchModel[] */ @@ -719,36 +719,36 @@ public function createBatches($companyId, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Create a new transaction batch * - * Create a new transaction batch objects attached to this company. - * - * When a transaction batch is created, it is added to the AvaTax Batch v2 Queue and will be - * processed as quickly as possible in the order it was received. To check the - * status of a batch, fetch the batch and retrieve the results of the batch - * operation. - * - * Because the batch system processes with a degree of concurrency, and - * because of batch sizes in the queue vary, AvaTax API is unable to accurately - * predict when a batch will complete. If high performance processing is - * required, please use the - * [CreateTransaction API](https://developer.avalara.com/api-reference/avatax/rest/v2/methods/Transactions/CreateTransaction/). - * - * The maximum content length of the request body is limited to 28.6 MB. If this limit - * is exceeded, a 404 Not Found status will be returned (possibly with a CORS error if - * the API is called from a browser). In this situation, please split the request into - * smaller batches. - * - * ### Security Policies - * + * Create a new transaction batch objects attached to this company. + * + * When a transaction batch is created, it is added to the AvaTax Batch v2 Queue and will be + * processed as quickly as possible in the order it was received. To check the + * status of a batch, fetch the batch and retrieve the results of the batch + * operation. + * + * Because the batch system processes with a degree of concurrency, and + * because of batch sizes in the queue vary, AvaTax API is unable to accurately + * predict when a batch will complete. If high performance processing is + * required, please use the + * [CreateTransaction API](https://developer.avalara.com/api-reference/avatax/rest/v2/methods/Transactions/CreateTransaction/). + * + * The maximum content length of the request body is limited to 28.6 MB. If this limit + * is exceeded, a 404 Not Found status will be returned (possibly with a CORS error if + * the API is called from a browser). In this situation, please split the request into + * smaller batches. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountOperator, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this batch. + * + * @param int $companyId The ID of the company that owns this batch. * @param CreateTransactionBatchRequestModel $model The transaction batch you wish to create. * @return CreateTransactionBatchResponseModel */ @@ -758,29 +758,29 @@ public function createTransactionBatch($companyId, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Delete a single batch * - * Marks the batch identified by this URL as deleted. - * - * If you attempt to delete a batch that is being processed, you will receive an error message. - * Deleting a batch does not delete any transactions that were created by importing the batch. - * - * Because the batch system processes with a degree of concurrency, and - * because of batch sizes in the queue vary, AvaTax API is unable to accurately - * predict when a batch will complete. If high performance processing is - * required, please use the - * [CreateTransaction API](https://developer.avalara.com/api-reference/avatax/rest/v2/methods/Transactions/CreateTransaction/). - * - * ### Security Policies - * + * Marks the batch identified by this URL as deleted. + * + * If you attempt to delete a batch that is being processed, you will receive an error message. + * Deleting a batch does not delete any transactions that were created by importing the batch. + * + * Because the batch system processes with a degree of concurrency, and + * because of batch sizes in the queue vary, AvaTax API is unable to accurately + * predict when a batch will complete. If high performance processing is + * required, please use the + * [CreateTransaction API](https://developer.avalara.com/api-reference/avatax/rest/v2/methods/Transactions/CreateTransaction/). + * + * ### Security Policies + * * * This API requires one of the following user roles: BatchServiceAdmin, CSPAdmin, CSPTester, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this batch. + * + * @param int $companyId The ID of the company that owns this batch. * @param int $id The ID of the batch to delete. * @return ErrorDetail[] */ @@ -790,21 +790,21 @@ public function deleteBatch($companyId, $id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'DELETE', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'DELETE', $guzzleParams,'22.8.0' ); } /** * Download a single batch file * - * Download a single batch file identified by this URL. - * - * ### Security Policies - * + * Download a single batch file identified by this URL. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this batch - * @param int $batchId The ID of the batch object + * + * @param int $companyId The ID of the company that owns this batch + * @param int $batchId The ID of the batch object * @param int $id The primary key of this batch file object * @return object */ @@ -814,34 +814,34 @@ public function downloadBatch($companyId, $batchId, $id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve a single batch * - * Get the batch object identified by this URL. A batch object is a large - * collection of API calls stored in a compact file. - * - * Use this endpoint to retrieve the results or check the status of a batch. - * - * When a batch is created, it is added to the AvaTax Batch Queue and will be - * processed as quickly as possible in the order it was received. To check the - * status of a batch, fetch the batch and retrieve the results of the batch - * operation. - * - * Because the batch system processes with a degree of concurrency, and - * because of batch sizes in the queue vary, AvaTax API is unable to accurately - * predict when a batch will complete. If high performance processing is - * required, please use the - * [CreateTransaction API](https://developer.avalara.com/api-reference/avatax/rest/v2/methods/Transactions/CreateTransaction/). - * - * ### Security Policies - * + * Get the batch object identified by this URL. A batch object is a large + * collection of API calls stored in a compact file. + * + * Use this endpoint to retrieve the results or check the status of a batch. + * + * When a batch is created, it is added to the AvaTax Batch Queue and will be + * processed as quickly as possible in the order it was received. To check the + * status of a batch, fetch the batch and retrieve the results of the batch + * operation. + * + * Because the batch system processes with a degree of concurrency, and + * because of batch sizes in the queue vary, AvaTax API is unable to accurately + * predict when a batch will complete. If high performance processing is + * required, please use the + * [CreateTransaction API](https://developer.avalara.com/api-reference/avatax/rest/v2/methods/Transactions/CreateTransaction/). + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this batch + * + * @param int $companyId The ID of the company that owns this batch * @param int $id The primary key of this batch * @return BatchModel */ @@ -851,44 +851,44 @@ public function getBatch($companyId, $id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve all batches for this company * - * List all batch objects attached to the specified company. - * - * A batch object is a large collection of API calls stored in a compact file. - * - * Search for specific objects using the criteria in the `$filter` parameter; - * full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . - * Paginate results using the `$top`, `$skip`, and `$orderby` parameters. - * - * Use [GetBatch](https://developer.avalara.com/api-reference/avatax/rest/v2/methods/Batches/GetBatch/) - * to retrieve the results, or check the status, of an individual batch. - * - * When a batch is created, it is added to the AvaTax Batch Queue and will be - * processed as quickly as possible in the order it was received. To check the - * status of a batch, fetch the batch and retrieve the results of the batch - * operation. - * - * Because the batch system processes with a degree of concurrency, and - * because of batch sizes in the queue vary, AvaTax API is unable to accurately - * predict when a batch will complete. If high performance processing is - * required, please use the - * [CreateTransaction API](https://developer.avalara.com/api-reference/avatax/rest/v2/methods/Transactions/CreateTransaction/). - * - * ### Security Policies - * + * List all batch objects attached to the specified company. + * + * A batch object is a large collection of API calls stored in a compact file. + * + * Search for specific objects using the criteria in the `$filter` parameter; + * full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . + * Paginate results using the `$top`, `$skip`, and `$orderby` parameters. + * + * Use [GetBatch](https://developer.avalara.com/api-reference/avatax/rest/v2/methods/Batches/GetBatch/) + * to retrieve the results, or check the status, of an individual batch. + * + * When a batch is created, it is added to the AvaTax Batch Queue and will be + * processed as quickly as possible in the order it was received. To check the + * status of a batch, fetch the batch and retrieve the results of the batch + * operation. + * + * Because the batch system processes with a degree of concurrency, and + * because of batch sizes in the queue vary, AvaTax API is unable to accurately + * predict when a batch will complete. If high performance processing is + * required, please use the + * [CreateTransaction API](https://developer.avalara.com/api-reference/avatax/rest/v2/methods/Transactions/CreateTransaction/). + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns these batches - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* files - * @param string $include A comma separated list of additional data to retrieve. - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param int $companyId The ID of the company that owns these batches + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* files + * @param string $include A comma separated list of additional data to retrieve. + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -898,40 +898,40 @@ public function listBatchesByCompany($companyId, $filter=null, $include=null, $t 'query' => ['$filter' => $filter, '$include' => $include, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve all batches * - * Get multiple batch objects across all companies. - * - * A batch object is a large collection of API calls stored in a compact file. - * - * Search for specific objects using the criteria in the `$filter` parameter; - * full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . - * Paginate results using the `$top`, `$skip`, and `$orderby` parameters. - * - * When a batch is created, it is added to the AvaTax Batch Queue and will be - * processed as quickly as possible in the order it was received. To check the - * status of a batch, fetch the batch and retrieve the results of the batch - * operation. - * - * Because the batch system processes with a degree of concurrency, and - * because of batch sizes in the queue vary, AvaTax API is unable to accurately - * predict when a batch will complete. If high performance processing is - * required, please use the - * [CreateTransaction API](https://developer.avalara.com/api-reference/avatax/rest/v2/methods/Transactions/CreateTransaction/). - * - * ### Security Policies - * + * Get multiple batch objects across all companies. + * + * A batch object is a large collection of API calls stored in a compact file. + * + * Search for specific objects using the criteria in the `$filter` parameter; + * full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . + * Paginate results using the `$top`, `$skip`, and `$orderby` parameters. + * + * When a batch is created, it is added to the AvaTax Batch Queue and will be + * processed as quickly as possible in the order it was received. To check the + * status of a batch, fetch the batch and retrieve the results of the batch + * operation. + * + * Because the batch system processes with a degree of concurrency, and + * because of batch sizes in the queue vary, AvaTax API is unable to accurately + * predict when a batch will complete. If high performance processing is + * required, please use the + * [CreateTransaction API](https://developer.avalara.com/api-reference/avatax/rest/v2/methods/Transactions/CreateTransaction/). + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* files - * @param string $include A comma separated list of additional data to retrieve. - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* files + * @param string $include A comma separated list of additional data to retrieve. + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -941,36 +941,36 @@ public function queryBatches($filter=null, $include=null, $top=null, $skip=null, 'query' => ['$filter' => $filter, '$include' => $include, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Create a CertExpress invitation * - * Creates an invitation for a customer to self-report certificates using the CertExpress website. - * - * This invitation is delivered by your choice of method, or you can present a hyperlink to the user - * directly in your connector. Your customer will be redirected to https://app.certexpress.com/ where - * they can follow a step-by-step guide to enter information about their exemption certificates. The - * certificates entered will be recorded and automatically linked to their customer record. - * - * The [CertExpress website](https://app.certexpress.com/home) is available for customers to use at any time. - * Using CertExpress with this API will ensure that your certificates are automatically linked correctly into - * your company so that they can be used for tax exemptions. - * - * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. - * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption - * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption - * certificate storage for this company, call `RequestCertificateSetup`. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin. + * Creates an invitation for a customer to self-report certificates using the CertExpress website. + * + * This invitation is delivered by your choice of method, or you can present a hyperlink to the user + * directly in your connector. Your customer will be redirected to https://app.certexpress.com/ where + * they can follow a step-by-step guide to enter information about their exemption certificates. The + * certificates entered will be recorded and automatically linked to their customer record. + * + * The [CertExpress website](https://app.certexpress.com/home) is available for customers to use at any time. + * Using CertExpress with this API will ensure that your certificates are automatically linked correctly into + * your company so that they can be used for tax exemptions. + * + * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. + * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption + * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption + * certificate storage for this company, call `RequestCertificateSetup`. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * - * @param int $companyId The unique ID number of the company that will record certificates - * @param string $customerCode The number of the customer where the request is sent to + * + * @param int $companyId The unique ID number of the company that will record certificates + * @param string $customerCode The number of the customer where the request is sent to * @param CreateCertExpressInvitationModel[] $model the requests to send out to customers * @return CertExpressInvitationStatusModel[] */ @@ -980,37 +980,37 @@ public function createCertExpressInvitation($companyId, $customerCode, $model) 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Retrieve a single CertExpress invitation * - * Retrieve an existing CertExpress invitation sent to a customer. - * - * A CertExpression invitation allows a customer to follow a helpful step-by-step guide to provide information - * about their certificates. This step by step guide allows the customer to complete and upload the full - * certificate in a convenient, friendly web browser experience. When the customer completes their certificates, - * they will automatically be recorded to your company and linked to the customer record. - * - * The [CertExpress website](https://app.certexpress.com/home) is available for customers to use at any time. - * Using CertExpress with this API will ensure that your certificates are automatically linked correctly into - * your company so that they can be used for tax exemptions. - * - * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. - * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption - * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption - * certificate storage for this company, call `RequestCertificateSetup`. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * Retrieve an existing CertExpress invitation sent to a customer. + * + * A CertExpression invitation allows a customer to follow a helpful step-by-step guide to provide information + * about their certificates. This step by step guide allows the customer to complete and upload the full + * certificate in a convenient, friendly web browser experience. When the customer completes their certificates, + * they will automatically be recorded to your company and linked to the customer record. + * + * The [CertExpress website](https://app.certexpress.com/home) is available for customers to use at any time. + * Using CertExpress with this API will ensure that your certificates are automatically linked correctly into + * your company so that they can be used for tax exemptions. + * + * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. + * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption + * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption + * certificate storage for this company, call `RequestCertificateSetup`. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * - * @param int $companyId The unique ID number of the company that issued this invitation - * @param string $customerCode The number of the customer where the request is sent to - * @param int $id The unique ID number of this CertExpress invitation + * + * @param int $companyId The unique ID number of the company that issued this invitation + * @param string $customerCode The number of the customer where the request is sent to + * @param int $id The unique ID number of this CertExpress invitation * @param string $include OPTIONAL: A comma separated list of special fetch options. No options are defined at this time. * @return CertExpressInvitationModel */ @@ -1020,39 +1020,39 @@ public function getCertExpressInvitation($companyId, $customerCode, $id, $includ 'query' => ['$include' => $include], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * List CertExpress invitations * - * Retrieve CertExpress invitations sent by this company. - * - * A CertExpression invitation allows a customer to follow a helpful step-by-step guide to provide information - * about their certificates. This step by step guide allows the customer to complete and upload the full - * certificate in a convenient, friendly web browser experience. When the customer completes their certificates, - * they will automatically be recorded to your company and linked to the customer record. - * - * The [CertExpress website](https://app.certexpress.com/home) is available for customers to use at any time. - * Using CertExpress with this API will ensure that your certificates are automatically linked correctly into - * your company so that they can be used for tax exemptions. - * - * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. - * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption - * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption - * certificate storage for this company, call `RequestCertificateSetup`. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * Retrieve CertExpress invitations sent by this company. + * + * A CertExpression invitation allows a customer to follow a helpful step-by-step guide to provide information + * about their certificates. This step by step guide allows the customer to complete and upload the full + * certificate in a convenient, friendly web browser experience. When the customer completes their certificates, + * they will automatically be recorded to your company and linked to the customer record. + * + * The [CertExpress website](https://app.certexpress.com/home) is available for customers to use at any time. + * Using CertExpress with this API will ensure that your certificates are automatically linked correctly into + * your company so that they can be used for tax exemptions. + * + * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. + * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption + * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption + * certificate storage for this company, call `RequestCertificateSetup`. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * - * @param int $companyId The unique ID number of the company that issued this invitation - * @param string $include OPTIONAL: A comma separated list of special fetch options. No options are defined at this time. - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* companyId, customer, coverLetter, exposureZones, exemptReasons, requestLink - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param int $companyId The unique ID number of the company that issued this invitation + * @param string $include OPTIONAL: A comma separated list of special fetch options. No options are defined at this time. + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* companyId, customer, coverLetter, exposureZones, exemptReasons, requestLink + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -1062,42 +1062,42 @@ public function listCertExpressInvitations($companyId, $include=null, $filter=nu 'query' => ['$include' => $include, '$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Create certificates for this company * - * Record one or more certificates document for this company. - * - * A certificate is a document stored in either AvaTax Exemptions or CertCapture. The certificate document - * can contain information about a customer's eligibility for exemption from sales or use taxes based on - * criteria you specify when you store the certificate. To view or manage your certificates directly, please - * log onto the administrative website for the product you purchased. - * - * When you create a certificate, it will be processed by Avalara and will become available for use in - * calculating tax exemptions when processing is complete. For a certificate to be used in calculating exemptions, - * it must have the following: - * - * * An exposure zone indicating where the certificate is valid - * * A link to the customer that is allowed to use this certificate - * * Your tax transaction must contain the correct customer code - * - * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. - * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption - * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption - * certificate storage for this company, call `RequestCertificateSetup`. - * - * If the users specified in the certificates do not exist, the API will create the user and link them to the certificate - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. + * Record one or more certificates document for this company. + * + * A certificate is a document stored in either AvaTax Exemptions or CertCapture. The certificate document + * can contain information about a customer's eligibility for exemption from sales or use taxes based on + * criteria you specify when you store the certificate. To view or manage your certificates directly, please + * log onto the administrative website for the product you purchased. + * + * When you create a certificate, it will be processed by Avalara and will become available for use in + * calculating tax exemptions when processing is complete. For a certificate to be used in calculating exemptions, + * it must have the following: + * + * * An exposure zone indicating where the certificate is valid + * * A link to the customer that is allowed to use this certificate + * * Your tax transaction must contain the correct customer code + * + * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. + * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption + * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption + * certificate storage for this company, call `RequestCertificateSetup`. + * + * If the users specified in the certificates do not exist, the API will create the user and link them to the certificate + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID number of the company recording this certificate - * @param boolean $preValidatedExemptionReason If set to true, the certificate will bypass the human verification process. + * + * @param int $companyId The ID number of the company recording this certificate + * @param boolean $preValidatedExemptionReason If set to true, the certificate will bypass the human verification process. * @param CertificateModel[] $model Certificates to be created * @return CertificateModel[] */ @@ -1107,33 +1107,33 @@ public function createCertificates($companyId, $preValidatedExemptionReason, $mo 'query' => ['$preValidatedExemptionReason' => $preValidatedExemptionReason], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Revoke and delete a certificate * - * Revoke the certificate identified by this URL, then delete it. - * - * A certificate is a document stored in either AvaTax Exemptions or CertCapture. The certificate document - * can contain information about a customer's eligibility for exemption from sales or use taxes based on - * criteria you specify when you store the certificate. To view or manage your certificates directly, please - * log onto the administrative website for the product you purchased. - * - * Revoked certificates can no longer be used. - * - * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. - * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption - * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption - * certificate storage for this company, call `RequestCertificateSetup`. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin. + * Revoke the certificate identified by this URL, then delete it. + * + * A certificate is a document stored in either AvaTax Exemptions or CertCapture. The certificate document + * can contain information about a customer's eligibility for exemption from sales or use taxes based on + * criteria you specify when you store the certificate. To view or manage your certificates directly, please + * log onto the administrative website for the product you purchased. + * + * Revoked certificates can no longer be used. + * + * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. + * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption + * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption + * certificate storage for this company, call `RequestCertificateSetup`. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * - * @param int $companyId The unique ID number of the company that recorded this certificate + * + * @param int $companyId The unique ID number of the company that recorded this certificate * @param int $id The unique ID number of this certificate * @return ErrorDetail[] */ @@ -1143,36 +1143,36 @@ public function deleteCertificate($companyId, $id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'DELETE', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'DELETE', $guzzleParams,'22.8.0' ); } /** * Download an image for this certificate * - * Download an image or PDF file for this certificate. - * - * This API can be used to download either a single-page preview of the certificate or a full PDF document. - * To retrieve a preview image, set the `$type` parameter to `Jpeg` and the `$page` parameter to `1`. - * - * A certificate is a document stored in either AvaTax Exemptions or CertCapture. The certificate document - * can contain information about a customer's eligibility for exemption from sales or use taxes based on - * criteria you specify when you store the certificate. To view or manage your certificates directly, please - * log onto the administrative website for the product you purchased. - * - * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. - * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption - * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption - * certificate storage for this company, call `RequestCertificateSetup`. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * Download an image or PDF file for this certificate. + * + * This API can be used to download either a single-page preview of the certificate or a full PDF document. + * To retrieve a preview image, set the `$type` parameter to `Jpeg` and the `$page` parameter to `1`. + * + * A certificate is a document stored in either AvaTax Exemptions or CertCapture. The certificate document + * can contain information about a customer's eligibility for exemption from sales or use taxes based on + * criteria you specify when you store the certificate. To view or manage your certificates directly, please + * log onto the administrative website for the product you purchased. + * + * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. + * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption + * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption + * certificate storage for this company, call `RequestCertificateSetup`. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * - * @param int $companyId The unique ID number of the company that recorded this certificate - * @param int $id The unique ID number of this certificate - * @param int $page If you choose `$type`=`Jpeg`, you must specify which page number to retrieve. + * + * @param int $companyId The unique ID number of the company that recorded this certificate + * @param int $id The unique ID number of this certificate + * @param int $page If you choose `$type`=`Jpeg`, you must specify which page number to retrieve. * @param string $type The data format in which to retrieve the certificate image (See CertificatePreviewType::* for a list of allowable values) * @return object */ @@ -1182,38 +1182,38 @@ public function downloadCertificateImage($companyId, $id, $page, $type) { 'query' => ['$page' => $page, '$type' => $type], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve a single certificate * - * Get the current certificate identified by this URL. - * - * A certificate is a document stored in either AvaTax Exemptions or CertCapture. The certificate document - * can contain information about a customer's eligibility for exemption from sales or use taxes based on - * criteria you specify when you store the certificate. To view or manage your certificates directly, please - * log onto the administrative website for the product you purchased. - * - * You can use the `$include` parameter to fetch the following additional objects for expansion: - * - * * customers - Retrieves the list of customers linked to the certificate. - * * po_numbers - Retrieves all PO numbers tied to the certificate. - * * attributes - Retrieves all attributes applied to the certificate. - * - * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. - * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption - * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption - * certificate storage for this company, call `RequestCertificateSetup`. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * Get the current certificate identified by this URL. + * + * A certificate is a document stored in either AvaTax Exemptions or CertCapture. The certificate document + * can contain information about a customer's eligibility for exemption from sales or use taxes based on + * criteria you specify when you store the certificate. To view or manage your certificates directly, please + * log onto the administrative website for the product you purchased. + * + * You can use the `$include` parameter to fetch the following additional objects for expansion: + * + * * customers - Retrieves the list of customers linked to the certificate. + * * po_numbers - Retrieves all PO numbers tied to the certificate. + * * attributes - Retrieves all attributes applied to the certificate. + * + * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. + * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption + * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption + * certificate storage for this company, call `RequestCertificateSetup`. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID number of the company that recorded this certificate - * @param int $id The unique ID number of this certificate + * + * @param int $companyId The ID number of the company that recorded this certificate + * @param int $id The unique ID number of this certificate * @param string $include OPTIONAL: A comma separated list of special fetch options. You can specify one or more of the following: * customers - Retrieves the list of customers linked to the certificate. * po_numbers - Retrieves all PO numbers tied to the certificate. * attributes - Retrieves all attributes applied to the certificate. * @return CertificateModel */ @@ -1223,26 +1223,26 @@ public function getCertificate($companyId, $id, $include=null) { 'query' => ['$include' => $include], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Check a company's exemption certificate status. * - * Checks whether this company is configured to use exemption certificates in AvaTax. - * - * Exemption certificates are tracked through a different auditable data store than the one that - * holds AvaTax transactions. To use the AvaTax exemption certificate document store, please call - * `GetCertificateSetup` to see if your company is configured to use the exemption certificate - * document store. To request setup, please call `RequestCertificateSetup` and your company will - * be configured with data storage in the auditable certificate system. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * Checks whether this company is configured to use exemption certificates in AvaTax. + * + * Exemption certificates are tracked through a different auditable data store than the one that + * holds AvaTax transactions. To use the AvaTax exemption certificate document store, please call + * `GetCertificateSetup` to see if your company is configured to use the exemption certificate + * document store. To request setup, please call `RequestCertificateSetup` and your company will + * be configured with data storage in the auditable certificate system. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * + * * @param int $companyId The company ID to check * @return ProvisionStatusModel */ @@ -1252,35 +1252,35 @@ public function getCertificateSetup($companyId) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Link attributes to a certificate * - * Link one or many attributes to a certificate. - * - * A certificate may have multiple attributes that control its behavior. You may link or unlink attributes to a - * certificate at any time. The full list of defined attributes may be found using `ListCertificateAttributes`. - * - * A certificate is a document stored in either AvaTax Exemptions or CertCapture. The certificate document - * can contain information about a customer's eligibility for exemption from sales or use taxes based on - * criteria you specify when you store the certificate. To view or manage your certificates directly, please - * log onto the administrative website for the product you purchased. - * - * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. - * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption - * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption - * certificate storage for this company, call `RequestCertificateSetup`. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin. + * Link one or many attributes to a certificate. + * + * A certificate may have multiple attributes that control its behavior. You may link or unlink attributes to a + * certificate at any time. The full list of defined attributes may be found using `ListCertificateAttributes`. + * + * A certificate is a document stored in either AvaTax Exemptions or CertCapture. The certificate document + * can contain information about a customer's eligibility for exemption from sales or use taxes based on + * criteria you specify when you store the certificate. To view or manage your certificates directly, please + * log onto the administrative website for the product you purchased. + * + * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. + * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption + * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption + * certificate storage for this company, call `RequestCertificateSetup`. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * - * @param int $companyId The unique ID number of the company that recorded this certificate - * @param int $id The unique ID number of this certificate + * + * @param int $companyId The unique ID number of the company that recorded this certificate + * @param int $id The unique ID number of this certificate * @param CertificateAttributeModel[] $model The list of attributes to link to this certificate. * @return FetchResult */ @@ -1290,36 +1290,36 @@ public function linkAttributesToCertificate($companyId, $id, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Link customers to a certificate * - * Link one or more customers to an existing certificate. - * - * Customers and certificates must be linked before a customer can make use of a certificate to obtain - * a tax exemption in AvaTax. Since some certificates may cover more than one business entity, a certificate - * can be connected to multiple customer records using the `LinkCustomersToCertificate` API. - * - * A certificate is a document stored in either AvaTax Exemptions or CertCapture. The certificate document - * can contain information about a customer's eligibility for exemption from sales or use taxes based on - * criteria you specify when you store the certificate. To view or manage your certificates directly, please - * log onto the administrative website for the product you purchased. - * - * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. - * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption - * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption - * certificate storage for this company, call `RequestCertificateSetup`. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin. + * Link one or more customers to an existing certificate. + * + * Customers and certificates must be linked before a customer can make use of a certificate to obtain + * a tax exemption in AvaTax. Since some certificates may cover more than one business entity, a certificate + * can be connected to multiple customer records using the `LinkCustomersToCertificate` API. + * + * A certificate is a document stored in either AvaTax Exemptions or CertCapture. The certificate document + * can contain information about a customer's eligibility for exemption from sales or use taxes based on + * criteria you specify when you store the certificate. To view or manage your certificates directly, please + * log onto the administrative website for the product you purchased. + * + * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. + * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption + * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption + * certificate storage for this company, call `RequestCertificateSetup`. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * - * @param int $companyId The unique ID number of the company that recorded this certificate - * @param int $id The unique ID number of this certificate + * + * @param int $companyId The unique ID number of the company that recorded this certificate + * @param int $id The unique ID number of this certificate * @param LinkCustomersModel $model The list of customers needed be added to the Certificate for exemption * @return FetchResult */ @@ -1329,34 +1329,34 @@ public function linkCustomersToCertificate($companyId, $id, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * List all attributes applied to this certificate * - * Retrieve the list of attributes that are linked to this certificate. - * - * A certificate may have multiple attributes that control its behavior. You may link or unlink attributes to a - * certificate at any time. The full list of defined attributes may be found using [ListCertificateAttributes](https://developer.avalara.com/api-reference/avatax/rest/v2/methods/Definitions/ListCertificateAttributes/) API. - * - * A certificate is a document stored in either AvaTax Exemptions or CertCapture. The certificate document - * can contain information about a customer's eligibility for exemption from sales or use taxes based on - * criteria you specify when you store the certificate. To view or manage your certificates directly, please - * log onto the administrative website for the product you purchased. - * - * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. - * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption - * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption - * certificate storage for this company, call `RequestCertificateSetup`. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin. + * Retrieve the list of attributes that are linked to this certificate. + * + * A certificate may have multiple attributes that control its behavior. You may link or unlink attributes to a + * certificate at any time. The full list of defined attributes may be found using [ListCertificateAttributes](https://developer.avalara.com/api-reference/avatax/rest/v2/methods/Definitions/ListCertificateAttributes/) API. + * + * A certificate is a document stored in either AvaTax Exemptions or CertCapture. The certificate document + * can contain information about a customer's eligibility for exemption from sales or use taxes based on + * criteria you specify when you store the certificate. To view or manage your certificates directly, please + * log onto the administrative website for the product you purchased. + * + * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. + * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption + * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption + * certificate storage for this company, call `RequestCertificateSetup`. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * - * @param int $companyId The unique ID number of the company that recorded this certificate + * + * @param int $companyId The unique ID number of the company that recorded this certificate * @param int $id The unique ID number of this certificate * @return FetchResult */ @@ -1366,35 +1366,35 @@ public function listAttributesForCertificate($companyId, $id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * List customers linked to this certificate * - * List all customers linked to this certificate. - * - * Customers must be linked to a certificate in order to make use of its tax exemption features. You - * can link or unlink customers to a certificate at any time. - * - * A certificate is a document stored in either AvaTax Exemptions or CertCapture. The certificate document - * can contain information about a customer's eligibility for exemption from sales or use taxes based on - * criteria you specify when you store the certificate. To view or manage your certificates directly, please - * log onto the administrative website for the product you purchased. - * - * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. - * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption - * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption - * certificate storage for this company, call `RequestCertificateSetup`. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin. + * List all customers linked to this certificate. + * + * Customers must be linked to a certificate in order to make use of its tax exemption features. You + * can link or unlink customers to a certificate at any time. + * + * A certificate is a document stored in either AvaTax Exemptions or CertCapture. The certificate document + * can contain information about a customer's eligibility for exemption from sales or use taxes based on + * criteria you specify when you store the certificate. To view or manage your certificates directly, please + * log onto the administrative website for the product you purchased. + * + * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. + * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption + * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption + * certificate storage for this company, call `RequestCertificateSetup`. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * - * @param int $companyId The unique ID number of the company that recorded this certificate - * @param int $id The unique ID number of this certificate + * + * @param int $companyId The unique ID number of the company that recorded this certificate + * @param int $id The unique ID number of this certificate * @param string $include OPTIONAL: A comma separated list of special fetch options. No options are currently available when fetching customers. * @return FetchResult */ @@ -1404,41 +1404,41 @@ public function listCustomersForCertificate($companyId, $id, $include=null) { 'query' => ['$include' => $include], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * List all certificates for a company * - * List all certificates recorded by a company - * - * A certificate is a document stored in either AvaTax Exemptions or CertCapture. The certificate document - * can contain information about a customer's eligibility for exemption from sales or use taxes based on - * criteria you specify when you store the certificate. To view or manage your certificates directly, please - * log onto the administrative website for the product you purchased. - * - * You can use the `$include` parameter to fetch the following additional objects for expansion: - * - * * customers - Retrieves the list of customers linked to the certificate. - * * po_numbers - Retrieves all PO numbers tied to the certificate. - * * attributes - Retrieves all attributes applied to the certificate. - * - * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. - * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption - * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption - * certificate storage for this company, call `RequestCertificateSetup`. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * List all certificates recorded by a company + * + * A certificate is a document stored in either AvaTax Exemptions or CertCapture. The certificate document + * can contain information about a customer's eligibility for exemption from sales or use taxes based on + * criteria you specify when you store the certificate. To view or manage your certificates directly, please + * log onto the administrative website for the product you purchased. + * + * You can use the `$include` parameter to fetch the following additional objects for expansion: + * + * * customers - Retrieves the list of customers linked to the certificate. + * * po_numbers - Retrieves all PO numbers tied to the certificate. + * * attributes - Retrieves all attributes applied to the certificate. + * + * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. + * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption + * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption + * certificate storage for this company, call `RequestCertificateSetup`. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID number of the company to search - * @param string $include OPTIONAL: A comma separated list of special fetch options. You can specify one or more of the following: * customers - Retrieves the list of customers linked to the certificate. * po_numbers - Retrieves all PO numbers tied to the certificate. * attributes - Retrieves all attributes applied to the certificate. - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* exemptionNumber, status, ecmsId, ecmsStatus, pdf, pages - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param int $companyId The ID number of the company to search + * @param string $include OPTIONAL: A comma separated list of special fetch options. You can specify one or more of the following: * customers - Retrieves the list of customers linked to the certificate. * po_numbers - Retrieves all PO numbers tied to the certificate. * attributes - Retrieves all attributes applied to the certificate. + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* exemptionNumber, status, ecmsId, ecmsStatus, pdf, pages + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -1448,28 +1448,28 @@ public function queryCertificates($companyId, $include=null, $filter=null, $top= 'query' => ['$include' => $include, '$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Request setup of exemption certificates for this company. * - * Requests the setup of exemption certificates for this company. - * - * Exemption certificates are tracked through a different auditable data store than the one that - * holds AvaTax transactions. To use the AvaTax exemption certificate document store, please call - * `GetCertificateSetup` to see if your company is configured to use the exemption certificate - * document store. To request setup, please call `RequestCertificateSetup` and your company will - * be configured with data storage in the auditable certificate system. - * - * This API will return the current status of exemption certificate setup for this company. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * Requests the setup of exemption certificates for this company. + * + * Exemption certificates are tracked through a different auditable data store than the one that + * holds AvaTax transactions. To use the AvaTax exemption certificate document store, please call + * `GetCertificateSetup` to see if your company is configured to use the exemption certificate + * document store. To request setup, please call `RequestCertificateSetup` and your company will + * be configured with data storage in the auditable certificate system. + * + * This API will return the current status of exemption certificate setup for this company. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * + * * @param int $companyId * @return ProvisionStatusModel */ @@ -1479,35 +1479,35 @@ public function requestCertificateSetup($companyId) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Unlink attributes from a certificate * - * Unlink one or many attributes from a certificate. - * - * A certificate may have multiple attributes that control its behavior. You may link or unlink attributes to a - * certificate at any time. The full list of defined attributes may be found using `ListCertificateAttributes`. - * - * A certificate is a document stored in either AvaTax Exemptions or CertCapture. The certificate document - * can contain information about a customer's eligibility for exemption from sales or use taxes based on - * criteria you specify when you store the certificate. To view or manage your certificates directly, please - * log onto the administrative website for the product you purchased. - * - * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. - * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption - * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption - * certificate storage for this company, call `RequestCertificateSetup`. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin. + * Unlink one or many attributes from a certificate. + * + * A certificate may have multiple attributes that control its behavior. You may link or unlink attributes to a + * certificate at any time. The full list of defined attributes may be found using `ListCertificateAttributes`. + * + * A certificate is a document stored in either AvaTax Exemptions or CertCapture. The certificate document + * can contain information about a customer's eligibility for exemption from sales or use taxes based on + * criteria you specify when you store the certificate. To view or manage your certificates directly, please + * log onto the administrative website for the product you purchased. + * + * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. + * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption + * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption + * certificate storage for this company, call `RequestCertificateSetup`. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * - * @param int $companyId The unique ID number of the company that recorded this certificate - * @param int $id The unique ID number of this certificate + * + * @param int $companyId The unique ID number of the company that recorded this certificate + * @param int $id The unique ID number of this certificate * @param CertificateAttributeModel[] $model The list of attributes to unlink from this certificate. * @return FetchResult */ @@ -1517,37 +1517,37 @@ public function unlinkAttributesFromCertificate($companyId, $id, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Unlink customers from a certificate * - * Unlinks one or more customers from a certificate. - * - * Unlinking a certificate from a customer will prevent the certificate from being used to generate - * tax exemptions for the customer in the future. If any previous transactions for this customer had - * used this linked certificate, those transactions will be unchanged and will still have a link to the - * exemption certificate in question. - * - * A certificate is a document stored in either AvaTax Exemptions or CertCapture. The certificate document - * can contain information about a customer's eligibility for exemption from sales or use taxes based on - * criteria you specify when you store the certificate. To view or manage your certificates directly, please - * log onto the administrative website for the product you purchased. - * - * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. - * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption - * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption - * certificate storage for this company, call `RequestCertificateSetup`. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin. + * Unlinks one or more customers from a certificate. + * + * Unlinking a certificate from a customer will prevent the certificate from being used to generate + * tax exemptions for the customer in the future. If any previous transactions for this customer had + * used this linked certificate, those transactions will be unchanged and will still have a link to the + * exemption certificate in question. + * + * A certificate is a document stored in either AvaTax Exemptions or CertCapture. The certificate document + * can contain information about a customer's eligibility for exemption from sales or use taxes based on + * criteria you specify when you store the certificate. To view or manage your certificates directly, please + * log onto the administrative website for the product you purchased. + * + * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. + * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption + * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption + * certificate storage for this company, call `RequestCertificateSetup`. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * - * @param int $companyId The unique ID number of the company that recorded this certificate - * @param int $id The unique ID number of this certificate + * + * @param int $companyId The unique ID number of the company that recorded this certificate + * @param int $id The unique ID number of this certificate * @param LinkCustomersModel $model The list of customers to unlink from this certificate * @return FetchResult */ @@ -1557,32 +1557,32 @@ public function unlinkCustomersFromCertificate($companyId, $id, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Update a single certificate * - * Replace the certificate identified by this URL with a new one. - * - * A certificate is a document stored in either AvaTax Exemptions or CertCapture. The certificate document - * can contain information about a customer's eligibility for exemption from sales or use taxes based on - * criteria you specify when you store the certificate. To view or manage your certificates directly, please - * log onto the administrative website for the product you purchased. - * - * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. - * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption - * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption - * certificate storage for this company, call `RequestCertificateSetup`. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin. + * Replace the certificate identified by this URL with a new one. + * + * A certificate is a document stored in either AvaTax Exemptions or CertCapture. The certificate document + * can contain information about a customer's eligibility for exemption from sales or use taxes based on + * criteria you specify when you store the certificate. To view or manage your certificates directly, please + * log onto the administrative website for the product you purchased. + * + * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. + * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption + * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption + * certificate storage for this company, call `RequestCertificateSetup`. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID number of the company that recorded this certificate - * @param int $id The unique ID number of this certificate + * + * @param int $companyId The ID number of the company that recorded this certificate + * @param int $id The unique ID number of this certificate * @param CertificateModel $model The new certificate object that will replace the existing one * @return CertificateModel */ @@ -1592,35 +1592,35 @@ public function updateCertificate($companyId, $id, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'PUT', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'PUT', $guzzleParams,'22.8.0' ); } /** * Upload an image or PDF attachment for this certificate * - * Upload an image or PDF attachment for this certificate. - * - * Image attachments can be of the format `PDF`, `JPEG`, `TIFF`, or `PNG`. To upload a multi-page image, please - * use the `PDF` data type. - * - * A certificate is a document stored in either AvaTax Exemptions or CertCapture. The certificate document - * can contain information about a customer's eligibility for exemption from sales or use taxes based on - * criteria you specify when you store the certificate. To view or manage your certificates directly, please - * log onto the administrative website for the product you purchased. - * - * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. - * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption - * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption - * certificate storage for this company, call `RequestCertificateSetup`. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * Upload an image or PDF attachment for this certificate. + * + * Image attachments can be of the format `PDF`, `JPEG`, `TIFF`, or `PNG`. To upload a multi-page image, please + * use the `PDF` data type. + * + * A certificate is a document stored in either AvaTax Exemptions or CertCapture. The certificate document + * can contain information about a customer's eligibility for exemption from sales or use taxes based on + * criteria you specify when you store the certificate. To view or manage your certificates directly, please + * log onto the administrative website for the product you purchased. + * + * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. + * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption + * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption + * certificate storage for this company, call `RequestCertificateSetup`. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * - * @param int $companyId The unique ID number of the company that recorded this certificate - * @param int $id The unique ID number of this certificate + * + * @param int $companyId The unique ID number of the company that recorded this certificate + * @param int $id The unique ID number of this certificate * @param object $file The exemption certificate file you wanted to upload. Accepted formats are: PDF, JPEG, TIFF, PNG. * @return string */ @@ -1630,41 +1630,41 @@ public function uploadCertificateImage($companyId, $id, $file) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Checks whether the integration being used to set up this company and run transactions onto this company is compliant to all requirements. * - * Examines the most recent 100 transactions or data from the last month when verifying transaction-related integrations. - * For partners who write integrations against AvaTax for many clients, this API is a way to do a quick self testing to verify whether the - * written integrations for a company are sufficient enough to be delivered to the respective customers to start using it. - * - * This API provides messages specific enough (through predefined checks) to guide the partner on what integrations are still missing from the company to get fully certified. - * The API makes the following checks to conclude if the company is NOT fully certified: - * 1. Any past month items contains generic tax code of P0000000. - * 2. All the companies on the requesting account are test companies. - * 3. No Voided/Cancelled documents in the past 30 days. - * 4. There are less than 2 committed documents. - * 5. Any documentCode is a generic GUID string. - * 6. Any customerCode on document is a generic GUID string. - * 7. No document has more than 1 documentLine. - * 8. All of the documents have missing exemptionNo, customerUsageType, taxDateOverride or negative amount. - * 9. Any document quantity is a negative number. - * 10. Any document have repeated lines. - * 11. No document has shipping charge. - * 12. All documents have same ItemCodes, descriptions and taxCodes. - * 13. Less than 2 addresses used across all documents. - * 14. Whether locationCode was used in documents. - * 15. Account with AvaGlobal subscription and no documents have VATBuyerId. - * 16. Any document has currencyCode not being USD for accounts with AvaGlobal subscription. - * 17. All documents have countryCode used for accounts with AvaGlobal subscription. - * - * ### Security Policies - * + * Examines the most recent 100 transactions or data from the last month when verifying transaction-related integrations. + * For partners who write integrations against AvaTax for many clients, this API is a way to do a quick self testing to verify whether the + * written integrations for a company are sufficient enough to be delivered to the respective customers to start using it. + * + * This API provides messages specific enough (through predefined checks) to guide the partner on what integrations are still missing from the company to get fully certified. + * The API makes the following checks to conclude if the company is NOT fully certified: + * 1. Any past month items contains generic tax code of P0000000. + * 2. All the companies on the requesting account are test companies. + * 3. No Voided/Cancelled documents in the past 30 days. + * 4. There are less than 2 committed documents. + * 5. Any documentCode is a generic GUID string. + * 6. Any customerCode on document is a generic GUID string. + * 7. No document has more than 1 documentLine. + * 8. All of the documents have missing exemptionNo, customerUsageType, taxDateOverride or negative amount. + * 9. Any document quantity is a negative number. + * 10. Any document have repeated lines. + * 11. No document has shipping charge. + * 12. All documents have same ItemCodes, descriptions and taxCodes. + * 13. Less than 2 addresses used across all documents. + * 14. Whether locationCode was used in documents. + * 15. Account with AvaGlobal subscription and no documents have VATBuyerId. + * 16. Any document has currencyCode not being USD for accounts with AvaGlobal subscription. + * 17. All documents have countryCode used for accounts with AvaGlobal subscription. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * + * * @param int $id The ID of the company to check if its integration is certified. * @return string */ @@ -1674,32 +1674,32 @@ public function certifyIntegration($id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Change the filing status of this company * - * Changes the current filing status of this company. - * - * For customers using Avalara's Managed Returns Service, each company within their account can request - * for Avalara to file tax returns on their behalf. Avalara compliance team members will review all - * requested filing calendars prior to beginning filing tax returns on behalf of this company. - * - * The following changes may be requested through this API: - * - * * If a company is in `NotYetFiling` status, the customer may request this be changed to `FilingRequested`. - * * Avalara compliance team members may change a company from `FilingRequested` to `FirstFiling`. - * * Avalara compliance team members may change a company from `FirstFiling` to `Active`. - * - * All other status changes must be requested through the Avalara customer support team. - * - * ### Security Policies - * + * Changes the current filing status of this company. + * + * For customers using Avalara's Managed Returns Service, each company within their account can request + * for Avalara to file tax returns on their behalf. Avalara compliance team members will review all + * requested filing calendars prior to beginning filing tax returns on behalf of this company. + * + * The following changes may be requested through this API: + * + * * If a company is in `NotYetFiling` status, the customer may request this be changed to `FilingRequested`. + * * Avalara compliance team members may change a company from `FilingRequested` to `FirstFiling`. + * * Avalara compliance team members may change a company from `FirstFiling` to `Active`. + * + * All other status changes must be requested through the Avalara customer support team. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * - * @param int $id + * + * @param int $id * @param FilingStatusChangeModel $model * @return string */ @@ -1709,30 +1709,30 @@ public function changeFilingStatus($id, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Quick setup for a company with a single physical address * - * Shortcut to quickly setup a single-physical-location company with critical information and activate it. - * This API provides quick and simple company setup functionality and does the following things: - * - * * Create a company object with its own tax profile - * * Add a key contact person for the company - * * Set up one physical location for the main office - * * Declare nexus in all taxing jurisdictions for that main office address - * * Activate the company - * - * This API only provides a limited subset of functionality compared to the 'Create Company' API call. - * If you need additional features or options not present in this 'Quick Setup' API call, please use the full 'Create Company' call instead. - * Please allow 1 minute before making transactions using the company. - * - * ### Security Policies - * + * Shortcut to quickly setup a single-physical-location company with critical information and activate it. + * This API provides quick and simple company setup functionality and does the following things: + * + * * Create a company object with its own tax profile + * * Add a key contact person for the company + * * Set up one physical location for the main office + * * Declare nexus in all taxing jurisdictions for that main office address + * * Activate the company + * + * This API only provides a limited subset of functionality compared to the 'Create Company' API call. + * If you need additional features or options not present in this 'Quick Setup' API call, please use the full 'Create Company' call instead. + * Please allow 1 minute before making transactions using the company. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * + * * @param CompanyInitializationModel $model Information about the company you wish to create. * @return CompanyModel */ @@ -1742,23 +1742,23 @@ public function companyInitialize($model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Create new companies * - * Create one or more new company objects. - * A 'company' represents a single corporation or individual that is registered to handle transactional taxes. - * You may attach nested data objects such as contacts, locations, and nexus with this CREATE call, and those objects will be created with the company. - * - * NOTE: Please do not use these blacklisted characters in company name and code: ';', '\', '|'. - * - * ### Security Policies - * + * Create one or more new company objects. + * A 'company' represents a single corporation or individual that is registered to handle transactional taxes. + * You may attach nested data objects such as contacts, locations, and nexus with this CREATE call, and those objects will be created with the company. + * + * NOTE: Please do not use these blacklisted characters in company name and code: ';', '\', '|'. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * + * * @param CompanyModel[] $model Either a single company object or an array of companies to create * @return CompanyModel[] */ @@ -1768,30 +1768,30 @@ public function createCompanies($model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Add parameters to a company. * - * Add parameters to a company. - * - * Some companies can be taxed and reported differently depending on the properties of the company, such as IsPrimaryAddress. In AvaTax, these tax-affecting properties are called "parameters". - * - * A parameter added to a company will be used by default in tax calculation but will not show on the transaction line referencing the company. - * - * A company location parameter specified on a transaction line will override a company parameter if they share the same parameter name. - * - * To see available parameters for this company, call `/api/v2/definitions/parameters?$filter=attributeType eq Company` - * - * Some parameters are only available for use if you have subscribed to specific AvaTax services. To see which parameters you are able to use, add the query parameter "$showSubscribed=true" to the parameter definition call above. - * - * ### Security Policies - * + * Add parameters to a company. + * + * Some companies can be taxed and reported differently depending on the properties of the company, such as IsPrimaryAddress. In AvaTax, these tax-affecting properties are called "parameters". + * + * A parameter added to a company will be used by default in tax calculation but will not show on the transaction line referencing the company. + * + * A company location parameter specified on a transaction line will override a company parameter if they share the same parameter name. + * + * To see available parameters for this company, call `/api/v2/definitions/parameters?$filter=attributeType eq Company` + * + * Some parameters are only available for use if you have subscribed to specific AvaTax services. To see which parameters you are able to use, add the query parameter "$showSubscribed=true" to the parameter definition call above. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this company parameter. + * + * @param int $companyId The ID of the company that owns this company parameter. * @param CompanyParameterDetailModel[] $model The company parameters you wish to create. * @return CompanyParameterDetailModel[] */ @@ -1801,32 +1801,32 @@ public function createCompanyParameters($companyId, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Request managed returns funding setup for a company * - * This API is available by invitation only. - * Companies that use the Avalara Managed Returns or the SST Certified Service Provider services are - * required to setup their funding configuration before Avalara can begin filing tax returns on their - * behalf. - * Funding configuration for each company is set up by submitting a funding setup request, which can - * be sent either via email or via an embedded HTML widget. - * When the funding configuration is submitted to Avalara, it will be reviewed by treasury team members - * before approval. - * This API records that an ambedded HTML funding setup widget was activated. - * This API requires a subscription to Avalara Managed Returns or SST Certified Service Provider. - * - * ### Security Policies - * - * * This API depends on the following active services:*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp. + * This API is available by invitation only. + * Companies that use the Avalara Managed Returns or the SST Certified Service Provider services are + * required to setup their funding configuration before Avalara can begin filing tax returns on their + * behalf. + * Funding configuration for each company is set up by submitting a funding setup request, which can + * be sent either via email or via an embedded HTML widget. + * When the funding configuration is submitted to Avalara, it will be reviewed by treasury team members + * before approval. + * This API records that an ambedded HTML funding setup widget was activated. + * This API requires a subscription to Avalara Managed Returns or SST Certified Service Provider. + * + * ### Security Policies + * + * * This API depends on the following active services:*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp. * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * - * @param int $id The unique identifier of the company - * @param string $businessUnit The company's business unit (See POABusinessUnit::* for a list of allowable values) - * @param string $subscriptionType The company's subscription type (See POASubscriptionType::* for a list of allowable values) + * + * @param int $id The unique identifier of the company + * @param string $businessUnit The company's business unit (See POABusinessUnit::* for a list of allowable values) + * @param string $subscriptionType The company's subscription type (See POASubscriptionType::* for a list of allowable values) * @param FundingInitiateModel $model The funding initialization request * @return FundingStatusModel */ @@ -1836,19 +1836,19 @@ public function createFundingRequest($id, $businessUnit, $subscriptionType, $mod 'query' => ['businessUnit' => $businessUnit, 'subscriptionType' => $subscriptionType], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Delete a single company * - * Deleting a company will delete all child companies, and all users attached to this company. - * - * ### Security Policies - * + * Deleting a company will delete all child companies, and all users attached to this company. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, FirmAdmin, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * + * * @param int $id The ID of the company you wish to delete. * @return ErrorDetail[] */ @@ -1858,25 +1858,25 @@ public function deleteCompany($id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'DELETE', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'DELETE', $guzzleParams,'22.8.0' ); } /** * Delete a single company parameter * - * Delete a parameter of a company. - * Some companies can be taxed and reported differently depending on the properties of the company, such as IsPrimaryAddress. In AvaTax, these tax-affecting properties are called "parameters". - * - * A parameter added to a company will be used by default in tax calculation but will not show on the transaction line referencing the company. - * - * A company location parameter specified on a transaction line will override a company parameter if they share the same parameter name. - * - * ### Security Policies - * + * Delete a parameter of a company. + * Some companies can be taxed and reported differently depending on the properties of the company, such as IsPrimaryAddress. In AvaTax, these tax-affecting properties are called "parameters". + * + * A parameter added to a company will be used by default in tax calculation but will not show on the transaction line referencing the company. + * + * A company location parameter specified on a transaction line will override a company parameter if they share the same parameter name. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, FirmAdmin, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The company id + * + * @param int $companyId The company id * @param int $id The parameter id * @return ErrorDetail[] */ @@ -1886,23 +1886,23 @@ public function deleteCompanyParameter($companyId, $id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'DELETE', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'DELETE', $guzzleParams,'22.8.0' ); } /** * Check the funding configuration of a company * - * This API is available by invitation only. - * Requires a subscription to Avalara Managed Returns or SST Certified Service Provider. - * Returns the funding configuration of the requested company. - * . - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. + * This API is available by invitation only. + * Requires a subscription to Avalara Managed Returns or SST Certified Service Provider. + * Returns the funding configuration of the requested company. + * . + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * * This API depends on the following active services:*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged. * Swagger Name: AvaTaxClient - * + * * @param int $companyId The unique identifier of the company * @return FundingConfigurationModel */ @@ -1912,24 +1912,24 @@ public function fundingConfigurationByCompany($companyId) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Check the funding configuration of a company * - * This API is available by invitation only. - * Requires a subscription to Avalara Managed Returns or SST Certified Service Provider. - * Returns the funding configuration of the requested company. - * . - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. + * This API is available by invitation only. + * Requires a subscription to Avalara Managed Returns or SST Certified Service Provider. + * Returns the funding configuration of the requested company. + * . + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * * This API depends on the following active services:*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged. * Swagger Name: AvaTaxClient - * - * @param int $companyId The unique identifier of the company + * + * @param int $companyId The unique identifier of the company * @param string $currency The currency of the funding. USD and CAD are the only valid currencies * @return FundingConfigurationModel[] */ @@ -1939,32 +1939,32 @@ public function fundingConfigurationsByCompanyAndCurrency($companyId, $currency) 'query' => ['currency' => $currency], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve a single company * - * Get the company object identified by this URL. - * A 'company' represents a single corporation or individual that is registered to handle transactional taxes. - * You may specify one or more of the following values in the '$include' parameter to fetch additional nested data, using commas to separate multiple values: - * - * * Contacts - * * Items - * * Locations - * * Nexus - * * Settings - * * TaxCodes - * * TaxRules - * * UPC - * * Parameters - * - * ### Security Policies - * + * Get the company object identified by this URL. + * A 'company' represents a single corporation or individual that is registered to handle transactional taxes. + * You may specify one or more of the following values in the '$include' parameter to fetch additional nested data, using commas to separate multiple values: + * + * * Contacts + * * Items + * * Locations + * * Nexus + * * Settings + * * TaxCodes + * * TaxRules + * * UPC + * * Parameters + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * - * @param int $id The ID of the company to retrieve. + * + * @param int $id The ID of the company to retrieve. * @param string $include OPTIONAL: A comma separated list of special fetch options. * Child objects - Specify one or more of the following to retrieve objects related to each company: "Contacts", "FilingCalendars", "Items", "Locations", "Nexus", "TaxCodes", "NonReportingChildren" or "TaxRules". * Deleted objects - Specify "FetchDeleted" to retrieve information about previously deleted objects. * @return CompanyModel */ @@ -1974,30 +1974,30 @@ public function getCompany($id, $include=null) { 'query' => ['$include' => $include], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Get configuration settings for this company * - * Retrieve a list of all configuration settings tied to this company. - * - * Configuration settings provide you with the ability to control features of your account and of your - * tax software. The category name `AvaCertServiceConfig` is reserved for - * Avalara internal software configuration values; to store your own company-level settings, please - * create a new category name that begins with `X-`, for example, `X-MyCustomCategory`. - * - * Company settings are permanent settings that cannot be deleted. You can set the value of a - * company setting to null if desired and if the particular setting supports it. - * - * Avalara-based company settings for `AvaCertServiceConfig` affect your company's exemption certificate - * processing, and should be changed with care. - * - * ### Security Policies - * + * Retrieve a list of all configuration settings tied to this company. + * + * Configuration settings provide you with the ability to control features of your account and of your + * tax software. The category name `AvaCertServiceConfig` is reserved for + * Avalara internal software configuration values; to store your own company-level settings, please + * create a new category name that begins with `X-`, for example, `X-MyCustomCategory`. + * + * Company settings are permanent settings that cannot be deleted. You can set the value of a + * company setting to null if desired and if the particular setting supports it. + * + * Avalara-based company settings for `AvaCertServiceConfig` affect your company's exemption certificate + * processing, and should be changed with care. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * + * * @param int $id * @return CompanyConfigurationModel[] */ @@ -2007,26 +2007,26 @@ public function getCompanyConfiguration($id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve a single company parameter * - * Retrieves a single parameter of a company. - * - * Some companies can be taxed and reported differently depending on the properties of the company, such as IsPrimaryAddress. In AvaTax, these tax-affecting properties are called "parameters". - * - * A parameter added to a company will be used by default in tax calculation but will not show on the transaction line referencing the company. - * - * A company location parameter specified on a transaction line will override a company parameter if they share the same parameter name. - * - * ### Security Policies - * + * Retrieves a single parameter of a company. + * + * Some companies can be taxed and reported differently depending on the properties of the company, such as IsPrimaryAddress. In AvaTax, these tax-affecting properties are called "parameters". + * + * A parameter added to a company will be used by default in tax calculation but will not show on the transaction line referencing the company. + * + * A company location parameter specified on a transaction line will override a company parameter if they share the same parameter name. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * - * @param int $companyId + * + * @param int $companyId * @param int $id * @return CompanyParameterDetailModel */ @@ -2036,32 +2036,32 @@ public function getCompanyParameterDetail($companyId, $id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Get this company's filing status * - * Retrieve the current filing status of this company. - * - * For customers using Avalara's Managed Returns Service, each company within their account can request - * for Avalara to file tax returns on their behalf. Avalara compliance team members will review all - * requested filing calendars prior to beginning filing tax returns on behalf of this company. - * - * A company's filing status can be one of the following values: - * - * * `NoReporting` - This company is not configured to report tax returns; instead, it reports through a parent company. - * * `NotYetFiling` - This company has not yet begun filing tax returns through Avalara's Managed Returns Service. - * * `FilingRequested` - The company has requested to begin filing tax returns, but Avalara's compliance team has not yet begun filing. - * * `FirstFiling` - The company has recently filing tax returns and is in a new status. - * * `Active` - The company is currently active and is filing tax returns via Avalara Managed Returns. - * * `Inactive` - The company is currently inactive. - * - * ### Security Policies - * + * Retrieve the current filing status of this company. + * + * For customers using Avalara's Managed Returns Service, each company within their account can request + * for Avalara to file tax returns on their behalf. Avalara compliance team members will review all + * requested filing calendars prior to beginning filing tax returns on behalf of this company. + * + * A company's filing status can be one of the following values: + * + * * `NoReporting` - This company is not configured to report tax returns; instead, it reports through a parent company. + * * `NotYetFiling` - This company has not yet begun filing tax returns through Avalara's Managed Returns Service. + * * `FilingRequested` - The company has requested to begin filing tax returns, but Avalara's compliance team has not yet begun filing. + * * `FirstFiling` - The company has recently filing tax returns and is in a new status. + * * `Active` - The company is currently active and is filing tax returns via Avalara Managed Returns. + * * `Inactive` - The company is currently inactive. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * + * * @param int $id * @return string */ @@ -2071,25 +2071,25 @@ public function getFilingStatus($id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Get ACH entry detail report for company and period * - * This API is available by invitation only. - * Requires a subscription to Avalara Managed Returns or SST Certified Service Provider. - * Returns a list of ACH entry details for the given company and period. - * Each object in the result is an ach entry trace record for a payment made on behalf of this company. - * - * ### Security Policies - * - * * This API depends on the following active services:*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp. + * This API is available by invitation only. + * Requires a subscription to Avalara Managed Returns or SST Certified Service Provider. + * Returns a list of ACH entry details for the given company and period. + * Each object in the result is an ach entry trace record for a payment made on behalf of this company. + * + * ### Security Policies + * + * * This API depends on the following active services:*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp. * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * - * @param int $id The unique identifier of the company - * @param int $periodyear The period year + * + * @param int $id The unique identifier of the company + * @param int $periodyear The period year * @param int $periodmonth The period month * @return ACHEntryDetailModel[] */ @@ -2099,32 +2099,32 @@ public function listACHEntryDetailsForCompany($id, $periodyear, $periodmonth) 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve parameters for a company * - * Retrieve all parameters of a company. - * - * Some companies can be taxed and reported differently depending on the properties of the company, such as IsPrimaryAddress. In AvaTax, these tax-affecting properties are called "parameters". - * - * A parameter added to a company will be used by default in tax calculation but will not show on the transaction line referencing the company. - * - * A company location parameter specified on a transaction line will override a company parameter if they share the same parameter name. - * - * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . - * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. - * - * ### Security Policies - * + * Retrieve all parameters of a company. + * + * Some companies can be taxed and reported differently depending on the properties of the company, such as IsPrimaryAddress. In AvaTax, these tax-affecting properties are called "parameters". + * + * A parameter added to a company will be used by default in tax calculation but will not show on the transaction line referencing the company. + * + * A company location parameter specified on a transaction line will override a company parameter if they share the same parameter name. + * + * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . + * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * - * @param int $companyId The company id - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* name, unit - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param int $companyId The company id + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* name, unit + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -2134,23 +2134,23 @@ public function listCompanyParameterDetails($companyId, $filter=null, $top=null, 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Check managed returns funding status for a company * - * This API is available by invitation only. - * Requires a subscription to Avalara Managed Returns or SST Certified Service Provider. - * Returns a list of funding setup requests and their current status. - * Each object in the result is a request that was made to setup or adjust funding status for this company. - * - * ### Security Policies - * - * * This API depends on the following active services:*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp. + * This API is available by invitation only. + * Requires a subscription to Avalara Managed Returns or SST Certified Service Provider. + * Returns a list of funding setup requests and their current status. + * Each object in the result is a request that was made to setup or adjust funding status for this company. + * + * ### Security Policies + * + * * This API depends on the following active services:*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp. * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * + * * @param int $id The unique identifier of the company * @return FundingStatusModel[] */ @@ -2160,18 +2160,18 @@ public function listFundingRequestsByCompany($id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve a list of MRS Companies with account * - * This API is available by invitation only. - * - * Get a list of companies with an active MRS service. - * - * ### Security Policies - * + * This API is available by invitation only. + * + * Get a list of companies with an active MRS service. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient * @@ -2183,39 +2183,39 @@ public function listMrsCompanies() { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve all companies * - * Get multiple company objects. - * - * A `company` represents a single corporation or individual that is registered to handle transactional taxes. - * - * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . - * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. - * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: - * - * * Contacts - * * Items - * * Locations - * * Nexus - * * Settings - * * TaxCodes - * * TaxRules - * * UPC - * * Parameters - * - * ### Security Policies - * + * Get multiple company objects. + * + * A `company` represents a single corporation or individual that is registered to handle transactional taxes. + * + * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . + * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. + * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: + * + * * Contacts + * * Items + * * Locations + * * Nexus + * * Settings + * * TaxCodes + * * TaxRules + * * UPC + * * Parameters + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * - * @param string $include A comma separated list of objects to fetch underneath this company. Any object with a URL path underneath this company can be fetched by specifying its name. - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* IsFein, contacts, items, locations, nexus, settings, taxCodes, taxRules, upcs, nonReportingChildCompanies, exemptCerts, parameters, supplierandcustomers - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $include A comma separated list of objects to fetch underneath this company. Any object with a URL path underneath this company can be fetched by specifying its name. + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* IsFein, contacts, items, locations, nexus, settings, taxCodes, taxRules, upcs, nonReportingChildCompanies, exemptCerts, parameters, supplierandcustomers + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -2225,31 +2225,31 @@ public function queryCompanies($include=null, $filter=null, $top=null, $skip=nul 'query' => ['$include' => $include, '$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Change configuration settings for this company * - * Update configuration settings tied to this company. - * - * Configuration settings provide you with the ability to control features of your account and of your - * tax software. The category names `AvaCertServiceConfig` is reserved for - * Avalara internal software configuration values; to store your own company-level settings, please - * create a new category name that begins with `X-`, for example, `X-MyCustomCategory`. - * - * Company settings are permanent settings that cannot be deleted. You can set the value of a - * company setting to null if desired and if the particular setting supports it. - * - * Avalara-based company settings for `AvaCertServiceConfig` affect your company's exemption certificate - * processing, and should be changed with care. - * - * ### Security Policies - * + * Update configuration settings tied to this company. + * + * Configuration settings provide you with the ability to control features of your account and of your + * tax software. The category names `AvaCertServiceConfig` is reserved for + * Avalara internal software configuration values; to store your own company-level settings, please + * create a new category name that begins with `X-`, for example, `X-MyCustomCategory`. + * + * Company settings are permanent settings that cannot be deleted. You can set the value of a + * company setting to null if desired and if the particular setting supports it. + * + * Avalara-based company settings for `AvaCertServiceConfig` affect your company's exemption certificate + * processing, and should be changed with care. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $id + * + * @param int $id * @param CompanyConfigurationModel[] $model * @return CompanyConfigurationModel[] */ @@ -2259,30 +2259,30 @@ public function setCompanyConfiguration($id, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Update a single company * - * Replace the existing company object at this URL with an updated object. - * - * A `CompanyModel` represents a single corporation or individual that is registered to handle transactional taxes. - * All data from the existing object will be replaced with data in the object you PUT. - * - * When calling `UpdateCompany`, you are permitted to update the company itself. Updates to the nested objects - * such as contacts, locations, or settings are not permitted. To update the nested objects - * - * To set a field's value to `null`, you may either set its value to `null` or omit that field from the object you PUT. - * - * NOTE: Please do not use these blacklisted characters in company name and code: ';', '\', '|'. - * - * ### Security Policies - * + * Replace the existing company object at this URL with an updated object. + * + * A `CompanyModel` represents a single corporation or individual that is registered to handle transactional taxes. + * All data from the existing object will be replaced with data in the object you PUT. + * + * When calling `UpdateCompany`, you are permitted to update the company itself. Updates to the nested objects + * such as contacts, locations, or settings are not permitted. To update the nested objects + * + * To set a field's value to `null`, you may either set its value to `null` or omit that field from the object you PUT. + * + * NOTE: Please do not use these blacklisted characters in company name and code: ';', '\', '|'. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $id The ID of the company you wish to update. + * + * @param int $id The ID of the company you wish to update. * @param CompanyModel $model The company object you wish to update. * @return CompanyModel */ @@ -2292,27 +2292,27 @@ public function updateCompany($id, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'PUT', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'PUT', $guzzleParams,'22.8.0' ); } /** * Update a company parameter * - * Update a parameter of a company. - * - * Some companies can be taxed and reported differently depending on the properties of the company, such as IsPrimaryAddress. In AvaTax, these tax-affecting properties are called "parameters". - * - * A parameter added to a company will be used by default in tax calculation but will not show on the transaction line referencing the company. - * - * A company location parameter specified on a transaction line will override a company parameter if they share the same parameter name. - * - * ### Security Policies - * + * Update a parameter of a company. + * + * Some companies can be taxed and reported differently depending on the properties of the company, such as IsPrimaryAddress. In AvaTax, these tax-affecting properties are called "parameters". + * + * A parameter added to a company will be used by default in tax calculation but will not show on the transaction line referencing the company. + * + * A company location parameter specified on a transaction line will override a company parameter if they share the same parameter name. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The company id. - * @param int $id The company parameter id + * + * @param int $companyId The company id. + * @param int $id The company parameter id * @param CompanyParameterDetailModel $model The company parameter object you wish to update. * @return CompanyParameterDetailModel */ @@ -2322,26 +2322,26 @@ public function updateCompanyParameterDetail($companyId, $id, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'PUT', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'PUT', $guzzleParams,'22.8.0' ); } /** * Retrieve jurisdiction rate information for tax authority * - * This API is available by invitation only. - * - * ### Security Policies - * + * This API is available by invitation only. + * + * ### Security Policies + * * * This API depends on the following active services:*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged. * Swagger Name: AvaTaxClient - * - * @param int $taxAuthorityId Used to limit the jurisdictions returned. - * @param string $effectiveDate Used to limit the jurisdictions returned. - * @param string $endDate Used to limit the jurisdictions returned. - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). - * @param string $include A comma separated list of objects to fetch underneath this jurisdiction. - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param int $taxAuthorityId Used to limit the jurisdictions returned. + * @param string $effectiveDate Used to limit the jurisdictions returned. + * @param string $endDate Used to limit the jurisdictions returned. + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). + * @param string $include A comma separated list of objects to fetch underneath this jurisdiction. + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return ComplianceJurisdictionRateModel */ @@ -2351,22 +2351,22 @@ public function queryTaxAuthorityJurisdictionRates($taxAuthorityId, $effectiveDa 'query' => ['taxAuthorityId' => $taxAuthorityId, 'effectiveDate' => $effectiveDate, 'endDate' => $endDate, '$filter' => $filter, '$include' => $include, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Create a new contact * - * Create one or more new contact objects. - * A 'contact' is a person associated with a company who is designated to handle certain responsibilities of - * a tax collecting and filing entity. - * - * ### Security Policies - * + * Create one or more new contact objects. + * A 'contact' is a person associated with a company who is designated to handle certain responsibilities of + * a tax collecting and filing entity. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, FirmAdmin, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this contact. + * + * @param int $companyId The ID of the company that owns this contact. * @param ContactModel[] $model The contacts you wish to create. * @return ContactModel[] */ @@ -2376,20 +2376,20 @@ public function createContacts($companyId, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Delete a single contact * - * Mark the existing contact object at this URL as deleted. - * - * ### Security Policies - * + * Mark the existing contact object at this URL as deleted. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, FirmAdmin, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this contact. + * + * @param int $companyId The ID of the company that owns this contact. * @param int $id The ID of the contact you wish to delete. * @return ErrorDetail[] */ @@ -2399,22 +2399,22 @@ public function deleteContact($companyId, $id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'DELETE', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'DELETE', $guzzleParams,'22.8.0' ); } /** * Retrieve a single contact * - * Get the contact object identified by this URL. - * A 'contact' is a person associated with a company who is designated to handle certain responsibilities of - * a tax collecting and filing entity. - * - * ### Security Policies - * + * Get the contact object identified by this URL. + * A 'contact' is a person associated with a company who is designated to handle certain responsibilities of + * a tax collecting and filing entity. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, FirmAdmin, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company for this contact + * + * @param int $companyId The ID of the company for this contact * @param int $id The primary key of this contact * @return ContactModel */ @@ -2424,26 +2424,26 @@ public function getContact($companyId, $id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve contacts for this company * - * List all contact objects assigned to this company. - * - * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . - * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. - * - * ### Security Policies - * + * List all contact objects assigned to this company. + * + * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . + * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, FirmAdmin, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns these contacts - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param int $companyId The ID of the company that owns these contacts + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -2453,27 +2453,27 @@ public function listContactsByCompany($companyId, $filter=null, $top=null, $skip 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve all contacts * - * Get multiple contact objects across all companies. - * A 'contact' is a person associated with a company who is designated to handle certain responsibilities of - * a tax collecting and filing entity. - * - * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . - * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. - * - * ### Security Policies - * + * Get multiple contact objects across all companies. + * A 'contact' is a person associated with a company who is designated to handle certain responsibilities of + * a tax collecting and filing entity. + * + * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . + * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, FirmAdmin, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -2483,25 +2483,25 @@ public function queryContacts($filter=null, $top=null, $skip=null, $orderBy=null 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Update a single contact * - * Replace the existing contact object at this URL with an updated object. - * A 'contact' is a person associated with a company who is designated to handle certain responsibilities of - * a tax collecting and filing entity. - * All data from the existing object will be replaced with data in the object you PUT. - * To set a field's value to null, you may either set its value to null or omit that field from the object you post. - * - * ### Security Policies - * + * Replace the existing contact object at this URL with an updated object. + * A 'contact' is a person associated with a company who is designated to handle certain responsibilities of + * a tax collecting and filing entity. + * All data from the existing object will be replaced with data in the object you PUT. + * To set a field's value to null, you may either set its value to null or omit that field from the object you post. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, FirmAdmin, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that this contact belongs to. - * @param int $id The ID of the contact you wish to update + * + * @param int $companyId The ID of the company that this contact belongs to. + * @param int $id The ID of the contact you wish to update * @param ContactModel $model The contact you wish to update. * @return ContactModel */ @@ -2511,35 +2511,35 @@ public function updateContact($companyId, $id, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'PUT', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'PUT', $guzzleParams,'22.8.0' ); } /** * Create customers for this company * - * Create one or more customers for this company. - * - * A customer object defines information about a person or business that purchases products from your - * company. When you create a tax transaction in AvaTax, you can use the `customerCode` from this - * record in your `CreateTransaction` API call. AvaTax will search for this `customerCode` value and - * identify any certificates linked to this `customer` object. If any certificate applies to the transaction, - * AvaTax will record the appropriate elements of the transaction as exempt and link it to the `certificate`. - * - * A nested object such as CustomFields could be specified and created along with the customer object. To fetch the - * nested object, please call 'GetCustomer' API with appropriate $include parameters. - * - * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. - * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption - * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption - * certificate storage for this company, call `RequestCertificateSetup`. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin. + * Create one or more customers for this company. + * + * A customer object defines information about a person or business that purchases products from your + * company. When you create a tax transaction in AvaTax, you can use the `customerCode` from this + * record in your `CreateTransaction` API call. AvaTax will search for this `customerCode` value and + * identify any certificates linked to this `customer` object. If any certificate applies to the transaction, + * AvaTax will record the appropriate elements of the transaction as exempt and link it to the `certificate`. + * + * A nested object such as CustomFields could be specified and created along with the customer object. To fetch the + * nested object, please call 'GetCustomer' API with appropriate $include parameters. + * + * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. + * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption + * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption + * certificate storage for this company, call `RequestCertificateSetup`. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * - * @param int $companyId The unique ID number of the company that recorded this customer + * + * @param int $companyId The unique ID number of the company that recorded this customer * @param CustomerModel[] $model The list of customer objects to be created * @return CustomerModel[] */ @@ -2549,32 +2549,32 @@ public function createCustomers($companyId, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Delete a customer record * - * Deletes the customer object referenced by this URL. - * - * A customer object defines information about a person or business that purchases products from your - * company. When you create a tax transaction in AvaTax, you can use the `customerCode` from this - * record in your `CreateTransaction` API call. AvaTax will search for this `customerCode` value and - * identify any certificates linked to this `customer` object. If any certificate applies to the transaction, - * AvaTax will record the appropriate elements of the transaction as exempt and link it to the `certificate`. - * - * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. - * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption - * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption - * certificate storage for this company, call `RequestCertificateSetup`. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin. + * Deletes the customer object referenced by this URL. + * + * A customer object defines information about a person or business that purchases products from your + * company. When you create a tax transaction in AvaTax, you can use the `customerCode` from this + * record in your `CreateTransaction` API call. AvaTax will search for this `customerCode` value and + * identify any certificates linked to this `customer` object. If any certificate applies to the transaction, + * AvaTax will record the appropriate elements of the transaction as exempt and link it to the `certificate`. + * + * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. + * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption + * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption + * certificate storage for this company, call `RequestCertificateSetup`. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * - * @param int $companyId The unique ID number of the company that recorded this customer + * + * @param int $companyId The unique ID number of the company that recorded this customer * @param string $customerCode The unique code representing this customer * @return CustomerModel */ @@ -2584,39 +2584,39 @@ public function deleteCustomer($companyId, $customerCode) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'DELETE', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'DELETE', $guzzleParams,'22.8.0' ); } /** * Retrieve a single customer * - * Retrieve the customer identified by this URL. - * - * A customer object defines information about a person or business that purchases products from your - * company. When you create a tax transaction in AvaTax, you can use the `customerCode` from this - * record in your `CreateTransaction` API call. AvaTax will search for this `customerCode` value and - * identify any certificates linked to this customer object. If any certificate applies to the transaction, - * AvaTax will record the appropriate elements of the transaction as exempt and link it to the `certificate`. - * - * You can use the `$include` parameter to fetch the following additional objects for expansion: - * - * * Certificates - Fetch a list of certificates linked to this customer. - * * CustomFields - Fetch a list of custom fields associated to this customer. - * * attributes - Retrieves all attributes applied to the customer. - * - * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. - * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption - * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption - * certificate storage for this company, call `RequestCertificateSetup`. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * Retrieve the customer identified by this URL. + * + * A customer object defines information about a person or business that purchases products from your + * company. When you create a tax transaction in AvaTax, you can use the `customerCode` from this + * record in your `CreateTransaction` API call. AvaTax will search for this `customerCode` value and + * identify any certificates linked to this customer object. If any certificate applies to the transaction, + * AvaTax will record the appropriate elements of the transaction as exempt and link it to the `certificate`. + * + * You can use the `$include` parameter to fetch the following additional objects for expansion: + * + * * Certificates - Fetch a list of certificates linked to this customer. + * * CustomFields - Fetch a list of custom fields associated to this customer. + * * attributes - Retrieves all attributes applied to the customer. + * + * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. + * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption + * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption + * certificate storage for this company, call `RequestCertificateSetup`. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * - * @param int $companyId The unique ID number of the company that recorded this customer - * @param string $customerCode The unique code representing this customer + * + * @param int $companyId The unique ID number of the company that recorded this customer + * @param string $customerCode The unique code representing this customer * @param string $include Specify optional additional objects to include in this fetch request * @return CustomerModel */ @@ -2626,36 +2626,36 @@ public function getCustomer($companyId, $customerCode, $include=null) { 'query' => ['$include' => $include], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Link attributes to a customer * - * Link one or many attributes to a customer. - * - * A customer may have multiple attributes that control its behavior. You may link or unlink attributes to a - * customer at any time. The full list of defined attributes may be found using `QueryCompanyCustomerAttributes` API. - * - * A customer object defines information about a person or business that purchases products from your - * company. When you create a tax transaction in AvaTax, you can use the `customerCode` from this - * record in your `CreateTransaction` API call. AvaTax will search for this `customerCode` value and - * identify any certificates linked to this customer object. If any certificate applies to the transaction, - * AvaTax will record the appropriate elements of the transaction as exempt and link it to the `certificate`. - * - * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. - * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption - * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption - * certificate storage for this company, call `RequestCertificateSetup`. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin. + * Link one or many attributes to a customer. + * + * A customer may have multiple attributes that control its behavior. You may link or unlink attributes to a + * customer at any time. The full list of defined attributes may be found using `QueryCompanyCustomerAttributes` API. + * + * A customer object defines information about a person or business that purchases products from your + * company. When you create a tax transaction in AvaTax, you can use the `customerCode` from this + * record in your `CreateTransaction` API call. AvaTax will search for this `customerCode` value and + * identify any certificates linked to this customer object. If any certificate applies to the transaction, + * AvaTax will record the appropriate elements of the transaction as exempt and link it to the `certificate`. + * + * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. + * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption + * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption + * certificate storage for this company, call `RequestCertificateSetup`. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * - * @param int $companyId The unique ID number of the company that recorded the provided customer - * @param string $customerCode The unique code representing the current customer + * + * @param int $companyId The unique ID number of the company that recorded the provided customer + * @param string $customerCode The unique code representing the current customer * @param CustomerAttributeModel[] $model The list of attributes to link to the customer. * @return FetchResult */ @@ -2665,33 +2665,33 @@ public function linkAttributesToCustomer($companyId, $customerCode, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'PUT', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'PUT', $guzzleParams,'22.8.0' ); } /** * Link certificates to a customer * - * Link one or more certificates to a customer. - * - * A customer object defines information about a person or business that purchases products from your - * company. When you create a tax transaction in AvaTax, you can use the `customerCode` from this - * record in your `CreateTransaction` API call. AvaTax will search for this `customerCode` value and - * identify any certificates linked to this `customer` object. If any certificate applies to the transaction, - * AvaTax will record the appropriate elements of the transaction as exempt and link it to the `certificate`. - * - * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. - * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption - * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption - * certificate storage for this company, call `RequestCertificateSetup`. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * Link one or more certificates to a customer. + * + * A customer object defines information about a person or business that purchases products from your + * company. When you create a tax transaction in AvaTax, you can use the `customerCode` from this + * record in your `CreateTransaction` API call. AvaTax will search for this `customerCode` value and + * identify any certificates linked to this `customer` object. If any certificate applies to the transaction, + * AvaTax will record the appropriate elements of the transaction as exempt and link it to the `certificate`. + * + * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. + * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption + * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption + * certificate storage for this company, call `RequestCertificateSetup`. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * - * @param int $companyId The unique ID number of the company that recorded this customer - * @param string $customerCode The unique code representing this customer + * + * @param int $companyId The unique ID number of the company that recorded this customer + * @param string $customerCode The unique code representing this customer * @param LinkCertificatesModel $model The list of certificates to link to this customer * @return FetchResult */ @@ -2701,34 +2701,34 @@ public function linkCertificatesToCustomer($companyId, $customerCode, $model) 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Link two customer records together * - * Links a Ship-To customer record with a Bill-To customer record. - * - * Customer records represent businesses or individuals who can provide exemption certificates. Some customers - * may have certificates that are linked to their shipping address or their billing address. To group these - * customer records together, you may link multiple bill-to and ship-to addresses together to represent a single - * entity that has multiple different addresses of different kinds. - * - * In general, a customer will have only one primary billing address and multiple ship-to addresses, representing - * all of the different locations where they receive goods. To facilitate this type of customer, you can send in - * one bill-to customer code and multiple ship-to customer codes in a single API call. - * - * Note that you can only link a ship-to customer record to a bill-to customer record. You may not link two customers - * of the same kind together. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * Links a Ship-To customer record with a Bill-To customer record. + * + * Customer records represent businesses or individuals who can provide exemption certificates. Some customers + * may have certificates that are linked to their shipping address or their billing address. To group these + * customer records together, you may link multiple bill-to and ship-to addresses together to represent a single + * entity that has multiple different addresses of different kinds. + * + * In general, a customer will have only one primary billing address and multiple ship-to addresses, representing + * all of the different locations where they receive goods. To facilitate this type of customer, you can send in + * one bill-to customer code and multiple ship-to customer codes in a single API call. + * + * Note that you can only link a ship-to customer record to a bill-to customer record. You may not link two customers + * of the same kind together. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * - * @param int $companyId The unique ID number of the company defining customers. - * @param string $code The code of the bill-to customer to link. + * + * @param int $companyId The unique ID number of the company defining customers. + * @param string $code The code of the bill-to customer to link. * @param LinkCustomersModel $model A list of information about ship-to customers to link to this bill-to customer. * @return CustomerModel */ @@ -2738,35 +2738,35 @@ public function linkShipToCustomersToBillCustomer($companyId, $code, $model) 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Retrieve a customer's attributes * - * Retrieve the attributes linked to the customer identified by this URL. - * - * A customer may have multiple attributes that control its behavior. You may link or unlink attributes to a - * customer at any time. The full list of defined attributes may be found using `QueryCompanyCustomerAttributes` API. - * - * A customer object defines information about a person or business that purchases products from your - * company. When you create a tax transaction in AvaTax, you can use the `customerCode` from this - * record in your `CreateTransaction` API call. AvaTax will search for this `customerCode` value and - * identify any certificates linked to this customer object. If any certificate applies to the transaction, - * AvaTax will record the appropriate elements of the transaction as exempt and link it to the `certificate`. - * - * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. - * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption - * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption - * certificate storage for this company, call `RequestCertificateSetup`. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * Retrieve the attributes linked to the customer identified by this URL. + * + * A customer may have multiple attributes that control its behavior. You may link or unlink attributes to a + * customer at any time. The full list of defined attributes may be found using `QueryCompanyCustomerAttributes` API. + * + * A customer object defines information about a person or business that purchases products from your + * company. When you create a tax transaction in AvaTax, you can use the `customerCode` from this + * record in your `CreateTransaction` API call. AvaTax will search for this `customerCode` value and + * identify any certificates linked to this customer object. If any certificate applies to the transaction, + * AvaTax will record the appropriate elements of the transaction as exempt and link it to the `certificate`. + * + * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. + * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption + * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption + * certificate storage for this company, call `RequestCertificateSetup`. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * - * @param int $companyId The unique ID number of the company that recorded the provided customer + * + * @param int $companyId The unique ID number of the company that recorded the provided customer * @param string $customerCode The unique code representing the current customer * @return FetchResult */ @@ -2776,37 +2776,37 @@ public function listAttributesForCustomer($companyId, $customerCode) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * List certificates linked to a customer * - * List all certificates linked to a customer. - * - * A customer object defines information about a person or business that purchases products from your - * company. When you create a tax transaction in AvaTax, you can use the `customerCode` from this - * record in your `CreateTransaction` API call. AvaTax will search for this `customerCode` value and - * identify any certificates linked to this `customer` object. If any certificate applies to the transaction, - * AvaTax will record the appropriate elements of the transaction as exempt and link it to the `certificate`. - * - * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. - * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption - * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption - * certificate storage for this company, call `RequestCertificateSetup`. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * List all certificates linked to a customer. + * + * A customer object defines information about a person or business that purchases products from your + * company. When you create a tax transaction in AvaTax, you can use the `customerCode` from this + * record in your `CreateTransaction` API call. AvaTax will search for this `customerCode` value and + * identify any certificates linked to this `customer` object. If any certificate applies to the transaction, + * AvaTax will record the appropriate elements of the transaction as exempt and link it to the `certificate`. + * + * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. + * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption + * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption + * certificate storage for this company, call `RequestCertificateSetup`. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * - * @param int $companyId The unique ID number of the company that recorded this customer - * @param string $customerCode The unique code representing this customer - * @param string $include OPTIONAL: A comma separated list of special fetch options. You can specify one or more of the following: * customers - Retrieves the list of customers linked to the certificate. * po_numbers - Retrieves all PO numbers tied to the certificate. * attributes - Retrieves all attributes applied to the certificate. - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* exemptionNumber, status, ecmsId, ecmsStatus, pdf, pages - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param int $companyId The unique ID number of the company that recorded this customer + * @param string $customerCode The unique code representing this customer + * @param string $include OPTIONAL: A comma separated list of special fetch options. You can specify one or more of the following: * customers - Retrieves the list of customers linked to the certificate. * po_numbers - Retrieves all PO numbers tied to the certificate. * attributes - Retrieves all attributes applied to the certificate. + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* exemptionNumber, status, ecmsId, ecmsStatus, pdf, pages + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -2816,37 +2816,37 @@ public function listCertificatesForCustomer($companyId, $customerCode, $include= 'query' => ['$include' => $include, '$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * List valid certificates for a location * - * List valid certificates linked to a customer in a particular country and region. - * - * This API is intended to help identify whether a customer has already provided a certificate that - * applies to a particular country and region. This API is intended to help you remind a customer - * when they have or have not provided copies of their exemption certificates to you during the sales - * order process. - * - * If a customer does not have a certificate on file and they wish to provide one, you should send the customer - * a CertExpress invitation link so that the customer can upload proof of their exemption certificate. Please - * see the `CreateCertExpressInvitation` API to create an invitation link for this customer. - * - * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. - * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption - * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption - * certificate storage for this company, call `RequestCertificateSetup`. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * List valid certificates linked to a customer in a particular country and region. + * + * This API is intended to help identify whether a customer has already provided a certificate that + * applies to a particular country and region. This API is intended to help you remind a customer + * when they have or have not provided copies of their exemption certificates to you during the sales + * order process. + * + * If a customer does not have a certificate on file and they wish to provide one, you should send the customer + * a CertExpress invitation link so that the customer can upload proof of their exemption certificate. Please + * see the `CreateCertExpressInvitation` API to create an invitation link for this customer. + * + * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. + * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption + * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption + * certificate storage for this company, call `RequestCertificateSetup`. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * - * @param int $companyId The unique ID number of the company that recorded this customer - * @param string $customerCode The unique code representing this customer - * @param string $country Search for certificates matching this country. Uses the ISO 3166 two character country code. + * + * @param int $companyId The unique ID number of the company that recorded this customer + * @param string $customerCode The unique code representing this customer + * @param string $country Search for certificates matching this country. Uses the ISO 3166 two character country code. * @param string $region Search for certificates matching this region. Uses the ISO 3166 two or three character state, region, or province code. * @return ExemptionStatusModel */ @@ -2856,41 +2856,41 @@ public function listValidCertificatesForCustomer($companyId, $customerCode, $cou 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * List all customers for this company * - * List all customers recorded by this company matching the specified criteria. - * - * A customer object defines information about a person or business that purchases products from your - * company. When you create a tax transaction in AvaTax, you can use the `customerCode` from this - * record in your `CreateTransaction` API call. AvaTax will search for this `customerCode` value and - * identify any certificates linked to this `customer` object. If any certificate applies to the transaction, - * AvaTax will record the appropriate elements of the transaction as exempt and link it to the `certificate`. - * - * You can use the `$include` parameter to fetch the following additional objects for expansion: - * - * * Certificates - Fetch a list of certificates linked to this customer. - * * attributes - Retrieves all attributes applied to the customer. - * - * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. - * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption - * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption - * certificate storage for this company, call `RequestCertificateSetup`. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * List all customers recorded by this company matching the specified criteria. + * + * A customer object defines information about a person or business that purchases products from your + * company. When you create a tax transaction in AvaTax, you can use the `customerCode` from this + * record in your `CreateTransaction` API call. AvaTax will search for this `customerCode` value and + * identify any certificates linked to this `customer` object. If any certificate applies to the transaction, + * AvaTax will record the appropriate elements of the transaction as exempt and link it to the `certificate`. + * + * You can use the `$include` parameter to fetch the following additional objects for expansion: + * + * * Certificates - Fetch a list of certificates linked to this customer. + * * attributes - Retrieves all attributes applied to the customer. + * + * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. + * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption + * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption + * certificate storage for this company, call `RequestCertificateSetup`. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * - * @param int $companyId The unique ID number of the company that recorded this customer - * @param string $include OPTIONAL - You can specify the value `certificates` to fetch information about certificates linked to the customer. - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* shipTos - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param int $companyId The unique ID number of the company that recorded this customer + * @param string $include OPTIONAL - You can specify the value `certificates` to fetch information about certificates linked to the customer. + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* shipTos + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -2900,36 +2900,36 @@ public function queryCustomers($companyId, $include=null, $filter=null, $top=nul 'query' => ['$include' => $include, '$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Unlink attributes from a customer * - * Unlink one or many attributes from a customer. - * - * A customer may have multiple attributes that control its behavior. You may link or unlink attributes to a - * customer at any time. The full list of defined attributes may be found using `QueryCompanyCustomerAttributes` API. - * - * A customer object defines information about a person or business that purchases products from your - * company. When you create a tax transaction in AvaTax, you can use the `customerCode` from this - * record in your `CreateTransaction` API call. AvaTax will search for this `customerCode` value and - * identify any certificates linked to this customer object. If any certificate applies to the transaction, - * AvaTax will record the appropriate elements of the transaction as exempt and link it to the `certificate`. - * - * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. - * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption - * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption - * certificate storage for this company, call `RequestCertificateSetup`. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin. + * Unlink one or many attributes from a customer. + * + * A customer may have multiple attributes that control its behavior. You may link or unlink attributes to a + * customer at any time. The full list of defined attributes may be found using `QueryCompanyCustomerAttributes` API. + * + * A customer object defines information about a person or business that purchases products from your + * company. When you create a tax transaction in AvaTax, you can use the `customerCode` from this + * record in your `CreateTransaction` API call. AvaTax will search for this `customerCode` value and + * identify any certificates linked to this customer object. If any certificate applies to the transaction, + * AvaTax will record the appropriate elements of the transaction as exempt and link it to the `certificate`. + * + * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. + * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption + * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption + * certificate storage for this company, call `RequestCertificateSetup`. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * - * @param int $companyId The unique ID number of the company that recorded the customer - * @param string $customerCode The unique code representing the current customer + * + * @param int $companyId The unique ID number of the company that recorded the customer + * @param string $customerCode The unique code representing the current customer * @param CustomerAttributeModel[] $model The list of attributes to unlink from the customer. * @return FetchResult */ @@ -2939,33 +2939,33 @@ public function unlinkAttributesFromCustomer($companyId, $customerCode, $model) 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'PUT', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'PUT', $guzzleParams,'22.8.0' ); } /** * Unlink certificates from a customer * - * Remove one or more certificates to a customer. - * - * A customer object defines information about a person or business that purchases products from your - * company. When you create a tax transaction in AvaTax, you can use the `customerCode` from this - * record in your `CreateTransaction` API call. AvaTax will search for this `customerCode` value and - * identify any certificates linked to this `customer` object. If any certificate applies to the transaction, - * AvaTax will record the appropriate elements of the transaction as exempt and link it to the `certificate`. - * - * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. - * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption - * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption - * certificate storage for this company, call `RequestCertificateSetup`. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * Remove one or more certificates to a customer. + * + * A customer object defines information about a person or business that purchases products from your + * company. When you create a tax transaction in AvaTax, you can use the `customerCode` from this + * record in your `CreateTransaction` API call. AvaTax will search for this `customerCode` value and + * identify any certificates linked to this `customer` object. If any certificate applies to the transaction, + * AvaTax will record the appropriate elements of the transaction as exempt and link it to the `certificate`. + * + * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. + * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption + * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption + * certificate storage for this company, call `RequestCertificateSetup`. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * - * @param int $companyId The unique ID number of the company that recorded this customer - * @param string $customerCode The unique code representing this customer + * + * @param int $companyId The unique ID number of the company that recorded this customer + * @param string $customerCode The unique code representing this customer * @param LinkCertificatesModel $model The list of certificates to link to this customer * @return FetchResult */ @@ -2975,33 +2975,33 @@ public function unlinkCertificatesFromCustomer($companyId, $customerCode, $model 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Update a single customer * - * Replace the customer object at this URL with a new record. - * - * A customer object defines information about a person or business that purchases products from your - * company. When you create a tax transaction in AvaTax, you can use the `customerCode` from this - * record in your `CreateTransaction` API call. AvaTax will search for this `customerCode` value and - * identify any certificates linked to this `customer` object. If any certificate applies to the transaction, - * AvaTax will record the appropriate elements of the transaction as exempt and link it to the `certificate`. - * - * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. - * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption - * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption - * certificate storage for this company, call `RequestCertificateSetup`. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin. + * Replace the customer object at this URL with a new record. + * + * A customer object defines information about a person or business that purchases products from your + * company. When you create a tax transaction in AvaTax, you can use the `customerCode` from this + * record in your `CreateTransaction` API call. AvaTax will search for this `customerCode` value and + * identify any certificates linked to this `customer` object. If any certificate applies to the transaction, + * AvaTax will record the appropriate elements of the transaction as exempt and link it to the `certificate`. + * + * Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. + * Companies that do not have this storage system set up will see `CertCaptureNotConfiguredError` when they call exemption + * certificate related APIs. To check if this is set up for a company, call `GetCertificateSetup`. To request setup of exemption + * certificate storage for this company, call `RequestCertificateSetup`. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * - * @param int $companyId The unique ID number of the company that recorded this customer - * @param string $customerCode The unique code representing this customer + * + * @param int $companyId The unique ID number of the company that recorded this customer + * @param string $customerCode The unique code representing this customer * @param CustomerModel $model The new customer model that will replace the existing record at this URL * @return CustomerModel */ @@ -3011,21 +3011,21 @@ public function updateCustomer($companyId, $customerCode, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'PUT', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'PUT', $guzzleParams,'22.8.0' ); } /** * Create and store new datasources for the respective companies. * - * Create one or more datasource objects. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. + * Create one or more datasource objects. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. * * This API depends on the following active services:*Required* (all): AvaTaxPro, BasicReturns. * Swagger Name: AvaTaxClient - * - * @param int $companyId The id of the company you which to create the datasources + * + * @param int $companyId The id of the company you which to create the datasources * @param DataSourceModel[] $model * @return DataSourceModel[] */ @@ -3035,21 +3035,21 @@ public function createDataSources($companyId, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Delete a datasource by datasource id for a company. * - * Marks the existing datasource for a company as deleted. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. + * Marks the existing datasource for a company as deleted. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. * * This API depends on the following active services:*Required* (all): AvaTaxPro, BasicReturns. * Swagger Name: AvaTaxClient - * - * @param int $companyId The id of the company the datasource belongs to. + * + * @param int $companyId The id of the company the datasource belongs to. * @param int $id The id of the datasource you wish to delete. * @return ErrorDetail[] */ @@ -3059,21 +3059,21 @@ public function deleteDataSource($companyId, $id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'DELETE', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'DELETE', $guzzleParams,'22.8.0' ); } /** * Get data source by data source id * - * Retrieve the data source by its unique ID number. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. + * Retrieve the data source by its unique ID number. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro, BasicReturns. * Swagger Name: AvaTaxClient - * - * @param int $companyId + * + * @param int $companyId * @param int $id data source id * @return DataSourceModel */ @@ -3083,24 +3083,24 @@ public function getDataSourceById($companyId, $id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve all datasources for this company * - * Gets multiple datasource objects for a given company. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. + * Gets multiple datasource objects for a given company. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro, BasicReturns. * Swagger Name: AvaTaxClient - * - * @param int $companyId The id of the company you wish to retrieve the datasources. - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* isEnabled, isSynced, isAuthorized, name, externalState - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param int $companyId The id of the company you wish to retrieve the datasources. + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* isEnabled, isSynced, isAuthorized, name, externalState + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -3110,26 +3110,26 @@ public function listDataSources($companyId, $filter=null, $top=null, $skip=null, 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve all datasources * - * Get multiple datasource objects across all companies. - * - * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . - * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. + * Get multiple datasource objects across all companies. + * + * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . + * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro, BasicReturns. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* isEnabled, isSynced, isAuthorized, name, externalState - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* isEnabled, isSynced, isAuthorized, name, externalState + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -3139,22 +3139,22 @@ public function queryDataSources($filter=null, $top=null, $skip=null, $orderBy=n 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Update a datasource identified by id for a company * - * Updates a datasource for a company. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. + * Updates a datasource for a company. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. * * This API depends on the following active services:*Required* (all): AvaTaxPro, BasicReturns. * Swagger Name: AvaTaxClient - * - * @param int $companyId The id of the company the datasource belongs to. - * @param int $id The id of the datasource you wish to delete. + * + * @param int $companyId The id of the company the datasource belongs to. + * @param int $id The id of the datasource you wish to delete. * @param DataSourceModel $model * @return DataSourceModel */ @@ -3164,29 +3164,29 @@ public function updateDataSource($companyId, $id, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'PUT', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'PUT', $guzzleParams,'22.8.0' ); } /** * Lists all parents of an HS Code. * - * Retrieves the specified HS code and all of its parents, reflecting all sections, chapters, headings, and subheadings - * - * a list of HS Codes that are the parents and information branches of the HS Code for the given - * destination country, if lower detail is available. - * - * This API will include information branches if applicable. These do not have HS Codes and cannot be referenced, - * but can contain information relevant to deciding the correct HS Code. - * - * This API is intended to be useful to review the descriptive hierarchy of an HS Code, which can be particularly helpful - * when HS Codes can have multiple levels of generic descriptions. - * - * ### Security Policies - * + * Retrieves the specified HS code and all of its parents, reflecting all sections, chapters, headings, and subheadings + * + * a list of HS Codes that are the parents and information branches of the HS Code for the given + * destination country, if lower detail is available. + * + * This API will include information branches if applicable. These do not have HS Codes and cannot be referenced, + * but can contain information relevant to deciding the correct HS Code. + * + * This API is intended to be useful to review the descriptive hierarchy of an HS Code, which can be particularly helpful + * when HS Codes can have multiple levels of generic descriptions. + * + * ### Security Policies + * * * This API depends on the following active services:*Required* (all): AvaTaxGlobal. * Swagger Name: AvaTaxClient - * - * @param string $country The name or code of the destination country. + * + * @param string $country The name or code of the destination country. * @param string $hsCode The partial or full HS Code for which you would like to view all of the parents. * @return FetchResult */ @@ -3196,20 +3196,20 @@ public function getCrossBorderCode($country, $hsCode) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Test whether a form supports online login verification * - * This API is intended to be useful to identify whether the user should be allowed + * This API is intended to be useful to identify whether the user should be allowed * to automatically verify their login and password. This API will provide a result only if the form supports automatic online login verification. * Swagger Name: AvaTaxClient - * - * @param string $form The name of the form you would like to verify. This is the tax form code - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* taxFormCodes, scraperType, expectedResponseTime, requiredFilingCalendarDataFields - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $form The name of the form you would like to verify. This is the tax form code + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* taxFormCodes, scraperType, expectedResponseTime, requiredFilingCalendarDataFields + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -3219,7 +3219,7 @@ public function getLoginVerifierByForm($form, $filter=null, $top=null, $skip=nul 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** @@ -3227,10 +3227,10 @@ public function getLoginVerifierByForm($form, $filter=null, $top=null, $skip=nul * * List all market place locations. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -3240,23 +3240,23 @@ public function listAllMarketplaceLocations($filter=null, $top=null, $skip=null, 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve the full list of the AvaFile Forms available * - * This API is deprecated. - * - * Please use the ListTaxForms API. - * - * Returns the full list of Avalara-supported AvaFile Forms + * This API is deprecated. + * + * Please use the ListTaxForms API. + * + * Returns the full list of Avalara-supported AvaFile Forms * This API is intended to be useful to identify all the different AvaFile Forms * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* outletTypeId - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* outletTypeId + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -3266,25 +3266,25 @@ public function listAvaFileForms($filter=null, $top=null, $skip=null, $orderBy=n 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * List certificate attributes used by a company * - * List the certificate attributes defined by a company either specified by the user or the user's default company. - * - * A certificate may have multiple attributes that control its behavior. You may apply or remove attributes to a - * certificate at any time. - * - * If you see the 'CertCaptureNotConfiguredError', please use CheckProvision and RequestProvision endpoints to + * List the certificate attributes defined by a company either specified by the user or the user's default company. + * + * A certificate may have multiple attributes that control its behavior. You may apply or remove attributes to a + * certificate at any time. + * + * If you see the 'CertCaptureNotConfiguredError', please use CheckProvision and RequestProvision endpoints to * check and provision account. * Swagger Name: AvaTaxClient - * - * @param int $companyid Id of the company the user wish to fetch the certificates' attributes from. If not specified the API will use user's default company. - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param int $companyid Id of the company the user wish to fetch the certificates' attributes from. If not specified the API will use user's default company. + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -3294,24 +3294,24 @@ public function listCertificateAttributes($companyid, $filter=null, $top=null, $ 'query' => ['companyid' => $companyid, '$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * List the certificate exempt reasons defined by a company * - * List the certificate exempt reasons defined by a company. - * - * An exemption reason defines why a certificate allows a customer to be exempt - * for purposes of tax calculation. - * - * If you see the 'CertCaptureNotConfiguredError', please use CheckProvision and RequestProvision endpoints to + * List the certificate exempt reasons defined by a company. + * + * An exemption reason defines why a certificate allows a customer to be exempt + * for purposes of tax calculation. + * + * If you see the 'CertCaptureNotConfiguredError', please use CheckProvision and RequestProvision endpoints to * check and provision account. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -3321,24 +3321,24 @@ public function listCertificateExemptReasons($filter=null, $top=null, $skip=null 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * List certificate exposure zones used by a company * - * List the certificate exposure zones defined by a company. - * - * An exposure zone is a location where a certificate can be valid. Exposure zones may indicate a taxing - * authority or other legal entity to which a certificate may apply. - * - * If you see the 'CertCaptureNotConfiguredError', please use CheckProvision and RequestProvision endpoints to + * List the certificate exposure zones defined by a company. + * + * An exposure zone is a location where a certificate can be valid. Exposure zones may indicate a taxing + * authority or other legal entity to which a certificate may apply. + * + * If you see the 'CertCaptureNotConfiguredError', please use CheckProvision and RequestProvision endpoints to * check and provision account. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* id, companyId, name, tag, description, created, modified, region, country - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* id, companyId, name, tag, description, created, modified, region, country + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -3348,20 +3348,20 @@ public function listCertificateExposureZones($filter=null, $top=null, $skip=null 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve the full list of Avalara-supported usage of extra parameters for classification of a item. * - * Returns the full list of Avalara-supported usage of extra parameters for item classification. - * The list of parameters is available for use with Item Classification. + * Returns the full list of Avalara-supported usage of extra parameters for item classification. + * The list of parameters is available for use with Item Classification. * Some parameters are only available for use if you have subscribed to certain features of AvaTax. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* values - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* values + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -3371,7 +3371,7 @@ public function listClassificationParametersUsage($filter=null, $top=null, $skip 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** @@ -3379,11 +3379,11 @@ public function listClassificationParametersUsage($filter=null, $top=null, $skip * * Returns full list of service types for a given transaction type ID. * Swagger Name: AvaTaxClient - * - * @param int $id The transaction type ID to examine - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* requiredParameters - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param int $id The transaction type ID to examine + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* requiredParameters + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -3393,19 +3393,19 @@ public function listCommunicationsServiceTypes($id, $filter=null, $top=null, $sk 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve the full list of communications transactiontypes * - * Returns full list of communications transaction types which + * Returns full list of communications transaction types which * are accepted in communication tax calculation requests. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -3415,19 +3415,19 @@ public function listCommunicationsTransactionTypes($filter=null, $top=null, $ski 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve the full list of communications transaction/service type pairs * - * Returns full list of communications transaction/service type pairs which + * Returns full list of communications transaction/service type pairs which * are accepted in communication tax calculation requests. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* requiredParameters - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* requiredParameters + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -3437,20 +3437,20 @@ public function listCommunicationsTSPairs($filter=null, $top=null, $skip=null, $ 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * List all ISO 3166 countries * - * Returns a list of all ISO 3166 country codes, and their US English friendly names. - * This API is intended to be useful when presenting a dropdown box in your website to allow customers to select a country for + * Returns a list of all ISO 3166 country codes, and their US English friendly names. + * This API is intended to be useful when presenting a dropdown box in your website to allow customers to select a country for * a shipping address. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* alpha3Code, isEuropeanUnion, localizedNames, addressesRequireRegion - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* alpha3Code, isEuropeanUnion, localizedNames, addressesRequireRegion + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -3460,25 +3460,25 @@ public function listCountries($filter=null, $top=null, $skip=null, $orderBy=null 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * List certificate exposure zones used by a company * - * List available cover letters that can be used when sending invitation to use CertExpress to upload certificates. - * - * The CoverLetter model represents a message sent along with an invitation to use CertExpress to - * upload certificates. An invitation allows customers to use CertExpress to upload their exemption - * certificates directly; this cover letter explains why the invitation was sent. - * - * If you see the 'CertCaptureNotConfiguredError', please use CheckProvision and RequestProvision endpoints to + * List available cover letters that can be used when sending invitation to use CertExpress to upload certificates. + * + * The CoverLetter model represents a message sent along with an invitation to use CertExpress to + * upload certificates. An invitation allows customers to use CertExpress to upload their exemption + * certificates directly; this cover letter explains why the invitation was sent. + * + * If you see the 'CertCaptureNotConfiguredError', please use CheckProvision and RequestProvision endpoints to * check and provision account. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* id, companyId, subject, description, createdDate, modifiedDate, pageCount, templateFilename, version - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* id, companyId, subject, description, createdDate, modifiedDate, pageCount, templateFilename, version + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -3488,31 +3488,31 @@ public function listCoverLetters($filter=null, $top=null, $skip=null, $orderBy=n 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Lists the next level of HS Codes given a destination country and HS Code prefix. * - * Retrieves a list of HS Codes that are the children of the prefix for the given destination country, if - * additional children are available. - * - * HS Code is interchangeable with "tariff code" and definitions are generally unique to a destination country. - * An HS Code describes an item and its eligibility/rate for tariffs. HS Codes are organized by - * Section/Chapter/Heading/Subheading/Classification. - * - * This API is intended to be useful to identify the correct HS Code to use for your item. - * - * ### Security Policies - * + * Retrieves a list of HS Codes that are the children of the prefix for the given destination country, if + * additional children are available. + * + * HS Code is interchangeable with "tariff code" and definitions are generally unique to a destination country. + * An HS Code describes an item and its eligibility/rate for tariffs. HS Codes are organized by + * Section/Chapter/Heading/Subheading/Classification. + * + * This API is intended to be useful to identify the correct HS Code to use for your item. + * + * ### Security Policies + * * * This API depends on the following active services:*Required* (all): AvaTaxGlobal. * Swagger Name: AvaTaxClient - * - * @param string $country The name or code of the destination country. - * @param string $hsCode The Section or partial HS Code for which you would like to view the next level of HS Code detail, if more detail is available. - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* hsCodeSource, system, destinationCountry, isDecisionNode, zeroPaddingCount, isSystemDefined, isTaxable, effDate, endDate, hsCodeSourceLength - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $country The name or code of the destination country. + * @param string $hsCode The Section or partial HS Code for which you would like to view the next level of HS Code detail, if more detail is available. + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* hsCodeSource, system, destinationCountry, isDecisionNode, zeroPaddingCount, isSystemDefined, isTaxable, effDate, endDate, hsCodeSourceLength + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -3522,21 +3522,21 @@ public function listCrossBorderCodes($country, $hsCode, $filter=null, $top=null, 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * List top level HS Code Sections. * - * Returns the full list of top level HS Code Sections. Sections are the broadest level of detail for - * classifying tariff codes and the items to which they apply. HS Codes are organized - * by Section/Chapter/Heading/Subheading/Classification. - * - * This API is intended to be useful to identify the top level Sections for - * further LandedCost HS Code lookups. - * - * ### Security Policies - * + * Returns the full list of top level HS Code Sections. Sections are the broadest level of detail for + * classifying tariff codes and the items to which they apply. HS Codes are organized + * by Section/Chapter/Heading/Subheading/Classification. + * + * This API is intended to be useful to identify the top level Sections for + * further LandedCost HS Code lookups. + * + * ### Security Policies + * * * This API depends on the following active services:*Required* (all): AvaTaxGlobal. * Swagger Name: AvaTaxClient * @@ -3548,21 +3548,21 @@ public function listCrossBorderSections() { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * List all ISO 4217 currencies supported by AvaTax. * - * Lists all ISO 4217 currencies supported by AvaTax. - * - * This API produces a list of currency codes that can be used when calling AvaTax. The values from this API can be used to fill out the + * Lists all ISO 4217 currencies supported by AvaTax. + * + * This API produces a list of currency codes that can be used when calling AvaTax. The values from this API can be used to fill out the * `currencyCode` field in a `CreateTransactionModel`. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -3572,22 +3572,22 @@ public function listCurrencies($filter=null, $top=null, $skip=null, $orderBy=nul 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve the full list of Avalara-supported entity use codes * - * Returns the full list of Avalara-supported entity use codes. - * Entity/Use Codes are definitions of the entity who is purchasing something, or the purpose for which the transaction - * is occurring. This information is generally used to determine taxability of the product. - * In order to facilitate correct reporting of your taxes, you are encouraged to select the proper entity use codes for + * Returns the full list of Avalara-supported entity use codes. + * Entity/Use Codes are definitions of the entity who is purchasing something, or the purpose for which the transaction + * is occurring. This information is generally used to determine taxability of the product. + * In order to facilitate correct reporting of your taxes, you are encouraged to select the proper entity use codes for * all transactions that are exempt. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* validCountries - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* validCountries + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -3597,19 +3597,19 @@ public function listEntityUseCodes($filter=null, $top=null, $skip=null, $orderBy 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve the full list of Avalara-supported filing frequencies. * - * Returns the full list of Avalara-supported filing frequencies. + * Returns the full list of Avalara-supported filing frequencies. * This API is intended to be useful to identify all the different filing frequencies that can be used in notices. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -3619,23 +3619,23 @@ public function listFilingFrequencies($filter=null, $top=null, $skip=null, $orde 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * List jurisdictions based on the filter provided * - * Returns a list of all Avalara-supported taxing jurisdictions. - * - * This API allows you to examine all Avalara-supported jurisdictions. You can filter your search by supplying - * SQL-like query for fetching only the ones you concerned about. For example: effectiveDate > '2016-01-01' - * + * Returns a list of all Avalara-supported taxing jurisdictions. + * + * This API allows you to examine all Avalara-supported jurisdictions. You can filter your search by supplying + * SQL-like query for fetching only the ones you concerned about. For example: effectiveDate > '2016-01-01' + * * The rate, salesRate, and useRate fields are not available on the JurisdictionModels returned by this API. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* rate, salesRate, signatureCode, useRate - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* rate, salesRate, signatureCode, useRate + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -3645,31 +3645,31 @@ public function listJurisdictions($filter=null, $top=null, $skip=null, $orderBy= 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * List jurisdictions near a specific address * - * Returns a list of all Avalara-supported taxing jurisdictions that apply to this address. - * - * This API allows you to identify which jurisdictions are nearby a specific address according to the best available geocoding information. - * It is intended to allow you to create a "Jurisdiction Override", which allows an address to be configured as belonging to a nearby - * jurisdiction in AvaTax. - * + * Returns a list of all Avalara-supported taxing jurisdictions that apply to this address. + * + * This API allows you to identify which jurisdictions are nearby a specific address according to the best available geocoding information. + * It is intended to allow you to create a "Jurisdiction Override", which allows an address to be configured as belonging to a nearby + * jurisdiction in AvaTax. + * * The results of this API call can be passed to the `CreateJurisdictionOverride` API call. * Swagger Name: AvaTaxClient - * - * @param string $line1 The first address line portion of this address. - * @param string $line2 The second address line portion of this address. - * @param string $line3 The third address line portion of this address. - * @param string $city The city portion of this address. - * @param string $region The region, state, or province code portion of this address. - * @param string $postalCode The postal code or zip code portion of this address. - * @param string $country The two-character ISO-3166 code of the country portion of this address. - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* country, Jurisdictions - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $line1 The first address line portion of this address. + * @param string $line2 The second address line portion of this address. + * @param string $line3 The third address line portion of this address. + * @param string $city The city portion of this address. + * @param string $region The region, state, or province code portion of this address. + * @param string $postalCode The postal code or zip code portion of this address. + * @param string $country The two-character ISO-3166 code of the country portion of this address. + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* country, Jurisdictions + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -3679,30 +3679,30 @@ public function listJurisdictionsByAddress($line1, $line2, $line3, $city, $regio 'query' => ['line1' => $line1, 'line2' => $line2, 'line3' => $line3, 'city' => $city, 'region' => $region, 'postalCode' => $postalCode, 'country' => $country, '$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * List jurisdictions based on the provided taxTypeId, taxSubTypeId, country, and rateTypeId * - * Returns a list of all Avalara-supported taxing jurisdictions filtered by taxTypeId, taxSubTypeId, country, and rateTypeId. - * - * You can optionally pass region as a query parameter to retrieve jurisdictions that are under that region. - * - * This API allows you to examine all Avalara-supported jurisdictions. You can filter your search by supplying - * SQL-like query for fetching only the ones you concerned about. For example: effectiveDate > '2016-01-01' - * + * Returns a list of all Avalara-supported taxing jurisdictions filtered by taxTypeId, taxSubTypeId, country, and rateTypeId. + * + * You can optionally pass region as a query parameter to retrieve jurisdictions that are under that region. + * + * This API allows you to examine all Avalara-supported jurisdictions. You can filter your search by supplying + * SQL-like query for fetching only the ones you concerned about. For example: effectiveDate > '2016-01-01' + * * The jurisdictionType, effectiveDate, and endDate are filterable fields available on the JurisdictionRateTypeTaxTypeMappingModels returned by this API. * Swagger Name: AvaTaxClient - * - * @param string $country The country for which you want to retrieve the jurisdiction information - * @param string $taxTypeId The taxtype for which you want to retrieve the jurisdiction information - * @param string $taxSubTypeId The taxsubtype for which you want to retrieve the jurisdiction information - * @param string $rateTypeId The ratetype for which you want to retrieve the jurisdiction information - * @param string $region The region for which you want to retrieve the jurisdiction information - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* id, country, state, jurisdictionCode, longName, taxTypeId, taxSubTypeId, taxTypeGroupId, rateTypeId - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $country The country for which you want to retrieve the jurisdiction information + * @param string $taxTypeId The taxtype for which you want to retrieve the jurisdiction information + * @param string $taxSubTypeId The taxsubtype for which you want to retrieve the jurisdiction information + * @param string $rateTypeId The ratetype for which you want to retrieve the jurisdiction information + * @param string $region The region for which you want to retrieve the jurisdiction information + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* id, country, state, jurisdictionCode, longName, taxTypeId, taxSubTypeId, taxTypeGroupId, rateTypeId + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -3712,7 +3712,7 @@ public function listJurisdictionsByRateTypeTaxTypeMapping($country, $taxTypeId, 'query' => ['rateTypeId' => $rateTypeId, 'region' => $region, '$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** @@ -3720,10 +3720,10 @@ public function listJurisdictionsByRateTypeTaxTypeMapping($country, $taxTypeId, * * Returns a list of all applicable jurisdiction types based on country, taxTypeId, taxSubTypeId, and rateTypeId * Swagger Name: AvaTaxClient - * - * @param string $country The country for which you want to retrieve the jurisdiction information - * @param string $taxTypeId The taxtype for which you want to retrieve the jurisdiction information - * @param string $taxSubTypeId The taxsubtype for which you want to retrieve the jurisdiction information + * + * @param string $country The country for which you want to retrieve the jurisdiction information + * @param string $taxTypeId The taxtype for which you want to retrieve the jurisdiction information + * @param string $taxSubTypeId The taxsubtype for which you want to retrieve the jurisdiction information * @param string $rateTypeId The ratetype for which you want to retrieve the jurisdiction information * @return string[] */ @@ -3733,32 +3733,32 @@ public function listJurisdictionTypesByRateTypeTaxTypeMapping($country, $taxType 'query' => ['rateTypeId' => $rateTypeId], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve the list of questions that are required for a tax location * - * Returns the list of additional questions you must answer when declaring a location in certain taxing jurisdictions. - * Some tax jurisdictions require that you register or provide additional information to configure each physical place where - * your company does business. - * This information is not usually required in order to calculate tax correctly, but is almost always required to file your tax correctly. - * You can call this API call for any address and obtain information about what questions must be answered in order to properly + * Returns the list of additional questions you must answer when declaring a location in certain taxing jurisdictions. + * Some tax jurisdictions require that you register or provide additional information to configure each physical place where + * your company does business. + * This information is not usually required in order to calculate tax correctly, but is almost always required to file your tax correctly. + * You can call this API call for any address and obtain information about what questions must be answered in order to properly * file tax in that location. * Swagger Name: AvaTaxClient - * - * @param string $line1 The first line of this location's address. - * @param string $line2 The second line of this location's address. - * @param string $line3 The third line of this location's address. - * @param string $city The city part of this location's address. - * @param string $region The region, state, or province part of this location's address. - * @param string $postalCode The postal code of this location's address. - * @param string $country The country part of this location's address. - * @param float $latitude Optionally identify the location via latitude/longitude instead of via address. - * @param float $longitude Optionally identify the location via latitude/longitude instead of via address. - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $line1 The first line of this location's address. + * @param string $line2 The second line of this location's address. + * @param string $line3 The third line of this location's address. + * @param string $city The city part of this location's address. + * @param string $region The region, state, or province part of this location's address. + * @param string $postalCode The postal code of this location's address. + * @param string $country The country part of this location's address. + * @param float $latitude Optionally identify the location via latitude/longitude instead of via address. + * @param float $longitude Optionally identify the location via latitude/longitude instead of via address. + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -3768,20 +3768,20 @@ public function listLocationQuestionsByAddress($line1, $line2, $line3, $city, $r 'query' => ['line1' => $line1, 'line2' => $line2, 'line3' => $line3, 'city' => $city, 'region' => $region, 'postalCode' => $postalCode, 'country' => $country, 'latitude' => $latitude, 'longitude' => $longitude, '$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * List all forms where logins can be verified automatically * - * List all forms where logins can be verified automatically. - * This API is intended to be useful to identify whether the user should be allowed + * List all forms where logins can be verified automatically. + * This API is intended to be useful to identify whether the user should be allowed * to automatically verify their login and password. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* taxFormCodes, scraperType, expectedResponseTime, requiredFilingCalendarDataFields - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* taxFormCodes, scraperType, expectedResponseTime, requiredFilingCalendarDataFields + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -3791,7 +3791,7 @@ public function listLoginVerifiers($filter=null, $top=null, $skip=null, $orderBy 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** @@ -3799,10 +3799,10 @@ public function listLoginVerifiers($filter=null, $top=null, $skip=null, $orderBy * * Retrieves the list of suggested locations for a marketplace. * Swagger Name: AvaTaxClient - * - * @param string $marketplaceId MarketplaceId of a marketplace - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $marketplaceId MarketplaceId of a marketplace + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -3812,20 +3812,20 @@ public function listMarketplaceLocations($marketplaceId, $top=null, $skip=null, 'query' => ['marketplaceId' => $marketplaceId, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve the full list of Avalara-supported nexus for all countries and regions. * - * Returns the full list of all Avalara-supported nexus for all countries and regions. - * + * Returns the full list of all Avalara-supported nexus for all countries and regions. + * * This API is intended to be useful if your user interface needs to display a selectable list of nexus. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* streamlinedSalesTax, isSSTActive, taxTypeGroup, taxAuthorityId, taxName, parameters, taxableNexus - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* streamlinedSalesTax, isSSTActive, taxTypeGroup, taxAuthorityId, taxName, parameters, taxableNexus + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -3835,29 +3835,29 @@ public function listNexus($filter=null, $top=null, $skip=null, $orderBy=null) 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * List all nexus that apply to a specific address. * - * Returns a list of all Avalara-supported taxing jurisdictions that apply to this address. - * This API allows you to identify which tax authorities apply to a physical location, salesperson address, or point of sale. - * In general, it is usually expected that a company will declare nexus in all the jurisdictions that apply to each physical address - * where the company does business. + * Returns a list of all Avalara-supported taxing jurisdictions that apply to this address. + * This API allows you to identify which tax authorities apply to a physical location, salesperson address, or point of sale. + * In general, it is usually expected that a company will declare nexus in all the jurisdictions that apply to each physical address + * where the company does business. * The results of this API call can be passed to the 'Create Nexus' API call to declare nexus for this address. * Swagger Name: AvaTaxClient - * - * @param string $line1 The first address line portion of this address. - * @param string $line2 The first address line portion of this address. - * @param string $line3 The first address line portion of this address. - * @param string $city The city portion of this address. - * @param string $region Name or ISO 3166 code identifying the region portion of the address. This field supports many different region identifiers: * Two and three character ISO 3166 region codes * Fully spelled out names of the region in ISO supported languages * Common alternative spellings for many regions For a full list of all supported codes and names, please see the Definitions API `ListRegions`. - * @param string $postalCode The postal code or zip code portion of this address. - * @param string $country Name or ISO 3166 code identifying the country portion of this address. This field supports many different country identifiers: * Two character ISO 3166 codes * Three character ISO 3166 codes * Fully spelled out names of the country in ISO supported languages * Common alternative spellings for many countries For a full list of all supported codes and names, please see the Definitions API `ListCountries`. - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* streamlinedSalesTax, isSSTActive, taxTypeGroup, taxAuthorityId, taxName, parameters, taxableNexus - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $line1 The first address line portion of this address. + * @param string $line2 The first address line portion of this address. + * @param string $line3 The first address line portion of this address. + * @param string $city The city portion of this address. + * @param string $region Name or ISO 3166 code identifying the region portion of the address. This field supports many different region identifiers: * Two and three character ISO 3166 region codes * Fully spelled out names of the region in ISO supported languages * Common alternative spellings for many regions For a full list of all supported codes and names, please see the Definitions API `ListRegions`. + * @param string $postalCode The postal code or zip code portion of this address. + * @param string $country Name or ISO 3166 code identifying the country portion of this address. This field supports many different country identifiers: * Two character ISO 3166 codes * Three character ISO 3166 codes * Fully spelled out names of the country in ISO supported languages * Common alternative spellings for many countries For a full list of all supported codes and names, please see the Definitions API `ListCountries`. + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* streamlinedSalesTax, isSSTActive, taxTypeGroup, taxAuthorityId, taxName, parameters, taxableNexus + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -3867,21 +3867,21 @@ public function listNexusByAddress($line1, $line2, $line3, $city, $region, $post 'query' => ['line1' => $line1, 'line2' => $line2, 'line3' => $line3, 'city' => $city, 'region' => $region, 'postalCode' => $postalCode, 'country' => $country, '$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve the full list of Avalara-supported nexus for a country. * - * Returns all Avalara-supported nexus for the specified country. - * + * Returns all Avalara-supported nexus for the specified country. + * * This API is intended to be useful if your user interface needs to display a selectable list of nexus filtered by country. * Swagger Name: AvaTaxClient - * - * @param string $country The country in which you want to fetch the system nexus - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* streamlinedSalesTax, isSSTActive, taxTypeGroup, taxAuthorityId, taxName, parameters, taxableNexus - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $country The country in which you want to fetch the system nexus + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* streamlinedSalesTax, isSSTActive, taxTypeGroup, taxAuthorityId, taxName, parameters, taxableNexus + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -3891,22 +3891,22 @@ public function listNexusByCountry($country, $filter=null, $top=null, $skip=null 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve the full list of Avalara-supported nexus for a country and region. * - * Returns all Avalara-supported nexus for the specified country and region. - * + * Returns all Avalara-supported nexus for the specified country and region. + * * This API is intended to be useful if your user interface needs to display a selectable list of nexus filtered by country and region. * Swagger Name: AvaTaxClient - * - * @param string $country The two-character ISO-3166 code for the country. - * @param string $region The two or three character region code for the region. - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* streamlinedSalesTax, isSSTActive, taxTypeGroup, taxAuthorityId, taxName, parameters, taxableNexus - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $country The two-character ISO-3166 code for the country. + * @param string $region The two or three character region code for the region. + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* streamlinedSalesTax, isSSTActive, taxTypeGroup, taxAuthorityId, taxName, parameters, taxableNexus + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -3916,29 +3916,29 @@ public function listNexusByCountryAndRegion($country, $region, $filter=null, $to 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * List nexus related to a tax form * - * Retrieves a list of nexus related to a tax form. - * - * The concept of `Nexus` indicates a place where your company has sufficient physical presence and is obligated - * to collect and remit transaction-based taxes. - * - * When defining companies in AvaTax, you must declare nexus for your company in order to correctly calculate tax - * in all jurisdictions affected by your transactions. - * - * This API is intended to provide useful information when examining a tax form. If you are about to begin filing - * a tax form, you may want to know whether you have declared nexus in all the jurisdictions related to that tax - * form in order to better understand how the form will be filled out. - * - * ### Security Policies - * + * Retrieves a list of nexus related to a tax form. + * + * The concept of `Nexus` indicates a place where your company has sufficient physical presence and is obligated + * to collect and remit transaction-based taxes. + * + * When defining companies in AvaTax, you must declare nexus for your company in order to correctly calculate tax + * in all jurisdictions affected by your transactions. + * + * This API is intended to provide useful information when examining a tax form. If you are about to begin filing + * a tax form, you may want to know whether you have declared nexus in all the jurisdictions related to that tax + * form in order to better understand how the form will be filled out. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * + * * @param string $formCode The form code that we are looking up the nexus for * @return NexusByTaxFormModel */ @@ -3948,21 +3948,21 @@ public function listNexusByFormCode($formCode) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve the full list of Avalara-supported nexus for a tax type group. * - * Returns all Avalara-supported nexus for the specified specified tax type group. - * + * Returns all Avalara-supported nexus for the specified specified tax type group. + * * This API is intended to be useful if your user interface needs to display a selectable list of nexus filtered by tax type group. * Swagger Name: AvaTaxClient - * - * @param string $taxTypeGroup The tax type group to fetch the supporting system nexus for. - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* streamlinedSalesTax, isSSTActive, taxTypeGroup, taxAuthorityId, taxName, parameters, taxableNexus - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $taxTypeGroup The tax type group to fetch the supporting system nexus for. + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* streamlinedSalesTax, isSSTActive, taxTypeGroup, taxAuthorityId, taxName, parameters, taxableNexus + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -3972,19 +3972,19 @@ public function listNexusByTaxTypeGroup($taxTypeGroup, $filter=null, $top=null, 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve the full list of nexus tax type groups * - * Returns the full list of Avalara-supported nexus tax type groups + * Returns the full list of Avalara-supported nexus tax type groups * This API is intended to be useful to identify all the different tax sub-types. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* subscriptionTypeId, subscriptionDescription, tabName, showColumn - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* subscriptionTypeId, subscriptionDescription, tabName, showColumn + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -3994,19 +3994,19 @@ public function listNexusTaxTypeGroups($filter=null, $top=null, $skip=null, $ord 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve the full list of Avalara-supported tax notice customer funding options. * - * Returns the full list of Avalara-supported tax notice customer funding options. + * Returns the full list of Avalara-supported tax notice customer funding options. * This API is intended to be useful to identify all the different notice customer funding options that can be used in notices. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* activeFlag, sortOrder - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* activeFlag, sortOrder + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -4016,19 +4016,19 @@ public function listNoticeCustomerFundingOptions($filter=null, $top=null, $skip= 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve the full list of Avalara-supported tax notice customer types. * - * Returns the full list of Avalara-supported tax notice customer types. + * Returns the full list of Avalara-supported tax notice customer types. * This API is intended to be useful to identify all the different notice customer types. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* activeFlag, sortOrder - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* activeFlag, sortOrder + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -4038,19 +4038,19 @@ public function listNoticeCustomerTypes($filter=null, $top=null, $skip=null, $or 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve the full list of Avalara-supported tax notice filing types. * - * Returns the full list of Avalara-supported tax notice filing types. + * Returns the full list of Avalara-supported tax notice filing types. * This API is intended to be useful to identify all the different notice filing types that can be used in notices. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* description, activeFlag, sortOrder - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* description, activeFlag, sortOrder + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -4060,19 +4060,19 @@ public function listNoticeFilingtypes($filter=null, $top=null, $skip=null, $orde 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve the full list of Avalara-supported tax notice priorities. * - * Returns the full list of Avalara-supported tax notice priorities. + * Returns the full list of Avalara-supported tax notice priorities. * This API is intended to be useful to identify all the different notice priorities that can be used in notices. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* activeFlag, sortOrder - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* activeFlag, sortOrder + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -4082,19 +4082,19 @@ public function listNoticePriorities($filter=null, $top=null, $skip=null, $order 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve the full list of Avalara-supported tax notice reasons. * - * Returns the full list of Avalara-supported tax notice reasons. + * Returns the full list of Avalara-supported tax notice reasons. * This API is intended to be useful to identify all the different tax notice reasons. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* description, activeFlag, sortOrder - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* description, activeFlag, sortOrder + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -4104,19 +4104,19 @@ public function listNoticeReasons($filter=null, $top=null, $skip=null, $orderBy= 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve the full list of Avalara-supported tax notice responsibility ids * - * Returns the full list of Avalara-supported tax notice responsibility ids + * Returns the full list of Avalara-supported tax notice responsibility ids * This API is intended to be useful to identify all the different tax notice responsibilities. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* sortOrder - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* sortOrder + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -4126,19 +4126,19 @@ public function listNoticeResponsibilities($filter=null, $top=null, $skip=null, 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve the full list of Avalara-supported tax notice root causes * - * Returns the full list of Avalara-supported tax notice root causes + * Returns the full list of Avalara-supported tax notice root causes * This API is intended to be useful to identify all the different tax notice root causes. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* sortOrder - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* sortOrder + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -4148,19 +4148,19 @@ public function listNoticeRootCauses($filter=null, $top=null, $skip=null, $order 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve the full list of Avalara-supported tax notice statuses. * - * Returns the full list of Avalara-supported tax notice statuses. + * Returns the full list of Avalara-supported tax notice statuses. * This API is intended to be useful to identify all the different tax notice statuses. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* isOpen, sortOrder - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* isOpen, sortOrder + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -4170,19 +4170,19 @@ public function listNoticeStatuses($filter=null, $top=null, $skip=null, $orderBy 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve the full list of Avalara-supported tax notice types. * - * Returns the full list of Avalara-supported tax notice types. + * Returns the full list of Avalara-supported tax notice types. * This API is intended to be useful to identify all the different notice types that can be used in notices. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* activeFlag, sortOrder - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* activeFlag, sortOrder + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -4192,20 +4192,20 @@ public function listNoticeTypes($filter=null, $top=null, $skip=null, $orderBy=nu 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve the full list of Avalara-supported extra parameters for creating transactions. * - * Returns the full list of Avalara-supported extra parameters for the 'Create Transaction' API call. - * This list of parameters is available for use when configuring your transaction. + * Returns the full list of Avalara-supported extra parameters for the 'Create Transaction' API call. + * This list of parameters is available for use when configuring your transaction. * Some parameters are only available for use if you have subscribed to certain features of AvaTax. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* serviceTypes, regularExpression, values - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* serviceTypes, regularExpression, values + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -4215,37 +4215,37 @@ public function listParameters($filter=null, $top=null, $skip=null, $orderBy=nul 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve the parameters by companyCode and itemCode. * - * Returns the list of parameters based on the company's service types and the item code. - * Ignores nexus if a service type is configured in the 'IgnoreNexusForServiceTypes' configuration section. - * Ignores nexus for the AvaAlcohol service type. - * - * NOTE: If your company code or item code contains any of these characters /, +, ? or a space, please use the following encoding before making a request: - * * Replace '/' with '\_-ava2f-\_' For example: 'Company/Code' becomes 'Company_-ava2f-_Code' - * * Replace '+' with '\_-ava2b-\_' For example: 'Company+Code' becomes 'Company_-ava2b-_Code' - * * Replace '?' with '\_-ava3f-\_' For example: 'Company?Code' becomes 'Company_-ava3f-_Code' - * * Replace '%' with '\_-ava25-\_' For example: 'Company%Code' becomes 'Company_-ava25-_Code' - * * Replace '#' with '\_-ava23-\_' For example: 'Company#Code' becomes 'Company_-ava23-_Code' - * - * For Item Code other than the five given above below two should also be used - * * Replace ''' with '\_-ava27-\_' For example: 'Item'Code' becomes 'Item_-ava27-_Code' - * * Replace '"' with '\_-ava22-\_' For example: 'Item"Code' becomes 'Item_-ava22-_Code' - * - * ### Security Policies - * + * Returns the list of parameters based on the company's service types and the item code. + * Ignores nexus if a service type is configured in the 'IgnoreNexusForServiceTypes' configuration section. + * Ignores nexus for the AvaAlcohol service type. + * + * NOTE: If your company code or item code contains any of these characters /, +, ? or a space, please use the following encoding before making a request: + * * Replace '/' with '\_-ava2f-\_' For example: 'Company/Code' becomes 'Company_-ava2f-_Code' + * * Replace '+' with '\_-ava2b-\_' For example: 'Company+Code' becomes 'Company_-ava2b-_Code' + * * Replace '?' with '\_-ava3f-\_' For example: 'Company?Code' becomes 'Company_-ava3f-_Code' + * * Replace '%' with '\_-ava25-\_' For example: 'Company%Code' becomes 'Company_-ava25-_Code' + * * Replace '#' with '\_-ava23-\_' For example: 'Company#Code' becomes 'Company_-ava23-_Code' + * + * For Item Code other than the five given above below two should also be used + * * Replace ''' with '\_-ava27-\_' For example: 'Item'Code' becomes 'Item_-ava27-_Code' + * * Replace '"' with '\_-ava22-\_' For example: 'Item"Code' becomes 'Item_-ava22-_Code' + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * - * @param string $companyCode Company code. - * @param string $itemCode Item code. - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* serviceTypes, regularExpression, values - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $companyCode Company code. + * @param string $itemCode Item code. + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* serviceTypes, regularExpression, values + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -4255,20 +4255,20 @@ public function listParametersByItem($companyCode, $itemCode, $filter=null, $top 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve the full list of Avalara-supported usage of extra parameters for creating transactions. * - * Returns the full list of Avalara-supported usage of extra parameters for the 'Create Transaction' API call. - * This list of parameters is available for use when configuring your transaction. + * Returns the full list of Avalara-supported usage of extra parameters for the 'Create Transaction' API call. + * This list of parameters is available for use when configuring your transaction. * Some parameters are only available for use if you have subscribed to certain features of AvaTax. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* values - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* values + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -4278,17 +4278,17 @@ public function listParametersUsage($filter=null, $top=null, $skip=null, $orderB 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve the full list of Avalara-supported permissions * - * Returns the full list of Avalara-supported permission types. + * Returns the full list of Avalara-supported permission types. * This API is intended to be useful to identify the capabilities of a particular user logon. * Swagger Name: AvaTaxClient - * - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @return FetchResult */ @@ -4298,7 +4298,7 @@ public function listPermissions($top=null, $skip=null) { 'query' => ['$top' => $top, '$skip' => $skip], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** @@ -4306,10 +4306,10 @@ public function listPermissions($top=null, $skip=null) { * * Retrieves the list of Avalara-supported postal codes. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -4319,26 +4319,26 @@ public function listPostalCodes($filter=null, $top=null, $skip=null, $orderBy=nu 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * List all customs duty programs recognized by AvaTax * - * List all preferred customs duty programs recognized by AvaTax. - * - * A customs duty program is an optional program you can use to obtain favorable treatment from customs and duty agents. - * An example of a preferred program is NAFTA, which provides preferential rates for products being shipped from neighboring - * countries. - * - * To select a preferred program for calculating customs and duty rates, call this API to find the appropriate code for your - * preferred program. Next, set the parameter `AvaTax.LC.PreferredProgram` in your `CreateTransaction` call to the code of + * List all preferred customs duty programs recognized by AvaTax. + * + * A customs duty program is an optional program you can use to obtain favorable treatment from customs and duty agents. + * An example of a preferred program is NAFTA, which provides preferential rates for products being shipped from neighboring + * countries. + * + * To select a preferred program for calculating customs and duty rates, call this API to find the appropriate code for your + * preferred program. Next, set the parameter `AvaTax.LC.PreferredProgram` in your `CreateTransaction` call to the code of * the program. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* effectiveDate, endDate - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* effectiveDate, endDate + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -4348,22 +4348,22 @@ public function listPreferredPrograms($filter=null, $top=null, $skip=null, $orde 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * List all available product classification systems. * - * List all available product classification systems. - * - * Tax authorities use product classification systems as a way to identify products and associate them with a tax rate. + * List all available product classification systems. + * + * Tax authorities use product classification systems as a way to identify products and associate them with a tax rate. * More than one tax authority might use the same product classification system, but they might charge different tax rates for products. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* countries - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. - * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* countries + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @param string $countryCode If not null, return all records with this code. * @return FetchResult */ @@ -4373,31 +4373,31 @@ public function listProductClassificationSystems($filter=null, $top=null, $skip= 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy, '$countryCode' => $countryCode], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * List all product classification systems available to a company based on its nexus. * - * Lists all product classification systems available to a company based on its nexus. - * - * Tax authorities use product classification systems as a way to identify products and associate them with a tax rate. - * More than one tax authority might use the same product classification system, but they might charge different tax rates for products. - * - * - * NOTE: If your company code contains any of these characters /, +, ? or a space, please use the following encoding before making a request: - * * Replace '/' with '\_-ava2f-\_' For example: 'Company/Code' becomes 'Company_-ava2f-_Code' - * * Replace '+' with '\_-ava2b-\_' For example: 'Company+Code' becomes 'Company_-ava2b-_Code' - * * Replace '?' with '\_-ava3f-\_' For example: 'Company?Code' becomes 'Company_-ava3f-_Code' - * * Replace '%' with '\_-ava25-\_' For example: 'Company%Code' becomes 'Company_-ava25-_Code' + * Lists all product classification systems available to a company based on its nexus. + * + * Tax authorities use product classification systems as a way to identify products and associate them with a tax rate. + * More than one tax authority might use the same product classification system, but they might charge different tax rates for products. + * + * + * NOTE: If your company code contains any of these characters /, +, ? or a space, please use the following encoding before making a request: + * * Replace '/' with '\_-ava2f-\_' For example: 'Company/Code' becomes 'Company_-ava2f-_Code' + * * Replace '+' with '\_-ava2b-\_' For example: 'Company+Code' becomes 'Company_-ava2b-_Code' + * * Replace '?' with '\_-ava3f-\_' For example: 'Company?Code' becomes 'Company_-ava3f-_Code' + * * Replace '%' with '\_-ava25-\_' For example: 'Company%Code' becomes 'Company_-ava25-_Code' * * Replace '#' with '\_-ava23-\_' For example: 'Company#Code' becomes 'Company_-ava23-_Code' * Swagger Name: AvaTaxClient - * - * @param string $companyCode The company code. - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* countries - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. - * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. + * + * @param string $companyCode The company code. + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* countries + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @param string $countryCode If not null, return all records with this code. * @return FetchResult */ @@ -4407,20 +4407,20 @@ public function listProductClassificationSystemsByCompany($companyCode, $filter= 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy, '$countryCode' => $countryCode], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve the full list of rate types for each country * - * Returns the full list of Avalara-supported rate type file types + * Returns the full list of Avalara-supported rate type file types * This API is intended to be useful to identify all the different rate types. * Swagger Name: AvaTaxClient - * - * @param string $country The country to examine for rate types - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $country The country to examine for rate types + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -4430,22 +4430,22 @@ public function listRateTypesByCountry($country, $filter=null, $top=null, $skip= 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve the list of rate types by country, TaxType and by TaxSubType * - * Returns the list of Avalara-supported rate type file types + * Returns the list of Avalara-supported rate type file types * This API is intended to be useful to identify all the different rate types. * Swagger Name: AvaTaxClient - * - * @param string $country The country to examine for rate types - * @param string $taxTypeId The taxType for the country to examine for rate types - * @param string $taxSubTypeId The taxSubType for the country and taxType to examine for rate types - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* id, rateType, description - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $country The country to examine for rate types + * @param string $taxTypeId The taxType for the country to examine for rate types + * @param string $taxSubTypeId The taxSubType for the country and taxType to examine for rate types + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* id, rateType, description + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -4455,20 +4455,20 @@ public function listRateTypesByCountryTaxTypeTaxSubType($country, $taxTypeId, $t 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * List all ISO 3166 regions * - * Returns a list of all ISO 3166 region codes and their US English friendly names. - * This API is intended to be useful when presenting a dropdown box in your website to allow customers to select a region + * Returns a list of all ISO 3166 region codes and their US English friendly names. + * This API is intended to be useful when presenting a dropdown box in your website to allow customers to select a region * within the country for a shipping addresses. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* localizedNames - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* localizedNames + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -4478,21 +4478,21 @@ public function listRegions($filter=null, $top=null, $skip=null, $orderBy=null) 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * List all ISO 3166 regions for a country * - * Returns a list of all ISO 3166 region codes for a specific country code, and their US English friendly names. - * This API is intended to be useful when presenting a dropdown box in your website to allow customers to select a region + * Returns a list of all ISO 3166 region codes for a specific country code, and their US English friendly names. + * This API is intended to be useful when presenting a dropdown box in your website to allow customers to select a region * within the country for a shipping addresses. * Swagger Name: AvaTaxClient - * - * @param string $country The country of which you want to fetch ISO 3166 regions - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* localizedNames - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $country The country of which you want to fetch ISO 3166 regions + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* localizedNames + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -4502,19 +4502,19 @@ public function listRegionsByCountry($country, $filter=null, $top=null, $skip=nu 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve the full list of Avalara-supported resource file types * - * Returns the full list of Avalara-supported resource file types + * Returns the full list of Avalara-supported resource file types * This API is intended to be useful to identify all the different resource file types. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -4524,20 +4524,20 @@ public function listResourceFileTypes($filter=null, $top=null, $skip=null, $orde 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve the full list of Avalara-supported usage of parameters used for returns. * - * Returns the full list of Avalara-supported usage of extra parameters for the returns. - * This list of parameters is available for use with Returns. + * Returns the full list of Avalara-supported usage of extra parameters for the returns. + * This list of parameters is available for use with Returns. * Some parameters are only available for use if you have subscribed to certain features of AvaTax. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* values - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* values + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -4547,20 +4547,20 @@ public function listReturnsParametersUsage($filter=null, $top=null, $skip=null, 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve the full list of Avalara-supported permissions * - * Returns the full list of Avalara-supported permission types. - * This API is intended to be useful when designing a user interface for selecting the security role of a user account. + * Returns the full list of Avalara-supported permission types. + * This API is intended to be useful when designing a user interface for selecting the security role of a user account. * Some security roles are restricted for Avalara internal use. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -4570,21 +4570,21 @@ public function listSecurityRoles($filter=null, $top=null, $skip=null, $orderBy= 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve the full list of Avalara-supported subscription types * - * Returns the full list of Avalara-supported subscription types. - * This API is intended to be useful for identifying which features you have added to your account. - * You may always contact Avalara's sales department for information on available products or services. + * Returns the full list of Avalara-supported subscription types. + * This API is intended to be useful for identifying which features you have added to your account. + * You may always contact Avalara's sales department for information on available products or services. * You cannot change your subscriptions directly through the API. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -4594,7 +4594,7 @@ public function listSubscriptionTypes($filter=null, $top=null, $skip=null, $orde 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** @@ -4602,10 +4602,10 @@ public function listSubscriptionTypes($filter=null, $top=null, $skip=null, $orde * * Retrieves the list of suggested locations for a marketplace. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -4615,19 +4615,19 @@ public function listTags($filter=null, $top=null, $skip=null, $orderBy=null) 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve the full list of Avalara-supported tax authorities. * - * Returns the full list of Avalara-supported tax authorities. + * Returns the full list of Avalara-supported tax authorities. * This API is intended to be useful to identify all the different authorities that receive tax. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -4637,21 +4637,21 @@ public function listTaxAuthorities($filter=null, $top=null, $skip=null, $orderBy 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve the full list of Avalara-supported forms for each tax authority. * - * Returns the full list of Avalara-supported forms for each tax authority. - * This list represents tax forms that Avalara recognizes. - * Customers who subscribe to Avalara Managed Returns Service can request these forms to be filed automatically + * Returns the full list of Avalara-supported forms for each tax authority. + * This list represents tax forms that Avalara recognizes. + * Customers who subscribe to Avalara Managed Returns Service can request these forms to be filed automatically * based on the customer's AvaTax data. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -4661,19 +4661,19 @@ public function listTaxAuthorityForms($filter=null, $top=null, $skip=null, $orde 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve the full list of Avalara-supported tax authority types. * - * Returns the full list of Avalara-supported tax authority types. + * Returns the full list of Avalara-supported tax authority types. * This API is intended to be useful to identify all the different authority types. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -4683,26 +4683,26 @@ public function listTaxAuthorityTypes($filter=null, $top=null, $skip=null, $orde 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve the full list of Avalara-supported tax codes. * - * Retrieves the list of Avalara-supported system tax codes. - * A 'TaxCode' represents a uniquely identified type of product, good, or service. - * Avalara supports correct tax rates and taxability rules for all TaxCodes in all supported jurisdictions. - * If you identify your products by tax code in your 'Create Transacion' API calls, Avalara will correctly calculate tax rates and - * taxability rules for this product in all supported jurisdictions. - * - * ### Security Policies - * + * Retrieves the list of Avalara-supported system tax codes. + * A 'TaxCode' represents a uniquely identified type of product, good, or service. + * Avalara supports correct tax rates and taxability rules for all TaxCodes in all supported jurisdictions. + * If you identify your products by tax code in your 'Create Transacion' API calls, Avalara will correctly calculate tax rates and + * taxability rules for this product in all supported jurisdictions. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -4712,18 +4712,18 @@ public function listTaxCodes($filter=null, $top=null, $skip=null, $orderBy=null) 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve the full list of Avalara-supported tax code types. * - * Returns the full list of recognized tax code types. - * A 'Tax Code Type' represents a broad category of tax codes, and is less detailed than a single TaxCode. + * Returns the full list of recognized tax code types. + * A 'Tax Code Type' represents a broad category of tax codes, and is less detailed than a single TaxCode. * This API is intended to be useful for broadly searching for tax codes by tax code type. * Swagger Name: AvaTaxClient - * - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @return TaxCodeTypesModel */ @@ -4733,19 +4733,19 @@ public function listTaxCodeTypes($top=null, $skip=null) { 'query' => ['$top' => $top, '$skip' => $skip], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve the full list of the Tax Forms available * - * Returns the full list of Avalara-supported Tax Forms + * Returns the full list of Avalara-supported Tax Forms * This API is intended to be useful to identify all the different Tax Forms * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -4755,19 +4755,19 @@ public function listTaxForms($filter=null, $top=null, $skip=null, $orderBy=null) 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve the full list of tax sub types * - * Returns the full list of Avalara-supported tax sub-types + * Returns the full list of Avalara-supported tax sub-types * This API is intended to be useful to identify all the different tax sub-types. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -4777,21 +4777,21 @@ public function listTaxSubTypes($filter=null, $top=null, $skip=null, $orderBy=nu 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve the full list of tax sub types by Country and TaxType * - * Returns the full list of Avalara-supported tax sub-types + * Returns the full list of Avalara-supported tax sub-types * This API is intended to be useful to identify all the different tax sub-types for given country and TaxType. * Swagger Name: AvaTaxClient - * - * @param string $country The country to examine for taxsubtype - * @param string $taxTypeId The taxType for the country to examine for taxsubtype - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $country The country to examine for taxsubtype + * @param string $taxTypeId The taxType for the country to examine for taxsubtype + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -4801,21 +4801,21 @@ public function listTaxSubTypesByCountryAndTaxType($country, $taxTypeId, $filter 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve the full list of tax sub types by jurisdiction code and region * - * Returns the full list of Avalara-supported tax sub-types by jurisdiction and region + * Returns the full list of Avalara-supported tax sub-types by jurisdiction and region * This API is intended to be useful to identify all the different tax sub-types. * Swagger Name: AvaTaxClient - * - * @param string $jurisdictionCode The jurisdiction code of the tax sub type. - * @param string $region The region of the tax sub type. - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $jurisdictionCode The jurisdiction code of the tax sub type. + * @param string $region The region of the tax sub type. + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -4825,19 +4825,19 @@ public function listTaxSubTypesByJurisdictionAndRegion($jurisdictionCode, $regio 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve the full list of tax type groups * - * Returns the full list of Avalara-supported tax type groups + * Returns the full list of Avalara-supported tax type groups * This API is intended to be useful to identify all the different tax type groups. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* subscriptionTypeId, subscriptionDescription, tabName, showColumn, displaySequence - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* subscriptionTypeId, subscriptionDescription, tabName, showColumn, displaySequence + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -4847,7 +4847,7 @@ public function listTaxTypeGroups($filter=null, $top=null, $skip=null, $orderBy= 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** @@ -4855,11 +4855,11 @@ public function listTaxTypeGroups($filter=null, $top=null, $skip=null, $orderBy= * * Retrieves the list of applicable TaxTypes based on Nexus of the company. * Swagger Name: AvaTaxClient - * - * @param string $country The country for which you want to retrieve the unitofbasis information - * @param int $companyId Your companyId to retrieve the applicable taxtypes - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $country The country for which you want to retrieve the unitofbasis information + * @param int $companyId Your companyId to retrieve the applicable taxtypes + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -4869,7 +4869,7 @@ public function listTaxTypesByNexusAndCountry($country, $companyId, $top=null, $ 'query' => ['companyId' => $companyId, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** @@ -4877,13 +4877,13 @@ public function listTaxTypesByNexusAndCountry($country, $companyId, $top=null, $ * * Retrieves the list of applicable UnitOfBasis * Swagger Name: AvaTaxClient - * - * @param string $country The country for which you want to retrieve the unitofbasis information - * @param string $taxTypeId The taxtype for which you want to retrieve the unitofbasis information - * @param string $taxSubTypeId The taxsubtype for which you want to retrieve the unitofbasis information - * @param string $rateTypeId The ratetype for which you want to retrieve the unitofbasis information - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $country The country for which you want to retrieve the unitofbasis information + * @param string $taxTypeId The taxtype for which you want to retrieve the unitofbasis information + * @param string $taxSubTypeId The taxsubtype for which you want to retrieve the unitofbasis information + * @param string $rateTypeId The ratetype for which you want to retrieve the unitofbasis information + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -4893,20 +4893,20 @@ public function listUnitOfBasisByCountryAndTaxTypeAndTaxSubTypeAndRateType($coun 'query' => ['rateTypeId' => $rateTypeId, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * List all defined units of measurement * - * List all units of measurement systems defined by Avalara. - * + * List all units of measurement systems defined by Avalara. + * * A unit of measurement system is a method of measuring a quantity, such as distance, mass, or others. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* id - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* id + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -4916,24 +4916,24 @@ public function listUnitOfMeasurement($filter=null, $top=null, $skip=null, $orde 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Create one or more DistanceThreshold objects * - * Create one or more DistanceThreshold objects for this company. - * - * A company-distance-threshold model indicates the distance between a company - * and the taxing borders of various countries. Distance thresholds are necessary - * to correctly calculate some value-added taxes. - * - * ### Security Policies - * + * Create one or more DistanceThreshold objects for this company. + * + * A company-distance-threshold model indicates the distance between a company + * and the taxing borders of various countries. Distance thresholds are necessary + * to correctly calculate some value-added taxes. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The unique ID number of the company that owns this DistanceThreshold + * + * @param int $companyId The unique ID number of the company that owns this DistanceThreshold * @param CompanyDistanceThresholdModel[] $model The DistanceThreshold object or objects you wish to create. * @return CompanyDistanceThresholdModel[] */ @@ -4943,24 +4943,24 @@ public function createDistanceThreshold($companyId, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Delete a single DistanceThreshold object * - * Marks the DistanceThreshold object identified by this URL as deleted. - * - * A company-distance-threshold model indicates the distance between a company - * and the taxing borders of various countries. Distance thresholds are necessary - * to correctly calculate some value-added taxes. - * - * ### Security Policies - * + * Marks the DistanceThreshold object identified by this URL as deleted. + * + * A company-distance-threshold model indicates the distance between a company + * and the taxing borders of various countries. Distance thresholds are necessary + * to correctly calculate some value-added taxes. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The unique ID number of the company that owns this DistanceThreshold + * + * @param int $companyId The unique ID number of the company that owns this DistanceThreshold * @param int $id The unique ID number of the DistanceThreshold object you wish to delete. * @return ErrorDetail[] */ @@ -4970,24 +4970,24 @@ public function deleteDistanceThreshold($companyId, $id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'DELETE', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'DELETE', $guzzleParams,'22.8.0' ); } /** * Retrieve a single DistanceThreshold * - * Retrieves a single DistanceThreshold object defined by this URL. - * - * A company-distance-threshold model indicates the distance between a company - * and the taxing borders of various countries. Distance thresholds are necessary - * to correctly calculate some value-added taxes. - * - * ### Security Policies - * + * Retrieves a single DistanceThreshold object defined by this URL. + * + * A company-distance-threshold model indicates the distance between a company + * and the taxing borders of various countries. Distance thresholds are necessary + * to correctly calculate some value-added taxes. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this DistanceThreshold object + * + * @param int $companyId The ID of the company that owns this DistanceThreshold object * @param int $id The unique ID number referring to this DistanceThreshold object * @return CompanyDistanceThresholdModel */ @@ -4997,28 +4997,28 @@ public function getDistanceThreshold($companyId, $id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve all DistanceThresholds for this company. * - * Lists all DistanceThreshold objects that belong to this company. - * - * A company-distance-threshold model indicates the distance between a company - * and the taxing borders of various countries. Distance thresholds are necessary - * to correctly calculate some value-added taxes. - * - * ### Security Policies - * + * Lists all DistanceThreshold objects that belong to this company. + * + * A company-distance-threshold model indicates the distance between a company + * and the taxing borders of various countries. Distance thresholds are necessary + * to correctly calculate some value-added taxes. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company whose DistanceThreshold objects you wish to list. - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). - * @param string $include A comma separated list of additional data to retrieve. - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param int $companyId The ID of the company whose DistanceThreshold objects you wish to list. + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). + * @param string $include A comma separated list of additional data to retrieve. + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -5028,30 +5028,30 @@ public function listDistanceThresholds($companyId, $filter=null, $include=null, 'query' => ['$filter' => $filter, '$include' => $include, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve all DistanceThreshold objects * - * Lists all DistanceThreshold objects that belong to this account. - * - * A company-distance-threshold model indicates the distance between a company - * and the taxing borders of various countries. Distance thresholds are necessary - * to correctly calculate some value-added taxes. - * - * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . - * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. - * - * ### Security Policies - * + * Lists all DistanceThreshold objects that belong to this account. + * + * A company-distance-threshold model indicates the distance between a company + * and the taxing borders of various countries. Distance thresholds are necessary + * to correctly calculate some value-added taxes. + * + * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . + * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). - * @param string $include A comma separated list of additional data to retrieve. - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). + * @param string $include A comma separated list of additional data to retrieve. + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -5061,28 +5061,28 @@ public function queryDistanceThresholds($filter=null, $include=null, $top=null, 'query' => ['$filter' => $filter, '$include' => $include, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Update a DistanceThreshold object * - * Replace the existing DistanceThreshold object at this URL with an updated object. - * - * A company-distance-threshold model indicates the distance between a company - * and the taxing borders of various countries. Distance thresholds are necessary - * to correctly calculate some value-added taxes. - * - * All data from the existing object will be replaced with data in the object you PUT. - * To set a field's value to null, you may either set its value to null or omit that field from the object you post. - * - * ### Security Policies - * + * Replace the existing DistanceThreshold object at this URL with an updated object. + * + * A company-distance-threshold model indicates the distance between a company + * and the taxing borders of various countries. Distance thresholds are necessary + * to correctly calculate some value-added taxes. + * + * All data from the existing object will be replaced with data in the object you PUT. + * To set a field's value to null, you may either set its value to null or omit that field from the object you post. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The unique ID number of the company that owns this DistanceThreshold object. - * @param int $id The unique ID number of the DistanceThreshold object to replace. + * + * @param int $companyId The unique ID number of the company that owns this DistanceThreshold object. + * @param int $id The unique ID number of the DistanceThreshold object to replace. * @param CompanyDistanceThresholdModel $model The new DistanceThreshold object to store. * @return CompanyDistanceThresholdModel */ @@ -5092,22 +5092,22 @@ public function updateDistanceThreshold($companyId, $id, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'PUT', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'PUT', $guzzleParams,'22.8.0' ); } /** * Create a new eCommerce token. * - * Creates a new eCommerce token. - * - * This API is used to create a new eCommerce token. An eCommerce token is required in order to launch the CertCapture eCommerce plugin. Create a token for each of your CertCapture customers. - * - * ### Security Policies - * + * Creates a new eCommerce token. + * + * This API is used to create a new eCommerce token. An eCommerce token is required in order to launch the CertCapture eCommerce plugin. Create a token for each of your CertCapture customers. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * - * @param int $companyId The company ID that will be issued this certificate. + * + * @param int $companyId The company ID that will be issued this certificate. * @param CreateECommerceTokenInputModel $model * @return ECommerceTokenOutputModel */ @@ -5117,22 +5117,22 @@ public function createECommerceToken($companyId, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Refresh an eCommerce token. * - * Refresh an eCommerce token. - * - * CertCapture eCommerce tokens expire after one hour. This API is used to refresh an eCommerce token that is about to expire. This API can only be used with active tokens. If your token has expired, you must generate a new one. - * - * ### Security Policies - * + * Refresh an eCommerce token. + * + * CertCapture eCommerce tokens expire after one hour. This API is used to refresh an eCommerce token that is about to expire. This API can only be used with active tokens. If your token has expired, you must generate a new one. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * - * @param int $companyId The company ID that the refreshed certificate belongs to. + * + * @param int $companyId The company ID that the refreshed certificate belongs to. * @param RefreshECommerceTokenInputModel $model * @return FetchResult */ @@ -5142,19 +5142,19 @@ public function refreshECommerceToken($companyId, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'PUT', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'PUT', $guzzleParams,'22.8.0' ); } /** * Approves linkage to a firm for a client account * - * This API enables the account admin of a client account to approve linkage request by a firm. - * - * ### Security Policies - * + * This API enables the account admin of a client account to approve linkage request by a firm. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * + * * @param int $id * @return FirmClientLinkageOutputModel */ @@ -5164,28 +5164,28 @@ public function approveFirmClientLinkage($id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Request a new FirmClient account and create an approved linkage to it * - * This API is for use by Firms only. - * - * Avalara allows firms to manage returns for clients without the clients needing to use AvaTax service. - * Firms can create accounts of FirmClient for customers they are managing using this API. - * - * Calling this API creates an account with the specified product subscriptions, but without a new user for account. - * Account is then linked to the Firm so they can managed their returns. - * You should call this API when a customer does not have an AvaTax account and is to be managed only by the firm. - * - * The created account will be created in `Active` status but there will be no user or license key associated with account. - * - * ### Security Policies - * + * This API is for use by Firms only. + * + * Avalara allows firms to manage returns for clients without the clients needing to use AvaTax service. + * Firms can create accounts of FirmClient for customers they are managing using this API. + * + * Calling this API creates an account with the specified product subscriptions, but without a new user for account. + * Account is then linked to the Firm so they can managed their returns. + * You should call this API when a customer does not have an AvaTax account and is to be managed only by the firm. + * + * The created account will be created in `Active` status but there will be no user or license key associated with account. + * + * ### Security Policies + * * * This API requires one of the following user roles: FirmAdmin, Registrar, SiteAdmin, SystemAdmin. * Swagger Name: AvaTaxClient - * + * * @param NewFirmClientAccountRequestModel $model Information about the account you wish to create. * @return FirmClientLinkageOutputModel */ @@ -5195,19 +5195,19 @@ public function createAndLinkNewFirmClientAccount($model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Links a firm account with the client account * - * This API enables the firm admins/firm users to request the linkage of a firm account and a client account. - * - * ### Security Policies - * + * This API enables the firm admins/firm users to request the linkage of a firm account and a client account. + * + * ### Security Policies + * * * This API requires one of the following user roles: BatchServiceAdmin, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * + * * @param FirmClientLinkageInputModel $model FirmClientLinkageInputModel * @return FirmClientLinkageOutputModel */ @@ -5217,19 +5217,19 @@ public function createFirmClientLinkage($model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Delete a linkage * - * This API marks a linkage between a firm and client as deleted. - * - * ### Security Policies - * + * This API marks a linkage between a firm and client as deleted. + * + * ### Security Policies + * * * This API requires one of the following user roles: BatchServiceAdmin, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * + * * @param int $id * @return ErrorDetail[] */ @@ -5239,19 +5239,19 @@ public function deleteFirmClientLinkage($id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'DELETE', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'DELETE', $guzzleParams,'22.8.0' ); } /** * Get linkage between a firm and client by id * - * This API enables the firm admins/firm users to request the linkage of a firm account and a client account. - * - * ### Security Policies - * + * This API enables the firm admins/firm users to request the linkage of a firm account and a client account. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * + * * @param int $id * @return FirmClientLinkageOutputModel */ @@ -5261,19 +5261,19 @@ public function getFirmClientLinkage($id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * List client linkages for a firm or client * - * This API enables the firm or account users to request the associated linkages to the account. - * - * ### Security Policies - * + * This API enables the firm or account users to request the associated linkages to the account. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * + * * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* firmAccountName, clientAccountName * @return FetchResult */ @@ -5283,19 +5283,19 @@ public function listFirmClientLinkage($filter=null) { 'query' => ['$filter' => $filter], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Rejects linkage to a firm for a client account * - * This API enables the account admin of a client account to reject linkage request by a firm. - * - * ### Security Policies - * + * This API enables the account admin of a client account to reject linkage request by a firm. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * + * * @param int $id * @return FirmClientLinkageOutputModel */ @@ -5305,19 +5305,19 @@ public function rejectFirmClientLinkage($id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Reset linkage status between a client and firm back to requested * - * This API enables the firm admin of a client account to reset a previously created linkage request by a firm. - * - * ### Security Policies - * + * This API enables the firm admin of a client account to reset a previously created linkage request by a firm. + * + * ### Security Policies + * * * This API requires one of the following user roles: BatchServiceAdmin, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * + * * @param int $id * @return FirmClientLinkageOutputModel */ @@ -5327,19 +5327,19 @@ public function resetFirmClientLinkage($id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Revokes previously approved linkage to a firm for a client account * - * This API enables the account admin of a client account to revoke a previously approved linkage request by a firm. - * - * ### Security Policies - * + * This API enables the account admin of a client account to revoke a previously approved linkage request by a firm. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * + * * @param int $id * @return FirmClientLinkageOutputModel */ @@ -5349,28 +5349,28 @@ public function revokeFirmClientLinkage($id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * FREE API - Request a free trial of AvaTax * - * Call this API to obtain a free AvaTax account. - * - * This API is free to use. No authentication credentials are required to call this API. You must read and - * accept [Avalara's terms and conditions](https://www1.avalara.com/us/en/legal/terms.html) for the account to be - * created. - * - * If all conditions are met, this API will grant a free trial version of AvaTax. For a list of functionality - * available in the free trial and its limitations, please see the [AvaTax Developer Website Free Trial page](https://developer.avalara.com/avatax/signup/). - * - * After your free trial concludes, you will still be able to use the [Free AvaTax API Suite](https://developer.avalara.com/api-reference/avatax/rest/v2/methods/Free/). - * - * ### Security Policies - * + * Call this API to obtain a free AvaTax account. + * + * This API is free to use. No authentication credentials are required to call this API. You must read and + * accept [Avalara's terms and conditions](https://www1.avalara.com/us/en/legal/terms.html) for the account to be + * created. + * + * If all conditions are met, this API will grant a free trial version of AvaTax. For a list of functionality + * available in the free trial and its limitations, please see the [AvaTax Developer Website Free Trial page](https://developer.avalara.com/avatax/signup/). + * + * After your free trial concludes, you will still be able to use the [Free AvaTax API Suite](https://developer.avalara.com/api-reference/avatax/rest/v2/methods/Free/). + * + * ### Security Policies + * * * This API may be called without providing authentication credentials. * Swagger Name: AvaTaxClient - * + * * @param FreeTrialRequestModel $model Required information to provision a free trial account. * @return NewAccountModel */ @@ -5380,33 +5380,33 @@ public function requestFreeTrial($model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Request the javascript for a funding setup widget * - * This API is available by invitation only. - * Companies that use the Avalara Managed Returns or the SST Certified Service Provider services are - * required to setup their funding configuration before Avalara can begin filing tax returns on their - * behalf. - * Funding configuration for each company is set up by submitting a funding setup request, which can - * be sent either via email or via an embedded HTML widget. - * When the funding configuration is submitted to Avalara, it will be reviewed by treasury team members - * before approval. - * This API returns back the actual javascript code to insert into your application to render the - * JavaScript funding setup widget inline. - * Use the 'methodReturn.javaScript' return value to insert this widget into your HTML page. - * This API requires a subscription to Avalara Managed Returns or SST Certified Service Provider. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. + * This API is available by invitation only. + * Companies that use the Avalara Managed Returns or the SST Certified Service Provider services are + * required to setup their funding configuration before Avalara can begin filing tax returns on their + * behalf. + * Funding configuration for each company is set up by submitting a funding setup request, which can + * be sent either via email or via an embedded HTML widget. + * When the funding configuration is submitted to Avalara, it will be reviewed by treasury team members + * before approval. + * This API returns back the actual javascript code to insert into your application to render the + * JavaScript funding setup widget inline. + * Use the 'methodReturn.javaScript' return value to insert this widget into your HTML page. + * This API requires a subscription to Avalara Managed Returns or SST Certified Service Provider. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * * This API depends on the following active services:*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged. * Swagger Name: AvaTaxClient - * - * @param int $id The unique ID number of this funding request - * @param string $businessUnit The company's business unit (See POABusinessUnit::* for a list of allowable values) + * + * @param int $id The unique ID number of this funding request + * @param string $businessUnit The company's business unit (See POABusinessUnit::* for a list of allowable values) * @param string $subscriptionType The company's subscription type (See POASubscriptionType::* for a list of allowable values) * @return FundingStatusModel */ @@ -5416,31 +5416,31 @@ public function activateFundingRequest($id, $businessUnit, $subscriptionType) 'query' => ['businessUnit' => $businessUnit, 'subscriptionType' => $subscriptionType], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve status about a funding setup request * - * This API is available by invitation only. - * Companies that use the Avalara Managed Returns or the SST Certified Service Provider services are - * required to setup their funding configuration before Avalara can begin filing tax returns on their - * behalf. - * Funding configuration for each company is set up by submitting a funding setup request, which can - * be sent either via email or via an embedded HTML widget. - * When the funding configuration is submitted to Avalara, it will be reviewed by treasury team members - * before approval. - * This API checks the status on an existing funding request. - * This API requires a subscription to Avalara Managed Returns or SST Certified Service Provider. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. + * This API is available by invitation only. + * Companies that use the Avalara Managed Returns or the SST Certified Service Provider services are + * required to setup their funding configuration before Avalara can begin filing tax returns on their + * behalf. + * Funding configuration for each company is set up by submitting a funding setup request, which can + * be sent either via email or via an embedded HTML widget. + * When the funding configuration is submitted to Avalara, it will be reviewed by treasury team members + * before approval. + * This API checks the status on an existing funding request. + * This API requires a subscription to Avalara Managed Returns or SST Certified Service Provider. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. * * This API depends on the following active services:*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged. * Swagger Name: AvaTaxClient - * - * @param int $id The unique ID number of this funding request - * @param string $businessUnit The company's business unit (See POABusinessUnit::* for a list of allowable values) + * + * @param int $id The unique ID number of this funding request + * @param string $businessUnit The company's business unit (See POABusinessUnit::* for a list of allowable values) * @param string $subscriptionType The company's subscription type (See POASubscriptionType::* for a list of allowable values) * @return FundingStatusModel */ @@ -5450,24 +5450,24 @@ public function fundingRequestStatus($id, $businessUnit, $subscriptionType) { 'query' => ['businessUnit' => $businessUnit, 'subscriptionType' => $subscriptionType], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Delete all classifications for an item * - * Delete all the classifications for a given item. - * - * A classification is the code for a product in a particular tax system. Classifications enable an item to be used in multiple tax systems which may have different tax rates for a product. - * - * When an item is used in a transaction, the applicable classification will be used to determine the appropriate tax rate. - * - * ### Security Policies - * + * Delete all the classifications for a given item. + * + * A classification is the code for a product in a particular tax system. Classifications enable an item to be used in multiple tax systems which may have different tax rates for a product. + * + * When an item is used in a transaction, the applicable classification will be used to determine the appropriate tax rate. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this item. + * + * @param int $companyId The ID of the company that owns this item. * @param int $itemId The ID of the item you wish to delete the classifications. * @return ErrorDetail[] */ @@ -5477,26 +5477,26 @@ public function batchDeleteItemClassifications($companyId, $itemId) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'DELETE', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'DELETE', $guzzleParams,'22.8.0' ); } /** * Delete all parameters for an item * - * Delete all the parameters for a given item. - * - * Some items can be taxed differently depending on the properties of that item, such as the item grade or by a particular measurement of that item. In AvaTax, these tax-affecting properties are called "parameters". - * - * A parameter added to an item will be used by default in tax calculation but will not show on the transaction line referencing the item . - * - * A parameter specified on a transaction line will override an item parameter if they share the same parameter name. - * - * ### Security Policies - * + * Delete all the parameters for a given item. + * + * Some items can be taxed differently depending on the properties of that item, such as the item grade or by a particular measurement of that item. In AvaTax, these tax-affecting properties are called "parameters". + * + * A parameter added to an item will be used by default in tax calculation but will not show on the transaction line referencing the item . + * + * A parameter specified on a transaction line will override an item parameter if they share the same parameter name. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this item. + * + * @param int $companyId The ID of the company that owns this item. * @param int $itemId The ID of the item you wish to delete the parameters. * @return ErrorDetail[] */ @@ -5506,28 +5506,28 @@ public function batchDeleteItemParameters($companyId, $itemId) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'DELETE', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'DELETE', $guzzleParams,'22.8.0' ); } /** * Bulk upload items from a product catalog * - * Create/Update one or more item objects attached to this company. - * - * Items are a way of separating your tax calculation process from your tax configuration details. If you choose, you - * can provide `itemCode` values for each `CreateTransaction()` API call rather than specifying tax codes, parameters, descriptions, - * and other data fields. AvaTax will automatically look up each `itemCode` and apply the correct tax codes and parameters - * from the item table instead. This allows your CreateTransaction call to be as simple as possible, and your tax compliance - * team can manage your item catalog and adjust the tax behavior of items without having to modify your software. - * - * The tax code takes precedence over the tax code id if both are provided. - * - * ### Security Policies - * + * Create/Update one or more item objects attached to this company. + * + * Items are a way of separating your tax calculation process from your tax configuration details. If you choose, you + * can provide `itemCode` values for each `CreateTransaction()` API call rather than specifying tax codes, parameters, descriptions, + * and other data fields. AvaTax will automatically look up each `itemCode` and apply the correct tax codes and parameters + * from the item table instead. This allows your CreateTransaction call to be as simple as possible, and your tax compliance + * team can manage your item catalog and adjust the tax behavior of items without having to modify your software. + * + * The tax code takes precedence over the tax code id if both are provided. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this items. + * + * @param int $companyId The ID of the company that owns this items. * @param ItemBulkUploadInputModel $model The items you wish to upload. * @return ItemBulkUploadOutputModel */ @@ -5537,27 +5537,27 @@ public function bulkUploadItems($companyId, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Add classifications to an item. * - * Add classifications to an item. - * - * A classification is the code for a product in a particular tax system. Classifications enable an item to be used in multiple tax systems which may have different tax rates for a product. - * - * When an item is used in a transaction, the applicable classification will be used to determine the appropriate tax rate. - * - * An item may only have one classification per tax system. - * - * ### Security Policies - * + * Add classifications to an item. + * + * A classification is the code for a product in a particular tax system. Classifications enable an item to be used in multiple tax systems which may have different tax rates for a product. + * + * When an item is used in a transaction, the applicable classification will be used to determine the appropriate tax rate. + * + * An item may only have one classification per tax system. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The company id. - * @param int $itemId The item id. + * + * @param int $companyId The company id. + * @param int $itemId The item id. * @param ItemClassificationInputModel[] $model The item classifications you wish to create. * @return ItemClassificationOutputModel[] */ @@ -5567,31 +5567,31 @@ public function createItemClassifications($companyId, $itemId, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Add parameters to an item. * - * Add parameters to an item. - * - * Some items can be taxed differently depending on the properties of that item, such as the item grade or by a particular measurement of that item. In AvaTax, these tax-affecting properties are called "parameters". - * - * A parameter added to an item will be used by default in tax calculation but will not show on the transaction line referencing the item . - * - * A parameter specified on a transaction line will override an item parameter if they share the same parameter name. - * - * To see available parameters for this item, call `/api/v2/definitions/parameters?$filter=attributeType eq Product` - * - * Some parameters are only available for use if you have subscribed to specific AvaTax services. To see which parameters you are able to use, add the query parameter "$showSubscribed=true" to the parameter definition call above. - * - * ### Security Policies - * + * Add parameters to an item. + * + * Some items can be taxed differently depending on the properties of that item, such as the item grade or by a particular measurement of that item. In AvaTax, these tax-affecting properties are called "parameters". + * + * A parameter added to an item will be used by default in tax calculation but will not show on the transaction line referencing the item . + * + * A parameter specified on a transaction line will override an item parameter if they share the same parameter name. + * + * To see available parameters for this item, call `/api/v2/definitions/parameters?$filter=attributeType eq Product` + * + * Some parameters are only available for use if you have subscribed to specific AvaTax services. To see which parameters you are able to use, add the query parameter "$showSubscribed=true" to the parameter definition call above. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this item parameter. - * @param int $itemId The item id. + * + * @param int $companyId The ID of the company that owns this item parameter. + * @param int $itemId The item id. * @param ItemParameterModel[] $model The item parameters you wish to create. * @return ItemParameterModel[] */ @@ -5601,28 +5601,28 @@ public function createItemParameters($companyId, $itemId, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Create a new item * - * Creates one or more new item objects attached to this company. - * - * Items are a way of separating your tax calculation process from your tax configuration details. If you choose, you - * can provide `itemCode` values for each `CreateTransaction()` API call rather than specifying tax codes, parameters, descriptions, - * and other data fields. AvaTax will automatically look up each `itemCode` and apply the correct tax codes and parameters - * from the item table instead. This allows your CreateTransaction call to be as simple as possible, and your tax compliance - * team can manage your item catalog and adjust the tax behavior of items without having to modify your software. - * - * The tax code takes precedence over the tax code id if both are provided. - * - * ### Security Policies - * + * Creates one or more new item objects attached to this company. + * + * Items are a way of separating your tax calculation process from your tax configuration details. If you choose, you + * can provide `itemCode` values for each `CreateTransaction()` API call rather than specifying tax codes, parameters, descriptions, + * and other data fields. AvaTax will automatically look up each `itemCode` and apply the correct tax codes and parameters + * from the item table instead. This allows your CreateTransaction call to be as simple as possible, and your tax compliance + * team can manage your item catalog and adjust the tax behavior of items without having to modify your software. + * + * The tax code takes precedence over the tax code id if both are provided. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this item. + * + * @param int $companyId The ID of the company that owns this item. * @param ItemModel[] $model The item you wish to create. * @return ItemModel[] */ @@ -5632,23 +5632,23 @@ public function createItems($companyId, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Create tags for a item * - * Creates one or more new `Tag` objects attached to this Item. - * - * Item tags puts multiple labels for an item. So that item can be easily grouped by these tags. - * - * ### Security Policies - * + * Creates one or more new `Tag` objects attached to this Item. + * + * Item tags puts multiple labels for an item. So that item can be easily grouped by these tags. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that defined these items - * @param int $itemId The ID of the item as defined by the company that owns this tag. + * + * @param int $companyId The ID of the company that defined these items + * @param int $itemId The ID of the item as defined by the company that owns this tag. * @param ItemTagDetailModel[] $model Tags you wish to associate with the Item * @return ItemTagDetailModel[] */ @@ -5658,24 +5658,24 @@ public function createItemTags($companyId, $itemId, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Create a new tax code classification request * - * Creates a new tax code classification request. - * - * Avalara AvaTax system tax codes represent various goods and services classified by industry or consumer categories and - * major physical similarities. Taxability rules are associated with tax codes. Customers can map their Items to tax codes, - * allowing them to take advantage of thousands of tax rules in the AvaTax engine and resulting in accurate taxability determinations. - * - * ### Security Policies - * + * Creates a new tax code classification request. + * + * Avalara AvaTax system tax codes represent various goods and services classified by industry or consumer categories and + * major physical similarities. Taxability rules are associated with tax codes. Customers can map their Items to tax codes, + * allowing them to take advantage of thousands of tax rules in the AvaTax engine and resulting in accurate taxability determinations. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company creating this request. + * + * @param int $companyId The ID of the company creating this request. * @param ItemTaxCodeClassificationRequestInputModel $model The request you wish to create. * @return ItemTaxCodeClassificationRequestOutputModel */ @@ -5685,34 +5685,34 @@ public function createTaxCodeClassificationRequest($companyId, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Delete a single item * - * Deletes the item object at this URL. - * - * Items are a way of separating your tax calculation process from your tax configuration details. - * Use this endpoint to delete an existing item with item code. - * - * Deleting an item will also delete the parameters, classifications, and product categories associated with that item. - * - * NOTE: If your item code contains any of these characters /, +, ? or a space, please use the following encoding before making a request: - * * Replace '/' with '\_-ava2f-\_' For example: 'Item/Code' becomes 'Item_-ava2f-_Code' - * * Replace '+' with '\_-ava2b-\_' For example: 'Item+Code' becomes 'Item_-ava2b-_Code' - * * Replace '?' with '\_-ava3f-\_' For example: 'Item?Code' becomes 'Item_-ava3f-_Code' - * * Replace '%' with '\_-ava25-\_' For example: 'Item%Code' becomes 'Item_-ava25-_Code' - * * Replace '#' with '\_-ava23-\_' For example: 'Item#Code' becomes 'Item_-ava23-_Code' - * * Replace ''' with '\_-ava27-\_' For example: 'Item'Code' becomes 'Item_-ava27-_Code' - * * Replace '"' with '\_-ava22-\_' For example: 'Item"Code' becomes 'Item_-ava22-_Code' - * - * ### Security Policies - * + * Deletes the item object at this URL. + * + * Items are a way of separating your tax calculation process from your tax configuration details. + * Use this endpoint to delete an existing item with item code. + * + * Deleting an item will also delete the parameters, classifications, and product categories associated with that item. + * + * NOTE: If your item code contains any of these characters /, +, ? or a space, please use the following encoding before making a request: + * * Replace '/' with '\_-ava2f-\_' For example: 'Item/Code' becomes 'Item_-ava2f-_Code' + * * Replace '+' with '\_-ava2b-\_' For example: 'Item+Code' becomes 'Item_-ava2b-_Code' + * * Replace '?' with '\_-ava3f-\_' For example: 'Item?Code' becomes 'Item_-ava3f-_Code' + * * Replace '%' with '\_-ava25-\_' For example: 'Item%Code' becomes 'Item_-ava25-_Code' + * * Replace '#' with '\_-ava23-\_' For example: 'Item#Code' becomes 'Item_-ava23-_Code' + * * Replace ''' with '\_-ava27-\_' For example: 'Item'Code' becomes 'Item_-ava27-_Code' + * * Replace '"' with '\_-ava22-\_' For example: 'Item"Code' becomes 'Item_-ava22-_Code' + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this item. + * + * @param int $companyId The ID of the company that owns this item. * @param string $itemCode The code of the item you want to delete. * @return ErrorDetail[] */ @@ -5722,28 +5722,28 @@ public function deleteCatalogueItem($companyId, $itemCode) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'DELETE', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'DELETE', $guzzleParams,'22.8.0' ); } /** * Delete a single item * - * Deletes the item object at this URL. - * - * Items are a way of separating your tax calculation process from your tax configuration details. If you choose, you - * can provide `itemCode` values for each `CreateTransaction()` API call rather than specifying tax codes, parameters, descriptions, - * and other data fields. AvaTax will automatically look up each `itemCode` and apply the correct tax codes and parameters - * from the item table instead. This allows your CreateTransaction call to be as simple as possible, and your tax compliance - * team can manage your item catalog and adjust the tax behavior of items without having to modify your software. - * - * Deleting an item will also delete the parameters and classifications associated with that item. - * - * ### Security Policies - * + * Deletes the item object at this URL. + * + * Items are a way of separating your tax calculation process from your tax configuration details. If you choose, you + * can provide `itemCode` values for each `CreateTransaction()` API call rather than specifying tax codes, parameters, descriptions, + * and other data fields. AvaTax will automatically look up each `itemCode` and apply the correct tax codes and parameters + * from the item table instead. This allows your CreateTransaction call to be as simple as possible, and your tax compliance + * team can manage your item catalog and adjust the tax behavior of items without having to modify your software. + * + * Deleting an item will also delete the parameters and classifications associated with that item. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this item. + * + * @param int $companyId The ID of the company that owns this item. * @param int $id The ID of the item you wish to delete. * @return ErrorDetail[] */ @@ -5753,25 +5753,25 @@ public function deleteItem($companyId, $id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'DELETE', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'DELETE', $guzzleParams,'22.8.0' ); } /** * Delete a single item classification. * - * Delete a single item classification. - * - * A classification is the code for a product in a particular tax system. Classifications enable an item to be used in multiple tax systems which may have different tax rates for a product. - * - * When an item is used in a transaction, the applicable classification will be used to determine the appropriate tax rate. - * - * ### Security Policies - * + * Delete a single item classification. + * + * A classification is the code for a product in a particular tax system. Classifications enable an item to be used in multiple tax systems which may have different tax rates for a product. + * + * When an item is used in a transaction, the applicable classification will be used to determine the appropriate tax rate. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The company id. - * @param int $itemId The item id. + * + * @param int $companyId The company id. + * @param int $itemId The item id. * @param int $id The item classification id. * @return ErrorDetail[] */ @@ -5781,27 +5781,27 @@ public function deleteItemClassification($companyId, $itemId, $id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'DELETE', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'DELETE', $guzzleParams,'22.8.0' ); } /** * Delete a single item parameter * - * Delete a single item parameter. - * - * Some items can be taxed differently depending on the properties of that item, such as the item grade or by a particular measurement of that item. In AvaTax, these tax-affecting properties are called "parameters". - * - * A parameter added to an item will be used by default in tax calculation but will not show on the transaction line referencing the item . - * - * A parameter specified on a transaction line will override an item parameter if they share the same parameter name. - * - * ### Security Policies - * + * Delete a single item parameter. + * + * Some items can be taxed differently depending on the properties of that item, such as the item grade or by a particular measurement of that item. In AvaTax, these tax-affecting properties are called "parameters". + * + * A parameter added to an item will be used by default in tax calculation but will not show on the transaction line referencing the item . + * + * A parameter specified on a transaction line will override an item parameter if they share the same parameter name. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The company id - * @param int $itemId The item id + * + * @param int $companyId The company id + * @param int $itemId The item id * @param int $id The parameter id * @return ErrorDetail[] */ @@ -5811,23 +5811,23 @@ public function deleteItemParameter($companyId, $itemId, $id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'DELETE', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'DELETE', $guzzleParams,'22.8.0' ); } /** * Delete item tag by id * - * Deletes the `Tag` object of an Item at this URL. - * - * Item tags puts multiple labels for an item. So that item can be easily grouped by these tags. - * - * ### Security Policies - * + * Deletes the `Tag` object of an Item at this URL. + * + * Item tags puts multiple labels for an item. So that item can be easily grouped by these tags. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that defined these items - * @param int $itemId The ID of the item as defined by the company that owns this tag. + * + * @param int $companyId The ID of the company that defined these items + * @param int $itemId The ID of the item as defined by the company that owns this tag. * @param int $itemTagDetailId The ID of the item tag detail you wish to delete. * @return ErrorDetail[] */ @@ -5837,22 +5837,22 @@ public function deleteItemTag($companyId, $itemId, $itemTagDetailId) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'DELETE', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'DELETE', $guzzleParams,'22.8.0' ); } /** * Delete all item tags * - * Deletes all `Tags` objects of an Item at this URL. - * - * Item tags puts multiple labels for an item. So that item can be easily grouped by these tags. - * - * ### Security Policies - * + * Deletes all `Tags` objects of an Item at this URL. + * + * Item tags puts multiple labels for an item. So that item can be easily grouped by these tags. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that defined these items. + * + * @param int $companyId The ID of the company that defined these items. * @param int $itemId The ID of the item as defined by the company that owns this tag. * @return ErrorDetail[] */ @@ -5862,30 +5862,30 @@ public function deleteItemTags($companyId, $itemId) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'DELETE', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'DELETE', $guzzleParams,'22.8.0' ); } /** * Get the status of classification requests for a company * - * Get the status of tax code classification requests for a company. - * - * Avalara AvaTax system tax codes represent various goods and services classified by industry or consumer categories and - * major physical similarities. Taxability rules are associated with tax codes. Customers can map their Items to tax codes, - * allowing them to take advantage of thousands of tax rules in the AvaTax engine and resulting in accurate taxability determinations. - * - * Enable includeClassificationDetails flag to get details of classification request status. - * - * ### Security Policies - * + * Get the status of tax code classification requests for a company. + * + * Avalara AvaTax system tax codes represent various goods and services classified by industry or consumer categories and + * major physical similarities. Taxability rules are associated with tax codes. Customers can map their Items to tax codes, + * allowing them to take advantage of thousands of tax rules in the AvaTax engine and resulting in accurate taxability determinations. + * + * Enable includeClassificationDetails flag to get details of classification request status. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that defined these items - * @param boolean $includeClassificationDetails A Boolean field that specifies whether to get a detailed classification status. - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* classificationDetails, totalItems, status - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param int $companyId The ID of the company that defined these items + * @param boolean $includeClassificationDetails A Boolean field that specifies whether to get a detailed classification status. + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* classificationDetails, totalItems, status + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -5895,27 +5895,27 @@ public function getClassificationStatus($companyId, $includeClassificationDetail 'query' => ['$includeClassificationDetails' => $includeClassificationDetails, '$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve a single item * - * Get the `Item` object identified by this URL. - * - * Items are a way of separating your tax calculation process from your tax configuration details. If you choose, you - * can provide `itemCode` values for each `CreateTransaction()` API call rather than specifying tax codes, parameters, descriptions, - * and other data fields. AvaTax will automatically look up each `itemCode` and apply the correct tax codes and parameters - * from the item table instead. This allows your CreateTransaction call to be as simple as possible, and your tax compliance - * team can manage your item catalog and adjust the tax behavior of items without having to modify your software. - * - * ### Security Policies - * + * Get the `Item` object identified by this URL. + * + * Items are a way of separating your tax calculation process from your tax configuration details. If you choose, you + * can provide `itemCode` values for each `CreateTransaction()` API call rather than specifying tax codes, parameters, descriptions, + * and other data fields. AvaTax will automatically look up each `itemCode` and apply the correct tax codes and parameters + * from the item table instead. This allows your CreateTransaction call to be as simple as possible, and your tax compliance + * team can manage your item catalog and adjust the tax behavior of items without having to modify your software. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this item object - * @param int $id The primary key of this item + * + * @param int $companyId The ID of the company that owns this item object + * @param int $id The primary key of this item * @param string $include A comma separated list of additional data to retrieve. * @return ItemModel */ @@ -5925,25 +5925,25 @@ public function getItem($companyId, $id, $include=null) { 'query' => ['$include' => $include], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve a single item classification. * - * Retrieve a single item classification. - * - * A classification is the code for a product in a particular tax system. Classifications enable an item to be used in multiple tax systems which may have different tax rates for a product. - * - * When an item is used in a transaction, the applicable classification will be used to determine the appropriate tax rate. - * - * ### Security Policies - * + * Retrieve a single item classification. + * + * A classification is the code for a product in a particular tax system. Classifications enable an item to be used in multiple tax systems which may have different tax rates for a product. + * + * When an item is used in a transaction, the applicable classification will be used to determine the appropriate tax rate. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * - * @param int $companyId The company id. - * @param int $itemId The item id. + * + * @param int $companyId The company id. + * @param int $itemId The item id. * @param int $id The item classification id. * @return ItemClassificationOutputModel */ @@ -5953,27 +5953,27 @@ public function getItemClassification($companyId, $itemId, $id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve a single item parameter * - * Retrieve a single item parameter. - * - * Some items can be taxed differently depending on the properties of that item, such as the item grade or by a particular measurement of that item. In AvaTax, these tax-affecting properties are called "parameters". - * - * A parameter added to an item will be used by default in tax calculation but will not show on the transaction line referencing the item . - * - * A parameter specified on a transaction line will override an item parameter if they share the same parameter name. - * - * ### Security Policies - * + * Retrieve a single item parameter. + * + * Some items can be taxed differently depending on the properties of that item, such as the item grade or by a particular measurement of that item. In AvaTax, these tax-affecting properties are called "parameters". + * + * A parameter added to an item will be used by default in tax calculation but will not show on the transaction line referencing the item . + * + * A parameter specified on a transaction line will override an item parameter if they share the same parameter name. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * - * @param int $companyId The company id - * @param int $itemId The item id + * + * @param int $companyId The company id + * @param int $itemId The item id * @param int $id The parameter id * @return ItemParameterModel */ @@ -5983,25 +5983,25 @@ public function getItemParameter($companyId, $itemId, $id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve tags for an item * - * Get the `Tag` objects of an Item identified by this URL. - * - * Item tags puts multiple labels for an item. So that item can be easily grouped by these tags. - * - * ### Security Policies - * + * Get the `Tag` objects of an Item identified by this URL. + * + * Item tags puts multiple labels for an item. So that item can be easily grouped by these tags. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that defined these items - * @param int $itemId The ID of the item as defined by the company that owns this tag. - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* tagName - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * + * @param int $companyId The ID of the company that defined these items + * @param int $itemId The ID of the item as defined by the company that owns this tag. + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* tagName + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @return FetchResult */ @@ -6011,30 +6011,30 @@ public function getItemTags($companyId, $itemId, $filter=null, $top=null, $skip= 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve premium classification for a company's item based on its ItemCode and SystemCode. * - * Retrieves the premium classification for an ItemCode and SystemCode. - * - * NOTE: If your item code contains any of these characters /, +, ?,",' ,% or #, please use the following encoding before making a request: - * * Replace '/' with '\_-ava2f-\_' For example: 'Item/Code' becomes 'Item_-ava2f-_Code' - * * Replace '+' with '\_-ava2b-\_' For example: 'Item+Code' becomes 'Item_-ava2b-_Code' - * * Replace '?' with '\_-ava3f-\_' For example: 'Item?Code' becomes 'Item_-ava3f-_Code' - * * Replace '%' with '\_-ava25-\_' For example: 'Item%Code' becomes 'Item_-ava25-_Code' - * * Replace '#' with '\_-ava23-\_' For example: 'Item#Code' becomes 'Item_-ava23-_Code' - * * Replace ''' with '\_-ava27-\_' For example: 'Item'Code' becomes 'Item_-ava27-_Code' - * * Replace '"' with '\_-ava22-\_' For example: 'Item"Code' becomes 'Item_-ava22-_Code' - * - * ### Security Policies - * + * Retrieves the premium classification for an ItemCode and SystemCode. + * + * NOTE: If your item code contains any of these characters /, +, ?,",' ,% or #, please use the following encoding before making a request: + * * Replace '/' with '\_-ava2f-\_' For example: 'Item/Code' becomes 'Item_-ava2f-_Code' + * * Replace '+' with '\_-ava2b-\_' For example: 'Item+Code' becomes 'Item_-ava2b-_Code' + * * Replace '?' with '\_-ava3f-\_' For example: 'Item?Code' becomes 'Item_-ava3f-_Code' + * * Replace '%' with '\_-ava25-\_' For example: 'Item%Code' becomes 'Item_-ava25-_Code' + * * Replace '#' with '\_-ava23-\_' For example: 'Item#Code' becomes 'Item_-ava23-_Code' + * * Replace ''' with '\_-ava27-\_' For example: 'Item'Code' becomes 'Item_-ava27-_Code' + * * Replace '"' with '\_-ava22-\_' For example: 'Item"Code' becomes 'Item_-ava22-_Code' + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this item object - * @param string $itemCode The ItemCode of the item for which you want to retrieve premium classification + * + * @param int $companyId The ID of the company that owns this item object + * @param string $itemCode The ItemCode of the item for which you want to retrieve premium classification * @param string $systemCode The SystemCode for which you want to retrieve premium classification * @return ItemPremiumClassificationOutputModel */ @@ -6044,28 +6044,28 @@ public function getPremiumClassification($companyId, $itemCode, $systemCode) 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Get tax code recommendations * - * Get tax code recommendations. - * - * Avalara AvaTax system tax codes represent various goods and services classified by industry or consumer categories and - * major physical similarities. Taxability rules are associated with tax codes. Customers can map their Items to tax codes, - * allowing them to take advantage of thousands of tax rules in the AvaTax engine and resulting in accurate taxability determinations. - * - * ### Security Policies - * + * Get tax code recommendations. + * + * Avalara AvaTax system tax codes represent various goods and services classified by industry or consumer categories and + * major physical similarities. Taxability rules are associated with tax codes. Customers can map their Items to tax codes, + * allowing them to take advantage of thousands of tax rules in the AvaTax engine and resulting in accurate taxability determinations. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that defined these items - * @param int $requestId The ID of the classification request - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* recommendations, url - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param int $companyId The ID of the company that defined these items + * @param int $requestId The ID of the classification request + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* recommendations, url + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -6075,33 +6075,33 @@ public function getTaxCodeRecommendations($companyId, $requestId, $filter=null, 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve Restrictions for Item by CountryOfImport * - * Retrieve Restrictions for Item by CountryOfImport. This API will only return import restriction for the countryOfImport. - * - * NOTE: If your item code contains any of these characters /, +, ? or a space, please use the following encoding before making a request: - * * Replace '/' with '\_-ava2f-\_' For example: 'Item/Code' becomes 'Item_-ava2f-_Code' - * * Replace '+' with '\_-ava2b-\_' For example: 'Item+Code' becomes 'Item_-ava2b-_Code' - * * Replace '?' with '\_-ava3f-\_' For example: 'Item?Code' becomes 'Item_-ava3f-_Code' - * * Replace '%' with '\_-ava25-\_' For example: 'Item%Code' becomes 'Item_-ava25-_Code' - * * Replace '#' with '\_-ava23-\_' For example: 'Item#Code' becomes 'Item_-ava23-_Code' - * * Replace ''' with '\_-ava27-\_' For example: 'Item'Code' becomes 'Item_-ava27-_Code' - * * Replace '"' with '\_-ava22-\_' For example: 'Item"Code' becomes 'Item_-ava22-_Code' - * - * ### Security Policies - * + * Retrieve Restrictions for Item by CountryOfImport. This API will only return import restriction for the countryOfImport. + * + * NOTE: If your item code contains any of these characters /, +, ? or a space, please use the following encoding before making a request: + * * Replace '/' with '\_-ava2f-\_' For example: 'Item/Code' becomes 'Item_-ava2f-_Code' + * * Replace '+' with '\_-ava2b-\_' For example: 'Item+Code' becomes 'Item_-ava2b-_Code' + * * Replace '?' with '\_-ava3f-\_' For example: 'Item?Code' becomes 'Item_-ava3f-_Code' + * * Replace '%' with '\_-ava25-\_' For example: 'Item%Code' becomes 'Item_-ava25-_Code' + * * Replace '#' with '\_-ava23-\_' For example: 'Item#Code' becomes 'Item_-ava23-_Code' + * * Replace ''' with '\_-ava27-\_' For example: 'Item'Code' becomes 'Item_-ava27-_Code' + * * Replace '"' with '\_-ava22-\_' For example: 'Item"Code' becomes 'Item_-ava22-_Code' + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this item object - * @param string $itemCode ItemCode for the item - * @param string $countryOfImport Country for which you want the restrictions for the Item. - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param int $companyId The ID of the company that owns this item object + * @param string $itemCode ItemCode for the item + * @param string $countryOfImport Country for which you want the restrictions for the Item. + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -6111,31 +6111,31 @@ public function listImportRestrictions($companyId, $itemCode, $countryOfImport, 'query' => ['$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve classifications for an item. * - * List classifications for an item. - * - * A classification is the code for a product in a particular tax system. Classifications enable an item to be used in multiple tax systems which may have different tax rates for a product. - * - * When an item is used in a transaction, the applicable classification will be used to determine the appropriate tax rate. - * - * Search for specific objects using the criteria in the `$filter` classification; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . - * Paginate your results using the `$top`, `$skip`, and `$orderby` classifications. - * - * ### Security Policies - * + * List classifications for an item. + * + * A classification is the code for a product in a particular tax system. Classifications enable an item to be used in multiple tax systems which may have different tax rates for a product. + * + * When an item is used in a transaction, the applicable classification will be used to determine the appropriate tax rate. + * + * Search for specific objects using the criteria in the `$filter` classification; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . + * Paginate your results using the `$top`, `$skip`, and `$orderby` classifications. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * - * @param int $companyId The company id. - * @param int $itemId The item id. - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* productCode, systemCode - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param int $companyId The company id. + * @param int $itemId The item id. + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* productCode, systemCode + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -6145,33 +6145,33 @@ public function listItemClassifications($companyId, $itemId, $filter=null, $top= 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve parameters for an item * - * List parameters for an item. - * - * Some items can be taxed differently depending on the properties of that item, such as the item grade or by a particular measurement of that item. In AvaTax, these tax-affecting properties are called "parameters". - * - * A parameter added to an item will be used by default in tax calculation but will not show on the transaction line referencing the item . - * - * A parameter specified on a transaction line will override an item parameter if they share the same parameter name. - * - * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . - * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. - * - * ### Security Policies - * + * List parameters for an item. + * + * Some items can be taxed differently depending on the properties of that item, such as the item grade or by a particular measurement of that item. In AvaTax, these tax-affecting properties are called "parameters". + * + * A parameter added to an item will be used by default in tax calculation but will not show on the transaction line referencing the item . + * + * A parameter specified on a transaction line will override an item parameter if they share the same parameter name. + * + * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . + * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * - * @param int $companyId The company id - * @param int $itemId The item id - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* name, unit, isNeededForCalculation, isNeededForReturns, isNeededForClassification - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param int $companyId The company id + * @param int $itemId The item id + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* name, unit, isNeededForCalculation, isNeededForReturns, isNeededForClassification + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -6181,43 +6181,43 @@ public function listItemParameters($companyId, $itemId, $filter=null, $top=null, 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve items for this company * - * List all items defined for the current company. - * - * Items are a way of separating your tax calculation process from your tax configuration details. If you choose, you - * can provide `itemCode` values for each `CreateTransaction()` API call rather than specifying tax codes, parameters, descriptions, - * and other data fields. AvaTax will automatically look up each `itemCode` and apply the correct tax codes and parameters - * from the item table instead. This allows your CreateTransaction call to be as simple as possible, and your tax compliance - * team can manage your item catalog and adjust the tax behavior of items without having to modify your software. - * - * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . - * - * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. - * - * You may specify Tag Name in the `tagName` query parameter if you want to filter items on the basis of tagName - * - * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: - * - * * Parameters - * * Classifications - * * Tags - * - * ### Security Policies - * + * List all items defined for the current company. + * + * Items are a way of separating your tax calculation process from your tax configuration details. If you choose, you + * can provide `itemCode` values for each `CreateTransaction()` API call rather than specifying tax codes, parameters, descriptions, + * and other data fields. AvaTax will automatically look up each `itemCode` and apply the correct tax codes and parameters + * from the item table instead. This allows your CreateTransaction call to be as simple as possible, and your tax compliance + * team can manage your item catalog and adjust the tax behavior of items without having to modify your software. + * + * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . + * + * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. + * + * You may specify Tag Name in the `tagName` query parameter if you want to filter items on the basis of tagName + * + * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: + * + * * Parameters + * * Classifications + * * Tags + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that defined these items - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* taxCode, source, upc, classifications, parameters, tags - * @param string $include A comma separated list of additional data to retrieve. - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. - * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. + * + * @param int $companyId The ID of the company that defined these items + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* taxCode, source, upc, classifications, parameters, tags + * @param string $include A comma separated list of additional data to retrieve. + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @param string $tagName Tag Name on the basis of which you want to filter Items * @return FetchResult */ @@ -6227,33 +6227,33 @@ public function listItemsByCompany($companyId, $filter=null, $include=null, $top 'query' => ['$filter' => $filter, '$include' => $include, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy, 'tagName' => $tagName], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve all items * - * Get multiple item objects across all companies. - * - * Items are a way of separating your tax calculation process from your tax configuration details. If you choose, you - * can provide `itemCode` values for each `CreateTransaction()` API call rather than specifying tax codes, parameters, descriptions, - * and other data fields. AvaTax will automatically look up each `itemCode` and apply the correct tax codes and parameters - * from the item table instead. This allows your CreateTransaction call to be as simple as possible, and your tax compliance - * team can manage your item catalog and adjust the tax behavior of items without having to modify your software. - * - * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . - * - * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. - * - * ### Security Policies - * + * Get multiple item objects across all companies. + * + * Items are a way of separating your tax calculation process from your tax configuration details. If you choose, you + * can provide `itemCode` values for each `CreateTransaction()` API call rather than specifying tax codes, parameters, descriptions, + * and other data fields. AvaTax will automatically look up each `itemCode` and apply the correct tax codes and parameters + * from the item table instead. This allows your CreateTransaction call to be as simple as possible, and your tax compliance + * team can manage your item catalog and adjust the tax behavior of items without having to modify your software. + * + * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . + * + * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* taxCode, source, upc, classifications, parameters, tags - * @param string $include A comma separated list of additional data to retrieve. - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* taxCode, source, upc, classifications, parameters, tags + * @param string $include A comma separated list of additional data to retrieve. + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -6263,35 +6263,35 @@ public function queryItems($filter=null, $include=null, $top=null, $skip=null, $ 'query' => ['$filter' => $filter, '$include' => $include, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve all items associated with given tag * - * Get multiple item objects associated with given tag. - * - * Items are a way of separating your tax calculation process from your tax configuration details. If you choose, you - * can provide `itemCode` values for each `CreateTransaction()` API call rather than specifying tax codes, parameters, descriptions, - * and other data fields. AvaTax will automatically look up each `itemCode` and apply the correct tax codes and parameters - * from the item table instead. This allows your CreateTransaction call to be as simple as possible, and your tax compliance - * team can manage your item catalog and adjust the tax behavior of items without having to modify your software. - * - * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . - * - * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. - * - * ### Security Policies - * + * Get multiple item objects associated with given tag. + * + * Items are a way of separating your tax calculation process from your tax configuration details. If you choose, you + * can provide `itemCode` values for each `CreateTransaction()` API call rather than specifying tax codes, parameters, descriptions, + * and other data fields. AvaTax will automatically look up each `itemCode` and apply the correct tax codes and parameters + * from the item table instead. This allows your CreateTransaction call to be as simple as possible, and your tax compliance + * team can manage your item catalog and adjust the tax behavior of items without having to modify your software. + * + * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . + * + * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that defined these items. - * @param string $tag The master tag to be associated with item. - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* taxCode, source, upc, classifications, parameters, tags - * @param string $include A comma separated list of additional data to retrieve. - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param int $companyId The ID of the company that defined these items. + * @param string $tag The master tag to be associated with item. + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* taxCode, source, upc, classifications, parameters, tags + * @param string $include A comma separated list of additional data to retrieve. + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -6301,24 +6301,24 @@ public function queryItemsByTag($companyId, $tag, $filter=null, $include=null, $ 'query' => ['$filter' => $filter, '$include' => $include, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Create or update items from a product catalog. * - * Creates/updates one or more item objects with additional properties and the AvaTax category attached to this company. - * - * Items are a way of separating your tax calculation process from your tax configuration details. Use this endpoint to create - * a new or update an existing item. This can be used to sync the items with Avalara. For example, an accounting software - * system can use this to sync all their items from an ERP with Avalara. - * - * ### Security Policies - * + * Creates/updates one or more item objects with additional properties and the AvaTax category attached to this company. + * + * Items are a way of separating your tax calculation process from your tax configuration details. Use this endpoint to create + * a new or update an existing item. This can be used to sync the items with Avalara. For example, an accounting software + * system can use this to sync all their items from an ERP with Avalara. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this item. + * + * @param int $companyId The ID of the company that owns this item. * @param ItemCatalogueInputModel[] $model The items you want to create or update. * @return ItemCatalogueOutputModel */ @@ -6328,31 +6328,31 @@ public function syncItemCatalogue($companyId, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Sync items from a product catalog * - * Syncs a list of items with AvaTax without waiting for them to be created. It is ideal for syncing large product catalogs - * with AvaTax. - * - * Any invalid or duplicate items will be ignored. To diagnose why an item is not created, use the normal create transaction API to receive validation information. - * - * This API is currently limited to 1000 items per call (the limit is subject to change). - * - * Items are a way of separating your tax calculation process from your tax configuration details. If you choose, you - * can provide `itemCode` values for each `CreateTransaction()` API call rather than specifying tax codes, parameters, descriptions, - * and other data fields. AvaTax will automatically look up each `itemCode` and apply the correct tax codes and parameters - * from the item table instead. This allows your CreateTransaction call to be as simple as possible, and your tax compliance - * team can manage your item catalog and adjust the tax behavior of items without having to modify your software. - * - * ### Security Policies - * + * Syncs a list of items with AvaTax without waiting for them to be created. It is ideal for syncing large product catalogs + * with AvaTax. + * + * Any invalid or duplicate items will be ignored. To diagnose why an item is not created, use the normal create transaction API to receive validation information. + * + * This API is currently limited to 1000 items per call (the limit is subject to change). + * + * Items are a way of separating your tax calculation process from your tax configuration details. If you choose, you + * can provide `itemCode` values for each `CreateTransaction()` API call rather than specifying tax codes, parameters, descriptions, + * and other data fields. AvaTax will automatically look up each `itemCode` and apply the correct tax codes and parameters + * from the item table instead. This allows your CreateTransaction call to be as simple as possible, and your tax compliance + * team can manage your item catalog and adjust the tax behavior of items without having to modify your software. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this item. + * + * @param int $companyId The ID of the company that owns this item. * @param SyncItemsRequestModel $model The request object. * @return SyncItemsResponseModel */ @@ -6362,32 +6362,32 @@ public function syncItems($companyId, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Update a single item * - * Replace the existing `Item` object at this URL with an updated object. - * - * Items are a way of separating your tax calculation process from your tax configuration details. If you choose, you - * can provide `itemCode` values for each `CreateTransaction()` API call rather than specifying tax codes, parameters, descriptions, - * and other data fields. AvaTax will automatically look up each `itemCode` and apply the correct tax codes and parameters - * from the item table instead. This allows your CreateTransaction call to be as simple as possible, and your tax compliance - * team can manage your item catalog and adjust the tax behavior of items without having to modify your software. - * - * All data from the existing object will be replaced with data in the object you PUT. To set a field's value to null, - * you may either set its value to null or omit that field from the object you post. - * - * The tax code takes precedence over the tax code id if both are provided. - * - * ### Security Policies - * + * Replace the existing `Item` object at this URL with an updated object. + * + * Items are a way of separating your tax calculation process from your tax configuration details. If you choose, you + * can provide `itemCode` values for each `CreateTransaction()` API call rather than specifying tax codes, parameters, descriptions, + * and other data fields. AvaTax will automatically look up each `itemCode` and apply the correct tax codes and parameters + * from the item table instead. This allows your CreateTransaction call to be as simple as possible, and your tax compliance + * team can manage your item catalog and adjust the tax behavior of items without having to modify your software. + * + * All data from the existing object will be replaced with data in the object you PUT. To set a field's value to null, + * you may either set its value to null or omit that field from the object you post. + * + * The tax code takes precedence over the tax code id if both are provided. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that this item belongs to. - * @param int $id The ID of the item you wish to update + * + * @param int $companyId The ID of the company that this item belongs to. + * @param int $id The ID of the item you wish to update * @param ItemModel $model The item object you wish to update. * @return ItemModel */ @@ -6397,28 +6397,28 @@ public function updateItem($companyId, $id, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'PUT', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'PUT', $guzzleParams,'22.8.0' ); } /** * Update an item classification. * - * Update an item classification. - * - * A classification is the code for a product in a particular tax system. Classifications enable an item to be used in multiple tax systems which may have different tax rates for a product. - * - * When an item is used in a transaction, the applicable classification will be used to determine the appropriate tax rate. - * - * An item may only have one classification per tax system. - * - * ### Security Policies - * + * Update an item classification. + * + * A classification is the code for a product in a particular tax system. Classifications enable an item to be used in multiple tax systems which may have different tax rates for a product. + * + * When an item is used in a transaction, the applicable classification will be used to determine the appropriate tax rate. + * + * An item may only have one classification per tax system. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The company id. - * @param int $itemId The item id. - * @param int $id The item classification id. + * + * @param int $companyId The company id. + * @param int $itemId The item id. + * @param int $id The item classification id. * @param ItemClassificationInputModel $model The item object you wish to update. * @return ItemClassificationOutputModel */ @@ -6428,28 +6428,28 @@ public function updateItemClassification($companyId, $itemId, $id, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'PUT', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'PUT', $guzzleParams,'22.8.0' ); } /** * Update an item parameter * - * Update an item parameter. - * - * Some items can be taxed differently depending on the properties of that item, such as the item grade or by a particular measurement of that item. In AvaTax, these tax-affecting properties are called "parameters". - * - * A parameter added to an item will be used by default in tax calculation but will not show on the transaction line referencing the item . - * - * A parameter specified on a transaction line will override an item parameter if they share the same parameter name. - * - * ### Security Policies - * + * Update an item parameter. + * + * Some items can be taxed differently depending on the properties of that item, such as the item grade or by a particular measurement of that item. In AvaTax, these tax-affecting properties are called "parameters". + * + * A parameter added to an item will be used by default in tax calculation but will not show on the transaction line referencing the item . + * + * A parameter specified on a transaction line will override an item parameter if they share the same parameter name. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The company id. - * @param int $itemId The item id - * @param int $id The item parameter id + * + * @param int $companyId The company id. + * @param int $itemId The item id + * @param int $id The item parameter id * @param ItemParameterModel $model The item object you wish to update. * @return ItemParameterModel */ @@ -6459,25 +6459,25 @@ public function updateItemParameter($companyId, $itemId, $id, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'PUT', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'PUT', $guzzleParams,'22.8.0' ); } /** * Create one or more overrides * - * Creates one or more jurisdiction override objects for this account. - * - * A Jurisdiction Override is a configuration setting that allows you to select the taxing - * jurisdiction for a specific address. If you encounter an address that is on the boundary - * between two different jurisdictions, you can choose to set up a jurisdiction override - * to switch this address to use different taxing jurisdictions. - * - * ### Security Policies - * + * Creates one or more jurisdiction override objects for this account. + * + * A Jurisdiction Override is a configuration setting that allows you to select the taxing + * jurisdiction for a specific address. If you encounter an address that is on the boundary + * between two different jurisdictions, you can choose to set up a jurisdiction override + * to switch this address to use different taxing jurisdictions. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $accountId The ID of the account that owns this override + * + * @param int $accountId The ID of the account that owns this override * @param JurisdictionOverrideModel[] $model The jurisdiction override objects to create * @return JurisdictionOverrideModel[] */ @@ -6487,20 +6487,20 @@ public function createJurisdictionOverrides($accountId, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Delete a single override * - * Marks the item object at this URL as deleted. - * - * ### Security Policies - * + * Marks the item object at this URL as deleted. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $accountId The ID of the account that owns this override + * + * @param int $accountId The ID of the account that owns this override * @param int $id The ID of the override you wish to delete * @return ErrorDetail[] */ @@ -6510,25 +6510,25 @@ public function deleteJurisdictionOverride($accountId, $id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'DELETE', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'DELETE', $guzzleParams,'22.8.0' ); } /** * Retrieve a single override * - * Get the item object identified by this URL. - * - * A Jurisdiction Override is a configuration setting that allows you to select the taxing - * jurisdiction for a specific address. If you encounter an address that is on the boundary - * between two different jurisdictions, you can choose to set up a jurisdiction override - * to switch this address to use different taxing jurisdictions. - * - * ### Security Policies - * + * Get the item object identified by this URL. + * + * A Jurisdiction Override is a configuration setting that allows you to select the taxing + * jurisdiction for a specific address. If you encounter an address that is on the boundary + * between two different jurisdictions, you can choose to set up a jurisdiction override + * to switch this address to use different taxing jurisdictions. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * - * @param int $accountId The ID of the account that owns this override + * + * @param int $accountId The ID of the account that owns this override * @param int $id The primary key of this override * @return JurisdictionOverrideModel */ @@ -6538,32 +6538,32 @@ public function getJurisdictionOverride($accountId, $id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve overrides for this account * - * List all jurisdiction override objects defined for this account. - * - * A Jurisdiction Override is a configuration setting that allows you to select the taxing - * jurisdiction for a specific address. If you encounter an address that is on the boundary - * between two different jurisdictions, you can choose to set up a jurisdiction override - * to switch this address to use different taxing jurisdictions. - * - * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . - * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. - * - * ### Security Policies - * + * List all jurisdiction override objects defined for this account. + * + * A Jurisdiction Override is a configuration setting that allows you to select the taxing + * jurisdiction for a specific address. If you encounter an address that is on the boundary + * between two different jurisdictions, you can choose to set up a jurisdiction override + * to switch this address to use different taxing jurisdictions. + * + * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . + * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * - * @param int $accountId The ID of the account that owns this override - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* country, Jurisdictions - * @param string $include A comma separated list of additional data to retrieve. - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param int $accountId The ID of the account that owns this override + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* country, Jurisdictions + * @param string $include A comma separated list of additional data to retrieve. + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -6573,31 +6573,31 @@ public function listJurisdictionOverridesByAccount($accountId, $filter=null, $in 'query' => ['$filter' => $filter, '$include' => $include, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve all overrides * - * Get multiple jurisdiction override objects across all companies. - * - * A Jurisdiction Override is a configuration setting that allows you to select the taxing - * jurisdiction for a specific address. If you encounter an address that is on the boundary - * between two different jurisdictions, you can choose to set up a jurisdiction override - * to switch this address to use different taxing jurisdictions. - * - * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . - * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. - * - * ### Security Policies - * + * Get multiple jurisdiction override objects across all companies. + * + * A Jurisdiction Override is a configuration setting that allows you to select the taxing + * jurisdiction for a specific address. If you encounter an address that is on the boundary + * between two different jurisdictions, you can choose to set up a jurisdiction override + * to switch this address to use different taxing jurisdictions. + * + * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . + * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* country, Jurisdictions - * @param string $include A comma separated list of additional data to retrieve. - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* country, Jurisdictions + * @param string $include A comma separated list of additional data to retrieve. + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -6607,21 +6607,21 @@ public function queryJurisdictionOverrides($filter=null, $include=null, $top=nul 'query' => ['$filter' => $filter, '$include' => $include, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Update a single jurisdictionoverride * - * Replace the existing jurisdictionoverride object at this URL with an updated object. - * - * ### Security Policies - * + * Replace the existing jurisdictionoverride object at this URL with an updated object. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $accountId The ID of the account that this jurisdictionoverride belongs to. - * @param int $id The ID of the jurisdictionoverride you wish to update + * + * @param int $accountId The ID of the account that this jurisdictionoverride belongs to. + * @param int $id The ID of the jurisdictionoverride you wish to update * @param JurisdictionOverrideModel $model The jurisdictionoverride object you wish to update. * @return JurisdictionOverrideModel */ @@ -6631,31 +6631,31 @@ public function updateJurisdictionOverride($accountId, $id, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'PUT', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'PUT', $guzzleParams,'22.8.0' ); } /** * Add parameters to a location. * - * Add parameters to a location. - * - * Some locations can be taxed differently depending on the properties of that location. In AvaTax, these tax-affecting properties are called "parameters". - * - * A parameter added to a location will be used by default in tax calculation but will not show on the transaction line referencing the location. - * - * A parameter specified on a transaction line will override a location parameter if they share the same parameter name. - * - * To see available parameters for this location, call `/api/v2/definitions/parameters?$filter=attributeType eq Company` - * - * Some parameters are only available for use if you have subscribed to specific AvaTax services. To see which parameters you are able to use, add the query parameter "$showSubscribed=true" to the parameter definition call above. - * - * ### Security Policies - * + * Add parameters to a location. + * + * Some locations can be taxed differently depending on the properties of that location. In AvaTax, these tax-affecting properties are called "parameters". + * + * A parameter added to a location will be used by default in tax calculation but will not show on the transaction line referencing the location. + * + * A parameter specified on a transaction line will override a location parameter if they share the same parameter name. + * + * To see available parameters for this location, call `/api/v2/definitions/parameters?$filter=attributeType eq Company` + * + * Some parameters are only available for use if you have subscribed to specific AvaTax services. To see which parameters you are able to use, add the query parameter "$showSubscribed=true" to the parameter definition call above. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPAdmin, CSPTester, FirmAdmin, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this location parameter. - * @param int $locationId The location id. + * + * @param int $companyId The ID of the company that owns this location parameter. + * @param int $locationId The location id. * @param LocationParameterModel[] $model The location parameters you wish to create. * @return LocationParameterModel[] */ @@ -6665,20 +6665,20 @@ public function createLocationParameters($companyId, $locationId, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Create a new location * - * Create one or more new location objects attached to this company. - * - * ### Security Policies - * + * Create one or more new location objects attached to this company. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPAdmin, CSPTester, FirmAdmin, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this location. + * + * @param int $companyId The ID of the company that owns this location. * @param LocationModel[] $model The location you wish to create. * @return LocationModel[] */ @@ -6688,20 +6688,20 @@ public function createLocations($companyId, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Delete a single location * - * Mark the location object at this URL as deleted. - * - * ### Security Policies - * + * Mark the location object at this URL as deleted. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPAdmin, CSPTester, FirmAdmin, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this location. + * + * @param int $companyId The ID of the company that owns this location. * @param int $id The ID of the location you wish to delete. * @return ErrorDetail[] */ @@ -6711,27 +6711,27 @@ public function deleteLocation($companyId, $id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'DELETE', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'DELETE', $guzzleParams,'22.8.0' ); } /** * Delete a single location parameter * - * Delete a single location parameter. - * - * Some locations can be taxed differently depending on the properties of that location. In AvaTax, these tax-affecting properties are called "parameters". - * - * A parameter added to a location will be used by default in tax calculation but will not show on the transaction line referencing the location. - * - * A parameter specified on a transaction line will override a location parameter if they share the same parameter name. - * - * ### Security Policies - * + * Delete a single location parameter. + * + * Some locations can be taxed differently depending on the properties of that location. In AvaTax, these tax-affecting properties are called "parameters". + * + * A parameter added to a location will be used by default in tax calculation but will not show on the transaction line referencing the location. + * + * A parameter specified on a transaction line will override a location parameter if they share the same parameter name. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPAdmin, CSPTester, FirmAdmin, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The company id - * @param int $locationId The location id + * + * @param int $companyId The company id + * @param int $locationId The location id * @param int $id The parameter id * @return ErrorDetail[] */ @@ -6741,30 +6741,30 @@ public function deleteLocationParameter($companyId, $locationId, $id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'DELETE', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'DELETE', $guzzleParams,'22.8.0' ); } /** * Retrieve a single location * - * Get the location object identified by this URL. - * An 'Location' represents a physical address where a company does business. - * Many taxing authorities require that you define a list of all locations where your company does business. - * These locations may require additional custom configuration or tax registration with these authorities. - * For more information on metadata requirements, see the '/api/v2/definitions/locationquestions' API. - * - * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: - * - * * LocationSettings - * * parameters - * - * ### Security Policies - * + * Get the location object identified by this URL. + * An 'Location' represents a physical address where a company does business. + * Many taxing authorities require that you define a list of all locations where your company does business. + * These locations may require additional custom configuration or tax registration with these authorities. + * For more information on metadata requirements, see the '/api/v2/definitions/locationquestions' API. + * + * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: + * + * * LocationSettings + * * parameters + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this location - * @param int $id The primary key of this location + * + * @param int $companyId The ID of the company that owns this location + * @param int $id The primary key of this location * @param string $include A comma separated list of additional data to retrieve. * @return LocationModel */ @@ -6774,27 +6774,27 @@ public function getLocation($companyId, $id, $include=null) { 'query' => ['$include' => $include], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve a single company location parameter * - * Retrieve a single location parameter. - * - * Some locations can be taxed differently depending on the properties of that location. In AvaTax, these tax-affecting properties are called "parameters". - * - * A parameter added to a location will be used by default in tax calculation but will not show on the transaction line referencing the location. - * - * A parameter specified on a transaction line will override a location parameter if they share the same parameter name. - * - * ### Security Policies - * + * Retrieve a single location parameter. + * + * Some locations can be taxed differently depending on the properties of that location. In AvaTax, these tax-affecting properties are called "parameters". + * + * A parameter added to a location will be used by default in tax calculation but will not show on the transaction line referencing the location. + * + * A parameter specified on a transaction line will override a location parameter if they share the same parameter name. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * - * @param int $companyId The company id - * @param int $locationId The location id + * + * @param int $companyId The company id + * @param int $locationId The location id * @param int $id The parameter id * @return LocationParameterModel */ @@ -6804,33 +6804,33 @@ public function getLocationParameter($companyId, $locationId, $id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve parameters for a location * - * List parameters for a location. - * - * Some locations can be taxed differently depending on the properties of that location. In AvaTax, these tax-affecting properties are called "parameters". - * - * A parameter added to a location will be used by default in tax calculation but will not show on the transaction line referencing the location. - * - * A parameter specified on a transaction line will override a location parameter if they share the same parameter name. - * - * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . - * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. - * - * ### Security Policies - * + * List parameters for a location. + * + * Some locations can be taxed differently depending on the properties of that location. In AvaTax, these tax-affecting properties are called "parameters". + * + * A parameter added to a location will be used by default in tax calculation but will not show on the transaction line referencing the location. + * + * A parameter specified on a transaction line will override a location parameter if they share the same parameter name. + * + * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . + * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * - * @param int $companyId The company id - * @param int $locationId The ID of the location - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* name, unit - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param int $companyId The company id + * @param int $locationId The ID of the location + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* name, unit + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -6840,35 +6840,35 @@ public function listLocationParameters($companyId, $locationId, $filter=null, $t 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve locations for this company * - * List all location objects defined for this company. - * An 'Location' represents a physical address where a company does business. - * Many taxing authorities require that you define a list of all locations where your company does business. - * These locations may require additional custom configuration or tax registration with these authorities. - * For more information on metadata requirements, see the '/api/v2/definitions/locationquestions' API. - * - * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . - * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. - * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: - * - * * LocationSettings - * * parameters - * - * ### Security Policies - * + * List all location objects defined for this company. + * An 'Location' represents a physical address where a company does business. + * Many taxing authorities require that you define a list of all locations where your company does business. + * These locations may require additional custom configuration or tax registration with these authorities. + * For more information on metadata requirements, see the '/api/v2/definitions/locationquestions' API. + * + * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . + * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. + * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: + * + * * LocationSettings + * * parameters + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns these locations - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* isMarketplaceOutsideUsa, settings, parameters - * @param string $include A comma separated list of additional data to retrieve. - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param int $companyId The ID of the company that owns these locations + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* isMarketplaceOutsideUsa, settings, parameters + * @param string $include A comma separated list of additional data to retrieve. + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -6878,35 +6878,35 @@ public function listLocationsByCompany($companyId, $filter=null, $include=null, 'query' => ['$filter' => $filter, '$include' => $include, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve all locations * - * Get multiple location objects across all companies. - * An 'Location' represents a physical address where a company does business. - * Many taxing authorities require that you define a list of all locations where your company does business. - * These locations may require additional custom configuration or tax registration with these authorities. - * For more information on metadata requirements, see the '/api/v2/definitions/locationquestions' API. - * - * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . - * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. - * - * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: - * - * * LocationSettings - * * parameters - * - * ### Security Policies - * + * Get multiple location objects across all companies. + * An 'Location' represents a physical address where a company does business. + * Many taxing authorities require that you define a list of all locations where your company does business. + * These locations may require additional custom configuration or tax registration with these authorities. + * For more information on metadata requirements, see the '/api/v2/definitions/locationquestions' API. + * + * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . + * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. + * + * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: + * + * * LocationSettings + * * parameters + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* isMarketplaceOutsideUsa, settings, parameters - * @param string $include A comma separated list of additional data to retrieve. You may specify `LocationSettings` to retrieve location settings. - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* isMarketplaceOutsideUsa, settings, parameters + * @param string $include A comma separated list of additional data to retrieve. You may specify `LocationSettings` to retrieve location settings. + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -6916,23 +6916,23 @@ public function queryLocations($filter=null, $include=null, $top=null, $skip=nul 'query' => ['$filter' => $filter, '$include' => $include, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Update a single location * - * Replace the existing location object at this URL with an updated object. - * All data from the existing object will be replaced with data in the object you PUT. - * To set a field's value to null, you may either set its value to null or omit that field from the object you post. - * - * ### Security Policies - * + * Replace the existing location object at this URL with an updated object. + * All data from the existing object will be replaced with data in the object you PUT. + * To set a field's value to null, you may either set its value to null or omit that field from the object you post. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPAdmin, CSPTester, FirmAdmin, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that this location belongs to. - * @param int $id The ID of the location you wish to update + * + * @param int $companyId The ID of the company that this location belongs to. + * @param int $id The ID of the location you wish to update * @param LocationModel $model The location you wish to update. * @return LocationModel */ @@ -6942,28 +6942,28 @@ public function updateLocation($companyId, $id, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'PUT', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'PUT', $guzzleParams,'22.8.0' ); } /** * Update a location parameter * - * Update a location parameter. - * - * Some locations can be taxed differently depending on the properties of that location. In AvaTax, these tax-affecting properties are called "parameters". - * - * A parameter added to a location will be used by default in tax calculation but will not show on the transaction line referencing the location. - * - * A parameter specified on a transaction line will override a location parameter if they share the same parameter name. - * - * ### Security Policies - * + * Update a location parameter. + * + * Some locations can be taxed differently depending on the properties of that location. In AvaTax, these tax-affecting properties are called "parameters". + * + * A parameter added to a location will be used by default in tax calculation but will not show on the transaction line referencing the location. + * + * A parameter specified on a transaction line will override a location parameter if they share the same parameter name. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPAdmin, CSPTester, FirmAdmin, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The company id. - * @param int $locationId The location id - * @param int $id The location parameter id + * + * @param int $companyId The company id. + * @param int $locationId The location id + * @param int $id The location parameter id * @param LocationParameterModel $model The location parameter object you wish to update. * @return LocationParameterModel */ @@ -6973,22 +6973,22 @@ public function updateLocationParameter($companyId, $locationId, $id, $model) 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'PUT', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'PUT', $guzzleParams,'22.8.0' ); } /** * Validate the location against local requirements * - * Returns validation information for this location. - * This API call is intended to compare this location against the currently known taxing authority rules and regulations, - * and provide information about what additional work is required to completely setup this location. - * - * ### Security Policies - * + * Returns validation information for this location. + * This API call is intended to compare this location against the currently known taxing authority rules and regulations, + * and provide information about what additional work is required to completely setup this location. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this location + * + * @param int $companyId The ID of the company that owns this location * @param int $id The primary key of this location * @return LocationValidationModel */ @@ -6998,40 +6998,40 @@ public function validateLocation($companyId, $id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Adjust a MultiDocument transaction * - * Adjusts the current MultiDocument transaction uniquely identified by this URL. - * - * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like - * sales, purchases, inventory transfer, and returns (also called refunds). - * - * When you adjust a transaction, that transaction's status is recorded as `Adjusted`. - * - * Both the revisions will be available for retrieval based on their code and ID numbers. Only transactions in Committed status can be reported on a tax filing by Avalara's Managed Returns Service. - * - * Transactions that have been previously reported to a tax authority by Avalara Managed Returns are considered locked and are no longer available for adjustments. - * - * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: - * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code - * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code - * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code - * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code - * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code - * * Replace ' ' with '%20' For example: document Code becomes document%20Code - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * Adjusts the current MultiDocument transaction uniquely identified by this URL. + * + * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like + * sales, purchases, inventory transfer, and returns (also called refunds). + * + * When you adjust a transaction, that transaction's status is recorded as `Adjusted`. + * + * Both the revisions will be available for retrieval based on their code and ID numbers. Only transactions in Committed status can be reported on a tax filing by Avalara's Managed Returns Service. + * + * Transactions that have been previously reported to a tax authority by Avalara Managed Returns are considered locked and are no longer available for adjustments. + * + * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: + * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code + * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code + * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code + * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code + * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code + * * Replace ' ' with '%20' For example: document Code becomes document%20Code + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * - * @param string $code The transaction code for this MultiDocument transaction - * @param string $type The transaction type for this MultiDocument transaction (See DocumentType::* for a list of allowable values) - * @param string $include Specifies objects to include in this fetch call + * + * @param string $code The transaction code for this MultiDocument transaction + * @param string $type The transaction type for this MultiDocument transaction (See DocumentType::* for a list of allowable values) + * @param string $include Specifies objects to include in this fetch call * @param AdjustMultiDocumentModel $model The adjust request you wish to execute * @return MultiDocumentModel */ @@ -7041,42 +7041,42 @@ public function adjustMultiDocumentTransaction($code, $type, $include=null, $mod 'query' => ['include' => $include], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Get audit information about a MultiDocument transaction * - * Retrieve audit information about a MultiDocument transaction stored in AvaTax. - * - * The audit API retrieves audit information related to a specific MultiDocument transaction. This audit - * information includes the following: - * - * * The `code` of the MultiDocument transaction - * * The `type` of the MultiDocument transaction - * * The server timestamp representing the exact server time when the transaction was created - * * The server duration - how long it took to process this transaction - * * Whether exact API call details were logged - * * A reconstructed API call showing what the original create call looked like - * - * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like - * sales, purchases, inventory transfer, and returns (also called refunds). - * - * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: - * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code - * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code - * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code - * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code - * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code - * * Replace ' ' with '%20' For example: document Code becomes document%20Code - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * Retrieve audit information about a MultiDocument transaction stored in AvaTax. + * + * The audit API retrieves audit information related to a specific MultiDocument transaction. This audit + * information includes the following: + * + * * The `code` of the MultiDocument transaction + * * The `type` of the MultiDocument transaction + * * The server timestamp representing the exact server time when the transaction was created + * * The server duration - how long it took to process this transaction + * * Whether exact API call details were logged + * * A reconstructed API call showing what the original create call looked like + * + * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like + * sales, purchases, inventory transfer, and returns (also called refunds). + * + * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: + * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code + * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code + * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code + * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code + * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code + * * Replace ' ' with '%20' For example: document Code becomes document%20Code + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * - * @param string $code The transaction code for this MultiDocument transaction + * + * @param string $code The transaction code for this MultiDocument transaction * @param string $type The transaction type for this MultiDocument transaction (See DocumentType::* for a list of allowable values) * @return AuditMultiDocumentModel */ @@ -7086,35 +7086,35 @@ public function auditMultiDocumentTransaction($code, $type) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Commit a MultiDocument transaction * - * Marks a list of transactions by changing its status to `Committed`. - * - * Transactions that are committed are available to be reported to a tax authority by Avalara Managed Returns. - * - * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like - * sales, purchases, inventory transfer, and returns (also called refunds). - * - * Any changes made to a committed transaction will generate a transaction history. - * - * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: - * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code - * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code - * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code - * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code - * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code - * * Replace ' ' with '%20' For example: document Code becomes document%20Code - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, ProStoresOperator, SSTAdmin, TechnicalSupportAdmin. + * Marks a list of transactions by changing its status to `Committed`. + * + * Transactions that are committed are available to be reported to a tax authority by Avalara Managed Returns. + * + * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like + * sales, purchases, inventory transfer, and returns (also called refunds). + * + * Any changes made to a committed transaction will generate a transaction history. + * + * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: + * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code + * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code + * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code + * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code + * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code + * * Replace ' ' with '%20' For example: document Code becomes document%20Code + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, ProStoresOperator, SSTAdmin, TechnicalSupportAdmin. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * + * * @param CommitMultiDocumentModel $model The commit request you wish to execute * @return MultiDocumentModel */ @@ -7124,60 +7124,60 @@ public function commitMultiDocumentTransaction($model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Create a new MultiDocument transaction * - * Records a new MultiDocument transaction in AvaTax. - * - * A traditional transaction requires exactly two parties: a seller and a buyer. MultiDocument transactions can - * involve a marketplace of vendors, each of which contributes some portion of the final transaction. Within - * a MultiDocument transaction, each individual buyer and seller pair are matched up and converted to a separate - * document. This separation of documents allows each seller to file their taxes separately. - * - * This API will report an error if you attempt to create a transaction when one already exists with the specified `code`. - * If you would like the API to automatically update the transaction when it already exists, please set the `allowAdjust` - * value to `true`. - * - * To generate a refund for a transaction, use the `RefundTransaction` API. - * - * The field `type` identifies the kind of transaction - for example, a sale, purchase, or refund. If you do not specify - * a `type` value, you will receive an estimate of type `SalesOrder`, which will not be recorded. - * - * The origin and destination locations for a transaction must be identified by either address or geocode. For address-based transactions, please - * provide addresses in the fields `line`, `city`, `region`, `country` and `postalCode`. For geocode-based transactions, please provide the geocode - * information in the fields `latitude` and `longitude`. If either `latitude` or `longitude` or both are null, the transaction will be calculated - * using the best available address location information. - * - * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: - * - * * Lines - * * Details (implies lines) - * * Summary (implies details) - * * Addresses - * * SummaryOnly (omit lines and details - reduces API response size) - * * LinesOnly (omit details - reduces API response size) - * * ForceTimeout - Simulates a timeout. This adds a 30 second delay and error to your API call. This can be used to test your code to ensure it can respond correctly in the case of a dropped connection. - * - * If you omit the `$include` parameter, the API will assume you want `Summary,Addresses`. - * - * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: - * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code - * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code - * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code - * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code - * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code - * * Replace ' ' with '%20' For example: document Code becomes document%20Code - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * Records a new MultiDocument transaction in AvaTax. + * + * A traditional transaction requires exactly two parties: a seller and a buyer. MultiDocument transactions can + * involve a marketplace of vendors, each of which contributes some portion of the final transaction. Within + * a MultiDocument transaction, each individual buyer and seller pair are matched up and converted to a separate + * document. This separation of documents allows each seller to file their taxes separately. + * + * This API will report an error if you attempt to create a transaction when one already exists with the specified `code`. + * If you would like the API to automatically update the transaction when it already exists, please set the `allowAdjust` + * value to `true`. + * + * To generate a refund for a transaction, use the `RefundTransaction` API. + * + * The field `type` identifies the kind of transaction - for example, a sale, purchase, or refund. If you do not specify + * a `type` value, you will receive an estimate of type `SalesOrder`, which will not be recorded. + * + * The origin and destination locations for a transaction must be identified by either address or geocode. For address-based transactions, please + * provide addresses in the fields `line`, `city`, `region`, `country` and `postalCode`. For geocode-based transactions, please provide the geocode + * information in the fields `latitude` and `longitude`. If either `latitude` or `longitude` or both are null, the transaction will be calculated + * using the best available address location information. + * + * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: + * + * * Lines + * * Details (implies lines) + * * Summary (implies details) + * * Addresses + * * SummaryOnly (omit lines and details - reduces API response size) + * * LinesOnly (omit details - reduces API response size) + * * ForceTimeout - Simulates a timeout. This adds a 30 second delay and error to your API call. This can be used to test your code to ensure it can respond correctly in the case of a dropped connection. + * + * If you omit the `$include` parameter, the API will assume you want `Summary,Addresses`. + * + * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: + * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code + * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code + * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code + * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code + * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code + * * Replace ' ' with '%20' For example: document Code becomes document%20Code + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * - * @param string $include Specifies objects to include in the response after transaction is created + * + * @param string $include Specifies objects to include in the response after transaction is created * @param CreateMultiDocumentModel $model the multi document transaction model * @return MultiDocumentModel */ @@ -7187,41 +7187,41 @@ public function createMultiDocumentTransaction($include=null, $model=null) { 'query' => ['$include' => $include], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Retrieve a MultiDocument transaction * - * Get the current MultiDocument transaction identified by this URL. - * - * If this transaction was adjusted, the return value of this API will be the current transaction with this code. - * - * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: - * - * * Lines - * * Details (implies lines) - * * Summary (implies details) - * * Addresses - * * SummaryOnly (omit lines and details - reduces API response size) - * * LinesOnly (omit details - reduces API response size) - * - * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: - * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code - * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code - * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code - * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code - * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code - * * Replace ' ' with '%20' For example: document Code becomes document%20Code - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * Get the current MultiDocument transaction identified by this URL. + * + * If this transaction was adjusted, the return value of this API will be the current transaction with this code. + * + * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: + * + * * Lines + * * Details (implies lines) + * * Summary (implies details) + * * Addresses + * * SummaryOnly (omit lines and details - reduces API response size) + * * LinesOnly (omit details - reduces API response size) + * + * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: + * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code + * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code + * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code + * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code + * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code + * * Replace ' ' with '%20' For example: document Code becomes document%20Code + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * - * @param string $code The multidocument code to retrieve - * @param string $type The transaction type to retrieve (See DocumentType::* for a list of allowable values) + * + * @param string $code The multidocument code to retrieve + * @param string $type The transaction type to retrieve (See DocumentType::* for a list of allowable values) * @param string $include Specifies objects to include in the response after transaction is created * @return MultiDocumentModel */ @@ -7231,49 +7231,49 @@ public function getMultiDocumentTransactionByCodeAndType($code, $type, $include= 'query' => ['$include' => $include], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve a MultiDocument transaction by ID * - * Get the unique MultiDocument transaction identified by this URL. - * - * A traditional transaction requires exactly two parties: a seller and a buyer. MultiDocument transactions can - * involve a marketplace of vendors, each of which contributes some portion of the final transaction. Within - * a MultiDocument transaction, each individual buyer and seller pair are matched up and converted to a separate - * document. This separation of documents allows each seller to file their taxes separately. - * - * This endpoint retrieves the exact transaction identified by this ID number even if that transaction was later adjusted - * by using the `AdjustTransaction` endpoint. - * - * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like - * sales, purchases, inventory transfer, and returns (also called refunds). - * - * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: - * - * * Lines - * * Details (implies lines) - * * Summary (implies details) - * * Addresses - * * SummaryOnly (omit lines and details - reduces API response size) - * * LinesOnly (omit details - reduces API response size) - * - * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: - * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code - * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code - * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code - * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code - * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code - * * Replace ' ' with '%20' For example: document Code becomes document%20Code - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * Get the unique MultiDocument transaction identified by this URL. + * + * A traditional transaction requires exactly two parties: a seller and a buyer. MultiDocument transactions can + * involve a marketplace of vendors, each of which contributes some portion of the final transaction. Within + * a MultiDocument transaction, each individual buyer and seller pair are matched up and converted to a separate + * document. This separation of documents allows each seller to file their taxes separately. + * + * This endpoint retrieves the exact transaction identified by this ID number even if that transaction was later adjusted + * by using the `AdjustTransaction` endpoint. + * + * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like + * sales, purchases, inventory transfer, and returns (also called refunds). + * + * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: + * + * * Lines + * * Details (implies lines) + * * Summary (implies details) + * * Addresses + * * SummaryOnly (omit lines and details - reduces API response size) + * * LinesOnly (omit details - reduces API response size) + * + * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: + * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code + * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code + * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code + * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code + * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code + * * Replace ' ' with '%20' For example: document Code becomes document%20Code + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * - * @param int $id The unique ID number of the MultiDocument transaction to retrieve + * + * @param int $id The unique ID number of the MultiDocument transaction to retrieve * @param string $include Specifies objects to include in the response after transaction is created * @return MultiDocumentModel */ @@ -7283,50 +7283,50 @@ public function getMultiDocumentTransactionById($id, $include=null) { 'query' => ['$include' => $include], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve all MultiDocument transactions * - * List all MultiDocument transactions within this account. - * - * This endpoint is limited to returning 1,000 MultiDocument transactions at a time. To retrieve more than 1,000 MultiDocument - * transactions, please use the pagination features of the API. - * - * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like - * sales, purchases, inventory transfer, and returns (also called refunds). - * - * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . - * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. - * - * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: - * - * * Lines - * * Details (implies lines) - * * Summary (implies details) - * * Addresses - * * SummaryOnly (omit lines and details - reduces API response size) - * * LinesOnly (omit details - reduces API response size) - * - * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: - * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code - * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code - * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code - * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code - * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code - * * Replace ' ' with '%20' For example: document Code becomes document%20Code - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * List all MultiDocument transactions within this account. + * + * This endpoint is limited to returning 1,000 MultiDocument transactions at a time. To retrieve more than 1,000 MultiDocument + * transactions, please use the pagination features of the API. + * + * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like + * sales, purchases, inventory transfer, and returns (also called refunds). + * + * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . + * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. + * + * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: + * + * * Lines + * * Details (implies lines) + * * Summary (implies details) + * * Addresses + * * SummaryOnly (omit lines and details - reduces API response size) + * * LinesOnly (omit details - reduces API response size) + * + * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: + * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code + * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code + * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code + * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code + * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code + * * Replace ' ' with '%20' For example: document Code becomes document%20Code + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* documents - * @param string $include Specifies objects to include in the response after transaction is created - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* documents + * @param string $include Specifies objects to include in the response after transaction is created + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -7336,66 +7336,66 @@ public function listMultiDocumentTransactions($filter=null, $include=null, $top= 'query' => ['$filter' => $filter, '$include' => $include, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Create a refund for a MultiDocument transaction * - * Create a refund for a MultiDocument transaction. - * - * A traditional transaction requires exactly two parties: a seller and a buyer. MultiDocument transactions can - * involve a marketplace of vendors, each of which contributes some portion of the final transaction. Within - * a MultiDocument transaction, each individual buyer and seller pair are matched up and converted to a separate - * document. This separation of documents allows each seller to file their taxes separately. - * - * The `RefundTransaction` API allows you to quickly and easily create a `ReturnInvoice` representing a refund - * for a previously created `SalesInvoice` transaction. You can choose to create a full or partial refund, and - * specify individual line items from the original sale for refund. - * - * The `RefundTransaction` API ensures that the tax amount you refund to the customer exactly matches the tax that - * was calculated during the original transaction, regardless of any changes to your company's configuration, rules, - * nexus, or any other setting. - * - * This API is intended to be a shortcut to allow you to quickly and accurately generate a refund for the following - * common refund scenarios: - * - * * A full refund of a previous sale - * * Refunding the tax that was charged on a previous sale, when the customer provides an exemption certificate after the purchase - * * Refunding one or more items (lines) from a previous sale - * * Granting a customer a percentage refund of a previous sale - * - * For more complex scenarios than the ones above, please use `CreateTransaction` with document type `ReturnInvoice` to - * create a custom refund transaction. - * - * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: - * - * * Lines - * * Details (implies lines) - * * Summary (implies details) - * * Addresses - * * SummaryOnly (omit lines and details - reduces API response size) - * * LinesOnly (omit details - reduces API response size) - * - * If you omit the `$include` parameter, the API will assume you want `Summary,Addresses`. - * - * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: - * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code - * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code - * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code - * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code - * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code - * * Replace ' ' with '%20' For example: document Code becomes document%20Code - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * Create a refund for a MultiDocument transaction. + * + * A traditional transaction requires exactly two parties: a seller and a buyer. MultiDocument transactions can + * involve a marketplace of vendors, each of which contributes some portion of the final transaction. Within + * a MultiDocument transaction, each individual buyer and seller pair are matched up and converted to a separate + * document. This separation of documents allows each seller to file their taxes separately. + * + * The `RefundTransaction` API allows you to quickly and easily create a `ReturnInvoice` representing a refund + * for a previously created `SalesInvoice` transaction. You can choose to create a full or partial refund, and + * specify individual line items from the original sale for refund. + * + * The `RefundTransaction` API ensures that the tax amount you refund to the customer exactly matches the tax that + * was calculated during the original transaction, regardless of any changes to your company's configuration, rules, + * nexus, or any other setting. + * + * This API is intended to be a shortcut to allow you to quickly and accurately generate a refund for the following + * common refund scenarios: + * + * * A full refund of a previous sale + * * Refunding the tax that was charged on a previous sale, when the customer provides an exemption certificate after the purchase + * * Refunding one or more items (lines) from a previous sale + * * Granting a customer a percentage refund of a previous sale + * + * For more complex scenarios than the ones above, please use `CreateTransaction` with document type `ReturnInvoice` to + * create a custom refund transaction. + * + * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: + * + * * Lines + * * Details (implies lines) + * * Summary (implies details) + * * Addresses + * * SummaryOnly (omit lines and details - reduces API response size) + * * LinesOnly (omit details - reduces API response size) + * + * If you omit the `$include` parameter, the API will assume you want `Summary,Addresses`. + * + * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: + * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code + * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code + * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code + * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code + * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code + * * Replace ' ' with '%20' For example: document Code becomes document%20Code + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * - * @param string $code The code of this MultiDocument transaction - * @param string $type The type of this MultiDocument transaction (See DocumentType::* for a list of allowable values) - * @param string $include Specifies objects to include in the response after transaction is created + * + * @param string $code The code of this MultiDocument transaction + * @param string $type The type of this MultiDocument transaction (See DocumentType::* for a list of allowable values) + * @param string $include Specifies objects to include in the response after transaction is created * @param RefundTransactionModel $model Information about the refund to create * @return MultiDocumentModel */ @@ -7405,33 +7405,33 @@ public function refundMultiDocumentTransaction($code, $type, $include=null, $mod 'query' => ['$include' => $include], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Verify a MultiDocument transaction * - * Verifies that the MultiDocument transaction uniquely identified by this URL matches certain expected values. - * - * If the transaction does not match these expected values, this API will return an error code indicating which value did not match. - * - * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like - * sales, purchases, inventory transfer, and returns (also called refunds). - * - * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: - * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code - * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code - * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code - * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code - * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code - * * Replace ' ' with '%20' For example: document Code becomes document%20Code - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * Verifies that the MultiDocument transaction uniquely identified by this URL matches certain expected values. + * + * If the transaction does not match these expected values, this API will return an error code indicating which value did not match. + * + * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like + * sales, purchases, inventory transfer, and returns (also called refunds). + * + * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: + * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code + * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code + * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code + * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code + * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code + * * Replace ' ' with '%20' For example: document Code becomes document%20Code + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * + * * @param VerifyMultiDocumentModel $model Information from your accounting system to verify against this MultiDocument transaction as it is stored in AvaTax * @return MultiDocumentModel */ @@ -7441,38 +7441,38 @@ public function verifyMultiDocumentTransaction($model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Void a MultiDocument transaction * - * Voids the current transaction uniquely identified by this URL. - * - * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like - * sales, purchases, inventory transfer, and returns (also called refunds). - * - * When you void a transaction, that transaction's status is recorded as `DocVoided`. - * - * Transactions that have been previously reported to a tax authority by Avalara Managed Returns Service are considered `locked`, - * and they are no longer available to be voided. - * - * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: - * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code - * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code - * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code - * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code - * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code - * * Replace ' ' with '%20' For example: document Code becomes document%20Code - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, BatchServiceAdmin, CompanyAdmin, CSPTester, ProStoresOperator, SSTAdmin, TechnicalSupportAdmin. + * Voids the current transaction uniquely identified by this URL. + * + * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like + * sales, purchases, inventory transfer, and returns (also called refunds). + * + * When you void a transaction, that transaction's status is recorded as `DocVoided`. + * + * Transactions that have been previously reported to a tax authority by Avalara Managed Returns Service are considered `locked`, + * and they are no longer available to be voided. + * + * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: + * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code + * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code + * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code + * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code + * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code + * * Replace ' ' with '%20' For example: document Code becomes document%20Code + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, BatchServiceAdmin, CompanyAdmin, CSPTester, ProStoresOperator, SSTAdmin, TechnicalSupportAdmin. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * - * @param string $code The transaction code for this MultiDocument transaction - * @param string $type The transaction type for this MultiDocument transaction (See DocumentType::* for a list of allowable values) + * + * @param string $code The transaction code for this MultiDocument transaction + * @param string $type The transaction type for this MultiDocument transaction (See DocumentType::* for a list of allowable values) * @param VoidTransactionModel $model The void request you wish to execute * @return MultiDocumentModel */ @@ -7482,38 +7482,38 @@ public function voidMultiDocumentTransaction($code, $type, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Create a new nexus * - * Creates one or more new nexus declarations attached to this company. - * - * The concept of Nexus indicates a place where your company is legally obligated to collect and remit transactional - * taxes. The legal requirements for nexus may vary per country and per jurisdiction; please seek advice from your - * accountant or lawyer prior to declaring nexus. - * - * To create a nexus declaration for your company, you must first call the Definitions API `ListNexus` to obtain a - * list of Avalara-defined nexus. Once you have determined which nexus you wish to declare, you should customize - * only the user-selectable fields in this object. - * - * The user selectable fields for the nexus object are `companyId`, `effectiveDate`, `endDate`, `localNexusTypeId`, - * `taxId`, `nexusTypeId`, `hasPermanentEstablishment`, and `isSellerImporterOfRecord`. - * - * When calling `CreateNexus` or `UpdateNexus`, all values in your nexus object except for the user-selectable fields - * must match an Avalara-defined system nexus object. You can retrieve a list of Avalara-defined system nexus objects - * by calling `ListNexus`. If any data does not match, AvaTax may not recognize your nexus declaration. - * - * Please note that nexus changes may not take effect immediately and you should plan to update your nexus settings in advance - * of calculating tax for a location. - * - * ### Security Policies - * + * Creates one or more new nexus declarations attached to this company. + * + * The concept of Nexus indicates a place where your company is legally obligated to collect and remit transactional + * taxes. The legal requirements for nexus may vary per country and per jurisdiction; please seek advice from your + * accountant or lawyer prior to declaring nexus. + * + * To create a nexus declaration for your company, you must first call the Definitions API `ListNexus` to obtain a + * list of Avalara-defined nexus. Once you have determined which nexus you wish to declare, you should customize + * only the user-selectable fields in this object. + * + * The user selectable fields for the nexus object are `companyId`, `effectiveDate`, `endDate`, `localNexusTypeId`, + * `taxId`, `nexusTypeId`, `hasPermanentEstablishment`, and `isSellerImporterOfRecord`. + * + * When calling `CreateNexus` or `UpdateNexus`, all values in your nexus object except for the user-selectable fields + * must match an Avalara-defined system nexus object. You can retrieve a list of Avalara-defined system nexus objects + * by calling `ListNexus`. If any data does not match, AvaTax may not recognize your nexus declaration. + * + * Please note that nexus changes may not take effect immediately and you should plan to update your nexus settings in advance + * of calculating tax for a location. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this nexus. + * + * @param int $companyId The ID of the company that owns this nexus. * @param NexusModel[] $model The nexus you wish to create. * @return NexusModel[] */ @@ -7523,30 +7523,30 @@ public function createNexus($companyId, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Add parameters to a nexus. * - * Add parameters to the nexus. - * Some tax calculation and reporting are different depending on the properties of the nexus, such as isRemoteSeller. In AvaTax, these tax-affecting properties are called "parameters". - * - * A parameter added to an nexus will be used by default in tax calculation but will not show on the transaction line referencing the nexus. - * - * A parameter specified on a transaction line will override an nexus parameter if they share the same parameter name. - * - * To see available parameters for this item, call `/api/v2/definitions/parameters?$filter=attributeType eq Nexus` - * - * Some parameters are only available for use if you have subscribed to specific AvaTax services. To see which parameters you are able to use, add the query parameter "$showSubscribed=true" to the parameter definition call above. - * - * ### Security Policies - * + * Add parameters to the nexus. + * Some tax calculation and reporting are different depending on the properties of the nexus, such as isRemoteSeller. In AvaTax, these tax-affecting properties are called "parameters". + * + * A parameter added to an nexus will be used by default in tax calculation but will not show on the transaction line referencing the nexus. + * + * A parameter specified on a transaction line will override an nexus parameter if they share the same parameter name. + * + * To see available parameters for this item, call `/api/v2/definitions/parameters?$filter=attributeType eq Nexus` + * + * Some parameters are only available for use if you have subscribed to specific AvaTax services. To see which parameters you are able to use, add the query parameter "$showSubscribed=true" to the parameter definition call above. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this nexus parameter. - * @param int $nexusId The nexus id. + * + * @param int $companyId The ID of the company that owns this nexus parameter. + * @param int $nexusId The nexus id. * @param NexusParameterDetailModel[] $model The nexus parameters you wish to create. * @return NexusParameterDetailModel[] */ @@ -7556,34 +7556,34 @@ public function createNexusParameters($companyId, $nexusId, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Creates nexus for a list of addresses. * - * This call is intended to simplify adding all applicable nexus to a company, for an address or addresses. Calling this - * API declares nexus for this company, for the list of addresses provided, - * for the date range provided. You may also use this API to extend effective date on an already-declared nexus. - * - * The concept of Nexus indicates a place where your company is legally obligated to collect and remit transactional - * taxes. The legal requirements for nexus may vary per country and per jurisdiction; please seek advice from your - * accountant or lawyer prior to declaring nexus. - * - * Note that not all fields within a nexus can be updated; Avalara publishes a list of all defined nexus at the - * '/api/v2/definitions/nexus' endpoint. - * - * You may only define nexus matching the official list of declared nexus. - * - * Please note that nexus changes may not take effect immediately and you should plan to update your nexus settings in advance - * of calculating tax for a location. - * - * ### Security Policies - * + * This call is intended to simplify adding all applicable nexus to a company, for an address or addresses. Calling this + * API declares nexus for this company, for the list of addresses provided, + * for the date range provided. You may also use this API to extend effective date on an already-declared nexus. + * + * The concept of Nexus indicates a place where your company is legally obligated to collect and remit transactional + * taxes. The legal requirements for nexus may vary per country and per jurisdiction; please seek advice from your + * accountant or lawyer prior to declaring nexus. + * + * Note that not all fields within a nexus can be updated; Avalara publishes a list of all defined nexus at the + * '/api/v2/definitions/nexus' endpoint. + * + * You may only define nexus matching the official list of declared nexus. + * + * Please note that nexus changes may not take effect immediately and you should plan to update your nexus settings in advance + * of calculating tax for a location. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that will own this nexus. + * + * @param int $companyId The ID of the company that will own this nexus. * @param DeclareNexusByAddressModel[] $model The nexus you wish to create. * @return NexusByAddressModel[] */ @@ -7593,28 +7593,28 @@ public function declareNexusByAddress($companyId, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Delete a single nexus * - * Marks the existing nexus object at this URL as deleted. - * - * The concept of Nexus indicates a place where your company is legally obligated to collect and remit transactional - * taxes. The legal requirements for nexus may vary per country and per jurisdiction; please seek advice from your - * accountant or lawyer prior to declaring nexus. - * - * Please note that nexus changes may not take effect immediately and you should plan to update your nexus settings in advance - * of calculating tax for a location. - * - * ### Security Policies - * + * Marks the existing nexus object at this URL as deleted. + * + * The concept of Nexus indicates a place where your company is legally obligated to collect and remit transactional + * taxes. The legal requirements for nexus may vary per country and per jurisdiction; please seek advice from your + * accountant or lawyer prior to declaring nexus. + * + * Please note that nexus changes may not take effect immediately and you should plan to update your nexus settings in advance + * of calculating tax for a location. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this nexus. - * @param int $id The ID of the nexus you wish to delete. + * + * @param int $companyId The ID of the company that owns this nexus. + * @param int $id The ID of the nexus you wish to delete. * @param boolean $cascadeDelete If true, deletes all the child nexus if they exist along with parent nexus * @return ErrorDetail[] */ @@ -7624,26 +7624,26 @@ public function deleteNexus($companyId, $id, $cascadeDelete) { 'query' => ['cascadeDelete' => $cascadeDelete], 'body' => null ]; - return $this->restCall($path, 'DELETE', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'DELETE', $guzzleParams,'22.8.0' ); } /** * Delete a single nexus parameter * - * Delete a single nexus parameter. - * Some tax calculation and reporting are different depending on the properties of the nexus, such as isRemoteSeller. In AvaTax, these tax-affecting properties are called "parameters". - * - * A parameter added to an nexus will be used by default in tax calculation but will not show on the transaction line referencing the nexus. - * - * A parameter specified on a transaction line will override an nexus parameter if they share the same parameter name. - * - * ### Security Policies - * + * Delete a single nexus parameter. + * Some tax calculation and reporting are different depending on the properties of the nexus, such as isRemoteSeller. In AvaTax, these tax-affecting properties are called "parameters". + * + * A parameter added to an nexus will be used by default in tax calculation but will not show on the transaction line referencing the nexus. + * + * A parameter specified on a transaction line will override an nexus parameter if they share the same parameter name. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The company id - * @param int $nexusId The nexus id + * + * @param int $companyId The company id + * @param int $nexusId The nexus id * @param int $id The parameter id * @return ErrorDetail[] */ @@ -7653,25 +7653,25 @@ public function deleteNexusParameter($companyId, $nexusId, $id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'DELETE', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'DELETE', $guzzleParams,'22.8.0' ); } /** * Delete all parameters for an nexus * - * Delete all the parameters for a given nexus. - * Some tax calculation and reporting are different depending on the properties of the nexus, such as isRemoteSeller. In AvaTax, these tax-affecting properties are called "parameters". - * - * A parameter added to an nexus will be used by default in tax calculation but will not show on the transaction line referencing the nexus. - * - * A parameter specified on a transaction line will override an nexus parameter if they share the same parameter name. - * - * ### Security Policies - * + * Delete all the parameters for a given nexus. + * Some tax calculation and reporting are different depending on the properties of the nexus, such as isRemoteSeller. In AvaTax, these tax-affecting properties are called "parameters". + * + * A parameter added to an nexus will be used by default in tax calculation but will not show on the transaction line referencing the nexus. + * + * A parameter specified on a transaction line will override an nexus parameter if they share the same parameter name. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this nexus. + * + * @param int $companyId The ID of the company that owns this nexus. * @param int $nexusId The ID of the nexus you wish to delete the parameters. * @return ErrorDetail[] */ @@ -7681,28 +7681,28 @@ public function deleteNexusParameters($companyId, $nexusId) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'DELETE', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'DELETE', $guzzleParams,'22.8.0' ); } /** * Retrieve a single nexus * - * Get the nexus object identified by this URL. - * - * The concept of Nexus indicates a place where your company is legally obligated to collect and remit transactional - * taxes. The legal requirements for nexus may vary per country and per jurisdiction; please seek advice from your - * accountant or lawyer prior to declaring nexus. - * You may specify one or more of the following values in the '$include' parameter to fetch additional nested data, using commas to separate multiple values: - * - * * Parameters - * - * ### Security Policies - * + * Get the nexus object identified by this URL. + * + * The concept of Nexus indicates a place where your company is legally obligated to collect and remit transactional + * taxes. The legal requirements for nexus may vary per country and per jurisdiction; please seek advice from your + * accountant or lawyer prior to declaring nexus. + * You may specify one or more of the following values in the '$include' parameter to fetch additional nested data, using commas to separate multiple values: + * + * * Parameters + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this nexus object - * @param int $id The primary key of this nexus + * + * @param int $companyId The ID of the company that owns this nexus object + * @param int $id The primary key of this nexus * @param string $include * @return NexusModel */ @@ -7712,32 +7712,32 @@ public function getNexus($companyId, $id, $include=null) { 'query' => ['$include' => $include], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * List company nexus related to a tax form * - * Retrieves a list of nexus related to a tax form. - * - * The concept of Nexus indicates a place where your company is legally obligated to collect and remit transactional - * taxes. The legal requirements for nexus may vary per country and per jurisdiction; please seek advice from your - * accountant or lawyer prior to declaring nexus. - * - * This API is intended to provide useful information when examining a tax form. If you are about to begin filing - * a tax form, you may want to know whether you have declared nexus in all the jurisdictions related to that tax - * form in order to better understand how the form will be filled out. - * You may specify one or more of the following values in the '$include' parameter to fetch additional nested data, using commas to separate multiple values: - * - * * Parameters - * - * ### Security Policies - * + * Retrieves a list of nexus related to a tax form. + * + * The concept of Nexus indicates a place where your company is legally obligated to collect and remit transactional + * taxes. The legal requirements for nexus may vary per country and per jurisdiction; please seek advice from your + * accountant or lawyer prior to declaring nexus. + * + * This API is intended to provide useful information when examining a tax form. If you are about to begin filing + * a tax form, you may want to know whether you have declared nexus in all the jurisdictions related to that tax + * form in order to better understand how the form will be filled out. + * You may specify one or more of the following values in the '$include' parameter to fetch additional nested data, using commas to separate multiple values: + * + * * Parameters + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this nexus object - * @param string $formCode The form code that we are looking up the nexus for + * + * @param int $companyId The ID of the company that owns this nexus object + * @param string $formCode The form code that we are looking up the nexus for * @param string $include * @return NexusByTaxFormModel */ @@ -7747,26 +7747,26 @@ public function getNexusByFormCode($companyId, $formCode, $include=null) { 'query' => ['$include' => $include], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve a single nexus parameter * - * Retrieve a single nexus parameter. - * Some tax calculation and reporting are different depending on the properties of the nexus, such as isRemoteSeller.In AvaTax, these tax-affecting properties are called "parameters". - * - * A parameter added to an nexus will be used by default in tax calculation but will not show on the transaction line referencing the nexus. - * - * A parameter specified on a transaction line will override an nexus parameter if they share the same parameter name. - * - * ### Security Policies - * + * Retrieve a single nexus parameter. + * Some tax calculation and reporting are different depending on the properties of the nexus, such as isRemoteSeller.In AvaTax, these tax-affecting properties are called "parameters". + * + * A parameter added to an nexus will be used by default in tax calculation but will not show on the transaction line referencing the nexus. + * + * A parameter specified on a transaction line will override an nexus parameter if they share the same parameter name. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * - * @param int $companyId The company id - * @param int $nexusId The nexus id + * + * @param int $companyId The company id + * @param int $nexusId The nexus id * @param int $id The parameter id * @return NexusParameterDetailModel */ @@ -7776,34 +7776,34 @@ public function getNexusParameter($companyId, $nexusId, $id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve nexus for this company * - * List all nexus objects defined for this company. - * - * The concept of Nexus indicates a place where your company is legally obligated to collect and remit transactional - * taxes. The legal requirements for nexus may vary per country and per jurisdiction; please seek advice from your - * accountant or lawyer prior to declaring nexus. - * - * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . - * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. - * You may specify one or more of the following values in the '$include' parameter to fetch additional nested data, using commas to separate multiple values: - * - * * Parameters - * - * ### Security Policies - * + * List all nexus objects defined for this company. + * + * The concept of Nexus indicates a place where your company is legally obligated to collect and remit transactional + * taxes. The legal requirements for nexus may vary per country and per jurisdiction; please seek advice from your + * accountant or lawyer prior to declaring nexus. + * + * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . + * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. + * You may specify one or more of the following values in the '$include' parameter to fetch additional nested data, using commas to separate multiple values: + * + * * Parameters + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns these nexus objects - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* streamlinedSalesTax, isSSTActive, taxTypeGroup, taxAuthorityId, taxName, parameters, taxableNexus - * @param string $include A comma separated list of additional data to retrieve. - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param int $companyId The ID of the company that owns these nexus objects + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* streamlinedSalesTax, isSSTActive, taxTypeGroup, taxAuthorityId, taxName, parameters, taxableNexus + * @param string $include A comma separated list of additional data to retrieve. + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -7813,35 +7813,35 @@ public function listNexusByCompany($companyId, $filter=null, $include=null, $top 'query' => ['$filter' => $filter, '$include' => $include, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve nexus for this company By TaxTypeGroup * - * List all nexus objects defined for this company filtered by TaxTypeGroup. - * - * The concept of Nexus indicates a place where your company is legally obligated to collect and remit transactional - * taxes. The legal requirements for nexus may vary per country and per jurisdiction; please seek advice from your - * accountant or lawyer prior to declaring nexus. - * - * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . - * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. - * You may specify one or more of the following values in the '$include' parameter to fetch additional nested data, using commas to separate multiple values: - * - * * Parameters - * - * ### Security Policies - * + * List all nexus objects defined for this company filtered by TaxTypeGroup. + * + * The concept of Nexus indicates a place where your company is legally obligated to collect and remit transactional + * taxes. The legal requirements for nexus may vary per country and per jurisdiction; please seek advice from your + * accountant or lawyer prior to declaring nexus. + * + * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . + * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. + * You may specify one or more of the following values in the '$include' parameter to fetch additional nested data, using commas to separate multiple values: + * + * * Parameters + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns these nexus objects - * @param string $taxTypeGroup Name of TaxTypeGroup to filter by - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* streamlinedSalesTax, isSSTActive, taxTypeGroup, taxAuthorityId, taxName, parameters, taxableNexus - * @param string $include A comma separated list of additional data to retrieve. - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param int $companyId The ID of the company that owns these nexus objects + * @param string $taxTypeGroup Name of TaxTypeGroup to filter by + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* streamlinedSalesTax, isSSTActive, taxTypeGroup, taxAuthorityId, taxName, parameters, taxableNexus + * @param string $include A comma separated list of additional data to retrieve. + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -7851,32 +7851,32 @@ public function listNexusByCompanyAndTaxTypeGroup($companyId, $taxTypeGroup, $fi 'query' => ['$filter' => $filter, '$include' => $include, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve parameters for a nexus * - * List parameters for a nexus. - * Some tax calculation and reporting are different depending on the properties of the nexus, such as isRemoteSeller. In AvaTax, these tax-affecting properties are called "parameters". - * - * A parameter added to an nexus will be used by default in tax calculation but will not show on the transaction line referencing the nexus. - * - * A parameter specified on a transaction line will override an nexus parameter if they share the same parameter name. - * - * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . - * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. - * - * ### Security Policies - * + * List parameters for a nexus. + * Some tax calculation and reporting are different depending on the properties of the nexus, such as isRemoteSeller. In AvaTax, these tax-affecting properties are called "parameters". + * + * A parameter added to an nexus will be used by default in tax calculation but will not show on the transaction line referencing the nexus. + * + * A parameter specified on a transaction line will override an nexus parameter if they share the same parameter name. + * + * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . + * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * - * @param int $companyId The company id - * @param int $nexusId The nexus id - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* name, unit - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param int $companyId The company id + * @param int $nexusId The nexus id + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* name, unit + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -7886,33 +7886,33 @@ public function listNexusParameters($companyId, $nexusId, $filter=null, $top=nul 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve all nexus * - * Get multiple nexus objects across all companies. - * - * The concept of Nexus indicates a place where your company is legally obligated to collect and remit transactional - * taxes. The legal requirements for nexus may vary per country and per jurisdiction; please seek advice from your - * accountant or lawyer prior to declaring nexus. - * - * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . - * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. - * You may specify one or more of the following values in the '$include' parameter to fetch additional nested data, using commas to separate multiple values: - * - * * Parameters - * - * ### Security Policies - * + * Get multiple nexus objects across all companies. + * + * The concept of Nexus indicates a place where your company is legally obligated to collect and remit transactional + * taxes. The legal requirements for nexus may vary per country and per jurisdiction; please seek advice from your + * accountant or lawyer prior to declaring nexus. + * + * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . + * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. + * You may specify one or more of the following values in the '$include' parameter to fetch additional nested data, using commas to separate multiple values: + * + * * Parameters + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* streamlinedSalesTax, isSSTActive, taxTypeGroup, taxAuthorityId, taxName, parameters, taxableNexus - * @param string $include A comma separated list of additional data to retrieve. - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* streamlinedSalesTax, isSSTActive, taxTypeGroup, taxAuthorityId, taxName, parameters, taxableNexus + * @param string $include A comma separated list of additional data to retrieve. + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -7922,39 +7922,39 @@ public function queryNexus($filter=null, $include=null, $top=null, $skip=null, $ 'query' => ['$filter' => $filter, '$include' => $include, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Update a single nexus * - * Replace the existing nexus declaration object at this URL with an updated object. - * - * The concept of Nexus indicates a place where your company is legally obligated to collect and remit transactional - * taxes. The legal requirements for nexus may vary per country and per jurisdiction; please seek advice from your - * accountant or lawyer prior to declaring nexus. - * - * To create a nexus declaration for your company, you must first call the Definitions API `ListNexus` to obtain a - * list of Avalara-defined nexus. Once you have determined which nexus you wish to declare, you should customize - * only the user-selectable fields in this object. - * - * The user selectable fields for the nexus object are `companyId`, `effectiveDate`, `endDate`, `localNexusTypeId`, - * `taxId`, `nexusTypeId`, `hasPermanentEstablishment`, and `isSellerImporterOfRecord`. - * - * When calling `CreateNexus` or `UpdateNexus`, all values in your nexus object except for the user-selectable fields - * must match an Avalara-defined system nexus object. You can retrieve a list of Avalara-defined system nexus objects - * by calling `ListNexus`. If any data does not match, AvaTax may not recognize your nexus declaration. - * - * Please note that nexus changes may not take effect immediately and you should plan to update your nexus settings in advance - * of calculating tax for a location. - * - * ### Security Policies - * + * Replace the existing nexus declaration object at this URL with an updated object. + * + * The concept of Nexus indicates a place where your company is legally obligated to collect and remit transactional + * taxes. The legal requirements for nexus may vary per country and per jurisdiction; please seek advice from your + * accountant or lawyer prior to declaring nexus. + * + * To create a nexus declaration for your company, you must first call the Definitions API `ListNexus` to obtain a + * list of Avalara-defined nexus. Once you have determined which nexus you wish to declare, you should customize + * only the user-selectable fields in this object. + * + * The user selectable fields for the nexus object are `companyId`, `effectiveDate`, `endDate`, `localNexusTypeId`, + * `taxId`, `nexusTypeId`, `hasPermanentEstablishment`, and `isSellerImporterOfRecord`. + * + * When calling `CreateNexus` or `UpdateNexus`, all values in your nexus object except for the user-selectable fields + * must match an Avalara-defined system nexus object. You can retrieve a list of Avalara-defined system nexus objects + * by calling `ListNexus`. If any data does not match, AvaTax may not recognize your nexus declaration. + * + * Please note that nexus changes may not take effect immediately and you should plan to update your nexus settings in advance + * of calculating tax for a location. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that this nexus belongs to. - * @param int $id The ID of the nexus you wish to update + * + * @param int $companyId The ID of the company that this nexus belongs to. + * @param int $id The ID of the nexus you wish to update * @param NexusModel $model The nexus object you wish to update. * @return NexusModel */ @@ -7964,28 +7964,28 @@ public function updateNexus($companyId, $id, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'PUT', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'PUT', $guzzleParams,'22.8.0' ); } /** * Update an nexus parameter * - * Update an nexus parameter. - * - * Some tax calculation and reporting are different depending on the properties of the nexus, such as isRemoteSeller. In AvaTax, these tax-affecting properties are called "parameters". - * - * A parameter added to a nexus will be used in tax calculation based on the locationcode and parameter value the transaction state line might have lines added. - * - * A parameter specified on a transaction line will override an item parameter if they share the same parameter name.????? I dont know about this? - * - * ### Security Policies - * + * Update an nexus parameter. + * + * Some tax calculation and reporting are different depending on the properties of the nexus, such as isRemoteSeller. In AvaTax, these tax-affecting properties are called "parameters". + * + * A parameter added to a nexus will be used in tax calculation based on the locationcode and parameter value the transaction state line might have lines added. + * + * A parameter specified on a transaction line will override an item parameter if they share the same parameter name.????? I dont know about this? + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The company id. - * @param int $nexusId The nexus id - * @param int $id The nexus parameter id + * + * @param int $companyId The company id. + * @param int $nexusId The nexus id + * @param int $id The nexus parameter id * @param NexusParameterDetailModel $model The nexus object you wish to update. * @return NexusParameterDetailModel */ @@ -7995,20 +7995,20 @@ public function updateNexusParameter($companyId, $nexusId, $id, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'PUT', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'PUT', $guzzleParams,'22.8.0' ); } /** * Creates a new tax notice responsibility type. * - * This API is available by invitation only and only available for users with Compliance admin access. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. + * This API is available by invitation only and only available for users with Compliance admin access. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * * This API depends on the following active services:*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged. * Swagger Name: AvaTaxClient - * + * * @param CreateNoticeResponsibilityTypeModel $model The responsibility type to create * @return NoticeResponsibilityModel */ @@ -8018,20 +8018,20 @@ public function createNoticeResponsibilityType($model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Creates a new tax notice root cause type. * - * This API is available by invitation only and only available for users with Compliance admin access. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. + * This API is available by invitation only and only available for users with Compliance admin access. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * * This API depends on the following active services:*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged. * Swagger Name: AvaTaxClient - * + * * @param CreateNoticeRootCauseTypeModel $model The root cause type to create * @return NoticeRootCauseModel */ @@ -8041,19 +8041,19 @@ public function createNoticeRootCauseType($model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Delete a tax notice responsibility type. * - * This API is available by invitation only and only available for users with Compliance admin access. - * - * ### Security Policies - * + * This API is available by invitation only and only available for users with Compliance admin access. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * + * * @param int $responsibilityId The unique ID of the responsibility type * @return ErrorDetail[] */ @@ -8063,19 +8063,19 @@ public function deleteNoticeResponsibilityType($responsibilityId) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'DELETE', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'DELETE', $guzzleParams,'22.8.0' ); } /** * Delete a tax notice root cause type. * - * This API is available by invitation only and only available for users with Compliance admin access. - * - * ### Security Policies - * + * This API is available by invitation only and only available for users with Compliance admin access. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * + * * @param int $rootCauseId The unique ID of the root cause type * @return ErrorDetail[] */ @@ -8085,32 +8085,32 @@ public function deleteNoticeRootCauseType($rootCauseId) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'DELETE', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'DELETE', $guzzleParams,'22.8.0' ); } /** * Mark a single notification as dismissed. * - * Marks the notification identified by this URL as dismissed. - * - * A notification is a message from Avalara that may have relevance to your business. You may want - * to regularly review notifications and then dismiss them when you are certain that you have addressed - * any relevant concerns raised by this notification. - * - * An example of a notification would be a message about new software, or a change to AvaTax that may - * affect you, or a potential issue with your company's tax profile. - * - * When you dismiss a notification, the notification will track the user and time when it was - * dismissed. You can then later review which employees of your company dismissed notifications to - * determine if they were resolved appropriately. - * - * A Global notification with null accountId and companyId cannot be dismissed and will expire within a given time span. - * - * ### Security Policies - * + * Marks the notification identified by this URL as dismissed. + * + * A notification is a message from Avalara that may have relevance to your business. You may want + * to regularly review notifications and then dismiss them when you are certain that you have addressed + * any relevant concerns raised by this notification. + * + * An example of a notification would be a message about new software, or a change to AvaTax that may + * affect you, or a potential issue with your company's tax profile. + * + * When you dismiss a notification, the notification will track the user and time when it was + * dismissed. You can then later review which employees of your company dismissed notifications to + * determine if they were resolved appropriately. + * + * A Global notification with null accountId and companyId cannot be dismissed and will expire within a given time span. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * + * * @param int $id The id of the notification you wish to mark as dismissed. * @return NotificationModel */ @@ -8120,26 +8120,26 @@ public function dismissNotification($id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'PUT', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'PUT', $guzzleParams,'22.8.0' ); } /** * Retrieve a single notification. * - * Retrieve a single notification by its unique ID number. - * - * A notification is a message from Avalara that may have relevance to your business. You may want - * to regularly review notifications and then dismiss them when you are certain that you have addressed - * any relevant concerns raised by this notification. - * - * An example of a notification would be a message about new software, or a change to AvaTax that may - * affect you, or a potential issue with your company's tax profile. - * - * ### Security Policies - * + * Retrieve a single notification by its unique ID number. + * + * A notification is a message from Avalara that may have relevance to your business. You may want + * to regularly review notifications and then dismiss them when you are certain that you have addressed + * any relevant concerns raised by this notification. + * + * An example of a notification would be a message about new software, or a change to AvaTax that may + * affect you, or a potential issue with your company's tax profile. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * + * * @param int $id The id of the notification to retrieve. * @return NotificationModel */ @@ -8149,32 +8149,32 @@ public function getNotification($id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * List all notifications. * - * List all notifications. - * - * A notification is a message from Avalara that may have relevance to your business. You may want - * to regularly review notifications and then dismiss them when you are certain that you have addressed - * any relevant concerns raised by this notification. - * - * An example of a notification would be a message about new software, or a change to AvaTax that may - * affect you, or a potential issue with your company's tax profile. - * - * You may search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . - * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. - * - * ### Security Policies - * + * List all notifications. + * + * A notification is a message from Avalara that may have relevance to your business. You may want + * to regularly review notifications and then dismiss them when you are certain that you have addressed + * any relevant concerns raised by this notification. + * + * An example of a notification would be a message about new software, or a change to AvaTax that may + * affect you, or a potential issue with your company's tax profile. + * + * You may search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . + * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -8184,34 +8184,34 @@ public function listNotifications($filter=null, $top=null, $skip=null, $orderBy= 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Request a new Avalara account * - * This API is for use by partner provisioning services customers only. - * - * Avalara invites select partners to refer new customers to the AvaTax service using the onboarding features - * of AvaTax. These partners can create accounts for new customers using this API. - * - * Calling this API creates an account with the specified product subscriptions, but does not configure billing. - * The customer will receive information from Avalara about how to configure billing for their account. - * You should call this API when a customer has requested to begin using Avalara services. - * - * If the newly created account owner wishes, they can confirm that they have read and agree to the Avalara - * terms and conditions. If they do so, they can receive a license key as part of this API and their - * API will be created in `Active` status. If the customer has not yet read and accepted these terms and - * conditions, the account will be created in `New` status and they can receive a license key by logging - * onto the AvaTax website and reviewing terms and conditions online. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. - * * This API is available by invitation only. + * This API is for use by partner provisioning services customers only. + * + * Avalara invites select partners to refer new customers to the AvaTax service using the onboarding features + * of AvaTax. These partners can create accounts for new customers using this API. + * + * Calling this API creates an account with the specified product subscriptions, but does not configure billing. + * The customer will receive information from Avalara about how to configure billing for their account. + * You should call this API when a customer has requested to begin using Avalara services. + * + * If the newly created account owner wishes, they can confirm that they have read and agree to the Avalara + * terms and conditions. If they do so, they can receive a license key as part of this API and their + * API will be created in `Active` status. If the customer has not yet read and accepted these terms and + * conditions, the account will be created in `New` status and they can receive a license key by logging + * onto the AvaTax website and reviewing terms and conditions online. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. + * * This API is available by invitation only. * * This API is available by invitation only. To request access to this feature, please speak to a business development manager and request access to [Provisioning:RequestNewAccount]. * Swagger Name: AvaTaxClient - * + * * @param NewAccountRequestModel $model Information about the account you wish to create and the selected product offerings. * @return NewAccountModel */ @@ -8221,23 +8221,23 @@ public function requestNewAccount($model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Request a new entitilement to an existing customer * - * This API is for use by partner provisioning services customers only. This will allow the partners to allow - * the add new entitlement to an existing customer - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. - * * This API is available by invitation only. + * This API is for use by partner provisioning services customers only. This will allow the partners to allow + * the add new entitlement to an existing customer + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. + * * This API is available by invitation only. * * This API is available by invitation only. To request access to this feature, please speak to a business development manager and request access to [Provisioning:RequestNewAccount]. * Swagger Name: AvaTaxClient - * - * @param int $id The avatax account id of the customer + * + * @param int $id The avatax account id of the customer * @param string $offer The offer to be added to an already existing customer * @return OfferModel */ @@ -8247,23 +8247,23 @@ public function requestNewEntitlement($id, $offer) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Create a new account * - * # For Registrar Use Only - * This API is for use by Avalara Registrar administrative users only. - * - * Create a single new account object. - * When creating an account object you may attach subscriptions and users as part of the 'Create' call. - * - * ### Security Policies - * + * # For Registrar Use Only + * This API is for use by Avalara Registrar administrative users only. + * + * Create a single new account object. + * When creating an account object you may attach subscriptions and users as part of the 'Create' call. + * + * ### Security Policies + * * * This API requires one of the following user roles: BatchServiceAdmin, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * + * * @param AccountModel $model The account you wish to create. * @return AccountModel[] */ @@ -8273,32 +8273,32 @@ public function createAccount($model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Create new notifications. * - * This API is available by invitation only. - * - * Create a single notification. - * - * A notification is a message from Avalara that may have relevance to your business. You may want - * to regularly review notifications and then dismiss them when you are certain that you have addressed - * any relevant concerns raised by this notification. - * - * A Global notification is a message which is directed to all the accounts and is set to expire within - * a certain time and cannot be dismissed by the user. Make accountId and companyId null to create a global notification. - * - * An example of a notification would be a message about new software, or a change to AvaTax that may - * affect you, or a potential issue with your company's tax profile. - * - * ### Security Policies - * - * * This API requires one of the following user roles: BatchServiceAdmin, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. + * This API is available by invitation only. + * + * Create a single notification. + * + * A notification is a message from Avalara that may have relevance to your business. You may want + * to regularly review notifications and then dismiss them when you are certain that you have addressed + * any relevant concerns raised by this notification. + * + * A Global notification is a message which is directed to all the accounts and is set to expire within + * a certain time and cannot be dismissed by the user. Make accountId and companyId null to create a global notification. + * + * An example of a notification would be a message about new software, or a change to AvaTax that may + * affect you, or a potential issue with your company's tax profile. + * + * ### Security Policies + * + * * This API requires one of the following user roles: BatchServiceAdmin, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. * * This API is available by invitation only. To request access to this feature, please speak to a business development manager and request access to [NotificationsAPI:Create]. * Swagger Name: AvaTaxClient - * + * * @param NotificationModel[] $model The notifications you wish to create. * @return NotificationModel[] */ @@ -8308,24 +8308,24 @@ public function createNotifications($model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Create a new subscription * - * This API is for use by Avalara Registrar administrative users only. - * - * Create one or more new subscription objects attached to this account. - * A 'subscription' indicates a licensed subscription to a named Avalara service. - * To request or remove subscriptions, please contact Avalara sales or your customer account manager. - * - * ### Security Policies - * + * This API is for use by Avalara Registrar administrative users only. + * + * Create one or more new subscription objects attached to this account. + * A 'subscription' indicates a licensed subscription to a named Avalara service. + * To request or remove subscriptions, please contact Avalara sales or your customer account manager. + * + * ### Security Policies + * * * This API requires one of the following user roles: BatchServiceAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $accountId The ID of the account that owns this subscription. + * + * @param int $accountId The ID of the account that owns this subscription. * @param SubscriptionModel[] $model The subscription you wish to create. * @return SubscriptionModel[] */ @@ -8335,23 +8335,23 @@ public function createSubscriptions($accountId, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Delete a single account * - * # For Registrar Use Only - * This API is for use by Avalara Registrar administrative users only. - * - * Delete an account. - * Deleting an account will delete all companies, all account level users and license keys attached to this account. - * - * ### Security Policies - * + * # For Registrar Use Only + * This API is for use by Avalara Registrar administrative users only. + * + * Delete an account. + * Deleting an account will delete all companies, all account level users and license keys attached to this account. + * + * ### Security Policies + * * * This API requires the user role SystemAdmin. * Swagger Name: AvaTaxClient - * + * * @param int $id The ID of the account you wish to delete. * @return ErrorDetail[] */ @@ -8361,29 +8361,29 @@ public function deleteAccount($id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'DELETE', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'DELETE', $guzzleParams,'22.8.0' ); } /** * Delete a single notification. * - * This API is available by invitation only. - * - * Delete the existing notification identified by this URL. - * - * A notification is a message from Avalara that may have relevance to your business. You may want - * to regularly review notifications and then dismiss them when you are certain that you have addressed - * any relevant concerns raised by this notification. - * - * An example of a notification would be a message about new software, or a change to AvaTax that may - * affect you, or a potential issue with your company's tax profile. - * - * ### Security Policies - * - * * This API requires one of the following user roles: BatchServiceAdmin, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. + * This API is available by invitation only. + * + * Delete the existing notification identified by this URL. + * + * A notification is a message from Avalara that may have relevance to your business. You may want + * to regularly review notifications and then dismiss them when you are certain that you have addressed + * any relevant concerns raised by this notification. + * + * An example of a notification would be a message about new software, or a change to AvaTax that may + * affect you, or a potential issue with your company's tax profile. + * + * ### Security Policies + * + * * This API requires one of the following user roles: BatchServiceAdmin, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. * * This API is available by invitation only. To request access to this feature, please speak to a business development manager and request access to [NotificationsAPI:Create]. * Swagger Name: AvaTaxClient - * + * * @param int $id The id of the notification you wish to delete. * @return ErrorDetail[] */ @@ -8393,23 +8393,23 @@ public function deleteNotification($id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'DELETE', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'DELETE', $guzzleParams,'22.8.0' ); } /** * Delete a single subscription * - * # For Registrar Use Only - * This API is for use by Avalara Registrar administrative users only. - * - * Mark the existing account identified by this URL as deleted. - * - * ### Security Policies - * + * # For Registrar Use Only + * This API is for use by Avalara Registrar administrative users only. + * + * Mark the existing account identified by this URL as deleted. + * + * ### Security Policies + * * * This API requires one of the following user roles: BatchServiceAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $accountId The ID of the account that owns this subscription. + * + * @param int $accountId The ID of the account that owns this subscription. * @param int $id The ID of the subscription you wish to delete. * @return ErrorDetail[] */ @@ -8419,27 +8419,27 @@ public function deleteSubscription($accountId, $id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'DELETE', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'DELETE', $guzzleParams,'22.8.0' ); } /** * Reset a user's password programmatically * - * # For Registrar Use Only - * This API is for use by Avalara Registrar administrative users only. - * - * Allows a system admin to reset the password for a specific user via the API. - * This API is only available for Avalara Registrar Admins, and can be used to reset the password of any - * user based on internal Avalara business processes. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. + * # For Registrar Use Only + * This API is for use by Avalara Registrar administrative users only. + * + * Allows a system admin to reset the password for a specific user via the API. + * This API is only available for Avalara Registrar Admins, and can be used to reset the password of any + * user based on internal Avalara business processes. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * * This API is available to Avalara system-level (registrar-level) users only. * Swagger Name: AvaTaxClient - * - * @param int $userId The unique ID of the user whose password will be changed - * @param boolean $isUndoMigrateRequest If user's password was migrated to AI, undo this. + * + * @param int $userId The unique ID of the user whose password will be changed + * @param boolean $isUndoMigrateRequest If user's password was migrated to AI, undo this. * @param SetPasswordModel $model The new password for this user * @return string */ @@ -8449,23 +8449,23 @@ public function resetPassword($userId, $isUndoMigrateRequest, $model) { 'query' => ['isUndoMigrateRequest' => $isUndoMigrateRequest], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Update a single account * - * # For Registrar Use Only - * This API is for use by Avalara Registrar administrative users only. - * - * Replace an existing account object with an updated account object. - * - * ### Security Policies - * + * # For Registrar Use Only + * This API is for use by Avalara Registrar administrative users only. + * + * Replace an existing account object with an updated account object. + * + * ### Security Policies + * * * This API requires one of the following user roles: BatchServiceAdmin, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $id The ID of the account you wish to update. + * + * @param int $id The ID of the account you wish to update. * @param AccountModel $model The account object you wish to update. * @return AccountModel */ @@ -8475,30 +8475,30 @@ public function updateAccount($id, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'PUT', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'PUT', $guzzleParams,'22.8.0' ); } /** * Update a single notification. * - * This API is available by invitation only. - * - * Replaces the notification identified by this URL with a new notification. - * - * A notification is a message from Avalara that may have relevance to your business. You may want - * to regularly review notifications and then dismiss them when you are certain that you have addressed - * any relevant concerns raised by this notification. - * - * An example of a notification would be a message about new software, or a change to AvaTax that may - * affect you, or a potential issue with your company's tax profile. - * - * ### Security Policies - * - * * This API requires one of the following user roles: BatchServiceAdmin, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. + * This API is available by invitation only. + * + * Replaces the notification identified by this URL with a new notification. + * + * A notification is a message from Avalara that may have relevance to your business. You may want + * to regularly review notifications and then dismiss them when you are certain that you have addressed + * any relevant concerns raised by this notification. + * + * An example of a notification would be a message about new software, or a change to AvaTax that may + * affect you, or a potential issue with your company's tax profile. + * + * ### Security Policies + * + * * This API requires one of the following user roles: BatchServiceAdmin, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. * * This API is available by invitation only. To request access to this feature, please speak to a business development manager and request access to [NotificationsAPI:Create]. * Swagger Name: AvaTaxClient - * - * @param int $id The id of the notification you wish to update. + * + * @param int $id The id of the notification you wish to update. * @param NotificationModel $model The notification object you wish to update. * @return NotificationModel */ @@ -8508,28 +8508,28 @@ public function updateNotification($id, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'PUT', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'PUT', $guzzleParams,'22.8.0' ); } /** * Update a single subscription * - * # For Registrar Use Only - * This API is for use by Avalara Registrar administrative users only. - * - * Replace the existing subscription object at this URL with an updated object. - * A 'subscription' indicates a licensed subscription to a named Avalara service. - * To request or remove subscriptions, please contact Avalara sales or your customer account manager. - * All data from the existing object will be replaced with data in the object you PUT. - * To set a field's value to null, you may either set its value to null or omit that field from the object you post. - * - * ### Security Policies - * + * # For Registrar Use Only + * This API is for use by Avalara Registrar administrative users only. + * + * Replace the existing subscription object at this URL with an updated object. + * A 'subscription' indicates a licensed subscription to a named Avalara service. + * To request or remove subscriptions, please contact Avalara sales or your customer account manager. + * All data from the existing object will be replaced with data in the object you PUT. + * To set a field's value to null, you may either set its value to null or omit that field from the object you post. + * + * ### Security Policies + * * * This API requires one of the following user roles: BatchServiceAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $accountId The ID of the account that this subscription belongs to. - * @param int $id The ID of the subscription you wish to update + * + * @param int $accountId The ID of the account that this subscription belongs to. + * @param int $id The ID of the subscription you wish to update * @param SubscriptionModel $model The subscription you wish to update. * @return SubscriptionModel */ @@ -8539,32 +8539,32 @@ public function updateSubscription($accountId, $id, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'PUT', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'PUT', $guzzleParams,'22.8.0' ); } /** * Download a report * - * This API downloads the file associated with a report. - * - * If the report is not yet complete, you will receive a `ReportNotFinished` error. To check if a report is complete, - * use the `GetReport` API. - * - * Reports are run as asynchronous report tasks on the server. When complete, the report file will be available for download - * for up to 30 days after completion. To run an asynchronous report, you should follow these steps: - * - * * Begin a report by calling the report's Initiate API. There is a separate initiate API call for each report type. - * * In the result of the Initiate API, you receive back a report's `id` value. - * * Check the status of a report by calling `GetReport` and passing in the report's `id` value. - * * When a report's status is `Completed`, call `DownloadReport` to retrieve the file. - * - * * We throttle this API. You can only call this API up to 5 times in a minute. - * - * ### Security Policies - * + * This API downloads the file associated with a report. + * + * If the report is not yet complete, you will receive a `ReportNotFinished` error. To check if a report is complete, + * use the `GetReport` API. + * + * Reports are run as asynchronous report tasks on the server. When complete, the report file will be available for download + * for up to 30 days after completion. To run an asynchronous report, you should follow these steps: + * + * * Begin a report by calling the report's Initiate API. There is a separate initiate API call for each report type. + * * In the result of the Initiate API, you receive back a report's `id` value. + * * Check the status of a report by calling `GetReport` and passing in the report's `id` value. + * * When a report's status is `Completed`, call `DownloadReport` to retrieve the file. + * + * * We throttle this API. You can only call this API up to 5 times in a minute. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * + * * @param int $id The unique ID number of this report * @return object */ @@ -8574,25 +8574,25 @@ public function downloadReport($id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve a single report * - * Retrieve a single report by its unique ID number. - * - * Reports are run as asynchronous report tasks on the server. When complete, the report file will be available for download - * for up to 30 days after completion. To run an asynchronous report, you should follow these steps: - * - * * Begin a report by calling the report's Initiate API. There is a separate initiate API call for each report type. - * * In the result of the Initiate API, you receive back a report's `id` value. - * * Check the status of a report by calling `GetReport` and passing in the report's `id` value. - * * When a report's status is `Completed`, call `DownloadReport` to retrieve the file. - * + * Retrieve a single report by its unique ID number. + * + * Reports are run as asynchronous report tasks on the server. When complete, the report file will be available for download + * for up to 30 days after completion. To run an asynchronous report, you should follow these steps: + * + * * Begin a report by calling the report's Initiate API. There is a separate initiate API call for each report type. + * * In the result of the Initiate API, you receive back a report's `id` value. + * * Check the status of a report by calling `GetReport` and passing in the report's `id` value. + * * When a report's status is `Completed`, call `DownloadReport` to retrieve the file. + * * This API call returns information about any report type. * Swagger Name: AvaTaxClient - * + * * @param int $id The unique ID number of the report to retrieve * @return ReportModel */ @@ -8602,39 +8602,39 @@ public function getReport($id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Initiate an ExportDocumentLine report task * - * Begins running an `ExportDocumentLine` report task and returns the identity of the report. - * - * Reports are run as asynchronous report tasks on the server. When complete, the report file will be available for download - * for up to 30 days after completion. To run an asynchronous report, you should follow these steps: - * - * * Begin a report by calling the report's Initiate API. There is a separate initiate API call for each report type. - * * In the result of the Initiate API, you receive back a report's `id` value. - * * Check the status of a report by calling `GetReport` and passing in the report's `id` value. - * * When a report's status is `Completed`, call `DownloadReport` to retrieve the file. - * - * The `ExportDocumentLine` report produces information about invoice lines recorded within your account. - * - * To split large reports into multiple smaller partitions, use the numberOfPartitions and partition properties on ExportDocumentLineModel. - * - * Example - split a report into three partitions - * - * * Follow the steps above with numberOfPartitions = 3 and partition = 0 - * * Follow the steps above with numberOfPartitions = 3 and partition = 1 - * * Follow the steps above with numberOfPartitions = 3 and partition = 2 - * * Once all three reports are downloaded merge the files on the client side. - * - * ### Security Policies - * + * Begins running an `ExportDocumentLine` report task and returns the identity of the report. + * + * Reports are run as asynchronous report tasks on the server. When complete, the report file will be available for download + * for up to 30 days after completion. To run an asynchronous report, you should follow these steps: + * + * * Begin a report by calling the report's Initiate API. There is a separate initiate API call for each report type. + * * In the result of the Initiate API, you receive back a report's `id` value. + * * Check the status of a report by calling `GetReport` and passing in the report's `id` value. + * * When a report's status is `Completed`, call `DownloadReport` to retrieve the file. + * + * The `ExportDocumentLine` report produces information about invoice lines recorded within your account. + * + * To split large reports into multiple smaller partitions, use the numberOfPartitions and partition properties on ExportDocumentLineModel. + * + * Example - split a report into three partitions + * + * * Follow the steps above with numberOfPartitions = 3 and partition = 0 + * * Follow the steps above with numberOfPartitions = 3 and partition = 1 + * * Follow the steps above with numberOfPartitions = 3 and partition = 2 + * * Once all three reports are downloaded merge the files on the client side. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * - * @param int $companyId The unique ID number of the company to report on. + * + * @param int $companyId The unique ID number of the company to report on. * @param ExportDocumentLineModel $model Options that may be configured to customize the report. * @return ReportModel[] */ @@ -8644,32 +8644,32 @@ public function initiateExportDocumentLineReport($companyId, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * List all report tasks for account * - * List all report tasks for your account. - * - * Reports are run as asynchronous report tasks on the server. When complete, the report file will be available for download - * for up to 30 days after completion. To run an asynchronous report, you should follow these steps: - * - * * Begin a report by calling the report's Initiate API. There is a separate initiate API call for each report type. - * * In the result of the Initiate API, you receive back a report's `id` value. - * * Check the status of a report by calling `GetReport` and passing in the report's `id` value. - * * When a report's status is `Completed`, call `DownloadReport` to retrieve the file. - * - * This API call returns information about all report types across your entire account. - * - * ### Security Policies - * + * List all report tasks for your account. + * + * Reports are run as asynchronous report tasks on the server. When complete, the report file will be available for download + * for up to 30 days after completion. To run an asynchronous report, you should follow these steps: + * + * * Begin a report by calling the report's Initiate API. There is a separate initiate API call for each report type. + * * In the result of the Initiate API, you receive back a report's `id` value. + * * Check the status of a report by calling `GetReport` and passing in the report's `id` value. + * * When a report's status is `Completed`, call `DownloadReport` to retrieve the file. + * + * This API call returns information about all report types across your entire account. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * - * @param int $companyId The id of the company for which to get reports. - * @param string $pageKey Provide a page key to retrieve the next page of results. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param int $companyId The id of the company for which to get reports. + * @param string $pageKey Provide a page key to retrieve the next page of results. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. * @return FetchResult */ @@ -8679,34 +8679,34 @@ public function listReports($companyId, $pageKey, $skip=null, $top=null) { 'query' => ['companyId' => $companyId, 'pageKey' => $pageKey, '$skip' => $skip, '$top' => $top], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Create a new setting * - * Create one or more new setting objects attached to this company. - * - * The company settings system is a metadata system that you can use to store extra information - * about a company. Your integration or connector could use this data storage to keep track of - * preference information, reminders, or any other storage that would need to persist even if - * the customer uninstalls your application. - * - * A setting can refer to any type of data you need to remember about this company object. - * When creating this object, you may define your own `set`, `name`, and `value` parameters. - * To define your own values, please choose a `set` name that begins with `X-` to indicate an extension. - * - * Use Set = Transactions, Name = TaxCodePrioritization/HSCodePrioritization and Value = Transaction/ItemMaster for prioritizing which TaxCodes/HsCodes should be used for calculating taxes. - * - * Example: To prioritize TaxCodes passed in a Transaction over values stored with Items when calculating tax, use - * Set = Transactions, Name = TaxCodePrioritization, Value = Transaction - * - * ### Security Policies - * + * Create one or more new setting objects attached to this company. + * + * The company settings system is a metadata system that you can use to store extra information + * about a company. Your integration or connector could use this data storage to keep track of + * preference information, reminders, or any other storage that would need to persist even if + * the customer uninstalls your application. + * + * A setting can refer to any type of data you need to remember about this company object. + * When creating this object, you may define your own `set`, `name`, and `value` parameters. + * To define your own values, please choose a `set` name that begins with `X-` to indicate an extension. + * + * Use Set = Transactions, Name = TaxCodePrioritization/HSCodePrioritization and Value = Transaction/ItemMaster for prioritizing which TaxCodes/HsCodes should be used for calculating taxes. + * + * Example: To prioritize TaxCodes passed in a Transaction over values stored with Items when calculating tax, use + * Set = Transactions, Name = TaxCodePrioritization, Value = Transaction + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this setting. + * + * @param int $companyId The ID of the company that owns this setting. * @param SettingModel[] $model The setting you wish to create. * @return SettingModel[] */ @@ -8716,29 +8716,29 @@ public function createSettings($companyId, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Delete a single setting * - * Mark the setting object at this URL as deleted. - * - * The company settings system is a metadata system that you can use to store extra information - * about a company. Your integration or connector could use this data storage to keep track of - * preference information, reminders, or any other storage that would need to persist even if - * the customer uninstalls your application. - * - * A setting can refer to any type of data you need to remember about this company object. - * When creating this object, you may define your own `set`, `name`, and `value` parameters. - * To define your own values, please choose a `set` name that begins with `X-` to indicate an extension. - * - * ### Security Policies - * + * Mark the setting object at this URL as deleted. + * + * The company settings system is a metadata system that you can use to store extra information + * about a company. Your integration or connector could use this data storage to keep track of + * preference information, reminders, or any other storage that would need to persist even if + * the customer uninstalls your application. + * + * A setting can refer to any type of data you need to remember about this company object. + * When creating this object, you may define your own `set`, `name`, and `value` parameters. + * To define your own values, please choose a `set` name that begins with `X-` to indicate an extension. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this setting. + * + * @param int $companyId The ID of the company that owns this setting. * @param int $id The ID of the setting you wish to delete. * @return ErrorDetail[] */ @@ -8748,29 +8748,29 @@ public function deleteSetting($companyId, $id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'DELETE', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'DELETE', $guzzleParams,'22.8.0' ); } /** * Retrieve a single setting * - * Get a single setting object by its unique ID. - * - * The company settings system is a metadata system that you can use to store extra information - * about a company. Your integration or connector could use this data storage to keep track of - * preference information, reminders, or any other storage that would need to persist even if - * the customer uninstalls your application. - * - * A setting can refer to any type of data you need to remember about this company object. - * When creating this object, you may define your own `set`, `name`, and `value` parameters. - * To define your own values, please choose a `set` name that begins with `X-` to indicate an extension. - * - * ### Security Policies - * + * Get a single setting object by its unique ID. + * + * The company settings system is a metadata system that you can use to store extra information + * about a company. Your integration or connector could use this data storage to keep track of + * preference information, reminders, or any other storage that would need to persist even if + * the customer uninstalls your application. + * + * A setting can refer to any type of data you need to remember about this company object. + * When creating this object, you may define your own `set`, `name`, and `value` parameters. + * To define your own values, please choose a `set` name that begins with `X-` to indicate an extension. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this setting + * + * @param int $companyId The ID of the company that owns this setting * @param int $id The primary key of this setting * @return SettingModel */ @@ -8780,36 +8780,36 @@ public function getSetting($companyId, $id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve all settings for this company * - * List all setting objects attached to this company. - * - * The company settings system is a metadata system that you can use to store extra information - * about a company. Your integration or connector could use this data storage to keep track of - * preference information, reminders, or any other storage that would need to persist even if - * the customer uninstalls your application. - * - * A setting can refer to any type of data you need to remember about this company object. - * When creating this object, you may define your own `set`, `name`, and `value` parameters. - * To define your own values, please choose a `set` name that begins with `X-` to indicate an extension. - * - * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . - * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. - * - * ### Security Policies - * + * List all setting objects attached to this company. + * + * The company settings system is a metadata system that you can use to store extra information + * about a company. Your integration or connector could use this data storage to keep track of + * preference information, reminders, or any other storage that would need to persist even if + * the customer uninstalls your application. + * + * A setting can refer to any type of data you need to remember about this company object. + * When creating this object, you may define your own `set`, `name`, and `value` parameters. + * To define your own values, please choose a `set` name that begins with `X-` to indicate an extension. + * + * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . + * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns these settings - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* modifiedDate, ModifiedUserId - * @param string $include A comma separated list of additional data to retrieve. - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param int $companyId The ID of the company that owns these settings + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* modifiedDate, ModifiedUserId + * @param string $include A comma separated list of additional data to retrieve. + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -8819,35 +8819,35 @@ public function listSettingsByCompany($companyId, $filter=null, $include=null, $ 'query' => ['$filter' => $filter, '$include' => $include, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve all settings * - * Get multiple setting objects across all companies. - * - * The company settings system is a metadata system that you can use to store extra information - * about a company. Your integration or connector could use this data storage to keep track of - * preference information, reminders, or any other storage that would need to persist even if - * the customer uninstalls your application. - * - * A setting can refer to any type of data you need to remember about this company object. - * When creating this object, you may define your own `set`, `name`, and `value` parameters. - * To define your own values, please choose a `set` name that begins with `X-` to indicate an extension. - * - * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . - * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. - * - * ### Security Policies - * + * Get multiple setting objects across all companies. + * + * The company settings system is a metadata system that you can use to store extra information + * about a company. Your integration or connector could use this data storage to keep track of + * preference information, reminders, or any other storage that would need to persist even if + * the customer uninstalls your application. + * + * A setting can refer to any type of data you need to remember about this company object. + * When creating this object, you may define your own `set`, `name`, and `value` parameters. + * To define your own values, please choose a `set` name that begins with `X-` to indicate an extension. + * + * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . + * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* modifiedDate, ModifiedUserId - * @param string $include A comma separated list of additional data to retrieve. - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* modifiedDate, ModifiedUserId + * @param string $include A comma separated list of additional data to retrieve. + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -8857,34 +8857,34 @@ public function querySettings($filter=null, $include=null, $top=null, $skip=null 'query' => ['$filter' => $filter, '$include' => $include, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Update a single setting * - * Replace the existing setting object at this URL with an updated object. - * - * The company settings system is a metadata system that you can use to store extra information - * about a company. Your integration or connector could use this data storage to keep track of - * preference information, reminders, or any other storage that would need to persist even if - * the customer uninstalls your application. - * - * A setting can refer to any type of data you need to remember about this company object. - * When creating this object, you may define your own `set`, `name`, and `value` parameters. - * To define your own values, please choose a `set` name that begins with `X-` to indicate an extension. - * - * All data from the existing object will be replaced with data in the object you `PUT`. - * - * To set a field's value to `null`, you may either set its value to `null` or omit that field from the object when calling update. - * - * ### Security Policies - * + * Replace the existing setting object at this URL with an updated object. + * + * The company settings system is a metadata system that you can use to store extra information + * about a company. Your integration or connector could use this data storage to keep track of + * preference information, reminders, or any other storage that would need to persist even if + * the customer uninstalls your application. + * + * A setting can refer to any type of data you need to remember about this company object. + * When creating this object, you may define your own `set`, `name`, and `value` parameters. + * To define your own values, please choose a `set` name that begins with `X-` to indicate an extension. + * + * All data from the existing object will be replaced with data in the object you `PUT`. + * + * To set a field's value to `null`, you may either set its value to `null` or omit that field from the object when calling update. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that this setting belongs to. - * @param int $id The ID of the setting you wish to update + * + * @param int $companyId The ID of the company that this setting belongs to. + * @param int $id The ID of the setting you wish to update * @param SettingModel $model The setting you wish to update. * @return SettingModel */ @@ -8894,22 +8894,22 @@ public function updateSetting($companyId, $id, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'PUT', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'PUT', $guzzleParams,'22.8.0' ); } /** * Retrieve a single subscription * - * Get the subscription object identified by this URL. - * A 'subscription' indicates a licensed subscription to a named Avalara service. - * To request or remove subscriptions, please contact Avalara sales or your customer account manager. - * - * ### Security Policies - * + * Get the subscription object identified by this URL. + * A 'subscription' indicates a licensed subscription to a named Avalara service. + * To request or remove subscriptions, please contact Avalara sales or your customer account manager. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * - * @param int $accountId The ID of the account that owns this subscription + * + * @param int $accountId The ID of the account that owns this subscription * @param int $id The primary key of this subscription * @return SubscriptionModel */ @@ -8919,28 +8919,28 @@ public function getSubscription($accountId, $id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve subscriptions for this account * - * List all subscription objects attached to this account. - * A 'subscription' indicates a licensed subscription to a named Avalara service. - * To request or remove subscriptions, please contact Avalara sales or your customer account manager. - * - * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . - * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. - * - * ### Security Policies - * + * List all subscription objects attached to this account. + * A 'subscription' indicates a licensed subscription to a named Avalara service. + * To request or remove subscriptions, please contact Avalara sales or your customer account manager. + * + * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . + * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * - * @param int $accountId The ID of the account that owns these subscriptions - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* subscriptionDescription - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param int $accountId The ID of the account that owns these subscriptions + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* subscriptionDescription + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -8950,27 +8950,27 @@ public function listSubscriptionsByAccount($accountId, $filter=null, $top=null, 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve all subscriptions * - * Get multiple subscription objects across all accounts. - * A 'subscription' indicates a licensed subscription to a named Avalara service. - * To request or remove subscriptions, please contact Avalara sales or your customer account manager. - * - * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . - * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. - * - * ### Security Policies - * + * Get multiple subscription objects across all accounts. + * A 'subscription' indicates a licensed subscription to a named Avalara service. + * To request or remove subscriptions, please contact Avalara sales or your customer account manager. + * + * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . + * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* subscriptionDescription - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* subscriptionDescription + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -8980,24 +8980,24 @@ public function querySubscriptions($filter=null, $top=null, $skip=null, $orderBy 'query' => ['$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Create a new tax code * - * Create one or more new taxcode objects attached to this company. - * A 'TaxCode' represents a uniquely identified type of product, good, or service. - * Avalara supports correct tax rates and taxability rules for all TaxCodes in all supported jurisdictions. - * If you identify your products by tax code in your 'Create Transacion' API calls, Avalara will correctly calculate tax rates and - * taxability rules for this product in all supported jurisdictions. - * - * ### Security Policies - * + * Create one or more new taxcode objects attached to this company. + * A 'TaxCode' represents a uniquely identified type of product, good, or service. + * Avalara supports correct tax rates and taxability rules for all TaxCodes in all supported jurisdictions. + * If you identify your products by tax code in your 'Create Transacion' API calls, Avalara will correctly calculate tax rates and + * taxability rules for this product in all supported jurisdictions. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this tax code. + * + * @param int $companyId The ID of the company that owns this tax code. * @param TaxCodeModel[] $model The tax code you wish to create. * @return TaxCodeModel[] */ @@ -9007,20 +9007,20 @@ public function createTaxCodes($companyId, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Delete a single tax code * - * Marks the existing TaxCode object at this URL as deleted. - * - * ### Security Policies - * + * Marks the existing TaxCode object at this URL as deleted. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this tax code. + * + * @param int $companyId The ID of the company that owns this tax code. * @param int $id The ID of the tax code you wish to delete. * @return ErrorDetail[] */ @@ -9030,24 +9030,24 @@ public function deleteTaxCode($companyId, $id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'DELETE', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'DELETE', $guzzleParams,'22.8.0' ); } /** * Retrieve a single tax code * - * Get the taxcode object identified by this URL. - * A 'TaxCode' represents a uniquely identified type of product, good, or service. - * Avalara supports correct tax rates and taxability rules for all TaxCodes in all supported jurisdictions. - * If you identify your products by tax code in your 'Create Transacion' API calls, Avalara will correctly calculate tax rates and - * taxability rules for this product in all supported jurisdictions. - * - * ### Security Policies - * + * Get the taxcode object identified by this URL. + * A 'TaxCode' represents a uniquely identified type of product, good, or service. + * Avalara supports correct tax rates and taxability rules for all TaxCodes in all supported jurisdictions. + * If you identify your products by tax code in your 'Create Transacion' API calls, Avalara will correctly calculate tax rates and + * taxability rules for this product in all supported jurisdictions. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this tax code + * + * @param int $companyId The ID of the company that owns this tax code * @param int $id The primary key of this tax code * @return TaxCodeModel */ @@ -9057,31 +9057,31 @@ public function getTaxCode($companyId, $id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve tax codes for this company * - * List all taxcode objects attached to this company. - * A 'TaxCode' represents a uniquely identified type of product, good, or service. - * Avalara supports correct tax rates and taxability rules for all TaxCodes in all supported jurisdictions. - * If you identify your products by tax code in your 'Create Transacion' API calls, Avalara will correctly calculate tax rates and - * taxability rules for this product in all supported jurisdictions. - * - * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . - * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. - * - * ### Security Policies - * + * List all taxcode objects attached to this company. + * A 'TaxCode' represents a uniquely identified type of product, good, or service. + * Avalara supports correct tax rates and taxability rules for all TaxCodes in all supported jurisdictions. + * If you identify your products by tax code in your 'Create Transacion' API calls, Avalara will correctly calculate tax rates and + * taxability rules for this product in all supported jurisdictions. + * + * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . + * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns these tax codes - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). - * @param string $include A comma separated list of additional data to retrieve. - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param int $companyId The ID of the company that owns these tax codes + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). + * @param string $include A comma separated list of additional data to retrieve. + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -9091,30 +9091,30 @@ public function listTaxCodesByCompany($companyId, $filter=null, $include=null, $ 'query' => ['$filter' => $filter, '$include' => $include, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve all tax codes * - * Get multiple taxcode objects across all companies. - * A 'TaxCode' represents a uniquely identified type of product, good, or service. - * Avalara supports correct tax rates and taxability rules for all TaxCodes in all supported jurisdictions. - * If you identify your products by tax code in your 'Create Transacion' API calls, Avalara will correctly calculate tax rates and - * taxability rules for this product in all supported jurisdictions. - * - * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . - * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. - * - * ### Security Policies - * + * Get multiple taxcode objects across all companies. + * A 'TaxCode' represents a uniquely identified type of product, good, or service. + * Avalara supports correct tax rates and taxability rules for all TaxCodes in all supported jurisdictions. + * If you identify your products by tax code in your 'Create Transacion' API calls, Avalara will correctly calculate tax rates and + * taxability rules for this product in all supported jurisdictions. + * + * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . + * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). - * @param string $include A comma separated list of additional data to retrieve. - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). + * @param string $include A comma separated list of additional data to retrieve. + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -9124,27 +9124,27 @@ public function queryTaxCodes($filter=null, $include=null, $top=null, $skip=null 'query' => ['$filter' => $filter, '$include' => $include, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Update a single tax code * - * Replace the existing taxcode object at this URL with an updated object. - * A 'TaxCode' represents a uniquely identified type of product, good, or service. - * Avalara supports correct tax rates and taxability rules for all TaxCodes in all supported jurisdictions. - * If you identify your products by tax code in your 'Create Transacion' API calls, Avalara will correctly calculate tax rates and - * taxability rules for this product in all supported jurisdictions. - * All data from the existing object will be replaced with data in the object you PUT. - * To set a field's value to null, you may either set its value to null or omit that field from the object you post. - * - * ### Security Policies - * + * Replace the existing taxcode object at this URL with an updated object. + * A 'TaxCode' represents a uniquely identified type of product, good, or service. + * Avalara supports correct tax rates and taxability rules for all TaxCodes in all supported jurisdictions. + * If you identify your products by tax code in your 'Create Transacion' API calls, Avalara will correctly calculate tax rates and + * taxability rules for this product in all supported jurisdictions. + * All data from the existing object will be replaced with data in the object you PUT. + * To set a field's value to null, you may either set its value to null or omit that field from the object you post. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that this tax code belongs to. - * @param int $id The ID of the tax code you wish to update + * + * @param int $companyId The ID of the company that this tax code belongs to. + * @param int $id The ID of the tax code you wish to update * @param TaxCodeModel $model The tax code you wish to update. * @return TaxCodeModel */ @@ -9154,42 +9154,42 @@ public function updateTaxCode($companyId, $id, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'PUT', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'PUT', $guzzleParams,'22.8.0' ); } /** * Build a multi-location tax content file * - * Builds a tax content file containing information useful for a retail point-of-sale solution. - * - * Since tax rates may change based on decisions made by a variety of tax authorities, we recommend - * that users of this tax content API download new data every day. Many tax authorities may finalize - * decisions on tax changes at unexpected times and may make changes in response to legal issues or - * governmental priorities. Any tax content downloaded for future time periods is subject to change - * if tax rates or tax laws change. - * - * A TaxContent file contains a matrix of the taxes that would be charged when you sell any of your - * Items at any of your Locations. To create items, use `CreateItems()`. To create locations, use - * `CreateLocations()`. The file is built by looking up the tax profile for your location and your - * item and calculating taxes for each in turn. To include a custom `TaxCode` in this tax content - * file, first create the custom tax code using `CreateTaxCodes()` to create the custom tax code, - * then use `CreateItems()` to create an item that uses the custom tax code. - * - * This data file can be customized for specific partner devices and usage conditions. - * - * The result of this API is the file you requested in the format you requested using the `responseType` field. - * - * This API builds the file on demand, and is limited to files with no more than 7500 scenarios. To build a tax content - * file for a single location at a time, please use `BuildTaxContentFileForLocation`. - * - * NOTE: This API does not work for Tennessee tax holiday scenarios. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. + * Builds a tax content file containing information useful for a retail point-of-sale solution. + * + * Since tax rates may change based on decisions made by a variety of tax authorities, we recommend + * that users of this tax content API download new data every day. Many tax authorities may finalize + * decisions on tax changes at unexpected times and may make changes in response to legal issues or + * governmental priorities. Any tax content downloaded for future time periods is subject to change + * if tax rates or tax laws change. + * + * A TaxContent file contains a matrix of the taxes that would be charged when you sell any of your + * Items at any of your Locations. To create items, use `CreateItems()`. To create locations, use + * `CreateLocations()`. The file is built by looking up the tax profile for your location and your + * item and calculating taxes for each in turn. To include a custom `TaxCode` in this tax content + * file, first create the custom tax code using `CreateTaxCodes()` to create the custom tax code, + * then use `CreateItems()` to create an item that uses the custom tax code. + * + * This data file can be customized for specific partner devices and usage conditions. + * + * The result of this API is the file you requested in the format you requested using the `responseType` field. + * + * This API builds the file on demand, and is limited to files with no more than 7500 scenarios. To build a tax content + * file for a single location at a time, please use `BuildTaxContentFileForLocation`. + * + * NOTE: This API does not work for Tennessee tax holiday scenarios. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * + * * @param PointOfSaleDataRequestModel $model Parameters about the desired file format and report format, specifying which company, locations and TaxCodes to include. * @return object */ @@ -9199,47 +9199,47 @@ public function buildTaxContentFile($model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Build a tax content file for a single location * - * Builds a tax content file containing information useful for a retail point-of-sale solution. - * - * Since tax rates may change based on decisions made by a variety of tax authorities, we recommend - * that users of this tax content API download new data every day. Many tax authorities may finalize - * decisions on tax changes at unexpected times and may make changes in response to legal issues or - * governmental priorities. Any tax content downloaded for future time periods is subject to change - * if tax rates or tax laws change. - * - * A TaxContent file contains a matrix of the taxes that would be charged when you sell any of your - * Items at any of your Locations. To create items, use `CreateItems()`. To create locations, use - * `CreateLocations()`. The file is built by looking up the tax profile for your location and your - * item and calculating taxes for each in turn. To include a custom `TaxCode` in this tax content - * file, first create the custom tax code using `CreateTaxCodes()` to create the custom tax code, - * then use `CreateItems()` to create an item that uses the custom tax code. - * - * This data file can be customized for specific partner devices and usage conditions. - * - * The result of this API is the file you requested in the format you requested using the `responseType` field. - * - * This API builds the file on demand, and is limited to files with no more than 7500 scenarios. To build a tax content - * file for a multiple locations in a single file, please use `BuildTaxContentFile`. - * - * NOTE: This API does not work for Tennessee tax holiday scenarios. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. + * Builds a tax content file containing information useful for a retail point-of-sale solution. + * + * Since tax rates may change based on decisions made by a variety of tax authorities, we recommend + * that users of this tax content API download new data every day. Many tax authorities may finalize + * decisions on tax changes at unexpected times and may make changes in response to legal issues or + * governmental priorities. Any tax content downloaded for future time periods is subject to change + * if tax rates or tax laws change. + * + * A TaxContent file contains a matrix of the taxes that would be charged when you sell any of your + * Items at any of your Locations. To create items, use `CreateItems()`. To create locations, use + * `CreateLocations()`. The file is built by looking up the tax profile for your location and your + * item and calculating taxes for each in turn. To include a custom `TaxCode` in this tax content + * file, first create the custom tax code using `CreateTaxCodes()` to create the custom tax code, + * then use `CreateItems()` to create an item that uses the custom tax code. + * + * This data file can be customized for specific partner devices and usage conditions. + * + * The result of this API is the file you requested in the format you requested using the `responseType` field. + * + * This API builds the file on demand, and is limited to files with no more than 7500 scenarios. To build a tax content + * file for a multiple locations in a single file, please use `BuildTaxContentFile`. + * + * NOTE: This API does not work for Tennessee tax holiday scenarios. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID number of the company that owns this location. - * @param int $id The ID number of the location to retrieve point-of-sale data. - * @param string $date The date for which point-of-sale data would be calculated (today by default) - * @param string $format The format of the file (JSON by default) (See PointOfSaleFileType::* for a list of allowable values) - * @param string $partnerId If specified, requests a custom partner-formatted version of the file. (See PointOfSalePartnerId::* for a list of allowable values) + * + * @param int $companyId The ID number of the company that owns this location. + * @param int $id The ID number of the location to retrieve point-of-sale data. + * @param string $date The date for which point-of-sale data would be calculated (today by default) + * @param string $format The format of the file (JSON by default) (See PointOfSaleFileType::* for a list of allowable values) + * @param string $partnerId If specified, requests a custom partner-formatted version of the file. (See PointOfSalePartnerId::* for a list of allowable values) * @param boolean $includeJurisCodes When true, the file will include jurisdiction codes in the result. * @return object */ @@ -9249,59 +9249,59 @@ public function buildTaxContentFileForLocation($companyId, $id, $date, $format, 'query' => ['date' => $date, 'format' => $format, 'partnerId' => $partnerId, 'includeJurisCodes' => $includeJurisCodes], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Download a file listing tax rates by postal code * - * Download a CSV file containing all five digit postal codes in the United States and their sales - * and use tax rates for tangible personal property. - * - * Since tax rates may change based on decisions made by a variety of tax authorities, we recommend - * that users of this tax content API download new data every day. Many tax authorities may finalize - * decisions on tax changes at unexpected times and may make changes in response to legal issues or - * governmental priorities. Any tax content downloaded for future time periods is subject to change - * if tax rates or tax laws change. - * - * This rates file is intended to be used as a default for tax calculation when your software cannot - * call the `CreateTransaction` API call. When using this file, your software will be unable to - * handle complex tax rules such as: - * - * * Zip+4 - This tax file contains five digit zip codes only. - * * Different product types - This tax file contains tangible personal property tax rates only. - * * Mixed sourcing - This tax file cannot be used to resolve origin-based taxes. - * * Threshold-based taxes - This tax file does not contain information about thresholds. - * - * If you use this file to provide default tax rates, please ensure that your software calls `CreateTransaction` - * to reconcile the actual transaction and determine the difference between the estimated general tax - * rate and the final transaction tax. - * - * The file provided by this API is in CSV format with the following columns: - * - * * ZIP_CODE - The five digit zip code for this record. - * * STATE_ABBREV - A valid two character US state abbreviation for this record. Zip codes may span multiple states. - * * COUNTY_NAME - A valid county name for this record. Zip codes may span multiple counties. - * * CITY_NAME - A valid city name for this record. Zip codes may span multiple cities. - * * STATE_SALES_TAX - The state component of the sales tax rate. - * * STATE_USE_TAX - The state component of the use tax rate. - * * COUNTY_SALES_TAX - The county component of the sales tax rate. - * * COUNTY_USE_TAX - The county component of the use tax rate. - * * CITY_SALES_TAX - The city component of the sales tax rate. - * * CITY_USE_TAX - The city component of the use tax rate. - * * TOTAL_SALES_TAX - The total tax rate for sales tax for this postal code. This value may not equal the sum of the state/county/city due to special tax jurisdiction rules. - * * TOTAL_USE_TAX - The total tax rate for use tax for this postal code. This value may not equal the sum of the state/county/city due to special tax jurisdiction rules. - * * TAX_SHIPPING_ALONE - This column contains 'Y' if shipping is taxable. - * * TAX_SHIPPING_AND_HANDLING_TOGETHER - This column contains 'Y' if shipping and handling are taxable when sent together. - * - * For more detailed tax content, please use the `BuildTaxContentFile` API which allows usage of exact items and exact locations. - * - * ### Security Policies - * + * Download a CSV file containing all five digit postal codes in the United States and their sales + * and use tax rates for tangible personal property. + * + * Since tax rates may change based on decisions made by a variety of tax authorities, we recommend + * that users of this tax content API download new data every day. Many tax authorities may finalize + * decisions on tax changes at unexpected times and may make changes in response to legal issues or + * governmental priorities. Any tax content downloaded for future time periods is subject to change + * if tax rates or tax laws change. + * + * This rates file is intended to be used as a default for tax calculation when your software cannot + * call the `CreateTransaction` API call. When using this file, your software will be unable to + * handle complex tax rules such as: + * + * * Zip+4 - This tax file contains five digit zip codes only. + * * Different product types - This tax file contains tangible personal property tax rates only. + * * Mixed sourcing - This tax file cannot be used to resolve origin-based taxes. + * * Threshold-based taxes - This tax file does not contain information about thresholds. + * + * If you use this file to provide default tax rates, please ensure that your software calls `CreateTransaction` + * to reconcile the actual transaction and determine the difference between the estimated general tax + * rate and the final transaction tax. + * + * The file provided by this API is in CSV format with the following columns: + * + * * ZIP_CODE - The five digit zip code for this record. + * * STATE_ABBREV - A valid two character US state abbreviation for this record. Zip codes may span multiple states. + * * COUNTY_NAME - A valid county name for this record. Zip codes may span multiple counties. + * * CITY_NAME - A valid city name for this record. Zip codes may span multiple cities. + * * STATE_SALES_TAX - The state component of the sales tax rate. + * * STATE_USE_TAX - The state component of the use tax rate. + * * COUNTY_SALES_TAX - The county component of the sales tax rate. + * * COUNTY_USE_TAX - The county component of the use tax rate. + * * CITY_SALES_TAX - The city component of the sales tax rate. + * * CITY_USE_TAX - The city component of the use tax rate. + * * TOTAL_SALES_TAX - The total tax rate for sales tax for this postal code. This value may not equal the sum of the state/county/city due to special tax jurisdiction rules. + * * TOTAL_USE_TAX - The total tax rate for use tax for this postal code. This value may not equal the sum of the state/county/city due to special tax jurisdiction rules. + * * TAX_SHIPPING_ALONE - This column contains 'Y' if shipping is taxable. + * * TAX_SHIPPING_AND_HANDLING_TOGETHER - This column contains 'Y' if shipping and handling are taxable when sent together. + * + * For more detailed tax content, please use the `BuildTaxContentFile` API which allows usage of exact items and exact locations. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * - * @param string $date The date for which point-of-sale data would be calculated (today by default). Example input: 2016-12-31 + * + * @param string $date The date for which point-of-sale data would be calculated (today by default). Example input: 2016-12-31 * @param string $region A two character region code which limits results to a specific region. * @return object */ @@ -9311,40 +9311,40 @@ public function downloadTaxRatesByZipCode($date, $region) { 'query' => ['region' => $region], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Sales tax rates for a specified address * - * Usage of this API is subject to rate limits. Users who exceed the rate limit will receive HTTP - * response code 429 - `Too Many Requests`. - * - * This API assumes that you are selling general tangible personal property at a retail point-of-sale - * location in the United States only. - * - * For more powerful tax calculation, please consider upgrading to the `CreateTransaction` API, - * which supports features including, but not limited to: - * - * * Nexus declarations - * * Taxability based on product/service type - * * Sourcing rules affecting origin/destination states - * * Customers who are exempt from certain taxes - * * States that have dollar value thresholds for tax amounts - * * Refunds for products purchased on a different date - * * Detailed jurisdiction names and state assigned codes - * * And more! - * - * Please see [Estimating Tax with REST v2](http://developer.avalara.com/blog/2016/11/04/estimating-tax-with-rest-v2/) + * Usage of this API is subject to rate limits. Users who exceed the rate limit will receive HTTP + * response code 429 - `Too Many Requests`. + * + * This API assumes that you are selling general tangible personal property at a retail point-of-sale + * location in the United States only. + * + * For more powerful tax calculation, please consider upgrading to the `CreateTransaction` API, + * which supports features including, but not limited to: + * + * * Nexus declarations + * * Taxability based on product/service type + * * Sourcing rules affecting origin/destination states + * * Customers who are exempt from certain taxes + * * States that have dollar value thresholds for tax amounts + * * Refunds for products purchased on a different date + * * Detailed jurisdiction names and state assigned codes + * * And more! + * + * Please see [Estimating Tax with REST v2](http://developer.avalara.com/blog/2016/11/04/estimating-tax-with-rest-v2/) * for information on how to upgrade to the full AvaTax CreateTransaction API. * Swagger Name: AvaTaxClient - * - * @param string $line1 The street address of the location. - * @param string $line2 The street address of the location. - * @param string $line3 The street address of the location. - * @param string $city The city name of the location. - * @param string $region Name or ISO 3166 code identifying the region within the country. This field supports many different region identifiers: * Two and three character ISO 3166 region codes * Fully spelled out names of the region in ISO supported languages * Common alternative spellings for many regions For a full list of all supported codes and names, please see the Definitions API `ListRegions`. - * @param string $postalCode The postal code of the location. + * + * @param string $line1 The street address of the location. + * @param string $line2 The street address of the location. + * @param string $line3 The street address of the location. + * @param string $city The city name of the location. + * @param string $region Name or ISO 3166 code identifying the region within the country. This field supports many different region identifiers: * Two and three character ISO 3166 region codes * Fully spelled out names of the region in ISO supported languages * Common alternative spellings for many regions For a full list of all supported codes and names, please see the Definitions API `ListRegions`. + * @param string $postalCode The postal code of the location. * @param string $country Name or ISO 3166 code identifying the country. This field supports many different country identifiers: * Two character ISO 3166 codes * Three character ISO 3166 codes * Fully spelled out names of the country in ISO supported languages * Common alternative spellings for many countries For a full list of all supported codes and names, please see the Definitions API `ListCountries`. * @return TaxRateModel */ @@ -9354,37 +9354,37 @@ public function taxRatesByAddress($line1, $line2, $line3, $city, $region, $posta 'query' => ['line1' => $line1, 'line2' => $line2, 'line3' => $line3, 'city' => $city, 'region' => $region, 'postalCode' => $postalCode, 'country' => $country], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Sales tax rates for a specified country and postal code. This API is only available for US postal codes. * - * This API is only available for a US postal codes. - * - * Usage of this API is subject to rate limits. Users who exceed the rate limit will receive HTTP - * response code 429 - `Too Many Requests`. - * - * This API assumes that you are selling general tangible personal property at a retail point-of-sale - * location in the United States only. - * - * For more powerful tax calculation, please consider upgrading to the `CreateTransaction` API, - * which supports features including, but not limited to: - * - * * Nexus declarations - * * Taxability based on product/service type - * * Sourcing rules affecting origin/destination states - * * Customers who are exempt from certain taxes - * * States that have dollar value thresholds for tax amounts - * * Refunds for products purchased on a different date - * * Detailed jurisdiction names and state assigned codes - * * And more! - * - * Please see [Estimating Tax with REST v2](http://developer.avalara.com/blog/2016/11/04/estimating-tax-with-rest-v2/) + * This API is only available for a US postal codes. + * + * Usage of this API is subject to rate limits. Users who exceed the rate limit will receive HTTP + * response code 429 - `Too Many Requests`. + * + * This API assumes that you are selling general tangible personal property at a retail point-of-sale + * location in the United States only. + * + * For more powerful tax calculation, please consider upgrading to the `CreateTransaction` API, + * which supports features including, but not limited to: + * + * * Nexus declarations + * * Taxability based on product/service type + * * Sourcing rules affecting origin/destination states + * * Customers who are exempt from certain taxes + * * States that have dollar value thresholds for tax amounts + * * Refunds for products purchased on a different date + * * Detailed jurisdiction names and state assigned codes + * * And more! + * + * Please see [Estimating Tax with REST v2](http://developer.avalara.com/blog/2016/11/04/estimating-tax-with-rest-v2/) * for information on how to upgrade to the full AvaTax CreateTransaction API. * Swagger Name: AvaTaxClient - * - * @param string $country Name or ISO 3166 code identifying the country. This field supports many different country identifiers: * Two character ISO 3166 codes * Three character ISO 3166 codes * Fully spelled out names of the country in ISO supported languages * Common alternative spellings for many countries For a full list of all supported codes and names, please see the Definitions API `ListCountries`. + * + * @param string $country Name or ISO 3166 code identifying the country. This field supports many different country identifiers: * Two character ISO 3166 codes * Three character ISO 3166 codes * Fully spelled out names of the country in ISO supported languages * Common alternative spellings for many countries For a full list of all supported codes and names, please see the Definitions API `ListCountries`. * @param string $postalCode The postal code of the location. * @return TaxRateModel */ @@ -9394,32 +9394,32 @@ public function taxRatesByPostalCode($country, $postalCode) { 'query' => ['country' => $country, 'postalCode' => $postalCode], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Create a new tax rule * - * Create one or more custom tax rules attached to this company. - * - * A tax rule represents a rule that changes the default AvaTax behavior for a product or jurisdiction. Custom tax rules - * can be used to change the taxability of an item, to change the tax base of an item, or to change the tax rate - * charged when selling an item. Tax rules can also change tax behavior depending on the `entityUseCode` value submitted - * with the transaction. - * - * You can create custom tax rules to customize the behavior of AvaTax to match specific rules that are custom to your - * business. If you have obtained a ruling from a tax auditor that requires custom tax calculations, you can use - * custom tax rules to redefine the behavior for your company or item. - * - * Please use custom tax rules carefully and ensure that these tax rules match the behavior agreed upon with your - * auditor, legal representative, and accounting team. - * - * ### Security Policies - * + * Create one or more custom tax rules attached to this company. + * + * A tax rule represents a rule that changes the default AvaTax behavior for a product or jurisdiction. Custom tax rules + * can be used to change the taxability of an item, to change the tax base of an item, or to change the tax rate + * charged when selling an item. Tax rules can also change tax behavior depending on the `entityUseCode` value submitted + * with the transaction. + * + * You can create custom tax rules to customize the behavior of AvaTax to match specific rules that are custom to your + * business. If you have obtained a ruling from a tax auditor that requires custom tax calculations, you can use + * custom tax rules to redefine the behavior for your company or item. + * + * Please use custom tax rules carefully and ensure that these tax rules match the behavior agreed upon with your + * auditor, legal representative, and accounting team. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this tax rule. + * + * @param int $companyId The ID of the company that owns this tax rule. * @param TaxRuleModel[] $model The tax rule you wish to create. * @return TaxRuleModel[] */ @@ -9429,32 +9429,32 @@ public function createTaxRules($companyId, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Delete a single tax rule * - * Mark the custom tax rule identified by this URL as deleted. - * - * A tax rule represents a rule that changes the default AvaTax behavior for a product or jurisdiction. Custom tax rules - * can be used to change the taxability of an item, to change the tax base of an item, or to change the tax rate - * charged when selling an item. Tax rules can also change tax behavior depending on the `entityUseCode` value submitted - * with the transaction. - * - * You can create custom tax rules to customize the behavior of AvaTax to match specific rules that are custom to your - * business. If you have obtained a ruling from a tax auditor that requires custom tax calculations, you can use - * custom tax rules to redefine the behavior for your company or item. - * - * Please use custom tax rules carefully and ensure that these tax rules match the behavior agreed upon with your - * auditor, legal representative, and accounting team. - * - * ### Security Policies - * + * Mark the custom tax rule identified by this URL as deleted. + * + * A tax rule represents a rule that changes the default AvaTax behavior for a product or jurisdiction. Custom tax rules + * can be used to change the taxability of an item, to change the tax base of an item, or to change the tax rate + * charged when selling an item. Tax rules can also change tax behavior depending on the `entityUseCode` value submitted + * with the transaction. + * + * You can create custom tax rules to customize the behavior of AvaTax to match specific rules that are custom to your + * business. If you have obtained a ruling from a tax auditor that requires custom tax calculations, you can use + * custom tax rules to redefine the behavior for your company or item. + * + * Please use custom tax rules carefully and ensure that these tax rules match the behavior agreed upon with your + * auditor, legal representative, and accounting team. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this tax rule. + * + * @param int $companyId The ID of the company that owns this tax rule. * @param int $id The ID of the tax rule you wish to delete. * @return ErrorDetail[] */ @@ -9464,32 +9464,32 @@ public function deleteTaxRule($companyId, $id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'DELETE', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'DELETE', $guzzleParams,'22.8.0' ); } /** * Retrieve a single tax rule * - * Get the taxrule object identified by this URL. - * - * A tax rule represents a rule that changes the default AvaTax behavior for a product or jurisdiction. Custom tax rules - * can be used to change the taxability of an item, to change the tax base of an item, or to change the tax rate - * charged when selling an item. Tax rules can also change tax behavior depending on the `entityUseCode` value submitted - * with the transaction. - * - * You can create custom tax rules to customize the behavior of AvaTax to match specific rules that are custom to your - * business. If you have obtained a ruling from a tax auditor that requires custom tax calculations, you can use - * custom tax rules to redefine the behavior for your company or item. - * - * Please use custom tax rules carefully and ensure that these tax rules match the behavior agreed upon with your - * auditor, legal representative, and accounting team. - * - * ### Security Policies - * + * Get the taxrule object identified by this URL. + * + * A tax rule represents a rule that changes the default AvaTax behavior for a product or jurisdiction. Custom tax rules + * can be used to change the taxability of an item, to change the tax base of an item, or to change the tax rate + * charged when selling an item. Tax rules can also change tax behavior depending on the `entityUseCode` value submitted + * with the transaction. + * + * You can create custom tax rules to customize the behavior of AvaTax to match specific rules that are custom to your + * business. If you have obtained a ruling from a tax auditor that requires custom tax calculations, you can use + * custom tax rules to redefine the behavior for your company or item. + * + * Please use custom tax rules carefully and ensure that these tax rules match the behavior agreed upon with your + * auditor, legal representative, and accounting team. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this tax rule + * + * @param int $companyId The ID of the company that owns this tax rule * @param int $id The primary key of this tax rule * @return TaxRuleModel */ @@ -9499,39 +9499,39 @@ public function getTaxRule($companyId, $id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve tax rules for this company * - * List all taxrule objects attached to this company. - * - * A tax rule represents a rule that changes the default AvaTax behavior for a product or jurisdiction. Custom tax rules - * can be used to change the taxability of an item, to change the tax base of an item, or to change the tax rate - * charged when selling an item. Tax rules can also change tax behavior depending on the `entityUseCode` value submitted - * with the transaction. - * - * You can create custom tax rules to customize the behavior of AvaTax to match specific rules that are custom to your - * business. If you have obtained a ruling from a tax auditor that requires custom tax calculations, you can use - * custom tax rules to redefine the behavior for your company or item. - * - * Please use custom tax rules carefully and ensure that these tax rules match the behavior agreed upon with your - * auditor, legal representative, and accounting team. - * - * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . - * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. - * - * ### Security Policies - * + * List all taxrule objects attached to this company. + * + * A tax rule represents a rule that changes the default AvaTax behavior for a product or jurisdiction. Custom tax rules + * can be used to change the taxability of an item, to change the tax base of an item, or to change the tax rate + * charged when selling an item. Tax rules can also change tax behavior depending on the `entityUseCode` value submitted + * with the transaction. + * + * You can create custom tax rules to customize the behavior of AvaTax to match specific rules that are custom to your + * business. If you have obtained a ruling from a tax auditor that requires custom tax calculations, you can use + * custom tax rules to redefine the behavior for your company or item. + * + * Please use custom tax rules carefully and ensure that these tax rules match the behavior agreed upon with your + * auditor, legal representative, and accounting team. + * + * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . + * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns these tax rules - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* taxCode, taxTypeCode, taxRuleProductDetail, rateTypeCode, taxTypeGroup, taxSubType, unitOfBasis - * @param string $include A comma separated list of additional data to retrieve. - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param int $companyId The ID of the company that owns these tax rules + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* taxCode, taxTypeCode, taxRuleProductDetail, rateTypeCode, taxTypeGroup, taxSubType, unitOfBasis + * @param string $include A comma separated list of additional data to retrieve. + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -9541,38 +9541,38 @@ public function listTaxRules($companyId, $filter=null, $include=null, $top=null, 'query' => ['$filter' => $filter, '$include' => $include, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve all tax rules * - * Get multiple taxrule objects across all companies. - * - * A tax rule represents a rule that changes the default AvaTax behavior for a product or jurisdiction. Custom tax rules - * can be used to change the taxability of an item, to change the tax base of an item, or to change the tax rate - * charged when selling an item. Tax rules can also change tax behavior depending on the `entityUseCode` value submitted - * with the transaction. - * - * You can create custom tax rules to customize the behavior of AvaTax to match specific rules that are custom to your - * business. If you have obtained a ruling from a tax auditor that requires custom tax calculations, you can use - * custom tax rules to redefine the behavior for your company or item. - * - * Please use custom tax rules carefully and ensure that these tax rules match the behavior agreed upon with your - * auditor, legal representative, and accounting team. - * - * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . - * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. - * - * ### Security Policies - * + * Get multiple taxrule objects across all companies. + * + * A tax rule represents a rule that changes the default AvaTax behavior for a product or jurisdiction. Custom tax rules + * can be used to change the taxability of an item, to change the tax base of an item, or to change the tax rate + * charged when selling an item. Tax rules can also change tax behavior depending on the `entityUseCode` value submitted + * with the transaction. + * + * You can create custom tax rules to customize the behavior of AvaTax to match specific rules that are custom to your + * business. If you have obtained a ruling from a tax auditor that requires custom tax calculations, you can use + * custom tax rules to redefine the behavior for your company or item. + * + * Please use custom tax rules carefully and ensure that these tax rules match the behavior agreed upon with your + * auditor, legal representative, and accounting team. + * + * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . + * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* taxCode, taxTypeCode, taxRuleProductDetail, rateTypeCode, taxTypeGroup, taxSubType, unitOfBasis - * @param string $include A comma separated list of additional data to retrieve. - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* taxCode, taxTypeCode, taxRuleProductDetail, rateTypeCode, taxTypeGroup, taxSubType, unitOfBasis + * @param string $include A comma separated list of additional data to retrieve. + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -9582,33 +9582,33 @@ public function queryTaxRules($filter=null, $include=null, $top=null, $skip=null 'query' => ['$filter' => $filter, '$include' => $include, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Update a single tax rule * - * Replace the existing custom tax rule object at this URL with an updated object. - * - * A tax rule represents a rule that changes the default AvaTax behavior for a product or jurisdiction. Custom tax rules - * can be used to change the taxability of an item, to change the tax base of an item, or to change the tax rate - * charged when selling an item. Tax rules can also change tax behavior depending on the `entityUseCode` value submitted - * with the transaction. - * - * You can create custom tax rules to customize the behavior of AvaTax to match specific rules that are custom to your - * business. If you have obtained a ruling from a tax auditor that requires custom tax calculations, you can use - * custom tax rules to redefine the behavior for your company or item. - * - * Please use custom tax rules carefully and ensure that these tax rules match the behavior agreed upon with your - * auditor, legal representative, and accounting team. - * - * ### Security Policies - * + * Replace the existing custom tax rule object at this URL with an updated object. + * + * A tax rule represents a rule that changes the default AvaTax behavior for a product or jurisdiction. Custom tax rules + * can be used to change the taxability of an item, to change the tax base of an item, or to change the tax rate + * charged when selling an item. Tax rules can also change tax behavior depending on the `entityUseCode` value submitted + * with the transaction. + * + * You can create custom tax rules to customize the behavior of AvaTax to match specific rules that are custom to your + * business. If you have obtained a ruling from a tax auditor that requires custom tax calculations, you can use + * custom tax rules to redefine the behavior for your company or item. + * + * Please use custom tax rules carefully and ensure that these tax rules match the behavior agreed upon with your + * auditor, legal representative, and accounting team. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that this tax rule belongs to. - * @param int $id The ID of the tax rule you wish to update + * + * @param int $companyId The ID of the company that this tax rule belongs to. + * @param int $id The ID of the tax rule you wish to update * @param TaxRuleModel $model The tax rule you wish to update. * @return TaxRuleModel */ @@ -9618,40 +9618,40 @@ public function updateTaxRule($companyId, $id, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'PUT', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'PUT', $guzzleParams,'22.8.0' ); } /** * Add lines to an existing unlocked transaction * - * Add lines to an existing unlocked transaction. - * - * The `AddLines` API allows you to add additional transaction lines to existing transaction, so that customer will - * be able to append multiple calls together and form an extremely large transaction. If customer does not specify line number - * in the lines to be added, a new random Guid string will be generated for line number. If customer are not satisfied with - * the line number for the transaction lines, they can turn on the renumber switch to have REST v2 automatically renumber all - * transaction lines for them, in this case, the line number becomes: "1", "2", "3", ... - * - * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like - * sales, purchases, inventory transfer, and returns (also called refunds). - * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: - * - * * Lines - * * Details (implies lines) - * * Summary (implies details) - * * Addresses - * * SummaryOnly (omit lines and details - reduces API response size) - * * LinesOnly (omit details - reduces API response size) - * - * If you omit the `$include` parameter, the API will assume you want `Summary,Addresses`. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * Add lines to an existing unlocked transaction. + * + * The `AddLines` API allows you to add additional transaction lines to existing transaction, so that customer will + * be able to append multiple calls together and form an extremely large transaction. If customer does not specify line number + * in the lines to be added, a new random Guid string will be generated for line number. If customer are not satisfied with + * the line number for the transaction lines, they can turn on the renumber switch to have REST v2 automatically renumber all + * transaction lines for them, in this case, the line number becomes: "1", "2", "3", ... + * + * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like + * sales, purchases, inventory transfer, and returns (also called refunds). + * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: + * + * * Lines + * * Details (implies lines) + * * Summary (implies details) + * * Addresses + * * SummaryOnly (omit lines and details - reduces API response size) + * * LinesOnly (omit details - reduces API response size) + * + * If you omit the `$include` parameter, the API will assume you want `Summary,Addresses`. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro, BasicReturns. * Swagger Name: AvaTaxClient - * - * @param string $include Specifies objects to include in the response after transaction is created + * + * @param string $include Specifies objects to include in the response after transaction is created * @param AddTransactionLineModel $model information about the transaction and lines to be added * @return TransactionModel */ @@ -9661,52 +9661,52 @@ public function addLines($include=null, $model=null) { 'query' => ['$include' => $include], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Correct a previously created transaction * - * Replaces the current transaction uniquely identified by this URL with a new transaction. - * - * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like - * sales, purchases, inventory transfer, and returns (also called refunds). - * - * When you adjust a committed transaction, the original transaction will be updated with the status code `Adjusted`, and - * both revisions will be available for retrieval based on their code and ID numbers. - * Only transactions in `Committed` status are reported by Avalara Managed Returns. - * - * Transactions that have been previously reported to a tax authority by Avalara Managed Returns are considered `locked` and are - * no longer available for adjustments. - * - * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: - * - * * Lines - * * Details (implies lines) - * * Summary (implies details) - * * Addresses - * * SummaryOnly (omit lines and details - reduces API response size) - * * LinesOnly (omit details - reduces API response size) - * * TaxDetailsByTaxType - Includes the aggregated tax, exempt tax, taxable and non-taxable for each tax type returned in the transaction summary. - * - * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: - * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code - * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code - * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code - * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code - * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code - * * Replace ' ' with '%20' For example: document Code becomes document%20Code - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * Replaces the current transaction uniquely identified by this URL with a new transaction. + * + * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like + * sales, purchases, inventory transfer, and returns (also called refunds). + * + * When you adjust a committed transaction, the original transaction will be updated with the status code `Adjusted`, and + * both revisions will be available for retrieval based on their code and ID numbers. + * Only transactions in `Committed` status are reported by Avalara Managed Returns. + * + * Transactions that have been previously reported to a tax authority by Avalara Managed Returns are considered `locked` and are + * no longer available for adjustments. + * + * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: + * + * * Lines + * * Details (implies lines) + * * Summary (implies details) + * * Addresses + * * SummaryOnly (omit lines and details - reduces API response size) + * * LinesOnly (omit details - reduces API response size) + * * TaxDetailsByTaxType - Includes the aggregated tax, exempt tax, taxable and non-taxable for each tax type returned in the transaction summary. + * + * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: + * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code + * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code + * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code + * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code + * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code + * * Replace ' ' with '%20' For example: document Code becomes document%20Code + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro, BasicReturns. * Swagger Name: AvaTaxClient - * - * @param string $companyCode The company code of the company that recorded this transaction - * @param string $transactionCode The transaction code to adjust - * @param string $documentType (Optional): The document type of the transaction to adjust. (See DocumentType::* for a list of allowable values) - * @param string $include Specifies objects to include in this fetch call + * + * @param string $companyCode The company code of the company that recorded this transaction + * @param string $transactionCode The transaction code to adjust + * @param string $documentType (Optional): The document type of the transaction to adjust. (See DocumentType::* for a list of allowable values) + * @param string $include Specifies objects to include in this fetch call * @param AdjustTransactionModel $model The adjustment you wish to make * @return TransactionModel */ @@ -9716,43 +9716,43 @@ public function adjustTransaction($companyCode, $transactionCode, $documentType, 'query' => ['documentType' => $documentType, '$include' => $include], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Get audit information about a transaction * - * Retrieve audit information about a transaction stored in AvaTax. - * - * The `AuditTransaction` API retrieves audit information related to a specific transaction. This audit - * information includes the following: - * - * * The `CompanyId` of the company that created the transaction - * * The server timestamp representing the exact server time when the transaction was created - * * The server duration - how long it took to process this transaction - * * Whether exact API call details were logged - * * A reconstructed API call showing what the original CreateTransaction call looked like - * - * This API can be used to examine information about a previously created transaction. - * - * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like - * sales, purchases, inventory transfer, and returns (also called refunds). - * - * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: - * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code - * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code - * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code - * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code - * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code - * * Replace ' ' with '%20' For example: document Code becomes document%20Code - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * Retrieve audit information about a transaction stored in AvaTax. + * + * The `AuditTransaction` API retrieves audit information related to a specific transaction. This audit + * information includes the following: + * + * * The `CompanyId` of the company that created the transaction + * * The server timestamp representing the exact server time when the transaction was created + * * The server duration - how long it took to process this transaction + * * Whether exact API call details were logged + * * A reconstructed API call showing what the original CreateTransaction call looked like + * + * This API can be used to examine information about a previously created transaction. + * + * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like + * sales, purchases, inventory transfer, and returns (also called refunds). + * + * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: + * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code + * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code + * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code + * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code + * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code + * * Replace ' ' with '%20' For example: document Code becomes document%20Code + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro, BasicReturns. * Swagger Name: AvaTaxClient - * - * @param string $companyCode The code identifying the company that owns this transaction + * + * @param string $companyCode The code identifying the company that owns this transaction * @param string $transactionCode The code identifying the transaction * @return AuditTransactionModel */ @@ -9762,44 +9762,44 @@ public function auditTransaction($companyCode, $transactionCode) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Get audit information about a transaction * - * Retrieve audit information about a transaction stored in AvaTax. - * - * The `AuditTransaction` API retrieves audit information related to a specific transaction. This audit - * information includes the following: - * - * * The `CompanyId` of the company that created the transaction - * * The server timestamp representing the exact server time when the transaction was created - * * The server duration - how long it took to process this transaction - * * Whether exact API call details were logged - * * A reconstructed API call showing what the original CreateTransaction call looked like - * - * This API can be used to examine information about a previously created transaction. - * - * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like - * sales, purchases, inventory transfer, and returns (also called refunds). - * - * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: - * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code - * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code - * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code - * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code - * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code - * * Replace ' ' with '%20' For example: document Code becomes document%20Code - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * Retrieve audit information about a transaction stored in AvaTax. + * + * The `AuditTransaction` API retrieves audit information related to a specific transaction. This audit + * information includes the following: + * + * * The `CompanyId` of the company that created the transaction + * * The server timestamp representing the exact server time when the transaction was created + * * The server duration - how long it took to process this transaction + * * Whether exact API call details were logged + * * A reconstructed API call showing what the original CreateTransaction call looked like + * + * This API can be used to examine information about a previously created transaction. + * + * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like + * sales, purchases, inventory transfer, and returns (also called refunds). + * + * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: + * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code + * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code + * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code + * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code + * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code + * * Replace ' ' with '%20' For example: document Code becomes document%20Code + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro, BasicReturns. * Swagger Name: AvaTaxClient - * - * @param string $companyCode The code identifying the company that owns this transaction - * @param string $transactionCode The code identifying the transaction + * + * @param string $companyCode The code identifying the company that owns this transaction + * @param string $transactionCode The code identifying the transaction * @param string $documentType The document type of the original transaction (See DocumentType::* for a list of allowable values) * @return AuditTransactionModel */ @@ -9809,26 +9809,26 @@ public function auditTransactionWithType($companyCode, $transactionCode, $docume 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Lock a set of documents * - * This API is available by invitation only. - * - * Lock a set of transactions uniquely identified by DocumentIds provided. This API allows locking multiple documents at once. - * After this API call succeeds, documents will be locked and can't be voided. - * - * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like - * sales, purchases, inventory transfer, and returns (also called refunds). - * - * ### Security Policies - * - * * This API requires the user role Compliance Root User. + * This API is available by invitation only. + * + * Lock a set of transactions uniquely identified by DocumentIds provided. This API allows locking multiple documents at once. + * After this API call succeeds, documents will be locked and can't be voided. + * + * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like + * sales, purchases, inventory transfer, and returns (also called refunds). + * + * ### Security Policies + * + * * This API requires the user role Compliance Root User. * * This API depends on the following active services:*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged. * Swagger Name: AvaTaxClient - * + * * @param BulkLockTransactionModel $model bulk lock request * @return BulkLockTransactionResult */ @@ -9838,52 +9838,52 @@ public function bulkLockTransaction($model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Change a transaction's code * - * Renames a transaction uniquely identified by this URL by changing its `code` value. - * - * This API is available as long as the transaction is in `saved` or `posted` status. When a transaction - * is `committed`, it can be modified by using the [AdjustTransaction](https://developer.avalara.com/api-reference/avatax/rest/v2/methods/Transactions/AdjustTransaction/) method. - * - * After this API call succeeds, the transaction will have a new URL matching its new `code`. - * - * If you have more than one document with the same `code`, specify the `documentType` parameter to choose between them. - * - * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like - * sales, purchases, inventory transfer, and returns (also called refunds). - * - * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: - * - * * Lines - * * Details (implies lines) - * * Summary (implies details) - * * Addresses - * * SummaryOnly (omit lines and details - reduces API response size) - * * LinesOnly (omit details - reduces API response size) - * * TaxDetailsByTaxType - Includes the aggregated tax, exempt tax, taxable and non-taxable for each tax type returned in the transaction summary. - * - * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: - * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code - * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code - * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code - * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code - * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code - * * Replace ' ' with '%20' For example: document Code becomes document%20Code - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, ProStoresOperator, SSTAdmin, TechnicalSupportAdmin. + * Renames a transaction uniquely identified by this URL by changing its `code` value. + * + * This API is available as long as the transaction is in `saved` or `posted` status. When a transaction + * is `committed`, it can be modified by using the [AdjustTransaction](https://developer.avalara.com/api-reference/avatax/rest/v2/methods/Transactions/AdjustTransaction/) method. + * + * After this API call succeeds, the transaction will have a new URL matching its new `code`. + * + * If you have more than one document with the same `code`, specify the `documentType` parameter to choose between them. + * + * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like + * sales, purchases, inventory transfer, and returns (also called refunds). + * + * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: + * + * * Lines + * * Details (implies lines) + * * Summary (implies details) + * * Addresses + * * SummaryOnly (omit lines and details - reduces API response size) + * * LinesOnly (omit details - reduces API response size) + * * TaxDetailsByTaxType - Includes the aggregated tax, exempt tax, taxable and non-taxable for each tax type returned in the transaction summary. + * + * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: + * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code + * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code + * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code + * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code + * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code + * * Replace ' ' with '%20' For example: document Code becomes document%20Code + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, ProStoresOperator, SSTAdmin, TechnicalSupportAdmin. * * This API depends on the following active services:*Required* (all): AvaTaxPro, BasicReturns. * Swagger Name: AvaTaxClient - * - * @param string $companyCode The company code of the company that recorded this transaction - * @param string $transactionCode The transaction code to change - * @param string $documentType (Optional): The document type of the transaction to change document code. If not provided, the default is SalesInvoice. (See DocumentType::* for a list of allowable values) - * @param string $include Specifies objects to include in this fetch call + * + * @param string $companyCode The company code of the company that recorded this transaction + * @param string $transactionCode The transaction code to change + * @param string $documentType (Optional): The document type of the transaction to change document code. If not provided, the default is SalesInvoice. (See DocumentType::* for a list of allowable values) + * @param string $include Specifies objects to include in this fetch call * @param ChangeTransactionCodeModel $model The code change request you wish to execute * @return TransactionModel */ @@ -9893,50 +9893,50 @@ public function changeTransactionCode($companyCode, $transactionCode, $documentT 'query' => ['documentType' => $documentType, '$include' => $include], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Commit a transaction for reporting * - * Marks a transaction by changing its status to `Committed`. - * - * Transactions that are committed are available to be reported to a tax authority by Avalara Managed Returns. - * - * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like - * sales, purchases, inventory transfer, and returns (also called refunds). - * - * If you have more than one document with the same `code`, specify the `documentType` parameter to choose between them. - * - * Any changes made to a committed transaction will generate a transaction history. - * - * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: - * - * * Lines - * * Details (implies lines) - * * Summary (implies details) - * * Addresses - * * SummaryOnly (omit lines and details - reduces API response size) - * * LinesOnly (omit details - reduces API response size) - * * TaxDetailsByTaxType - Includes the aggregated tax, exempt tax, taxable and non-taxable for each tax type returned in the transaction summary. - * - * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: - * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code - * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code - * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code - * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code - * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code - * * Replace ' ' with '%20' For example: document Code becomes document%20Code - * - * ### Security Policies - * + * Marks a transaction by changing its status to `Committed`. + * + * Transactions that are committed are available to be reported to a tax authority by Avalara Managed Returns. + * + * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like + * sales, purchases, inventory transfer, and returns (also called refunds). + * + * If you have more than one document with the same `code`, specify the `documentType` parameter to choose between them. + * + * Any changes made to a committed transaction will generate a transaction history. + * + * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: + * + * * Lines + * * Details (implies lines) + * * Summary (implies details) + * * Addresses + * * SummaryOnly (omit lines and details - reduces API response size) + * * LinesOnly (omit details - reduces API response size) + * * TaxDetailsByTaxType - Includes the aggregated tax, exempt tax, taxable and non-taxable for each tax type returned in the transaction summary. + * + * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: + * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code + * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code + * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code + * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code + * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code + * * Replace ' ' with '%20' For example: document Code becomes document%20Code + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, ProStoresOperator, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param string $companyCode The company code of the company that recorded this transaction - * @param string $transactionCode The transaction code to commit - * @param string $documentType (Optional): The document type of the transaction to commit. If not provided, the default is SalesInvoice. (See DocumentType::* for a list of allowable values) - * @param string $include Specifies objects to include in this fetch call + * + * @param string $companyCode The company code of the company that recorded this transaction + * @param string $transactionCode The transaction code to commit + * @param string $documentType (Optional): The document type of the transaction to commit. If not provided, the default is SalesInvoice. (See DocumentType::* for a list of allowable values) + * @param string $include Specifies objects to include in this fetch call * @param CommitTransactionModel $model The commit request you wish to execute * @return TransactionModel */ @@ -9946,53 +9946,53 @@ public function commitTransaction($companyCode, $transactionCode, $documentType, 'query' => ['documentType' => $documentType, '$include' => $include], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Create or adjust a transaction * - * Records a new transaction or adjust an existing transaction in AvaTax. - * - * The `CreateOrAdjustTransaction` endpoint is used to create a new transaction or update an existing one. This API - * can help you create an idempotent service that creates transactions - * If there exists a transaction identified by code, the original transaction will be adjusted by using the meta data - * in the input transaction. - * - * The `CreateOrAdjustTransaction` API cannot modify any transaction that has been reported to a tax authority using - * the Avalara Managed Returns Service or any other tax filing service. If you call this API to attempt to modify - * a transaction that has been reported on a tax filing, you will receive the error `CannotModifyLockedTransaction`. - * - * To generate a refund for a transaction, use the `RefundTransaction` API. - * - * If you don't specify the field `type` in your request, you will get an estimate of type `SalesOrder`, which will not be recorded in the database. - * - * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like - * sales, purchases, inventory transfer, and returns (also called refunds). - * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: - * - * * Lines - * * Details (implies lines) - * * Summary (implies details) - * * Addresses - * * SummaryOnly (omit lines and details - reduces API response size) - * * LinesOnly (omit details - reduces API response size) - * * ForceTimeout - Simulates a timeout. This adds a 30 second delay and error to your API call. This can be used to test your code to ensure it can respond correctly in the case of a dropped connection. - * - * If you omit the `$include` parameter, the API will assume you want `Summary,Addresses`. - * - * NOTE: Avoid using the following strings in your transaction codes as they are encoding strings and will be interpreted differently: - * * \_-ava2f-\_ - * * \_-ava2b-\_ - * * \_-ava3f-\_ - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * Records a new transaction or adjust an existing transaction in AvaTax. + * + * The `CreateOrAdjustTransaction` endpoint is used to create a new transaction or update an existing one. This API + * can help you create an idempotent service that creates transactions + * If there exists a transaction identified by code, the original transaction will be adjusted by using the meta data + * in the input transaction. + * + * The `CreateOrAdjustTransaction` API cannot modify any transaction that has been reported to a tax authority using + * the Avalara Managed Returns Service or any other tax filing service. If you call this API to attempt to modify + * a transaction that has been reported on a tax filing, you will receive the error `CannotModifyLockedTransaction`. + * + * To generate a refund for a transaction, use the `RefundTransaction` API. + * + * If you don't specify the field `type` in your request, you will get an estimate of type `SalesOrder`, which will not be recorded in the database. + * + * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like + * sales, purchases, inventory transfer, and returns (also called refunds). + * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: + * + * * Lines + * * Details (implies lines) + * * Summary (implies details) + * * Addresses + * * SummaryOnly (omit lines and details - reduces API response size) + * * LinesOnly (omit details - reduces API response size) + * * ForceTimeout - Simulates a timeout. This adds a 30 second delay and error to your API call. This can be used to test your code to ensure it can respond correctly in the case of a dropped connection. + * + * If you omit the `$include` parameter, the API will assume you want `Summary,Addresses`. + * + * NOTE: Avoid using the following strings in your transaction codes as they are encoding strings and will be interpreted differently: + * * \_-ava2f-\_ + * * \_-ava2b-\_ + * * \_-ava3f-\_ + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro, BasicReturns. * Swagger Name: AvaTaxClient - * - * @param string $include Specifies objects to include in the response after transaction is created + * + * @param string $include Specifies objects to include in the response after transaction is created * @param CreateOrAdjustTransactionModel $model The transaction you wish to create or adjust * @return TransactionModel */ @@ -10002,60 +10002,60 @@ public function createOrAdjustTransaction($include=null, $model=null) { 'query' => ['$include' => $include], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Create a new transaction * - * Records a new transaction in AvaTax. - * - * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like - * sales, purchases, inventory transfer, and returns (also called refunds). - * - * The `CreateTransaction` endpoint uses the tax profile of your company to identify the correct tax rules - * and rates to apply to all line items in this transaction. The end result will be the total tax calculated by AvaTax based on your - * company's configuration and the data provided in this API call. - * - * The `CreateTransaction` API will report an error if a committed transaction already exists with the same `code`. To - * avoid this error, use the `CreateOrAdjustTransaction` API - it will create the transaction if it does not exist, or - * update it if it does exist. - * - * To generate a refund for a transaction, use the `RefundTransaction` API. - * - * The field `type` identifies the kind of transaction - for example, a sale, purchase, or refund. If you do not specify - * a `type` value, you will receive an estimate of type `SalesOrder`, which will not be recorded. - * - * The origin and destination locations for a transaction must be identified by either address or geocode. For address-based transactions, please - * provide addresses in the fields `line`, `city`, `region`, `country` and `postalCode`. For geocode-based transactions, please provide the geocode - * information in the fields `latitude` and `longitude`. If either `latitude` or `longitude` or both are null, the transaction will be calculated - * using the best available address location information. - * - * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: - * - * * Lines - * * Details (implies lines) - * * Summary (implies details) - * * Addresses - * * SummaryOnly (omit lines and details - reduces API response size) - * * LinesOnly (omit details - reduces API response size) - * * ForceTimeout - Simulates a timeout. This adds a 30 second delay and error to your API call. This can be used to test your code to ensure it can respond correctly in the case of a dropped connection. - * * TaxDetailsByTaxType - Includes the aggregated tax, exempt tax, taxable and non-taxable for each tax type returned in the transaction summary. - * - * If you omit the `$include` parameter, the API will assume you want `Summary,Addresses`. - * - * NOTE: Avoid using the following strings in your transaction codes as they are encoding strings and will be interpreted differently: - * * \_-ava2f-\_ - * * \_-ava2b-\_ - * * \_-ava3f-\_ - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * Records a new transaction in AvaTax. + * + * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like + * sales, purchases, inventory transfer, and returns (also called refunds). + * + * The `CreateTransaction` endpoint uses the tax profile of your company to identify the correct tax rules + * and rates to apply to all line items in this transaction. The end result will be the total tax calculated by AvaTax based on your + * company's configuration and the data provided in this API call. + * + * The `CreateTransaction` API will report an error if a committed transaction already exists with the same `code`. To + * avoid this error, use the `CreateOrAdjustTransaction` API - it will create the transaction if it does not exist, or + * update it if it does exist. + * + * To generate a refund for a transaction, use the `RefundTransaction` API. + * + * The field `type` identifies the kind of transaction - for example, a sale, purchase, or refund. If you do not specify + * a `type` value, you will receive an estimate of type `SalesOrder`, which will not be recorded. + * + * The origin and destination locations for a transaction must be identified by either address or geocode. For address-based transactions, please + * provide addresses in the fields `line`, `city`, `region`, `country` and `postalCode`. For geocode-based transactions, please provide the geocode + * information in the fields `latitude` and `longitude`. If either `latitude` or `longitude` or both are null, the transaction will be calculated + * using the best available address location information. + * + * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: + * + * * Lines + * * Details (implies lines) + * * Summary (implies details) + * * Addresses + * * SummaryOnly (omit lines and details - reduces API response size) + * * LinesOnly (omit details - reduces API response size) + * * ForceTimeout - Simulates a timeout. This adds a 30 second delay and error to your API call. This can be used to test your code to ensure it can respond correctly in the case of a dropped connection. + * * TaxDetailsByTaxType - Includes the aggregated tax, exempt tax, taxable and non-taxable for each tax type returned in the transaction summary. + * + * If you omit the `$include` parameter, the API will assume you want `Summary,Addresses`. + * + * NOTE: Avoid using the following strings in your transaction codes as they are encoding strings and will be interpreted differently: + * * \_-ava2f-\_ + * * \_-ava2b-\_ + * * \_-ava3f-\_ + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro, BasicReturns. * Swagger Name: AvaTaxClient - * - * @param string $include Specifies objects to include in the response after transaction is created + * + * @param string $include Specifies objects to include in the response after transaction is created * @param CreateTransactionModel $model The transaction you wish to create * @return TransactionModel */ @@ -10065,37 +10065,37 @@ public function createTransaction($include=null, $model=null) { 'query' => ['$include' => $include], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Remove lines from an existing unlocked transaction * - * Remove lines to an existing unlocked transaction. - * - * The `DeleteLines` API allows you to remove transaction lines from existing unlocked transaction, so that customer will - * be able to delete transaction lines and adjust original transaction the way they like - * - * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like - * sales, purchases, inventory transfer, and returns (also called refunds). - * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: - * - * * Lines - * * Details (implies lines) - * * Summary (implies details) - * * Addresses - * * SummaryOnly (omit lines and details - reduces API response size) - * * LinesOnly (omit details - reduces API response size) - * - * If you omit the `$include` parameter, the API will assume you want `Summary,Addresses`. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * Remove lines to an existing unlocked transaction. + * + * The `DeleteLines` API allows you to remove transaction lines from existing unlocked transaction, so that customer will + * be able to delete transaction lines and adjust original transaction the way they like + * + * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like + * sales, purchases, inventory transfer, and returns (also called refunds). + * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: + * + * * Lines + * * Details (implies lines) + * * Summary (implies details) + * * Addresses + * * SummaryOnly (omit lines and details - reduces API response size) + * * LinesOnly (omit details - reduces API response size) + * + * If you omit the `$include` parameter, the API will assume you want `Summary,Addresses`. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro, BasicReturns. * Swagger Name: AvaTaxClient - * - * @param string $include Specifies objects to include in the response after transaction is created + * + * @param string $include Specifies objects to include in the response after transaction is created * @param RemoveTransactionLineModel $model information about the transaction and lines to be removed * @return TransactionModel */ @@ -10105,48 +10105,48 @@ public function deleteLines($include=null, $model=null) { 'query' => ['$include' => $include], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Retrieve a single transaction by code * - * Get the current transaction identified by this company code, transaction code, and document type. - * - * A transaction is uniquely identified by `companyCode`, `code` (often called Transaction Code), and `documentType`. - * - * For compatibility purposes, when this API finds multiple transactions with the same transaction code, and if you have not specified - * the `type` parameter to this API, it will default to selecting the `SalesInvoices` transaction. To change this behavior, use the - * optional `documentType` parameter to specify the specific document type you wish to find. - * - * If this transaction was adjusted, the return value of this API will be the current transaction with this code. - * - * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: - * - * * Lines - * * Details (implies lines) - * * Summary (implies details) - * * Addresses - * * SummaryOnly (omit lines and details - reduces API response size) - * * LinesOnly (omit details - reduces API response size) - * - * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: - * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code - * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code - * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code - * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code - * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code - * * Replace ' ' with '%20' For example: document Code becomes document%20Code - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * Get the current transaction identified by this company code, transaction code, and document type. + * + * A transaction is uniquely identified by `companyCode`, `code` (often called Transaction Code), and `documentType`. + * + * For compatibility purposes, when this API finds multiple transactions with the same transaction code, and if you have not specified + * the `type` parameter to this API, it will default to selecting the `SalesInvoices` transaction. To change this behavior, use the + * optional `documentType` parameter to specify the specific document type you wish to find. + * + * If this transaction was adjusted, the return value of this API will be the current transaction with this code. + * + * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: + * + * * Lines + * * Details (implies lines) + * * Summary (implies details) + * * Addresses + * * SummaryOnly (omit lines and details - reduces API response size) + * * LinesOnly (omit details - reduces API response size) + * + * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: + * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code + * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code + * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code + * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code + * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code + * * Replace ' ' with '%20' For example: document Code becomes document%20Code + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro, BasicReturns. * Swagger Name: AvaTaxClient - * - * @param string $companyCode The company code of the company that recorded this transaction - * @param string $transactionCode The transaction code to retrieve - * @param string $documentType (Optional): The document type of the transaction to retrieve (See DocumentType::* for a list of allowable values) + * + * @param string $companyCode The company code of the company that recorded this transaction + * @param string $transactionCode The transaction code to retrieve + * @param string $documentType (Optional): The document type of the transaction to retrieve (See DocumentType::* for a list of allowable values) * @param string $include Specifies objects to include in this fetch call * @return TransactionModel */ @@ -10156,31 +10156,31 @@ public function getTransactionByCode($companyCode, $transactionCode, $documentTy 'query' => ['documentType' => $documentType, '$include' => $include], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve a single transaction by code * - * DEPRECATED: Please use the `GetTransactionByCode` API instead. - * - * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: - * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code - * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code - * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code - * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code - * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code - * * Replace ' ' with '%20' For example: document Code becomes document%20Code - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * DEPRECATED: Please use the `GetTransactionByCode` API instead. + * + * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: + * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code + * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code + * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code + * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code + * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code + * * Replace ' ' with '%20' For example: document Code becomes document%20Code + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro, BasicReturns. * Swagger Name: AvaTaxClient - * - * @param string $companyCode The company code of the company that recorded this transaction - * @param string $transactionCode The transaction code to retrieve - * @param string $documentType The transaction type to retrieve (See DocumentType::* for a list of allowable values) + * + * @param string $companyCode The company code of the company that recorded this transaction + * @param string $transactionCode The transaction code to retrieve + * @param string $documentType The transaction type to retrieve (See DocumentType::* for a list of allowable values) * @param string $include Specifies objects to include in this fetch call * @return TransactionModel */ @@ -10190,36 +10190,36 @@ public function getTransactionByCodeAndType($companyCode, $transactionCode, $doc 'query' => ['$include' => $include], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve a single transaction by ID * - * Get the unique transaction identified by this URL. - * - * This endpoint retrieves the exact transaction identified by this ID number, as long as it is the most version of the transaction. - * - * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like - * sales, purchases, inventory transfer, and returns (also called refunds). - * - * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: - * - * * Lines - * * Details (implies lines) - * * Summary (implies details) - * * Addresses - * * SummaryOnly (omit lines and details - reduces API response size) - * * LinesOnly (omit details - reduces API response size) - * * TaxDetailsByTaxType - Includes the aggregated tax, exempt tax, taxable and non-taxable for each tax type returned in the transaction summary. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * Get the unique transaction identified by this URL. + * + * This endpoint retrieves the exact transaction identified by this ID number, as long as it is the most version of the transaction. + * + * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like + * sales, purchases, inventory transfer, and returns (also called refunds). + * + * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: + * + * * Lines + * * Details (implies lines) + * * Summary (implies details) + * * Addresses + * * SummaryOnly (omit lines and details - reduces API response size) + * * LinesOnly (omit details - reduces API response size) + * * TaxDetailsByTaxType - Includes the aggregated tax, exempt tax, taxable and non-taxable for each tax type returned in the transaction summary. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro, BasicReturns. * Swagger Name: AvaTaxClient - * - * @param int $id The unique ID number of the transaction to retrieve + * + * @param int $id The unique ID number of the transaction to retrieve * @param string $include Specifies objects to include in this fetch call * @return TransactionModel */ @@ -10229,54 +10229,54 @@ public function getTransactionById($id, $include=null) { 'query' => ['$include' => $include], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve all transactions * - * List all transactions attached to this company. - * - * This endpoint is limited to returning 1,000 transactions at a time maximum. - * - * When listing transactions, you must specify a `date` range filter. If you do not specify a `$filter` that includes a `date` field - * criteria, the query will default to looking at only those transactions with `date` in the past 30 days. - * - * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like - * sales, purchases, inventory transfer, and returns (also called refunds). - * - * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . - * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. - * - * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: - * - * * Lines - * * Details (implies lines) - * * Summary (implies details) - * * Addresses - * * SummaryOnly (omit lines and details - reduces API response size) - * * LinesOnly (omit details - reduces API response size) - * - * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: - * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code - * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code - * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code - * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code - * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code - * * Replace ' ' with '%20' For example: document Code becomes document%20Code - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * List all transactions attached to this company. + * + * This endpoint is limited to returning 1,000 transactions at a time maximum. + * + * When listing transactions, you must specify a `date` range filter. If you do not specify a `$filter` that includes a `date` field + * criteria, the query will default to looking at only those transactions with `date` in the past 30 days. + * + * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like + * sales, purchases, inventory transfer, and returns (also called refunds). + * + * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . + * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. + * + * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: + * + * * Lines + * * Details (implies lines) + * * Summary (implies details) + * * Addresses + * * SummaryOnly (omit lines and details - reduces API response size) + * * LinesOnly (omit details - reduces API response size) + * + * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: + * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code + * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code + * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code + * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code + * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code + * * Replace ' ' with '%20' For example: document Code becomes document%20Code + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro, BasicReturns. * Swagger Name: AvaTaxClient - * - * @param string $companyCode The company code of the company that recorded this transaction - * @param int $dataSourceId Optionally filter transactions to those from a specific data source. - * @param string $include Specifies objects to include in this fetch call - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* exchangeRateCurrencyCode, totalDiscount, lines, addresses, locationTypes, summary, taxDetailsByTaxType, parameters, userDefinedFields, messages, invoiceMessages, isFakeTransaction, deliveryTerms - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $companyCode The company code of the company that recorded this transaction + * @param int $dataSourceId Optionally filter transactions to those from a specific data source. + * @param string $include Specifies objects to include in this fetch call + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* exchangeRateCurrencyCode, totalDiscount, lines, addresses, locationTypes, summary, taxDetailsByTaxType, parameters, userDefinedFields, messages, invoiceMessages, isFakeTransaction, deliveryTerms + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -10286,52 +10286,52 @@ public function listTransactionsByCompany($companyCode, $dataSourceId, $include= 'query' => ['dataSourceId' => $dataSourceId, '$include' => $include, '$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Lock a single transaction * - * Lock a transaction uniquely identified by this URL. - * - * This API is mainly used for connector developers to simulate what happens when the Returns product locks a document. - * After this API call succeeds, the document will be locked and can't be voided or adjusted. - * - * This API is only available to customers in Sandbox with AvaTaxPro subscription. On production servers, this API is available by invitation only. - * - * If you have more than one document with the same `code`, specify the `documentType` parameter to choose between them. - * - * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like - * sales, purchases, inventory transfer, and returns (also called refunds). - * - * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: - * - * * Lines - * * Details (implies lines) - * * Summary (implies details) - * * Addresses - * * SummaryOnly (omit lines and details - reduces API response size) - * * LinesOnly (omit details - reduces API response size) - * * TaxDetailsByTaxType - Includes the aggregated tax, exempt tax, taxable and non-taxable for each tax type returned in the transaction summary. - * - * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: - * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code - * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code - * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code - * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code - * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code - * * Replace ' ' with '%20' For example: document Code becomes document%20Code - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * Lock a transaction uniquely identified by this URL. + * + * This API is mainly used for connector developers to simulate what happens when the Returns product locks a document. + * After this API call succeeds, the document will be locked and can't be voided or adjusted. + * + * This API is only available to customers in Sandbox with AvaTaxPro subscription. On production servers, this API is available by invitation only. + * + * If you have more than one document with the same `code`, specify the `documentType` parameter to choose between them. + * + * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like + * sales, purchases, inventory transfer, and returns (also called refunds). + * + * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: + * + * * Lines + * * Details (implies lines) + * * Summary (implies details) + * * Addresses + * * SummaryOnly (omit lines and details - reduces API response size) + * * LinesOnly (omit details - reduces API response size) + * * TaxDetailsByTaxType - Includes the aggregated tax, exempt tax, taxable and non-taxable for each tax type returned in the transaction summary. + * + * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: + * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code + * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code + * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code + * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code + * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code + * * Replace ' ' with '%20' For example: document Code becomes document%20Code + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged. * Swagger Name: AvaTaxClient - * - * @param string $companyCode The company code of the company that recorded this transaction - * @param string $transactionCode The transaction code to lock - * @param string $documentType (Optional): The document type of the transaction to lock. If not provided, the default is SalesInvoice. (See DocumentType::* for a list of allowable values) - * @param string $include Specifies objects to include in this fetch call + * + * @param string $companyCode The company code of the company that recorded this transaction + * @param string $transactionCode The transaction code to lock + * @param string $documentType (Optional): The document type of the transaction to lock. If not provided, the default is SalesInvoice. (See DocumentType::* for a list of allowable values) + * @param string $include Specifies objects to include in this fetch call * @param LockTransactionModel $model The lock request you wish to execute * @return TransactionModel */ @@ -10341,63 +10341,63 @@ public function lockTransaction($companyCode, $transactionCode, $documentType, $ 'query' => ['documentType' => $documentType, '$include' => $include], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Create a refund for a transaction * - * Create a refund for a transaction. - * - * The `RefundTransaction` API allows you to quickly and easily create a `ReturnInvoice` representing a refund - * for a previously created `SalesInvoice` transaction. You can choose to create a full or partial refund, and - * specify individual line items from the original sale for refund. - * - * The `RefundTransaction` API ensures that the tax amount you refund to the customer exactly matches the tax that - * was calculated during the original transaction, regardless of any changes to your company's configuration, rules, - * nexus, or any other setting. - * - * This API is intended to be a shortcut to allow you to quickly and accurately generate a refund for the following - * common refund scenarios: - * - * * A full refund of a previous sale - * * Refunding the tax that was charged on a previous sale, when the customer provides an exemption certificate after the purchase - * * Refunding one or more items (lines) from a previous sale - * * Granting a customer a percentage refund of a previous sale - * - * For more complex scenarios than the ones above, please use `CreateTransaction` with document type `ReturnInvoice` to - * create a custom refund transaction. - * - * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: - * - * * Lines - * * Details (implies lines) - * * Summary (implies details) - * * Addresses - * * SummaryOnly (omit lines and details - reduces API response size) - * * LinesOnly (omit details - reduces API response size) - * * TaxDetailsByTaxType - Includes the aggregated tax, exempt tax, taxable and non-taxable for each tax type returned in the transaction summary. - * If you omit the `$include` parameter, the API will assume you want `Summary,Addresses`. - * - * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: - * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code - * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code - * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code - * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code - * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code - * * Replace ' ' with '%20' For example: document Code becomes document%20Code - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * Create a refund for a transaction. + * + * The `RefundTransaction` API allows you to quickly and easily create a `ReturnInvoice` representing a refund + * for a previously created `SalesInvoice` transaction. You can choose to create a full or partial refund, and + * specify individual line items from the original sale for refund. + * + * The `RefundTransaction` API ensures that the tax amount you refund to the customer exactly matches the tax that + * was calculated during the original transaction, regardless of any changes to your company's configuration, rules, + * nexus, or any other setting. + * + * This API is intended to be a shortcut to allow you to quickly and accurately generate a refund for the following + * common refund scenarios: + * + * * A full refund of a previous sale + * * Refunding the tax that was charged on a previous sale, when the customer provides an exemption certificate after the purchase + * * Refunding one or more items (lines) from a previous sale + * * Granting a customer a percentage refund of a previous sale + * + * For more complex scenarios than the ones above, please use `CreateTransaction` with document type `ReturnInvoice` to + * create a custom refund transaction. + * + * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: + * + * * Lines + * * Details (implies lines) + * * Summary (implies details) + * * Addresses + * * SummaryOnly (omit lines and details - reduces API response size) + * * LinesOnly (omit details - reduces API response size) + * * TaxDetailsByTaxType - Includes the aggregated tax, exempt tax, taxable and non-taxable for each tax type returned in the transaction summary. + * If you omit the `$include` parameter, the API will assume you want `Summary,Addresses`. + * + * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: + * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code + * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code + * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code + * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code + * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code + * * Replace ' ' with '%20' For example: document Code becomes document%20Code + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro, BasicReturns. * Swagger Name: AvaTaxClient - * - * @param string $companyCode The code of the company that made the original sale - * @param string $transactionCode The transaction code of the original sale - * @param string $include Specifies objects to include in the response after transaction is created - * @param string $documentType (Optional): The document type of the transaction to refund. If not provided, the default is SalesInvoice. (See DocumentType::* for a list of allowable values) - * @param boolean $useTaxDateOverride (Optional): If set to true, processes refund using taxDateOverride rather than taxAmountOverride (Note: taxAmountOverride is not allowed for SST states). + * + * @param string $companyCode The code of the company that made the original sale + * @param string $transactionCode The transaction code of the original sale + * @param string $include Specifies objects to include in the response after transaction is created + * @param string $documentType (Optional): The document type of the transaction to refund. If not provided, the default is SalesInvoice. (See DocumentType::* for a list of allowable values) + * @param boolean $useTaxDateOverride (Optional): If set to true, processes refund using taxDateOverride rather than taxAmountOverride (Note: taxAmountOverride is not allowed for SST states). * @param RefundTransactionModel $model Information about the refund to create * @return TransactionModel */ @@ -10407,50 +10407,50 @@ public function refundTransaction($companyCode, $transactionCode, $include=null, 'query' => ['$include' => $include, 'documentType' => $documentType, 'useTaxDateOverride' => $useTaxDateOverride], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Perform multiple actions on a transaction * - * Performs one or more actions against the current transaction uniquely identified by this URL. - * - * The `SettleTransaction` API call can perform the work of `ChangeCode`, `VerifyTransaction`, and `CommitTransaction`. - * - * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like - * sales, purchases, inventory transfer, and returns (also called refunds). - * - * If you have more than one document with the same `code`, specify the `documentType` parameter to choose between them. - * - * This API is available for users who want to execute more than one action at a time. - * - * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: - * - * * Lines - * * Details (implies lines) - * * Summary (implies details) - * * Addresses - * * SummaryOnly (omit lines and details - reduces API response size) - * * LinesOnly (omit details - reduces API response size) - * * TaxDetailsByTaxType - Includes the aggregated tax, exempt tax, taxable and non-taxable for each tax type returned in the transaction summary. - * - * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: - * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code - * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code - * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code - * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code - * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code - * * Replace ' ' with '%20' For example: document Code becomes document%20Code - * - * ### Security Policies - * + * Performs one or more actions against the current transaction uniquely identified by this URL. + * + * The `SettleTransaction` API call can perform the work of `ChangeCode`, `VerifyTransaction`, and `CommitTransaction`. + * + * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like + * sales, purchases, inventory transfer, and returns (also called refunds). + * + * If you have more than one document with the same `code`, specify the `documentType` parameter to choose between them. + * + * This API is available for users who want to execute more than one action at a time. + * + * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: + * + * * Lines + * * Details (implies lines) + * * Summary (implies details) + * * Addresses + * * SummaryOnly (omit lines and details - reduces API response size) + * * LinesOnly (omit details - reduces API response size) + * * TaxDetailsByTaxType - Includes the aggregated tax, exempt tax, taxable and non-taxable for each tax type returned in the transaction summary. + * + * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: + * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code + * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code + * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code + * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code + * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code + * * Replace ' ' with '%20' For example: document Code becomes document%20Code + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, ProStoresOperator, SSTAdmin, TechnicalSupportAdmin. * Swagger Name: AvaTaxClient - * - * @param string $companyCode The company code of the company that recorded this transaction - * @param string $transactionCode The transaction code to settle - * @param string $documentType (Optional): The document type of the transaction to settle. If not provided, the default is SalesInvoice. (See DocumentType::* for a list of allowable values) - * @param string $include Specifies objects to include in this fetch call + * + * @param string $companyCode The company code of the company that recorded this transaction + * @param string $transactionCode The transaction code to settle + * @param string $documentType (Optional): The document type of the transaction to settle. If not provided, the default is SalesInvoice. (See DocumentType::* for a list of allowable values) + * @param string $include Specifies objects to include in this fetch call * @param SettleTransactionModel $model The data from an external system to reconcile against AvaTax * @return TransactionModel */ @@ -10460,44 +10460,44 @@ public function settleTransaction($companyCode, $transactionCode, $documentType, 'query' => ['documentType' => $documentType, '$include' => $include], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Uncommit a transaction for reporting * - * Adjusts a transaction by changing it to an uncommitted status. - * - * Transactions that have been previously reported to a tax authority by Avalara Managed Returns are considered `locked` and are - * no longer available to be uncommitted. - * - * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: - * - * * Lines - * * Details (implies lines) - * * Summary (implies details) - * * Addresses - * * SummaryOnly (omit lines and details - reduces API response size) - * * LinesOnly (omit details - reduces API response size) - * * TaxDetailsByTaxType - Includes the aggregated tax, exempt tax, taxable and non-taxable for each tax type returned in the transaction summary. - * - * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: - * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code - * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code - * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code - * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code - * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code - * * Replace ' ' with '%20' For example: document Code becomes document%20Code - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * Adjusts a transaction by changing it to an uncommitted status. + * + * Transactions that have been previously reported to a tax authority by Avalara Managed Returns are considered `locked` and are + * no longer available to be uncommitted. + * + * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: + * + * * Lines + * * Details (implies lines) + * * Summary (implies details) + * * Addresses + * * SummaryOnly (omit lines and details - reduces API response size) + * * LinesOnly (omit details - reduces API response size) + * * TaxDetailsByTaxType - Includes the aggregated tax, exempt tax, taxable and non-taxable for each tax type returned in the transaction summary. + * + * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: + * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code + * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code + * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code + * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code + * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code + * * Replace ' ' with '%20' For example: document Code becomes document%20Code + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro, BasicReturns. * Swagger Name: AvaTaxClient - * - * @param string $companyCode The company code of the company that recorded this transaction - * @param string $transactionCode The transaction code to Uncommit - * @param string $documentType (Optional): The document type of the transaction to Uncommit. If not provided, the default is SalesInvoice. (See DocumentType::* for a list of allowable values) + * + * @param string $companyCode The company code of the company that recorded this transaction + * @param string $transactionCode The transaction code to Uncommit + * @param string $documentType (Optional): The document type of the transaction to Uncommit. If not provided, the default is SalesInvoice. (See DocumentType::* for a list of allowable values) * @param string $include Specifies objects to include in this fetch call * @return TransactionModel */ @@ -10507,41 +10507,41 @@ public function uncommitTransaction($companyCode, $transactionCode, $documentTyp 'query' => ['documentType' => $documentType, '$include' => $include], 'body' => null ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Unvoids a transaction * - * Unvoids a voided transaction - * - * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: - * - * * Lines - * * Details (implies lines) - * * Summary (implies details) - * * Addresses - * * SummaryOnly (omit lines and details - reduces API response size) - * * LinesOnly (omit details - reduces API response size) - * * TaxDetailsByTaxType - Includes the aggregated tax, exempt tax, taxable and non-taxable for each tax type returned in the transaction summary. - * - * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: - * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code - * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code - * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code - * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code - * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code - * * Replace ' ' with '%20' For example: document Code becomes document%20Code - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * Unvoids a voided transaction + * + * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: + * + * * Lines + * * Details (implies lines) + * * Summary (implies details) + * * Addresses + * * SummaryOnly (omit lines and details - reduces API response size) + * * LinesOnly (omit details - reduces API response size) + * * TaxDetailsByTaxType - Includes the aggregated tax, exempt tax, taxable and non-taxable for each tax type returned in the transaction summary. + * + * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: + * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code + * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code + * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code + * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code + * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code + * * Replace ' ' with '%20' For example: document Code becomes document%20Code + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro, BasicReturns. * Swagger Name: AvaTaxClient - * - * @param string $companyCode The company code of the company that recorded this transaction - * @param string $transactionCode The transaction code to commit - * @param string $documentType (Optional): The document type of the transaction to commit. If not provided, the default is SalesInvoice. (See DocumentType::* for a list of allowable values) + * + * @param string $companyCode The company code of the company that recorded this transaction + * @param string $transactionCode The transaction code to commit + * @param string $documentType (Optional): The document type of the transaction to commit. If not provided, the default is SalesInvoice. (See DocumentType::* for a list of allowable values) * @param string $include Specifies objects to include in this fetch call * @return TransactionModel */ @@ -10551,49 +10551,49 @@ public function unvoidTransaction($companyCode, $transactionCode, $documentType, 'query' => ['documentType' => $documentType, '$include' => $include], 'body' => null ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Verify a transaction * - * Verifies that the transaction uniquely identified by this URL matches certain expected values. - * - * If the transaction does not match these expected values, this API will return an error code indicating which value did not match. - * - * If you have more than one document with the same `code`, specify the `documentType` parameter to choose between them. - * - * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like - * sales, purchases, inventory transfer, and returns (also called refunds). - * - * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: - * - * * Lines - * * Details (implies lines) - * * Summary (implies details) - * * Addresses - * * SummaryOnly (omit lines and details - reduces API response size) - * * LinesOnly (omit details - reduces API response size) - * * TaxDetailsByTaxType - Includes the aggregated tax, exempt tax, taxable and non-taxable for each tax type returned in the transaction summary. - * - * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: - * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code - * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code - * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code - * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code - * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code - * * Replace ' ' with '%20' For example: document Code becomes document%20Code - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, ProStoresOperator, SSTAdmin, TechnicalSupportAdmin. + * Verifies that the transaction uniquely identified by this URL matches certain expected values. + * + * If the transaction does not match these expected values, this API will return an error code indicating which value did not match. + * + * If you have more than one document with the same `code`, specify the `documentType` parameter to choose between them. + * + * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like + * sales, purchases, inventory transfer, and returns (also called refunds). + * + * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: + * + * * Lines + * * Details (implies lines) + * * Summary (implies details) + * * Addresses + * * SummaryOnly (omit lines and details - reduces API response size) + * * LinesOnly (omit details - reduces API response size) + * * TaxDetailsByTaxType - Includes the aggregated tax, exempt tax, taxable and non-taxable for each tax type returned in the transaction summary. + * + * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: + * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code + * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code + * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code + * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code + * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code + * * Replace ' ' with '%20' For example: document Code becomes document%20Code + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, ProStoresOperator, SSTAdmin, TechnicalSupportAdmin. * * This API depends on the following active services:*Required* (all): AvaTaxPro, BasicReturns. * Swagger Name: AvaTaxClient - * - * @param string $companyCode The company code of the company that recorded this transaction - * @param string $transactionCode The transaction code to settle - * @param string $documentType (Optional): The document type of the transaction to verify. If not provided, the default is SalesInvoice. (See DocumentType::* for a list of allowable values) - * @param string $include Specifies objects to include in this fetch call + * + * @param string $companyCode The company code of the company that recorded this transaction + * @param string $transactionCode The transaction code to settle + * @param string $documentType (Optional): The document type of the transaction to verify. If not provided, the default is SalesInvoice. (See DocumentType::* for a list of allowable values) + * @param string $include Specifies objects to include in this fetch call * @param VerifyTransactionModel $model The data from an external system to reconcile against AvaTax * @return TransactionModel */ @@ -10603,51 +10603,51 @@ public function verifyTransaction($companyCode, $transactionCode, $documentType, 'query' => ['documentType' => $documentType, '$include' => $include], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Void a transaction * - * Voids the current transaction uniquely identified by this URL. - * - * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like - * sales, purchases, inventory transfer, and returns (also called refunds). - * - * When you void a transaction, that transaction's status is recorded as `DocVoided`. - * - * If you have more than one document with the same `code`, specify the `documentType` parameter to choose between them. - * - * Transactions that have been previously reported to a tax authority by Avalara Managed Returns are no longer available to be voided. - * - * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: - * - * * Lines - * * Details (implies lines) - * * Summary (implies details) - * * Addresses - * * SummaryOnly (omit lines and details - reduces API response size) - * * LinesOnly (omit details - reduces API response size) - * * TaxDetailsByTaxType - Includes the aggregated tax, exempt tax, taxable and non-taxable for each tax type returned in the transaction summary. - * - * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: - * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code - * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code - * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code - * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code - * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code - * * Replace ' ' with '%20' For example: document Code becomes document%20Code - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, BatchServiceAdmin, CompanyAdmin, CSPTester, ProStoresOperator, SSTAdmin, TechnicalSupportAdmin. + * Voids the current transaction uniquely identified by this URL. + * + * A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like + * sales, purchases, inventory transfer, and returns (also called refunds). + * + * When you void a transaction, that transaction's status is recorded as `DocVoided`. + * + * If you have more than one document with the same `code`, specify the `documentType` parameter to choose between them. + * + * Transactions that have been previously reported to a tax authority by Avalara Managed Returns are no longer available to be voided. + * + * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: + * + * * Lines + * * Details (implies lines) + * * Summary (implies details) + * * Addresses + * * SummaryOnly (omit lines and details - reduces API response size) + * * LinesOnly (omit details - reduces API response size) + * * TaxDetailsByTaxType - Includes the aggregated tax, exempt tax, taxable and non-taxable for each tax type returned in the transaction summary. + * + * NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request: + * * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code + * * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code + * * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code + * * Replace '%' with '\_-ava25-\_' For example: document%Code becomes document_-ava25-_Code + * * Replace '#' with '\_-ava23-\_' For example: document#Code becomes document_-ava23-_Code + * * Replace ' ' with '%20' For example: document Code becomes document%20Code + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, BatchServiceAdmin, CompanyAdmin, CSPTester, ProStoresOperator, SSTAdmin, TechnicalSupportAdmin. * * This API depends on the following active services:*Required* (all): AvaTaxPro, BasicReturns. * Swagger Name: AvaTaxClient - * - * @param string $companyCode The company code of the company that recorded this transaction - * @param string $transactionCode The transaction code to void - * @param string $documentType (Optional): The document type of the transaction to void. If not provided, the default is SalesInvoice. (See DocumentType::* for a list of allowable values) - * @param string $include Specifies objects to include in this fetch call + * + * @param string $companyCode The company code of the company that recorded this transaction + * @param string $transactionCode The transaction code to void + * @param string $documentType (Optional): The document type of the transaction to void. If not provided, the default is SalesInvoice. (See DocumentType::* for a list of allowable values) + * @param string $include Specifies objects to include in this fetch call * @param VoidTransactionModel $model The void request you wish to execute. To void a transaction the code must be set to 'DocVoided' * @return TransactionModel */ @@ -10657,22 +10657,22 @@ public function voidTransaction($companyCode, $transactionCode, $documentType, $ 'query' => ['documentType' => $documentType, '$include' => $include], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Create a new UPC * - * Create one or more new UPC objects attached to this company. - * A UPC represents a single UPC code in your catalog and matches this product to the tax code identified by this UPC. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. + * Create one or more new UPC objects attached to this company. + * A UPC represents a single UPC code in your catalog and matches this product to the tax code identified by this UPC. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. * * This API depends on the following active services:*Required* (all): AvaUpc. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this UPC. + * + * @param int $companyId The ID of the company that owns this UPC. * @param UPCModel[] $model The UPC you wish to create. * @return UPCModel[] */ @@ -10682,21 +10682,21 @@ public function createUPCs($companyId, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Delete a single UPC * - * Marks the UPC object identified by this URL as deleted. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. + * Marks the UPC object identified by this URL as deleted. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. * * This API depends on the following active services:*Required* (all): AvaUpc. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this UPC. + * + * @param int $companyId The ID of the company that owns this UPC. * @param int $id The ID of the UPC you wish to delete. * @return ErrorDetail[] */ @@ -10706,22 +10706,22 @@ public function deleteUPC($companyId, $id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'DELETE', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'DELETE', $guzzleParams,'22.8.0' ); } /** * Retrieve a single UPC * - * Get the UPC object identified by this URL. - * A UPC represents a single UPC code in your catalog and matches this product to the tax code identified by this UPC. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * Get the UPC object identified by this URL. + * A UPC represents a single UPC code in your catalog and matches this product to the tax code identified by this UPC. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AvaUpc. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns this UPC + * + * @param int $companyId The ID of the company that owns this UPC * @param int $id The primary key of this UPC * @return UPCModel */ @@ -10731,29 +10731,29 @@ public function getUPC($companyId, $id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve UPCs for this company * - * List all UPC objects attached to this company. - * A UPC represents a single UPC code in your catalog and matches this product to the tax code identified by this UPC. - * - * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . - * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * List all UPC objects attached to this company. + * A UPC represents a single UPC code in your catalog and matches this product to the tax code identified by this UPC. + * + * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . + * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AvaUpc. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that owns these UPCs - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). - * @param string $include A comma separated list of additional data to retrieve. - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param int $companyId The ID of the company that owns these UPCs + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). + * @param string $include A comma separated list of additional data to retrieve. + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -10763,28 +10763,28 @@ public function listUPCsByCompany($companyId, $filter=null, $include=null, $top= 'query' => ['$filter' => $filter, '$include' => $include, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve all UPCs * - * Get multiple UPC objects across all companies. - * A UPC represents a single UPC code in your catalog and matches this product to the tax code identified by this UPC. - * - * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . - * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. + * Get multiple UPC objects across all companies. + * A UPC represents a single UPC code in your catalog and matches this product to the tax code identified by this UPC. + * + * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . + * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. * * This API depends on the following active services:*Required* (all): AvaUpc. * Swagger Name: AvaTaxClient - * - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). - * @param string $include A comma separated list of additional data to retrieve. - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/). + * @param string $include A comma separated list of additional data to retrieve. + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -10794,25 +10794,25 @@ public function queryUPCs($filter=null, $include=null, $top=null, $skip=null, $o 'query' => ['$filter' => $filter, '$include' => $include, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Update a single UPC * - * Replace the existing UPC object at this URL with an updated object. - * A UPC represents a single UPC code in your catalog and matches this product to the tax code identified by this UPC. - * All data from the existing object will be replaced with data in the object you PUT. - * To set a field's value to null, you may either set its value to null or omit that field from the object you post. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. + * Replace the existing UPC object at this URL with an updated object. + * A UPC represents a single UPC code in your catalog and matches this product to the tax code identified by this UPC. + * All data from the existing object will be replaced with data in the object you PUT. + * To set a field's value to null, you may either set its value to null or omit that field from the object you post. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin. * * This API depends on the following active services:*Required* (all): AvaUpc. * Swagger Name: AvaTaxClient - * - * @param int $companyId The ID of the company that this UPC belongs to. - * @param int $id The ID of the UPC you wish to update + * + * @param int $companyId The ID of the company that this UPC belongs to. + * @param int $id The ID of the UPC you wish to update * @param UPCModel $model The UPC you wish to update. * @return UPCModel */ @@ -10822,21 +10822,21 @@ public function updateUPC($companyId, $id, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'PUT', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'PUT', $guzzleParams,'22.8.0' ); } /** * Delete a User Defined Field by User Defined Field id for a company. * - * Marks the existing user defined field for a company as deleted. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. + * Marks the existing user defined field for a company as deleted. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. * * This API depends on the following active services:*Required* (all): AvaTaxPro, BasicReturns. * Swagger Name: AvaTaxClient - * - * @param int $companyId The id of the company the User Defined Field belongs to. + * + * @param int $companyId The id of the company the User Defined Field belongs to. * @param int $id The id of the User Defined Field you wish to delete. * @return ErrorDetail[] */ @@ -10846,20 +10846,20 @@ public function deleteUserDefinedField($companyId, $id) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'DELETE', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'DELETE', $guzzleParams,'22.8.0' ); } /** * * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * * This API depends on the following active services:*Required* (all): AvaTaxPro, BasicReturns. * Swagger Name: AvaTaxClient - * - * @param int $companyId - * @param string $udfType Document or Line level UDF (See UserDefinedFieldType::* for a list of allowable values) + * + * @param int $companyId + * @param string $udfType Document or Line level UDF (See UserDefinedFieldType::* for a list of allowable values) * @param boolean $allowDefaults If true this will add defaulted UDFs to the list that are not named yet * @return FetchResult */ @@ -10869,22 +10869,22 @@ public function listUserDefinedFieldsByCompanyId($companyId, $udfType, $allowDef 'query' => ['udfType' => $udfType, 'allowDefaults' => $allowDefaults], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Update a User Defined Field identified by id for a company * - * Updates a User Defined Field for a company. - * - * ### Security Policies - * - * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. + * Updates a User Defined Field for a company. + * + * ### Security Policies + * + * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, CSPTester, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. * * This API depends on the following active services:*Required* (all): AvaTaxPro, BasicReturns. * Swagger Name: AvaTaxClient - * - * @param int $companyId The id of the company the user defined field belongs to. - * @param int $id + * + * @param int $companyId The id of the company the user defined field belongs to. + * @param int $id * @param CompanyUserDefinedFieldModel $model * @return CompanyUserDefinedFieldModel */ @@ -10894,25 +10894,25 @@ public function updateUserDefinedField($companyId, $id, $model) { 'query' => ['id' => $id], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Change Password * - * Allows a user to change their password via an API call. - * - * This API allows an authenticated user to change their password via an API call. This feature is only available - * for accounts that do not use SAML integrated password validation. - * - * This API only allows the currently authenticated user to change their password; it cannot be used to apply to a - * different user than the one authenticating the current API call. - * - * ### Security Policies - * + * Allows a user to change their password via an API call. + * + * This API allows an authenticated user to change their password via an API call. This feature is only available + * for accounts that do not use SAML integrated password validation. + * + * This API only allows the currently authenticated user to change their password; it cannot be used to apply to a + * different user than the one authenticating the current API call. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * + * * @param PasswordChangeModel $model An object containing your current password and the new password. * @return string */ @@ -10922,28 +10922,28 @@ public function changePassword($model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'PUT', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'PUT', $guzzleParams,'22.8.0' ); } /** * Create new users * - * Create one or more new user objects attached to this account. - * - * A user represents one person with access privileges to make API calls and work with a specific account. - * - * Users who are account administrators or company users are permitted to create user records to invite - * additional team members to work with AvaTax. - * - * A newly created user will receive an email inviting them to create their password. This means that you - * must provide a valid email address for all user accounts created. - * - * ### Security Policies - * + * Create one or more new user objects attached to this account. + * + * A user represents one person with access privileges to make API calls and work with a specific account. + * + * Users who are account administrators or company users are permitted to create user records to invite + * additional team members to work with AvaTax. + * + * A newly created user will receive an email inviting them to create their password. This means that you + * must provide a valid email address for all user accounts created. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * - * @param int $accountId The unique ID number of the account where these users will be created. + * + * @param int $accountId The unique ID number of the account where these users will be created. * @param UserModel[] $model The user or array of users you wish to create. * @return UserModel[] */ @@ -10953,25 +10953,25 @@ public function createUsers($accountId, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'POST', $guzzleParams,'22.8.0' ); } /** * Delete a single user * - * Mark the user object identified by this URL as deleted. - * - * This API is available for use by account and company administrators only. - * - * Account and company administrators may only delete users within the appropriate organizations - * they control. - * - * ### Security Policies - * + * Mark the user object identified by this URL as deleted. + * + * This API is available for use by account and company administrators only. + * + * Account and company administrators may only delete users within the appropriate organizations + * they control. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, BatchServiceAdmin, CompanyAdmin, Compliance Root User, CSPTester, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TreasuryAdmin. * Swagger Name: AvaTaxClient - * - * @param int $id The ID of the user you wish to delete. + * + * @param int $id The ID of the user you wish to delete. * @param int $accountId The accountID of the user you wish to delete. * @return ErrorDetail[] */ @@ -10981,26 +10981,26 @@ public function deleteUser($id, $accountId) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'DELETE', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'DELETE', $guzzleParams,'22.8.0' ); } /** * Retrieve a single user * - * Get the user object identified by this URL. - * A user represents one person with access privileges to make API calls and work with a specific account. - * - * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: - * - * * FetchDeleted - * - * ### Security Policies - * + * Get the user object identified by this URL. + * A user represents one person with access privileges to make API calls and work with a specific account. + * + * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: + * + * * FetchDeleted + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * - * @param int $id The ID of the user to retrieve. - * @param int $accountId The accountID of the user you wish to get. + * + * @param int $id The ID of the user to retrieve. + * @param int $accountId The accountID of the user you wish to get. * @param string $include Optional fetch commands. * @return UserModel */ @@ -11010,34 +11010,34 @@ public function getUser($id, $accountId, $include=null) { 'query' => ['$include' => $include], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve all entitlements for a single user * - * Return a list of all entitlements to which this user has rights to access. - * Entitlements are a list of specified API calls the user is permitted to make, a list of identifier numbers for companies the user is - * allowed to use, and an access level identifier that indicates what types of access roles the user is allowed to use. - * This API call is intended to provide a validation endpoint to determine, before making an API call, whether this call is likely to succeed. - * For example, if user 567 within account 999 is attempting to create a new child company underneath company 12345, you could preview the user's - * entitlements and predict whether this call would succeed: - * - * * Retrieve entitlements by calling '/api/v2/accounts/999/users/567/entitlements' . If the call fails, you do not have accurate - * credentials for this user. - * * If the 'accessLevel' field within entitlements is 'None', the call will fail. - * * If the 'accessLevel' field within entitlements is 'SingleCompany' or 'SingleAccount', the call will fail if the companies - * table does not contain the ID number 12345. - * * If the 'permissions' array within entitlements does not contain 'AccountSvc.CompanySave', the call will fail. - * - * For a full list of defined permissions, please use '/api/v2/definitions/permissions' . - * - * ### Security Policies - * + * Return a list of all entitlements to which this user has rights to access. + * Entitlements are a list of specified API calls the user is permitted to make, a list of identifier numbers for companies the user is + * allowed to use, and an access level identifier that indicates what types of access roles the user is allowed to use. + * This API call is intended to provide a validation endpoint to determine, before making an API call, whether this call is likely to succeed. + * For example, if user 567 within account 999 is attempting to create a new child company underneath company 12345, you could preview the user's + * entitlements and predict whether this call would succeed: + * + * * Retrieve entitlements by calling '/api/v2/accounts/999/users/567/entitlements' . If the call fails, you do not have accurate + * credentials for this user. + * * If the 'accessLevel' field within entitlements is 'None', the call will fail. + * * If the 'accessLevel' field within entitlements is 'SingleCompany' or 'SingleAccount', the call will fail if the companies + * table does not contain the ID number 12345. + * * If the 'permissions' array within entitlements does not contain 'AccountSvc.CompanySave', the call will fail. + * + * For a full list of defined permissions, please use '/api/v2/definitions/permissions' . + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * - * @param int $id The ID of the user to retrieve. + * + * @param int $id The ID of the user to retrieve. * @param int $accountId The accountID of the user you wish to get. * @return UserEntitlementModel */ @@ -11047,35 +11047,35 @@ public function getUserEntitlements($id, $accountId) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve users for this account * - * List all user objects attached to this account. - * A user represents one person with access privileges to make API calls and work with a specific account. - * - * When an API is called using a legacy AvaTax License Key, the API log entry is recorded as being performed by a special user attached to that license key. - * By default, this API will not return a listing of license key users. Users with registrar-level security may call this API to list license key users. - * - * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . - * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. - * - * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: - * - * * FetchDeleted - * - * ### Security Policies - * + * List all user objects attached to this account. + * A user represents one person with access privileges to make API calls and work with a specific account. + * + * When an API is called using a legacy AvaTax License Key, the API log entry is recorded as being performed by a special user attached to that license key. + * By default, this API will not return a listing of license key users. Users with registrar-level security may call this API to list license key users. + * + * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . + * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. + * + * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: + * + * * FetchDeleted + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * - * @param int $accountId The accountID of the user you wish to list. - * @param string $include Optional fetch commands. - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* SuppressNewUserEmail - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param int $accountId The accountID of the user you wish to list. + * @param string $include Optional fetch commands. + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* SuppressNewUserEmail + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -11085,36 +11085,36 @@ public function listUsersByAccount($accountId, $include=null, $filter=null, $top 'query' => ['$include' => $include, '$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Retrieve all users * - * Get multiple user objects across all accounts. - * - * A user represents one person or set of credentials with access privileges to make API calls and work with a specific account. A user can be authenticated - * via either username / password authentication, an OpenID / OAuth Bearer Token, or a legacy AvaTax License Key. - * - * When an API is called using a legacy AvaTax License Key, the API log entry is recorded as being performed by a special user attached to that license key. - * By default, this API will not return a listing of license key users. Users with registrar-level security may call this API to list license key users. - * - * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . - * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. - * - * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: - * - * * FetchDeleted - * - * ### Security Policies - * + * Get multiple user objects across all accounts. + * + * A user represents one person or set of credentials with access privileges to make API calls and work with a specific account. A user can be authenticated + * via either username / password authentication, an OpenID / OAuth Bearer Token, or a legacy AvaTax License Key. + * + * When an API is called using a legacy AvaTax License Key, the API log entry is recorded as being performed by a special user attached to that license key. + * By default, this API will not return a listing of license key users. Users with registrar-level security may call this API to list license key users. + * + * Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) . + * Paginate your results using the `$top`, `$skip`, and `$orderby` parameters. + * + * You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values: + * + * * FetchDeleted + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * - * @param string $include Optional fetch commands. - * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* SuppressNewUserEmail - * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. - * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. + * + * @param string $include Optional fetch commands. + * @param string $filter A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
*Not filterable:* SuppressNewUserEmail + * @param int $top If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records. + * @param int $skip If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets. * @param string $orderBy A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`. * @return FetchResult */ @@ -11124,24 +11124,24 @@ public function queryUsers($include=null, $filter=null, $top=null, $skip=null, $ 'query' => ['$include' => $include, '$filter' => $filter, '$top' => $top, '$skip' => $skip, '$orderBy' => $orderBy], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Update a single user * - * Replace the existing user object at this URL with an updated object. - * A user represents one person with access privileges to make API calls and work with a specific account. - * All data from the existing object will be replaced with data in the object you PUT. - * To set a field's value to null, you may either set its value to null or omit that field from the object you post. - * - * ### Security Policies - * + * Replace the existing user object at this URL with an updated object. + * A user represents one person with access privileges to make API calls and work with a specific account. + * All data from the existing object will be replaced with data in the object you PUT. + * To set a field's value to null, you may either set its value to null or omit that field from the object you post. + * + * ### Security Policies + * * * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. * Swagger Name: AvaTaxClient - * - * @param int $id The ID of the user you wish to update. - * @param int $accountId The accountID of the user you wish to update. + * + * @param int $id The ID of the user you wish to update. + * @param int $accountId The accountID of the user you wish to update. * @param UserModel $model The user object you wish to update. * @return UserModel */ @@ -11151,22 +11151,22 @@ public function updateUser($id, $accountId, $model) { 'query' => [], 'body' => json_encode($model) ]; - return $this->restCall($path, 'PUT', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'PUT', $guzzleParams,'22.8.0' ); } /** * Checks if the current user is subscribed to a specific service * - * Returns a subscription object for the current account, or 404 Not Found if this subscription is not enabled for this account. - * - * This API will return an error if it is called with invalid authentication credentials. - * - * This API is intended to help you determine whether you have the necessary subscription to use certain API calls - * within AvaTax. You can examine the subscriptions returned from this API call to look for a particular product - * or subscription to provide useful information to the current user as to whether they are entitled to use + * Returns a subscription object for the current account, or 404 Not Found if this subscription is not enabled for this account. + * + * This API will return an error if it is called with invalid authentication credentials. + * + * This API is intended to help you determine whether you have the necessary subscription to use certain API calls + * within AvaTax. You can examine the subscriptions returned from this API call to look for a particular product + * or subscription to provide useful information to the current user as to whether they are entitled to use * specific features of AvaTax. * Swagger Name: AvaTaxClient - * + * * @param string $serviceTypeId The service to check * @return SubscriptionModel */ @@ -11176,19 +11176,19 @@ public function getMySubscription($serviceTypeId) { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * List all services to which the current user is subscribed * - * Returns the list of all subscriptions enabled for the currently logged in user. - * - * This API will return an error if it is called with invalid authentication credentials. - * - * This API is intended to help you determine whether you have the necessary subscription to use certain API calls - * within AvaTax. You can examine the subscriptions returned from this API call to look for a particular product - * or subscription to provide useful information to the current user as to whether they are entitled to use + * Returns the list of all subscriptions enabled for the currently logged in user. + * + * This API will return an error if it is called with invalid authentication credentials. + * + * This API is intended to help you determine whether you have the necessary subscription to use certain API calls + * within AvaTax. You can examine the subscriptions returned from this API call to look for a particular product + * or subscription to provide useful information to the current user as to whether they are entitled to use * specific features of AvaTax. * Swagger Name: AvaTaxClient * @@ -11200,31 +11200,31 @@ public function listMySubscriptions() { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Tests connectivity and version of the service * - * Check connectivity to AvaTax and return information about the AvaTax API server. - * - * This API is intended to help you verify that your connection is working. This API will always succeed and will - * never return a error. It provides basic information about the server you connect to: - * - * * `version` - The version number of the AvaTax API server that responded to your request. The AvaTax API version number is updated once per month during Avalara's update process. - * * `authenticated` - A boolean flag indicating whether or not you sent valid credentials with your API request. - * * `authenticationType` - If you provided valid credentials to the API, this field will tell you whether you used Bearer, Username, or LicenseKey authentication. - * * `authenticatedUserName` - If you provided valid credentials to the API, this field will tell you the username of the currently logged in user. - * * `authenticatedUserId` - If you provided valid credentials to the API, this field will tell you the user ID of the currently logged in user. - * * `authenticatedAccountId` - If you provided valid credentials to the API, this field will contain the account ID of the currently logged in user. - * - * This API helps diagnose connectivity problems between your application and AvaTax; you may call this API even - * if you do not have verified connection credentials. If this API fails, either your computer is not connected to - * the internet, or there is a routing problem between your office and Avalara, or the Avalara server is not available. - * For more information on the uptime of AvaTax, please see [Avalara's AvaTax Status Page](https://status.avalara.com/). - * - * ### Security Policies - * + * Check connectivity to AvaTax and return information about the AvaTax API server. + * + * This API is intended to help you verify that your connection is working. This API will always succeed and will + * never return a error. It provides basic information about the server you connect to: + * + * * `version` - The version number of the AvaTax API server that responded to your request. The AvaTax API version number is updated once per month during Avalara's update process. + * * `authenticated` - A boolean flag indicating whether or not you sent valid credentials with your API request. + * * `authenticationType` - If you provided valid credentials to the API, this field will tell you whether you used Bearer, Username, or LicenseKey authentication. + * * `authenticatedUserName` - If you provided valid credentials to the API, this field will tell you the username of the currently logged in user. + * * `authenticatedUserId` - If you provided valid credentials to the API, this field will tell you the user ID of the currently logged in user. + * * `authenticatedAccountId` - If you provided valid credentials to the API, this field will contain the account ID of the currently logged in user. + * + * This API helps diagnose connectivity problems between your application and AvaTax; you may call this API even + * if you do not have verified connection credentials. If this API fails, either your computer is not connected to + * the internet, or there is a routing problem between your office and Avalara, or the Avalara server is not available. + * For more information on the uptime of AvaTax, please see [Avalara's AvaTax Status Page](https://status.avalara.com/). + * + * ### Security Policies + * * * This API may be called without providing authentication credentials. * Swagger Name: AvaTaxClient * @@ -11236,28 +11236,28 @@ public function ping() { 'query' => [], 'body' => null ]; - return $this->restCall($path, 'GET', $guzzleParams,'22.7.0' ); + return $this->restCall($path, 'GET', $guzzleParams,'22.8.0' ); } /** * Determines whether an individual meets or exceeds the minimum legal drinking age. * - * The request must meet the following criteria in order to be evaluated: - * * *firstName*, *lastName*, and *address* are required fields. - * * One of the following sets of attributes are required for the *address*: - * * *line1, city, region* - * * *line1, postalCode* - * - * Optionally, the transaction and its lines may use the following parameters: - * * A *DOB* (Date of Birth) field. The value should be ISO-8601 compliant (e.g. 2020-07-21). - * * Beyond the required *address* fields above, a *country* field is permitted - * * The valid values for this attribute are [*US, USA*] - * - * **Security Policies** + * The request must meet the following criteria in order to be evaluated: + * * *firstName*, *lastName*, and *address* are required fields. + * * One of the following sets of attributes are required for the *address*: + * * *line1, city, region* + * * *line1, postalCode* + * + * Optionally, the transaction and its lines may use the following parameters: + * * A *DOB* (Date of Birth) field. The value should be ISO-8601 compliant (e.g. 2020-07-21). + * * Beyond the required *address* fields above, a *country* field is permitted + * * The valid values for this attribute are [*US, USA*] + * + * **Security Policies** * This API depends on the active subscription *AgeVerification* * Swagger Name: AvaTaxBeverageClient - * - * @param string $simulatedFailureCode (Optional) The failure code included in the simulated response of the endpoint. Note that this endpoint is only available in Sandbox for testing purposes. + * + * @param string $simulatedFailureCode (Optional) The failure code included in the simulated response of the endpoint. Note that this endpoint is only available in Sandbox for testing purposes. * @param AgeVerifyRequest $model Information about the individual whose age is being verified. * @return AgeVerifyResult */ @@ -11267,7 +11267,7 @@ public function verifyAge($simulatedFailureCode, $model) { 'query' => ['simulatedFailureCode' => $simulatedFailureCode], 'body' => json_encode($model) ]; - return $this->restCall($path, 'POST', $guzzleParams,'' ); + return $this->restCall($path, 'POST', $guzzleParams,'' ); } /** @@ -11275,11 +11275,11 @@ public function verifyAge($simulatedFailureCode, $model) { * * * Swagger Name: AvaTaxBeverageClient - * - * @param string $companyCode The company code of the company that recorded the transaction - * @param string $transactionCode The transaction code to retrieve - * @param string $documentType (Optional): The document type of the transaction to operate on. If omitted, defaults to "SalesInvoice" - * @param string $api_version (Optional): API version that should satisfy the request. If omitted, defaults to 2.2 + * + * @param string $companyCode The company code of the company that recorded the transaction + * @param string $transactionCode The transaction code to retrieve + * @param string $documentType (Optional): The document type of the transaction to operate on. If omitted, defaults to "SalesInvoice" + * @param string $api_version (Optional): API version that should satisfy the request. If omitted, defaults to 2.2 * @param string $x_avalara_version (Optional): API version that should satisfy the request. If omitted, defaults to 2.2. Header takes precendence if both header and query parameters are present. * @return */ @@ -11289,8 +11289,8 @@ public function deregisterShipment($companyCode, $transactionCode, $documentType 'query' => ['documentType' => $documentType, 'api-version' => $api_version], 'body' => null ]; - $headerParams=['x-avalara-version' => $x_avalara_version]; - return $this->restCall($path, 'DELETE', $guzzleParams,'',$headerParams ); + $headerParams=['x-avalara-version' => $x_avalara_version]; + return $this->restCall($path, 'DELETE', $guzzleParams,'',$headerParams ); } /** @@ -11298,11 +11298,11 @@ public function deregisterShipment($companyCode, $transactionCode, $documentType * * * Swagger Name: AvaTaxBeverageClient - * - * @param string $companyCode The company code of the company that recorded the transaction - * @param string $transactionCode The transaction code to retrieve - * @param string $documentType (Optional): The document type of the transaction to operate on. If omitted, defaults to "SalesInvoice" - * @param string $api_version (Optional): API version that should satisfy the request. If omitted, defaults to 2.2 + * + * @param string $companyCode The company code of the company that recorded the transaction + * @param string $transactionCode The transaction code to retrieve + * @param string $documentType (Optional): The document type of the transaction to operate on. If omitted, defaults to "SalesInvoice" + * @param string $api_version (Optional): API version that should satisfy the request. If omitted, defaults to 2.2 * @param string $x_avalara_version (Optional): API version that should satisfy the request. If omitted, defaults to 2.2. Header takes precendence if both header and query parameters are present. * @return */ @@ -11312,8 +11312,8 @@ public function registerShipment($companyCode, $transactionCode, $documentType, 'query' => ['documentType' => $documentType, 'api-version' => $api_version], 'body' => null ]; - $headerParams=['x-avalara-version' => $x_avalara_version]; - return $this->restCall($path, 'PUT', $guzzleParams,'',$headerParams ); + $headerParams=['x-avalara-version' => $x_avalara_version]; + return $this->restCall($path, 'PUT', $guzzleParams,'',$headerParams ); } /** @@ -11321,11 +11321,11 @@ public function registerShipment($companyCode, $transactionCode, $documentType, * * * Swagger Name: AvaTaxBeverageClient - * - * @param string $companyCode The company code of the company that recorded the transaction - * @param string $transactionCode The transaction code to retrieve - * @param string $documentType (Optional): The document type of the transaction to operate on. If omitted, defaults to "SalesInvoice" - * @param string $api_version (Optional): API version that should satisfy the request. If omitted, defaults to 2.2 + * + * @param string $companyCode The company code of the company that recorded the transaction + * @param string $transactionCode The transaction code to retrieve + * @param string $documentType (Optional): The document type of the transaction to operate on. If omitted, defaults to "SalesInvoice" + * @param string $api_version (Optional): API version that should satisfy the request. If omitted, defaults to 2.2 * @param string $x_avalara_version (Optional): API version that should satisfy the request. If omitted, defaults to 2.2. Header takes precendence if both header and query parameters are present. * @return ShippingVerifyResult */ @@ -11335,35 +11335,35 @@ public function registerShipmentIfCompliant($companyCode, $transactionCode, $doc 'query' => ['documentType' => $documentType, 'api-version' => $api_version], 'body' => null ]; - $headerParams=['x-avalara-version' => $x_avalara_version]; - return $this->restCall($path, 'PUT', $guzzleParams,'',$headerParams ); + $headerParams=['x-avalara-version' => $x_avalara_version]; + return $this->restCall($path, 'PUT', $guzzleParams,'',$headerParams ); } /** * Evaluates a transaction against a set of direct-to-consumer shipping regulations. * - * The transaction and its lines must meet the following criteria in order to be evaluated: - * * The transaction must be recorded. Using a type of *SalesInvoice* is recommended. - * * A parameter with the name *AlcoholRouteType* must be specified and the value must be one of the following: '*DTC*', '*Retailer DTC*' - * * A parameter with the name *RecipientName* must be specified and the value must be the name of the recipient. - * * Each alcohol line must include a *ContainerSize* parameter that describes the volume of a single container. Use the *unit* field to specify one of the following units: '*Litre*', '*Millilitre*', '*gallon (US fluid)*', '*quart (US fluid)*', '*ounce (fluid US customary)*' - * * Each alcohol line must include a *PackSize* parameter that describes the number of containers in a pack. Specify *Count* in the *unit* field. - * * Each alcohol line must include a *AlcoholContent* parameter that describes the alcohol percentage by volume of the item. Specify *Percentage* in the *unit* field. If unable to provide this parameter, use version 2.1 of the API. - * - * Optionally, the transaction and its lines may use the following parameters: - * * The *ShipDate* parameter may be used if the date of shipment is different than the date of the transaction. The value should be ISO-8601 compliant (e.g. 2020-07-21). - * * The *RecipientDOB* parameter may be used to evaluate age restrictions. The value should be ISO-8601 compliant (e.g. 2020-07-21). - * * The *PurchaserDOB* parameter may be used to evaluate age restrictions. The value should be ISO-8601 compliant (e.g. 2020-07-21). - * * The *SalesLocation* parameter may be used to describe whether the sale was made *OnSite* or *OffSite*. *OffSite* is the default value. - * - * **Security Policies** + * The transaction and its lines must meet the following criteria in order to be evaluated: + * * The transaction must be recorded. Using a type of *SalesInvoice* is recommended. + * * A parameter with the name *AlcoholRouteType* must be specified and the value must be one of the following: '*DTC*', '*Retailer DTC*' + * * A parameter with the name *RecipientName* must be specified and the value must be the name of the recipient. + * * Each alcohol line must include a *ContainerSize* parameter that describes the volume of a single container. Use the *unit* field to specify one of the following units: '*Litre*', '*Millilitre*', '*gallon (US fluid)*', '*quart (US fluid)*', '*ounce (fluid US customary)*' + * * Each alcohol line must include a *PackSize* parameter that describes the number of containers in a pack. Specify *Count* in the *unit* field. + * * Each alcohol line must include a *AlcoholContent* parameter that describes the alcohol percentage by volume of the item. Specify *Percentage* in the *unit* field. If unable to provide this parameter, use version 2.1 of the API. + * + * Optionally, the transaction and its lines may use the following parameters: + * * The *ShipDate* parameter may be used if the date of shipment is different than the date of the transaction. The value should be ISO-8601 compliant (e.g. 2020-07-21). + * * The *RecipientDOB* parameter may be used to evaluate age restrictions. The value should be ISO-8601 compliant (e.g. 2020-07-21). + * * The *PurchaserDOB* parameter may be used to evaluate age restrictions. The value should be ISO-8601 compliant (e.g. 2020-07-21). + * * The *SalesLocation* parameter may be used to describe whether the sale was made *OnSite* or *OffSite*. *OffSite* is the default value. + * + * **Security Policies** * This API depends on all of the following active subscriptions: *AvaAlcohol, AutoAddress, AvaTaxPro* * Swagger Name: AvaTaxBeverageClient - * - * @param string $companyCode The company code of the company that recorded the transaction - * @param string $transactionCode The transaction code to retrieve - * @param string $documentType (Optional): The document type of the transaction to operate on. If omitted, defaults to "SalesInvoice" - * @param string $api_version (Optional): API version that should satisfy the request. If omitted, defaults to 2.2 + * + * @param string $companyCode The company code of the company that recorded the transaction + * @param string $transactionCode The transaction code to retrieve + * @param string $documentType (Optional): The document type of the transaction to operate on. If omitted, defaults to "SalesInvoice" + * @param string $api_version (Optional): API version that should satisfy the request. If omitted, defaults to 2.2 * @param string $x_avalara_version (Optional): API version that should satisfy the request. If omitted, defaults to 2.2. Header takes precendence if both header and query parameters are present. * @return ShippingVerifyResult */ @@ -11373,8 +11373,8 @@ public function verifyShipment($companyCode, $transactionCode, $documentType, $a 'query' => ['documentType' => $documentType, 'api-version' => $api_version], 'body' => null ]; - $headerParams=['x-avalara-version' => $x_avalara_version]; - return $this->restCall($path, 'GET', $guzzleParams,'',$headerParams ); + $headerParams=['x-avalara-version' => $x_avalara_version]; + return $this->restCall($path, 'GET', $guzzleParams,'',$headerParams ); } } diff --git a/src/Models.php b/src/Models.php index 0d297c2..1ab4b19 100644 --- a/src/Models.php +++ b/src/Models.php @@ -650,6 +650,14 @@ class AuditEvent * @var int */ public $transactionId; + /** + * @var string + */ + public $correlationId; + /** + * @var string + */ + public $avalaraUid; /** * @var int */ @@ -4136,6 +4144,37 @@ class CertExpressInvitationStatusModel */ public $invitation; } +/** + * + * Swagger Name: AvaTaxClient + */ +class ProblemDetails +{ + /** + * @var string + */ + public $type; + /** + * @var string + */ + public $title; + /** + * @var int + */ + public $status; + /** + * @var string + */ + public $detail; + /** + * @var string + */ + public $instance; + /** + * @var object + */ + public $extensions; +} /** * Contains information about a company's exemption certificate status. * @@ -10259,6 +10298,10 @@ class TransactionLineDetailModel * @var string LiabilityType identifies the party liable to file the tax. This field is used to filter taxes from reports and tax filings as appropriate. (See LiabilityType::* for a list of allowable values) */ public $liabilityType; + /** + * @var string ID of the AvaTax user creating the transaction. This field will be calculated by AvaTax based on the Company settings and the transaction details. + */ + public $avtUserBIN; } /** * Represents information about location types stored in a line