Balance Exchange სერვისის აღწერა
Balance Exchange სერვისით შესაძლებელია ცნობარების, დოკუმენტების და ტიპიური ოპერაციების გაცვლა ბალანსში.
ვებ-სერვისის გამოძახება ხდება ფორმატით:
<ServerIPaddress>/Balance_Exchange/hs/Exchange/<URLtemplate>
დაპაბლიშებული ბაზის სახელი უნდა იყოს: Balance_Exchange
<ServerIPaddress> - სერვერის მისამართი, სადაც ხდება ბალანსის ბაზის პუბლიკაცია.
<URLtemplate> - აღნიშნავს გაცვლის ობიექტს.
„ბალანსში“ ვებ-სერვისებით გაცვლის ფუნქციონალის გამოსაყენებლად, საჭიროა პროგრამაში გაცვლის გამოყენების ჩართვა:
<ServerIPaddress>/Balance_Exchange/hs/Exchange/Clients
სერვისის აღწერა გენერირდება პროგრამიდან.
გაყიდვები > მყიდველები > ვებ-სერვისების აღწერა;
Name | Description | Exchange type | Type | Default value | Required |
uid | უნიკალური იდენტიფიკატორი | Guid | ახალი უნიკალური იდენტიფიკატორი | PATCH-ის დროს | |
Name | დასახელება | String (150) | დიახ | ||
Group | ჯგუფი | Catalog | მყიდველი | ||
Name | Description | Exchange type | Type | Default value | Required |
uid | უნიკალური იდენტიფიკატორი | Guid | ახალი უნიკალური იდენტიფიკატორი | PATCH-ის დროს | |
Name | დასახელება | String (150) | დიახ | ||
Group | ჯგუფი | Catalog | მყიდველი | ||
FullName | სრული დასახელება | String (150) | Name მნიშვნელობის მიხედვით | ||
ID | ს/ნ | String (50) | დიახ | ||
LegalForm | სამართლებრივი ფორმა | List | სამართლებრივი ფორმები | „შეზღუდული პასუხისმგებლობის საზოგადოება“ | |
Currency | ვალუტა | Catalog | ვალუტა | აღრიცხვის ვალუტა | |
VATType | დღგ-ით დაბეგვრა | List | დღგ-ით დაბეგვრის ტიპები | „დღგ-ის გადამხდელი“ | |
ByAgreements | ანგარიშსწორება ხელშეკრულებების მიხედვით | Boolean | FALSE | ||
MainAgreement | ძირითადი ხელშეკრულება | Catalog | მყიდველის ხელშეკრულება | „ძირითადი ხელშეკრულება“ | |
ReceivablesAccount | ანგარიშსწორების აღრიცხვის ანგარიში | Account | დეფოლტ ანგარიში | ||
AdvancesAccount | ავანსების აღრიცხვის ანგარიში | Account | დეფოლტ ანგარიში | ||
VATArticle | დღგ-ის მუხლი | Catalog | დღგ-ის მუხლი | VATType მნიშვნელობის მიხედვით | |
LegalAddress | იურიდიული მისამართი | String (150) | |||
PhysicalAddress | ფაქტიური მისამართი | String (150) | |||
Phone | ტელეფონი | String (150) | |||
Fax | ფაქსი | String (150) | |||
ელექტრონული ფოსტა | String (255) | ||||
PostAddress | საფოსტო მისამართი | String (Indefinite) | |||
AdditionalInformation | დამატებითი ინფორმაცია | String (Indefinite) | |||
Country | ქვეყანა | Catalog | მსოფლიოს ქვეყნები | „საქართველო“ | |
BankAccount | საბანკო ანგარიში | String (50) | საბანკო ანგარიშის ნომერი |
<ServerIPaddress>/Balance_Exchange/hs/Exchange/ClientsAgreements
სერვისის აღწერა გენერირდება პროგრამიდან.
გაყიდვები > მყიდველები > ვებ-სერვისების აღწერა;
ცნობარი - მყიდველების ხელშეკრულებები
Name | Description | Exchange type | Type | Default value | Required |
uid | უნიკალური იდენტიფიკატორი | Guid | ახალი უნიკალური იდენტიფიკატორი | PATCH-ის დროს | |
Name | დასახელება | String (150) | დიახ | ||
Owner | მფლობელი | Catalog | მყიდველი | დიახ | |
Currency | ვალუტა | Catalog | ვალუტა | Owner მნიშვნელობის მიხედვით | |
Number | ნომერი | String (30) | |||
Date | თარიღი | Date | მიმდინარე თარიღი | ||
Comments | კომენტარები | String (Indefinite) | |||
StartDate | მოქმედების დაწყების თარიღი | Date | |||
EndDate | მოქმედების დასრულების თარიღი | Date | |||
VATType | დღგ-ით დაბეგვრა | List | დღგ-ით დაბეგვრის ტიპები | Owner მნიშვნელობის მიხედვით | |
ReceivablesAccount | ანგარიშსწორების აღრიცხვის ანგარიში | Account | Owner მნიშვნელობის მიხედვით | ||
AdvancesAccount | ავანსების აღრიცხვის ანგარიში | Account | Owner მნიშვნელობის მიხედვით | ||
VATArticle | დღგ-ის მუხლი | Catalog | დღგ-ის მუხლი | VATType მნიშვნელობის მიხედვით. | |
თუ VATType არ გადმოეცემა, Owner მნიშვნელობის მიხედვით. |
<ServerIPaddress>/Balance_Exchange/hs/Exchange/Vendors
სერვისის აღწერა გენერირდება პროგრამიდან.
შესყიდვები > მომწოდებლები > ვებ-სერვისების აღწერა;
Name | Description | Exchange type | Type | Default value | Required |
uid | უნიკალური იდენტიფიკატორი | Guid | ახალი უნიკალური იდენტიფიკატორი | PATCH-ის დროს | |
Name | დასახელება | String (150) | დიახ | ||
Group | ჯგუფი | Catalog | მომწოდებელი | ||
FullName | სრული დასახელება | String (150) | Name მნიშვნელობის მიხედვით | ||
ID | ს/ნ | String (50) | დიახ | ||
LegalForm | სამართლებრივი ფორმა | List | სამართლებრივი ფორმები | „შეზღუდული პასუხისმგებლობის საზოგადოება“ | |
Currency | ვალუტა | Catalog | ვალუტა | აღრიცხვის ვალუტა | |
VATType | დღგ-ით დაბეგვრა | List | დღგ-ით დაბეგვრის ტიპები | „დღგ-ის გადამხდელი“ | |
ByAgreements | ანგარიშსწორება ხელშეკრულებების მიხედვით | Boolean | FALSE | ||
MainAgreement | ძირითადი ხელშეკრულება | Catalog | მომწოდებლის ხელშეკრულება | „ძირითადი ხელშეკრულება“ | |
PayablesAccount | ანგარიშსწორების აღრიცხვის ანგარიში | Account | დეფოლტ ანგარიში | ||
AdvancesAccount | ავანსების აღრიცხვის ანგარიში | Account | დეფოლტ ანგარიში | ||
ReverseChargeVATAccount | უკუდაბეგვრის დღგ-ის ანგარიში | Account | დეფოლტ ანგარიში | ||
PersonalIncomeTax | საშ. გად.-ის გათვალისწინება | Boolean | FALSE | ||
PersonalIncomeTaxRate | საშ. გად.-ის განაკვეთი | Catalog | საშ. გად.-ის განაკვეთი | ||
ItemComplianceType | ნომენკლატურების შესაბამისობა | List | ნომენკლატურების შესაბამისობა | „დასახელებების მიხედვით“ | |
LegalAddress | იურიდიული მისამართი | String (150) | |||
PhysicalAddress | ფაქტიური მისამართი | String (150) | |||
Phone | ტელეფონი | String (150) | |||
Fax | ფაქსი | String (150) | |||
ელექტრონული ფოსტა | String (255) | ||||
PostAddress | საფოსტო მისამართი | String (Indefinite) | |||
AdditionalInformation | დამატებითი ინფორმაცია | String (Indefinite) | |||
RecoverableVATAccount | ჩასათვლელი დღგ-ს ანგარიში | Account | დეფოლტ ანგარიში | ||
Country | ქვეყანა | Catalog | მსოფლიოს ქვეყნები | „საქართველო“ | |
WaybillComplianceType | სზ შესაბამისობის კონტროლის ტიპი | List | სზ შესაბამისობის კონტროლის ტიპი | „ავტომატური“ | |
BankAccount | საბანკო ანგარიში | String (50) | საბანკო ანგარიშის ნომერი |
<ServerIPaddress>/Balance_Exchange/hs/Exchange/VendorsAgreements
სერვისის აღწერა გენერირდება პროგრამიდან.
შესყიდვები > მომწოდებლები > ვებ-სერვისების აღწერა;
ცნობარი - მომწოდებლების ხელშეკრულებები
Name | Description | Exchange type | Type | Default value | Required |
uid | უნიკალური იდენტიფიკატორი | Guid | ახალი უნიკალური იდენტიფიკატორი | PATCH-ის დროს | |
Name | დასახელება | String (150) | დიახ | ||
Owner | მფლობელი | Catalog | მომწოდებელი | დიახ | |
Currency | ვალუტა | Catalog | ვალუტა | Owner მნიშვნელობის მიხედვით | |
Number | ნომერი | String (30) | |||
Date | თარიღი | Date | მიმდინარე თარიღი | ||
Comments | კომენტარები | String (Indefinite) | |||
PersonalIncomeTax | საშ. გად.-ის გათვალისწინება | Boolean | Owner მნიშვნელობის მიხედვით (თუ არ გადმოეცემა PersonalIncomeTaxRate) | ||
PersonalIncomeTaxRate | საშ. გად.-ის განაკვეთი | Catalog | საშ. გად.-ის განაკვეთი | Owner მნიშვნელობის მიხედვით | |
StartDate | მოქმედების დაწყების თარიღი | Date | |||
EndDate | მოქმედების დასრულების თარიღი | Date | |||
VATType | დღგ-ით დაბეგვრა | List | დღგ-ით დაბეგვრის ტიპები | Owner მნიშვნელობის მიხედვით | |
PayablesAccount | ანგარიშსწორების აღრიცხვის ანგარიში | Account | Owner მნიშვნელობის მიხედვით | ||
AdvancesAccount | ავანსების აღრიცხვის ანგარიში | Account | Owner მნიშვნელობის მიხედვით | ||
ReverseChargeVATAccount | უკუდაბეგვრის დღგ-ის ანგარიში | Account | Owner მნიშვნელობის მიხედვით | ||
RecoverableVATAccount | ჩასათვლელი დღგ-ს ანგარიში | Account | Owner მნიშვნელობის მიხედვით | ||
IncomeTaxObject | მოგების გადასახადით დაბეგვრის ობიექტი | Catalog | მოგების გადასახადით დაბეგვრის ობიექტები | ||
IndicateIncomeTaxObject | მიეთითოს დაბეგვრის ობიექტი მოგების გადასახადის მიხედვით | Boolean | FALSE |
<ServerIPaddress>/Balance_Exchange/hs/Exchange/Employees
სერვისის აღწერა გენერირდება პროგრამიდან.
ხელფასი > თანამშრომლები > ვებ-სერვისების აღწერა;
Name | Description | Exchange type | Type | Default value | Required |
uid | უნიკალური იდენტიფიკატორი | Guid | ახალი უნიკალური იდენტიფიკატორი | PATCH-ის დროს | |
Name | დასახელება | String (150) | დიახ | ||
Group | ჯგუფი | Catalog | თანამშრომელი | ||
ID | პირადი ნომერი | String (12) | დიახ | ||
LegalAddress | იურიდიული მისამართი | String (150) | |||
PhysicalAddress | ფაქტიური მისამართი | String (150) | |||
PhoneNumber | ტელეფონი | String (150) | |||
Fax | ფაქსი | String (150) | |||
ელექტრონული ფოსტა | String (255) | ||||
PostAddress | საფოსტო მისამართი | String (Indefinite) | |||
Other | სხვა | String (Indefinite) | |||
Sex | სქესი | List | ფიზიკური პირის სქესი | ||
BirthDate | დაბადების თარიღი | Date | |||
HireDate | მიღების თარიღი | Date | დიახ | ||
DismissalDate | გათავისუფლების თარიღი | Date | |||
Condition | მდგომარეობა | List | თანამშრომლების მდგომარეობა | „მიღებულია სამუშაოზე“ | |
Country | რეზიდენტობის ქვეყანა | Catalog | მსოფლიოს ქვეყნები | „საქართველო“ | |
BankAccount | საბანკო ანგარიში | String (50) | საბანკო ანგარიშის ნომერი | ||
Department | დეპარტამენტი | Catalog | დეპარტამენტი | დიახ | |
Position | თანამდებობა | Catalog | თანამდებობა | ||
AccrualType | დარიცხვა | Catalog | დარიცხვები და დაკავებები | ძირითადი დარიცხვის ტიპი | |
AccrualGrossAmount | თანხა გროსი | Number (13/2) | |||
DeductionType | დაკავება | Catalog | დარიცხვები და დაკავებები | ||
DeductionGrossAmount | თანხა გროსი | Number (13/2) | |||
TaxPreference | გამოქვითვა გამოიყენება | Date | |||
PreferenceRate | გამოქვითვის პროცენტი | Number (3/0) | |||
PreferenceAmount | გამოქვითვის თანხა | Number (13/2) | |||
PreviousIncome | შემოსავალი წინა სამუშაო ადგილიდან | Number (13/2) |
<ServerIPaddress>/Balance_Exchange/hs/Exchange/FixedAssets
სერვისის აღწერა გენერირდება პროგრამიდან.
ძირითადი საშუალებები > ძირითადი საშუალებები > ვებ-სერვისების აღწერა;
Name | Description | Exchange type | Type | Default value | Required |
uid | უნიკალური იდენტიფიკატორი | Guid | ახალი უნიკალური იდენტიფიკატორი | PATCH-ის დროს | |
Name | დასახელება | String (150) | დიახ | ||
Group | ჯგუფი | Catalog | ძირითადი საშუალება | ||
Description | აღწერა | String (150) | |||
AssetNumber | საინვენტარო ნომერი | String (25) | |||
Insured | დაზღვეულია | Boolean | FALSE | ||
WarrantyReceived | მიღებულია გარანტია | Boolean | FALSE | ||
Category | კატეგორია | Catalog | ძირითადი საშუალებების კატეგორია | ||
Lease | ლიზინგი | List | ლიზინგის მდგომარეობა | ||
LeaseDate | ლიზინგის თარიღი | Date | |||
AssetAccount | აღრიცხვის ანგარიში | Account | Category მნიშვნელობის მიხედვით | დიახ | |
DepreciationAccount | ამორტიზაციის ანგარიში | Account | Category მნიშვნელობის მიხედვით | ||
ExpensesAccount | ხარჯების ანგარიში | Account | Category მნიშვნელობის მიხედვით | ||
State | სტატუსი | List | ძირითადი საშუალების სტატუსები | „აქტიური“ | |
ServiceStartDate | ექსპლუატაციაში შესვლის თარიღი | Date | |||
TaxGroup | საგადასახადო ჯგუფი | Catalog | ძს-ს საგადასახადო ჯგუფები | Category მნიშვნელობის მიხედვით | დიახ |
OwnershipType | საკუთრების ფორმა | List | ძირითადი საშუალებების საკუთრების ფორმები | ||
Model | მოდელი | String (100) | |||
ReleaseDate | გამოშვების (აშენების) თარიღი | Date | |||
PurchaseDate | შესყიდვის თარიღი | Date | მიმდინარე თარიღი | ||
PurchasePrice | შესყიდვის ღირებულება | Number (13/2) | |||
WriteOffDate | ჩამოწერის თარიღი | Date | |||
Department | დეპარტამენტი | Catalog | დეპარტამენტი | ||
Warehouse | ადგილმდებარეობა (საწყობი) | Catalog | საწყობი | ||
ResponsiblePerson | პასუხისმგებელი პირი | Catalog | თანამშრომელი | ||
DepreciationStartDate | ამორტიზაციის დაწყების თარიღი | Date | |||
DepreciationMethod | ამორტიზაციის დარიცხვის მეთოდი | List | ამორტიზაციის დარიცხვის მეთოდები | ||
ResidualValue | სალიკვიდაციო ღირებულება | Number (13/2) | |||
UsefulLife | გამოყენების ვადა (თვე) | Number (4/0) | |||
Analytics1 | ანალიტიკა 1 | Analytics | ExpensesAccountAnalytics | ||
Analytics2 | ანალიტიკა 2 | Analytics | ExpensesAccountAnalytics | ||
Analytics3 | ანალიტიკა 3 | Analytics | ExpensesAccountAnalytics | ||
Analytics4 | ანალიტიკა 4 | Analytics | ExpensesAccountAnalytics |
<ServerIPaddress>/Balance_Exchange/hs/Exchange/Items
სერვისის აღწერა გენერირდება პროგრამიდან.
საწყობი > ნომენკლატურა > ვებ-სერვისების აღწერა;
Name | Description | Exchange type | Type | Default value | Required |
uid | უნიკალური იდენტიფიკატორი | Guid | ახალი უნიკალური იდენტიფიკატორი | PATCH-ის დროს | |
Name | დასახელება | String (150) | დიახ | ||
Group | ჯგუფი | Catalog | ნომენკლატურა | ||
InternalArticle | არტიკული | String (12) | |||
Unit | ზომ. ერთეული | Catalog | ზომის ერთეულის კლასიფიკატორი | „ცალი“ | |
ItemType | ნომენკლატურის ტიპი | List | ნომენკლატურის ტიპები | „საქონელი“ | |
Weight | წონა | Number (12/3) | |||
VATRate | დღგ-ის განაკვეთი | Catalog | დღგ-ის განაკვეთი | „ჩვეულებრივი“ | |
InventoriesAccount | მარაგების აღრიცხვის ანგარიში | Account | დეფოლტ ანგარიში | ||
ExpensesAccount | ხარჯების აღრიცხვის ანგარიში (მომსახურების) | Account | დეფოლტ ანგარიში | ||
RevenuesAccount | შემოსავლების აღრიცხვის ანგარიში | Account | დეფოლტ ანგარიში | ||
CostsAccount | ხარჯების აღრიცხვის ანგარიში (საქონლის) | Account | დეფოლტ ანგარიში | ||
VATPayableAccount | დარიცხული დღგ-ის ანგარიში | Account | დეფოლტ ანგარიში | ||
ImportTaxRate | იმპორტის განაკვეთი | Catalog | იმპორტის განაკვეთი | ||
Barcode | შტრიხკოდი | String (200) | |||
FullName | სრული დასახელება | String (150) | Name მნიშვნელობის მიხედვით | ||
VATArticle | დღგ-ის მუხლი | Catalog | დღგ-ის მუხლი | 1. „მიწოდება კომპენსაციით“ | |
2. თუ მუხლის განაკვეთი არ ემთხვევა VATRate-ს, VATRate მნიშვნელობის მიხედვით | |||||
OwnProduction | საკუთარი წარმოების პროდუქტი | Boolean | FALSE | ||
ProductionAccount | წარმოების | Account | |||
UnitCost | ტარიფი | Number (13/2) | |||
LoadingPerVehicle | ტევადობა ერთ ტრანსპორტზე | Number (13/2) | |||
Price | ფასი | Number (11/4) | არაუარყოფითი |
ცხრილი: Packages
Name | Description | Exchange type | Type | Default value | Required |
Package | დასახელება | String (150) | |||
Coefficient | კოეფიციენტი | Number (7/3) |
<ServerIPaddress>/Balance_Exchange/hs/Exchange/TypicalOperations/{TemplateCode}
პარამეტრი TemplateCode არის შაბლონის კოდი.
ტიპები, დეფოლტ შევსებები და აუცილებელი ველები დამოკიდებულია შაბლონზე.
სერვისის აღწერა გენერირდება პროგრამიდან:
ოპერაციები > ტიპიური ოპერაციები > ვებ-სერვისების აღწერა;
სასურველი შაბლონის არჩევის შემდეგ, გენერირდება სერვისის მისამართი და აღწერა.
<ServerIPaddress>/Balance_Exchange/hs/Exchange/Purchase
სერვისის აღწერა გენერირდება პროგრამიდან.
შესყიდვები > შესყიდვა > ვებ-სერვისების აღწერა;
Name | Description | Exchange type | Type | Default value | Required |
uid | უნიკალური იდენტიფიკატორი | Guid | ახალი უნიკალური იდენტიფიკატორი | ||
Date | თარიღი | Date | დიახ | ||
OperationType | ოპერაციის ტიპი | List | შესყიდვის ოპერაციის ტიპები | „შესყიდვა მომწოდებლისგან“ | |
Branch | ფილიალი | Catalog | ფილიალი | ძირითადი ფილიალი | დიახ |
Warehouse | საწყობი | Catalog | საწყობი | ძირითადი საწყობი | Item არის საქონელი |
Vendor | მომწოდებელი | Catalog | მომწოდებელი | დიახ | |
Agreement | ხელშეკრულება | Catalog | მომწოდებლის ხელშეკრულება | Vendor მნიშვნელობის მიხედვით | |
AmountIncludesVAT | თანხა შეიცავს დღგ-ის | Boolean | TRUE | ||
PriceType | ფასის ტიპი | Catalog | ფასის ტიპი | ძირითადი ფასის ტიპი | |
Currency | ვალუტა | Catalog | ვალუტა | 1. Vendor/Agreement მნიშვნელობის მიხედვით | |
2. აღრიცხვის ვალუტა | |||||
CurrencyRate | კურსი | Number (2/13) | მიმდინარე კურსი | ||
VendorAccount | მომწოდებლის ანგარიში | Account | Vendor/Agreement მნიშვნელობის მიხედვით | დიახ | |
AdvancesAccount | ავანსის ანგარიში | Account | Vendor/Agreement მნიშვნელობის მიხედვით | შევსებულია ცხრილი: AdvancesPaid | |
ReverseChargeVATAccount | უკუდაბეგვრის დღგ-ის ანგარიში | Account | Vendor/Agreement მნიშვნელობის მიხედვით | VATType = „უკუდაბეგვრის დღგ“ | |
IncludeWithholdingTax | საშ. გად.-ის გათვალისწინება | Boolean | FALSE | ||
თუ OperationType = „შესყიდვა იმპორტით“, მაშინ ყოველთვის false | |||||
Comments | კომენტარები | String (Indefinite) | |||
AdvanceHolder | ანგარიშვალდებული პირი | Catalog | თანამშრომელი | ||
AdvanceHolderAccount | ანგარიშვალდებულის ანგარიში | Account | დეფოლტ ანგარიში | OperationType = „შესყიდვა ანგარიშვალდებული პირის მიერ“ | |
VATType | დღგ-ით დაბეგვრა | List | დღგ-ით დაბეგვრის ტიპები | 1. Vendor/Agreement მნიშვნელობის მიხედვით; | |
2. თუ OperationType = „შესყიდვა იმპორტით“, მაშინ „იმპორტი“ | |||||
ReceivableVATAccount | დღგ-ის ანგარიში | Account | Vendor/Agreement მნიშვნელობის მიხედვით | VATType = „დღგ-ის გადამხდელი“ ან „უკუდაბეგვრის დღგ“ | |
WithholdingTaxExpenseAccount | საშემოსავლოს ხარჯის ანგარიში | Account | დეფოლტ ანგარიში | IncludeWithholdingTax = true და WithholdingTaxAccount შევსებულია | |
WithholdingTaxAccount | გადასახდელი საშემოსავლო გადასახადის ანგარიში | Account | დეფოლტ ანგარიში | IncludeWithholdingTax = true და OperationType = „შესყიდვა ანგარიშვალდებული პირის მიერ“ | |
PrimaryDocument | პირველადი დოკუმენტი | String (50) | |||
RevenuesAndExpensesAnalytics | შემოსავალ-ხარჯების ანალიტიკა | Catalog | შემოსავალ-ხარჯების ანალიტიკა | ||
Department | დეპარტამენტი | Catalog | დეპარტამენტი | ძირითადი დეპარტამენტი |
ცხრილი: AdvancesPaid
Name | Description | Exchange type | Default value | Required |
AdvanceDate | ავანსის თარიღი | Date | ||
AmountInCurrency | ვალ. თანხა | Number (13/2) | Amount მნიშვნელობის მიხედვით | Amount = 0 |
Amount | თანხა | Number (13/2) | AmountInCurrency მნიშვნელობის მიხედვით | AmountInCurrency = 0 |
CurrencyRate | კურსი | Number (6/4) | 1. AmountInCurrency, Amount მნიშვნელობის მიხედვით, თუ ორივე შევსებულია. | |
2. მიმდინარე კურსი |
ცხრილი: Others
Name | Description | Exchange type | Type | Default value | Required |
Description | შინაარსი | String (1024) | დიახ | ||
Amount | თანხა | Number (13/2) | დიახ | ||
VATRate | დღგ-ის განაკვეთი | Catalog | დღგ-ის განაკვეთი | 1. თუ VATType = „არ არის დღგ-ს გადამხდელი“, მაშინ „დღგ-ის გარეშე“ | |
2. „ჩვეულებრივი“ | |||||
WithholdingTaxRate | საშ. გად.-ის განაკვეთი | Catalog | საშ. გად.-ის განაკვეთი | თუ IncludeWithholdingTax = true, Vendor/Agreement მნიშვნელობის მიხედვით | |
AccountNumber | აღრიცხვის ანგარიში | Account | დიახ | ||
Analytics1 | ანალიტიკა 1 | Analytics | AccountNumberAnalytics | ||
Analytics2 | ანალიტიკა 2 | Analytics | AccountNumberAnalytics | ||
Analytics3 | ანალიტიკა 3 | Analytics | AccountNumberAnalytics | ||
Analytics4 | ანალიტიკა 4 | Analytics | AccountNumberAnalytics |
ცხრილი: Items
Name | Description | Exchange type | Type | Default value | Required |
Item | ნომენკლატურა | Catalog | ნომენკლატურა | დიახ | |
Unit | ერთ. | Catalog | ზომის ერთეული, ზომის ერთეულის კლასიფიკატორი | Item მნიშვნელობის მიხედვით | |
Quantity | რაოდენობა | Number (12/3) | 1 | ||
Price | ფასი | Number (11/4) | 1. Item მნიშვნელობის მიხედვით | ფასი არ არის დადგენილი და Amount=0 | |
2. Amount მნიშვნელობის მიხედვით | |||||
Amount | თანხა | Number (13/2) | Price, WithholdingTaxRate, VATRate მნიშვნელობის მიხედვით | Price = 0 | |
WithholdingTaxRate | საშ. გად.-ის განაკვეთი | Catalog | საშ. გად.-ის განაკვეთი | თუ IncludeWithholdingTax = true, Vendor/Agreement მნიშვნელობის მიხედვით | |
VATRate | დღგ-ის განაკვეთი | Catalog | დღგ-ის განაკვეთი | 1. თუ VATType = „არ არის დღგ-ს გადამხდელი“, მაშინ „დღგ-ის გარეშე“ | |
2. Item მნიშვნელობის მიხედვით | |||||
3. „ჩვეულებრივი“ | |||||
AccountNumber | აღრიცხვის ანგარიში | Account | Item მნიშვნელობის მიხედვით | დიახ | |
Analytics1 | ანალიტიკა 1 | Analytics | AccountNumberAnalytics | ||
Analytics2 | ანალიტიკა 2 | Analytics | AccountNumberAnalytics | ||
Analytics3 | ანალიტიკა 3 | Analytics | AccountNumberAnalytics | ||
Analytics4 | ანალიტიკა 4 | Analytics | AccountNumberAnalytics |
<ServerIPaddress>/Balance_Exchange/hs/Exchange/Sale
სერვისის აღწერა გენერირდება პროგრამიდან.
გაყიდვები > რეალიზაცია > ვებ-სერვისების აღწერა;
Name | Description | Exchange type | Type | Default value | Required |
uid | უნიკალური იდენტიფიკატორი | Guid | ახალი უნიკალური იდენტიფიკატორი | ||
Date | თარიღი | Date | დიახ | ||
Branch | ფილიალი | Catalog | ფილიალი | ძირითადი ფილიალი | დიახ |
Department | დეპარტამენტი | Catalog | დეპარტამენტი | ძირითადი დეპარტამენტი | |
Warehouse | საწყობი | Catalog | საწყობი | ძირითადი საწყობი | დიახ |
Client | მყიდველი | Catalog | მყიდველი | დიახ | |
Agreement | ხელშეკრულება | Catalog | მყიდველის ხელშეკრულება | Client მნიშვნელობის მიხედვით | |
AmountIncludesVAT | თანხა შეიცავს დღგ-ის | Boolean | TRUE | ||
PriceType | ფასის ტიპი | Catalog | ფასის ტიპი | 1. Client მნიშვნელობის მიხედვით | |
2. ძირითადი ფასის ტიპი | |||||
Currency | ვალუტა | Catalog | ვალუტა | 1. Client/Agreement მნიშვნელობის მიხედვით | |
2. აღრიცხვის ვალუტა | |||||
CurrencyRate | კურსი | Number (2/13) | მიმდინარე კურსი | ||
ReceivablesAccount | მყიდველის ანგარიში | Account | Client/Agreement მნიშვნელობის მიხედვით | დიახ | |
AdvancesAccount | ავანსის ანგარიში | Account | Client/Agreement მნიშვნელობის მიხედვით | შევსებულია ცხრილი: AdvancesPaid | |
Comments | კომენტარები | String (Indefinite) | |||
VATExpenseAccount | დღგ - ფინანსური ხარჯის ანგარიში | Account | დეფოლტ ანგარიში | DoesNotAffectReceivables = true, ან | |
VATArticle = „მიწოდება კომპენსაციის გარეშე“ და პერიოდისთვის მოგების გადასახადის დაბეგვრის ობიექტია „სხვაობა ერთობლივი შემოსავლისა და გამოქვითვების თანხებს შორის“ | |||||
DifferenceAccount | სხვაობის ანგარიში | Account | დეფოლტ ანგარიში | DoesNotAffectReceivables = true და პერიოდისთვის მოგების გადასახადის დაბეგვრის ობიექტია „სხვაობა ერთობლივი შემოსავლისა და გამოქვითვების თანხებს შორის“ | |
ReceivablesWriteoffAccount | დავალიანების გადაფარვის ანგარიში | დეფოლტ ანგარიში | VATArticle = „მიწოდება კომპენსაციის გარეშე“ და DoesNotAffectReceivables = false | ||
VATArticle | დღგ-ის მუხლი | Catalog | დღგ-ის მუხლი | 1. Client/Agreement მნიშვნელობის მიხედვით | |
2. „მიწოდება კომპენსაციით“ | |||||
DoesNotAffectReceivables | არ აისახება ანგარიშსწორების ანგარიშზე | Boolean | FALSE | ||
PrimaryDocument | პირველადი დოკუმენტი | String (50) | |||
RevenuesAndExpensesAnalytics | შემოსავალ-ხარჯების ანალიტიკა | Catalog | შემოსავალ-ხარჯების ანალიტიკა | ||
SubjetToIncomeTax | იბეგრება მოგების გადასახადით | Boolean | თუ VATArticle = „მიწოდება კომპენსაციის გარეშე“ და პერიოდისთვის მოგების გადასახადის დაბეგვრის ობიექტია „განაწილებული მოგება“, მაშინ true | ||
IncomeTaxType | მოგების გადასახადით დაბეგვრის ობიექტი | Catalog | მოგების გადასახადით დაბეგვრის ობიექტები | „საქონლის/მომსახურების უსასყიდლო მიწოდება“ | SubjetToIncomeTax = true |
CapitalAccount | კაპიტალის ანგარიში | Account | დეფოლტ ანგარიში | SubjetToIncomeTax = true | |
IncomeTaxAccount | მოგების გადასახადის ანგარიში | Account | დეფოლტ ანგარიში | SubjetToIncomeTax = true |
ცხრილი: AdvancesPaid
Name | Description | Exchange type | Default value | Required |
AdvanceDate | ავანსის თარიღი | Date | ||
AmountInCurrency | ვალ. თანხა | Number (13/2) | Amount მნიშვნელობის მიხედვით | Amount = 0 |
Amount | თანხა | Number (13/2) | AmountInCurrency მნიშვნელობის მიხედვით | AmountInCurrency = 0 |
CurrencyRate | კურსი | Number (6/4) | 1. AmountInCurrency, Amount მნიშვნელობის მიხედვით, თუ ორივე შევსებულია. | |
2. მიმდინარე კურსი |
ცხრილი: Others
Name | Description | Exchange type | Type | Default value | Required |
Description | შინაარსი | String (1024) | დიახ | ||
Amount | თანხა | Number (13/2) | დიახ | ||
VATArticle | დღგ-ის მუხლი | Catalog | დღგ-ის მუხლი | დოკუმენტის VATArticle | |
VATRate | დღგ-ის განაკვეთი | Catalog | დღგ-ის განაკვეთი | VATArticle მნიშვნელობის მიხედვით | |
VATPayableAccount | დღგ-ის ანგარიში | Account | VAT > 0 | ||
RevenueAccount | შემოსავლების ანგარიში | Account | დიახ | ||
Waybill | ს/ზ | Boolean | FALSE | ||
RevenuesAndExpensesAnalytics | შემოსავალ-ხარჯების ანალიტიკა | Catalog | შემოსავალ-ხარჯების ანალიტიკა |
ცხრილი: Items
Name | Description | Exchange type | Type | Default value | Required |
Item | ნომენკლატურა | Catalog | ნომენკლატურა | დიახ | |
Unit | ერთ. | Catalog | ზომის ერთეული | Item მნიშვნელობის მიხედვით | |
Quantity | რაოდენობა | Number (12/3) | 1 | ||
Price | ფასი | Number (11/4) | 1. Item მნიშვნელობის მიხედვით | ფასი არ არის დადგენილი და გამოსათვლელი ველები = 0 | |
2. Amount მნიშვნელობის მიხედვით | |||||
Discount | ფასდაკლება | Number (13/2) | Price, Amount, DiscountedPrice მნიშვნელობის მიხედვით | გამოსათვლელი ველები = 0 | |
თუ * ყოველთვის 0 | |||||
DiscountedPrice | ფასი ფასდაკლებით | Number (11/4) | Price, Amount, Discount მნიშვნელობის მიხედვით | გამოსათვლელი ველები = 0 | |
თუ * ყოველთვის Price | |||||
Amount | თანხა | Number (13/2) | Price, Discount, DiscountedPrice, VATRate მნიშვნელობის მიხედვით | გამოსათვლელი ველები = 0 | |
AccountNumber | აღრიცხვის ანგარიში | Account | Item მნიშვნელობის მიხედვით | Item არის საქონელი | |
VATPayableAccount | დღგ-ის ანგარიში | Account | Item მნიშვნელობის მიხედვით | VAT > 0 | |
IncomeAccount | შემოსავლების ანგარიში | Account | Item მნიშვნელობის მიხედვით | დიახ | |
ExpensesAccount | ხარჯების ანგარიში | Account | Item მნიშვნელობის მიხედვით | Item არის საქონელი | |
RevenuesAndExpensesAnalytics | შემოსავალ-ხარჯების ანალიტიკა | Catalog | შემოსავალ-ხარჯების ანალიტიკა |
<ServerIPaddress>/Balance_Exchange/hs/Exchange/SalesOrders
სერვისის აღწერა გენერირდება პროგრამიდან.
გაყიდვები > მყიდველის შეკვეთები > ვებ-სერვისების აღწერა;
Name | Description | Exchange type | Type | Default value | Required |
uid | უნიკალური იდენტიფიკატორი | Guid | ახალი უნიკალური იდენტიფიკატორი | ||
Date | თარიღი | Date | დიახ | ||
Branch | ფილიალი | Catalog | ფილიალი | ძირითადი ფილიალი | დიახ |
Department | დეპარტამენტი | Catalog | დეპარტამენტი | ძირითადი დეპარტამენტი | |
Client | მყიდველი | Catalog | მყიდველი | დიახ | |
Agreement | ხელშეკრულება | Catalog | მყიდველის ხელშეკრულება | Client მნიშვნელობის მიხედვით | |
AmountIncludesVAT | თანხა შეიცავს დღგ-ის | Boolean | TRUE | ||
PriceType | ფასის ტიპი | Catalog | ფასის ტიპი | 1. Client მნიშვნელობის მიხედვით | |
2. ძირითადი ფასის ტიპი | |||||
Currency | ვალუტა | Catalog | ვალუტა | 1. Client/Agreement მნიშვნელობის მიხედვით | |
2. აღრიცხვის ვალუტა | |||||
CurrencyRate | კურსი | Number (2/13) | მიმდინარე კურსი | ||
Comments | კომენტარები | String (Indefinite) | |||
Warehouse | საწყობი | Catalog | საწყობი | ძირითადი საწყობი | |
ComponentsReservation | მაკომპლექტებლების რეზერვირება | Boolean | TRUE | ||
AutomaticReservation | ავტომატური რეზერვირება | Boolean | TRUE |
ცხრილი: Inventory
Name | Description | Exchange type | Type | Default value | Required |
Production | პროდუქცია | Catalog | ნომენკლატურა | ||
Item | ნომენკლატურა | Catalog | ნომენკლატურა | ||
Quantity | რაოდენობა | Number (12/3) | 1 | ||
Unit | ერთ. | Catalog | ზომის ერთეული | Item მნიშვნელობის მიხედვით | |
Reserve | რეზერვი | Number (12/3) | 0 |
ცხრილი: Items
Name | Description | Exchange type | Type | Default value | Required |
Item | ნომენკლატურა | Catalog | ნომენკლატურა | დიახ | |
Unit | ერთ. | Catalog | ზომის ერთეული | Item მნიშვნელობის მიხედვით | |
Quantity | რაოდენობა | Number (12/3) | 1 | ||
Price | ფასი | Number (11/4) | 1. Item მნიშვნელობის მიხედვით | ფასი არ არის დადგენილი და გამოსათვლელი ველები = 0 | |
2. Amount მნიშვნელობის მიხედვით | |||||
Discount | ფასდაკლება | Number (13/2) | Price, Amount, DiscountedPrice მნიშვნელობის მიხედვით | გამოსათვლელი ველები = 0 | |
თუ * ყოველთვის 0 | |||||
DiscountedPrice | ფასი ფასდაკლებით | Number (11/4) | Price, Amount, Discount მნიშვნელობის მიხედვით | გამოსათვლელი ველები = 0 | |
თუ * ყოველთვის Price | |||||
Amount | თანხა | Number (13/2) | Price, Discount, DiscountedPrice, VATRate მნიშვნელობის მიხედვით | გამოსათვლელი ველები = 0 | |
VATRate | დღგ-ის განაკვეთი | Catalog | დღგ-ის განაკვეთი | 1. თუ VATType = „არ არის დღგ-ს გადამხდელი“, მაშინ „დღგ-ის გარეშე“ | |
2. Item მნიშვნელობის მიხედვით | |||||
3. „ჩვეულებრივი“ | |||||
Reserve | რეზერვი | Number (12/3) | 0 | ||
Specification | სპეციფიკაცია | Catalog | სპეციფიკაცია |
<ServerIPaddress>/Balance_Exchange/hs/Exchange/Prices
არასავალდებულო პარამეტრები: Date, PriceType, Item.
სერვისი აბრუნებს კონკრეტული თარიღისთვის (Date) დადგენილ ყველა არსებულ ფასს.
პარამეტრების გადაცემის გარეშე, დაბრუნდება მიმდინარე თარიღისთვის არსებული ფასები.
პარამეტრებით შესაძლებელია მონაცემების ფასის ტიპის (PriceType) და ნომენკლატურის (Item) ჭრილში გაფილტვრა.
ობიექტების იდენტიფიცირება მოხდება, შესაბამისად, აწყობებში მითითებული ძებნის ტიპების მიხედვით. ძებნის ტიპების ნახვა შესაძლებელია აწყობებში.
ერთდროულად შესაძლებელია როგორც ერთი, ისე რამდენიმე ფილტრის გამოყენება.
მაგალითად, მიმდინარე თარიღისთვის ყველა დადგენილი ფასის წასაკითხად გამოძახება ხდება:
<ServerIPaddress>/Balance_Exchange/hs/Exchange/Prices
კონკრეტული თარიღის, ფასის ტიპის და ნომენკლატურის ჭრილში ფასების წასაკითხად:
<ServerIPaddress>/Balance_Exchange/hs/Exchange/Prices?Date=""&PriceType=""&Item=""
არ დაბრუნდება ნომენკლატურები, თუ გადაცემული პარამეტრების ჭრილში ფასი არაა დადგენილი.
შეზღუდვები:
დეფოლტად სერვისს წვდომა აქვს ყველა არსებულ ფასის ტიპზე დადგენილ ფასზე.
პროგრამაში შესაძლებელია წვდომის მინიჭება კონკრეტულ ფასის ტიპებზე დადგენილ ფასებზე.
ნებადართული ფასის ტიპების სიის შესავსებად და სანახავად, გახსენით:
ადმინისტრირება > მონაცემების სინქრონიზაციის აწყობები > ყველა ფასის ტიპი ნებადართულია
სიაში ფასის ტიპების დამატების შემდეგ, სერვისს წვდომა ექნება მხოლოდ სიაში არსებულ ფასის ტიპებზე დადგენილ ფასებზე.
პასუხები:
400 Invalid date format
404 Price type / Item not found (ვერ მოიძებნა ობიექტი.)
200 OK
<ServerIPaddress>/Balance_Exchange/hs/Exchange/Stocks
არასავალდებულო პარამეტრები: Date, Item, Warehouse, Branch.
სერვისი აბრუნებს კონკრეტული თარიღისთვის (Date) არსებულ მიმდინარე ნაშთებს.
პარამეტრების გადაცემის გარეშე, დაბრუნდება მიმდინარე თარიღისთვის არსებული ნაშთები.
პარამეტრებით შესაძლებელია მონაცემების ნომენკლატურის (Item), საწყობის (Warehouse) და ფილიალის (Branch) ჭრილში გაფილტვრა. ობიექტების იდენტიფიცირება მოხდება, შესაბამისად, აწყობებში მითითებული ძებნის ტიპების მიხედვით. ძებნის ტიპების ნახვა შესაძლებელია აწყობებში.
ერთდროულად შესაძლებელია როგორც ერთი, ისე რამდენიმე ფილტრის გამოყენება.
მაგალითად, მიმდინარე თარიღისთვის ყველა არსებული ნაშთის წასაკითხად გამოძახება ხდება:
<ServerIPaddress>/Balance_Exchange/hs/Exchange/Stocks
კონკრეტული თარიღის, ნომენკლატურის, საწყობის და ფილიალის ჭრილში ნაშთების წასაკითხად:
<ServerIPaddress>/Balance_Exchange/hs/Exchange/Stocks?Date=""&Item=""&Warehouse=""&Branch=""
არ დაბრუნდება ნომენკლატურები, თუ გადაცემული პარამეტრების ჭრილში ნაშთი არის 0.
შეზღუდვები:
დეფოლტად სერვისს წვდომა აქვს ყველა საწყობზე არსებულ ნაშთებზე.
პროგრამაში შესაძლებელია წვდომის მინიჭება კონკრეტული საწყობების ნაშთებზე.
ნებადართული საწყობების სიის შესავსებად და სანახავად, გახსენით:
ადმინისტრირება > მონაცემების სინქრონიზაციის აწყობები > ყველა საწყობი ნებადართულია
სიაში საწყობების დამატების შემდეგ, სერვისს წვდომა ექნება მხოლოდ სიაში არსებულ საწყობებზე არსებულ ნაშთებზე.
პასუხები:
400 Invalid date format
404 Item / Warehouse / Branch not found (ვერ მოიძებნა ობიექტი.)
200 OK
<ServerIPaddress>/Balance_Exchange/hs/Exchange/VendorsBalances
არასავალდებულო პარამეტრები: Date, Vendor, VendorAgreement, Branch.
სერვისი აბრუნებს კონკრეტული თარიღისთვის (Date) არსებულ მიმდინარე დავალიანებებს.
პარამეტრების გადაცემის გარეშე, დაბრუნდება მიმდინარე თარიღისთვის არსებული ყველა მომწოდებლის დავალიანება მომწოდებლის ხელშეკრულებების, ვალუტების, ფილიალების ჭრილში.
პარამეტრებით შესაძლებელია მონაცემების მომწოდებლის (Vendor), მომწოდებლის ხელშეკრულების (VendorAgreement) და ფილიალის (Branch) ჭრილში გაფილტვრა. ობიექტების იდენტიფიცირება მოხდება, შესაბამისად, აწყობებში მითითებული ძებნის ტიპების მიხედვით. ძებნის ტიპების ნახვა შესაძლებელია აწყობებში.
ერთდროულად შესაძლებელია როგორც ერთი, ისე რამდენიმე ფილტრის გამოყენება.
მაგალითად, მიმდინარე თარიღისთვის ყველა არსებულიდავალიანების წასაკითხად გამოძახება ხდება:
<ServerIPaddress>/Balance_Exchange/hs/Exchange/VendorsBalances
კონკრეტული თარიღის, მომწოდებლის, მომწოდებლის ხელშეკრულებისა და ფილიალის ჭრილში ნაშთების წასაკითხად:
<ServerIPaddress>/Balance_Exchange/hs/Exchange/VendorsBalances?Date=""&Vendor=""&VendorAgreement=""&Branch=""
არ დაბრუნდება მომწოდებლები, თუ გადაცემული პარამეტრების ჭრილში დავალიანება არის 0.
პასუხები:
400 Invalid date format
404Vendor / VendorAgreement / Branch not found (ვერ მოიძებნა ობიექტი.)
200 OK
<ServerIPaddress>/Balance_Exchange/hs/Exchange/ClientsBalances
არასავალდებულო პარამეტრები: Date, Client, ClientAgreement, Branch.
სერვისი აბრუნებს კონკრეტული თარიღისთვის (Date) არსებულ მიმდინარე დავალიანებებს.
პარამეტრების გადაცემის გარეშე, დაბრუნდება მიმდინარე თარიღისთვის არსებული ყველა მყიდველის დავალიანება მყიდველის ხელშეკრულებების, ვალუტების, ფილიალების ჭრილში.
პარამეტრებით შესაძლებელია მონაცემების მყიდველის (Client), მყიდველის ხელშეკრულების (ClientAgreement) და ფილიალის (Branch) ჭრილში გაფილტვრა. ობიექტების იდენტიფიცირება მოხდება, შესაბამისად, აწყობებში მითითებული ძებნის ტიპების მიხედვით. ძებნის ტიპების ნახვა შესაძლებელია აწყობებში.
ერთდროულად შესაძლებელია როგორც ერთი, ისე რამდენიმე ფილტრის გამოყენება.
მაგალითად, მიმდინარე თარიღისთვის ყველა არსებულიდავალიანების წასაკითხად გამოძახება ხდება:
<ServerIPaddress>/Balance_Exchange/hs/Exchange/ClientsBalances
კონკრეტული თარიღის, მყიდველის, მყიდველის ხელშეკრულებისა და ფილიალის ჭრილში ნაშთების წასაკითხად:
<ServerIPaddress>/Balance_Exchange/hs/Exchange/ClientsBalances?Date=""&Client=""&ClientAgreement=""&Branch=""
არ დაბრუნდება მყიდველები, თუ გადაცემული პარამეტრების ჭრილში დავალიანება არის 0.
პასუხები:
400 Invalid date format
404Client / ClientAgreement / Branch not found (ვერ მოიძებნა ობიექტი.)
200 OK
სერვისის აღწერის დაგენერირება ხდება პროგრამაში, ნებისმიერი ცნობარისთვის.
მაგალითად, მყიდველებისთვის:
მყიდველების სიის ფორმა:
გენერირდება პარამეტრების აღწერის ცხრილი (Description) და JSON კოდის სტრუქტურა:
ვხსნით აღწერას შესაბამისად მყიდველების / მომწოდებლებისთვის, და ცნობარის ჩამონათვალში ვირჩევთ შესაბამის მნიშვნელობას:
გამოიყენება მხოლოდ ახალი ობიექტებისთვის.
აუცილებელია ყველა თვისების გადმოცემა. (რომელიც არ გადმოიცემა, შეივსება დეფოლტ შევსებებით, ან დარჩება ცარიელი).
ობიექტის იდენტიფიცირება ხდება აწყობების მიხედვით. თუ ბაზაში უკვე არსებობს ობიექტი, დაბრუნდება შეცდომა.
ახალ ობიექტს მიენიჭება ახალი უნიკალური იდენტიფიკატორი, ან გადმოცემული uid.
* გამოიყენება მხოლოდ ერთი ობიექტისთვის. კოლექციის გადაცემის შემთხვევაში, მოხდება მხოლოდ პირველი ობიექტის დამატება.
პასუხები (Responses):
400 Bad Request (ვერ მოხერხდა JSON-ის წაკითხვა. მაგ. სინტაქსური შეცდომა.)
400 Invalid uid (გადმოცემულია არასწორი იდენტიფიკატორი.)
400 Not saved (ვერ მოხერხდა ობიექტის ჩაწერა. დეტალური ინფორმაცია - ტექსტში.)
409 Already exists (ობიექტი უკვე არსებობს.)
201 Created (ობიექტი წარმატებითშეიქმნა/გატარდა.)
Location: შექმნილი ობიექტის ლინკი. აბრუნებს მის მონაცემებს, GET მეთოდის არსებობის შემთხვევაში.
განახლება/დამატება (Update/Create) - PUT მეთოდით.
შესაძლებელია განახლდეს არსებული ობიექტები ან შეიქმნას ახალი.
აუცილებელია ყველა თვისების გადმოცემა. (რომელიც არ გადმოიცემა, შეივსება დეფოლტ შევსებებით, ან გასუფთავდება/დარჩება ცარიელი).
ობიექტის იდენტიფიცირება ხდება აწყობების მიხედვით. თუ ბაზაში ვერ მოიძებნა ობიექტი, შეიქმნება ახალი. (ახალ ობიექტს მიენიჭება ახალი უნიკალური იდენტიფიკატორი, ან გადმოცემული uid.)
ცხრილების არსებობის დროს, უნდა გადმოიცეს მხოლოდ ის ცხრილი, რომლის დამატებაც საჭიროა. ცარიელი თვისებების გადმოცემის შემთხვევაში, დაემატება ცარიელი სტრიქონი.
* გამოიყენება მხოლოდ ერთი ობიექტისთვის. კოლექციის გადაცემის შემთხვევაში, მოხდება მხოლოდ პირველი ობიექტის დამატება / ცვლილება.
* ახლის შექმნისთვის სასურველია POST მეთოდის გამოყენება.
პასუხები (Responses):
400 Bad Request (ვერ მოხერხდა JSON-ის წაკითხვა. მაგ. სინტაქსური შეცდომა.)
400 Invalid uid (გადმოცემულია არასწორი იდენტიფიკატორი.)
400 Not saved (ვერ მოხერხდა ობიექტის ჩაწერა. დეტალური ინფორმაცია - ტექსტში.)
400 Not posted. Required fields are empty (შესავსებია აუცილებელი ველები.)
400 Not posted (ვერ მოხერხდა დოკუმენტის გატარება. დეტალური ინფორმაცია - ტექსტში.)
404 Template not found (ვერ მოხერხდა შაბლონის მოძებნა.)
200 OK (ცნობარი/დოკუმენტი წარმატებითგანახლდა/გატარდა.)
201 Created (ცნობარი/დოკუმენტი წარმატებით შეიქმნა/გატარდა.)
Location: შექმნილი ობიექტის ლინკი. აბრუნებს მის მონაცემებს, GET მეთოდის არსებობის შემთხვევაში.
გამოიყენება მხოლოდ არსებული ობიექტებისთვის.
შესაძლებელია მხოლოდ იმ თვისებების გადმოცემა, რომელთა განახლებაც არის საჭირო. (რომელიც არ გადმოიცემა, არ შეიცვლება).
ობიექტის იდენტიფიცირება ხდება აწყობების მიხედვით. თუ ბაზაში ვერ მოიძებნა ობიექტი, დაბრუნდება შეცდომა.
* გამოიყენება მხოლოდ ერთი ობიექტისთვის. კოლექციის გადაცემის შემთხვევაში, მოხდება მხოლოდ პირველი ობიექტის ცვლილება.
პასუხები (Responses):
400 Bad Request (ვერ მოხერხდა JSON-ის წაკითხვა. მაგ. სინტაქსური შეცდომა.)
400 Invalid uid (გადმოცემულია არასწორი იდენტიფიკატორი.)
400 Not saved (ვერ მოხერხდა ობიექტის ჩაწერა. დეტალური ინფორმაცია - ტექსტში.)
404 Unknown parameter (გადმოცემულია უცნობი პარამეტრი.)
404 Not Found (ვერ მოიძებნა ობიექტი.)
200 OK (ობიექტი წარმატებითგანახლდა.)
გამოიყენება არსებული ობიექტების წასაკითხად.
შესაძლებელია ერთი ან რამდენიმე ობიექტის, ან მთლიანი კოლექციის მიღება.
მეთოდი აბრუნებს JSON კოდს, ან შესაბამის პასუხს.
მთლიანი კოლექციის წასაკითხად, გამოძახება ხდება იგივე ფორმატით.
მაგალითად, მყიდველებისთვის:
<ServerIPaddress>/Balance_Exchange/hs/Exchange/Clients
კოლექციის პაკეტის წასაკითხად, საჭიროა პარამეტრად გადმოიცეს პაკეტის ნომერი და პაკეტის ზომა.
მაგალითად, მესამე ოცეული ნომენკლატურის წასაკითხად, მისამართი იქნება:
ServerIPaddress>/Balance_Exchange/hs/Exchange/Items?Pack=3&PackSize=20
PackSize-ის არ გადმოცემის შემთხვევაში სტანდარტულად პაკეტის ზომა განისაზღვრება 1000-ით.
ერთი ობიექტის წასაკითხად, საჭიროა პარამეტრად გადმოიცეს ძებნის ტიპი და მნიშვნელობა.
კონკრეტული ობიექტისთვის შესაძლებელია შესაბამისი ძებნის ტიპის შესაძლო მნიშვნელობებიდან ნებისმიერის გადმოცემა.
მაგალითად, მყიდველის წასაკითხად, რომლის ს/ნ არის „01234567890“, მისამართი იქნება:
<ServerIPaddress>/Balance_Exchange/hs/Exchange/Clients?ID=01234567890
ძებნის ტიპების ნახვა შესაძლებელია აწყობებში.
! მნიშვნელოვანი
* მყიდველის/მომწოდებლის ხელშეკრულებების წასაკითხად, ჩამოთვლილი პარამეტრების გარდა, შესაძლებელია მფლობელის (Owner) გადმოცემა. ფორმატით:
<ServerIPaddress>/Balance_Exchange/hs/Exchange/ClientsAgreements?Owner=01234567890
მფლობელის იდენტიფიცირება მოხდება, შესაბამისად, მყიდველის/ მომწოდებლისთვის აწყობებში მითითებული ძებნის ტიპით.
პასუხები (Responses):
404 Unknown parameter (გადმოცემულია უცნობი პარამეტრი.)
400 Invalid uid (გადმოცემულია არასწორი იდენტიფიკატორი.)
404 Not Found (ვერ მოიძებნა ობიექტი.)
200 OK
ძებნის აწყობების სანახავად და შესაცვლელად, უნდა გახსნათ:
ადმინისტრირება > მონაცემების სინქრონიზაციის აწყობები > WS გაცვლის ძებნის აწყობები
ძებნის ტიპის არჩევა შესაძლებელია მხოლოდ ჩამოთვლილი ობიექტებისთვის.
არჩეული პარამეტრებით იდენტიფიცირება მოხდება ობიექტების დამატების, განახლების, წაკითხვის დროს. (დანარჩენებისთვის იდენტიფიცირება ხდება Guid უნიკალური იდენტიფიკატორით).
მაგ. მყიდველების იდენტიფიცირებისთვის შესაძლოა ჩამოთვლილი 3 ტიპიდან ერთ-ერთის არჩევა:
იმისთვის, რომ იდენტიფიცირება მოხდეს სასურველი ველით, საჭიროა ძებნის ტიპში აირჩიოთ ის და ჩაწეროთ. შედეგად, მყიდველის დასარედაქტირებლად, ან დოკუმენტში მის ასარჩევად, Client ველში უნდა გადმოსცეთ არჩეული ძებნის ტიპის შესაბამისი მონაცემი, რომლითაც მოხდება ობიექტის ძებნა.
Guid-ების დაგენერირება პროგრამაში არსებული ობიექტებისთვის, შესაძლებელია პროგრამაში, შესაბამისი გაცვლის ობიექტის (ცნობარის / დოკუმენტის) სიის ფორმიდან.
მაგალითად, მყიდველებისთვის ვალუტის შესავსებად EUR მნიშვნელობით, უნდა დავაგენერიროთ EUR ვალუტის Guid:
ანგარიშები, რომლებიც შევსებულია საწყის აწყობებში, „ანგარიშები ავტომატური შევსებისთვის“ ჩანართზე.
საწყის აწყობებში, ვალუტების ჩანართზე შევსებული „ძირითადი ფუნქციონალური ვალუტა“.
შესაბამისი დასახელების მქონე კონსტანტის მნიშვნელობა. (დეფოლტად ივსება „ხელფასი“-თ, ასეთის არსებობის შემთხვევაში.)
მომხმარებლისაწყობებშიმითითებულიძირითადიფასისტიპი.
მომხმარებლისაწყობებშიმითითებულიძირითადი დეპარტამენტი.
მომხმარებლისაწყობებშიმითითებულიძირითადი ფილიალი.
მომხმარებლისაწყობებშიმითითებულიძირითადი საწყობი.
ობიექტის თარიღის მიხედვით, მიმდინარე კურსი ობიექტის ვალუტისთვის.
Number - რიცხვი, მაქსიმალური სიგრძე ფორმატით (Int / Fraction). მთელი რიცხვის გადმოცემის დროს, მაქსიმალური იქნება მთელის და წილადის ჯამური სიგრძე (Int + Fraction).
String - სტრიქონი, მითითებულია მაქსიმალური სიგრძე.
Boolean - ლოგიკური, სტანდარტული JSON ფორმატი: 'true' / 'false', 1 / 0.
Date - თარიღი, სტანდარტული JSON ფორმატი. მაგ: 'yyyy'-'MM'-'dd'T'HH':'mm':'ss'
იდენტიფიცირება ხდება Guid უნიკალური იდენტიფიკატორით (Guid-ის გენერირება) ან დამოკიდებულია აწყობებზე.
იდენტიფიცირება ხდება Guid უნიკალური იდენტიფიკატორით. (Guid-ის გენერირება)
იდენტიფიცირება ხდება ანგარიშის კოდით. (სტრიქონის ტიპის.)
იდენტიფიცირება ხდება ტექსტური მნიშვნელობით ჩამონათვალიდან. (ჩამონათვალების მნიშვნელობები)
დამოკიდებულია ანგარიშზე, რომლის ანალიტიკასაც ავსებთ. (მითითებულია Type-ში.) შესაძლებელია შესაბამისი ტიპის მნიშვნელობის გადმოცემა, შესაბამისი წესით.
Guid - უნიკალური იდენტიფიკატორი
ფორმატი: xxxxxxxx-xxxx-Mxxx-Nxxx-xxxxxxxxxxxx
ინდივიდუალური მეწარმე |
შეზღუდული პასუხისმგებლობის საზოგადოება |
ფიზიკური პირი |
სოლიდარული პასუხისმგებლობის საზოგადოება |
სააქციო საზოგადოება |
კომანდიტური საზოგადოება |
კოოპერატივი |
არაკომერციული იურიდიული პირი |
უცხოური საწარმოს ფილიალი |
უცხოური საწარმო |
საჯარო სამართლის იურიდიული პირი |
სახელმწიფო ორგანო |
არარეზიდენტი ფიზიკური პირი |
დღგ-ის გადამხდელი |
არ არის დღგ-ს გადამხდელი |
იმპორტი |
უკუდაბეგვრის დღგ |
ექსპორტი |
დიპლომატი |
არტიკულის მიხედვით |
დასახელებების მიხედვით |
არ გაკონტროლდეს |
პოზიციების მიხედვით |
საერთო თანხის მიხედვით |
ავტომატური |
მდედრობითი |
მამრობითი |
მიღებულია სამუშაოზე |
გათავისუფლებული |
გაცემულია |
მიღებულია |
არ არსებობს |
არ არის აქტიური |
აქტიური |
ჩამოწერილი |
საკუთარი |
იჯარით |
ლიზინგი |
სხვა |
წრფივი |
საგადასახადო |
არ ერიცხება |
საქონელი |
მომსახურება |
სამუშაო |
შესყიდვა მომწოდებლისგან |
შესყიდვა იმპორტით |
შესყიდვა ანგარიშვალდებული პირის მიერ |