chore(multiInvoices): add new methods for multiinvoice receipts

Author: raul-facturapi

CHANGELOG.md

@@ -5,6 +5,13 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.2.0] - 2026-04-27
+
+### Added
+
+- Add `receipts.multiInvoice(Map<String, Object> data)` for `POST /receipts/multi-invoice`.
+- Add `receipts.previewMultiInvoicePdf(Map<String, Object> data)` for `POST /receipts/multi-invoice/preview/pdf`.
+
 ## [1.2.0] - 2026-04-23
 
 ### Added

src/main/java/io/facturapi/resources/ReceiptsResource.java

@@ -75,6 +75,27 @@ public Invoice createGlobalInvoice(Map<String, Object> data) {
     return post("/receipts/global-invoice", data, null, Invoice.class);
   }
 
+  /**
+   * Creates a multi-invoice from a list of receipt keys.
+   * Supports both invoice response and dry-run summary response.
+   *
+   * @param data Multi-invoice payload.
+   * @return Invoice/summary response as a generic map.
+   */
+  public Map<String, Object> multiInvoice(Map<String, Object> data) {
+    return post("/receipts/multi-invoice", data, null, new TypeReference<Map<String, Object>>() {});
+  }
+
+  /**
+   * Generates a PDF preview for a multi-invoice payload.
+   *
+   * @param data Multi-invoice preview payload.
+   * @return PDF bytes.
+   */
+  public byte[] previewMultiInvoicePdf(Map<String, Object> data) {
+    return client.postBytes("/receipts/multi-invoice/preview/pdf", data);
+  }
+
   /**
    * Cancels a receipt.
    *

src/test/java/io/facturapi/FacturapiResourcesTest.java

@@ -44,6 +44,55 @@ void invoiceCreateUsesExpectedPath() {
     assertEquals("/v2/invoices?test=true", request.uri().getPath() + "?" + request.uri().getQuery());
   }
 
+  @Test
+  void receiptsMultiInvoiceUsesExpectedPath() {
+    StubHttpClient httpClient = new StubHttpClient();
+    httpClient.enqueueJson(200, "{\"id\":\"inv_multi_1\"}");
+
+    Facturapi sdk = new Facturapi(
+      FacturapiConfig.builder("sk_test")
+        .httpClient(httpClient.client())
+        .build()
+    );
+
+    var response = sdk.receipts().multiInvoice(
+      Map.of(
+        "keys", java.util.List.of("rec_1", "rec_2"),
+        "use", "G03"
+      )
+    );
+
+    assertEquals("inv_multi_1", response.get("id"));
+    var request = httpClient.requests().get(0);
+    assertEquals("POST", request.method());
+    assertEquals("/v2/receipts/multi-invoice", request.uri().getPath());
+    assertTrue(request.bodyUtf8().contains("\"keys\":[\"rec_1\",\"rec_2\"]"));
+  }
+
+  @Test
+  void receiptsPreviewMultiInvoicePdfReturnsBytes() {
+    StubHttpClient httpClient = new StubHttpClient();
+    httpClient.enqueueBinary(200, "PDF-MULTI".getBytes(StandardCharsets.UTF_8), "application/pdf");
+
+    Facturapi sdk = new Facturapi(
+      FacturapiConfig.builder("sk_test")
+        .httpClient(httpClient.client())
+        .build()
+    );
+
+    var pdfBytes = sdk.receipts().previewMultiInvoicePdf(
+      Map.of(
+        "keys", java.util.List.of("rec_1"),
+        "use", "G03"
+      )
+    );
+
+    assertEquals("PDF-MULTI", new String(pdfBytes, StandardCharsets.UTF_8));
+    var request = httpClient.requests().get(0);
+    assertEquals("POST", request.method());
+    assertEquals("/v2/receipts/multi-invoice/preview/pdf", request.uri().getPath());
+  }
+
   @Test
   void invoicePdfCanBeStreamed() throws Exception {
     StubHttpClient httpClient = new StubHttpClient();