Parcel data object

Author: Sander de Vos

src/Contracts/SendcloudContract.php

@@ -2,7 +2,8 @@
 
 namespace Soved\Laravel\Sendcloud\Contracts;
 
-use Soved\Laravel\Sendcloud\Data\RecipientData;
+use Soved\Laravel\Sendcloud\Data\ParcelData;
+use Soved\Laravel\Sendcloud\Data\SenderData;
 
 interface SendcloudContract
 {
@@ -15,7 +16,7 @@ public function getParcels(array $optionalParameters = []): array;
 
     public function getParcel(int $id): array;
 
-    public function createParcel(RecipientData $recipient, array $optionalParameters = []): array;
+    public function createParcel(ParcelData $parcel, SenderData $sender = null): array;
 
     public function shippingMethods(array $optionalParameters = []): array;
 }

src/Data/ParcelData.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace Soved\Laravel\Sendcloud\Data;
+
+class ParcelData extends RecipientData
+{
+    public int $sender_address;
+    public string $customs_invoice_nr;
+    public int $customs_shipment_type;
+    public string $external_reference;
+    public int $quantity;
+    public int $to_service_point;
+    public int $insured_value;
+    public int $total_insured_value;
+    public string $order_number;
+    public string $shipment_uuid;
+    public array $parcel_items;
+    public string $weight;
+    public bool $is_return;
+    public string $total_order_value;
+    public bool $request_label;
+    public bool $request_label_async;
+    public ShipmentData $shipment;
+    public bool $apply_shipping_rules;
+}

src/Data/RecipientData.php

@@ -5,11 +5,17 @@
 class RecipientData extends Data
 {
     public string $name;
+    public string $company_name;
     public string $address;
+    public string $address_2;
     public string $house_number;
     public string $city;
     public string $postal_code;
+    public string $to_post_number;
     public string $country;
+    public string $country_state;
+    public int $telephone;
+    public string $email;
 
     public array $required = [
         'name',

src/Data/SenderData.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace Soved\Laravel\Sendcloud\Data;
+
+class SenderData extends Data
+{
+    public string $from_name;
+    public string $from_company_name;
+    public string $from_address_1;
+    public string $from_address_2;
+    public string $from_house_number;
+    public string $from_city;
+    public string $from_postal_code;
+    public string $from_country;
+    public int $from_telephone;
+    public string $from_email;
+
+    public array $required = [
+        'from_name',
+        'from_address_1',
+        'from_house_number',
+        'from_city',
+        'from_postal_code',
+        'from_country',
+    ];
+}

src/Sendcloud.php

@@ -3,7 +3,8 @@
 namespace Soved\Laravel\Sendcloud;
 
 use Illuminate\Support\Facades\Http;
-use Soved\Laravel\Sendcloud\Data\RecipientData;
+use Soved\Laravel\Sendcloud\Data\ParcelData;
+use Soved\Laravel\Sendcloud\Data\SenderData;
 use Soved\Laravel\Sendcloud\Contracts\SendcloudContract;
 
 class Sendcloud implements SendcloudContract
@@ -24,9 +25,13 @@ public function getParcel(int $id): array
         return $this->request('get', $endpoint);
     }
 
-    public function createParcel(RecipientData $recipient, array $optionalParameters = []): array
+    public function createParcel(ParcelData $parcel, SenderData $sender = null): array
     {
-        $data = ['parcel' => $recipient->toArray() + $optionalParameters];
+        $data = ['parcel' => $parcel->toArray()];
+
+        if (! is_null($sender)) {
+            $data['parcel'] += $sender->toArray();
+        }
 
         return $this->request('post', self::PARCELS_ENDPOINT, $data);
     }