Формирование экспортного файла с курсами

Настоящий стандарт устанавливает коды обозначения электронных валют и формат файла экспорта.

Правила формирования названия валют:

1. Имена валют записываются латиницей. Пример: Perfect Money USD
2. Каждая валюта имеет сокращенное буквенное обозначение до 6-7 букв. Пример: PMUSD
3. Каждая валюта имеет трехзначный числовой код. Пример: 001
4. В системах с более чем одной валютой необходим указывать эквиваленты, соответствующие ISO 4217 после названия валюты (RUB, USD, UAH и т.д.), если валюта системы не имеет своего идентифицирующего названия или кода. В системах с одной валютой — рекомендуется так же использовать данное правило. Пример: E-Gold XAU USD
5. Краткие обозначения : Gold -> G, Money -> M

Правила формирования XML формата:

1. Элементы в каждой строке следуют в чётко определённой последовательности.
2. Каждая запись с новой строки. Перенос осуществляется символом

   .

3. <rates> — корневой элемент.
4. Каждое направление обмена описывается в элементе — <item>.
5. <from> — код валюты, которую обменный пункт принимает от клиента. Коды электронных валют приведены в списке ниже.
6. <to> — код валюты, которую обменный пункт отправляет клиенту. Коды электронных валют приведены в списке ниже.
7. <in> — сколько валюты from должен отдать клиент.
8. <out> — сколько валюты to получит клиент.
9. <amount> — размер резерва валюты to в обменнике.
10. <minfee> – минимальная комиссия, которую взимает обменный пункт в текущем направлении обмена. Указывается с кодом национальной валюты. Пример: <minfee>5 USD</minfee>.
11. <fromfee> – дополнительная комиссия, не входящая в курс обмена и взимаемая с суммы, которую клиент переводит в обменный пункт. Указывается с кодом национальной валюты. Пример: <fromfee>2.15 EUR</fromfee>. Вместо кода нац. валюты возможно также использование знака % для обозначения процентной дополнительной комиссии.
12. <tofee> – дополнительная комиссия, не входящая в курс обмена и взимаемая с суммы, которую обменный пункт переводит клиенту. Указывается с кодом национальной валюты. Пример: <tofee>30 RUB</tofee>. Вместо кода нац. валюты возможно также использование знака % для обозначения процентной дополнительной комиссии.
13. <minamount> – минимальная возможная к обмену сумма валюты, которую обменный пункт принимает от клиента. Указывается с кодом национальной валюты. Пример: <minamount>4.1 USD</minamount>.
14. <param> – данный элемент служит для указания дополнительных меток, таких как: manual – метка должна указываться для направлений обмена, которые обрабатываются через оператора вручную, либо если обмен по направлению производится с задержками (не моментально). juridical – данная метка означает, что обменный пункт производит переводы средств на банковский счет клиента со счета юридического лица или ИП. Указывается только для банковских направлений. Пример: <param>manual, juridical</param>.
15. Использовать 6-ть значащих цифр после запятой для курсов.
16. Использовать 2-е значащие цифры после запятой для резервов.
17. Постоянные комиссии платежных систем не должны указываться в экспортном файле курсов.

Примеры:

Правила формирования TXT формата:

1. Элементы в каждой строке следуют в чётко определённой последовательности
2. Каждая запись с новой строки. Перенос строки осуществляется командой \n (unix format =x0A)
3. from; — отдаваемая валюта. (Любое из 3-х обозначений: полное, сокращённое или число)
4. to; — получаемая валюты. (Любое из 3-х обозначений: полное, сокращённое или число)
5. in; — отдадите
6. out; — получите
7. amount — резерв валюты to
8. Элементы разделяются «;».
9. Использовать 6-ть значащих цифр после запятой для курсов
10. Использовать 2-е значащие цифры после запятой для резервов
11. Строки начинающиеся с символа # воспринимаются как комментарии. Этим символом можно обозначить в экспортном файле временно приостановленное направление обмена

Примеры:

Webmoney USD;Webmoney RUB;1;23.628812;10000.23

WMZ;WMR;1;23.628812;10000.23

001;002;1;23.628812;10000.23

Список кодов валют: