Progress payments (hakediş) and site budget in one place

How is a progress payment calculated?

Santix calculates the hakediş (Turkish progress payment) cumulatively: this period's gross is total work to date minus the sum of earlier payments. Retention, advance recovery and other deductions come off, withholding and stamp duty are calculated on the VAT-exclusive amount, VAT is added and VAT withholding is removed. This is the worked example from the app's own tests.

How do you enter a progress payment?

A progress payment is a payment record tied to a subcontract. Pick the contract and Santix finds the retention rate, the advance and the earlier payments on that contract; the one big number you type is cumulative work to date.

1. In "Bütçe", open payments and create a new one of type "Hakediş".
2. Choose the company and contract. The title is suggested as "No. 3 progress payment" from the earlier ones.
3. Enter cumulative work to date, VAT excluded. Previous payments come from the contract's earlier payments that were not rejected or cancelled.
4. Advance recovery is suggested pro rata; change it if your contract says otherwise. Add a penalty or quality deduction as its own line.
5. Switch withholding, stamp duty and VAT withholding on or off; the breakdown updates live.
6. Add the invoice number and due date and send it for approval.

If an earlier payment is rejected or cancelled, the next period's previous total corrects itself instead of carrying the error forward.

How is the advance recovered?

Pro rata to progress: if this period is one twelfth of the contract value, one twelfth of the advance is recovered, never more than what remains. On the sample project, Ataşehir Blok B, a ₺1.200.000 tiling labour contract with a 10 % advance (₺120.000) recovers ₺120.000 × 100.000 / 1.200.000 = ₺10.000 from a ₺100.000 period, which is the line in the table above.

Which deductions are supported?

Retention, advance recovery, income tax withholding, stamp duty and VAT withholding, plus free deduction lines you add yourself for delay penalties, quality deductions (nefaset) or owner-supplied material. Each sits on its own line. Rates come from the contract; see contract templates, the hakediş guide and the quantity takeoff guide.

How is the budget built?

Each budget line holds an item code (poz), category, description, unit, quantity, unit price, planned amount, currency and optionally a company. Import your estimate or add lines one by one.

1. Tap "Excel'den al" and pick an .xlsx, .xls or CSV file.
2. Choose the sheet. Santix finds the header row in the first 30 rows; move it up or down if needed.
3. Check the column mapping (code, category, description, unit, quantity, unit price, amount). Online, the mapping is suggested by AI; offline, it is guessed from header names. You confirm either way.
4. Read the preview; Turkish-formatted numbers such as "1.234,56" parse correctly. Import.
5. Link lines to companies. A bid chosen in bid comparison can open a new line, or update an existing line's planned amount and company.

What does the budget screen show?

Below sit a planned-versus-actual chart, totals by category and a "who was paid what" list per company. Payments without a budget line are totalled separately so nothing falls outside the summary. "Excel'e aktar" exports lines and payments with summable amounts.

How does approval work?

Payments move through draft, awaiting approval, approved and paid, or rejected and cancelled. The site manager approves every payment or rejects it with a reason. When the amount in TL exceeds the organisation's owner approval threshold (₺500.000 by default), the owner must approve too. Each payment keeps an approval history.

Foreign currency

TL, USD and EUR are supported, with Central Bank of Türkiye (TCMB) rates fetched every working day. The rate and its date are stored on each payment, so past payments keep their TL value. If a rate has not reached the device while offline, the screen says so and leaves those lines out of the totals instead of guessing.

Who can see the budget?

By default only the owner, project manager and site manager. In the organisation's budget access settings you grant none, summary or full access per role or per person; summary users see totals only. The restriction is enforced in the database itself. See the company owner role.

What the budget module does not do

• It is not accounting software: no ledger entries, e-invoices or bank integration.
• No price escalation (index) calculation; enter any escalation as its own line.
• It does not take off quantities for you; you enter the cumulative work value.
• It does not read invoices from photos into payments; store invoices and delivery notes under documents.

Why not an Excel hakediş file?

In Excel each period usually starts as a copy of the last file, so a wrong carried-forward total spreads into every later payment. Santix recalculates the period from the cumulative total each time, suggests the advance recovery, keeps each deduction on its own line and records who approved it. The full comparison is on Santix instead of Excel and WhatsApp.