Skip to main content
View as Markdown

Individual document in the national currency

This method allows creating one or more individual documents in national currency.

Params​

An array of documents with the following attributes:

Nominationrequiredstring

A reason, purpose of the transfer / 250 symbols max.

PayerInnrequiredstring, max-length: 11

An Identification Number of a taxpayer individual, or an Identification Code of a legal entity. Should be filled only when a transaction is performed towards the budget on behalf of a third party (in this case an identification code of a said the third party should be filled).

PayerNameoptionalstring

A Payer's name. Should be filled only when a transaction is performed towards the budget on behalf of a third party (in this case a name of a said the third party should be filled)

DispatchTypeoptionalstring

A transfer method. Is used for outbound transfers only and is a mandatory field. Can take the following values:

  • BULK – A standard transfer. Is allowed only for up to 10 000 GEL transactions.
  • MT103 - An individual transfer.

ValueDaterequireddate

A date of document entry in the bank system.

IsSalaryoptionalboolean

Nonmandatory field, preferred to be filled on salary transfers:

  • TRUE – In cases of a salary transfer.
  • FALSE – In other cases

UniqueIdrequiredglobally unique identifier

A unique ID of an external (caller) system (Guid).

Amountrequireddecimal number

A document amount.

DocumentNorequiredstring

A document number, max. length = 16.

SourceAccountNumberrequiredstring

An IBAN format of a sender’s account.

BeneficiaryAccountNumberrequiredstring

A recipient’s account. Only IBAN format is allowed for transfers to the Bank of Georgia or other banks in the national currency. A treasury code for the transfers to the National Treasury. An account ID in an existing format for the transfers in the foreign currency.

BeneficiaryBankCoderequiredstring

A recipient Bank’s RTGS code.

BeneficiaryInnrequiredstring

A Personal Identification Number for individuals; an Identification Code for legal entities.

CheckInnoptionalboolean

Used to indicate whether the compatibility of a receiver’s account to the Identification Code should be checked when transferring to the Bank of Georgia. Can take one of the two values:

  • TRUE – An additional compatibility check of the account number by the identification code should take place. If the account number does not match the account numbers related to that identification code- an error will be returned.
  • FALSE – A transfer will be checked in a standard way. When transferring to another bank, this parameter should be always set to False.

BeneficiaryNameoptionalstring

A recipient’s name.

CommissionAccountNumberoptionalstring

Commission account, for individual transfers only.

IBAN format only, e.g.: GE11BG1111111111111111GEL. In case of an incorrectly specified account, the commission (if any) will be deducted from the account from which the transfer is being made.

IsPayerResidentoptionalboolean

Is payer resident of Georgia,  Resident True, non-resident False

This field must be completed only for transfers to a State Treasury account made on behalf of a third person. Indicate whether that person is a resident of Georgia

PayerTaxRegistrationCodeoptionalstring

Registration code

This field must be completed only for transfers to the State Treasury made by non-residents of Georgia

PayerPenaltyNumberoptionalstring

Protocol number

This field must be completed only for transfers to the State Treasury made by non-residents of Georgia

AdditionalInformationoptionalstring

An additional info. Is not used for transfers in a national currency.

AttachmentIdsoptionalarray of string

A list of attachment hashes. Each hash (externalFileHash) is obtained from the file upload endpoint. Filled only when you want to attach files to the document.

CheckUniqueIdoptionalboolean

When true, before the document is created it is checked whether a document with the same UniqueId has already been created within the last 7 days. If a duplicate is found, no new document is created and result code 702 is returned.

POST api/documents/domestic
Content-Type: application/json
[
  {
    "Nomination": "sample string 2",
    "PayerInn": "sample string 3",
    "PayerName": "sample string 4",
    "DispatchType": "sample string 5",
    "ValueDate": "2021-06-17T10:31:50.2269037+04:00",
    "IsSalary": true,
    "UniqueId": "066a7743-256a-4b40-b937-78e241dd31ae",
    "Amount": 9.0,
    "DocumentNo": "sample string 10",
    "SourceAccountNumber": "sample string 11",
    "BeneficiaryAccountNumber": "sample string 12",
    "BeneficiaryBankCode": "sample string 13",
    "BeneficiaryInn": "sample string 14",
    "CheckInn": true,
    "BeneficiaryName": "sample string 16",
    "AdditionalInformation": "sample string 17",
    "CommissionAccountNumber": "sample string 18",
    "IsPayerResident": true,
    "PayerTaxRegistrationCode": "sample string 19",
    "PayerPenaltyNumber": "sample string 20",
    "AttachmentIds": ["sample string 21"]
  },
  {
    "Nomination": "sample string 2",
    "PayerInn": "sample string 3",
    "PayerName": "sample string 4",
    "DispatchType": "sample string 5",
    "ValueDate": "2021-06-17T10:31:50.2269037+04:00",
    "IsSalary": true,
    "UniqueId": "066a7743-256a-4b40-b937-78e241dd31ae",
    "Amount": 9.0,
    "DocumentNo": "sample string 10",
    "SourceAccountNumber": "sample string 11",
    "BeneficiaryAccountNumber": "sample string 12",
    "BeneficiaryBankCode": "sample string 13",
    "BeneficiaryInn": "sample string 14",
    "CheckInn": true,
    "BeneficiaryName": "sample string 16",
    "AdditionalInformation": "sample string 17",
    "CommissionAccountNumber": "sample string 18",
    "IsPayerResident": true,
    "PayerTaxRegistrationCode": "sample string 19",
    "PayerPenaltyNumber": "sample string 20",
    "AttachmentIds": ["sample string 21"]
  }
]

Response​

UniqueIdglobally unique identifier

An unique ID in the external system (Guid).

UniqueKeyinteger

An unique ID of the document in the business online.

ResultCodeinteger

A result code of an operation. (With a link to the ResultCode page).
result code

Matchdecimal number

For the internal transfers a matched coefficient of a provided recipient name. For legal entities a match of an owner of a provided IBAN to the entity name is being checked, while for the individuals - to the name and surname. A match coefficient in percent will be shown as a result of such a comparison. 


[
  {
    "UniqueId": "57adca88-0aff-4eb7-9648-4785106e77f6",
    "UniqueKey": 2,
    "ResultCode": 1,
    "Match": 1.0
  },
  {
    "UniqueId": "57adca88-0aff-4eb7-9648-4785106e77f6",
    "UniqueKey": 2,
    "ResultCode": 1,
    "Match": 1.0
  }
]