> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arcuserp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Portal Invoices and Shipments

> Help customers review invoice balances, download invoice PDFs, pay eligible invoices, and track shipments from the customer portal.

<Note>
  **Portal invoice and shipment pages are list-based**
  The portal currently uses invoice rows and expandable shipment rows. Do not tell
  customers to open a separate invoice detail page or shipment detail URL.
</Note>

## Review Portal Invoices

Customers open **Invoices** from the portal sidebar. The page shows
invoice counts, unpaid and overdue summaries, outstanding balance, invoice status
tabs, search, invoice rows, balance due, payment state, a PDF download action, and
a **Pay** button when an invoice still has a balance.

<Frame caption={"Portal Invoices gives customers a customer-safe view of open, paid, and overdue invoices without exposing internal accounting detail."}>
  <img src="https://mintcdn.com/arcuserp/MrJkb10V6EpIZu0o/images/support/screenshots/customer-portal/customer-portal-invoices.png?fit=max&auto=format&n=MrJkb10V6EpIZu0o&q=85&s=8a23b53e03a76a0e203101c17fb54922" alt="Customer portal Invoices page with invoice KPI cards, status tabs, invoice rows, due dates, balances, Pay buttons, and PDF download actions" width="1920" height="1100" data-path="images/support/screenshots/customer-portal/customer-portal-invoices.png" />
</Frame>

## Pay An Open Invoice

When a customer clicks **Pay**, the portal opens a confirmation modal
with invoice total, amount paid, and balance due. Continuing sends the customer to
the portal Payments flow with invoice and amount context.

<Frame caption={"The Pay Invoice modal confirms the balance before handing the customer to the payment workflow."}>
  <img src="https://mintcdn.com/arcuserp/MrJkb10V6EpIZu0o/images/support/screenshots/customer-portal/customer-portal-pay-invoice-modal.png?fit=max&auto=format&n=MrJkb10V6EpIZu0o&q=85&s=f62c3f1e8fe854f005a4ba5949a8e480" alt="Customer portal Pay Invoice modal showing invoice total, amount paid, balance due, and Continue to Payment button" width="1920" height="1100" data-path="images/support/screenshots/customer-portal/customer-portal-pay-invoice-modal.png" />
</Frame>

* **PDF download**: opens the customer-facing invoice PDF in a new browser tab.
* **Pay button**: appears when the invoice has a remaining balance.
* **Paid invoice**: remains visible for history, but should not show a pay action.
* **Overdue label**: helps customers identify invoices past their due date.

## Invoice Edge States

| State               | Customer-facing result                                              | Staff review                                                                          |
| ------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| Unpaid              | Invoice shows balance due and may show Pay.                         | Confirm the invoice is posted and payment connector is healthy.                       |
| Partially paid      | Balance due is lower than invoice total.                            | Review payment history, credits, refunds, and remaining balance.                      |
| Paid                | Invoice remains visible for history and should not request payment. | Use staff invoice or payment history for questions about how it was paid.             |
| Overdue             | Invoice is still open and past due date.                            | Follow collections workflow and confirm due date, terms, and statements.              |
| PDF unavailable     | PDF action fails or opens an error.                                 | Confirm the customer-facing document can be generated and browser popups are allowed. |
| Payment blocked     | Pay action is missing or payment flow fails.                        | Check invoice status, void state, balance due, portal settings, and Stripe health.    |
| Public link expired | Customer cannot use an old link from email.                         | Resend the invoice or payment email to generate a fresh link.                         |

<Warning>
  **Search and KPI totals can depend on backend data**
  If invoice stats are unavailable, the portal may show a current-page summary. Treat
  invoice rows and balances as the most important customer-facing source on the page.
</Warning>

## Track Portal Shipments

Customers open **Shipments** from the portal sidebar. The page shows
shipment counts, active shipments, carrier, tracking number, delivery status, shipped
date, estimated delivery date, and carrier tracking link.

<Frame caption={"Portal Shipments gives customers account-scoped package visibility and carrier links."}>
  <img src="https://mintcdn.com/arcuserp/MrJkb10V6EpIZu0o/images/support/screenshots/customer-portal/customer-portal-shipments.png?fit=max&auto=format&n=MrJkb10V6EpIZu0o&q=85&s=1f42d8d5f180cb6da931f2a34a7d0f08" alt="Customer portal Shipments page with shipment KPI cards, shipment rows, carrier badges, tracking numbers, statuses, shipped dates, and estimated delivery dates" width="1920" height="1100" data-path="images/support/screenshots/customer-portal/customer-portal-shipments.png" />
</Frame>

## Expand Shipment History

Customers can expand a shipment row to see the current status, carrier service,
tracking number copy action, external carrier link, and tracking history events.
The history loads when the row is expanded.

<Frame caption={"Expanded shipment rows show tracking context without requiring a separate shipment detail route."}>
  <img src="https://mintcdn.com/arcuserp/MrJkb10V6EpIZu0o/images/support/screenshots/customer-portal/customer-portal-shipment-detail.png?fit=max&auto=format&n=MrJkb10V6EpIZu0o&q=85&s=20886492699143bd7b3df4069bda95df" alt="Expanded customer portal shipment row with out for delivery status, carrier card, tracking number, copy action, external carrier link, and tracking history" width="1920" height="1100" data-path="images/support/screenshots/customer-portal/customer-portal-shipment-detail.png" />
</Frame>

<Tip>
  **Use public tracking links for one shipment**
  If the customer only needs tracking for one package, send the public tracking link.
  If they need to review many shipments, use the full portal Shipments page.
</Tip>

## Shipment Edge States

| State                | Customer-facing result                                               | Staff review                                                                               |
| -------------------- | -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| No tracking number   | Shipment may be absent or show limited package information.          | Confirm the package was fulfilled and a label or tracking number exists.                   |
| Carrier delay        | Tracking may stop updating for a period of time.                     | Check the carrier site and review recent tracking events before promising a delivery date. |
| Multiple packages    | Customer may see multiple shipment rows or expanded package details. | Confirm each package has the right items and tracking.                                     |
| Delivered            | Shipment shows delivered when carrier data is available.             | Use delivered timestamp for RMA eligibility and customer follow-up.                        |
| Carrier page differs | Carrier site may update before Arcus receives the next event.        | Treat the carrier page as the live carrier source and Arcus as the account record.         |

## Staff Checklist

1. Confirm the customer is logged into the correct account.
2. Confirm the invoice or shipment belongs to that account and entity.
3. Confirm the invoice is posted and customer-visible before expecting it in the portal.
4. Confirm the package has a tracking number and carrier status before promising live tracking detail.
5. Use the public payment link or public tracking link for one-off customer requests.

## Common Blocks

* **Invoice missing**: confirm the invoice belongs to the portal account and is customer-visible.
* **Pay button missing**: the invoice may be paid, voided, not payable, or portal payments may be disabled.
* **PDF does not open**: confirm the invoice PDF can be generated and the customer's browser allows new tabs.
* **Shipment missing**: confirm the order was shipped and the package belongs to the customer's account.
* **Tracking history is empty**: the carrier may not have scanned the package yet.
* **Carrier page differs from Arcus**: the carrier site can update before Arcus receives the next tracking event.

## Related Articles

<CardGroup cols={2}>
  <Card title="Customer Portal Overview" href="/support/customer-portal/overview">
    Understand portal login, dashboard, customer navigation, setup requirements, and account-scoped visibility.
  </Card>

  <Card title="Portal Payments and Payment Methods" href="/support/customer-portal/payments-methods">
    Review customer portal payment history, payment starts, saved methods, and common payment blocks.
  </Card>

  <Card title="Public Order, Payment, and Quote Links" href="/support/customer-portal/public-links">
    Use tokenized public links for customer order view, payment, shipment tracking, and quote approval.
  </Card>

  <Card title="Invoice Management" href="/support/invoices/management">
    Find, create, post, send, pay, correct, and void customer invoices.
  </Card>

  <Card title="Shipments and Rate Preview" href="/support/fulfillment/shipments-rate-preview">
    Track packages, review shipment details, export shipment rows, and preview carrier rates without buying labels.
  </Card>

  <Card title="Record Customer Payments" href="/support/orders/record-payment">
    Record cash, card, ACH, check, wire, external, terms, or credit payments.
  </Card>
</CardGroup>
