POST api/documents/foreign

Create a document in foreign currency (Individual)

Request

URI Parameters

empty

Request body parameters

documents

One or more   ForeignPayment
nameDescriptionTypeadditional info
Charges

Payment Method (SHA & OUR)

 string

-
ComissionAccountNumber

Commission Account/Only For Indivdual Transfers

 string

-
BeneficiaryBankName

Beneficiary Bank Name / mandatory or BeneficiaryBankCode or BeneficiaryBankName

 string

-
IntermediaryBankCode

Intermediary Bank SWIFT code

 string

-
IntermediaryBankName

Intermediary Bank Name

 string

-
PaymentDetail

Description, nomination / maximum 4x34 136 characters

 string

-
ValueDate

Value Date

 date

Required
BeneficiaryRegistrationCountryCode

Registration Country of the Recipient

 string

-
BeneficiaryActualCountryCode

Country of Actual Activity of the Recipient

 string

-
RecipientAddress

api.property.foreign.recipient.address

 string

-
RecipientCity

api.property.foreign.recipient.city

 string

-
RegReportingValue

api.property.foreign.reg.reporting.value

 string

-
PurposeCode

Nomination description (Mandatory for Chinese Yuan and Indian Rupee transfers)

 string

-
UniqueId

unique identifier (Guid) outside system

 globally unique identifier

Required
Amount

Amount

 decimal number

Required
Currency

Currency

 string

-
DocumentNo

Doc N

 string

Required
SourceAccountNumber

Sender Account, Transfer from / only IBAN format

 string

Required
BeneficiaryAccountNumber

Beneficiary Account, Transfer To

transfer of the national currency Bank of Georgia, another bank - only IBAN-'s format.

Treasury transfers, indicated Treasury code

transfer of the foreign currency account number of the existing format

 string

Required
BeneficiaryBankCode

Beneficiary Bank RTGS code / mandatory

 string

-
BeneficiaryInn

Recipient - an individual ID number, legal entity Number Taxpayer

 string

Maximum length: 11
CheckInn

Checking transfers within Bank of Georgia using INN

Optional Field

If “TRUE” while transferring Within Bank of Georgia, benefitiary account number will be checked additionally, using indicated INN. If beneficiary account number does not belong to the owner of indicated INN, a error will ocure.

If “FALSE” while transferring within Bank of Georgia, the transfer will be checked with standard procedure

while transferring outside Bank of Georgia the value of this field should not be “TRUE”

 boolean

-
BeneficiaryName

Recipient Name

 string

-
AdditionalInformation

additional info / Optional / Not used Transfer of national currency

 string

-

api.documents.foreign.comments

Request formats

application/json, text/json

Sample: 
[
  {
    "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": "2025-01-18T10:52:48.3405481+04:00",
    "BeneficiaryRegistrationCountryCode": "sample string 8",
    "BeneficiaryActualCountryCode": "sample string 9",
    "RecipientAddress": "sample string 10",
    "RecipientCity": "sample string 11",
    "RegReportingValue": "sample string 12",
    "PurposeCode": "sample string 13",
    "UniqueId": "867a6534-316f-42e5-98fc-0439874853ce",
    "Amount": 15.0,
    "Currency": "sample string 16",
    "DocumentNo": "sample string 17",
    "SourceAccountNumber": "sample string 18",
    "BeneficiaryAccountNumber": "sample string 19",
    "BeneficiaryBankCode": "sample string 20",
    "BeneficiaryInn": "sample string 21",
    "CheckInn": true,
    "BeneficiaryName": "sample string 23",
    "AdditionalInformation": "sample string 24"
  },
  {
    "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": "2025-01-18T10:52:48.3405481+04:00",
    "BeneficiaryRegistrationCountryCode": "sample string 8",
    "BeneficiaryActualCountryCode": "sample string 9",
    "RecipientAddress": "sample string 10",
    "RecipientCity": "sample string 11",
    "RegReportingValue": "sample string 12",
    "PurposeCode": "sample string 13",
    "UniqueId": "867a6534-316f-42e5-98fc-0439874853ce",
    "Amount": 15.0,
    "Currency": "sample string 16",
    "DocumentNo": "sample string 17",
    "SourceAccountNumber": "sample string 18",
    "BeneficiaryAccountNumber": "sample string 19",
    "BeneficiaryBankCode": "sample string 20",
    "BeneficiaryInn": "sample string 21",
    "CheckInn": true,
    "BeneficiaryName": "sample string 23",
    "AdditionalInformation": "sample string 24"
  }
]

application/xml, text/xml

Sample: 
<ArrayOfForeignPayment xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/CIBApi.Models">
  <ForeignPayment>
    <AdditionalInformation>sample string 24</AdditionalInformation>
    <Amount>15</Amount>
    <BeneficiaryAccountNumber>sample string 19</BeneficiaryAccountNumber>
    <BeneficiaryBankCode>sample string 20</BeneficiaryBankCode>
    <BeneficiaryInn>sample string 21</BeneficiaryInn>
    <BeneficiaryName>sample string 23</BeneficiaryName>
    <CheckInn>true</CheckInn>
    <Currency>sample string 16</Currency>
    <DocumentNo>sample string 17</DocumentNo>
    <SourceAccountNumber>sample string 18</SourceAccountNumber>
    <UniqueId>867a6534-316f-42e5-98fc-0439874853ce</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>
    <PurposeCode>sample string 13</PurposeCode>
    <RecipientAddress>sample string 10</RecipientAddress>
    <RecipientCity>sample string 11</RecipientCity>
    <RegReportingValue>sample string 12</RegReportingValue>
    <ValueDate>2025-01-18T10:52:48.3405481+04:00</ValueDate>
  </ForeignPayment>
  <ForeignPayment>
    <AdditionalInformation>sample string 24</AdditionalInformation>
    <Amount>15</Amount>
    <BeneficiaryAccountNumber>sample string 19</BeneficiaryAccountNumber>
    <BeneficiaryBankCode>sample string 20</BeneficiaryBankCode>
    <BeneficiaryInn>sample string 21</BeneficiaryInn>
    <BeneficiaryName>sample string 23</BeneficiaryName>
    <CheckInn>true</CheckInn>
    <Currency>sample string 16</Currency>
    <DocumentNo>sample string 17</DocumentNo>
    <SourceAccountNumber>sample string 18</SourceAccountNumber>
    <UniqueId>867a6534-316f-42e5-98fc-0439874853ce</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>
    <PurposeCode>sample string 13</PurposeCode>
    <RecipientAddress>sample string 10</RecipientAddress>
    <RecipientCity>sample string 11</RecipientCity>
    <RegReportingValue>sample string 12</RegReportingValue>
    <ValueDate>2025-01-18T10:52:48.3405481+04:00</ValueDate>
  </ForeignPayment>
</ArrayOfForeignPayment>

Response

Description

დოკუმენტების იდენტიფიკატორები

One or more   DocumentKey
nameDescriptionTypeadditional info
UniqueId

unique identifier (Guid) outside system

 globally unique identifier

-
UniqueKey

Unique identifier of the Business Online

 integer

-
ResultCode

api.document.result.code

 integer

-
Match

Match %

When making an internal transfer, if the recipient that you enter is a legal entity, such recipient will be checked against the name of the IBAN account holder with the bank, and if the recipient that you enter is a natural person, such recipient will be checked against the first name and last name of such person. The comparison will show a % result of matching.

To check for duplication when creating any documents or performing package transfers, the new document is checked to see whether it matches any of the documents already created. You can compare documents in advance according to the fields that you select.

decimal number

-

formats

application/json, text/json

Sample: 
[
  {
    "UniqueId": "ef0287f0-7c25-4300-bbcf-1ab04c31d850",
    "UniqueKey": 2,
    "ResultCode": 1,
    "Match": 1.0
  },
  {
    "UniqueId": "ef0287f0-7c25-4300-bbcf-1ab04c31d850",
    "UniqueKey": 2,
    "ResultCode": 1,
    "Match": 1.0
  }
]

application/xml, text/xml

Sample: 
<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>ef0287f0-7c25-4300-bbcf-1ab04c31d850</UniqueId>
    <UniqueKey>2</UniqueKey>
  </DocumentKey>
  <DocumentKey>
    <Match>1</Match>
    <ResultCode>1</ResultCode>
    <UniqueId>ef0287f0-7c25-4300-bbcf-1ab04c31d850</UniqueId>
    <UniqueKey>2</UniqueKey>
  </DocumentKey>
</ArrayOfDocumentKey>