Skip to content
P4 Software P4 Software / cifraHQ

Add these docs to Claude

Ask Claude questions about these docs. Claude reads the published pages and links you back to them. Copy this address:

https://p4-software.opendocs.page/mcp

In claude.ai or Claude Desktop: open Settings, then Connectors, choose Add custom connector and paste the address.

In Claude Code, run:

claude mcp add --transport http docs https://p4-software.opendocs.page/mcp

Invoices

Invoices

A customer invoice is how you turn a completed sale into a receivable — it tells CifraHQ that money is owed, increases your accounts receivable balance, and updates the customer's outstanding balance immediately on posting. Whether you generate it from a delivery, directly from a sales order, or enter it manually, the result is the same: a tracked, dated obligation that CifraHQ follows until it's paid.

Invoices list page in CifraHQ.

Invoices list, every customer invoice you have issued.

How to create an Invoice

From an Inventory Delivery (recommended):

  1. Open the posted Inventory Delivery.
  2. Click Generate Invoice — CifraHQ creates an invoice with all lines, amounts, customer, and terms pre-filled.
  3. Review the invoice and post it.

From a Sales Order:

  1. Open a confirmed Sales Order.
  2. Click Invoice — CifraHQ creates an invoice directly from the order lines.
  3. Review and post.

Manually:

  1. Go to Sales > Invoices.
  2. Click the + Data Entry button and select New.
  3. Select the Customer and set the Posting Date (defaults to today).
  4. Add lines using Add SO Line, Add Delivery Line, or manually.

Adding many Products? Tick several Products in the Add Line window and add them in one step. See Adding Several Products at Once. 5. CifraHQ assigns an invoice number automatically on save.

Field reference

  • Customer — locked after creation.
  • Posting Date — the date the invoice is recorded in your accounts receivable. Use the actual billing date to keep your periods accurate.
  • Due Date — calculated automatically from your Payment Terms; override it if the customer has negotiated a specific due date that differs from the calculated one.
  • Payment Terms / Freight Terms — default from the customer's settings; editable before posting.
  • Reference Number — optional internal reference for cross-linking to your sales order or delivery.
  • Electronic Submission Number — populated automatically when the invoice is submitted to the Panama electronic invoicing system (ETAX), if enabled for your account.

Document lifecycle

State Meaning
Draft Editable; no accounts receivable impact yet
Posted AR balance increased; customer balance updated
Partially Paid Some payments have been applied
Paid Fully paid; outstanding amount ≤ 0.01
Voided Cancelled after posting; Accounting reversal created
Archived Closed and read-only

Salesperson on a posted invoice

A posted invoice always shows its Sales Person: the invoice's own salesperson or, when it has none, the salesperson of the sales order it came from (shown with the order number). That is the person who earns the commission.

When nobody is credited (no salesperson on the invoice or its sales order), an administrator can add one: choose the person and click Add. An administrator can also add an Additional Sales Person with their share in percent while that field is empty. Once added, neither can be changed.

The invoice list shows both people right after the Customer column: Sales Person and Additional Sales Person. You can sort, filter and search by them, and they are included when you export the list.

Taking back commission on a fully credited invoice

An invoice that credit notes credit in full earns no commission. When commission is paid as invoices are paid, an invoice can still collect commission if it was credited first and then paid with the credit that credit note created. To fix that, an administrator opens the invoice and chooses Actions > Take back commission.

CifraHQ first shows how much each salesperson would give back, and nothing changes until you confirm. Once confirmed, the amount comes off each salesperson's commission balance, and a journal entry dated today takes it out of commission expense and commission payable.

CifraHQ refuses when the invoice is not fully credited or holds no commission.

Bringing commission up to date after switching to "Invoice Posted"

When a company switches Commission Calculation from Invoice Paid to Invoice Posted, the invoices posted before the switch are short: unpaid ones never earned commission, and their payments no longer earn any. To fix that, an administrator selects the posted invoices on the Invoices list and chooses More > Bring commission up to date.

For each invoice, CifraHQ works out what posting would have earned: the rule's rate on each salesperson's share of each line, on the part of the line no credit note credits. It then adds only what is missing. An invoice credited in full gives back what it still holds, exactly as Take back commission does.

  • CifraHQ first shows what each salesperson would get and give back, and nothing changes until you confirm.
  • Added commission is dated on each invoice's posting date, so each month's commission report shows what that month's invoices earned. A journal entry on the same date debits commission expense and credits commission payable.
  • A later credit note takes its share of the added commission back, like any other commission.
  • A partly credited invoice that holds more than it is due is listed in the confirmation and left as it is.
  • Running it again on the same invoices changes nothing.
  • It only runs when Commission Calculation is Invoice Posted. With Invoice Paid, each payment already earns its share.
  • An invoice with a return still pending can stay unselected until the return is credited.

Profitability (administrators)

On a posted invoice, administrators see a Profitability section under the summary:

Row Meaning
Cost of Goods The cost the deliveries behind this invoice posted to your books. Units billed but not shipped yet are estimated at the product's current cost and marked Estimated.
Profit Revenue before tax minus cost of goods.
Margin Profit as a percentage of revenue before tax.
Markup Profit as a percentage of cost of goods.

The note under the figures names the deliveries whose cost is included. Because the cost comes from the deliveries, profitability stays right even when a kit is billed as a single invoice line. When one delivery is billed on several invoices, each invoice carries the cost of its own lines, and cost that no line claims is shared by revenue.

Expand any invoice line to see its units, unit price, revenue, unit cost, cost, absolute profit, margin, markup, and its Cost Basis: Posted (from a delivery), Estimated (not shipped yet), Posted and estimated (partly shipped), or Product cost (services). The lines add up to the section totals.

What happens next

After posting, use the Pay button to record an Invoice Payment when the customer's money arrives. If the customer has a credit on account — from a pre-payment or credit note — choose Apply Credit to consume it instead of recording a new bank receipt.

To reverse a posted invoice (for example, if it was raised in error), click Void. CifraHQ creates a reversal journal entry and moves the invoice to Voided state, preserving the Audit Trail.

Voiding also takes back the invoice's commission. Each salesperson's commission on the invoice comes off their balance (an Invoice voided line in their commission ledger). Any commission still in the books for the invoice, beyond what its own reversal undoes, is taken out of commission payable and commission expense with an entry dated the day of the void.

An invoice approved by the DGI is never voided

Once the DGI has approved an electronic invoice, it can no longer be voided, whether it is posted or still a draft. The same applies while the DGI has not answered yet. To cancel what the customer owes, make a Return and a Credit Note against the invoice.

An invoice with a credit note or return is not voided

An invoice cannot be voided while a credit note or return stands against it. Void or delete the credit note first, and delete a return that is still a draft. If goods came back, cancel the debt with a credit note instead.

A posted document in a period that is not open is not voided

Invoices, payments, prepayments and credit notes cannot be voided while their posting period is closed or locked. An administrator reopens the period first.

A voided invoice is locked

A voided invoice can only be viewed on screen:

  • It cannot be changed, posted, unarchived or sent to the DGI.
  • No return, credit note or payment can be made against it.
  • It cannot be printed, emailed or exported. The invoice page hides those buttons, and its payment link tells the customer the invoice was voided.

Tips

  • Recurring invoices: Mark an invoice as a Recurring Template to use it as the basis for repeating invoices — monthly service retainers, for example. CifraHQ copies the lines and amounts when you generate the next occurrence, so you don't rebuild the invoice each time.
  • The Outstanding amount on the invoice reflects the balance after partial payments and applied credits — it's what the customer still owes, at a glance.
  • A single invoice can reference lines from multiple deliveries or Sales Orders, which is useful when you invoice a customer at the end of the month for everything shipped during that period.

Related: Inventory Deliveries · Invoice Payments · Customer Credit Notes · Customers · Tax Codes · Audit Trail · Account Priming · Electronic Invoicing (Panama)

Was this page helpful?