mufassall

Konspekt · Biznes jarayonlar

Pul va yaxlitlash

13 daq · O'rta · mufassall.dtwin.uz/uz/l/money-and-rounding/

← Darsni ochish

Muammo

Do'kon so'mda sotadi va 12% QQS bilan elektron hisob-faktura chiqaradi. Narxlar suzuvchi nuqtali sonlar bo'lsa, aynan to'g'ri summadagi to'lov tenglik tekshiruvidan o'tmaydi. Summalar valyutasi bilan birga eng kichik birlikdagi butun songa aylanadi, keyin esa asl savollar boshlanadi: qaysi yaxlitlash qoidasi, qayerda yaxlitlash (har qatorda yoki butun hujjatda), summani bir tiyin ham yo'qotmasdan qanday bo'lish, bir haftadan keyin ham isbotlay oladigan kurs bilan qanday konvertatsiya qilish va nega formatlash faqat eng chekkada bo'lishi kerak.

Nimani o'rganasiz

  • Nega ikkilik suzuvchi nuqta 0.1 yoki 19 990.10 ni aniq saqlay olmaydi va valyutali eng kichik birlikdagi butun sonlar buni qanday hal qiladi (0, 2 va 3 kasr xonali valyutalar)
  • Yaxlitlash usullari: half-up, half-even (bank usuli) va nosimmetrik Math.round, hamda nega qoida bir marta yozib qo'yiladigan biznes qarori
  • Har qatorda yoki butun hisob-fakturada yaxlitlash: QQS'dagi 1 tiyinlik farq va jami summalar chop etilgan qatorlar yig'indisi degan qoida
  • Summani eng katta qoldiq usuli bilan bo'lish, valyutani saqlangan kurs va vaqt bilan konvertatsiya qilish va lokal bo'yicha formatlashni chekkada qilish
Yakuniy sahna

Diagramma kod sifatida

Darsdagi yakuniy sxemani matn ko'rinishida oling va Jira, GitLab, GitHub, Notion yoki hujjatga qo'ying: Mermaid u yerlarda o'zi chiziladi. D2 va PlantUML (Confluence, IntelliJ) uchun alohida variantlar bor.

Mermaid: sxema

flowchart LR
  n_app(["Checkout"])
  n_api["Buyurtma servisi"]
  n_db[("Buyurtmalar bazasi")]
  n_tax>"Hisob-faktura tizimi"]
  n_fx>"Kurs manbai"]
  n_app -->|"chaqiruv"| n_api
  n_api --> n_db
  n_api -->|"asinxron"| n_tax
  n_api -->|"chaqiruv"| n_fx

Mermaid: so'rovlar ketma-ketligi

sequenceDiagram
  participant n_app as Checkout
  participant n_api as Buyurtma servisi
  participant n_db as Buyurtmalar bazasi
  participant n_tax as Hisob-faktura tizimi
  participant n_fx as Kurs manbai
  Note over n_app,n_api: Narxlari oddiy son bo'lgan buyurtma
  n_app->>n_api: POST /v1/orders HTTP/1.1
  n_api-->>n_app: HTTP/1.1 201 Created
  Note over n_app,n_api: To'g'ri to'lov jami summaga mos kelmaydi
  n_app->>n_api: #62; 19990.1 * 3
  Note over n_app,n_api: Eng kichik birlikdagi butun sonlarni saqla
  n_app->>n_api: POST /v1/orders HTTP/1.1
  n_api-->>n_app: currency exponent 1 unit =
  Note over n_api,n_db: Yaxlitlash usullari: aynan yarimda nima bo'ladi
  n_api->>n_db: 1.5% fee on 10 003.00 so'm = 15 004.5 tiyin
  Note over n_api,n_tax: Qatorlar QQS'i jami summaga teng chiqmaydi
  n_api->>n_tax: invoice INV-2026-11-04417 VAT 12%
  n_tax-->>n_api: rejected: total VAT 10 660.71 != sum of line VAT 10 660.72
  Note over n_api,n_tax: Har qatorda bir marta yaxlitla, saqlanganini qo'sh
  n_api->>n_tax: POST /v1/invoices INV-2026-11-04417
  n_tax-->>n_api: accepted INV-2026-11-04417
  Note over n_api,n_db: Uchta to'lov, bitta tiyin yetishmaydi
  n_api->>n_db: installments: 100 000.00 so'm in 3 months = 10 000 000 tiyin / 3
  Note over n_api,n_db: Qoldiqni eng kattasidan boshlab taqsimla
  n_api->>n_db: allocate a 5 000.00 so'm discount (500 000 tiyin) by line net
  Note over n_api,n_fx: Bugungi kurs bilan qaytarish
  n_api->>n_fx: order o_8120 49.99 USD, paid in UZS on 2026-11-09
  Note over n_api,n_db: Kursni, uning manbai va vaqtini konvertatsiya bilan birga saqla
  n_api->>n_db: INSERT INTO conversions (order o_8120)
  n_db-->>n_api: 4999 x 1268743 / 100 = 63 424 462.57 -#62; 63 424 463 tiyin
  Note over n_app,n_api: Faqat chekkada, lokal bo'yicha formatla
  n_app->>n_api: stored: minor 63424463, currency UZS

D2

direction: right

n_app: "Checkout" {
  shape: rectangle
}
n_api: "Buyurtma servisi" {
  shape: rectangle
}
n_db: "Buyurtmalar bazasi" {
  shape: cylinder
}
n_tax: "Hisob-faktura tizimi" {
  shape: cloud
}
n_fx: "Kurs manbai" {
  shape: cloud
}

n_app -> n_api: "chaqiruv"
n_api -> n_db
n_api -> n_tax: "asinxron"
n_api -> n_fx: "chaqiruv"

PlantUML: so'rovlar ketma-ketligi

@startuml
participant "Checkout" as n_app
participant "Buyurtma servisi" as n_api
database "Buyurtmalar bazasi" as n_db
boundary "Hisob-faktura tizimi" as n_tax
boundary "Kurs manbai" as n_fx
note over n_app, n_api : Narxlari oddiy son bo'lgan buyurtma
n_app -> n_api : POST /v1/orders HTTP/1.1
n_api --> n_app : HTTP/1.1 201 Created
note over n_app, n_api : To'g'ri to'lov jami summaga mos kelmaydi
n_app -> n_api : > 19990.1 * 3
note over n_app, n_api : Eng kichik birlikdagi butun sonlarni saqla
n_app -> n_api : POST /v1/orders HTTP/1.1
n_api --> n_app : currency exponent 1 unit =
note over n_api, n_db : Yaxlitlash usullari: aynan yarimda nima bo'ladi
n_api -> n_db : 1.5% fee on 10 003.00 so'm = 15 004.5 tiyin
note over n_api, n_tax : Qatorlar QQS'i jami summaga teng chiqmaydi
n_api ->> n_tax : invoice INV-2026-11-04417 VAT 12%
n_tax -->> n_api : rejected: total VAT 10 660.71 != sum of line VAT 10 660.72
note over n_api, n_tax : Har qatorda bir marta yaxlitla, saqlanganini qo'sh
n_api ->> n_tax : POST /v1/invoices INV-2026-11-04417
n_tax -->> n_api : accepted INV-2026-11-04417
note over n_api, n_db : Uchta to'lov, bitta tiyin yetishmaydi
n_api -> n_db : installments: 100 000.00 so'm in 3 months = 10 000 000 tiyin / 3
note over n_api, n_db : Qoldiqni eng kattasidan boshlab taqsimla
n_api -> n_db : allocate a 5 000.00 so'm discount (500 000 tiyin) by line net
note over n_api, n_fx : Bugungi kurs bilan qaytarish
n_api -> n_fx : order o_8120 49.99 USD, paid in UZS on 2026-11-09
note over n_api, n_db : Kursni, uning manbai va vaqtini konvertatsiya bilan birga saqla
n_api -> n_db : INSERT INTO conversions (order o_8120)
n_db --> n_api : 4999 x 1268743 / 100 = 63 424 462.57 -> 63 424 463 tiyin
note over n_app, n_api : Faqat chekkada, lokal bo'yicha formatla
n_app -> n_api : stored: minor 63424463, currency UZS
@enduml

PlantUML: komponentlar

@startuml
left to right direction
agent "Checkout" as n_app
component "Buyurtma servisi" as n_api
database "Buyurtmalar bazasi" as n_db
cloud "Hisob-faktura tizimi" as n_tax
cloud "Kurs manbai" as n_fx
n_app --> n_api : chaqiruv
n_api --> n_db
n_api --> n_tax : asinxron
n_api --> n_fx : chaqiruv
@enduml

Xulosa

Pul uchun yetti qoida.

1) Hech qachon float emas: eng kichik birlikdagi butun sonlar, doim valyuta bilan. 2) Kasr xonalari valyuta jadvalidan olinadi: 0, 2 yoki 3. 3) Yaxlitlash usulini qoidaga ko'ra tanla va usuli aniq ko'rsatilgan bitta funksiyani ishlat. 4) Bitta belgilangan joyda yaxlitla, yaxlitlangan summalarni saqla va jami summalar saqlangan narsalar yig'indisi bo'lsin. 5) Taqsimlash bilan bo'l, shunda qismlar doim butunga teng. 6) Har bir konvertatsiyani kursi, manbai va vaqti bilan saqla va qaytarishda qayta ishlat. 7) Lokal bo'yicha faqat ilovada formatla.

Ko'rsatkichlar: boshida va oxirida

Ko'rsatkichBoshidaOxirida
Farq, tiyin00
Mos kelmagan hujjatlar0/kun0/kun
Qaytarishdagi kamomad, tiyin00

Qadamlar

  1. Holat Narxlari oddiy son bo'lgan buyurtma

    Checkout buyurtma yuboradi: 19 990.10 so'mlik uch quti choy.

  2. Muammo To'g'ri to'lov jami summaga mos kelmaydi

    Ikkilik suzuvchi nuqtada 19 990.10 eng yaqin ikkilik kasr sifatida saqlanadi, u esa biroz farq qiladi.

  3. Yechim Eng kichik birlikdagi butun sonlarni saqla

    Endi har bir summa eng kichik birlikdagi butun son va valyutadan iborat: UZS'da 1 999 010 tiyin.

  4. Yechim Yaxlitlash usullari: aynan yarimda nima bo'ladi

    Butun sonlar yaxlitlashni yo'q qilmaydi: 10 003.00 so'mdan 1.5% komissiya 15 004.5 tiyin, undirish esa faqat butun tiyinda mumkin.

  5. Muammo Qatorlar QQS'i jami summaga teng chiqmaydi

    Hisob-fakturada uchta qator bor.

  6. Yechim Har qatorda bir marta yaxlitla, saqlanganini qo'sh

    Endi qoida shunday: QQS har bir qatorda, half-up bilan, qator yaratilganda yaxlitlanadi va saqlanadi.

  7. Muammo Uchta to'lov, bitta tiyin yetishmaydi

    Mijoz 100 000.00 so'mni 3 oylik to'lov bilan to'laydi.

  8. Yechim Qoldiqni eng kattasidan boshlab taqsimla

    Taqsimlash (allocation) summani vaznlar bo'yicha qismlar doim butunga teng bo'ladigan qilib bo'ladi.

  9. Muammo Bugungi kurs bilan qaytarish

    Mahsulot narxi 49.99 USD, mijoz esa so'mda to'laydi.

  10. Yechim Kursni, uning manbai va vaqtini konvertatsiya bilan birga saqla

    Endi har bir konvertatsiya yozuv: asl summa, aniq o'nlik kasr ko'rinishidagi kurs, u qayerdan va qachon olingani, konvertatsiya qilingan summa va yaxlitlash usuli.

  11. Yechim Faqat chekkada, lokal bo'yicha formatla

    Baza, API'lar va log'lar eng kichik birlik va valyutani saqlaydi.

  12. Xulosa Xulosa

    Pul uchun yetti qoida.

Atamalar

Suzuvchi nuqta xatosi
Ikkilik double 0.1 kabi o'nlik kasrlarni aniq saqlay olmaydi, shuning uchun 0.1 + 0.2 0.30000000000000004 beradi. Pul uchun butun sonlar yoki decimal turi ishlatiladi.
Yaxlitlash usuli
Aynan yarimdagi qiymat qayerga ketishini belgilaydigan qoida: half-up yarimni noldan uzoqqa, half-even (bank usuli) juft qo'shniga oladi. Qoidani qonun yoki shartnoma belgilaydi.
Eng katta qoldiq usuli
Summani qismlarga bo'lish usuli: har bir qism pastga yaxlitlangan ulushini oladi, ortgan tiyinlar esa bittadan eng katta qoldiqli qismlarga beriladi. Qismlar doim butunga teng.
Saqlangan valyuta kursi
Konvertatsiya bilan birga yozib qo'yiladigan kurs, uning manbai, vaqti va yaxlitlash usuli. Qaytarish va audit shu sonlardan foydalanadi, kursni qaytadan olmaydi.