125 lines
5.7 KiB
PHP
125 lines
5.7 KiB
PHP
<?php
|
|
if ( ! defined( 'ABSPATH' ) ) {
|
|
exit;
|
|
}
|
|
|
|
/*
|
|
* Copyright (c) 2013 - 2015 MasterCard International Incorporated
|
|
* All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without modification, are
|
|
* permitted provided that the following conditions are met:
|
|
*
|
|
* Redistributions of source code must retain the above copyright notice, this list of
|
|
* conditions and the following disclaimer.
|
|
* Redistributions in binary form must reproduce the above copyright notice, this list of
|
|
* conditions and the following disclaimer in the documentation and/or other materials
|
|
* provided with the distribution.
|
|
* Neither the name of the MasterCard International Incorporated nor the names of its
|
|
* contributors may be used to endorse or promote products derived from this software
|
|
* without specific prior written permission.
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY
|
|
* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
|
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
|
|
* SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
|
|
* TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
|
|
* OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
|
|
* IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
|
|
* IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
* SUCH DAMAGE.
|
|
*/
|
|
|
|
|
|
class Simplify_Tax extends Simplify_Object {
|
|
/**
|
|
* Creates an Simplify_Tax object
|
|
* @param array $hash a map of parameters; valid keys are:<dl style="padding-left:10px;">
|
|
* <dt><tt>label</tt></dt> <dd>The label of the tax object. [max length: 255] <strong>required </strong></dd>
|
|
* <dt><tt>rate</tt></dt> <dd>The tax rate. Decimal value up three decimal places. e.g 12.501. [max length: 6] <strong>required </strong></dd></dl>
|
|
* @param $authentication - information used for the API call. If no value is passed the global keys Simplify::public_key and Simplify::private_key are used. <i>For backwards compatibility the public and private keys may be passed instead of the authentication object.<i/>
|
|
* @return Tax a Tax object.
|
|
*/
|
|
static public function createTax($hash, $authentication = null) {
|
|
|
|
$args = func_get_args();
|
|
$authentication = Simplify_PaymentsApi::buildAuthenticationObject($authentication, $args, 2);
|
|
|
|
$instance = new Simplify_Tax();
|
|
$instance->setAll($hash);
|
|
|
|
$object = Simplify_PaymentsApi::createObject($instance, $authentication);
|
|
return $object;
|
|
}
|
|
|
|
|
|
/**
|
|
* Deletes an Simplify_Tax object.
|
|
*
|
|
* @param $authentication - information used for the API call. If no value is passed the global keys Simplify::public_key and Simplify::private_key are used. <i>For backwards compatibility the public and private keys may be passed instead of the authentication object.</i>
|
|
*
|
|
* @return true
|
|
*/
|
|
public function deleteTax($authentication = null) {
|
|
|
|
$args = func_get_args();
|
|
$authentication = Simplify_PaymentsApi::buildAuthenticationObject($authentication, $args, 1);
|
|
|
|
$obj = Simplify_PaymentsApi::deleteObject($this, $authentication);
|
|
$this->properties = null;
|
|
return true;
|
|
}
|
|
|
|
|
|
/**
|
|
* Retrieve Simplify_Tax objects.
|
|
* @param array criteria a map of parameters; valid keys are:<dl style="padding-left:10px;">
|
|
* <dt><tt>filter</tt></dt> <dd>Filters to apply to the list. </dd>
|
|
* <dt><tt>max</tt></dt> <dd>Allows up to a max of 50 list items to return. [min value: 0, max value: 50, default: 20] </dd>
|
|
* <dt><tt>offset</tt></dt> <dd>Used in paging of the list. This is the start offset of the page. [min value: 0, default: 0] </dd>
|
|
* <dt><tt>sorting</tt></dt> <dd>Allows for ascending or descending sorting of the list. The value maps properties to the sort direction (either <tt>asc</tt> for ascending or <tt>desc</tt> for descending). Sortable properties are: <tt> id</tt><tt> label</tt>.</dd></dl>
|
|
* @param $authentication - information used for the API call. If no value is passed the global keys Simplify::public_key and Simplify::private_key are used. <i>For backwards compatibility the public and private keys may be passed instead of the authentication object.</i>
|
|
* @return ResourceList a ResourceList object that holds the list of Tax objects and the total
|
|
* number of Tax objects available for the given criteria.
|
|
* @see ResourceList
|
|
*/
|
|
static public function listTax($criteria = null, $authentication = null) {
|
|
|
|
$args = func_get_args();
|
|
$authentication = Simplify_PaymentsApi::buildAuthenticationObject($authentication, $args, 2);
|
|
|
|
$val = new Simplify_Tax();
|
|
$list = Simplify_PaymentsApi::listObject($val, $criteria, $authentication);
|
|
|
|
return $list;
|
|
}
|
|
|
|
|
|
/**
|
|
* Retrieve a Simplify_Tax object from the API
|
|
*
|
|
* @param string id the id of the Tax object to retrieve
|
|
* @param $authentication - information used for the API call. If no value is passed the global keys Simplify::public_key and Simplify::private_key are used. <i>For backwards compatibility the public and private keys may be passed instead of the authentication object.</i>
|
|
* @return Tax a Tax object
|
|
*/
|
|
static public function findTax($id, $authentication = null) {
|
|
|
|
$args = func_get_args();
|
|
$authentication = Simplify_PaymentsApi::buildAuthenticationObject($authentication, $args, 2);
|
|
|
|
$val = new Simplify_Tax();
|
|
$val->id = $id;
|
|
|
|
$obj = Simplify_PaymentsApi::findObject($val, $authentication);
|
|
|
|
return $obj;
|
|
}
|
|
|
|
/**
|
|
* @ignore
|
|
*/
|
|
public function getClazz() {
|
|
return "Tax";
|
|
}
|
|
}
|