void label docs (#29)

Author: j-r-j

docs/addressesValidateExample.md

@@ -12,6 +12,7 @@ Output
 The `validateAddresses` method returns an array of address validation result objects.
 
 Example
+==============================
 ```php
 use ShipEngine\ShipEngine;
 use ShipEngine\Message\ShipEngineException;

docs/createLabelFromRate.md

@@ -12,6 +12,7 @@ Output
 The `createLabelFromRate` method returns the label that was created.
 
 Example
+==============================
 ```php
 use ShipEngine\ShipEngine;
 use ShipEngine\Message\ShipEngineException;

docs/createLabelFromShipmentDetailsExample.md

@@ -11,6 +11,7 @@ Output
 The `createLabelFromShipmentDetails` method returns the label that was created.
 
 Example
+==============================
 ```php
 use ShipEngine\ShipEngine;
 use ShipEngine\Message\ShipEngineException;

docs/getRatesWithShipmentDetailsExample.md

@@ -12,6 +12,64 @@ The `getRatesWithShipmentDetails` method returns the rates that were calculated
 
 Example
 ==============================
+```php
+use ShipEngine\ShipEngine;
+use ShipEngine\Message\ShipEngineException;
+
+function getRatesWithShipmentDetailsDemoFunction() {
+    $client = new ShipEngine('API-Key');
+
+    $details = [
+      "rate_options" => [
+        "carrier_ids" => [
+          "se-423887"
+        ]
+      ],
+      "shipment" => [
+        "validate_address" => "no_validation",
+        "ship_to" => [
+          "name" => "Amanda Miller",
+          "phone" => "555-555-5555",
+          "address_line1" => "525 S Winchester Blvd",
+          "city_locality" => "San Jose",
+          "state_province" => "CA",
+          "postal_code" => "95128",
+          "country_code" => "US",
+          "address_residential_indicator" => "yes"
+        ],
+        "ship_from" => [
+          "company_name" => "Example Corp.",
+          "name" => "John Doe",
+          "phone" => "111-111-1111",
+          "address_line1" => "4008 Marathon Blvd",
+          "address_line2" => "Suite 300",
+          "city_locality" => "Austin",
+          "state_province" => "TX",
+          "postal_code" => "78756",
+          "country_code" => "US",
+          "address_residential_indicator" => "no"
+        ],
+        "packages" => [
+          [
+            "weight" => [
+              "value" => 1.0,
+              "unit" => "ounce"
+            ]
+          ]
+        ]
+      ]
+    ];
+
+    try {
+        print_r($client->getRatesWithShipmentDetails($details));
+    } catch (ShipEngineException $e) {
+        print_r($e -> getMessage());
+    }
+}
+
+getRatesWithShipmentDetailsDemoFunction();
+
+```
 
 ### Array of Shipment Rates
 ```php

docs/listCarriersExample.md

@@ -8,6 +8,7 @@ Output
 The `listCarriers` method returns an array of connected carrier accounts.
 
 Example
+==============================
 ```php
 use ShipEngine\ShipEngine;
 use ShipEngine\Message\ShipEngineException;

docs/voidLabelExample.md

@@ -0,0 +1,42 @@
+Void Label With Label Id
+================================
+[ShipEngine](www.shipengine.com) allows you to attempt to void a previously purchased label. Please see [our docs](https://www.shipengine.com/docs/labels/voiding/) to learn more about voiding a label.
+
+Input Parameters
+-------------------------------------
+
+The `voidLabelWithLabelId` method accepts a string that contains the label Id that is being voided.
+
+Output
+--------------------------------
+The `voidLabelWithLabelId` method returns an object that indicates the status of the void label request.
+
+Example
+==============================
+```php
+use ShipEngine\ShipEngine;
+use ShipEngine\Message\ShipEngineException;
+
+function voidLabelWithLabelIdDemoFunction() {
+  $client = new ShipEngine('API-Key');
+  try {
+    print_r($client->voidLabelWithLabelId('se-75449505'));
+  } catch (ShipEngineException $e) {
+    print_r($e -> getMessage());
+  }
+}
+
+voidLabelWithLabelIdDemoFunction();
+```
+
+Example Output
+-----------------------------------------------------
+
+### Successful Void Label
+```php
+Array
+(
+    [approved] =>
+    [message] => No shipment found within the allowed void period
+)
+```