POST api/documents/foreign

უცხოურ ვალუტაში ინდივიდუალური დოკუმენტის შექმნა

მოთხოვნა

URI პარამეტრები

ცარიელი

მოთხოვნის ტანის პარამეტრები

დოკუმენტები

ერთი ან რამდენიმე   ForeignPayment
სახელიაღწერატიპიდამატებითი ინფორმაცია
Charges

გადარიცხვის მეთოდი (SHA ან OUR)

string

-

ComissionAccountNumber

საკომისიოს ანგარიში/მხოლოდ ინდივიდუალური გადარიცხვისთვის

string

-

BeneficiaryBankName

მიმრები ბანკის დასახელება. სავალდებულოა ან BeneficiaryBankCode ან BeneficiaryBankName

string

-

IntermediaryBankCode

შუამავალი ბანკის SWIFT კოდი

string

-

IntermediaryBankName

შუამავალი ბანკის დასახელება

string

-

PaymentDetail

გადარიცხვის საფუძველი, დანიშნულება / მაქსიმუმ 4x34 136 სიმბოლო

string

-

ValueDate

ვალუტირების თარიღი

date

აუცილებელი

BeneficiaryRegistrationCountryCode

მიმღების რეგისტრაციის ქვეყანა

string

-

BeneficiaryActualCountryCode

რეგისტრაციის ქვეყანა

string

-

RecipientAddress

api.property.foreign.recipient.address

string

-

RecipientCity

api.property.foreign.recipient.city

string

-

RegReportingValue

api.property.foreign.reg.reporting.value

string

-

PurposeCode

დანიშნულების აღწერა (სავალდებულოა მხოლოდ ჩინური იუანის და ინდური რუპიის გადარიცხვისას)

string

-

UniqueId

უნიკალური იდენტიფიკატორი (Guid) გარე სისტემაში

globally unique identifier

აუცილებელი

Amount

თანხა

decimal number

აუცილებელი

Currency

ვალუტა

string

-

DocumentNo

დოკ. N

string

აუცილებელი

SourceAccountNumber

გამგზავნის ანგარიში, ანგარიშიდან / მხოლოდ IBAN-ის ფორმატი

string

აუცილებელი

BeneficiaryAccountNumber

მიმღების ანგარიში, ანგარიშზე

ეროვნული ვალუტის გადარიცხვისას საქართველოს ბანკში, სხვა ბანკში – მხოლოდ IBAN-ის ფორმატი.

ხაზინაში გადარიცხვისას მიუთითეთ სახაზინო კოდი

უცხოური ვალუტის გადარიცხვისას მიმრების ანგარიშის ნომერი არსებული ფორმატით

string

აუცილებელი

BeneficiaryBankCode

მიმღები ბანკის RTGS კოდი / სავალდებულო

string

-

BeneficiaryInn

მიმღების – ფიზიკური პირის პირადი ნომერი, იურიდიული პირის საიდენტიფიკაციო კოდი

string

მაქსიმალური სიგრძე: 11

CheckInn

“საქართველოს ბანკში“ გადარიცხვის შემოწმება საიდენტიფიკაციო კოდით

არასავალდებულო ველი

“საქართველოს ბანკში“ გადარიცხვისას “TRUE” მითითების შემთხვევაში, დამატებით შემოწმდება მიმღების ანგარიშის ნომრი მითითებული საიდენტიფიკაციო კოდით, თუ არ ანგარიშის ნომერი არ ეკუთვნის მითითებულ საიდენტიფიკაციო კოდზე არსებულ ანგარიშს დაფიქსირდება შეცდომა.

“საქართველოს ბანკში“ გადარიცხვისას “FALSE” მითითების შემთხვევაში, გადარიცხვა შემოწმდება სტანდარტული წესით

სხვა ბანკში გადარიცხვისას ამ ველის მნიშვნელობა დადებითი არ უნდა იყოს

boolean

-

BeneficiaryName

მიმღების დასახელება

string

-

AdditionalInformation

დამატებითი ინფორმაცია / არა სავალდებულო / არ გამოიყენება ეროვნული ვალუტის გადარიცხვისას

string

-

api.documents.foreign.comments

მოთხოვნის ფორმატი

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": "2024-03-28T20:14:42.8900954+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": "07026ee8-1fcb-41c7-b709-159a055d6d2e",
    "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": "2024-03-28T20:14:42.8900954+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": "07026ee8-1fcb-41c7-b709-159a055d6d2e",
    "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>07026ee8-1fcb-41c7-b709-159a055d6d2e</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>2024-03-28T20:14:42.8900954+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>07026ee8-1fcb-41c7-b709-159a055d6d2e</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>2024-03-28T20:14:42.8900954+04:00</ValueDate>
  </ForeignPayment>
</ArrayOfForeignPayment>

პასუხი

აღწერა

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

ერთი ან რამდენიმე   DocumentKey
სახელიაღწერატიპიდამატებითი ინფორმაცია
UniqueId

უნიკალური იდენტიფიკატორი (Guid) გარე სისტემაში

globally unique identifier

-

UniqueKey

დოკუმენტის უნიკალური იდენტიფიკატორი business online-ში

integer

-

ResultCode

api.document.result.code

integer

-

Match

თანხვედრის %

შიდა გადარიცხვის დროს თქვენ მიერ აკრეფილი მიმღები ი/პ-ის შემთხვევაში მოწმდება ბანკში IBAN-ის ანგარიშის მფლობელის დასახელებასთან, ფ/პ-ის შემთხვევაში კი – სახელთან და გვართან. შედარების შედეგად ნახავთ დამთხვევის %-ულ მაჩვენებელს.

ნებისმიერი დოკუმენტის შექმნის ან პაკეტური გადარიცხვის დროს დუბლირების დასადგენად მოწმდება ახალი დოკუმენტი ემთხვევა თუ არა უკვე შექმნილ რომელიმე დოკუმენტს. დოკუმენტების შედარებას თქვენ მიერ წინასწარ არჩეული ველების მიხედვით შეძლებთ.

decimal number

-

ფორმატები

application/json, text/json

Sample:
[
  {
    "UniqueId": "4cdb904a-b488-4b17-bcd4-2203cf1e83ff",
    "UniqueKey": 2,
    "ResultCode": 1,
    "Match": 1.0
  },
  {
    "UniqueId": "4cdb904a-b488-4b17-bcd4-2203cf1e83ff",
    "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>4cdb904a-b488-4b17-bcd4-2203cf1e83ff</UniqueId>
    <UniqueKey>2</UniqueKey>
  </DocumentKey>
  <DocumentKey>
    <Match>1</Match>
    <ResultCode>1</ResultCode>
    <UniqueId>4cdb904a-b488-4b17-bcd4-2203cf1e83ff</UniqueId>
    <UniqueKey>2</UniqueKey>
  </DocumentKey>
</ArrayOfDocumentKey>