✨ add support for Findoc V1.12, Invoices V4.10, US Healthcare Cards V1.2

Author: sebastianMindee

docs/financial_document_v1.md

@@ -107,7 +107,7 @@ public class SimpleMindeeClient {
 ########
 Document
 ########
-:Mindee ID: f469a24d-3875-4a83-ad43-e0d5aa9da604
+:Mindee ID: a80ac0ee-26f6-4e2e-988a-960b240d5ba7
 :Filename: default_sample.jpg
 
 Inference
@@ -132,7 +132,7 @@ Prediction
   +---------------+--------+----------+---------------+
   | Base          | Code   | Rate (%) | Amount        |
   +===============+========+==========+===============+
-  |               |        | 5.00     | 9.75          |
+  | 195.00        |        | 5.00     | 9.75          |
   +---------------+--------+----------+---------------+
 :Supplier Payment Details:
 :Supplier Name: JOHN SMITH
@@ -184,7 +184,7 @@ Page 0
   +---------------+--------+----------+---------------+
   | Base          | Code   | Rate (%) | Amount        |
   +===============+========+==========+===============+
-  |               |        | 5.00     | 9.75          |
+  | 195.00        |        | 5.00     | 9.75          |
   +---------------+--------+----------+---------------+
 :Supplier Payment Details:
 :Supplier Name: JOHN SMITH
@@ -389,6 +389,24 @@ System.out.println(result.getDocument().getInference().getPrediction().getDocume
 System.out.println(result.getDocument().getInference().getPrediction().getDocumentType().value);
 ```
 
+## Document Type Extended
+**documentTypeExtended**: Document type extended.
+
+#### Possible values include:
+ - 'CREDIT NOTE'
+ - 'INVOICE'
+ - 'OTHER'
+ - 'OTHER_FINANCIAL'
+ - 'PAYSLIP'
+ - 'PURCHASE ORDER'
+ - 'QUOTE'
+ - 'RECEIPT'
+ - 'STATEMENT'
+
+```java
+System.out.println(result.getDocument().getInference().getPrediction().getDocumentTypeExtended().value);
+```
+
 ## Due Date
 **dueDate**: The date on which the payment is due.
 

docs/invoices_v4.md

@@ -107,7 +107,7 @@ public class SimpleMindeeClient {
 ########
 Document
 ########
-:Mindee ID: 86b1833f-138b-4a01-8387-860204b0e631
+:Mindee ID: b55db8f9-ae3b-4f05-b2f1-ec0ced5e5b70
 :Filename: default_sample.jpg
 
 Inference
@@ -131,7 +131,7 @@ Prediction
   +---------------+--------+----------+---------------+
   | Base          | Code   | Rate (%) | Amount        |
   +===============+========+==========+===============+
-  |               |        | 8.00     | 193.20        |
+  | 2145.00       |        | 8.00     | 193.20        |
   +---------------+--------+----------+---------------+
 :Supplier Payment Details:
 :Supplier Name: TURNPIKE DESIGNS
@@ -177,7 +177,7 @@ Page 0
   +---------------+--------+----------+---------------+
   | Base          | Code   | Rate (%) | Amount        |
   +===============+========+==========+===============+
-  |               |        | 8.00     | 193.20        |
+  | 2145.00       |        | 8.00     | 193.20        |
   +---------------+--------+----------+---------------+
 :Supplier Payment Details:
 :Supplier Name: TURNPIKE DESIGNS
@@ -351,6 +351,24 @@ System.out.println(result.getDocument().getInference().getPrediction().getDate()
 System.out.println(result.getDocument().getInference().getPrediction().getDocumentType().value);
 ```
 
+## Document Type Extended
+**documentTypeExtended**: Document type extended.
+
+#### Possible values include:
+ - 'CREDIT NOTE'
+ - 'INVOICE'
+ - 'OTHER'
+ - 'OTHER_FINANCIAL'
+ - 'PAYSLIP'
+ - 'PURCHASE ORDER'
+ - 'QUOTE'
+ - 'RECEIPT'
+ - 'STATEMENT'
+
+```java
+System.out.println(result.getDocument().getInference().getPrediction().getDocumentTypeExtended().value);
+```
+
 ## Due Date
 **dueDate**: The date on which the payment is due.
 

docs/us_healthcare_cards_v1.md

@@ -137,6 +137,15 @@ A `HealthcareCardV1Copay` implements the following attributes:
 * **serviceFees** (`Double`): The price of service.
 * **serviceName** (`String`): The name of service of the copay.
 
+#### Possible values include:
+ - primary_care
+ - emergency_room
+ - urgent_care
+ - specialist
+ - office_visit
+ - prescription
+
+
 # Attributes
 The following fields are extracted for Healthcare Card V1:
 
@@ -223,6 +232,13 @@ System.out.println(result.getDocument().getInference().getPrediction().getRxBin(
 System.out.println(result.getDocument().getInference().getPrediction().getRxGrp().value);
 ```
 
+## RX ID
+**rxId**: The ID number for prescription drug coverage.
+
+```java
+System.out.println(result.getDocument().getInference().getPrediction().getRxId().value);
+```
+
 ## RX PCN
 **rxPcn**: The PCN number for prescription drug coverage.
 

src/main/java/com/mindee/product/financialdocument/FinancialDocumentV1Document.java

@@ -20,7 +20,7 @@
 import lombok.Getter;
 
 /**
- * Financial Document API version 1.11 document data.
+ * Financial Document API version 1.12 document data.
  */
 @Getter
 @EqualsAndHashCode(callSuper = false)
@@ -72,6 +72,11 @@ public class FinancialDocumentV1Document extends Prediction {
    */
   @JsonProperty("document_type")
   protected ClassificationField documentType;
+  /**
+   * Document type extended.
+   */
+  @JsonProperty("document_type_extended")
+  protected ClassificationField documentTypeExtended;
   /**
    * The date on which the payment is due.
    */
@@ -218,6 +223,7 @@ public boolean isEmpty() {
       && this.shippingAddress == null
       && this.billingAddress == null
       && this.documentType == null
+      && this.documentTypeExtended == null
       && this.subcategory == null
       && this.category == null
       && this.totalTax == null
@@ -324,6 +330,9 @@ public String toString() {
     outStr.append(
         String.format(":Document Type: %s%n", this.getDocumentType())
     );
+    outStr.append(
+        String.format(":Document Type Extended: %s%n", this.getDocumentTypeExtended())
+    );
     outStr.append(
         String.format(":Purchase Subcategory: %s%n", this.getSubcategory())
     );

src/main/java/com/mindee/product/invoice/InvoiceV4Document.java

@@ -20,7 +20,7 @@
 import lombok.Getter;
 
 /**
- * Invoice API version 4.9 document data.
+ * Invoice API version 4.10 document data.
  */
 @Getter
 @EqualsAndHashCode(callSuper = false)
@@ -62,6 +62,11 @@ public class InvoiceV4Document extends Prediction {
    */
   @JsonProperty("document_type")
   protected ClassificationField documentType;
+  /**
+   * Document type extended.
+   */
+  @JsonProperty("document_type_extended")
+  protected ClassificationField documentTypeExtended;
   /**
    * The date on which the payment is due.
    */
@@ -187,6 +192,7 @@ public boolean isEmpty() {
       && this.shippingAddress == null
       && this.billingAddress == null
       && this.documentType == null
+      && this.documentTypeExtended == null
       && (this.lineItems == null || this.lineItems.isEmpty())
       );
   }
@@ -285,6 +291,9 @@ public String toString() {
     outStr.append(
         String.format(":Document Type: %s%n", this.getDocumentType())
     );
+    outStr.append(
+        String.format(":Document Type Extended: %s%n", this.getDocumentTypeExtended())
+    );
     String lineItemsSummary = "";
     if (!this.getLineItems().isEmpty()) {
       int[] lineItemsColSizes = new int[]{38, 14, 10, 12, 14, 14, 17, 12};

src/main/java/com/mindee/product/us/healthcarecard/HealthcareCardV1Document.java

@@ -12,7 +12,7 @@
 import lombok.Getter;
 
 /**
- * Healthcare Card API version 1.1 document data.
+ * Healthcare Card API version 1.2 document data.
  */
 @Getter
 @EqualsAndHashCode(callSuper = false)
@@ -74,6 +74,11 @@ public class HealthcareCardV1Document extends Prediction {
    */
   @JsonProperty("rx_grp")
   protected StringField rxGrp;
+  /**
+   * The ID number for prescription drug coverage.
+   */
+  @JsonProperty("rx_id")
+  protected StringField rxId;
   /**
    * The PCN number for prescription drug coverage.
    */
@@ -91,6 +96,7 @@ public boolean isEmpty() {
       && this.groupNumber == null
       && this.payerId == null
       && this.rxBin == null
+      && this.rxId == null
       && this.rxGrp == null
       && this.rxPcn == null
       && (this.copays == null || this.copays.isEmpty())
@@ -129,6 +135,9 @@ public String toString() {
     outStr.append(
         String.format(":RX BIN: %s%n", this.getRxBin())
     );
+    outStr.append(
+        String.format(":RX ID: %s%n", this.getRxId())
+    );
     outStr.append(
         String.format(":RX GRP: %s%n", this.getRxGrp())
     );

src/test/java/com/mindee/product/invoice/InvoiceV4Test.java

@@ -59,6 +59,7 @@ void whenEmptyDeserialized_mustHaveValidProperties() throws IOException {
     Assertions.assertNull(docPrediction.getShippingAddress().getValue());
     Assertions.assertNull(docPrediction.getBillingAddress().getValue());
     Assertions.assertInstanceOf(ClassificationField.class, docPrediction.getDocumentType());
+    Assertions.assertInstanceOf(ClassificationField.class, docPrediction.getDocumentTypeExtended());
     Assertions.assertTrue(docPrediction.getLineItems().isEmpty());
   }
 

src/test/java/com/mindee/product/us/healthcarecard/HealthcareCardV1Test.java

@@ -42,6 +42,7 @@ void whenEmptyDeserialized_mustHaveValidProperties() throws IOException {
     Assertions.assertNull(docPrediction.getGroupNumber().getValue());
     Assertions.assertNull(docPrediction.getPayerId().getValue());
     Assertions.assertNull(docPrediction.getRxBin().getValue());
+    Assertions.assertNull(docPrediction.getRxId().getValue());
     Assertions.assertNull(docPrediction.getRxGrp().getValue());
     Assertions.assertNull(docPrediction.getRxPcn().getValue());
     Assertions.assertTrue(docPrediction.getCopays().isEmpty());