Հաշիվ-Ապրանքագիր |
  
|
Հաշիվ-Ապրանքագիր |
|
API-ի միջոցով հնարավոր է ստանալ (GET), ստեղծել (POST), թարմացնել (PUT) և հեռացնել (DELETE) Հաշիվ-Ապրանքագիր փաստաթուղթը:
URI |
https://api.armsoft.am/accountant/v1/documents/invoice |
Տվյալ ռեսուրսի համար պահանջվում է ավտորիզացիա՝ 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: |
customer |
String(20) |
Optional Reference type |
Գնորդի կոդ: |
currency |
String(3) |
*Required Reference type |
Փաստաթղթի արժույթի կոդ: Եթե արժեք չենք տալիս, ավտոմատ լրացվում է ծրագրի դրույթներում նշված արժեքը։ |
exchangeRate |
Decimal |
*Conditional required |
Արժույթի փոխարժեք: |
exchangeBase |
Integer |
*Conditional required |
Արժույթի փոխարժեքի պատիկություն: |
state |
Enum |
*Required |
Փաստաթղթի վիճակ: Ընդունում է հետևյալ արժեքները. 0 - Գրանցված կամ սևագիր, 1 - Սևագիր, 2 - Գրանցված, 99 - Հեռացված: Եթե վիճակը չի փոխանցվում, փաստաթուղթը ավտոմատ գրանցված վիճակում է ուղարկվում։ |
contract |
String(50) |
Optional |
Գնորդի պայմանագրի համար։ |
contractDate |
Date(YYYY-MM-DD) |
Optional |
Գնորդի հետ պայմանագրի կնքման ամսաթիվ։ |
customerAccount |
String(12) |
Optional Reference type |
Գնորդի հաշիվը։ Գնորդ նշելու դեպքում հաշիվը պետք է լինի ըստ գործընկերների հաշվառվող։ |
receivedPrepaymentAccount |
String(12) |
Optional Reference type |
Ստացված կանխավճարի հաշիվ։ |
vatAccount |
String(12) |
Optional Reference type |
ԱԱՀ-ի հաշիվը։ |
environmentalFeeAccount |
String(12) |
Optional Reference type |
Բնապահպանական հարկը ձևակերպելիս կրեդիտում լրացվող հաշիվը: Այս դաշտն արտացոլվում է, եթե Դրույթներում նշված է Բնապահպանական հարկ վճարող դրոշակը: |
analytic1 |
String(12) |
Optional Reference type |
Անալիտիկ խումբ 1-ի կոդը։ |
analytic2 |
String(12) |
Optional Reference type |
Անալիտիկ խումբ 2-ի կոդը։ |
bookNumber |
String(10) |
Optional |
Փաստաթղթի գրանցման գրքի համար (չի կիրառվում): |
bookPage |
Integer |
Optional |
Գրանցման գրքում էջի համար (չի կիրառվում): |
bookLine |
Integer |
Optional |
Գրանցման գրքի էջում տողի համար (չի կիրառվում): |
taxExportType |
Enum |
Optional |
Հաշվարկային փաստաթղթի դուրսգրման եղանակ։ Ընդունում է հետևյալ արժեքները․ 1- էլեկտրոնային, 2-թղթային: |
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 |
Պահեստի կոդ։ Պարտադիր է ուղարկել այն դեպքում, երբ չենք ուղարկում անվանացուցակով։ |
discountPercent |
Decimal |
Optional |
Զեղչի %: |
vatAmount |
Decimal |
*Required |
ԱԱՀ-ի գումար: ԱԱՀ-ի գումարը ավտոմատ հաշվարկվում է ապրանքի վրա նշված ԱԱՀ-ի հաշվարկման բնութագրիչի, ԱԱՀ-ի հաշվարկի ձևի և ընդհանուր գումարի հիման վրա։ |
totalAmount |
Decimal |
*Required |
Ընդհանուր գումար: Ընդհանուր գումարը ավտոմատ է հաշվարկվում տրված գնի և քանակի հիման վրա։ |
supplierBusinessAddress |
String(100) |
Optional |
Մատակարարի գործունեության հասցե։ |
supplierSettlementAccount |
String(22) |
Optional |
Մատակարարի հաշվարկային հաշիվ։ |
supplierManagerPosition |
String(100) |
Optional |
Մատակարարի ղեկավարի պաշտոն։ |
supplierManagerName |
String(100) |
Optional |
Մատակարարի ղեկավարի Ա․Ա․Հ․։ |
supplierAccountantPosition |
String(100) |
Optional |
Մատակարարի հաշվապահի պաշտոն։ |
supplierAccountantName |
String(100) |
Optional |
Մատակարարի հաշվապահի անվանում։ |
supplierAdditionalData |
String(255) |
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 |
Պետական գրանցման վկայականի համար։ |
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 |
Ապրանքների առաքման եղանակ։ |
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(10) |
Optional |
Սոցիալական ծախս կատարած անձի անձը հաստատող փաստաթղթի սերիա և/կամ համար: |
additionalFullName |
String(255) |
Optional |
Լիազորված անձի Ա․Ա․Հ․։ |
credentialNumber |
String(255) |
Optional |
Լիազորագրի համար։ |
credentialDate |
Date(YYYY-MM-DD) |
Optional |
Լիազորագրի ամսաթիվ։ |
baseECRCheckNumber |
String(8) |
Optional |
Հիմք հդմ կտրոնի համար։ |
itemList [0..n] |
Array |
*Required |
Նյութական արժեքների, ծառայությունների և հիմնական միջոցների անվանացուցակ (մասսիվ): Անվանացուցակը պետք է պարունակի ապրանքի կամ ծառայութան առնվազն մեկ տող։ |
Անվանացուցակի տողի դաշտերը (itemList)
Անվանում |
Տեսակ |
Կիրառումը |
Նկարագրություն |
type |
Enum |
*Required |
Տողի տեսակ։ Ընդունում է հետևյալ արժեքները․ 1 - Ապրանք, 2 - Ծառայություն, 3 - Հիմնական միջոց։ |
storage |
String(5) Reference type |
*Conditional required |
Պահեստի կոդ: Ծառայության դեպքում պահեստը չի նշվում։ |
id |
Integer |
System defined |
Նյութական արժեքի, ծառայության կամ հիմնական միջոցի ներքին նույնացուցիչ։ |
code |
String(20) Reference type |
*Required |
Նյութական արժեքի, ծառայության կամ հիմնական միջոցի կոդ: |
name |
String(200) |
Optional |
Նյութական արժեքի, ծառայության կամ հիմնական միջոցի անվանում: Ծառայության դեպքում անվանումը կարելի է վերագրել։ Ապրանքի դեպքումը դաշտի արժեքը կանտեսվի։ |
unitAbbreviation |
String(6) |
Read only |
Նյութական արժեքի, ծառայության կամ հիմնական միջոցի չափման միավորի հապավում։ |
quantity |
Decimal |
*Required |
Նյութական արժեքի, ծառայության կամ հիմնական միջոցի քանակ։ |
price |
Decimal |
*Required |
Նյութական արժեքի, ծառայության կամ հիմնական միջոցի վաճառքի գին: |
discountPercent |
Decimal |
Optional |
Զեղչի տոկոս: Զեղչված գինը ուղարկելու դեպքում զեղչի տոկոսը հաշվարկվում է ավտոմատ։ |
discountedPrice |
Decimal |
Optional |
Զեղչված գին: Զեղչի տոկոսը ուղարկելու դեպքում զեղչված գինը հաշվարկվում է ավտոմատ։ |
amount |
Decimal |
*Required |
Գումար։ Ավտոմատ հաշվարկվում է ըստ գնի և քանակի։ |
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[] |
Array |
Optional |
Դրոշմավորման ծածկագրերի ցուցակ (մասսիվ): |
cpaClassifier |
String(12) |
Optional Reference type |
Նյութական արժեքի կամ ծառայության ԱՏԳԱԱ դասակարգիչ: |
rowNumber |
Integer |
System defined |
Տողի համար։ |
rowId |
Integer |
System defined |
Տողի ներքին նույնացուցիչ։ |
Օրինակ 1. Հաշիվ-Ապրանքագիր փաստաթղթի ստեղծում (պարտադիր դաշտերով)
|
Օրինակ 2. Հաշիվ-Ապրանքագիր փաստաթղթի ստեղծում (լրացուցիչ դաշտերով)
POST |
|
Օրինակ 3. Նշված isn-ով Հաշիվ-Ապրանքագիր փաստաթղթի ստացում
|
Օրինակ 4. Նշված isn-ով Հաշիվ-Ապրանքագիր փաստաթղթի դաշտերի խմբագրում
|
Օրինակ 5. Նշված isn-ով Հաշիվ-Ապրանքագիր փաստաթղթի հեռացում
|
