Application programming interface (API)

Verbinden met de API

Door middel van onderstaande code kan er verbinding gemaakt worden met de API.
Hierin dienen wel de juiste gegevens ingevuld te worden.
De API gebruikersnaam en wachtwoord zijn terug te vinden in het systeem onder voorkeuren.

	class UsernameToken
	{
		/**
		 * Username and password for authentication
		 * 
		 * @var string
		 */
		protected $_username;
		protected $_password;
	
		/**
		 * Constructor
		 * 
		 * @param string $username
		 * @param string $password
		 * @return void
		 */
		public function __construct($username, $password)
		{
			$this -> _username = $username;
			$this -> _password = $password;
		}
	}
	
	$xmlSoap = 'http://schemas.xmlsoap.org/ws/2002/07/utility/';   
	$usernameToken = new UsernameToken('username', 'password');
	$soapHeaders[] = new SoapHeader($xmlSoap, 'UsernameToken', $usernameToken);
	
	$client = new SoapClient('http://demo.clearbalance.nl/api/wsdl', array('trace' => true, 'exceptions' => true));
	$client -> __setSoapHeaders($soapHeaders);

Controleren of een debiteur bestaat op basis van het e-mailadres

Door middel van deze functie kan er gecontroleerd worden of een debiteur bestaat. Als de debiteur niet bestaat zal er als resultaat 0 terugkomen.

	$client -> checkEmailExists('emailaddress');

Toevoegen nieuwe debiteur

Door middel van deze functie kan er een nieuwe debiteur toegevoegd worden. Hierbij zal er automatisch een debiteurCode aangemaakt worden.

	$client -> insertDebtor(
		array(
			'debGender' 			=> 0, // 0 = dhr / 1 = mevr //required
			'debFirstname' 			=> 'Voornaam', //required
			'debSurname' 			=> 'Achternaam', //required
			'debAddress' 			=> 'Adres',
			'debZipcode' 			=> '1234AA',
			'debPlace' 			=> 'Plaats',
			'debCountry' 			=> 'Nederland',
			'debEmail' 			=> '
 Dit e-mailadres wordt beveiligd tegen spambots. JavaScript dient ingeschakeld te zijn om het te bekijken.
 ', //required
			'debCompanyname' 		=> 'Bedrijfsnaam',
			'debLegal' 			=> 0, //particulier 
			'debKvknr' 			=> '0000',
			'debVatnr' 			=> '0000',
			'debPhonenr' 			=> '0000',
			'debFaxnr' 			=> '0000',
			'debMobnr' 			=> '0000',
			'debPaymentBillnr' 		=> '0000',
			'debPaymentTnv' 		=> 'Voornaam Achternaam',
			'debPaymentBank' 		=> 'ING',
			'debPaymentPlace' 		=> 'Plaats bank',
			'debPaymentIBANnr' 		=> '0000',
			'debPaymentBICnr' 		=> '0000',
			'debNote'			=> 'notitie',
			'debNoteView'			=> 0
		)
	);

Toevoegen nieuwe factuur

Door middel van deze functie kan er een nieuwe factuur toegevoegd worden. Hierbij zal er automatisch een factuurCode aangemaakt worden.

	$client -> insertInvoice(
		array(
			'inv_debID' 			=> debtorId,
			'invExcl' 			=> 100, // calculate the price excl before adding
			'invIncl' 			=> 119, // calculate the price incl before adding
			'invVat' 			=> 19,
			'invPayment' 			=> 14, 
			'invDiscount' 			=> 0,
			'invSend' 			=> 0, 
			'invSendMethod' 		=> 0,
			'invStatus' 			=> 0,
			'invTemplate'			=> 0,
			// for each item, change 0 with 1 etc
			'invi_prodID0'			=> 0,
			'invi_subscriptionID0' 		=> 0,
			'inviCount0'			=> 1,
			'inviDesc0'			=> '',
			'inviExcl0'			=> 0,
			'inviVat0'			=> 0,
			'inviPeriodic0'			=> 0,
			'inviPeriod0'			=> 0
		)
	);

Toevoegen nieuwe offerte

Door middel van deze functie kan er een nieuwe offerte toegevoegd worden. Hierbij zal er automatisch een offerteCode aangemaakt worden.

	$client -> insertQuote(
		array(
			'quote_debID' 			=> debtorId,
			'quoteExcl' 			=> 100, // calculate the price excl before adding
			'quoteIncl' 			=> 119, // calculate the price incl before adding
			'quoteVat' 			=> 19,
			'quoteValidityQuote' 		=> 30, 
			'quoteDiscount' 		=> 0,
			'quoteSend' 			=> 0, 
			'quoteSendMethod' 		=> 0,
			'quoteStatus' 			=> 0,
			'quoteTemplate'		=> 0,
			'quotePaymentTerms'	=> '',
			// for each item, change 0 with 1 etc
			'quotei_prodID0'		=> 0,
			'quoteiCount0'			=> 1,
			'quoteiDesc0'			=> '',
			'quoteiExcl0'			=> 0,
			'quoteiVat0'			=> 0
		)
	);

Ophalen facturen van een debiteur

Door middel van deze functie kunnen alle gegevens van een bepaalde debiteur opgehaald worden.

	$client -> getInvoicesByDebtor(debtorId)

Ophalen van een product

Door middel van deze functie kunnen alle gegevens van een bepaald product opgehaald worden.

	$client -> getProduct(productId);

Ophalen van alle producten

Door middel van deze functie kunnen alle gegevens van alle producten opgehaald worden.

	$client -> getProducts();

De plus van ClearBalance Software

  • Snel en makkelijk in gebruik
  • Krachtige- en complexe functies
  • API's (makkelijk te koppelen met andere CRM software)

Gebruiksvriendelijkheid & Veiligheid

  • Dagelijkse back-up
  • Overdracht van gegevens gaat via een SSL-Certificaat
  • Jij bepaalt wie, waar en wanneer toegang heeft