# Invox

> Electronic invoicing for Peru (SUNAT), built to be operated by agents.

One call per invoice: the service validates, calculates, numbers, sends to the provider, resolves what SUNAT
answers, stores the PDF, XML and CDR, emails the customer and notifies by webhook or by a waiting event query.
Every organization has a test twin with a simulated provider that can produce every outcome, failures included.
Private beta. Today: one provider (Bizlinks), soles (PEN) only, cash payment, no credit or debit notes.

## Start here

- [Brief for agents](https://beta.invox.page/index.md) (Spanish): what to ask your person, when you are done, the house rules and what does not exist yet.
- [API discovery](https://api.invox.page/v1): how to obtain a credential (device flow: the person confirms in a browser), links to everything below. No credential needed.
- [OpenAPI contract](https://api.invox.page/v1/openapi.json): generated from the code that serves it.
- [Error catalog](https://api.invox.page/v1/errors): every error says what happened, what did NOT happen and what to do.
- [Event types](https://api.invox.page/v1/event_types)

## Guides (Markdown)

- [Getting a credential](https://api.invox.page/v1/docs/start): From the base URL to a credential that acts on an organization, without any screen of ours.
- [The first invoice, in test mode](https://api.invox.page/v1/docs/first-invoice): Issue a test invoice end to end: series, preview, the call, and what the answer means.
- [Following an invoice to its outcome](https://api.invox.page/v1/docs/follow-invoice): Waiting on the invoice or on the event stream — no public URL needed — and reading its files and emails.
- [Webhooks](https://api.invox.page/v1/docs/webhooks): Receiving events at a URL: verifying the signature, discarding duplicates, and reconciling with the event stream.
- [Voiding and correcting](https://api.invox.page/v1/docs/void-and-correct): The two irreversible actions: each needs the token of its own preview.
- [Test mode: scenarios and provider conditions](https://api.invox.page/v1/docs/test-mode): Provoking every outcome — accepted, rejected, pending, a blocked provider account — without touching anything real.
- [The road to production](https://api.invox.page/v1/docs/production): What is still missing to issue for real, who must do each thing, and what changes when it is done.
- [Members and invitations](https://api.invox.page/v1/docs/people): Who can do what, and how a person joins an organization: only by invitation.
- [The sales report (CSV)](https://api.invox.page/v1/docs/reports): The invoices of a period as a spreadsheet, in one call.
- [Errors](https://api.invox.page/v1/docs/errors): How to read an error and act on it without guessing; the full catalog.
- [Reference: routes, permissions and limits](https://api.invox.page/v1/docs/reference): Every route with the permission it needs and how a retry is made safe; the scopes; the limits.

## Optional

- [The page for people](https://beta.invox.page/personas.md) (Spanish): an agent's session step by step, each step with a real answer of the API.

## Access

- Private beta: ask for access on behalf of your person at access@invox.page.