// Adding a new customer to QuickBooks
//
// This example shows how to queue up a request to add a new customer to
// QuickBooks. Remember that the Name element of a customer is unique within
// QuickBooks, and the request will fail and send you back an error message if
// another customer in QuickBooks already has that name.
$name = 'Shannon\'s Company (' . mt_rand() . ')';
$fname = 'Shannon';
$lname = 'Daniels';
// (the mt_rand() call is just so I don't get duplicate customer errors while testing)
$Customer = new QuickBooks_Object_Customer();
// This is a unique name (usually a company name) for the customer
$Customer->setName($name);
$Customer->setFirstName($fname);
$Customer->setLastName($lname);
$Customer->setShipAddress('134 Stonemill Road', '', '', '', '', 'Toronto', '', 'Ontario', 'H1B 12L', 'Canada');
// Country
$Customer->setMiddleName('B.');
$Customer->setSalutation('Ms.');
$Customer->setPhone('1.860.634.1602');
// Queue up the actual request to be sent to QuickBooks via the Web Connector
//
// Notice that we also provide the primary key of this customer from within our
// application, so we can create a mapping which maps this customer to the
// QuickBooks primary key.
//
// We also provide a priority, we want to make sure that this request runs
// *before* the request below, because we need to create the customer *before*
// we create an invoice for them. Higher priorities run sooner.
$primary_key_of_customer_in_your_application = 20;
$priority_of_add_customer_request = 25;
// get return values instead of having to write callback functions. Note that
// if you do this, you make your code less portable to other editions of
// QuickBooks that do not support real-time connections (i.e. QuickBooks
// desktop editions via the Web Connector)
if ($API->usingRealtime()) {
print 'Our real-time response from QuickBooks Online Edition was: ';
print_r($return);
}
exit;
// You can also create QuickBooks_Object_* instances and send them directly to
// QBOE via the API as show below. The API takes care of transforming those
// objects to valid qbXML requests for you.
$name = 'Keith Palmer (' . mt_rand() . ')';
$Customer = new QuickBooks_Object_Customer();
$Customer->setName($name);
$Customer->setShipAddress('134 Stonemill Road', '', '', '', '', 'Storrs', 'CT', '', '06268');
// Just a demo showing how to generate the raw qbXML request
print 'Here is the qbXML request we\'re about to send to QuickBooks Online Edition: ' . "\n";
print $Customer->asQBXML('CustomerAdd');
// Send the request to QuickBooks
$API->addCustomer($Customer, '_add_customer_callback', 15);
// This is our callback function, this will get called when the customer is added successfully
function _add_customer_callback($method, $action, $ID, &$err, $qbxml, $Customer, $qbres)
{
print 'Customer #' . $ID . ' looks like this within QuickBooks Online Edition: ' . "\n";
print_r($Customer);
}
// Here's a demo of querying for customers with a specific name:
$name = 'Keith Palmer Jr.';
// Here's how to fetch that customer by name
$API->getCustomerByName($name, '_get_customer_callback', 15);
$source_options = array();
$driver_options = array();
if (!QuickBooks_Utilities::initialized($api_driver_dsn)) {
//
QuickBooks_Utilities::initialize($api_driver_dsn);
//
QuickBooks_Utilities::createUser($api_driver_dsn, 'api', 'password');
}
$API = new QuickBooks_API($api_driver_dsn, $user, $source_type, $source_dsn, $api_options, $source_options, $driver_options);
// CUSTOMERS
$fname = 'Shannon ' . mt_rand();
$lname = 'Daniels';
$Customer = new QuickBooks_Object_Customer();
$Customer->setFirstName($fname);
$Customer->setLastName($lname);
$Customer->setShipAddress('56 Cowles Road', '', '', '', '', 'Willington', 'CT');
$Customer->setMiddleName('R');
$Customer->setSalutation('Mr.');
$Customer->setPhone('1.860.634.1602');
$API->addCustomer($Customer, '_quickbooks_customer_add_callback', 15);
// INVOICES
$Invoice = new QuickBooks_Object_Invoice();
//$Invoice->setOther('test of other'); // for some reason this field doesn't work...
$Invoice->setMemo('test of a memo');
$Invoice->setCustomerApplicationID(15);
$Invoice->setRefNumber(125);
$InvoiceLine1 = new QuickBooks_Object_Invoice_InvoiceLine();
$InvoiceLine1->setItemApplicationID(12);
$InvoiceLine1->setAmount(300.0);
$InvoiceLine1->setQuantity(3);
$InvoiceLine2 = new QuickBooks_Object_Invoice_InvoiceLine();
//$api_driver_dsn = 'pgsql://pgsql@localhost/quickbooks';
$source_dsn = 'http://*****:*****@localhost/path/to/server.php';
$source_options = array();
$driver_options = array();
if (!QuickBooks_Utilities::initialized($api_driver_dsn)) {
QuickBooks_Utilities::initialize($api_driver_dsn);
QuickBooks_Utilities::createUser($api_driver_dsn, 'api', 'password');
}
$api_options = array('qbxml_version' => 'CA3.0');
$source_options = array();
$driver_options = array();
$API = new QuickBooks_API($api_driver_dsn, $user, $source_type, $source_dsn, $api_options, $source_options, $driver_options);
$fname = 'Shannon ' . mt_rand(1, 1000);
$lname = 'Daniels';
$Customer = new QuickBooks_Object_Customer();
$Customer->setFirstName($fname);
$Customer->setLastName($lname);
$Customer->setShipAddress('56 Cowles Road', '', '', '', '', 'Willington', '', 'Quebec', 'Canada');
$Customer->setMiddleName('R');
$Customer->setSalutation('Mr.');
$Customer->setPhone('1.860.634.1602');
$API->addCustomer($Customer, '_quickbooks_customer_add_callback', 15);
$Class = new QuickBooks_Object_Class();
$Class->setName('My Test Class ' . mt_rand());
$API->addClass($Class, 'callback', 15);
function my_customer_callback()
{
}
function my_invoice_callback()
{
}
