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": "2025-01-18T08:50:34.8296213+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": "c2269cc2-a783-4414-b5cd-640bcde87bf5",
    "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": "2025-01-18T08:50:34.8296213+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": "c2269cc2-a783-4414-b5cd-640bcde87bf5",
    "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>c2269cc2-a783-4414-b5cd-640bcde87bf5</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>2025-01-18T08:50:34.8296213+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>c2269cc2-a783-4414-b5cd-640bcde87bf5</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>2025-01-18T08:50:34.8296213+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": "dd08c804-794d-4af6-b360-81954730452b",
    "UniqueKey": 2,
    "ResultCode": 1,
    "Match": 1.0
  },
  {
    "UniqueId": "dd08c804-794d-4af6-b360-81954730452b",
    "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>dd08c804-794d-4af6-b360-81954730452b</UniqueId>
    <UniqueKey>2</UniqueKey>
  </DocumentKey>
  <DocumentKey>
    <Match>1</Match>
    <ResultCode>1</ResultCode>
    <UniqueId>dd08c804-794d-4af6-b360-81954730452b</UniqueId>
    <UniqueKey>2</UniqueKey>
  </DocumentKey>
</ArrayOfDocumentKey>