ArmSoft Accountant Public API Documentation

API Version .NET OpenAPI Sync Swagger

🔗 Online documentation

Official documentation for the ArmSoft Accountant Public API.

The ArmSoft Accountant Public API provides programmatic access to:

• Directories: Partners, materials, services, employees and storages
• Documents: Invoices, retail sales, transfer invoices, memorial orders, payment orders, storage input/output orders, materials movement, materials kitting, overhead expense allocation, received services, fixed asset acquisition and disposal, cash input/output orders
• Journals: All documents, invoices, ECR checks
• Reports: Accounts balances and turnover, transactions, partners balances and transactions, materials balances and operations, purchases
• Multi-language Support: Armenian (hy-AM), English (en-US), Russian (ru-RU)

✅ RESTful design with JSON responses
✅ API Key authentication (header-based)
✅ Comprehensive error handling
✅ OpenAPI/Swagger specification
✅ Multi-language support
✅ Built on ASP.NET Core 10 / C# 13

Contact your ArmSoft administrator to obtain an API key.

curl -X GET "https://api.armsoft.am/accountant/v1/directories/materials/1001" \
 -H "apiKey: your-api-key-here" \
 -H "Accept-Language: hy-AM"

{
 "id": 100001,
 "code": "1001",
 "name": "Sample material",
 "unitMeasure": "001",
 "account": "2110",
 "vat": true,
 "isClosed": false
}

All API requests require an API key in the request header:

apiKey: your-api-key-here
Accept-Language: hy-AM

API Key Types:

• Full Access: Complete CRUD operations on all resources
• Limited Access: Restricted to read-only operations (directories, single documents, journals, reports)

📖 Full Authentication Guide

https://api.armsoft.am/accountant/v{version}

Current version: v1

Every document type supports the same four calls.

📖 Code Examples

Interactive API documentation available via Swagger:

• Swagger UI: https://api.armsoft.am/accountant/swagger
• OpenAPI Spec: openapi/openapi.yaml

Import the OpenAPI specification into:

• Postman
• SwaggerHub
• Any OpenAPI-compatible tool

This repository maintains automatically synchronized API documentation:

• swagger.json — Live OpenAPI specification fetched from https://api.armsoft.am/accountant/swagger/v1/swagger.json
• docs/api-reference.md — Auto-generated Markdown reference documentation

A GitHub Actions workflow (.github/workflows/sync-swagger.yml) can be run from the Actions tab to:

1. Fetch the latest swagger.json from the live API
2. Compare it with the committed version
3. If changes are detected:
   • Update swagger.json
   • Regenerate docs/api-reference.md using widdershins
   • Commit and push the changes automatically

To manually trigger a documentation sync:

1. Go to the Actions tab
2. Click "Run workflow" → "Run workflow"

The workflow runs in ~30 seconds and updates the docs if changes are detected.

Note: If the API endpoint ever requires authentication, add an API_TOKEN secret to the repository settings. The workflow includes commented placeholders for this.

Set the Accept-Language header to receive localized responses:

API version is specified in the URL:

/accountant/v1/directories/materials

• Current version: v1
• Backward compatibility maintained within major versions

© 2026 ArmSoft - Armenian Software. All rights reserved.

This documentation is provided for API integration purposes. For licensing of the ArmSoft Accountant system, contact ArmSoft.

ArmSoft is a leading provider of enterprise resource planning (ERP) solutions for businesses in Armenia and beyond. The Accountant system is designed for small and medium enterprises to manage their accounting operations efficiently.

This repository includes machine-readable index files for AI tools and web crawlers:

• llms.txt — structured index of all docs and endpoints
• llms-full.txt — full inline content for AI tools that don't follow links