Better support for import mappings

Author: stephangroen

README.md

@@ -111,6 +111,10 @@ $salesInvoices = $moneybird->salesInvoice()->filter([
   'state' => 'draft'
 ]);
 var_dump($salesInvoices); // Array with filtered SalesInvoice objects
+
+// Example: Get import mappings for contacts
+$mappings = $moneybird->importMapping()->setType('contact')->get();
+var_dump($mappings); // Array with ImportMapping objects
 ```
 
 ## Code example

src/Picqer/Financials/Moneybird/Actions/Filterable.php

@@ -17,7 +17,7 @@ public function filter(array $filters)
             $filterList[] = $key .':' . $value;
         }
 
-        $result = $this->connection()->get($this->url, ['filter' => implode(',', $filterList)]);
+        $result = $this->connection()->get($this->getUrl(), ['filter' => implode(',', $filterList)]);
 
         return $this->collectionFromResult($result);
     }

src/Picqer/Financials/Moneybird/Actions/FindAll.php

@@ -12,7 +12,7 @@ trait FindAll
      */
     public function get()
     {
-        $result = $this->connection()->get($this->url);
+        $result = $this->connection()->get($this->getUrl());
 
         return $this->collectionFromResult($result);
     }

src/Picqer/Financials/Moneybird/Actions/FindOne.php

@@ -12,7 +12,7 @@ trait FindOne {
      */
     public function find($id)
     {
-        $result = $this->connection()->get($this->url . '/' . urlencode($id));
+        $result = $this->connection()->get($this->getUrl() . '/' . urlencode($id));
 
         return $this->makeFromResponse($result);
     }

src/Picqer/Financials/Moneybird/Actions/Removable.php

@@ -11,7 +11,7 @@ trait Removable {
      */
     public function delete()
     {
-        return $this->connection()->delete($this->url . '/' . urlencode($this->id));
+        return $this->connection()->delete($this->getUrl() . '/' . urlencode($this->id));
     }
 
 }

src/Picqer/Financials/Moneybird/Actions/Storable.php

@@ -25,7 +25,7 @@ public function save()
      */
     public function insert()
     {
-        $result = $this->connection()->post($this->url, $this->jsonWithNamespace());
+        $result = $this->connection()->post($this->getUrl(), $this->jsonWithNamespace());
 
         return $this->selfFromResponse($result);
     }
@@ -35,7 +35,7 @@ public function insert()
      */
     public function update()
     {
-        $result = $this->connection()->patch($this->url . '/' . urlencode($this->id), $this->jsonWithNamespace());
+        $result = $this->connection()->patch($this->getUrl() . '/' . urlencode($this->id), $this->jsonWithNamespace());
 
         return $this->selfFromResponse($result);
     }

src/Picqer/Financials/Moneybird/Actions/Synchronizable.php

@@ -12,7 +12,7 @@ trait Synchronizable
      */
     public function listVersions()
     {
-        $result = $this->connection()->get($this->url . '/synchronization');
+        $result = $this->connection()->get($this->getUrl() . '/synchronization');
 
         return $this->collectionFromResult($result);
     }
@@ -23,7 +23,7 @@ public function listVersions()
      */
     public function getVersions(array $ids)
     {
-        $result = $this->connection()->post($this->url .'/synchronization', json_encode([
+        $result = $this->connection()->post($this->getUrl() .'/synchronization', json_encode([
             'ids' => $ids
         ]));
 

src/Picqer/Financials/Moneybird/Entities/ImportMapping.php

@@ -12,6 +12,8 @@ class ImportMapping extends Model {
 
     use FindAll, FindOne;
 
+    protected $type = null;
+
     /**
      * @var array
      */
@@ -26,4 +28,28 @@ class ImportMapping extends Model {
      * @var string
      */
     protected $url = 'import_mappings';
+
+    /**
+     * @param string $type The type of import mapping to request
+     *
+     * Type should be any of: financial_account bank_mutation contact document_attachment general_journal identity
+     * incoming_invoice attachment payment history invoice_attachment transaction ledger_account tax_rate product
+     * print_invoice recurring_template invoice workflow document_style
+     * @return $this
+     */
+    public function setType($type)
+    {
+        $this->type = $type;
+
+        return $this;
+    }
+
+    public function getUrl()
+    {
+        if (is_null($this->type)) {
+            return $this->url;
+        }
+
+        return $this->url . '/' . $this->type;
+    }
 }

src/Picqer/Financials/Moneybird/Model.php

@@ -329,4 +329,12 @@ public function __debugInfo()
         return $result;
     }
 
+    /**
+     * @return string
+     */
+    public function getUrl()
+    {
+        return $this->url;
+    }
+
 }