Վճարման հանձնարարագիր

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

Վճարման հանձնարարագիր

 Previous pageReturn to chapter overviewNext page

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

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

 

URI

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

URL Swagger

https://api.armsoft.am/accountant/swagger/index.html#//v1/documents/paymentorder

Տվյալ ռեսուրսի համար պահանջվում է ավտորիզացիա՝ 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:

transactionDate

Date(YYYY-MM-DD)

Optional

Ձևակերպման ամսաթիվ դաշտով տրվում է գործառնությունների ձևակերպման ամսաթիվը, որի սկզբնական արժեքը համընկնում է փաստաթղթի ստեղծման ամսաթվի հետ: Այն չի թույլատրվում լրացնել ավելի փոքր ամսաթվով:

state

Enum

*Required

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

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

1 - Սևագիր,

2 - Գրանցված,

99 - Հեռացված:

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

amountCurrency

Decimal

*Required

Վճարողի հաշվից դուրս գրվող գումարը` հաշվարկային հաշվի արժույթով:

amount

Decimal

*Required

Գումար արժ. դաշտում լրացված գումարի դրամային համարժեքը:

paymentAim

String(255)

*Required

Վճարման նպատակը:

payerName

String(255)

*Required

Վճարողի անվանումը։

payerTaxCode

String(20)

Optional

Հարկ վճարողի հաշվառման համարը:

taxAreaCode

String(2)

Optional

Հարկային տարածքի կոդը։

payerBankAccount

String(22)

*Required

Վճարողի հաշվի համարը բանկում, որից պետք է կատարվի վճարումը:

currency

Enum

Read only

Reference type

Վճարողի հաշվեհամարին համապատասխանող արժույթի կոդը։

partnerCode

String(20)

Optional

Reference type

Գործընկերոջ կոդը։

receiverName

String(50)

*Required

Ստացողի անվանումը։

receiverTaxCode

String(20)

Optional

Ստացողի ՀՎՀՀ։

receiverLegalStatus

Enum

Optional

Ստացողի իրավական կարգավիճակ։ Ընդունում է հետևյալ արժեքները․

1 - Իրավաբանական անձ,

2 - Ֆիզիկական անձ,

3 - Անհատ ձեռներեց:

receiverBankAccount

String(22)

*Required

Ստացողի հաշվի համարը բանկում։

correspondentAccount

String(12)

Optional

Reference type

Վճարողի հաշվարկային հաշվին համապատասխանող հաշվի հետ թղթակցող հաշվային պլանի հաշիվը։

cashOutFlowAccount

String(12)

Optional

Reference type

Գործառնության բնույթին համապատասխան Դրամական արտահոսքի հաշիվն է, որը կատարում է տարանցիկ հաշվի դեր։

analytic1

String(12)

Optional

Reference type

Անալիտիկ խումբ 1-ի կոդ։

analytic2

String(12)

Optional

Reference type

Անալիտիկ խումբ 2-ի կոդ։

forOtherPartner

Boolean

Optional

Վճարում այլ հաճախորդի համար դաշտը լրացվում է, եթե վճարումը կատարվում է մեկ այլ կազմակերպության կամ ֆիզիկական անձի համար:

otherPartnerCode

String(20)

Optional

Reference type

Գործընկերոջ կոդը, որի համար կատարվում է վճարումը:

otherPartnerName

String(50)

*Conditional required

Գործընկերոջ անվանումը, որի համար կատարվում է վճարումը:

otherPartnerResidence

Enum

*Conditional required

Գործընկերոջ ռեզիդենտության հայտանիշը։ Ընդունում է հետևյալ արժեքները․

1 - Ռեզիդենտ,

2 -  Ոչ ռեզիդենտ:

otherPartnerLegalStatus

Enum

*Conditional required

Գործընկերոջ իրավական կարգավիճակը։ Ընդունում է հետևյալ արժեքները․

1 - Իրավաբանական անձ,

2 - Ֆիզիկական անձ,

3 - Անհատ ձեռներեց

otherPartnerTaxCode

String(20)

Optional

Գործընկերոջ ՀՎՀՀ։

otherPartnerPassportData

Enum

Optional

Գործընկերոջ անձնագրի տեսակը։ Ընդունում է հետևյալ արժեքները․

1 - ՀՀ անձնագիր,

2 - Օտարերկրյա անձնագիր,

3 - Մահվան վկայական:

otherPartnerPassportNumber

String(50)

Optional

Գործընկերոջ անձնագրի համարը:

otherPartnerSocialCard

String(11)

Optional

Գործընկերոջ սոցիալական քարտի համարը:

otherPartnerAddress

String(255)

Optional

Գործընկերոջ հասցեն:

 

Օրինակ 1. Վճարման հանձնարարագիր փաստաթղթի ստեղծում

POST

Request

 

curl -X POST \

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

 -H 'accept: text/plain' \

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

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

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

 -d '{

 "amountCurrency": 100,

 "amount": 100,

 "paymentAim": "Պարտքի մարում",

 "payerName": "Աստղ ՍՊԸ",

 "payerBankAccount": "2200073941234213",

 "currency": "USD",

 "receiverName": "Հայկական Ծրագրեր ՍՊԸ",

 "receiverBankAccount": "7770077782963313"

}'

 

Response body (201 Created)

 

{

   "isn": "71160bae-ef56-4af8-8105-f5aed0c44ab4",

   "date": "2026-05-16",

   "documentNumber": "ՎՀ018",

   "state": 2,

   "amountCurrency": 100.0000,

   "amount": 100.0000,

   "paymentAim": "Պարտքի մարում",

   "payerName": "Աստղ ՍՊԸ",

   "payerTaxCode": "",

   "taxAreaCode": "",

   "payerBankAccount": "2200073941234213",

   "currency": "AMD",

   "partnerCode": "",

   "receiverName": "Հայկական Ծրագրեր ՍՊԸ",

   "receiverTaxCode": "",

   "receiverLegalStatus": "",

   "receiverBankAccount": "7770077782963313",

   "correspondentAccount": "",

   "cashOutFlowAccount": "",

   "analytic1": "",

   "analytic2": "",

   "forOtherPartner": false,

   "otherPartnerCode": "",

   "otherPartnerName": "",

   "otherPartnerResidence": "",

   "otherPartnerLegalStatus": "",

   "otherPartnerTaxCode": "",

   "otherPartnerPassportData": "",

   "otherPartnerPassportNumber": "",

   "otherPartnerSocialCard": "",

   "otherPartnerAddress": ""

}

 

Օրինակ 2. Նշված isn-ով Վճարման հանձնարարագիր փաստաթղթի ստացում

GET

Request

 

curl -X GET \

 'https://api.armsoft.am/accountant/v1/documents/paymentorder/71160bae-ef56-4af8-8105-f5aed0c44ab4' \

 -H 'accept: */*' \

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

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

 

Response body  (200 OK)

 

{

   "isn": "71160bae-ef56-4af8-8105-f5aed0c44ab4",

   "date": "2026-05-16",

   "documentNumber": "ՎՀ018",

   "state": 2,

   "amountCurrency": 100.0000,

   "amount": 100.0000,

   "paymentAim": "Պարտքի մարում",

   "payerName": "Աստղ ՍՊԸ",

   "payerTaxCode": "",

   "taxAreaCode": "",

   "payerBankAccount": "2200073941234213",

   "currency": "AMD",

   "partnerCode": "",

   "receiverName": "Հայկական Ծրագրեր ՍՊԸ",

   "receiverTaxCode": "",

   "receiverLegalStatus": "",

   "receiverBankAccount": "7770077782963313",

   "correspondentAccount": "",

   "cashOutFlowAccount": "",

   "analytic1": "",

   "analytic2": "",

   "forOtherPartner": false,

   "otherPartnerCode": "",

   "otherPartnerName": "",

   "otherPartnerResidence": "",

   "otherPartnerLegalStatus": "",

   "otherPartnerTaxCode": "",

   "otherPartnerPassportData": "",

   "otherPartnerPassportNumber": "",

   "otherPartnerSocialCard": "",

   "otherPartnerAddress": ""

}

 

Օրինակ 3. Նշված isn-ով Վճարման հանձնարարագիր փաստաթղթի դաշտերի խմբագրում

PUT

Request

 

curl -X PUT \

 'https://api.armsoft.am/accountant/v1/documents/paymentorder/71160bae-ef56-4af8-8105-f5aed0c44ab4' \

 -H 'accept: text/plain' \

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

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

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

 -d '{

   "isn": "71160bae-ef56-4af8-8105-f5aed0c44ab4",

   "date": "2026-05-16",

   "documentNumber": "ՎՀ018",

   "state": 2,

   "amountCurrency": 50000,

   "amount": 50000,

   "paymentAim": "Պարտքի մարում խմբագրված",

   "payerName": "Աստղ ՍՊԸ",

   "payerTaxCode": "74859614",

   "taxAreaCode": "",

   "payerBankAccount": "2200073941234213",

   "currency": "AMD",

   "partnerCode": "",

   "receiverName": "Հայկական Ծրագրեր ՍՊԸ",

   "receiverTaxCode": "",

   "receiverLegalStatus": "",

   "receiverBankAccount": "7770077782963313",

   "correspondentAccount": "",

   "cashOutFlowAccount": "",

   "analytic1": "",

   "analytic2": "",

   "forOtherPartner": false,

   "otherPartnerCode": "",

   "otherPartnerName": "",

   "otherPartnerResidence": "",

   "otherPartnerLegalStatus": "",

   "otherPartnerTaxCode": "",

   "otherPartnerPassportData": "",

   "otherPartnerPassportNumber": "",

   "otherPartnerSocialCard": "",

   "otherPartnerAddress": ""

}'

 

Response body  (200 OK)

 

{

   "isn": "71160bae-ef56-4af8-8105-f5aed0c44ab4",

   "date": "2026-05-16",

   "documentNumber": "ՎՀ018",

   "state": 2,

   "amountCurrency": 50000.0000,

   "amount": 50000.0000,

   "paymentAim": "Պարտքի մարում խմբագրված",

   "payerName": "Աստղ ՍՊԸ",

   "payerTaxCode": "74859614",

   "taxAreaCode": "",

   "payerBankAccount": "2200073941234213",

   "currency": "AMD",

   "partnerCode": "",

   "receiverName": "Հայկական Ծրագրեր ՍՊԸ",

   "receiverTaxCode": "",

   "receiverLegalStatus": "",

   "receiverBankAccount": "7770077782963313",

   "correspondentAccount": "",

   "cashOutFlowAccount": "",

   "analytic1": "",

   "analytic2": "",

   "forOtherPartner": false,

   "otherPartnerCode": "",

   "otherPartnerName": "",

   "otherPartnerResidence": "",

   "otherPartnerLegalStatus": "",

   "otherPartnerTaxCode": "",

   "otherPartnerPassportData": "",

   "otherPartnerPassportNumber": "",

   "otherPartnerSocialCard": "",

   "otherPartnerAddress": ""

}

 

Օրինակ 4. Նշված isn-ով Վճարման հանձնարարագիր փաստաթղթի հեռացում

DELETE

Request

 

curl -X DELETE \

 'https://api.armsoft.am/accountant/v1/documents/paymentorder/71160bae-ef56-4af8-8105-f5aed0c44ab4' \

 -H 'accept: */*' \

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

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

 

Response body  (200 OK)

.