✨ feat: Added a new endpoint to change expire date of carnet

Author: guilherme-cota-efi

examples/charges/carnet/updateCarnetParcels.php

@@ -0,0 +1,55 @@
+<?php
+
+/**
+ * Detailed endpoint documentation
+ * https://dev.efipay.com.br/docs/api-cobrancas/carne#alterar-data-de-vencimento-de-parcela-do-carnê
+ */
+
+$autoload = realpath(__DIR__ . "/../../../vendor/autoload.php");
+if (!file_exists($autoload)) {
+	die("Autoload file not found or on path <code>$autoload</code>.");
+}
+require_once $autoload;
+
+use Efi\Exception\EfiException;
+use Efi\EfiPay;
+
+$options = __DIR__ . "/../../credentials/options.php";
+if (!file_exists($options)) {
+	die("Options file not found or on path <code>$options</code>.");
+}
+require $options;
+
+$params = [
+	"id" => 0
+];
+
+$body = [
+	"parcels" => [
+		[
+			"parcel" => 2,
+			"expire_at" => "2025-02-28"
+		],
+		[
+			"parcel" => 3,
+			"expire_at" => "2025-03-31"
+		],
+		[
+			"parcel" => 4,
+			"expire_at" => "2025-04-30"
+		]
+	]
+];
+
+try {
+	$api = new EfiPay($options);
+	$response = $api->updateCarnetParcels($params, $body);
+
+	print_r("<pre>" . json_encode($response, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES) . "</pre>");
+} catch (EfiException $e) {
+	print_r($e->code . "<br>");
+	print_r($e->error . "<br>");
+	print_r($e->errorDescription) . "<br>";
+} catch (Exception $e) {
+	print_r($e->getMessage());
+}

src/Efi/EfiPay.php

@@ -20,6 +20,7 @@
  * @method array createCarnet(array $params = [], array $body)
  * @method array detailCarnet(array $params)
  * @method array updateCarnetParcel(array $params, array $body)
+ * @method array updateCarnetParcels(array $params, array $body)
  * @method array updateCarnetMetadata(array $params, array $body)
  * @method array getNotification(array $params)
  * @method array listPlans(array $params)

src/Efi/config.json

@@ -62,6 +62,10 @@
                     "route": "/v1/carnet/:id/parcel/:parcel",
                     "method": "put"
                 },
+                "updateCarnetParcels": {
+                    "route": "/v1/carnet/:id/parcels",
+                    "method": "put"
+                },
                 "updateCarnetMetadata": {
                     "route": "/v1/carnet/:id/metadata",
                     "method": "put"