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

- `Nomination` — string, required

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

- `PayerInn` — string, max-length: 11, required

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

- `PayerName` — string

  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)

- `DispatchType` — string

  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.

- `ValueDate` — date, required

  A date of document entry in the bank system.

- `IsSalary` — boolean

  Nonmandatory field, preferred to be filled on salary transfers:
  - TRUE – In cases of a salary transfer.
  - FALSE – In other cases

- `UniqueId` — globally unique identifier, required

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

- `Amount` — decimal number, required

  A document amount.

- `DocumentNo` — string, required

  A document number, max. length = 16.

- `SourceAccountNumber` — string, required

  An IBAN format of a sender’s account.

- `BeneficiaryAccountNumber` — string, required

  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.

- `BeneficiaryBankCode` — string, required

  A recipient Bank’s RTGS code.

- `BeneficiaryInn` — string, required

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

- `CheckInn` — boolean

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

- `BeneficiaryName` — string

  A recipient’s name.

- `CommissionAccountNumber` — string

  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.

- `IsPayerResident` — boolean

  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

- `PayerTaxRegistrationCode` — string

  Registration code

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

- `PayerPenaltyNumber` — string

  Protocol number

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

- `AdditionalInformation` — string

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

- `AttachmentIds` — array of string

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

- `CheckUniqueId` — boolean

  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.

**JSON**

```api
POST api/documents/domestic
Content-Type: application/json
```

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

**xml**

```api
POST api/documents/domestic
Content-Type: application/xml
```

```xml
<ArrayOfDomesticPayment xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/CIBApi.Models">
  <DomesticPayment>
    <AdditionalInformation>sample string 17</AdditionalInformation>
    <Amount>9</Amount>
    <BeneficiaryAccountNumber>sample string 12</BeneficiaryAccountNumber>
    <BeneficiaryBankCode>sample string 13</BeneficiaryBankCode>
    <BeneficiaryInn>sample string 14</BeneficiaryInn>
    <BeneficiaryName>sample string 16</BeneficiaryName>
    <CheckInn>true</CheckInn>
    <Currency>GEL</Currency>
    <DocumentNo>sample string 10</DocumentNo>
    <SourceAccountNumber>sample string 11</SourceAccountNumber>
    <UniqueId>a9ee0b25-6d72-4774-b7d0-0c8415fe9ebf</UniqueId>
    <DispatchType>sample string 5</DispatchType>
    <IsSalary>true</IsSalary>
    <Nomination>sample string 2</Nomination>
    <PayerInn>sample string 3</PayerInn>
    <PayerName>sample string 4</PayerName>
    <ValueDate>2021-06-17T11:22:01.4869236+04:00</ValueDate>
    <CommissionAccountNumber>sample string 18</CommissionAccountNumber>
    <IsPayerResident>true</IsPayerResident>
    <PayerTaxRegistrationCode>sample string 19</PayerTaxRegistrationCode>
    <PayerPenaltyNumber>sample string 20</PayerPenaltyNumber>
  </DomesticPayment>
  <DomesticPayment>
    <AdditionalInformation>sample string 17</AdditionalInformation>
    <Amount>9</Amount>
    <BeneficiaryAccountNumber>sample string 12</BeneficiaryAccountNumber>
    <BeneficiaryBankCode>sample string 13</BeneficiaryBankCode>
    <BeneficiaryInn>sample string 14</BeneficiaryInn>
    <BeneficiaryName>sample string 16</BeneficiaryName>
    <CheckInn>true</CheckInn>
    <Currency>GEL</Currency>
    <DocumentNo>sample string 10</DocumentNo>
    <SourceAccountNumber>sample string 11</SourceAccountNumber>
    <UniqueId>a9ee0b25-6d72-4774-b7d0-0c8415fe9ebf</UniqueId>
    <DispatchType>sample string 5</DispatchType>
    <IsSalary>true</IsSalary>
    <Nomination>sample string 2</Nomination>
    <PayerInn>sample string 3</PayerInn>
    <PayerName>sample string 4</PayerName>
    <ValueDate>2021-06-17T11:22:01.4869236+04:00</ValueDate>
    <CommissionAccountNumber>sample string 18</CommissionAccountNumber>
    <IsPayerResident>true</IsPayerResident>
    <PayerTaxRegistrationCode>sample string 19</PayerTaxRegistrationCode>
    <PayerPenaltyNumber>sample string 20</PayerPenaltyNumber>
  </DomesticPayment>
</ArrayOfDomesticPayment>
```

## Response

- `UniqueId` — globally unique identifier

  An unique ID in the external system (Guid).

- `UniqueKey` — integer

  An unique ID of the document in the business online.

- `ResultCode` — integer

  A result code of an operation. (With a link to the ResultCode page).
  [result code](../result/result-codes.md)

- `Match` — decimal 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.

**JSON**

```json

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

```

**xml**

```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>57adca88-0aff-4eb7-9648-4785106e77f6</UniqueId>
    <UniqueKey>2</UniqueKey>
  </DocumentKey>
  <DocumentKey>
    <Match>1</Match>
    <ResultCode>1</ResultCode>
    <UniqueId>57adca88-0aff-4eb7-9648-4785106e77f6</UniqueId>
    <UniqueKey>2</UniqueKey>
  </DocumentKey>
</ArrayOfDocumentKey>
```
