View as Markdown

მოთხოვნა

მეთოდის საშუალებით შესაძლებელია, უცხოურ ვალუტაში, ერთი ან რამდენიმე ინდივიდუალური დოკუმენტის შექმნა.

პარამეტრები

Chargesrequiredstring

გადარიცხვის მეთოდი. იღებს შემდეგ მნიშვნელობებს:

• SHA - (SWIFT) თანხის გამგზავნი იხდის მხოლოდ გამგზავნი ბანკის მიერ დადგენილ ყველა საკომისიოს.
• OUR - (SWIFT) თანხის გამგზავნი იხდის გადარიცხვასთან დაკავშირებულ ყველა საკომისიოს.
• BULK - (RTGS) სტანდარტული გადარიცხვა. შესაძლებელია მხოლოდ 10 000 USD/EUR-მდე ოპერაციის დროს.
• MT103 - (RTGS) ინდივიდუალური გადარიცხვა.

RTGS გადარიცხვა შესაძლებელია მხოლოდ ქართულ ბანკებში, USD ან EUR ვალუტაში.

BeneficiaryBankNameoptionalstring

მიმღები ბანკის დასახელება. SWIFT გადარიცხვისას BeneficiaryBankCode ან BeneficiaryBankName ველის შევსება სავალდებულოა. RTGS გადარიცხვის შემთხვევაში ველი უნდა დარჩეს ცარიელი.

IntermediaryBankCodeoptionalstring

შუამავალი ბანკის SWIFT კოდი. RTGS გადარიცხვის შემთხვევაში ველი უნდა დარჩეს ცარიელი.

IntermediaryBankNameoptionalstring

შუამავალი ბანკის დასახელება. RTGS გადარიცხვის შემთხვევაში ველი უნდა დარჩეს ცარიელი.

PaymentDetailoptionalstring

გადარიცხვის საფუძველი, დანიშნულება (მაქსიმუმ 4x34 136 სიმბოლო).

ValueDaterequireddate

ვალუტირების თარიღი.

BeneficiaryRegistrationCountryCodeoptionalstring

მიმღების რეგისტრაციის ქვეყანა.

BeneficiaryActualCountryCodeoptionalstring

მიმღების ფაქტობრივი ქვეყანა.

RecipientAddressoptionalstring

მიმღების მისამართი. RTGS გადარიცხვის შემთხვევაში ველი უნდა დარჩეს ცარიელი.

RecipientCityoptionalstring

მიმღების ქალაქი. RTGS გადარიცხვის შემთხვევაში ველი უნდა დარჩეს ცარიელი.

RegReportingValueoptionalstring

დამატებითი დანიშნულების ველი (გამოიყენება არაბეთის გაერთიანებულ საემიროებში გადარიცხვისას).

UniqueIdrequiredglobally unique identifier

გარე (გამომძახებელ) სისტემაში დოკუმენტის უნიკალური იდენტიფიკატორი (Guid).

Amountrequireddecimal number

დოკუმენტის თანხა.

Currencyrequiredstring

დოკუმენტის ვალუტა.

DocumentNorequiredstring

დოკუმენტის ნომერი.

SourceAccountNumberrequiredstring

გამგზავნის ანგარიში, ანგარიშიდან / მხოლოდ IBAN-ის ფორმატი, მაგ: GE11BG1111111111111111GEL

BeneficiaryAccountNumberrequiredstring

მიმღების ანგარიში. საქართველოს ბანკში ან სხვა ბანკში ეროვნული ვალუტის გადარიცხვისას – მხოლოდ IBAN-ის ფორმატი. ხაზინაში გადარიცხვისას - სახაზინო კოდი. უცხოური ვალუტის გადარიცხვისას - ანგარიშის ნომერი არსებული ფორმატით.

BeneficiaryBankCodeoptionalstring

მიმღები ბანკის BIC კოდი. RTGS გადარიცხვის შემთხვევაში ველი უნდა დარჩეს ცარიელი.

BeneficiaryInnoptionalstring, max-length: 11

ფიზიკური პირის შემთხვევაში მიმღების პირადი ნომერი, იურიდიული პირის შემთხვევაში მისი საიდენტიფიკაციო კოდი.

CheckInnoptionalstring

“საქართველოს ბანკში“ გადარიცხვის დროს, შემოწმდეს თუ არა მიმღების ანგარიშის თავსებადობა მის საიდენტიფიკაციო კოდთან. იღებს ორ მნიშვნელობას:

• TRUE - დამატებით შემოწმდება მიმღების ანგარიშის ნომრის მითითებული საიდენტიფიკაციო კოდით. თუ ანგარიშის ნომერი არ ეკუთვნის მითითებულ საიდენტიფიკაციო კოდზე არსებულ ანგარიშს, დაფიქსირდება შეცდომა.
• FALSE - გადარიცხვა შემოწმდება სტანდარტული წესით. სხვა ბანკში გადარიცხვისას ამ ველის მნიშვნელობა უნდა იყოს False.

BeneficiaryNameoptionalstring

მიმღების დასახელება.

CommissionAccountNumberoptionalstring

საკომისიოს ანგარიში, მხოლოდ ინდივიდუალური გადარიცხვისთვის / მხოლოდ IBAN-ის ფორმატი, მაგ: GE11BG1111111111111111GEL, ანგარიშის არასწორედ მითითების შემთხვევაში საკომისიო (არსებობის შეთხვევაში) ჩამოიწღება იმ ანგარიშიდან რომლიდანაც გადარიცხვა ხდება

AdditionalInformationoptionalstring

დამატებითი ინფორმაცია. არ გამოიყენება ეროვნული ვალუტის გადარიცხვისას.

AttachmentIdsoptionalarray of string

დანართების ჰეშების სია. თითოეული ჰეში (externalFileHash) მიიღება ფაილის ატვირთვის ენდპოინტიდან. ივსება მხოლოდ მაშინ, თუ დოკუმენტს დანართის მიბმა გსურთ.

PurposeCodeoptionalstring

გადარიცხვის დანიშნულების კოდი. გამოიყენება სავალუტო ოპერაციების რეპორტინგისთვის.

CheckUniqueIdoptionalboolean

თუ true, დოკუმენტის შექმნამდე შემოწმდება, ბოლო 7 დღის განმავლობაში იმავე UniqueId-ით დოკუმენტი უკვე შეიქმნა თუ არა. დუბლიკატის აღმოჩენისას ახალი დოკუმენტი არ იქმნება და ბრუნდება შედეგის კოდი 702.

JSON

POST api/documents/foreign
Content-Type: application/json

[
  {
    "Charges": "sample string 1",
    "CommissionAccountNumber": "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",
    "AttachmentIds": ["sample string 24"]
  },
  {
    "Charges": "sample string 1",
    "CommissionAccountNumber": "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",
    "AttachmentIds": ["sample string 24"]
  }
]

XML

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>
    <CommissionAccountNumber>sample string 2</CommissionAccountNumber>
    <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>
    <AttachmentIds xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <d3p1:string>sample string 24</d3p1:string>
    </AttachmentIds>
  </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>
    <CommissionAccountNumber>sample string 2</CommissionAccountNumber>
    <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>
    <AttachmentIds xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <d3p1:string>sample string 24</d3p1:string>
    </AttachmentIds>
  </ForeignPayment>
</ArrayOfForeignPayment>

დაბრუნებული პარამეტრები

UniqueIdglobally unique identifier

უნიკალური იდენტიფიკატორი (Guid) გარე სისტემაში.

UniqueKeyinteger

დოკუმენტის უნიკალური იდენტიფიკატორი business online-ში.

ResultCodeinteger

ოპერაციის შედეგის კოდი (ლინკით ResultCode გვერდზე). result code

Matchdecimal number

შიდა გადარიცხვის დროს, თანხვედრის % თქვენ მიერ აკრეფილი მიმღების დასახელებასთან. იურიდიული პირის შემთხვევაში მოწმდება ბანკში IBAN-ის ანგარიშის მფლობელის დასახელებასთან, ფიზიკური პირის შემთხვევაში კი – სახელთან და გვართან. შედარების შედეგად ბრუნდება დამთხვევის პროცენტული მაჩვენებელი.

JSON

[
  {
    "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
  }
]

XML

<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>