changeMonexAtBnode

Operacja changeMonexAtBnode dokonuje wykupo-rozmiany pieniędzy w banku.

Może być przeprowadzona w jednym z trzech typów. Zależnie od wybranego typu należy podać też odpowiednie parametry rozmiany.

AMOUNT: Pieniądze mają zostać rozmienione tak by dało się utworzyć z nich kwotę podaną w milibillonach.
HISTOGRAM: Pieniądze mają zostać rozmienione tak by odpowiadały podanemu rozkładowi monet. Możliwe rozkłady to:
- DEFAULT_ISSUANCE_CURVE
- GROSZY_ISSUANCE_CURVE
- ZLOTY_ISSUANCE_CURVE
- TENS_ISSUANCE_CURVE
- HUNDREDS_ISSUANCE_CURVE
FACE_VALUE: Pieniądza mają zostać rozmienione zgodnie z podaną listą monet. Musi się ona składać z maksymalnie 21 liczb całkowitych, odzielonych znakami nowej linii, każda z nich odpowiada liczbie monet, które chcemy uzyskać danego nominału (zgodnie z listą możliwych nominałów, od najmniejszego do największego)

Przykładowe zapytanie SOAP:

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
  xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:xsd="http://www.w3.org/2001/XMLSchema"
  xmlns:ns="ns1">
 <SOAP-ENV:Body  SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
  <ns:changeMonexAtBnode>
   <amountToChange>
    <amount>1000</amount>
    <currency>PLN</currency>
    <colour>0</colour>
   </amountToChange>
   <changeMonexType>HISTOGRAM</changeMonexType>
   <value>HUNDREDS_ISSUANCE_CURVE</value>
  </ns:changeMonexAtBnode>
 </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Przykładowa odpowiedź SOAP:

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
  xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:xsd="http://www.w3.org/2001/XMLSchema"
  xmlns:ns="ns1">
 <SOAP-ENV:Body  SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
  <ns:changeMonexAtBnodeResponse>
   <return>
    <taskId>0B3LCA6254A12E5GEB0MF4F6LH</taskId>
    <requestStatus>SUCCESS</requestStatus>
    <requestStatusDescription>Request succeeded.</requestStatusDescription>
   </return>
  </ns:changeMonexAtBnodeResponse>
 </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Parametry zapytania:

Parametr	Typ	Opis	Wymagane?	Specyfikacja
changeMonexType	string	Sposób rozmiany,	Tak	Jeden spośród: AMOUNT, HISTOGRAM, FACE_VALUE
value	string	Parametr rozmiany, zależny od changeMonexType	Tak	Patrz opis
amountToChange	billonAmount	Kwota, która ma zostać rozmieniona	Tak	Kwota musi być z zakresu od 0 do 25 000 miliBillonów

Parametry odpowiedzi:

Nazwa	Typ	Opis
taskId	string	identyfikator powstałego zadania
requestStatusDescription	string	opis statusu
requestStatus	string	status wykonania zapytania

Możliwe błędy:

Błąd	Opis
ERR_INVALID_AMOUNT	nieprawidłowa kwota
ERR_INVALID_CURRENCY	nieprawidłowa waluta
ERR_INVALID_MONEY_COLOUR	niepoprawny/nieobsługiwany kolor pieniędzy
ERR_INVALID_CHANGE_MONEY_PARAMS
ERR_NOT_ENOUGH_MONEY	niewystarczająca kwota pieniędzy
FINISHED_ERR	wystąpił nieznany błąd
FINISHED_ERR_CANCELLED_DUE_TO_PREVIOUS_ERROR	zrestartuj węzeł CNode

Przykładowy JSON additionalInfo w odpowiedzi na getTaskStatus:

{
   "amount": 5000,
   "actual_amount": 0,
   "restart_amount": 0
}

Jak możemy pomóc?