Skip to main content

Receivables lifecycle

States

StateDescription
DraftCreated but not published yet. Does not show in the totals.
PendingAwaiting receipt.
ReceivedLinked to an inflow transaction.
CancelledVoided, with no financial movement.

Beyond those four, the listing shows two badges that are not states, but derived from them:

  • Overdue — a Pending bill whose due date has passed.
  • Reconciled — the receipt is tied to a transaction from the statement. When it shows, it replaces the "Received" badge: it is the stronger piece of information.

Transitions

  • Publish (Draft → Pending) — the bill starts counting towards the totals.
  • Mark as received (Pending → Received) — records the receipt and generates the inflow transaction.
  • Cancel (Pending → Cancelled) — voids the bill.

Create

  1. Go to /receivables/new.
  2. Fill in the required fields: Amount (R$), Due date, Description, Customer, Accrual month and Type.
  3. Finish with Add bill, Add and create another or Save draft.

The customer is not optional. Without it the form will not submit: "Select or create a customer". You can pick a customer that already exists or type a new name — in that case they get registered along with the bill.

The Company is required too, but it is not a form field: it comes from the header selector.

note

"Publish" does not exist on the create screen. The buttons there are the three above. Publish shows up only on the detail, and only while the bill is a draft. The path is: save draft → open the bill → Publish.

Mark as received

From the listing or the detail, use Mark as received. The Confirm receipt dialog has two tabs:

  • Receive — give the date and the Destination account. The system creates the inflow transaction.
  • Receive & reconcile — ties the bill to a transaction that already exists in the statement, without generating a duplicate.

The dialog also carries Receipt adjustments, all optional: Interest, Discount and Settled amount. The footer shows the nominal amount and how it was worked out.

Undo and reconcile

  • Undo — available on a received bill. It goes back to pending; if the transaction was generated by the receipt, it is deleted along with it.
  • Reconcile — available on a received bill that has not been reconciled yet.

Cancel

Cancel only shows on pending bills — it is not an exit available from every state.

And it is not irreversible: the dialog itself says "You can reopen it later by editing the status." The bill stops showing among the pending ones; linked auto-created transactions are removed, and statement-imported transactions remain — only the link is undone.

note

The action lives on the listing. Open the detail directly and that path is not there.

Edit

A received bill is not read-only. There is no lock by state: the form opens normally and is editable in any status, including Received and Cancelled.

This is a real difference from payables, not an oversight. Over there a lock does exist — a partial one — once the bank confirms the payment. Receivables never go through the dispatch to the bank, so there is nothing to lock.

When you edit a bill that belongs to a group, the system offers to propagate the change to the following installments, showing you beforehand exactly what will change.

Delete

On a bill that belongs to a group — installment or recurring — deleting asks about the scope:

  • Delete only this one
  • Delete this and future ones

The same picker covers both cases: what it looks at is the group, not the type. On a standalone bill it does not appear.

note

The picker lives on the listing. Deleting from the detail always removes just that one bill, with no scope offered.