Баримт хэвлэх
Иргэнд (B2C, сугалаатай) болон байгууллагад (B2B). НӨАТ, НХАТ, НӨАТ-аас чөлөөлөгдөх, 0%-ийн барааг нэг багцад хамтад нь.
POST /rest/receiptСанхүү, татварын API · И-баримт gateway
Санхүүгийн мэдээллийн технологийн төвийн 8 систем, 90 API-ийн боломжийг нэг дороос харна. Тэдгээрээс И-баримтын баримт, нэхэмжлэхийг энэ gateway-ээр API key, HTTPS болон merchant-ийн эрхээр хамгаалж шууд үүсгэнэ.
https://ebarimt.account.mndeveloper.itc.gov.mn-ийн 8 систем, 90 API. Мэдээллийг 2026-11-16-ны байдлаар татсан тул албан ёсны дэлгэрэнгүйг тэндээс шалгана уу.
Ачаалж байна…
PosAPI 3.0-ийн бүх баримтын үйлдэл gateway-ээр дамжина. Талбаруудын бүрэн тайлбарыг developer.itc.gov.mn-ээс харна уу.
Иргэнд (B2C, сугалаатай) болон байгууллагад (B2B). НӨАТ, НХАТ, НӨАТ-аас чөлөөлөгдөх, 0%-ийн барааг нэг багцад хамтад нь.
POST /rest/receiptB2B_INVOICE, B2C_INVOICE. Төлбөр хүлээн авах дансыг заана. Төлөгдөхөд баримтыг invoiceId-аар нэхэмжлэхтэй холбоно.
Өмнөх баримтын ДДТД-г inactiveId-д бичээд шинэ баримт гаргана. Сугалаа хүчинтэй хэвээр үлдэнэ.
Буцаалт хийсэн эсвэл алдаатай гарсан баримтыг ДДТД болон огноогоор идэвхгүй болгоно.
DELETE /rest/receiptreportMonth: сар бүрийн 1-7-нд өмнөх сарын B2B баримт болон нэхэмжлэхийг нөхөж үүсгэнэ.
Худалдан авагчийн ebarimt-ийн 8 оронтой кодыг (consumerNo) өгвөл баримт шууд иргэний бүртгэлд орно.
Нэг багцад дэд баримт бүр өөр ТТД-тэй байж болно. Client бүрийг зөвшөөрсөн merchant-уудаар нь хязгаарлана.
receipts[].merchantTinMerchant болон түрээслэгчийн ebarimt-д бүртгэлтэй идэвхтэй данс. Нэхэмжлэхийн дансыг эндээс сонгоно.
GET /rest/bankAccounts?tin=Цаг тутмын автомат илгээлтийг хүлээлгүйгээр баримтуудыг ebarimt руу илгээж, ebarimt талын өөрчлөлтийг татна.
GET /rest/sendDataТаны эрхтэй merchant-ууд, үлдсэн сугалаа, сүүлд илгээсэн огноо, төлбөрийн төрлүүд.
GET /rest/infoPosAPI болон өгөгдлийн сангийн төлөвийг нэвтрэлтгүйгээр харуулна. Uptime мониторингт зориулсан.
GET /healthPosAPI өөрөө нэвтрэлтгүй бөгөөд түүнийг интернэтэд нээж болохгүй. Gateway нь түүний урд талд дараах хамгаалалтуудыг нэмдэг.
X-API-Key header. Өгөгдлийн санд зөвхөн SHA-256 hash хадгалагдана. Key-г идэвхгүй болгоход 60 секундэд хаагдана./rest-ийг HTTP-ээр дуудвал redirect хийлгүйгээр 403 буцаана. Ингэснээр key шифрлэгдээгүй сүлжээгээр дахин явахгүй.Idempotency-Key ашиглавал сүлжээ тасарч дахин илгээсэн ч нэг л баримт гарна. Анхны хариуг Idempotent-Replayed: true header-тэй буцаана.ebk_-ээр эхэлдэг бөгөөд зөвхөн нэг удаа харагдана.http://localhost:7080) https://ebarimt.account.mn-ээр солино. Path болон JSON өөрчлөгдөхгүй.X-API-Key, баримт хэвлэх хүсэлтэд Idempotency-Key (жишээ нь захиалгын дугаар) нэмнэ.Баримт хэвлэх (curl)
curl https://ebarimt.account.mn/rest/receipt \
-H "X-API-Key: ebk_..." \
-H "Idempotency-Key: order-10023" \
-H "Content-Type: application/json" \
-d @receipt.json
receipt.json: иргэнд гаргах баримт, нэг бараа (1000 + НӨАТ 100 + НХАТ 20)
{
"branchNo": "001",
"posNo": "001",
"merchantTin": "37900846788",
"type": "B2C_RECEIPT",
"billIdSuffix": "000123",
"districtCode": "2501",
"totalAmount": 1120,
"totalVAT": 100,
"totalCityTax": 20,
"receipts": [{
"merchantTin": "37900846788",
"taxType": "VAT_ABLE",
"totalAmount": 1120,
"totalVAT": 100,
"totalCityTax": 20,
"items": [{
"name": "Бичгийн цаас A4",
"barCode": "0123456789012",
"barCodeType": "GS1",
"classificationCode": "3212911",
"measureUnit": "ш",
"qty": 1,
"unitPrice": 1120,
"totalAmount": 1120,
"totalVAT": 100,
"totalCityTax": 20
}]
}],
"payments": [{ "code": "CASH", "status": "PAID", "paidAmount": 1120 }]
}
Буцаах
curl -X DELETE https://ebarimt.account.mn/rest/receipt \
-H "X-API-Key: ebk_..." \
-H "Content-Type: application/json" \
-d '{"id": "037900846788001096190000210005299", "date": "2026-11-16 10:30:00"}'
C#
using var http = new HttpClient { BaseAddress = new Uri("https://ebarimt.account.mn/") };
http.DefaultRequestHeaders.Add("X-API-Key", apiKey);
using var request = new HttpRequestMessage(HttpMethod.Post, "rest/receipt")
{
Content = JsonContent.Create(receipt)
};
request.Headers.Add("Idempotency-Key", orderNo); // нэг борлуулалтад нэг key
using var response = await http.SendAsync(request);
// 503: баримт гараагүй, ижил key-ээр дахин илгээ
// 504: баримт гарсан эсэх тодорхойгүй, шалгаад шинэ key-ээр илгээ
PosAPI 3.0-ийн path-уудыг яг давтсан. Body болон хариуг өөрчлөлтгүй дамжуулна.
| Method | Path | Нэвтрэлт | Үүрэг |
|---|---|---|---|
| POST | /rest/receipt | API key, Idempotency-Key (зөвлөнө) | Баримт, нэхэмжлэх, засвар, нөхөлт |
| DELETE | /rest/receipt | API key | Баримт буцаах: {"id": "<33 оронтой ДДТД>", "date": "yyyy-MM-dd HH:mm:ss"} |
| GET | /rest/info | API key | Merchant-ууд, сугалаа, төлбөрийн төрлүүд. Хязгаарлагдсан client зөвхөн өөрийн merchant-уудаа харна |
| GET | /rest/sendData | API key | Ebarimt руу шууд илгээх |
| GET | /rest/bankAccounts?tin= | API key | Merchant-ийн данс |
| GET | /health | Шаардахгүй | PosAPI болон өгөгдлийн сангийн төлөв |
type)B2C_RECEIPT | Иргэнд, сугалаатай. customerTin бичихгүй |
B2B_RECEIPT | Байгууллагад. customerTin заавал |
B2C_INVOICE | Иргэнд гаргах нэхэмжлэх |
B2B_INVOICE | Байгууллагад гаргах нэхэмжлэх. customerTin заавал |
receipts[].taxType)VAT_ABLE | НӨАТ тооцох |
VAT_FREE | НӨАТ-аас чөлөөлөгдөх, taxProductCode-той |
VAT_ZERO | НӨАТ 0%, taxProductCode-той |
NOT_VAT | Монгол Улсын хилийн гадна борлуулсан |
payments[].code)CASH бэлнээр, PAYMENT_CARD карт, BANK_TRANSFER шилжүүлэг, BANK_TRANSFER_QPAY QPay гэх мэт. Идэвхтэй жагсаалт нь /rest/info-ийн paymentTypes-д байна. Төлөгдсөн бол status = PAID.
PosAPI-ийн хариуг статус болон body-той нь өөрчлөлтгүй дамжуулна. Gateway өөрөө буцаах алдаа нь application/problem+json хэлбэртэй.
| Статус | Хэзээ | Юу хийх вэ |
|---|---|---|
| 400 | JSON буруу, merchantTin эсвэл Idempotency-Key буруу | Хүсэлтээ засна |
| 401 | API key байхгүй, буруу эсвэл идэвхгүй | Key-ээ шалгана |
| 403 | HTTP-ээр дуудсан, эсвэл тухайн merchant-д эрхгүй | HTTPS ашиглана, эрх хүснэ |
| 409 | Ижил Idempotency-Key-тэй хүсэлт боловсруулагдаж байна, эсвэл өмнөх оролдлогын үр дүн тодорхойгүй | Түр хүлээгээд дахин оролдоно, эсвэл баримтыг шалгана |
| 422 | Ижил Idempotency-Key-ийг өөр body-той ашигласан | Шинэ борлуулалтад шинэ key |
| 503 | PosAPI ажиллахгүй байна, баримт гараагүй | Ижил key-ээр дахин илгээж болно |
| 504 | PosAPI хариу өгсөнгүй, баримт гарсан байж магадгүй | Шалгаад, шинэ key-ээр илгээнэ |
totalAmount, unitPrice нь бүх татвар шингэсэн дүн байна. Жишээ: 1000 + НӨАТ 100 + НХАТ 20 = 1120.receipts[]) үүсгэнэ.billIdSuffix нь тухайн өдөртөө давтагдахгүй байх ёстой.lottery болон qrData-г зөвхөн баримт дээр хэвлэнэ. Өөр хэлбэрээр хадгалахыг хориглосон.