/quickbooks/QuickBooks/QBXML/Object/ServiceItem.php

https://bitbucket.org/211enterprises/laracing · PHP · 559 lines · 327 code · 90 blank · 142 comment · 7 complexity · 8eb8973e31db83c10846d771a6479354 MD5 · raw file

  1. <?php
  2. /**
  3. * QuickBooks ServiceItem object container
  4. *
  5. * NOTE: By default, ServiceItems are created as SalesOrPurchase items, and are
  6. * thus *NOT* created as SalesAndPurchase items. If you want to create an item
  7. * that is sold *and* purchased, you'll need to set the type with the method:
  8. * -> {@link QuickBooks_Object_ServiceItem::isSalesAndPurchase()}
  9. *
  10. * @author Keith Palmer <keith@consolibyte.com>
  11. * @license LICENSE.txt
  12. *
  13. * @package QuickBooks
  14. * @subpackage Object
  15. */
  16. /**
  17. * QuickBooks object base class
  18. */
  19. QuickBooks_Loader::load('/QuickBooks/QBXML/Object.php');
  20. /**
  21. * QuickBooks ServiceItem object
  22. */
  23. class QuickBooks_QBXML_Object_ServiceItem extends QuickBooks_QBXML_Object
  24. {
  25. /**
  26. * Flag indicating whether or not this for sales *AND* purchase, or just sales *OR* purchase
  27. */
  28. protected $_is_sales_and_purchase;
  29. /**
  30. * Create a new QuickBooks_Object_ServiceItem object (ServiceItem)
  31. */
  32. public function __construct($arr = array(), $is_sales_and_purchase = false)
  33. {
  34. parent::__construct($arr);
  35. if (count($this->getArray('SalesAndPurchase')) > 0)
  36. {
  37. $is_sales_and_purchase = true;
  38. }
  39. $this->_is_sales_and_purchase = $is_sales_and_purchase;
  40. }
  41. /**
  42. * Set the ListID for this item
  43. *
  44. * @param string $ListID
  45. * @return boolean
  46. */
  47. public function setListID($ListID)
  48. {
  49. return $this->set('ListID', $ListID);
  50. }
  51. /**
  52. * Get the ListID for this item
  53. *
  54. * @return string
  55. */
  56. public function getListID()
  57. {
  58. return $this->get('ListID');
  59. }
  60. /**
  61. * Set the name for this item
  62. *
  63. * @param string $name
  64. * @return boolean
  65. */
  66. public function setName($name)
  67. {
  68. return $this->setNameType('Name', $name);
  69. }
  70. /**
  71. * Get the name for this item
  72. *
  73. * @return string
  74. */
  75. public function getName()
  76. {
  77. return $this->get('Name');
  78. }
  79. public function setFullName($fullname)
  80. {
  81. return $this->setFullNameType('FullName', 'Name', 'ParentRef FullName', $fullname);
  82. }
  83. public function getFullName()
  84. {
  85. return $this->getFullNameType('FullName', 'Name', 'ParentRef FullName');
  86. }
  87. public function setIsActive($active)
  88. {
  89. if (strtolower($active) == 'true' or
  90. (is_bool($active) and $active))
  91. {
  92. return $this->set('IsActive', 'true');
  93. }
  94. return $this->set('IsActive', 'false');
  95. }
  96. public function getIsActive()
  97. {
  98. $active = $this->get('IsActive');
  99. return strtolower($active) == 'true' or
  100. (is_bool($active) and $active);
  101. }
  102. public function setParentListID($ListID)
  103. {
  104. return $this->set('ParentRef ListID', $ListID);
  105. }
  106. public function setParentName($name)
  107. {
  108. return $this->set('ParentRef FullName', $name);
  109. }
  110. public function setParentApplicationID($value)
  111. {
  112. return $this->set('ParentRef ' . QUICKBOOKS_API_APPLICATIONID, $this->encodeApplicationID(QUICKBOOKS_OBJECT_ITEM, QUICKBOOKS_LISTID, $value));
  113. }
  114. public function getParentListID()
  115. {
  116. return $this->get('ParentRef ListID');
  117. }
  118. public function getParentName()
  119. {
  120. return $this->get('ParentRef FullName');
  121. }
  122. public function getParentApplicationID()
  123. {
  124. return $this->extractApplicationID($this->get('ParentRef ' . QUICKBOOKS_API_APPLICATIONID));
  125. }
  126. public function setSalesTaxCodeListID($ListID)
  127. {
  128. return $this->set('SalesTaxCodeRef ListID', $ListID);
  129. }
  130. public function setSalesTaxCodeName($name)
  131. {
  132. return $this->set('SalesTaxCodeRef FullName', $name);
  133. }
  134. public function setSalesTaxCodeApplicationID($value)
  135. {
  136. return $this->set('SalesTaxCodeRef ' . QUICKBOOKS_API_APPLICATIONID, $this->encodeApplicationID(QUICKBOOKS_OBJECT_SALESTAXCODE, QUICKBOOKS_LISTID, $value));
  137. }
  138. public function getSalesTaxCodeListID()
  139. {
  140. return $this->get('SalesTaxCodeRef ListID');
  141. }
  142. public function getSalesTaxCodeName()
  143. {
  144. return $this->get('SalesTaxCodeRef FullName');
  145. }
  146. public function getSalesTaxCodeApplicationID()
  147. {
  148. return $this->extractApplicationID($this->get('SalesTaxCodeRef ' . QUICKBOOKS_API_APPLICATIONID));
  149. }
  150. public function getUnitOfMeasureSetListID()
  151. {
  152. return $this->get('UnitOfMeasureSetRef ListID');
  153. }
  154. public function getUnitOfMeasureSetFullName()
  155. {
  156. return $this->get('UnitOfMeasureSetRef FullName');
  157. }
  158. /**
  159. * Tell (and optionally set) whether or not this item is currently for Sale *and* Purchase
  160. *
  161. * @param boolean $enable
  162. * @return boolean
  163. */
  164. public function isSalesAndPurchase($enable = null)
  165. {
  166. $current = $this->_is_sales_and_purchase;
  167. if (!is_null($enable))
  168. {
  169. $this->_is_sales_and_purchase = (boolean) $enable;
  170. }
  171. return $current;
  172. }
  173. /**
  174. * Tell (and optionall set) whether or not this item is currently for Sale *or* Purchase
  175. *
  176. * @param boolean $enable
  177. * @return boolean
  178. */
  179. public function isSalesOrPurchase($enable = null)
  180. {
  181. $current = !$this->_is_sales_and_purchase;
  182. if (!is_null($enable))
  183. {
  184. $this->_is_sales_and_purchase = ! (boolean) $enable;
  185. }
  186. return $current;
  187. }
  188. // Sales OR Purchase
  189. /**
  190. * Set the description of this item (Sales OR Purchase)
  191. *
  192. * @param string $descrip
  193. * @return boolean
  194. */
  195. public function setDescription($descrip)
  196. {
  197. return $this->set('SalesOrPurchase Desc', $descrip);
  198. }
  199. public function getDescription()
  200. {
  201. return $this->get('SalesOrPurchase Desc');
  202. }
  203. /**
  204. * Set the price for this item (Sales OR Purchase)
  205. *
  206. * @param string $price
  207. * @return boolean
  208. */
  209. public function setPrice($price)
  210. {
  211. $this->remove('SalesOrPurchase PricePercent');
  212. return $this->set('SalesOrPurchase Price', sprintf('%01.2f', (float) $price));
  213. }
  214. /**
  215. * Get the price for this item (Sales OR Purchase)
  216. */
  217. public function getPrice()
  218. {
  219. return $this->get('SalesOrPurchase Price');
  220. }
  221. /**
  222. * Set the price percent for this item (Sales OR Purchase)
  223. */
  224. public function setPricePercent($percent)
  225. {
  226. $this->remove('SalesOrPurchase Price');
  227. return $this->set('SalesOrPurchase PricePercent', $percent);
  228. }
  229. /**
  230. * Get the price percent for this item (Sales OR Purchase)
  231. *
  232. * @return float
  233. */
  234. public function getPricePercent()
  235. {
  236. return $this->get('SalesOrPurchase PricePercent');
  237. }
  238. /**
  239. * Set the account ListID for this item (Sales OR Purchase)
  240. *
  241. * @param string $ListID
  242. * @return boolean
  243. */
  244. public function setAccountListID($ListID)
  245. {
  246. return $this->set('SalesOrPurchase AccountRef ListID', $ListID);
  247. }
  248. /**
  249. * Set the account name for this item (Sales OR Purchase)
  250. *
  251. * @param string $name
  252. * @return boolean
  253. */
  254. public function setAccountName($name)
  255. {
  256. return $this->set('SalesOrPurchase AccountRef FullName', $name);
  257. }
  258. public function setAccountFullName($name)
  259. {
  260. return $this->set('SalesOrPurchase AccountRef FullName', $name);
  261. }
  262. /**
  263. * (Sales OR Purchase)
  264. */
  265. public function setAccountApplicationID($value)
  266. {
  267. return $this->set('SalesOrPurchase AccountRef ' . QUICKBOOKS_API_APPLICATIONID, $this->encodeApplicationID(QUICKBOOKS_OBJECT_ACCOUNT, QUICKBOOKS_LISTID, $value));
  268. }
  269. public function getAccountApplicationID()
  270. {
  271. return $this->get('SalesOrPurchase AccountRef ' . QUICKBOOKS_API_APPLICATIONID);
  272. }
  273. /**
  274. * Get the account ListID for this item (Sales OR Purchase)
  275. *
  276. * @return string
  277. */
  278. public function getAccountListID()
  279. {
  280. return $this->get('SalesOrPurchase AccountRef ListID');
  281. }
  282. /**
  283. * @deprecated
  284. */
  285. public function getAccountName()
  286. {
  287. return $this->get('SalesOrPurchase AccountRef FullName');
  288. }
  289. /**
  290. * Get the account name for this item (Sales OR Purchase)
  291. *
  292. * @return string
  293. */
  294. public function getAccountFullName()
  295. {
  296. return $this->get('SalesOrPurchase AccountRef FullName');
  297. }
  298. // Sales AND Purchase
  299. public function setSalesDescription($descrip)
  300. {
  301. return $this->set('SalesAndPurchase SalesDesc', $descrip);
  302. }
  303. public function getSalesDescription()
  304. {
  305. return $this->get('SalesAndPurchase SalesDesc');
  306. }
  307. public function setSalesPrice($price)
  308. {
  309. return $this->set('SalesAndPurchase SalesPrice', sprintf('%01.2f', (float) $price));
  310. }
  311. public function getSalesPrice()
  312. {
  313. return $this->get('SalesAndPurchase SalesPrice');
  314. }
  315. public function setIncomeAccountListID($ListID)
  316. {
  317. return $this->set('SalesAndPurchase IncomeAccountRef ListID', $ListID);
  318. }
  319. public function getIncomeAccountListID()
  320. {
  321. return $this->get('SalesAndPurchase IncomeAccountRef ListID');
  322. }
  323. /**
  324. * @deprecated
  325. */
  326. public function setIncomeAccountName($name)
  327. {
  328. return $this->set('SalesAndPurchase IncomeAccountRef FullName', $name);
  329. }
  330. public function getIncomeAccountFullName()
  331. {
  332. return $this->get('SalesAndPurchase IncomeAccountRef FullName');
  333. }
  334. /**
  335. * @deprecated
  336. */
  337. public function getIncomeAccountName()
  338. {
  339. return $this->get('SalesAndPurchase IncomeAccountRef FullName');
  340. }
  341. public function setIncomeAccountApplicationID($value)
  342. {
  343. return $this->set('SalesAndPurchase IncomeAccountRef ' . QUICKBOOKS_API_APPLICATIONID, $this->encodeApplicationID(QUICKBOOKS_OBJECT_ACCOUNT, QUICKBOOKS_LISTID, $value));
  344. }
  345. public function getIncomeAccountApplicationID()
  346. {
  347. return $this->get('SalesAndPurchase IncomeAccountRef ' . QUICKBOOKS_API_APPLICATIONID);
  348. }
  349. public function setPurchaseDescription($descrip)
  350. {
  351. return $this->set('SalesAndPurchase PurchaseDesc', $descrip);
  352. }
  353. public function getPurchaseDescription()
  354. {
  355. return $this->get('SalesAndPurchase PurchaseDesc');
  356. }
  357. public function setPurchaseCost($cost)
  358. {
  359. return $this->set('SalesAndPurchase PurchaseCost', sprintf('%01.2f', (float) $cost));
  360. }
  361. public function getPurchaseCost()
  362. {
  363. return $this->get('SalesAndPurchase PurchaseCost');
  364. }
  365. public function setExpenseAccountListID($ListID)
  366. {
  367. return $this->set('SalesAndPurchase ExpenseAccountRef ListID', $ListID);
  368. }
  369. public function setExpenseAccountName($name)
  370. {
  371. return $this->set('SalesAndPurchase ExpenseAccountRef FullName', $name);
  372. }
  373. public function setExpenseAccountApplicationID($value)
  374. {
  375. return $this->set('SalesAndPurchase ExpenseAccountRef ' . QUICKBOOKS_API_APPLICATIONID, $this->encodeApplicationID(QUICKBOOKS_OBJECT_ACCOUNT, QUICKBOOKS_LISTID, $value));
  376. }
  377. public function getExpenseAccountApplicationID()
  378. {
  379. return $this->get('SalesAndPurchase ExpenseAccountRef ' . QUICKBOOKS_API_APPLICATIONID);
  380. }
  381. public function getExpenseAccountListID()
  382. {
  383. return $this->get('SalesAndPurchase ExpenseAccountRef ListID');
  384. }
  385. public function getExpenseAccountName()
  386. {
  387. return $this->get('SalesAndPurchase ExpenseAccountRef FullName');
  388. }
  389. public function setPreferredVendorListID($ListID)
  390. {
  391. return $this->set('SalesAndPurchase PrefVendorRef ListID', $ListID);
  392. }
  393. public function setPreferredVendorName($name)
  394. {
  395. return $this->set('SalesAndPurchase PrefVendorRef FullName', $name);
  396. }
  397. public function setPreferredVendorApplicationID($value)
  398. {
  399. return $this->set('SalesAndPurchase PrefVendorRef ' . QUICKBOOKS_API_APPLICATIONID, $this->encodeApplicationID(QUICKBOOKS_OBJECT_VENDOR, QUICKBOOKS_LISTID, $value));
  400. }
  401. public function getPreferredVendorApplicationID()
  402. {
  403. return $this->get('SalesAndPurchase PrefVendorRef ' . QUICKBOOKS_API_APPLICATIONID);
  404. }
  405. public function getPreferredVendorListID()
  406. {
  407. return $this->get('SalesAndPurchase PrefVendorRef ListID');
  408. }
  409. public function getPreferredVendorName()
  410. {
  411. return $this->get('SalesAndPurchase PrefVendorRef FullName');
  412. }
  413. /**
  414. *
  415. *
  416. * @return boolean
  417. */
  418. protected function _cleanup()
  419. {
  420. if ($this->isSalesAndPurchase())
  421. {
  422. // Remove any SalesOrPurchase keys
  423. foreach ($this->getArray('SalesOrPurchase*') as $key => $value)
  424. {
  425. $this->remove($key);
  426. }
  427. }
  428. else
  429. {
  430. foreach ($this->getArray('SalesAndPurchase*') as $key => $value)
  431. {
  432. $this->remove($key);
  433. }
  434. }
  435. return true;
  436. }
  437. /**
  438. *
  439. */
  440. public function asArray($request, $nest = true)
  441. {
  442. $this->_cleanup();
  443. return parent::asArray($request, $nest);
  444. }
  445. /**
  446. * Convert this object to a valid qbXML request
  447. *
  448. * @param string $request The type of request to convert this to (examples: CustomerAddRq, CustomerModRq, CustomerQueryRq)
  449. * @param boolean $todo_for_empty_elements A constant, one of: QUICKBOOKS_XML_XML_COMPRESS, QUICKBOOKS_XML_XML_DROP, QUICKBOOKS_XML_XML_PRESERVE
  450. * @param string $indent
  451. * @param string $root
  452. * @return string
  453. */
  454. public function asQBXML($request, $todo_for_empty_elements = QuickBooks_QBXML_Object::XML_DROP, $indent = "\t", $root = null)
  455. {
  456. $this->_cleanup();
  457. return parent::asQBXML($request, $todo_for_empty_elements, $indent, $root);
  458. }
  459. /**
  460. * Tell what type of object this is
  461. *
  462. * @return string
  463. */
  464. public function object()
  465. {
  466. return QUICKBOOKS_OBJECT_SERVICEITEM;
  467. }
  468. }
  469. ?>