Initial integration with Quickbooks

app/Classes/External/Accounting.php

@@ -0,0 +1,7 @@
+<?php
+
+namespace App\Classes\External;
+
+abstract class Accounting
+{
+}

app/Classes/External/Accounting/Quickbooks.php

@@ -0,0 +1,50 @@
+<?php
+
+namespace App\Classes\External\Accounting;
+
+use Illuminate\Support\Collection;
+use Illuminate\Support\Facades\Auth;
+use Illuminate\Support\Facades\Cache;
+
+use QuickBooksOnline\API\Data\IPPCustomer;
+use QuickBooksOnline\API\Facades\Customer;
+
+use App\User;
+use App\Classes\External\Accounting as Base;
+
+class Quickbooks extends Base
+{
+	private $api = NULL;
+
+	public function __construct(User $uo)
+	{
+		if (Auth::user())
+			throw new \Exception('User logged in - *TODO* handle this');
+
+		Auth::loginUsingId($uo->id);
+
+		$this->api = app('Spinen\QuickBooks\Client');
+	}
+
+	public function getCustomers($refresh=FALSE): Collection
+	{
+		if ($refresh)
+			Cache::forget(__METHOD__);
+
+		return Cache::remember(__METHOD__,86400,function() {
+			return collect($this->api->getDataService()->Query('SELECT * FROM Customer'));
+		});
+	}
+
+	public function updateCustomer(IPPCustomer $r,array $args)
+	{
+		$r->sparse = TRUE;
+
+		foreach ($args as $k=>$v)
+		{
+			$r->{$k} = $v;
+		}
+
+		return $this->api->getDataService()->Update($r);
+	}
+}

app/Console/Commands/QuickAccounts.php

@@ -0,0 +1,269 @@
+<?php
+
+namespace App\Console\Commands;
+
+use App\User;
+use Illuminate\Console\Command;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Log;
+
+use App\Classes\External\Accounting\Quickbooks;
+use App\Models\Account;
+use App\Models\External\Integrations;
+use QuickBooksOnline\API\Data\IPPEmailAddress;
+use QuickBooksOnline\API\Data\IPPPhysicalAddress;
+
+class QuickAccounts extends Command
+{
+	/**
+	 * The name and signature of the console command.
+	 *
+	 * @var string
+	 */
+	protected $signature = 'external:sync:accounts {--m|match : Match Display Name}';
+
+	/**
+	 * The console command description.
+	 *
+	 * @var string
+	 */
+	protected $description = 'Sync Account numbers with External Sources';
+
+	/**
+	 * Create a new command instance.
+	 *
+	 * @return void
+	 */
+	public function __construct()
+	{
+		parent::__construct();
+	}
+
+	/**
+	 * Execute the console command.
+	 *
+	 * @return mixed
+	 * @throws \Exception
+	 */
+	public function handle()
+	{
+		DB::listen(function($query) {
+			Log::debug('- SQL',['sql'=>$query->sql,'binding'=>$query->bindings]);
+		});
+
+		foreach (Integrations::active()->type('ACCOUNTING')->get() as $into)
+		{
+			switch ($into->name)
+			{
+				case 'quickbooks':
+					$api = new Quickbooks($into->user);
+					break;
+
+				default:
+					throw new \Exception('No handler for: ',$into-name);
+			}
+
+			foreach ($api->getCustomers(TRUE) as $r)
+			{
+				$this->info(sprintf('Checking [%s] (%s)',$r->Id,$r->DisplayName));
+
+				if ($r->Notes == 'Cash Only')
+				{
+					$this->warn(sprintf('Skipping [%s] (%s)',$r->Id,$r->DisplayName));
+					continue;
+				}
+
+				if (! $this->option('match') AND (! $r->CompanyName AND (! $r->FamilyName AND ! $r->GivenName)))
+				{
+					$this->error(sprintf('No COMPANY or PERSONAL details for [%s] (%s)',$r->Id,$r->DisplayName));
+					continue;
+				}
+
+				if ($this->option('match')) {
+					$ao = Account::where('company',$r->DisplayName);
+
+					if (! $ao->count()) {
+						$uo = User::where('lastname',$r->FamilyName);
+
+						if ($r->GivenName)
+							$uo->where('firstname',$r->GivenName);
+
+						if ($uo->count() > 1 OR (! $uo->count()))
+						{
+							$this->error(sprintf('No SINGLE Users matched for [%s] (%s)',$r->Id,$r->DisplayName));
+							continue;
+						}
+
+						$uo = $uo->first();
+						$ao = $uo->accounts->where('active',TRUE);
+					}
+
+				} else {
+					if ($r->CompanyName) {
+						$ao = Account::where('company',$this->option('match') ? $r->DisplayName : $r->CompanyName);
+					} else {
+						$uo = User::where('lastname',$r->FamilyName);
+
+						if ($r->GivenName)
+							$uo->where('firstname',$r->GivenName);
+
+						if ($uo->count() > 1 OR (! $uo->count()))
+						{
+							$this->error(sprintf('No SINGLE matched for [%s] (%s)',$r->Id,$r->DisplayName));
+							continue;
+						}
+
+						$uo = $uo->first();
+						$ao = $uo->accounts->where('active',TRUE);
+					}
+				}
+
+				if (! $ao->count())
+				{
+					$this->error(sprintf('No Accounts matched for [%s] (%s)',$r->Id,$r->DisplayName));
+					continue;
+				}
+
+				if ($ao->count() > 1)
+				{
+					$this->error(sprintf('Too Many Accounts (%s) matched for [%s] (%s)',$ao->count(),$r->Id,$r->DisplayName));
+					continue;
+				}
+
+				$ao = $ao->first();
+
+				// If we are matching on DisplayName, make sure the account is updated correct for Business or Personal Accounts
+				$oldr = clone $r;
+
+				// @NOTE: This overwrites the ABN if it exists.
+				if ($r->PrimaryTaxIdentifier)
+				{
+					$this->warn(sprintf('ABN Overwrite for (%s)',$r->DisplayName));
+				}
+
+				switch ($ao->type)
+				{
+					case 'Business':
+						$r->CompanyName = $ao->company;
+						$r->ResaleNum = $ao->AccountId;
+						$r->SalesTermRef = '7'; // @todo
+
+						if ($ao->first_name)
+							$r->GivenName = chop($ao->user->firstname); // @todo shouldnt be required
+						if ($ao->last_name)
+							$r->FamilyName = $ao->user->lastname;
+
+						if ($ao->address1)
+						{
+							if (! $r->BillAddr)
+								$r->BillAddr = new IPPPhysicalAddress;
+
+							$r->BillAddr->Line1 = $ao->user->address1;
+							$r->BillAddr->Line2 = $ao->user->address2;
+							$r->BillAddr->City = $ao->user->city;
+							$r->BillAddr->CountrySubDivisionCode = strtoupper($ao->user->state);
+							$r->BillAddr->PostalCode = $ao->user->postcode;
+							$r->BillAddr->Country = 'Australia'; // @todo
+
+							//$r->ShipAddr = $r->BillAddr;
+						}
+
+						if ($ao->email) {
+							if (! $r->PrimaryEmailAddr)
+								$r->PrimaryEmailAddr = new IPPEmailAddress;
+
+							$r->PrimaryEmailAddr->Address = $ao->user->email;
+							$r->PreferredDeliveryMethod = 'Email';
+						}
+
+						if (! $r->Balance)
+							$r->Active = $ao->active ? 'true' : 'false';
+
+						break;
+
+					case 'Private':
+						$r->CompanyName = NULL;
+						$r->DisplayName = sprintf('%s %s',$ao->user->lastname,$ao->user->firstname);
+						$r->ResaleNum = $ao->AccountId;
+						$r->SalesTermRef = '7'; // @todo
+
+						if ($ao->first_name)
+							$r->GivenName = chop($ao->user->firstname); // @todo shouldnt be required
+						if ($ao->last_name)
+							$r->FamilyName = $ao->user->lastname;
+
+						if ($ao->address1)
+						{
+							if (! $r->BillAddr)
+								$r->BillAddr = new IPPPhysicalAddress;
+
+							$r->BillAddr->Line1 = $ao->user->address1;
+							$r->BillAddr->Line2 = $ao->user->address2;
+							$r->BillAddr->City = $ao->user->city;
+							$r->BillAddr->CountrySubDivisionCode = strtoupper($ao->user->state);
+							$r->BillAddr->PostalCode = $ao->user->postcode;
+							$r->BillAddr->Country = 'Australia'; // @todo
+
+							//$r->ShipAddr = $r->BillAddr;
+						}
+
+						if ($ao->email) {
+							if (! $r->PrimaryEmailAddr)
+								$r->PrimaryEmailAddr = new IPPEmailAddress;
+
+							$r->PrimaryEmailAddr->Address = $ao->user->email;
+							$r->PreferredDeliveryMethod = 'Email';
+						}
+
+						if (! $r->Balance)
+							$r->Active = $ao->active ? 'true' : 'false';
+
+						break;
+
+					default:
+						throw new \Exception('Unhandled account type: '.$ao->type);
+
+				}
+
+				// If something changed, lets update it.
+				if (count(array_diff_assoc(object_to_array($r,FALSE),object_to_array($oldr,FALSE))))
+				{
+					$api->updateCustomer($r,[]);
+				}
+
+				// If external integration doesnt exist, lets create it.
+				if (! $ao->ExternalAccounting($into))
+				{
+					$ao->external()->attach([$into->id=>['site_id'=>1,'link'=>$r->Id]]); // @todo site_id
+				}
+
+				// If the integration ID doesnt exist in the integration source, add it.
+				if (! $r->ResaleNum)
+				{
+					$api->updateCustomer($r,['ResaleNum'=>$ao->AccountId]);
+				}
+
+				// If integration exist, double check the numbers match
+				if ($r->ResaleNum != $ao->AccountId) {
+					$this->warn(sprintf('Integration ID Mismatch AID [%s] ID [%s]',$ao->id,$r->Id));
+					continue;
+				}
+			}
+		}
+	}
+}
+
+function object_to_array($object,$encode=TRUE)
+{
+	// For child arrays, we just encode
+	if ($encode)
+		return json_encode($object);
+
+	if (is_object($object)) {
+		return array_map(__FUNCTION__,get_object_vars($object));
+	} else if (is_array($object)) {
+		return array_map(__FUNCTION__,$object);
+	} else {
+		return $object;
+	}
+}

app/Models/Account.php

@@ -36,6 +36,11 @@ class Account extends Model
 		return $this->belongsTo(Country::class);
 	}
 
+	public function external()
+	{
+		return $this->belongsToMany(External\Integrations::class,'external_account',NULL,'external_integration_id');
+	}
+
 	public function invoices()
 	{
 		return $this->hasMany(Invoice::class);
@@ -91,6 +96,11 @@ class Account extends Model
 		return sprintf('<a href="/r/switch/start/%s"><i class="fa fa-external-link"></i></a>',$this->user_id);
 	}
 
+	public function getTypeAttribute()
+	{
+		return $this->company ? 'Business' : 'Private';
+	}
+
 	private function _address()
 	{
 		$return = [];
@@ -131,4 +141,19 @@ class Account extends Model
 			return $item->active AND $item->due > 0;
 		});
 	}
+
+	/**
+	 * Get the external account ID for a specific integration
+	 *
+	 * @param External\Integrations $o
+	 * @return mixed
+	 */
+	public function ExternalAccounting(External\Integrations $o)
+	{
+		return $this
+			->external()
+			->where('id','=',$o->id)
+			->where('site_id','=',$this->site_id)
+			->first();
+	}
 }

app/Models/External/Integrations.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace App\Models\External;
+
+use Illuminate\Database\Eloquent\Model;
+
+use App\User;
+
+class Integrations extends Model
+{
+	public $table = 'external_integrations';
+
+	public function user()
+	{
+		return $this->belongsTo(User::class);
+	}
+
+	function scopeActive()
+	{
+		return $this->where('active',TRUE);
+	}
+
+	function scopeType($query,string $type)
+	{
+		return $query->where('type',$type);
+	}
+}

app/User.php

@@ -10,10 +10,11 @@ use Leenooks\Carbon;
 use Leenooks\Traits\UserSwitch;
 use App\Notifications\ResetPasswordNotification;
 use App\Models\Service;
+use Spinen\QuickBooks\HasQuickBooksToken;
 
 class User extends Authenticatable
 {
-    use HasApiTokens,Notifiable,UserSwitch;
+    use HasApiTokens,Notifiable,UserSwitch,HasQuickBooksToken;
 
 	protected $dates = ['created_at','updated_at','last_access'];
 	protected $with = ['accounts.services'];