Settlement Reports¶
Who this is for
Accounting and finance. You'll use this to reconcile what Reyder owes Axis Mobile after each consignment sale and to close out the books.
What you'll accomplish: verify each settlement report, match it to its auto-generated vendor bill, and mark it paid once the payment to Axis clears.
Before you start: reports are generated automatically when a delivery ships or a retail sale confirms. You don't create them manually.
What a settlement report is¶
A settlement report is the accounting document that says "here are the devices we sold on Axis's behalf, here's the commission Reyder kept, here's the amount Axis is owed."
Every consignment sale produces two paired reports:
| Report type | Who it belongs to | What it shows |
|---|---|---|
Owner report (SETTLE/OWN/...) |
Axis Mobile | IMEI, model, grade, owner amount, and owner-payment totals. No customer, sale price, sale date, order number, or consignee commission. |
Consignee report (SETTLE/CON/...) |
Reyder Enterprises | Internal sale facts — IMEI, model, grade, sale price, customer, sale date, commission, owner amount, link to the vendor bill, and SO number when the sale used an SO. A retail sale has no SO number. |
This asymmetry is deliberate. Axis is the inventory owner, not the customer-facing seller. The owner report lets Axis reconcile the amount owed for its devices without exposing Reyder's customer, order, sale-date, or retail-price details; those stay on the consignee report.
For a retail sale, Customer is the Retail Partner and Sale Date is the date saved on the retail-sale header. Confirming it later does not replace that business date. These two facts are saved only on the consignee report; the owner report remains data-minimal.
What each side actually sees¶
Full picture — every field filled in, plus a link to the auto-generated vendor bill payable to Axis.
Same device, but the customer, order number, sale date, sale price, and per-device commission are not in the owner report line at all — not hidden, not stored. There's nothing for an Axis user to reveal even if they found a way to bypass the UI.
Compare what's on each report:
| Field | Owner sees | Consignee sees |
|---|---|---|
| IMEI | ✅ | ✅ |
| Model / Storage / Grade | ✅ | ✅ |
| Sale date | — | ✅ |
| Per-device commission | — | ✅ |
| Total commission | — | ✅ |
| Owner amount | ✅ | ✅ |
| Sale price | — | ✅ |
| Customer name | — | ✅ |
| Sale order number | — | ✅ |
| Vendor bill link | — | ✅ |
Step 1 — Open the settlement reports list¶
Go to Device Ops → Consignment → Settlement Reports.
The list is company-scoped. An Axis-only user sees only SETTLE/OWN/*; a Reyder-only
user sees only SETTLE/CON/*. Only an explicitly authorized dual-company administrator
can see both sides.
For daily reconciliation, open Settlement Reports and apply the Pending Payment filter. The separate Pending Settlements menu is a device backlog, not a report list.
Step 2 — Verify the report and its vendor bill¶
Open a consignee report. You'll see four sections:
- Report Details — type, agreement, SO, generation date
- Companies — owner and consignee
- Financial Summary — total devices, total sale price, total commission, total owner amount
- Payment — vendor bill reference and payment date (blank until paid)
Open the vendor bill¶
On a normal consignee report, click Vendor Bill at the top. This opens the auto-generated bill payable to Axis Mobile. Its amount should match Total Owner Amount.
The bill was auto-posted at the moment the settlement report was created — so in normal operation you don't need to post it manually. Your job is to verify:
- Amount matches the report.
- Partner is the correct Axis Mobile vendor contact.
- Journal is your configured settlement journal (or a purchase journal fallback).
If anything looks wrong, don't modify the bill in place — raise it with whoever owns the device settlement flow. The bill and the report are linked via vendor_bill_id; unlinking them by hand breaks the paired-report accounting.
Confirmed but no Vendor Bill button
If neither the configured Settlement Journal nor a fallback Purchase journal was available, Odoo can leave the report Confirmed and post a warning without creating a bill. Do not pay or mark the report paid. Accounting must configure the journal and follow the approved recovery process; operators must not manufacture an unlinked bill.
Understand the paired report¶
Odoo creates the Axis owner report and Reyder consignee report together and keeps their status synchronized. A normal Reyder-only accounting user does not open the Axis-side record. If an authorized dual-company administrator is performing a controlled review, the Paired Report button can be used to compare the two sides.
Step 3 — Mark the report as paid¶
Once you've actually paid Axis (bank transfer, check, etc.) and the vendor bill is fully paid/reconciled in Odoo, come back to the consignee settlement report and click Mark as Paid. Owner reports are view-only for payment status.
The button validates the vendor bill before changing state. If the linked bill is missing or its payment_state is not paid, Odoo blocks the action and tells you the current bill payment status. Do the accounting reconciliation first, then return to the report.
That:
- Moves the report state from
ConfirmedtoPaid. - Records today as the payment date.
- Updates the same fields on the paired owner report.
- Updates each referenced device's
settlement_statustosettled, which closes the accounting loop on that specific IMEI.
Report states¶
- Draft — reports are almost never in this state. They're auto-confirmed at creation.
- Confirmed — the report exists and is waiting for payment. Normally the vendor bill is created and posted; the missing-journal exception above can leave it Confirmed with no bill.
- Paid — you marked it paid; devices are flagged as settled.
Report totals¶
| Field | What it means |
|---|---|
| Total Devices | Count of device lines on this report |
| Total Sale Price | Sum of sale prices across all devices; shown only on consignee reports and not stored on owner-report lines |
| Total Commission | Sum of Reyder's commission across all devices; consignee report only |
| Total Owner Amount | Sum of what's owed to Axis — sale price − commission |
Download a PDF statement¶
Click Download PDF on the report form. You get a formatted PDF appropriate to the report type:
- Owner PDF — IMEI, model, storage, grade, owner amount. Nothing else.
- Consignee PDF — everything on the form, with the full sale detail.
An Axis-authorized user can download the owner PDF for Axis records. Reyder accounting uses the consignee PDF internally. A dual-company administrator may export either during an authorized cross-company review.
Common problems¶
The vendor bill doesn't match the report total
The report is computed from the device records captured at creation time. If the posted bill diverges, stop payment. Compare its lines against the report's Device tab IMEI-by-IMEI, preserve both references, and have Accounting use the approved reversal/reissue process. Do not edit the report or directly rewrite a posted bill.
I can't see the consignee report — only the owner version
You're working in an Axis-only profile. Axis users see owner reports by design. Do not borrow or switch to another user's account; ask an administrator to confirm your assigned company and role.
A device shows up in the wrong settlement report
Each device is settled exactly once. If a device is appearing in a new report even though it was settled previously, check its settlement_status — it should read settled after the paired report was marked paid. If the status is wrong, the paired report for that device wasn't marked paid properly; find the earlier report and mark it.
No settlement report was created after a delivery
Settlement reports only generate for consignment devices — i.e. devices where the owner company differs from the selling company. If the device was owned by Reyder (not Axis), no settlement is needed. Check the device's owner_company_id.
The 'Mark as Paid' button is missing
The button appears only on confirmed consignee reports. It is hidden on owner reports by design, and it disappears once the report is already Paid. If it appears but raises an error, open the linked vendor bill and make sure it is paid/reconciled first.
Where to look for settlements in-app¶
| You want to see… | Go to |
|---|---|
| Every settlement report ever | Device Ops → Consignment → Settlement Reports |
| Only reports awaiting payment | Settlement Reports → filter Pending Payment |
| Devices still flagged for settlement investigation | Pending Settlements or My Pending Settlements; this is a device list, not proof of payment |
The Settlement Wizard is a controlled legacy/recovery tool, not the normal accounting path. It does not replace the settlement report → vendor bill → paid reconciliation chain. Do not use it for routine payments.