/**
* Gets Bf_Invoices for a given Bf_Account
* @param union[string | Bf_Account] $account Reference to account <string>: $id of the Bf_Account. <Bf_Account>: The Bf_Account entity.
* @return Bf_Invoice[]
*/
public static function getForAccount($account, $options = NULL, $customClient = NULL)
{
$accountID = Bf_Account::getIdentifier($account);
$endpoint = sprintf("account/%s", rawurlencode($accountID));
return static::getCollection($endpoint, $options, $customClient);
}
/**
* Synchronously advances the account's subscriptions through time.
* @param array $advancementOptions (Default: All keys set to their respective default values) Encapsulates the following optional parameters:
* * @param boolean (Default: false) $..['dryRun'] Whether to forego persisting the effected changes.
* * @param boolean (Default: false) $..['skipIntermediatePeriods']
* * @param boolean (Default: true) $..['handleAmendments']
* * @param string_ENUM['SingleAttempt', 'FollowDunning', 'None'] (Default: 'SingleAttempt') $..['executionStrategy']
* *
* * <SingleAttempt> (Default)
* *
* * <FollowDunning>
* *
* * <None>
* *
* * @param boolean (Default: false) $..['freezeOnCompletion']
* * @param {@see Bf_BillingEntity::parseTimeRequestFromTime(mixed)} $..['from'] From when to advance time
* * @param {@see Bf_BillingEntity::parseTimeRequestToTime(mixed)} $..['to'] Until when to advance time
* * @param integer (Default: NULL) (Non-null value of param requires that $..['to'] be NULL instead) $..['periods']
* @return Bf_AccountTimeResponse The results of advancing the account's subscription through time.
*/
public function advance(array $advancementOptions = array('dryRun' => false, 'skipIntermediatePeriods' => false, 'handleAmendments' => true, 'executionStrategy' => 'SingleAttempt', 'freezeOnCompletion' => false, 'from' => NULL, 'to' => 'CurrentPeriodEnd', 'periods' => NULL))
{
$inputOptions = $advancementOptions;
$accountID = Bf_Account::getIdentifier($this);
$stateParams = static::mergeUserArgsOverNonNullDefaults(__METHOD__, array(), $inputOptions);
static::mutateKeysByStaticLambdas($stateParams, array('from' => 'parseTimeRequestFromTime', 'to' => 'parseTimeRequestToTime'), array('from' => array(NULL), 'to' => array(NULL)));
$requestEntity = new Bf_TimeRequest($stateParams);
$endpoint = sprintf("%s/advance", rawurlencode($accountID));
$responseEntity = Bf_AccountTimeResponse::getClassName();
$constructedEntity = static::postEntityAndGrabFirst($endpoint, $requestEntity, $responseEntity);
return $constructedEntity;
}