Merge pull request #28 from mbarreiro85/feature/add-proprietary_uid

invoices with idempotency keys

Author: tiagof

src/API/Endpoints/Concerns/CreatesWithType.php

@@ -21,12 +21,15 @@ trait CreatesWithType
      * @throws RequestException
      * @throws UnknownAPIMethodException
      */
-    public function create(EntityTypeEnum $entityType, EntityData $data): EntityData
+    public function create(EntityTypeEnum $entityType, EntityData $data, array $extraData = []): EntityData
     {
         $response = $this->call(
             action: static::CREATE,
             urlParams: ['type' => $entityType->toUrlVariable()],
-            bodyData: [$entityType->value => $data->toCreateData()->toArray()]
+            bodyData: [
+                $entityType->value => $data->toCreateData()->toArray(),
+                ...$extraData,
+            ]
         );
 
         return $this->responseToDataObject($response[$entityType->value]);

src/API/Endpoints/InvoicesEndpoint.php

@@ -19,6 +19,7 @@
 use Squarebit\InvoiceXpress\API\Endpoints\Concerns\RelatedDocuments;
 use Squarebit\InvoiceXpress\API\Endpoints\Concerns\SendsByEmail;
 use Squarebit\InvoiceXpress\API\Endpoints\Concerns\UpdatesWithType;
+use Squarebit\InvoiceXpress\Enums\EntityTypeEnum;
 
 /**
  * @template-extends Endpoint<InvoiceData>
@@ -29,7 +30,7 @@ class InvoicesEndpoint extends Endpoint
     use ChangesState;
 
     /** @use CreatesWithType<InvoiceData> */
-    use CreatesWithType;
+    use CreatesWithType { create as createWithType; }
 
     use GeneratesAndCancelsPayment;
     use GeneratesPDF;
@@ -60,4 +61,14 @@ protected function getEndpointName(): string
     {
         return static::ENDPOINT_CONFIG;
     }
+
+    public function create(EntityTypeEnum $entityType, InvoiceData $data, ?string $proprietaryUid = null): InvoiceData
+    {
+        $extra = [];
+        if ($proprietaryUid) {
+            $extra['proprietary_uid'] = $proprietaryUid;
+        }
+
+        return $this->createWithType($entityType, $data, $extra);
+    }
 }