Փոխանցման հաշիվ

Ուղղորդիչ:  REST API (ամպային տարբերակ) > Փաստաթղթեր >

Փոխանցման հաշիվ

 Previous pageReturn to chapter overviewNext page

Բացել/Փակել թաքցված տեքստը

API-ի միջոցով հնարավոր է ստանալ (GET), ստեղծել (POST), թարմացնել (PUT) և հեռացնել (DELETE) Փոխանցման հաշիվ փաստաթուղթը:

 

URI

https://api.armsoft.am/accountant/v1/documents/transferinvoice

URL Swagger

https://api.armsoft.am/trade/swagger/index.html#/TransferInvoice

Տվյալ ռեսուրսի համար պահանջվում է ավտորիզացիա՝ API բանալու օգտագործմամբ։ Այն անհրաժեշտ է տեղադրել հարցման գլխագրի apiKey դաշտում. API բանալին ստանալու համար անհրաժեշտ է կատարել API գաղտնի բանալու ստացում էջում նկարագրված քայլերը:

-H 'apiKey: @SKq7*ERI]ZIgXvpkWhV'

 

Փոխանցման հաշիվ օբյեկտի ատրիբուտներ (Object Attributes)

Ստորև ներկայացված է օբյեկտի ատրիբուտների նկարագրությունը.

Անվանում

Տեսակ

Կիրառումը

Նկարագրություն

isn

UUID

Optional

*Required for update

System defined

Փաստաթղթի նույնացուցիչ: Պարտադիր է GET, PUT, DELETE հարցումների դեպքում։

Եթե POST հարցման ժամանակ UUID-ը չի փոխանցվում, սերվերը այն ավտոմատ գեներացնում է և վերադարձնում պատասխանում։

date

Date(YYYY-MM-DD)

*Required  

Փաստաթղթի ամսաթիվ: Եթե ամսաթիվը չի փոխանցվում, ապա օգտագործվում է սերվերի ընթացիկ ամսաթիվը:

documentNumber

String(12)

*Required

Փաստաթղթի համար: Եթե համարը չի փոխանցվում, ապա գրանցվում է վերջին համարին ավելացնելով 1:

state

Enum

*Required

Փաստաթղթի վիճակ: Ընդունում է հետևյալ արժեքները.

0 - Գրանցված կամ սևագիր,

1 - Սևագիր,

2 - Գրանցված,

99 - Հեռացված:

Եթե վիճակը չի փոխանցվում, փաստաթուղթը ավտոմատ գրանցված վիճակում է ուղարկվում։

customer

String(20)

Optional

Reference type

Գնորդի կոդ:

currency

String(3)

*Required

Reference type

Փաստաթղթի արժույթի կոդ: Եթե արժեք չենք տալիս, ավտոմատ լրացվում է ծրագրի դրույթներում նշված արժեքը։

exchangeRate

Decimal

*Conditional required

Արժույթի փոխարժեք:

exchangeBase

Decimal

*Conditional required

Արժույթի փոխարժեքի պատիկություն:

contract

String(3)

Optional

Գնորդի պայմանագրի կոդ։ Արժեք չուղարկելու դեպքում ավտոմատ լրացվում է գնորդի հիմնական պայմանագրի կոդը։

contractDate

Date(YYYY-MM-DD)

Optional

Պայմանագրի ամսաթիվ։

comment

String(255)

Optional

Փաստաթղթի մեկնաբանություն։

owner

String(50)

Optional

Reference type

Փաստաթուղթը ստեղծող օգտագործողը։

vatCalculationType

Enum

*Required

ԱԱՀ-ի հաշվարկի ձև։ Ընդունում է հետևյալ արժեքները.

1 - ԱԱՀ-ով,

2 - ԱԱՀ-ն այդ թվում,

3 - Առանց ԱԱՀ,

4 - Զրոյական ԱԱՀ,

5 - ԱԱՀ-ն այդ թվում 16.67 %

Եթե արժեք չենք տալիս, ավտոմատ լրացվում է ծրագրի դրույթներում նշված արժեքը։

priceType

String(2)

Optional

Reference type

Նշվում է, թե ինչ գներով են վաճառվում ապրանքները։

storage

String(5)

Optional

Reference type

Պահեստի կոդ։

discountPercent

Decimal

Optional

Զեղչի տոկոս։

vatAmount

Decimal

*Required

ԱԱՀ-ի գումար: ԱԱՀ-ի գումարը ավտոմատ հաշվարկվում է ապրանքի վրա նշված  ԱԱՀ-ի հաշվարկման բնութագրիչի, ԱԱՀ-ի հաշվարկի ձևի և ընդհանուր գումարի հիման վրա։

totalAmount

Decimal

*Required

Ընդհանուր գումար: Ընդհանուր գումարը ավտոմատ է հաշվարկվում տրված գնի և քանակի հիման վրա։

supplierName

String(100)

Optional

Մատակարարի անվանում։

supplierLegalAddress

String(100)

Optional

Մատակարարի իրավաբանական հասցե։

supplierBusinessAddress

String(100)

Optional

Մատակարարի գործունեության հասցե։

supplierSettlementAccount

String(22)

Optional

Մատակարարի հաշվարկային հաշիվ։

supplierTaxCode

String(20)

Optional

Մատակարարի ՀՎՀՀ։

supplierManagerPosition

String(100)

Optional

Մատակարարի ղեկավարի պաշտոն։

supplierManagerName

String(100)

Optional

Մատակարարի ղեկավարի Ա․Ա․Հ․։

supplierAccountantPosition

String(100)

Optional

Մատակարարի հաշվապահի պաշտոն։

supplierAccountantName

String(100)

Optional

Մատակարարի հաշվապահի անվանում։

customerName

String(50)

Optional

Գնորդի անվանում։

customerLegalAddress

String(255)

Optional

Գնորդի իրավաբանական հասցե։

customerBusinessAddress

String(255)

Optional

Գնորդի գործունեության հասցե։

customerSettlementAccount

String(22)

Optional

Գնորդի հաշվարկային հաշիվ։

customerTaxCode

String(20)

Optional

Գնորդի ՀՎՀՀ։

customerManagerPosition

String(50)

Optional

Գնորդի ղեկավարի պաշտոն։

customerManagerName

String(50)

Optional

Գնորդի ղեկավարի Ա․Ա․Հ․։

customerAccountantPosition

String(50)

Optional

Գնորդի հաշվապահի պաշտոն։

customerAccountantName

String(50)

Optional

Գնորդի հաշվապահի անվանում։

stateRegisterNumber

String(50)

Optional

Պետական գրանցման վկայականի համար։

passportNumber

String(32)

Optional

Անձնագրի համար։

itemList [0..n]

Array

*Required

Նյութական արժեքների, ծառայությունների կամ հիմնական միջոցների անվանացուցակ (մասսիվ): Անվանացուցակը պետք է պարունակի ապրանքի կամ ծառայութան առնվազն մեկ տող։

 

Անվանացուցակի տողի դաշտերը (itemList)

Անվանում

Տեսակ

Կիրառումը

Նկարագրություն

type

Enum

*Required

Տողի տեսակ։ Ընդունում է հետևյալ արժեքները․

1 - Նյութական արժեք,

2 - Ծառայություն,

3 - Հիմնական միջոց։

storage

String(5)

Optional

Reference type

Պահեստի կոդ:

id

Integer

System defined

Նյութական արժեքի, ծառայության կամ հիմնական միջոցի ներքին նույնացուցիչ։

code

String(20)

*Required

Reference type

Նյութական արժեքի, ծառայության կամ հիմնական միջոցի կոդ:

name

String(200)

Optional

Նյութական արժեքի, ծառայության կամ հիմնական միջոցի անվանում: Ծառայության դեպքում անվանումը կարելի է վերագրել։ Ապրանքի դեպքումը դաշտի արժեքը կանտեսվի։

unit

String(3)

Optional

Reference type

Նյութական արժեքի, ծառայության կամ հիմնական միջոցի չափման միավորի կոդ։

unitAbbreviation

String(6)

Read only

Նյութական արժեքի, ծառայության կամ հիմնական միջոցի չափման միավորի հապավում։

quantity

Decimal

*Required

Ապրանքի քանակը կամ ծառայության ծավալ:

price

Decimal

*Required

Վաճառքի գին:

discountPercent

Decimal

Optional

Զեղչի տոկոս: Զեղչված գինը ուղարկելու դեպքում զեղչի տոկոսը հաշվարկվում է ավտոմատ։

discountedPrice

Decimal

Optional

Զեղչված գին: Զեղչի տոկոսը ուղարկելու դեպքում զեղչված գինը հաշվարկվում է ավտոմատ։

amount

Decimal

Optional

Զեղչված գումար: Զեղչի տոկոսը ուղարկելու դեպքում զեղչված գումարը հաշվարկվում է ավտոմատ։

vat

Boolean

*Required

ԱԱՀ-ով հարկման հայտանիշ:

rowNumber

Integer

System defined

Տողի համար։

rowId

Integer

System defined

Տողի ներքին նույնացուցիչ։

 

Օրինակ 1. Փոխանցման հաշիվ փաստաթղթի ստեղծում (պարտադիր դաշտերով)

POST

Request

 

curl -X POST \

 'https://api.armsoft.am/accountant/v1/documents/transferinvoice' \

 -H 'accept: text/plain' \

 -H 'Accept-Language: hy-AM' \

 -H 'apiKey: %}uPbv>T0xZ}3beLxR{1' \

 -H 'Content-Type: application/json' \

 -d '{

 "itemList": [

   {

     "type": "1",

     "code": "10001",

     "quantity": 1,

     "price": 15000

      }

 ]

}'

 

Response body (201 Created)

 

{

   "isn": "a9a129ed-36d7-4a67-ad35-7efefb24fdb7",

   "date": "2026-03-16",

   "documentNumber": "003",

   "customer": "",

   "currency": "AMD",

   "currencyExchangeRate": 1.0000,

   "currencyExchangeBase": 1.0000,

   "state": 2,

   "contract": "",

   "comment": "",

   "vatCalculationType": "1",

   "storage": "",

   "discountPercent": 0,

   "vatAmount": 3000.0000,

   "totalAmount": 18000.0000,

   "supplierBusinessAddress": "",

   "supplierSettlementAccount": "",

   "supplierManagerPosition": "",

   "supplierManagerName": "",

   "supplierAccountantPosition": "",

   "supplierAccountantName": "",

   "customerName": "",

   "customerLegalAddress": "",

   "customerBusinessAddress": "",

   "customerSettlementAccount": "",

   "customerTaxCode": "",

   "customerManagerPosition": "",

   "customerManagerName": "",

   "customerAccountantPosition": "",

   "customerAccountantName": "",

   "stateRegisterNumber": "",

   "passportNumber": "",

   "itemList": [

       {

           "type": "1",

           "storage": "",

           "id": 100000,

           "code": "10001",

           "name": "Իտալական մանկական կոշիկ",

           "unitAbbreviation": "հատ",

           "quantity": 1.0000,

           "price": 15000.0000,

           "discountPercent": 0.0000,

           "discountedPrice": 15000.0000,

           "amount": 15000.0000,

           "vat": true,

           "rowNumber": 0,

           "rowId": 0

       }

   ]

}

 

Օրինակ 2. Փոխանցման հաշիվ փաստաթղթի ստեղծում (լրացուցիչ դաշտերով)

POST

Request

 

curl -X POST \

 'https://api.armsoft.am/accountant/v1/documents/transferinvoice' \

 -H 'accept: text/plain' \

 -H 'Accept-Language: hy-AM' \

 -H 'apiKey: %}uPbv>T0xZ}3beLxR{1' \

 -H 'Content-Type: application/json' \

 -d '{

 "customer": "20001",

 "storage": "01",

 "itemList": [

   {

     "type": "1",

     "code": "10001",

     "quantity": 1,

     "price": 15000,

     "discountPercent": 15

     },

   {

     "type": "1",

     "code": "10002",

     "quantity": 2,

     "price": 20000

        }

 ]

}'

 

Response body (201 Created)

 

{

   "isn": "a5b6e110-2d2e-484f-9769-6eb5f60e245d",

   "date": "2026-03-16",

   "documentNumber": "004",

   "customer": "20001",

   "currency": "AMD",

   "currencyExchangeRate": 1.0000,

   "currencyExchangeBase": 1.0000,

   "state": 2,

   "contract": "",

   "comment": "",

   "vatCalculationType": "1",

   "storage": "01",

   "discountPercent": 0,

   "vatAmount": 10550.0000,

   "totalAmount": 63300.0000,

   "supplierBusinessAddress": "",

   "supplierSettlementAccount": "",

   "supplierManagerPosition": "",

   "supplierManagerName": "",

   "supplierAccountantPosition": "",

   "supplierAccountantName": "",

   "customerName": "",

   "customerLegalAddress": "",

   "customerBusinessAddress": "",

   "customerSettlementAccount": "",

   "customerTaxCode": "",

   "customerManagerPosition": "",

   "customerManagerName": "",

   "customerAccountantPosition": "",

   "customerAccountantName": "",

   "stateRegisterNumber": "",

   "passportNumber": "",

   "itemList": [

       {

           "type": "1",

           "storage": "01",

           "id": 100000,

           "code": "10001",

           "name": "Իտալական մանկական կոշիկ",

           "unitAbbreviation": "հատ",

           "quantity": 1.0000,

           "price": 15000.0000,

           "discountPercent": 15.0000,

           "discountedPrice": 12750.0000,

           "amount": 12750.0000,

           "vat": true,

           "rowNumber": 0,

           "rowId": 0

       },

       {

           "type": "1",

           "storage": "01",

           "id": 100001,

           "code": "10002",

           "name": "Կանացի կոշիկ",

           "unitAbbreviation": "հատ",

           "quantity": 2.0000,

           "price": 20000.0000,

           "discountPercent": 0.0000,

           "discountedPrice": 20000.0000,

           "amount": 40000.0000,

           "vat": true,

           "rowNumber": 1,

           "rowId": 1

       }

   ]

}

 

Օրինակ 3. Նշված isn-ով Փոխանցման հաշիվ փաստաթղթի ստացում

GET

Request

 

curl -X GET \

 'https://api.armsoft.am/accountant/v1/documents/transferinvoice/a5b6e110-2d2e-484f-9769-6eb5f60e245d' \

 -H 'accept: */*' \

 -H 'Accept-Language: hy-AM' \

 -H 'apiKey: %}uPbv>T0xZ}3beLxR{1'

 

Response body  (200 OK)

 

{

   "isn": "a5b6e110-2d2e-484f-9769-6eb5f60e245d",

   "date": "2026-03-16",

   "documentNumber": "004",

   "customer": "20001",

   "currency": "AMD",

   "currencyExchangeRate": 1.0000,

   "currencyExchangeBase": 1.0000,

   "state": 2,

   "contract": "",

   "comment": "",

   "vatCalculationType": "1",

   "storage": "01",

   "discountPercent": 0,

   "vatAmount": 10550.0000,

   "totalAmount": 63300.0000,

   "supplierBusinessAddress": "",

   "supplierSettlementAccount": "",

   "supplierManagerPosition": "",

   "supplierManagerName": "",

   "supplierAccountantPosition": "",

   "supplierAccountantName": "",

   "customerName": "",

   "customerLegalAddress": "",

   "customerBusinessAddress": "",

   "customerSettlementAccount": "",

   "customerTaxCode": "",

   "customerManagerPosition": "",

   "customerManagerName": "",

   "customerAccountantPosition": "",

   "customerAccountantName": "",

   "stateRegisterNumber": "",

   "passportNumber": "",

   "itemList": [

       {

           "type": "1",

           "storage": "01",

           "id": 100000,

           "code": "10001",

           "name": "Իտալական մանկական կոշիկ",

           "unitAbbreviation": "հատ",

           "quantity": 1.0000,

           "price": 15000.0000,

           "discountPercent": 15.0000,

           "discountedPrice": 12750.0000,

           "amount": 12750.0000,

           "vat": true,

           "rowNumber": 0,

           "rowId": 0

       },

       {

           "type": "1",

           "storage": "01",

           "id": 100001,

           "code": "10002",

           "name": "Կանացի կոշիկ",

           "unitAbbreviation": "հատ",

           "quantity": 2.0000,

           "price": 20000.0000,

           "discountPercent": 0.0000,

           "discountedPrice": 20000.0000,

           "amount": 40000.0000,

           "vat": true,

           "rowNumber": 1,

           "rowId": 1

       }

   ]

}

 

Օրինակ 4. Նշված isn-ով Փոխանցման հաշիվ փաստաթղթի դաշտերի խմբագրում

PUT

Request

 

curl -X PUT \

 'https://api.armsoft.am/accountant/v1/documents/transferinvoice/4dfcab64-a372-4e5d-b07f-f971c048e76b' \

 -H 'accept: text/plain' \

 -H 'Accept-Language: hy-AM' \

 -H 'apiKey: %}uPbv>T0xZ}3beLxR{1' \

 -H 'Content-Type: application/json' \

 -d '{

   "isn": "a5b6e110-2d2e-484f-9769-6eb5f60e245d",

   "date": "2026-03-16",

   "documentNumber": "004",

   "customer": "20001",

   "currency": "AMD",

   "currencyExchangeRate": 1.0000,

   "currencyExchangeBase": 1.0000,

   "state": 2,

   "contract": "",

   "comment": "",

   "vatCalculationType": "1",

   "storage": "01",

   "discountPercent": 0,

   "vatAmount": 10550.0000,

   "totalAmount": 63300.0000,

   "supplierBusinessAddress": "",

   "supplierSettlementAccount": "",

   "supplierManagerPosition": "",

   "supplierManagerName": "",

   "supplierAccountantPosition": "",

   "supplierAccountantName": "",

   "customerName": "",

   "customerLegalAddress": "",

   "customerBusinessAddress": "",

   "customerSettlementAccount": "",

   "customerTaxCode": "",

   "customerManagerPosition": "",

   "customerManagerName": "",

   "customerAccountantPosition": "",

   "customerAccountantName": "",

   "stateRegisterNumber": "",

   "passportNumber": "",

   "itemList": [

       {

           "type": "1",

           "storage": "01",

           "id": 100000,

           "code": "10001",

           "name": "Իտալական մանկական կոշիկ",

           "unitAbbreviation": "հատ",

           "quantity": 1.0000,

           "price": 15000.0000,

           "discountPercent": 30.0000

               },

       {

           "type": "1",

           "storage": "01",

           "id": 100001,

           "code": "10002",

           "name": "Կանացի կոշիկ",

           "unitAbbreviation": "հատ",

           "quantity": 4.0000,

           "price": 20000.0000

              }

   ]

}'

 

Response body  (200 OK)

 

{

   "isn": "a5b6e110-2d2e-484f-9769-6eb5f60e245d",

   "date": "2026-03-16",

   "documentNumber": "004",

   "customer": "20001",

   "currency": "AMD",

   "currencyExchangeRate": 1.0000,

   "currencyExchangeBase": 1.0000,

   "state": 2,

   "contract": "",

   "comment": "",

   "vatCalculationType": "1",

   "storage": "01",

   "discountPercent": 0,

   "vatAmount": 10550.0000,

   "totalAmount": 63300.0000,

   "supplierBusinessAddress": "",

   "supplierSettlementAccount": "",

   "supplierManagerPosition": "",

   "supplierManagerName": "",

   "supplierAccountantPosition": "",

   "supplierAccountantName": "",

   "customerName": "",

   "customerLegalAddress": "",

   "customerBusinessAddress": "",

   "customerSettlementAccount": "",

   "customerTaxCode": "",

   "customerManagerPosition": "",

   "customerManagerName": "",

   "customerAccountantPosition": "",

   "customerAccountantName": "",

   "stateRegisterNumber": "",

   "passportNumber": "",

   "itemList": [

       {

           "type": "1",

           "storage": "01",

           "id": 100000,

           "code": "10001",

           "name": "Իտալական մանկական կոշիկ",

           "unitAbbreviation": "հատ",

           "quantity": 1.0000,

           "price": 15000.0000,

           "discountPercent": 30.0000,

           "discountedPrice": 10500.0000,

           "amount": 10500.0000,

           "vat": true,

           "rowNumber": 0,

           "rowId": 0

       },

       {

           "type": "1",

           "storage": "01",

           "id": 100001,

           "code": "10002",

           "name": "Կանացի կոշիկ",

           "unitAbbreviation": "հատ",

           "quantity": 4.0000,

           "price": 20000.0000,

           "discountPercent": 0.0000,

           "discountedPrice": 20000.0000,

           "amount": 80000.0000,

           "vat": true,

           "rowNumber": 1,

           "rowId": 1

       }

   ]

}

 

Օրինակ 5. Նշված isn-ով Փոխանցման հաշիվ փաստաթղթի հեռացում

DELETE

Request

 

curl -X DELETE \

 'https://api.armsoft.am/accountant/v1/documents/transferinvoice/a5b6e110-2d2e-484f-9769-6eb5f60e245d' \

 -H 'accept: */*' \

 -H 'Accept-Language: hy-AM' \

 -H 'apiKey: %}uPbv>T0xZ}3beLxR{1'

 

Response body  (200 OK)