# Package transfer in the foreign currency

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

## Query params

- `fileName` — string, required

  Package name

## Params

- `Charges` — string, required

  A transfer method. Can take one of the following values:
  - `SHA` - (SWIFT) The Payer (sender of the payment) will pay only fees charged by the sending bank.
  - `OUR` - (SWIFT) The Payer (sender of the payment) will pay all fees charged by the sending bank.
  - `BULK` - (RTGS) A standard transfer. Is allowed only for up to 10 000 USD/EUR transactions.
  - `MT103` - (RTGS) An individual transfer.

  RTGS transfers are available only to Georgian banks in USD or EUR.

- `CommissionAccountNumber` — string

  A fees’ account number.

- `BeneficiaryBankName` — string

  A receiver Bank name. For SWIFT transfers, it is mandatory to fill in either BeneficiaryBankCode or BeneficiaryBankName. Must be left empty for RTGS transfers.

- `IntermediaryBankCode` — string

  A SWIFT code of an Intermediary Bank. Must be left empty for RTGS transfers.

- `IntermediaryBankName` — string

  A name of an Intermediary Bank. Must be left empty for RTGS transfers.

- `PaymentDetail` — string

  A reason, purpose of the transfer / 4x34 (136) symbols max.

- `ValueDate` — date, required

  A date of document entry in the bank system.

- `BeneficiaryRegistrationCountryCode` — string

  Recipient’s registration country.

- `BeneficiaryActualCountryCode` — string

  Recipient’s actual country.

- `RecipientAddress` — string

  Recipient’s address. Must be left empty for RTGS transfers.

- `RecipientCity` — string

  Recipient’s city. Must be left empty for RTGS transfers.

- `RegReportingValue` — string

  An additional field that is used when transferring to the UAE.

- `UniqueId` — globally unique identifier, required

  An unique ID of a document in the external (caller) system (Guid).

- `Amount` — decimal number, required

  A document’s amount.

- `Currency` — string, required

  A document currency.

- `DocumentNo` — string, required

  A document’s number.

- `SourceAccountNumber` — string, required

  A sender’s account in IBAN format.

- `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 BIC code of a recipient Bank. Must be left empty for RTGS transfers.

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

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

- `PurposeCode` — string

  A payment purpose code. Used for currency operation reporting.

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

```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-17T17:55:21.9971829+04:00",
    "BeneficiaryRegistrationCountryCode": "sample string 8",
    "BeneficiaryActualCountryCode": "sample string 9",
    "RecipientAddress": "sample string 10",
    "RecipientCity": "sample string 11",
    "RegReportingValue": "sample string 12",
    "UniqueId": "16928efd-7fc0-4dd4-8643-64b4e1ae6725",
    "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"
  },
  {
    "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-17T17:55:21.9971829+04:00",
    "BeneficiaryRegistrationCountryCode": "sample string 8",
    "BeneficiaryActualCountryCode": "sample string 9",
    "RecipientAddress": "sample string 10",
    "RecipientCity": "sample string 11",
    "RegReportingValue": "sample string 12",
    "UniqueId": "16928efd-7fc0-4dd4-8643-64b4e1ae6725",
    "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"
  }
]
```

**xml**

```api
POST api/documents/bulk/foreign?fileName={fileName}
Content-Type: application/xml
```

```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>16928efd-7fc0-4dd4-8643-64b4e1ae6725</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-17T17:55:21.9971829+04:00</ValueDate>
  </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>16928efd-7fc0-4dd4-8643-64b4e1ae6725</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-17T17:55:21.9971829+04:00</ValueDate>
  </ForeignPayment>
</ArrayOfForeignPayment>
```

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

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