Handover and warranty claims
On this page
- How handover and warranty work
- The Handovers page of a project
- The handover of a deal
- How to propose a handover appointment
- How to change or cancel an appointment
- How to record the handover protocol
- Snags
- Warranty claims
- How to review a warranty claim
- How to assign, work on and resolve a claim
- Warranty categories and periods
- Common questions
- Related
| Where | Handovers of a project: project → Sales (Продажби) → After the sale (След продажбата) → Handovers (Предаване), URL /projects/{project}/sales/handovers. The handover of one deal: the deal card → section After the sale (След продажбата) → Handover (Предаване), URL /projects/{project}/sales/deals/{deal}?tab=handover, or the handover-only page /projects/{project}/sales/handovers/{deal}. Warranty claims: company → Sales (Продажби) → After the sale (След продажбата) → Warranty claims (Гаранционни сигнали), URL /companies/{company}/sales/warranty-claims. Warranty categories: company Sales → ⚙ Settings (Настройки) → tab Warranty (Гаранции). |
|---|---|
| Who can | Company permission Property sales: handover and warranty (Продажби на имоти: предаване и гаранции): View (Преглед) to see the handover of every sale of the project (the Handovers page, without the client) and every warranty claim, Edit (Редакция) to propose appointments, record protocols, work on snags and handle claims. This permission alone is enough: the project's Sales row in the sidebar then opens on Handovers. By default the roles Company owner, Manager, Project supervisor and Technical supervisor have it at Edit. Property sales (Продажби на имоти) at View also shows the handovers and the warranty claims of the deals you can see; Property sales: management (Продажби на имоти: управление) at View also shows every warranty claim. The categories are edited with Property sales: setup (Продажби на имоти: настройка). Only on a project where Property sales is activated. |
| Related | Deals: creating, contract and signing, Properties: board, property card and price lists, Sales settings, legal entities and permissions, Task boards |
How handover and warranty work
The handover follows the signed contract. A property can only be handed over once its technical readiness is Ready for handover (Готов за предаване); that readiness is set on the property in the Properties section. The typical path:
- Check readiness. The deal's Handover block shows whether the deal is active and every property is ready.
- Propose a time. You propose an appointment; every person with client-portal access to the deal and the Handover right gets an e-mail and confirms or asks for another time in the portal.
- Record the protocol. After the meeting you record the handover protocol with the date, the properties, the keys, meter readings and documents handed over, and whether there were remarks. The properties become Done or Done with remarks. Then you upload the protocol signed by both parties.
- Record and close the snags. Each remark is a snag on one property. Someone marks it fixed; a different person verifies it (four eyes). When every snag of a property is verified or void, its handover status becomes Remarks closed.
- Handle warranty claims. Later, a buyer reports a defect of a handed-over property in the portal. Your team reviews it, accepts or rejects it, assigns it, works on it and marks it resolved; the buyer confirms the resolution.
How buyers get portal access and rights is described in The buyer portal.
The Handovers page of a project
Open the project, then Sales (Продажби) → After the sale (След продажбата) → Handovers (Предаване). The page lists the sold properties of the project (a deal with a signed contract, or one whose handover has started) by where their handover is. With Property sales: handover and warranty you see every sale of the project; with Property sales only, the sales of the deals you can see. The switch above the table has five groups, each with its count:
| Group (EN / BG) | Which properties |
|---|---|
| Ready to schedule / Готови за насрочване | Sold, not yet scheduled, and the property's readiness is Ready for handover. |
| Scheduled / Насрочени | The buyer confirmed an appointment. |
| With remarks / Със забележки | Handed over with remarks that are still open. |
| Under construction / В строеж | Sold, not scheduled, and the property is not yet ready for handover. |
| Done / Приключени | Handed over without remarks, or with every remark closed. |
The page opens on the first group that has properties. The columns are Properties (Имоти), Client (Клиент), Readiness (Готовност), Payment (Плащане: No payment, Partial, Paid in full, Overpaid) and Handover (Предаване). On a deal you cannot see, the client shows as Hidden client (Скрит клиент) and the payment is empty. Click a row to open the deal's handover. If you can see the deal, it opens the deal card on its After the sale section; otherwise it opens the handover-only page of that sale, which shows the meetings, protocols and remarks but not the client, the contract or the money.
The handover of a deal
On the deal card, open the section After the sale (След продажбата). Its Handover (Предаване) block is shown for an active or completed deal. It has four parts.
Ready for handover?
The card Ready for handover? (Готово ли е за предаване?) shows Ready (Готово) or Not ready (Не е готово) and two checks: The deal is active (Сделката е активна) and The properties are ready for handover (Имотите са готови за предаване), which lists the properties that are not ready yet. Below, a table shows each property with its Technical readiness (Техническа готовност) and its Handover status with the scheduled or handover date.
| Handover status (EN / BG) | Meaning |
|---|---|
| Not scheduled / Ненасрочено | No confirmed appointment yet. Cancelling a confirmed appointment returns the property here. |
| Scheduled / Насрочено | The buyer confirmed an appointment in the portal; the date is its day. |
| Done / Извършено | A protocol without remarks was recorded; the date is the protocol's date. |
| Done with remarks / Със забележки | A protocol with remarks was recorded; snags are still open. |
| Remarks closed / Забележките са приключени | Every snag of the property is verified or void. Reopening a snag sets the status back to Done with remarks. |
The board, the property card and the Handovers list show the same statuses with the same labels.
Appointments
The card Appointments (Срещи за предаване) lists every proposed time, newest first, with its properties, place, note, the buyer's note ("Buyer: …") and status.
| Appointment status (EN / BG) | Meaning and next step |
|---|---|
| Proposed / Предложена | Waiting for the buyer. You can Change or Cancel the appointment, or record the protocol. |
| Confirmed by the buyer / Потвърдена от купувача | The buyer accepted the time; the properties are Scheduled. You can record the protocol or cancel. |
| Buyer asks for another time / Купувачът иска друг час | The buyer's note says what suits them. Use Change to propose a new time. |
| Held / Проведена | A protocol was recorded from this appointment. |
| Cancelled / Отказана | Cancelled by staff, with the reason shown. |
How to propose a handover appointment
- Open the deal card, section After the sale, block Handover.
- In Appointments, click Propose a time (Предложи час).
- Fill in From (От) and To (До), date and time. The end must be after the start ("The end must be after the start").
- Optionally fill in Place (Място, up to 300 characters) and a Note to the buyer (Бележка към купувача, up to 2,000 characters). The buyer sees both.
- Under Properties (Имоти), tick the properties this appointment hands over. All of them are ticked at first; at least one is needed.
- If the deal is not ready (a property is not Ready for handover), a warning says that proposing anyway needs a reason. Fill in Reason for the exception (Причина за изключението). It is recorded with the appointment and in the audit trail.
- Click Propose to the buyer (Предложи на купувача).
The appointment appears as Proposed. Every person with portal access to the deal and the Handover right receives an e-mail and confirms or asks for another time in the client portal. When the buyer answers, everyone with Property sales: handover and warranty at Edit gets a notification: "Handover for deal {number}: the buyer confirmed the date" or "…: the buyer asked for another date".
How to change or cancel an appointment
Change (Промени) is offered on a Proposed appointment and on one where the buyer asked for another time. Change the time, place or note and click Save changes (Запази промените). A new time sets the appointment back to Proposed, clears the buyer's note and e-mails the buyers again. Changing only the place or note sends no e-mail.
Cancel the appointment (Откажи срещата) is offered on Proposed, Confirmed and "another time" appointments. Type the reason and confirm. The appointment becomes Cancelled and a property that was Scheduled returns to Not scheduled. Everyone with portal access to the deal and the Handover right gets a generic e-mail about the update and sees the cancelled appointment in the portal.
How to record the handover protocol
- In Appointments, click Record the protocol (Запиши протокол) on the appointment that took place. You can also use Record the protocol in the Handover protocols card without an appointment.
- Held on (Дата на предаване): the day of the handover. It starts on the appointment's day (or today) and cannot be after today: "The protocol records a handover that took place — the date cannot be after today."
- Under Properties, tick the properties handed over (at least one).
- Tick Handed over with remarks (snags are recorded below) (Предаден със забележки) if the buyer noted defects.
- Under Keys, meter readings, documents (Ключове, показания, документи), add one row per item: Type (Вид: Key, Meter reading, Document, Other), What (Какво, required for the row to be saved), Value / count (Стойност / брой) and Unit (Мярка). Add a row (Добави ред) adds one, Remove (Премахни) deletes one. Up to 100 rows.
- Click Save the protocol (Запази протокола).
The protocol appears as "Protocol of {date}" with With remarks or Without remarks. The ticked properties become Done (or Done with remarks) with the protocol's date, and the appointment, if any, becomes Held.
Upload the signed protocol
On the protocol, click Upload the signed protocol (Качи подписания протокол) and pick the file signed by both parties: a PDF or an image (JPEG, PNG or WebP), up to 25 MB. The file is added to the deal's documents as a Handover protocol (Протокол за предаване). If you may publish documents of this deal and the client portal is on for the project, the buyer sees it in the portal straight away and the protocol shows In the portal (В портала). Otherwise it waits in the deal's Documents until someone who may publish it does.
Snags
A snag (забележка) is one defect noted at the handover, on one property. Staff record snags; buyers do not. The card Snags (Забележки) lists every snag of the deal with the property and location, its status, the description, the due date, the responsible company, who fixed it and who verified it, "Has a task on a board" when it has one, the internal note and the photos.
How to add a snag
- In Snags, click Add a snag (Добави забележка).
- Choose the Property (Имот) and, if it belongs to one, the Protocol (Протокол). The only protocol, or the only one with remarks, is pre-selected.
- Fill in the Description (Описание, required) and optionally the Location (Местоположение), the Due date (Срок) and the Responsible company (Отговорна фирма).
- Optionally write an Internal note (Вътрешна бележка). "Only staff see it — never the buyer."
- Click Save the snag (Запази забележката). It starts as Open.
To add a photo, click Add photo (Добави снимка) on the snag: JPEG, PNG or WebP, up to 12 MB, up to 20 photos per snag. Large phone photos are reduced before the upload. A void or verified snag takes no photos.
Snag statuses
| Status (EN / BG) | Meaning | Actions offered |
|---|---|---|
| Open / Отворена | Recorded, not being fixed yet. | Start (Започни), Mark fixed (Отбележи отстранена), Void (Анулирай) |
| In progress / В процес | Being fixed. | Mark fixed, Void |
| Fixed — awaiting check / Отстранена — чака проверка | Someone marked it fixed; a second person checks it. | Verify (Провери и затвори), Reopen (Отвори отново) |
| Verified / Проверена | Checked and closed. | Reopen |
| Void / Анулирана | Recorded by mistake or not a defect; the reason is kept. | None |
Reopen and Void ask for a reason. Reopening clears who fixed and who verified the snag.
How to create a task for a snag
On an open, in-progress or fixed snag, click Create a task (Създай задача), choose the Board (Табло) of the project and confirm. The task is named after the property and the snag, carries the location, description, responsible company and due date, and "carries no personal data of the buyer". Its status is not linked to the snag: update the snag yourself when the task is done. A snag gets one task at most.
Warranty claims
A warranty claim (гаранционен сигнал) is a defect a buyer reports in the client portal after the handover. The buyer can report only for a property already handed over, and needs the Warranty claims right on their portal access. The buyer gives a title, a description, optionally the location and a category, and up to 10 photos (JPEG, PNG or WebP, up to 12 MB each; location data is removed from the photos). Each claim gets a number such as GS-…; everyone with Property sales: handover and warranty at Edit gets the notification "New warranty claim {number}".
The Warranty claims list
Open company Sales → After the sale → Warranty claims. The list covers every project of the company: every claim with Property sales: handover and warranty or Property sales: management at View, the claims of the deals you can see with Property sales only. Filter by Status (Статус, default All statuses) and Project (Проект, default All projects). The columns are No. (Номер), Project, Property (Имот), Claim (Сигнал, with a Warranty period expired badge when it applies), Status and Submitted (Подаден). Click a row to open the claim.
The claim card
The page "Warranty claim {number}" shows the status, project, deal (a link to the deal's handover), property, category, location, submission time, responsible company, due date and, once resolved, the resolution time; then the buyer's description, the rejection reason if rejected, and the photos (click one to open it full size). Below are two separate threads:
- Conversation with the buyer (Разговор с купувача): "Everything here is visible to the buyer in the client portal." Type a Message to the buyer and click Send to the buyer (Изпрати на купувача). The buyer gets a generic e-mail. When the buyer writes, you get "New message on warranty claim {number}".
- Internal notes (Вътрешни бележки): "Only staff see these notes — never the buyer." Type an Internal note and click Save the note (Запази бележката).
Both threads take new entries until the claim is Closed, Withdrawn or Rejected.
Claim statuses
| Status (EN / BG) | Meaning | Next step |
|---|---|---|
| Submitted / Подаден | New from the buyer. | Review (Прегледай): accept or reject. |
| Accepted / Приет | Covered; waiting for work. | Assign, Start work, Create a task. |
| Rejected / Отказан | Not covered; the buyer reads the reason. | None. |
| In progress / В процес | Being fixed. | Assign, Mark resolved, Create a task. |
| Resolved — awaiting the buyer / Отстранен — чака купувача | Your team says it is fixed. | The buyer confirms in the portal; the claim closes. Unconfirmed, it closes by itself after 14 days. |
| Closed / Затворен | Confirmed by the buyer who reported it, or closed after 14 days. | None. |
| Withdrawn / Оттеглен | The buyer who reported it withdrew it (possible while Submitted or Accepted). A co-buyer sees the claim and can write in it, but only the person who reported it can withdraw it or confirm the fix. | None. |
How to review a warranty claim
- Open the claim and click Review (Прегледай).
- Choose Accept (Приеми) or Reject (Откажи).
- If the company has warranty categories, choose or correct the Category (Категория). Each option shows its warranty period in months.
- For a rejection, write the Reason (the buyer sees it): "Explain plainly why the claim is not covered." It is required. For an acceptance the field is an optional Note, saved as an internal note that the buyer does not see.
- Click Save the decision (Запази решението).
The buyers of the deal who may follow claims get a generic e-mail about the update.
How to assign, work on and resolve a claim
- Assign (Възложи): set the Responsible company and the Due date, then Save changes. Both are internal; the buyer does not see them.
- Create a task (Създай задача): on an Accepted or In progress claim, choose a Board of the claim's project. The task is named "Гаранционен сигнал {number} — {property}" and carries the title, description, location, responsible company and due date, without the buyer's personal data. Its status is kept in sync by hand.
- Start work (Започни работа) on an Accepted claim: "The claim moves to «In progress»; the buyer sees the new status."
- Mark resolved (Отбележи отстранен) on a claim In progress: "The buyer is asked to confirm the resolution in the portal; then the claim closes."
Start work and Mark resolved ask for an optional Message to the buyer. The buyer sees it in the portal conversation; for staff-only text, use an internal note. Each step e-mails the buyers a generic update.
Warranty categories and periods
The categories are the list buyers choose from when they report a defect, each with an optional warranty period set by your lawyer. Open company Sales → ⚙ Settings → tab Warranty (Гаранции), card Warranty claim categories (Категории гаранционни сигнали). With no categories, "the buyers report without one".
- Click Add a category (Добави категория).
- Fill in Category (Категория, required, up to 120 characters), optionally Category (English, optional) for buyers using the portal in English, and Warranty period (months): a whole number from 1 to 600, or empty for no period.
- Set New version valid from (today or earlier), optionally a note, and click Save as a new version.
The categories are versioned like the other sales policies: a saved version is never edited, the card shows the active version with its start date and who approved it, and the history lists the earlier versions. Remove takes a category out of the next version; a claim that already has that category then shows its stored key instead of the name. Editing needs Property sales: setup at Edit; users with Property sales: management at View see the tab read-only. On a phone the settings are read-only.
Common questions
Why can't I propose a handover time?
Propose a time needs Property sales: handover and warranty at Edit, and the deal must be active or completed. If a property is not Ready for handover, you can still propose, but only with a Reason for the exception. If a property is already in an open proposal, change or cancel that one.
The buyer asked for another time. What do I do?
The appointment shows Buyer asks for another time and the buyer's note. Click Change, set the new time and save. The appointment goes back to Proposed and the buyer is e-mailed again.
Why is Verify disabled on a snag?
You marked the snag fixed yourself. The rule "Somebody other than the person who marked it fixed must verify it" makes a second person check every fix. Ask a colleague with Edit to verify it.
When does a property's handover show Remarks closed?
When every snag recorded on that property is Verified or Void. Reopening any of its snags sets it back to Done with remarks.
Can I correct a protocol saved with the wrong date or properties?
No. The screen cannot edit or delete a protocol, and the buyer already sees it in the portal. Check the protocol before you save it.
Does an expired warranty period reject the claim?
No. The claim shows a warning with the date the period ended; "This is a warning only — the claim is not rejected automatically." You accept or reject it yourself.
Can the buyer see my internal notes or the responsible company?
No. Internal notes, the responsible company, the due date of a claim and the board task stay with staff. Only the Conversation with the buyer, the status, the rejection reason and the messages you add to Start work or Mark resolved reach the buyer.
The buyer never confirmed the resolution. What happens?
A claim in Resolved — awaiting the buyer closes by itself 14 days after it was marked resolved.
Can staff enter a warranty claim for a buyer?
No. Warranty claims come from buyers in the client portal. If a buyer calls you, ask them to report it in the portal, or record the defect as a snag on the deal's handover.