Merge pull request #233 from avadev/25.2.2

Update for 25.2.2

Author: svc-developer

Diff for: src/Constants.php

@@ -2,7 +2,7 @@
 namespace Avalara;
 use GuzzleHttp\Client;
 
-define('AVATAX_SDK_VERSION', '25.1.0');
+define('AVATAX_SDK_VERSION', '25.2.2');
 
 /*****************************************************************************
  *                                                                           *

Diff for: src/Methods.php

@@ -1461,7 +1461,7 @@ public function listCustomersForCertificate($companyId, $id, $include=null)    {
      * 
      * @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.   * histories - Retrieves the certificate update history   * jobs - Retrieves the jobs for this certificate   * logs - Retrieves the certificate log   * invalid_reasons - Retrieves invalid reasons for this certificate if the certificate is invalid   * custom_fields - Retrieves custom fields set for this 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/).<br />*Not filterable:* exemptionNumber, status, ecmsId, ecmsStatus, pdf, pages
+     * @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/).<br />*Not filterable:* exemptionNumber, 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`.
@@ -3072,6 +3072,35 @@ public function linkShipToCustomersToBillCustomer($companyId, $code, $model)
         return $this->restCall($path, 'POST', $guzzleParams, AVATAX_SDK_VERSION );
     }
 
+    /**
+     * Retrieves a list of active certificates for a specified customer within a company.
+     *
+     * This API is intended to identify whether a customer has any active certificates.
+     * 
+     * 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, ECMEssentials, ECMPro, ECMPremium, VEMPro, VEMPremium, ECMProComms, ECMPremiumComms.
+     * 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
+     * @return \stdClass
+     */
+    public function listActiveCertificatesForCustomer($companyId, $customerCode)    {
+        $path = "/api/v2/companies/{$companyId}/customers/{$customerCode}/certificates/active";
+        $guzzleParams = [
+            'query' => [],
+            'body' => null
+        ];
+        return $this->restCall($path, 'GET', $guzzleParams, AVATAX_SDK_VERSION );
+    }
+
     /**
      * Retrieve a customer's attributes
      *
@@ -3135,7 +3164,7 @@ public function listAttributesForCustomer($companyId, $customerCode)    {
      * @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.   * histories - Retrieves the certificate update history   * jobs - Retrieves the jobs for this certificate   * logs - Retrieves the certificate log   * invalid_reasons - Retrieves invalid reasons for this certificate if the certificate is invalid   * custom_fields - Retrieves custom fields set for this 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/).<br />*Not filterable:* exemptionNumber, status, ecmsId, ecmsStatus, pdf, pages
+     * @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/).<br />*Not filterable:* exemptionNumber, 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`.
@@ -3150,6 +3179,36 @@ public function listCertificatesForCustomer($companyId, $customerCode, $include=
         return $this->restCall($path, 'GET', $guzzleParams, AVATAX_SDK_VERSION );
     }
 
+    /**
+     * Retrieves a list of inactive certificates for a specified customer within a company.
+     *
+     * This API is used to retrieve inactive certificates for a customer. Inactive certificates may include expired, 
+     * revoked, or otherwise non-compliant certificates.
+     * 
+     * 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, ECMEssentials, ECMPro, ECMPremium, VEMPro, VEMPremium, ECMProComms, ECMPremiumComms.
+     * 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
+     * @return \stdClass
+     */
+    public function listInActiveCertificatesForCustomer($companyId, $customerCode)    {
+        $path = "/api/v2/companies/{$companyId}/customers/{$customerCode}/certificates/inactive";
+        $guzzleParams = [
+            'query' => [],
+            'body' => null
+        ];
+        return $this->restCall($path, 'GET', $guzzleParams, AVATAX_SDK_VERSION );
+    }
+
     /**
      * List valid certificates for a location
      *
@@ -9569,7 +9628,7 @@ public function getReport($id)    {
      * 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.
+     * * Begin a report by calling the report's Initiate API.
      * * 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.

Diff for: src/Models.php

@@ -1930,7 +1930,7 @@ class CertificateModel
      */
     public $exemptionReason;
     /**
-     * @var string The status of the certificate.
+     * @var string The status of the certificate.  Possible values for status COMPLETE,PENDING,PENDING-FUTURE,PENDING-MULTI,PENDING-SINGLE,REVOKED
      */
     public $status;
     /**
@@ -10461,6 +10461,10 @@ class MultiTaxFilingReturnModel
      * @var string The three-character filing calendar currency code for this return. For example if country is 'US' then currency is 'USD'. Similarly, if country is 'CA' then currency is 'CAD', etc.
      */
     public $filingCalendarCurrencyCode;
+    /**
+     * @var boolean Can the return be unlocked or not.
+     */
+    public $canUnlock;
     /**
      * @var FilingsTaxSummaryModel 
      */