Version 3.12.0-RC-v2.1-21.1.01 release (#188)

Co-authored-by: DevCenter-DocuSign <[email protected]>

Author: mmallis87

CHANGELOG.md

@@ -1,7 +1,12 @@
 # DocuSign Java Client Changelog
 See [DocuSign Support Center](https://support.docusign.com/en/releasenotes/) for Product Release Notes.
 
-## [v3.11.0-RC2] - eSignature API v2.1-20.4.01 - 2020-01-20
+## [v3.12.0-RC1] - eSignature API v2.1-21.1.01 - 2021-04-13
+### Changed
+- Added support for version v2.1-21.1.01 of the DocuSign eSignature API.
+- Updated the SDK release version.
+
+## [v3.11.0-RC2] - eSignature API v2.1-20.4.01 - 2021-01-20
 ### Changed
 - Added support for version v2.1-20.4.01 of the DocuSign eSignature API.
 - Updated the SDK release version.

README.md

@@ -1,100 +1,74 @@
-# The Official DocuSign Java Client
+# The Official DocuSign eSignature Java Client SDK
 
 [![Build status][travis-image]][travis-url]
 [![Maven Central status][maven-image]][maven-url]
 
 ## Requirements
-
-- Java 1.9+
-- Free [Developer Sandbox](https://go.docusign.com/sandbox/productshot/?elqCampaignId=16531)
+*   Java 1.9+
+*   Free [developer account](https://go.docusign.com/sandbox/productshot/?elqCampaignId=16531)
 
 ## Compatibility
-
-- Java 1.9+
-
-## Note
-
-This open-source SDK is provided for cases where you would like to make additional changes that the SDK does not provide out-of-the-box. If you simply want to use the SDK with any of the examples shown in the [Developer Center](https://developers.docusign.com/esign-rest-api/code-examples), follow the installation instructions below.
+*   Java 1.9+
 
 ## Installation
+This SDK is provided as open source, which enables you to customize its functionality to suit your particular use case. To do so, download or clone the repository. If the SDK’s given functionality meets your integration needs, or if you’re working through our [code examples](https://developers.docusign.com/docs/esign-rest-api/how-to/) from the [DocuSign Developer Center](https://developers.docusign.com/), you merely need to install it by following the instructions below.
 
-Note: DocuSign uses **Eclipse** with **Maven** for testing purposes.
+**Note:** DocuSign uses Eclipse with Maven for testing purposes.
 
 ### Maven:
-
-1. In Eclipse, create a new project by selecting **File** -> **New** -> **Project**.
-2. In the **New Project Wizard** , expand **Maven** , then select **Maven Project.**
+1. In Eclipse, create a new project by selecting **File > New > Project**.
+2. In the New Project Wizard, expand **Maven,** then select **Maven Project.**
 3. Leave **Create a simple project** unchecked.
-4. Select **Next** , then provide a unique **Group** and **Artifact Id**.
-5. In the directory where you've saved your project, open the _pom.xml_ file.
-6. In the _pom.xml_ file, locate the **dependencies** node.
-7. Add:
-
-```
-<dependency>
-  <groupId>com.docusign</groupId>
-  <artifactId>docusign-esign-java</artifactId>
-  <version>3.11.0-RC2</version>
-</dependency>
-```
-
-8. If your project is still open, restart **Eclipse**.
+4. Select **Next,** then provide a unique **groupId** and **artifactId.**
+5. In the directory where you've saved your project, open the pom.xml file.
+6. In the pom.xml file, locate the `dependencies` node.
+7. Add:  
+    ```
+    <dependency>
+      <groupId>com.docusign</groupId>
+      <artifactId>docusign-esign-java</artifactId>
+      <version>3.12.0-RC1</version>
+    </dependency>
+    ```
+8. If your project is still open, restart Eclipse.
 
 ## Dependencies
-
 This client has the following external dependencies:
-
-- io.swagger:swagger-annotations:jar:1.5.17
-- org.glassfish.jersey.core:jersey-client:jar:2.29.1
-- org.glassfish.jersey.media:jersey-media-multipart:jar:2.29.1
-- org.glassfish.jersey.media:jersey-media-json-jackson:2.29.1
-- com.fasterxml.jackson.core:jackson-core:jar:2.10.1
-- com.fasterxml.jackson.core:jackson-annotations:jar:2.10.1
-- com.fasterxml.jackson.core:jackson-databind:2.10.1
-- com.fasterxml.jackson.datatype:jackson-datatype-joda:jar:2.10.1
-- com.brsanthu:migbase64:2.2
-- junit:junit:jar:4.12
-- com.apache.oltu.oauth2:org.apache.oltu.oauth2.client:1.0.2
-- com.auth0:java-jwt:3.4.1
-- org.bouncycastle:bcprov-jdk15on:1.60
-
-## Code Examples
-
-### Launchers
-
-DocuSign provides a sample application code referred to as a [Launcher](https://github.com/docusign/code-examples-java). The Launcher contains a set of 31 common use cases and associated source files. These examples use either DocuSign&#39;s [Authorization Code Grant](https://developers.docusign.com/esign-rest-api/guides/authentication/oauth2-code-grant) or [JSON Web Tokens (JWT)](https://developers.docusign.com/esign-rest-api/guides/authentication/oauth2-jsonwebtoken) flows.
-
-### Proof-of-concept applications
-
-If your goal is to create a proof-of-concept application, DocuSign provides a set of [Quick Start](https://github.com/docusign/qs-java) examples. The Quick Start examples are meant to be used with DocuSign's [OAuth Token Generator](https://developers.docusign.com/oauth-token-generator), which will allow you to generate tokens for the Demo/Sandbox environment only. These tokens last for eight hours and will enable you to build your proof-of-concept application without the need to fully implement an OAuth solution.
-
-## OAuth Implementations
-
-For details regarding which type of OAuth grant will work best for your DocuSign integration, see the [REST API Authentication Overview](https://developers.docusign.com/esign-rest-api/guides/authentication) guide located on the [DocuSign Developer Center](https://developers.docusign.com/esign-rest-api/guides/authentication).
-
-For security purposes, DocuSign recommends using the Authorization Code Grant flow.
-
-There are other use-case scenarios, such as **single page applications** (SPA) that use **Cross-Origin Resource Sharing** (CORS), or where there may not be a user to interact with your Service Account. For these use cases, DocuSign also supports [JWT](https://developers.docusign.com/esign-rest-api/guides/authentication/oauth2-jsonwebtoken) and [Implicit](https://developers.docusign.com/esign-rest-api/guides/authentication/oauth2-implicit) grants. For code examples, see the links below:
-
-- [JWT (JSON Web Token)](https://developers.docusign.com/esign-rest-api/guides/authentication/oauth2-jsonwebtoken)
-- [Implicit Grant] (https://developers.docusign.com/esign-rest-api/guides/authentication/oauth2-implicit)
+*   io.swagger:swagger-annotations:jar:1.5.17
+*   org.glassfish.jersey.core:jersey-client:jar:2.29.1
+*   org.glassfish.jersey.media:jersey-media-multipart:jar:2.29.1
+*   org.glassfish.jersey.media:jersey-media-json-jackson:2.29.1
+*   com.fasterxml.jackson.core:jackson-core:jar:2.10.1
+*   com.fasterxml.jackson.core:jackson-annotations:jar:2.10.1
+*   com.fasterxml.jackson.core:jackson-databind:2.10.1
+*   com.fasterxml.jackson.datatype:jackson-datatype-joda:jar:2.10.1
+*   com.brsanthu:migbase64:2.2
+*   junit:junit:jar:4.12
+*   com.apache.oltu.oauth2:org.apache.oltu.oauth2.client:1.0.2
+*   com.auth0:java-jwt:3.4.1
+*   org.bouncycastle:bcprov-jdk15on:1.60
+
+## Code examples
+You can find on our GitHub a self-executing package of code examples for the eSignature C# SDK, called a [Launcher](https://github.com/docusign/code-examples-java/blob/master/README.md), that demonstrates common use cases. You can also download a version preconfigured for your DocuSign developer account from [Quickstart](https://developers.docusign.com/docs/esign-rest-api/quickstart/). These examples can use either the [Authorization Code Grant](https://developers.docusign.com/esign-rest-api/guides/authentication/oauth2-code-grant) or [JSON Web Token (JWT)](https://developers.docusign.com/esign-rest-api/guides/authentication/oauth2-jsonwebtoken) authentication workflows.
+
+## OAuth implementations
+For details regarding which type of OAuth grant will work best for your DocuSign integration, see [Choose OAuth Type](https://developers.docusign.com/platform/auth/choose/) in the [DocuSign Developer Center](https://developers.docusign.com/).
+
+For security purposes, DocuSign recommends using the [Authorization Code Grant](https://developers.docusign.com/esign-rest-api/guides/authentication/oauth2-code-grant) flow.
 
 ## Support
-
 Log issues against this client through GitHub. We also have an [active developer community on Stack Overflow](https://stackoverflow.com/questions/tagged/docusignapi).
 
 ## License
+The DocuSign eSignature Java Client SDK is licensed under the [MIT License](https://github.com/docusign/docusign-java-client/blob/master/LICENSE).
 
-The DocuSign Java Client is licensed under the [MIT License](https://github.com/docusign/docusign-java-client/blob/master/LICENSE).
-
+### Additional resources
+*   [DocuSign Developer Center](https://developers.docusign.com/)
+*   [DocuSign API on Twitter](https://twitter.com/docusignapi)
+*   [DocuSign For Developers on LinkedIn](https://www.linkedin.com/showcase/docusign-for-developers/)
+*   [DocuSign For Developers on YouTube](https://www.youtube.com/channel/UCJSJ2kMs_qeQotmw4-lX2NQ)
 
 [travis-image]: https://img.shields.io/travis/docusign/docusign-java-client.svg?style=flat
 [travis-url]: https://travis-ci.org/docusign/docusign-java-client
 [maven-image]: https://img.shields.io/maven-central/v/com.docusign/docusign-esign-java.svg?style=flat
-[maven-url]: https://search.maven.org/#search%7Cga%7C1%7Cg%3A%22com.docusign%22
-
-### Additional Resources
-* [DocuSign Developer Center](https://developers.docusign.com)
-* [DocuSign API on Twitter](https://twitter.com/docusignapi)
-* [DocuSign For Developers on LinkedIn](https://www.linkedin.com/showcase/docusign-for-developers/)
-* [DocuSign For Developers on YouTube](https://www.youtube.com/channel/UCJSJ2kMs_qeQotmw4-lX2NQ)
+[maven-url]: https://search.maven.org/#search%7Cga%7C1%7Cg%3A%22com.docusign%22

build.gradle

@@ -2,7 +2,7 @@ apply plugin: 'idea'
 apply plugin: 'eclipse'
 
 group = 'com.docusign'
-version = '3.11.0-RC2'
+version = '3.12.0-RC1'
 
 buildscript {
     repositories {

pom.xml

@@ -4,7 +4,7 @@
   <artifactId>docusign-esign-java</artifactId>
   <packaging>jar</packaging>
   <name>docusign-esign-java</name>
-  <version>3.11.0-RC2</version>
+  <version>3.12.0-RC1</version>
   <description>The official DocuSign eSignature JAVA client is based on version 2 of the DocuSign REST API and provides libraries for JAVA application integration. It is recommended that you use this version of the library for new development.</description>
   <url>https://developers.docusign.com</url>
 
@@ -287,9 +287,9 @@
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
         <swagger-core-version>1.5.18</swagger-core-version>
         <jersey-version>2.29.1</jersey-version>
-        <jackson-version>2.12.1</jackson-version>
+        <jackson-version>2.10.1</jackson-version>
         <maven-plugin-version>1.0.0</maven-plugin-version>
-        <junit-version>4.13.1</junit-version>
+        <junit-version>4.12</junit-version>
         <oltu-version>1.0.2</oltu-version>
     </properties>
 </project>

src/main/java/com/docusign/esign/api/AccountsApi.java

@@ -2680,6 +2680,53 @@ public ReportInProductList getReportInProductList(String accountId) throws ApiEx
     return apiClient.invokeAPI(localVarPath, "GET", localVarQueryParams, localVarCollectionQueryParams, localVarPostBody, localVarHeaderParams, localVarFormParams, localVarAccept, localVarContentType, localVarAuthNames, localVarReturnType);
       }
 
+  /**
+   * Returns Account available seals for specified account.
+   * 
+   * @param accountId The external account number (int) or account ID Guid. (required)
+   * @return AccountSeals
+   * @throws ApiException if fails to make API call
+   */
+  public AccountSeals getSealProviders(String accountId) throws ApiException {
+    Object localVarPostBody = "{}";
+    
+    // verify the required parameter 'accountId' is set
+    if (accountId == null) {
+      throw new ApiException(400, "Missing the required parameter 'accountId' when calling getSealProviders");
+    }
+    
+    // create path and map variables
+    String localVarPath = "/v2.1/accounts/{accountId}/seals"
+      .replaceAll("\\{" + "accountId" + "\\}", apiClient.escapeString(accountId.toString()));
+
+    // query params
+    java.util.List<Pair> localVarQueryParams = new java.util.ArrayList<Pair>();
+    java.util.List<Pair> localVarCollectionQueryParams = new java.util.ArrayList<Pair>();
+    java.util.Map<String, String> localVarHeaderParams = new java.util.HashMap<String, String>();
+    java.util.Map<String, Object> localVarFormParams = new java.util.HashMap<String, Object>();
+
+    
+
+    
+
+    
+
+    final String[] localVarAccepts = {
+      "application/json"
+    };
+    final String localVarAccept = apiClient.selectHeaderAccept(localVarAccepts);
+
+    final String[] localVarContentTypes = {
+      
+    };
+    final String localVarContentType = apiClient.selectHeaderContentType(localVarContentTypes);
+
+    String[] localVarAuthNames = new String[] { "docusignAccessCode" };
+
+    GenericType<AccountSeals> localVarReturnType = new GenericType<AccountSeals>() {};
+    return apiClient.invokeAPI(localVarPath, "GET", localVarQueryParams, localVarCollectionQueryParams, localVarPostBody, localVarHeaderParams, localVarFormParams, localVarAccept, localVarContentType, localVarAuthNames, localVarReturnType);
+      }
+
   /**
    * Gets list of supported languages for recipient language setting.
    * 

src/main/java/com/docusign/esign/api/BillingApi.java

@@ -174,7 +174,7 @@ public DowngradRequestBillingInfoResponse getDowngradeRequestBillingInfo(String
 
   /**
    * Retrieves a billing invoice.
-   * Retrieves the specified invoice.   ###### Note: If the `pdfAvailable` property in the response is set to *true*, you can download a PDF version of the invoice. To download the PDF, make the call again and change the value of the `Accept` property in the header to `Accept: application/pdf`.  Privileges required: account administrator  The response returns a list of charges and information about the charges. Quantities are usually shown as 'unlimited' or an integer. Amounts are shown in the currency set for the account.  **Response** The following table provides a description of the different `chargeName` property values. The information will grow as more chargeable items are added to the system.  | chargeName | Description | | --- | --- | | id_check | IDÂ Check Charge | | in_person_signing | In Person Signing charge | | envelopes Included | Sent Envelopes for the account | | age_verify | Age verification check | | ofac | OFAC Check | | id_confirm | ID confirmation check | | student_authentication | STAN PIN authentication check | | wet_sign_fax | Pages for returning signed documents by fax | | attachment_fax | Pages for returning attachments by fax | | phone_authentication | Phone authentication charge | | powerforms | PowerForm envelopes sent | | signer_payments | Payment processing charge | | outbound_fax | Send by fax charge | | bulk_recipient_envelopes | Bulk Recipient Envelopes sent | | sms_authentications | SMS authentication charge | | saml_authentications | SAML authentication charge | | express_signer_certificate | DocuSign Express Certificate charge | | personal_signer_certificate | Personal Signer Certificate charge | | safe_certificate | SAFE BioPharma Signer Certificate charge | | seats | Included active seats charge | | open_trust_certificate | OpenTrust Signer Certificate charge | 
+   * Retrieves the specified invoice.   ###### Note: If the `pdfAvailable` property in the response is set to *true*, you can download a PDF version of the invoice. To download the PDF, make the call again and change the value of the `Accept` property in the header to `Accept: application/pdf`.  Privileges required: account administrator  The response returns a list of charges and information about the charges. Quantities are usually shown as 'unlimited' or an integer. Amounts are shown in the currency set for the account.  **Response** The following table provides a description of the different `chargeName` property values. The information will grow as more chargeable items are added to the system.  | chargeName | Description | | --- | --- | | id_check | ID Check Charge | | in_person_signing | In Person Signing charge | | envelopes Included | Sent Envelopes for the account | | age_verify | Age verification check | | ofac | OFAC Check | | id_confirm | ID confirmation check | | student_authentication | STAN PIN authentication check | | wet_sign_fax | Pages for returning signed documents by fax | | attachment_fax | Pages for returning attachments by fax | | phone_authentication | Phone authentication charge | | powerforms | PowerForm envelopes sent | | signer_payments | Payment processing charge | | outbound_fax | Send by fax charge | | bulk_recipient_envelopes | Bulk Recipient Envelopes sent | | sms_authentications | SMS authentication charge | | saml_authentications | SAML authentication charge | | express_signer_certificate | DocuSign Express Certificate charge | | personal_signer_certificate | Personal Signer Certificate charge | | safe_certificate | SAFE BioPharma Signer Certificate charge | | seats | Included active seats charge | | open_trust_certificate | OpenTrust Signer Certificate charge | 
    * @param accountId The external account number (int) or account ID Guid. (required)
    * @param invoiceId  (required)
    * @return BillingInvoice

src/main/java/com/docusign/esign/api/BulkEnvelopesApi.java

@@ -303,6 +303,7 @@ public class GetBulkSendBatchesOptions
   {
   private String batchIds = null;
   private String count = null;
+  private String searchText = null;
   private String startPosition = null;
   private String status = null;
   /*
@@ -325,6 +326,16 @@ public void setCount(String count) {
   public String getCount() {
     return this.count;
   }
+  /*
+   * 
+   */
+  public void setSearchText(String searchText) {
+    this.searchText = searchText;
+  }
+
+  public String getSearchText() {
+    return this.searchText;
+  }
   /*
    * 
    */
@@ -387,6 +398,8 @@ public BulkSendBatchSummaries getBulkSendBatches(String accountId, BulkEnvelopes
       localVarQueryParams.addAll(apiClient.parameterToPair("batch_ids", options.batchIds));
     }if (options != null) {
       localVarQueryParams.addAll(apiClient.parameterToPair("count", options.count));
+    }if (options != null) {
+      localVarQueryParams.addAll(apiClient.parameterToPair("search_text", options.searchText));
     }if (options != null) {
       localVarQueryParams.addAll(apiClient.parameterToPair("start_position", options.startPosition));
     }if (options != null) {