მოთხოვნა
მეთოდის საშუალებით შესაძლებელია, უცხოურ ვალუტაში, ერთი ან რამდენიმე ინდივიდუალური დოკუმენტის შექმნა.
პარამეტრები
Chargesoptionalstring
გადარიცხვის მეთოდი. იღებს შემდეგ მნიშვნელობებს:
- SHA - თანხის გამგზავნი იხდის მხოლოდ გამგზავნი ბანკის მიერ დადგენილ ყველა საკომისიოს.
- OUR - თანხის გამგზავნი იხდის გადარიცხვასთან დაკავშირებულ ყველა საკომისიოს.
ComissionAccountNumberoptionalstring
საკომისიოს ანგარიში.
BeneficiaryBankNameoptionalstring
მიმღები ბანკის დასახელება. BeneficiaryBankCode ან BeneficiaryBankName ველის შევსება სავალდებულოა.
IntermediaryBankCodeoptionalstring
შუამავალი ბანკის SWIFT კოდი.
IntermediaryBankNameoptionalstring
შუამავალი ბანკის დასახელება.
PaymentDetailoptionalstring
გადარიცხვის საფუძველი, დანიშნულება (მაქსიმუმ 4x34 136 სიმბოლო).
ValueDaterequireddate
ვალუტირების თარიღი.
BeneficiaryRegistrationCountryCodeoptionalstring
მიმღების რეგისტრაციის ქვეყანა.
BeneficiaryActualCountryCodeoptionalstring
მიმღების ფაქტობრივი ქვეყანა.
RecipientAddressoptionalstring
მიმღების მისამართი.
RecipientCityoptionalstring
მიმღების ქალაქი.
RegReportingValueoptionalstring
დამატებითი დანიშნულების ველი (გამოიყენება არაბეთის გაერთიანებულ საემიროებში გადარიცხვისას).
UniqueIdrequiredglobally unique identifier
გარე (გამომძახებელ) სისტემაში დოკუმენტის უნიკალური იდენტიფიკატორი (Guid).
Amountrequireddecimal number
დოკუმენტის თანხა.
DocumentNorequiredstring
დოკუმენტის ნომერი.
SourceAccountNumberrequiredstring
გამგზავნის ანგარიში IBAN-ის ფორმატში.
BeneficiaryAccountNumberrequiredstring
მიმღების ანგარიში. საქართველოს ბანკში ან სხვა ბანკში ეროვნული ვალუტის გადარიცხვისას – მხოლოდ IBAN-ის ფორმატი. ხაზინაში გადარიცხვისას - სახაზინო კოდი. უცხოური ვალუტის გადარიცხვისას - ანგარიშის ნომერი არსებული ფორმატით.
BeneficiaryBankCodeoptionalstring
მიმღები ბანკის RTGS კოდი.
BeneficiaryInnoptionalstring, max-length: 11
ფიზიკური პირის შემთხვევაში მიმღების პირადი ნომერი, იურიდიული პირის შემთხვევაში მისი საიდენტიფიკაციო კოდი.
CheckInnoptionalstring
“საქართველოს ბანკში“ გადარიცხვის დროს, შემოწმდეს თუ არა მიმღების ანგარიშის თავსებადობა მის საიდენტიფიკაციო კოდთან. იღებს ორ მნიშვნელობას:
TRUE
- დამატებით შემოწმდება მიმღების ანგარიშის ნომრის მითითებული საიდენტიფიკაციო კოდით. თუ ანგარიშის ნომერი არ ეკუთვნის მითითებულ საიდენტიფიკაციო კოდზე არსებულ ანგარიშს, დაფიქსირდება შეცდომა.FALSE
- გადარიცხვა შემოწმდება სტანდარტული წესით. სხვა ბანკში გადარიცხვისას ამ ველის მნიშვნელობა უნდა იყოსFalse
.
BeneficiaryNameoptionalstring
მიმღების დასახელება.
AdditionalInformationoptionalstring
დამატებითი ინფორმაცია. არ გამოიყენება ეროვნული ვალუტის გადარიცხვისას.
- JSON
- XML
POST api/documents/foreign
Content-Type: application/json
[
{
"Charges": "sample string 1",
"ComissionAccountNumber": "sample string 2",
"BeneficiaryBankName": "sample string 3",
"IntermediaryBankCode": "sample string 4",
"IntermediaryBankName": "sample string 5",
"PaymentDetail": "sample string 6",
"ValueDate": "2021-06-17T12:03:37.4722861+04:00",
"BeneficiaryRegistrationCountryCode": "sample string 8",
"BeneficiaryActualCountryCode": "sample string 9",
"RecipientAddress": "sample string 10",
"RecipientCity": "sample string 11",
"RegReportingValue": "sample string 12",
"UniqueId": "c6b8cc64-072d-4849-9b7a-a40dc5faa3af",
"Amount": 14.0,
"Currency": "sample string 15",
"DocumentNo": "sample string 16",
"SourceAccountNumber": "sample string 17",
"BeneficiaryAccountNumber": "sample string 18",
"BeneficiaryBankCode": "sample string 19",
"BeneficiaryInn": "sample string 20",
"CheckInn": true,
"BeneficiaryName": "sample string 22",
"AdditionalInformation": "sample string 23"
},
{
"Charges": "sample string 1",
"ComissionAccountNumber": "sample string 2",
"BeneficiaryBankName": "sample string 3",
"IntermediaryBankCode": "sample string 4",
"IntermediaryBankName": "sample string 5",
"PaymentDetail": "sample string 6",
"ValueDate": "2021-06-17T12:03:37.4722861+04:00",
"BeneficiaryRegistrationCountryCode": "sample string 8",
"BeneficiaryActualCountryCode": "sample string 9",
"RecipientAddress": "sample string 10",
"RecipientCity": "sample string 11",
"RegReportingValue": "sample string 12",
"UniqueId": "c6b8cc64-072d-4849-9b7a-a40dc5faa3af",
"Amount": 14.0,
"Currency": "sample string 15",
"DocumentNo": "sample string 16",
"SourceAccountNumber": "sample string 17",
"BeneficiaryAccountNumber": "sample string 18",
"BeneficiaryBankCode": "sample string 19",
"BeneficiaryInn": "sample string 20",
"CheckInn": true,
"BeneficiaryName": "sample string 22",
"AdditionalInformation": "sample string 23"
}
]
POST api/documents/foreign
Content-Type: application/xml
<ArrayOfForeignPayment xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/CIBApi.Models">
<ForeignPayment>
<AdditionalInformation>sample string 23</AdditionalInformation>
<Amount>14</Amount>
<BeneficiaryAccountNumber>sample string 18</BeneficiaryAccountNumber>
<BeneficiaryBankCode>sample string 19</BeneficiaryBankCode>
<BeneficiaryInn>sample string 20</BeneficiaryInn>
<BeneficiaryName>sample string 22</BeneficiaryName>
<CheckInn>true</CheckInn>
<Currency>sample string 15</Currency>
<DocumentNo>sample string 16</DocumentNo>
<SourceAccountNumber>sample string 17</SourceAccountNumber>
<UniqueId>c6b8cc64-072d-4849-9b7a-a40dc5faa3af</UniqueId>
<BeneficiaryActualCountryCode>sample string 9</BeneficiaryActualCountryCode>
<BeneficiaryBankName>sample string 3</BeneficiaryBankName>
<BeneficiaryRegistrationCountryCode>sample string 8</BeneficiaryRegistrationCountryCode>
<Charges>sample string 1</Charges>
<ComissionAccountNumber>sample string 2</ComissionAccountNumber>
<IntermediaryBankCode>sample string 4</IntermediaryBankCode>
<IntermediaryBankName>sample string 5</IntermediaryBankName>
<PaymentDetail>sample string 6</PaymentDetail>
<RecipientAddress>sample string 10</RecipientAddress>
<RecipientCity>sample string 11</RecipientCity>
<RegReportingValue>sample string 12</RegReportingValue>
<ValueDate>2021-06-17T12:03:37.4722861+04:00</ValueDate>
</ForeignPayment>
<ForeignPayment>
<AdditionalInformation>sample string 23</AdditionalInformation>
<Amount>14</Amount>
<BeneficiaryAccountNumber>sample string 18</BeneficiaryAccountNumber>
<BeneficiaryBankCode>sample string 19</BeneficiaryBankCode>
<BeneficiaryInn>sample string 20</BeneficiaryInn>
<BeneficiaryName>sample string 22</BeneficiaryName>
<CheckInn>true</CheckInn>
<Currency>sample string 15</Currency>
<DocumentNo>sample string 16</DocumentNo>
<SourceAccountNumber>sample string 17</SourceAccountNumber>
<UniqueId>c6b8cc64-072d-4849-9b7a-a40dc5faa3af</UniqueId>
<BeneficiaryActualCountryCode>sample string 9</BeneficiaryActualCountryCode>
<BeneficiaryBankName>sample string 3</BeneficiaryBankName>
<BeneficiaryRegistrationCountryCode>sample string 8</BeneficiaryRegistrationCountryCode>
<Charges>sample string 1</Charges>
<ComissionAccountNumber>sample string 2</ComissionAccountNumber>
<IntermediaryBankCode>sample string 4</IntermediaryBankCode>
<IntermediaryBankName>sample string 5</IntermediaryBankName>
<PaymentDetail>sample string 6</PaymentDetail>
<RecipientAddress>sample string 10</RecipientAddress>
<RecipientCity>sample string 11</RecipientCity>
<RegReportingValue>sample string 12</RegReportingValue>
<ValueDate>2021-06-17T12:03:37.4722861+04:00</ValueDate>
</ForeignPayment>
</ArrayOfForeignPayment>
დაბრუნებული პარამეტრები
UniqueIdglobally unique identifier
უნიკალური იდენტიფიკატორი (Guid) გარე სისტემაში.
UniqueKeyinteger
დოკუმენტის უნიკალური იდენტიფიკატორი business online-ში.
ResultCodeinteger
ოპერაციის შედეგის კოდი (ლინკით ResultCode გვერდზე). result code
Matchdecimal number
შიდა გადარიცხვის დროს, თანხვედრის % თქვენ მიერ აკრეფილი მიმღების დასახელებასთან. იურიდიული პირის შემთხვევაში მოწმდება ბანკში IBAN-ის ანგარიშის მფლობელის დასახელებასთან, ფიზიკური პირის შემთხვევაში კი – სახელთან და გვართან. შედარების შედეგად ბრუნდება დამთხვევის პროცენტული მაჩვენებელი.
- JSON
- XML
[
{
"UniqueId": "7afaebef-5c0a-4876-aa47-13370f16fc8c",
"UniqueKey": 2,
"ResultCode": 1,
"Match": 1.0
},
{
"UniqueId": "7afaebef-5c0a-4876-aa47-13370f16fc8c",
"UniqueKey": 2,
"ResultCode": 1,
"Match": 1.0
}
]
<ArrayOfDocumentKey xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/CIBApi.Models">
<DocumentKey>
<Match>1</Match>
<ResultCode>1</ResultCode>
<UniqueId>7afaebef-5c0a-4876-aa47-13370f16fc8c</UniqueId>
<UniqueKey>2</UniqueKey>
</DocumentKey>
<DocumentKey>
<Match>1</Match>
<ResultCode>1</ResultCode>
<UniqueId>7afaebef-5c0a-4876-aa47-13370f16fc8c</UniqueId>
<UniqueKey>2</UniqueKey>
</DocumentKey>
</ArrayOfDocumentKey>