Վերադարձ գնորդից

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

Վերադարձ գնորդից

Previous pageReturn to chapter overviewNext page

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

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

 

URI

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

URL Swagger

https://api.armsoft.am/accountant/swagger/index.html#/ReturnFromCustomer

GitHub

 

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

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

baseDocumentISN

UUID

Optional

Հիմք փաստաթղթի նույնացուցիչ։

ecrReturnCheckNumber

String(8)

Optional

Վերադարձի փաստաթղթի հդմ կտրոնի համար։

customer

String(20)

Optional

Reference type

Գնորդի կոդ:

currency

String(3)

*Required

Reference type

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

currencyExchangeRate

Decimal

*Conditional required

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

currencyExchangeBase

Integer

*Conditional required

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

previousDayExchangeRate

Boօlean

Optional

Նախորդ օրվա փոխարժեքը կիրառելու հայտանիշ։

contract

String(50)

Optional

Գնորդի պայմանագրի համար։

contractDate

Date(YYYY-MM-DD)

Optional

Գնորդի հետ պայմանագրի կնքման ամսաթիվ։

cashDesk

String(12)

Optional

Reference type

Դրամարկղի կոդը, որտեղից կելքագրվի վերադարձվող կանխիկ գումարը։

customerAccount

String(12)

Optional

Reference type

Գնորդի հաշիվը:  Ավտոմատ լրացվում է դրույթներից։

receivedPrepaymentAccount

String(12)

Optional

Reference type

Ստացված կանխավճարի հաշիվը: Ավտոմատ լրացվում է դրույթներից։

vatAccount

String(12)

Optional

Reference type

ԱԱՀ-ի հաշիվը: Ավտոմատ լրացվում է դրույթներից։

environmentalFeeAccount

String(12)

Optional

Reference type

Բնապահպանական հարկը ձևակերպելիս կրեդիտում լրացվող հաշիվը: Այս դաշտն արտացոլվում է, եթե Դրույթներում նշված է Բնապահպանական հարկ վճարող դրոշակը:  Ավտոմատ լրացվում է դրույթներից։

nonCashTransactionAccount

String(12)

Optional

Reference type

Անկանխիկ ստացված գումարը մուտքագրելու հաշիվը: Ավտոմատ լրացվում է դրույթներից։

analytic1

String(12)

Optional

Reference type

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

analytic2

String(12)

Optional

Reference type

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

baseTaxInvoiceSeries

String(1)

Optional

Հիմք փաստաթղթի սերիա։

baseTaxInvoiceNumber

String(10)

Optional

Հիմք փաստաթղթի համար։

baseSubmissionDate

Date(YYYY-MM-DD)

Optional

Հիմք փաստաթղթի դուրսգրման ամսաթիվը:

taxExportType

Enum

Optional

Հարկային հաշիվների դուրսգրման եղանակը` էլեկտրոնային կամ թղթային:

taxInvoiceSeries

String(1)

Optional

Հարկային մարմնի կողմից ստացված սերիա:

taxInvoiceNumber

String(10)

Optional

Հարկային մարմնի կողմից ստացված համար։

submissionDate

Date(YYYY-MM-DD)

Optional

Հարկային հաշիվների դուրսգրման ամսաթիվը:

comment

String(255)

Optional

Մեկնաբանություն փաստաթղթի վերաբերյալ:

vatCalculationType

Enum

*Required

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

1 - ԱԱՀ-ով,

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

3 - Առանց ԱԱՀ,

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

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

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

dealType

Enum

Optional

Դաշտը լրացվում է, եթե փաստաթղթում առկա են ԱԱՀ-ով չհարկվող տողեր: Եթե փաստաթղթում ԱԱՀ-ի հաշվարկի ձևը նշված է ԱԱՀ-ով կամ ԱԱՀ-ն այդ թվում, ապա որպես Գործարքի տեսակ հնարավոր է նշել հետևյալ տարբերակներից մեկը.

1 - ԱԱՀ-ի 0% դրույքաչափով հարկվող,

2 - ԱԱՀ- ից ազատված,

3 - Այլ:

Եթե փաստաթղթում ԱԱՀ-ի հաշվարկի ձևը նշված է Առանց ԱԱՀ կամ Զրոյական ԱԱՀ, ապա որպես Գործարքի տեսակ հնարավոր է նշել հետևյալ տարբերակներից մեկը.

1 - Հարկման հատուկ համակարգ,

2 - ԱԱՀ-ից ազատված,

3 - ԱԱՀ-ի 0% դրույքաչափով հարկվող,

4 - ԱԱՀ-ով հարկման օբյեկտ չհամարվող,

5 - Արտահանում,

6 - ԵՏՄ օդային տրանսպորտով արտահանում,

7 - ԱԱՀ չվճարողներ:

Դաշտի արժեքը արտահանվում է e-Invoicing:

storage

String(5)

Optional

Պահեստի կոդ։ Պարտադիր է ուղարկել այն դեպքում, երբ չենք ուղարկում անվանացուցակով։

discountPercent

Decimal

Optional

Զեղչի %:

nonCashAmount

Decimal

Optional

Անկանխիկ վերադարձվող գումարի չափը:

prepaymentAmount

Decimal

Optional

Օգտագործված կանխավճարի չափը։

vatAmount

Decimal

*Conditional required

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

totalAmount

Decimal

*Required

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

supplierBusinessAddress

String(255)

Optional

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

supplierSettlementAccount

String(22)

Optional

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

supplierManagerPosition

String(50)

Optional

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

supplierManagerName

String(50)

Optional

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

supplierAccountantPosition

String(50)

Optional

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

supplierAccountantName

String(50)

Optional

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

customerName

String(50)

Optional

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

customerLegalAddress

String(255)

Optional

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

customerBusinessAddress

String(255)

Optional

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

customerSettlementAccount

String(50)

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

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

idDocumentType

Enum

Optional

Անձը հաստատող փաստաթղթի տեսակ։ Ընդունում է հետևյալ արժեքները․ 1 - ՀՀ անձնագիր, 2 - Ծննդյան վկայական, 3 - Կացության քարտ, 4 - Կոնվենցիոն ճանապարհորդական փաստաթուղթ, 5 - Նույնականացման քարտ, 6 - Կենսաչափական անձնագիր, 7 - Օտարերկրյա անձնագիր՝ ՀՀ-ում աշխատանքի իրավունքով, 8 - Օտարերկրյա անձնագիր։

passportNumber

String(32)

Optional

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

socialCardNumber

String(10)

Optional

Գնորդի ՀԾՀ։

customerAdditionalData

String(255)

Optional

Գնորդի վերաբերյալ լրացուցիչ տվյալներ։

shippingMethod

String(255)

Optional

Ապրանքների առաքման եղանակ։

additionalFullName

String(255)

Optional

Լիազորված անձի Ա․Ա․Հ․։

credentialNumber

String(255)

Optional

Լիազորագրի համար։

credentialDate

Date(YYYY-MM-DD)

Optional

Լիազորագրի ամսաթիվ։

itemList [0..n]

Array

*Required

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

 

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

Անվանում

Տեսակ

Կիրառումը

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

type

Enum

*Required

Reference type

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

1 - Ապրանք,

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

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

storage

String(5)

*Required

Reference type

Պահեստի կոդ: Ծառայության դեպքում պահեստը չի նշվում։

id

Integer

System defined

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

code

String(20)

*Required

Reference type

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

name

String(200)

*Conditional required

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

unitAbbreviation

String(6)

Read only

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

quantity

Decimal

*Required

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

price

Decimal

*Conditional required

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

discountPercent

Decimal

Optional

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

discountedPrice

Decimal

Optional

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

amount

Decimal

*Conditional required

Գումար։ Ավտոմատ հաշվարկվում է ըստ գնի և քանակի։

environmentalFeePercent

Decimal

Optional

Բնապահպանական հարկի տոկոս: Այս դաշտն արտացոլվում է, եթե Դրույթներում նշված է Բնապահպանական հարկ վճարող դրոշակը:

environmentalFeeAmount

Decimal

Optional

Բնապահպանական հարկի գումար: Բնապահպանական հարկի %-ը ուղարկելու դեպքում անհրաժեշտ է ուղարկել նաև գումարը։ Գումարի ավտոմատ հաշվարկ չի կատարվում։ Այս դաշտն արտացոլվում է, եթե Դրույթներում նշված է Բնապահպանական հարկ վճարող դրոշակը:

vat

Boolean

*Required

ԱԱՀ-ով հարկման հայտանիշ: Ավտոմատ լրացվում է նյութական արժեքի տեղեկատուից։

dealType

Enum

Optional

Գործարքի տեսակ։

costPriceWithoutVAT

Decimal

*Conditional required

Վերադարձվող նյութական արժեքների ինքնարժեքը առանց ԱԱՀ: Պարտադիր է լրացնել, եթե հիմք փաստաթուղթ չենք նշում։

costAmountWithoutVAT

Decimal

*Conditional required

Վերադարձվող նյութական արժեքների ինքնարժեքի գումարը առանց ԱԱՀ: Պարտադիր է լրացնել, եթե հիմք փաստաթուղթ չենք նշում։

costVATAmount

Decimal

Optional

Վերադարձվող նյութական արժեքների ինքնարժեքի ԱԱՀ-ի գումար։

costAccount

String(12)

*Conditional required

Reference type

Վերադարձվող նյութական արժեքների ինքնարժեքի հաշիվ։ Ավտոմատ լրացվում է նյութական արժեքի տեղեկատուից։

expenseAccount

String(12)

Optional

Reference type

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

incomeAccount

String(12)

Optional

Reference type

Նյութական արժեքի, ծառայության կամ հիմնական միջոցի վաճառքից առաջացող հասույթի հաշիվ։ Ավտոմատ լրացվում է նյութական արժեքի տեղեկատուից։

markingList [0..n]

Array

Optional

Դրոշմավորման ծածկագրերի ցուցակ (մասսիվ):

cpaClassifier

String(12)

Optional

Reference type

Նյութական արժեքի կամ  ծառայության ԱՏԳԱԱ դասակարգիչ: Ավտոմատ լրացվում է նյութական արժեքի տեղեկատուից։

rowNumber

Integer

System defined

Տողի համար։

rowId

Integer

System defined

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

 

GitHub

 

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

POST

 

Օրինակ 2. Վերադարձ գնորդից փաստաթղթի ստեղծում հիմք փաստաթղթով

POST

 

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

GET

 

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

PUT

 

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

DELETE