/** Funkcja API umożliwiająca rejestrację dokumentu wymiany walut.
*
* @param type $fieldsArray - tablica parametrów podanych jako pole => wartosc_pola
* możliwe pola do podania to:
* - OPER_TYPE (r) - Stała kwota: 1-przyjmowana, 2-wydawana
* - AMOUNT (r) - Kwota przyjmowana/wydawana do wymiany w walucie określonej w znaczniku CURRENCY_SYMBOL_DT/CURRENCY_SYMBOL_CT. O stronie decyduje element OPER_TYPE: dla przyjęcia jest to DT, dla wydania - CT
* - CURRENCY_SYMBOL_DT (r) - Symbol waluty przyjmowanej
* - CURRENCY_SYMBOL_CT (r) - Symbol waluty wydawanej.
* - CUSTOMER_NAME (r) - Nazwa klienta
* - DESCRIPTION - Opis
* - CFEE_AMOUNT - Kwota prowizji.
* - ACCOUNT_OWN (r) - NRB konta własnego kasy, w której nastąpi wymiana waluty.
* - VALUE_DATE - Data waluty YYYYMMDD.
* - EXCHANGE_RATE_DT - Kurs wymiany waluty przyjmowanej. Dla dokumentu wymiany walut (gdy żadna z walut nie jest walutą bazową), jeżeli zostanie podana wartość parametru, to wymagane jest także podanie kursu wymiany waluty wydawanej.
* - EXCHANGE_RATE_CT - Kurs wymiany waluty wydawanej. Dla dokumentu wymiany walut (gdy żadna z walut nie jest walutą bazową), jeżeli zostanie podana wartość parametru, to wymagane jest także podanie kursu wymiany waluty przyjmowanej.
*
* @param type $nominals - Nominały przyjmowane/wydawane - podawane jako tablica której elementami są tablice asocjacyjne o usupełnionych kluczach:
* - NOMINAL (r) - Symbol nominału ze słownika CURRENCY_NOMINALS.
* - COUNT_IN - Liczba nominałów przyjętych.
* - COUNT_OUT - Liczba nominałów wydanych.
*/
public function insertCashCurrencyExchange($fieldsArray, $nominals = null)
{
$xml = new Base_Def_XmlBuilder('DEF_3000_API');
$iteration = new Base_Def_XmlBuilder('NOMINALS');
$iteration->addTagsFromArray(array('NOMINAL' => null, 'COUNT_IN' => null, 'COUNT_OUT' => null));
$iteration->NOMINAL->setRequired(true);
$xml->EXCHANGE_POS->addTag('OPER_TYPE', null, true)->addTag('AMOUNT', null, true)->addTag('CURRENCY_SYMBOL_DT', null, true)->addTag('CURRENCY_SYMBOL_CT', null, true)->addTag('CUSTOMER_NAME', null, true)->addTag('DESCRIPTION')->addTag('CFEE_AMOUNT')->addTag('ACCOUNT_OWN', null, true)->addTag('VALUE_DATE')->addTag('EXCHANGE_RATE_DT')->addTag('EXCHANGE_RATE_CT')->addIteration('nominals', $iteration);
$xml->EXCHANGE_POS->setTagsValues($fieldsArray)->setIterationValue('nominals', $nominals);
return $this->_executeApiFunction('insert_cash_currency_exchange', $xml->getXml());
}
