Վաճառք(Մանրածախ) |
  
|
Վաճառք(Մանրածախ) |
|
API-ի միջոցով հնարավոր է ստանալ (GET), ստեղծել (POST), թարմացնել (PUT) և հեռացնել (DELETE) Վաճառք(Մարնածախ) փաստաթուղթը:
URI |
https://api.armsoft.am/accountant/v1/documents/retailsale |
Տվյալ ռեսուրսի համար պահանջվում է ավտորիզացիա՝ 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) |
*Conditional required Reference type |
Գնորդի կոդ։ |
printExpenseConfirmingCheck |
Boolean |
Optional |
Ծախս հիմնավորող ՀԴՄԿ տպելու հայտանիշ։ True արժեքի դեպքում ՀԴՄ կտրոնի վրա կարտացոլվի գնորդի ՀՎՀՀ-ն: |
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-ի կոդը։ |
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 Reference type |
Պահեստի կոդ։ Պարտադիր է ուղարկել այն դեպքում, երբ չենք ուղարկում անվանացուցակով։ |
nonCashAmount |
Decimal |
*Conditional required |
Անկանխիկ վճարվող գումարի չափը: |
useECRPos |
Boolean |
Optional |
Օգտագործել ՀԴՄ-ի POS-ը հայտանիշը նշված լինելու դեպքում ՀԴՄ կտրոն տպելիս անկանխիկ վճարումները հնարավոր կլինի ստանալ ՀԴՄ սարքի POS տերմինալով: |
prepaymentAmount |
Decimal |
*Conditional required |
Օգտագործվող կանխավճարի չափը։ |
vatAmount |
Decimal |
*Conditional required |
ԱԱՀ-ի գումար: ԱԱՀ-ի գումարը ավտոմատ հաշվարկվում է ապրանքի վրա նշված ԱԱՀ-ի հաշվարկման բնութագրիչի, ԱԱՀ-ի հաշվարկի ձևի և ընդհանուր գումարի հիման վրա։ |
totalAmount |
Decimal |
*Conditional required |
Ընդհանուր գումար: Ընդհանուր գումարը ավտոմատ է հաշվարկվում տրված գնի և քանակի հիման վրա։ |
supplierSettlementAccount |
String(22) |
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(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 |
Գնորդի ՀԾՀ։ |
citizenOfRA |
Boolean |
Optional |
Սոցիալական ծախս կատարած ՀՀ քաղաքացի հանդիսանալու հայտանիշ։ |
socialExpensesType |
Enum |
Optional |
Սոցիալական ծախսի տեսակ։ Ընդունում է հետևյալ արժեքները․ 1 - Առողջության ապահովագրական փաթեթ, 2 - Ատամնաբուժական ծառայություններ, 3 - Կրթական ծախս, 4 - Այլ։ |
socialExpenseSocialCard |
String(10) |
Optional |
Սոցիալական ծախս կատարած անձի ՀԾՀ կամ ՀԾՀ չունենալու վերաբերյալ տեղեկանք։ |
socialExpenseCitizenName |
String(255) |
Optional |
Սոցիալական ծախս կատարած անձի անուն, ազգանուն։ |
socialExpenseIdentityDocument |
Enum |
Optional |
Սոցիալական ծախս կատարած անձի անձը հաստատող փաստաթուղթ։ Ընդունում է հետևյալ արժեքները․ 1 - ՀՀ անձնագիր, 2 - Ծննդյան վկայական, 3 - Նույնականացման քարտ, 4 - Կենսաչափական անձնագիր։ |
socialExpenseSerialNumber |
String(32) |
Optional |
Սոցիալական ծախս կատարած անձի անձը հաստատող փաստաթղթի սերիա և/կամ համար: |
itemList [0..n] |
Array |
*Required |
Նյութական արժեքների և ծառայությունների անվանացուցակ (մասսիվ): Անվանացուցակը պետք է պարունակի ապրանքի կամ ծառայութան առնվազն մեկ տող։ |
Անվանացուցակի տողի դաշտերը (itemList)
Անվանում |
Տեսակ |
Կիրառումը |
Նկարագրություն |
type |
Enum |
*Required |
Տողի տեսակ։ Ընդունում է հետևյալ արժեքները․ 1 - Ապրանք, 2 - Ծառայություն, |
storage |
String(5) |
*Conditional required Reference type |
Պահեստի կոդ: Ծառայության դեպքում պահեստը չի նշվում։ |
id |
Integer |
System defined |
Նյութական արժեքի կամ ծառայության ներքին նույնացուցիչ։ |
code |
String(20) |
*Required Reference type |
Նյութական արժեքի կամ ծառայության կոդ: |
name |
String(200) |
Optional |
Նյութական արժեքի կամ ծառայության անվանում: Ծառայության դեպքում անվանումը կարելի է վերագրել։ Ապրանքի դեպքումը դաշտի արժեքը կանտեսվի։ |
unitAbbreviation |
String(6) |
Read only |
Նյութական արժեքի կամ ծառայության չափման միավորի հապավում։ |
quantity |
Decimal |
*Required |
Նյութական արժեքի կամ ծառայության քանակ։ |
price |
Decimal |
*Required |
Նյութական արժեքի կամ ծառայության վաճառքի գին: |
discountPercent |
Decimal |
Optional |
Զեղչի տոկոս: Զեղչված գինը ուղարկելու դեպքում զեղչի տոկոսը հաշվարկվում է ավտոմատ։ |
discountedPrice |
Decimal |
Optional |
Զեղչված գին: Զեղչի տոկոսը ուղարկելու դեպքում զեղչված գինը հաշվարկվում է ավտոմատ։ |
amount |
Decimal |
*Required |
Գումար։ Ավտոմատ հաշվարկվում է ըստ գնի և քանակի։ Արժեք տալու դեպքում պետք է ուշադիր լինել, որ այն բավարարի amount=quantity*discountedPrice պայմանին։ |
environmentalFeePercent |
Decimal |
Optional |
Բնապահպանական հարկի տոկոս: Այս դաշտն արտացոլվում է, եթե Դրույթներում նշված է Բնապահպանական հարկ վճարող դրոշակը: |
environmentalFeeAmount |
Decimal |
Optional |
Բնապահպանական հարկի գումար: Բնապահպանական հարկի %-ը ուղարկելու դեպքում անհրաժեշտ է ուղարկել նաև գումարը։ Գումարի ավտոմատ հաշվարկ չի կատարվում։ Այս դաշտն արտացոլվում է, եթե Դրույթներում նշված է Բնապահպանական հարկ վճարող դրոշակը: |
vat |
Boolean |
*Required |
ԱԱՀ-ով հարկման հայտանիշ: Արժեք չուղարկելու դեպքում ժառանգում է տեղեկատուի վրա նշված արժեքը։ |
dealType |
Enum |
Optional |
Գործարքի տեսակ։ |
expenseAccount |
String(12) |
Optional Reference type |
Նյութական արժեքի վաճառքից առաջացող ծախսի հաշիվ։ |
incomeAccount |
String(12) |
Optional Reference type |
Նյութական արժեքի կամ ծառայության վաճառքից առաջացող հասույթի հաշիվ։ |
markingList[0..n] |
Array |
Optional |
Դրոշմավորման ծածկագրերի ցուցակ (մասսիվ): |
rowNumber |
Integer |
System defined |
Տողի համար: |
rowId |
Integer |
System defined |
Տողի ներքին նույնացուցիչ։ |
Օրինակ 1. Վաճառք(Մանրածախ) փաստաթղթի ստեղծում (պարտադիր դաշտերով)
|
Օրինակ 2. Վաճառք(Մանրածախ) փաստաթղթի ստեղծում (լրացուցիչ դաշտերով)
POST |
|
Օրինակ 3. Նշված isn-ով Վաճառք(Մանրածախ) փաստաթղթի ստացում
|
Օրինակ 4. Նշված isn-ով Վաճառք(Մանրածախ) փաստաթղթի դաշտերի խմբագրում
|
Օրինակ 5. Նշված isn-ով Հաշիվ-Ապրանքագիր փաստաթղթի հեռացում
|
