# Package transfer in the national currency

This method allows to create one or more package document in national currency.

## Params

- `Nomination` — string, required

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

- `PayerInn` — string, 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).

- `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` - In other cases.

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

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

  A recipient Bank’s RTGS code.

- `BeneficiaryInn` — string, max-length: 11

  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.

- `AdditionalInformation` — string

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

- `CommissionAccountNumber` — string

  Commission account. 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

- `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/bulk/domestic?fileName={fileName}
Content-Type: application/json
```

```json
[
  {
    "Nomination": "sample string 2",
    "PayerInn": "sample string 3",
    "PayerName": "sample string 4",
    "DispatchType": "sample string 5",
    "ValueDate": "2021-06-17T16:12:22.399993+04:00",
    "IsSalary": true,
    "UniqueId": "938a8f0a-567d-4436-81a7-4b63768bc2f6",
    "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"
  },
  {
    "Nomination": "sample string 2",
    "PayerInn": "sample string 3",
    "PayerName": "sample string 4",
    "DispatchType": "sample string 5",
    "ValueDate": "2021-06-17T16:12:22.399993+04:00",
    "IsSalary": true,
    "UniqueId": "938a8f0a-567d-4436-81a7-4b63768bc2f6",
    "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"
  }
]
```

**xml**

```api
POST api/documents/bulk/domestic?fileName={fileName}
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>938a8f0a-567d-4436-81a7-4b63768bc2f6</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-17T16:12:22.399993+04:00</ValueDate>
  </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>938a8f0a-567d-4436-81a7-4b63768bc2f6</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-17T16:12:22.399993+04:00</ValueDate>
  </DomesticPayment>
</ArrayOfDomesticPayment>
```

## Response

-  — integer

  A unique ID of a package on the business online.

**JSON**

```json
1
```

**xml**

```xml
<long xmlns="http://schemas.microsoft.com/2003/10/Serialization/">1</long>
```
