Mongolia eBarimt Receipt
Mongolia eBarimt PosAPI 3.0 e-receipt generator with unique QR + lottery per receipt via your own BYOK PosAPI service
Монголын иБаримт — PosAPI 3.0 цахим баримтын холбогч
НӨАТ / хотын татварын баримт үүсгэж, өөрийн PosAPI-аар баталгаажуулж, ДДТД-г нэхэмжлэх бүрд хадгалж, сугалаа + QR-г баримтад хэвлэнэ
Энэ модуль нь Odoo-н харилцагчийн нэхэмжлэхийг албан ёсны PosAPI 3.0 JSON форматын бүрэн боловсруулсан Монгол иБаримт (цахим төлбөрийн баримт) болгож хувиргаад, таны өөрийн бүртгэлтэй дотоод PosAPI үйлчилгээ рүү дамжуулна. Хүлээн зөвшөөрөгдсөний дараа давтагдашгүй баримтын дугаар (ДДТД), НӨАТ-ын сугалааны дугаар, баталгаажуулах QR код нь нэхэмжлэх болон баримтын бичлэгт буцаан хадгалагдана.
Энэ нь формат үүсгэгч + BYOK дамжуулагч: Монголын Татварын ерөнхий газрын PosAPI шаарддаг яг тэр өгөгдлийг бэлтгэж, таны ажиллуулдаг PosAPI хост руу таны худалдаачийн эрхээр илгээдэг. Энэ модуль нь баталгаажсан санхүүгийн төхөөрөмж биш бөгөөд өөрийн ямар нэгэн магадлан итгэмжлэлийг шаарддаггүй.
Гол боломжууд
PosAPI 3.0 баримт үүсгэгч
PosAPI 3.0-ийн яг талбарын нэрсийг агуулсан стандарт баримтын JSON —
totalAmount, totalVat, totalCityTax,
merchantTin, customerTin, districtCode,
taxType-аар бүлэглэсэн дэд баримтууд, мөн
classificationCode, taxProductCode,
measureUnit бүхий мөр зүйлүүд.
НӨАТ 10% ба хотын татвар (НХАТ)
НӨАТ багтсан дүнгээс хууль ёсны 10% НӨАТ-ыг ялгаж, тохируулж болох хотын татвар (0–2% хязгаар, Улаанбаатарт 2%)-ыг зочлох үйлчилгээний нийлүүлэлтэд хагасыг дээш бүхэлчлэн, бүрэн баталгаажуулалттайгаар тооцоолно.
B2C ба B2B баримт
Харилцагчийн профайлаас B2C_RECEIPT, B2B_RECEIPT,
B2C_INVOICE эсвэл B2B_INVOICE-г автоматаар сонгож,
бизнесийн баримт дээр худалдан авагчийн ТТД-г заавал шаардана.
Баримт тус бүрийн QR + сугалаа
PosAPI-ийн qrData-г хадгалж, скан хийх боломжтой QR зураг үзүүлнэ;
ноорог дээр qrData хараахан байхгүй бол ebarimt.mn-ийн нийтийн
баталгаажуулах URL-ийг үүсгэдэг тул баримт бүрд давтагдашгүй QR байнга бэлэн
байна.
BYOK PosAPI дамжуулалт
Таны дотоод PosAPI (анхдагч http://localhost:7080) руу
дахин оролдлого, хугацаа хэтрэлт, бүрэн хүсэлт/хариултын лог бүхийгээр холбогдоно.
sendData, getInformation,
буцаалт (DELETE /rest/receipt, ДДТД + огноо) дэмжигдэнэ.
ТТД ба регистрийн шалгалт
Монголын ТТД-ийн бүтцийн шалгалт болон иргэний регистрийн дугаарыг албан ёсны еБаримт татвар төлөгчийн лавлагаа (getTinInfo)-аар шалгаж, буцаасан ТТД-г харилцагч дээр хадгалж, хайлт хийх боломжтой хүчинтэй байдлын тэмдэгээр харуулна.
иБаримт талбарын харгалзаа
| PosAPI 3.0 талбар | Odoo дахь эх сурвалж | Тайлбар |
|---|---|---|
type | Харилцагчийн профайл (байгууллага эсвэл хувь хүн) | B2C / B2B баримт эсвэл нэхэмжлэх |
merchantTin | Компанийн иБаримт ТТД | Монголын татвар төлөгчийн дугаар (ТТД) |
customerTin | Харилцагчийн Монгол ТТД | B2B-д заавал |
districtCode | Компанийн дүүргийн код | 4 оронтой ТЕГ дүүргийн код |
taxType | Нэхэмжлэхийн мөрөнд тохируулсан татвар (account.tax дээрх иБаримт татварын төрөл) | VAT_ABLE / VAT_FREE / VAT_ZERO / NOT_VAT; хувь хэмжээнээс автоматаар тодорхойлогдоно, гараар өөрчилж болно |
totalVat | Нэхэмжлэхийн НӨАТ (Odoo-гийн тооцоолсон дүн) | Мөрийн татваргүй дүн дээр тухайн татварын хувь; нэхэмжлэхтэй тэнцээгүй бол баримт үүсэхгүй |
totalCityTax | Нэхэмжлэх дээрх ХХАТ-ын татвар (CITY_TAX гэж тэмдэглэсэн account.tax) | Зочлох үйлчилгээний мөрөнд хотын татвар |
payments | Нэхэмжлэхийн төлөлтийн байдал ба журналын төрөл | CASH / PAYMENT_CARD / QR / BANK_TRANSFER, PAID эсвэл NOT_PAID |
classificationCode | Барааны ангиллын код | ТЕГ-ын бараа/үйлчилгээний ангилал |
qrData / lottery / id | PosAPI хариу | ДДТД нэхэмжлэхэд; сугалаа ба QR зөвхөн баримтад хэвлэгдэнэ (тээврийн бүртгэлд нууцлагдана) |
Хэрхэн ажилладаг вэ
- Компанийн иБаримт ТТД, дүүрэг, ПОС дугаар болон BYOK PosAPI URL-ээ тохируулна.
- Бараануудад иБаримт татварын төрөл, ангиллын код, хотын татварын тэмдэг ононо.
- Харилцагчийн нэхэмжлэх илгээж, иБаримт гаргах-ыг дарж PosAPI JSON-г үүсгэж шалгана.
- Баталгаажуулах (PosAPI)-ыг дарж дамжуулна; ДДТД, сугалаа, QR буцаж ирээд хадгалагдана.
- Багц баталгаажуулалт-аар холболтоо шалгаж, олон нэхэмжлэхийг нэг дор боловсруулна.
Нийцэл ба нууцлал
Odoo 18, 19, 20 (Community ба Enterprise)-д зориулсан. Enterprise-ийн дан хамаарал шаардахгүй. Таны PosAPI хост, эрх нь bring-your-own-key зарчмаар зөвхөн таны өөрийн өгөгдлийн санд хадгалагдах бөгөөд модуль баримтыг зөвхөн таны тохируулсан PosAPI цэг рүү дамжуулж, өөр хаашаа ч илгээдэггүй.
Тайлбар: тариф, форматууд нь нийтлэгдсэн Монголын НӨАТ (10%), хотын татвар (0–2%), PosAPI 3.0 тодорхойлолтыг тусгасан. Энэ модуль нь формат үүсгэгч ба BYOK дамжуулагч бөгөөд ТЕГ-ын баталгаажсан төхөөрөмж биш.
English summary
Mongolia eBarimt — PosAPI 3.0 e-Receipt Connector. This module turns an Odoo customer invoice into a fully-formed Mongolian eBarimt receipt in the official PosAPI 3.0 JSON format, then transmits it to your own locally-registered PosAPI service. Once accepted, the unique receipt number (DDTD) is stored back on the invoice and the VAT-lottery number and the verification QR are kept on the eBarimt receipt for printing. It builds the canonical receipt JSON with exact PosAPI 3.0 field names, extracts the statutory 10% VAT and the configurable 0–2% city tax (НХАТ) with half-up rounding, auto-selects B2C/B2B receipt and invoice types, and validates the Mongolian TIN (ТТД) and verifies the civil-register number against the official eBarimt taxpayer lookup. It is a format generator + BYOK transport that posts to the PosAPI host you run with your own credentials — not an MTA-certified device. Built for Odoo 18, 19 and 20, Community and Enterprise, with no Enterprise-only dependency.
Screenshots
Batch Fiscalisation
Transport Logs
Receipts
l10n_mn_ebarimt_pos. Both define the l10n_mn.ebarimt.batch.wizard model, and Odoo replaces one definition with the other instead of merging them. If you try, the installation is stopped with a clear error message. Choose one of them for a given database.
Update date: 2026-10-02
User guides (PDF)
Related modules
Mongolia eBarimt POS
Mongolia eBarimt POS receipts: PosAPI 3.0 format-gen, 10% VAT (НӨАТ) + 2% city tax (НХАТ), per-receipt QR, BYOK local PosAPI transmission
EU Distance-Sales
Monitor the EUR 10.000 pan-EU B2C distance-sales threshold, alert on crossing and switch to destination-VAT / OSS mode
EU Domiciliation Portal
Let customers sign and confirm SEPA direct-debit domiciliering/domiciliation mandates online with a full audit trail (BE/NL self-service onboarding)