System logic: consumer, supplier, goods, money

How requests, pre-orders, orders, discounts, payment, receipts, returns and product batch recalls work in the system.

1. Participants and objects

Object	What it is
Consumer	A buying household: a family, an organisation, a shop buying for its own needs.
Supplier	A trading household that sells goods. A producer describes the products that suppliers then sell.
Tonteg	A concept of the system, for example "boiled sausage", with a formula of characteristics. It is the common language of consumers and suppliers.
Producer's product	A specific product: barcode, characteristics, unit conversion factors (pieces, kg, m², m³).
Offer	A product at a specific supplier: price, price rules, delivery terms.
Request	The consumer's list of needs expressed in tontegs.
Order	Everything chosen from one supplier.
Order line	Product, quantity, price, requested and granted discount.
Payment	A money movement on an order: payment (+) or refund (−).
Receipt	Confirmation of payment from the supplier's cash register, with the order lines.
Batch	One delivery or production run of a product: number, date, best-before date.
Return	A document inside an order: goods and/or money moving back.

2. Main path: from a need to a receipt

Consumer

Supplier

RequestNeeds in tontegs. The system finds offers of the suppliers the consumer has accepted.

ChoiceA specific product of a specific supplier.

Pre-order"Issue orders"One pre-order per supplier. A discount request can be added.

NewReceives the pre-orderChecks the lines, the discount request, availability.

If the supplier changes the lines or grants a discount, the order goes back to the consumer as a new version of the pre-order. The consumer agrees and sends it again.

Accepted for workAccepts the orderThe amount to pay becomes final. Payment terms are agreed: prepayment or cash on delivery.

markPaymentWith prepayment: marks "paid" — amount, method, from which account, expense category. With cash on delivery the payment is made on receipt.

markReceiptThe cash register issues a receipt in exchange for the payment; it also reaches the consumer's app.

Being deliveredDispatchDelivery (waybill number) or pick-up. With cash on delivery the parcel comes with a delivery note (pre-receipt).

CompletedReceives the goodsWith cash on delivery: inspects, pays the courier or at the pick-up point, gets the receipt.

markMoney receivedThe supplier confirms the money has arrived; with cash on delivery — once the carrier has transferred it.

An order has three independent lines: state (where the goods are), payment and delivery. Payment and receipt are marks, they do not change the order state. So an order can, for example, be on its way and already paid, or be completed and paid on receipt.

3. Money

The main rule: money moves only through payments, "+" and "−" records attached to the order. At any moment it is clear how much was paid, how much was refunded and what the balance is.

Event	Who	What is recorded
Payment terms	Supplier	When accepting the order for work: prepayment or cash on delivery (payment on receipt).
Payment	Consumer	Amount, method (card, transfer, cash, cash on delivery), from which account, expense category ("household", "business"…).
Confirmation	Supplier	"Money received". For an online card payment the bank does this automatically; for cash on delivery, after the transfer from the carrier.
Receipt	Supplier's cash register	A receipt with the order lines; the receipt number is stored in the order.
Refund	Supplier	A negative payment linked to the return of goods, with a refund receipt.

4. Delivery and cash on delivery

With cash on delivery the consumer pays only after seeing the goods: to the courier or at the carrier's pick-up point, usually with the carrier's fee.

Documents

Delivery note (pre-receipt) comes with the parcel: order lines, amount to pay, order number. It is not yet a receipt — nothing has been paid.
Receipt is issued at the moment of payment: by the courier's cash register (paper and electronic, the electronic one goes to the receipts site) or by the carrier on behalf of the supplier.

What happened	Goods	Money
Received and paid	Order "Completed"	Payment on receipt (+ carrier fee), receipt; the supplier marks "money received" once the carrier has transferred it
Refused on receipt	The parcel goes back to the supplier, order "Returned"	Nothing was paid; who pays for shipping both ways follows the supplier's rules
Partial acceptance	Part taken, the rest goes back	Payment only for what was taken; the rest becomes a return
Prepaid, but refused on receipt	Goes back to the supplier	A normal refund
Parcel lost or destroyed	Order "Lost in delivery"	With cash on delivery the consumer pays nothing. With prepayment the supplier refunds or ships again and settles with the carrier itself (claim up to the declared value)

The declared value of the parcel should equal the order amount — otherwise the supplier loses the difference if the parcel is lost.

5. Returns

A return is a separate document inside the order, not just a mark on the whole order.

Requested→Accepted by supplier / Rejected→Goods received by supplier→Money refunded (refund receipt)

Case	Goods	Money
Full return	All lines in full	The whole amount
Partial return of goods	Some lines or part of a quantity (e.g. 2 of 5 kg)	Proportionally, taking the line discount into account
Partial refund without goods	None (markdown, short weight, a defect not worth sending back)	An agreed amount
Cancellation before payment	—	No money movement, the order is "Canceled"
Cancellation after payment, before hand-over	Stock is not affected	Full refund

6. Product batch recall

For example, a defect is found in a batch of a food product.

Recall announcedProducer or supplier: "Batch No. X of product Y is recalled, reason…"

Search by receiptsThe system finds everyone who bought the product from this batch.

Consumers notified"Do not use it, return it — your money will be refunded."

Removed from saleOffers with this batch are hidden at all suppliers.

Automatic returnA return with the reason "Batch recall" is created for every affected order.

For a precise recall the batch number is stored in the receipt line. Without it only the whole product could be recalled from everyone.

7. Notifications

At registration, and later in the profile, the consumer chooses how to receive notifications: e-mail, SMS, Telegram or the mobile app (Android, iOS). Signing in stays by phone number. Passwords, order changes, receipts, returns and batch recalls come through the chosen channel.

8. Natural next additions

Best-before date in the batch: a warning for the supplier, a mark in the consumer's app.
Review of a product and a supplier after the order is completed: rating, text, photos.
Complaint without a return (short weight, wrong packaging) with correspondence attached to the order.
Repeat order from the archive with one button.
Partial delivery: the supplier ships what is available, the rest becomes a separate order.