Guides

Pull your PEO cost breakdown for reconciliation

Bring Remote US PEO costs into your accounting system, per employee. PEO bills on actuals — a payroll invoice each pay run, plus a monthly service invoice.

👥

Who this is for — Finance and AP teams running Remote US PEO who want their PEO costs in their own accounting system: per employee, attributed to the right dimension, and booked to their GL.

🇺🇸

On EOR instead? EOR bills on an estimate-then-true-up cycle — see Pull your EOR cost breakdown.

How US PEO billing works

PEO (US co-employment) bills actuals — there's no EOR-style pre-funding estimate to true up. You receive two recurring documents:

  • PEO payroll invoice (billing_document_type: peo_funding_payrolls) — issued each time a payroll run is finalized (typically twice a month for semi-monthly payroll; more often for bi-weekly/weekly or off-cycle runs). Carries the actual payroll costs — gross wages, employer-side taxes, benefits, reimbursements. Due on receipt.
  • PEO service invoice (billing_document_type: peo_management_fees) — issued on the 1st of the month, payable within ~14 days. Carries Remote's fees (PEPM, benefits administration, ACA/COBRA, EPLI, 401(k), and any registration costs), plus adjustments/arrears from the prior month. A one-time implementation fee, if you have one, appears as a line item on this service invoice — it isn't a separate document.

So "reconciliation" for PEO means matching actual costs to your books — not comparing an estimate to an actual. PEO is US-only, USD, and paid by ACH / Direct Debit.

The approach

  1. List the billing documents for the period — the PEO payroll invoice(s) and the monthly service invoice.
  2. Pull each breakdown — tag each line with its document's billing_document_type and keep the employment_id.
  3. Join each line's employment_id to the employment record, then to your booking dimension.
  4. Book the actuals — post the actual payroll + service costs, including any prior-month arrears on the service invoice.

Key capabilities

JobWhere to look
List PEO documents for a period (peo_funding_payrolls, peo_management_fees)GET /v1/billing-documents
Itemized lines per employee (one call returns all lines — not paginated)GET /v1/billing-documents/{id}/breakdown
Workforce record to join + dimension onGET /v1/employments

Each breakdown line carries a free-text type + description (the cost component — show it, don't key logic off the exact string; description may be null), the employment_id, and two amounts in integer minor units — invoice_amount/invoice_currency and source_amount/source_currency, with the fx_rate between them (e.g. 534163 = $5,341.63). Confirm exact field names in the API Reference.

Gotchas & limits

  • No estimate / reconcile cycle. PEO invoices are actuals — don't apply EOR's pre-funding logic here.
  • Two document types only — peo_funding_payrolls (payroll) and peo_management_fees (service). The one-time implementation fee is a line on the service invoice, not its own document.
  • The service invoice can include prior-month arrears, so don't assume one invoice equals one month.
  • This breakdown is per-employment. Legal-entity-wide charges (with no employment) are excluded, so every line has a non-null employment_id — and the breakdown may not tie to the invoice total. Reconcile company-level charges from the invoice itself.
  • Payment terms differ by document — the payroll invoice is due on receipt; the service invoice is payable within ~14 days.
  • PEO is US-only, USD, ACH / Direct Debit.
  • Cost center isn't on the public employment endpoint yet (in flight).

🤖 For AI agents

Point your assistant (or the Remote MCP server) at the API Reference with this plan:

List billing documents for the period (expect peo_funding_payrolls payroll invoice(s) and a peo_management_fees service invoice) → pull each breakdown (all lines come in one call) → join lines to employments on employment_id → convert amounts from minor units → post the actuals, including any prior-month arrears on the service invoice → aggregate by the customer's accounting dimension. Every line has a non-null employment_id (legal-entity-wide charges are excluded, so the breakdown may not tie to the invoice total). Treat type as a display label, not a stable key. Do not apply EOR pre-funding/reconciliation logic to PEO.

Next steps

  • Pull your EOR cost breakdown — the EOR equivalent (estimate-then-true-up).
  • Pull contractor invoices for AP — the contractor side of the same finance pipeline.
  • Pull GL & payroll reports (coming soon) — for Global Payroll customers booking journals.