United States
What Ocost reads on an American document and where it writes it in ocost.document.v1. An invoice, credit note, delivery note or receipt gets the same kind as anywhere.
Identifiers
Ocost writes each number to the party's identifiers by scheme:
| Printed as | scheme | valid |
|---|---|---|
EIN, Employer Identification Number (12-3456789) | US_EIN | 9 digits, the first two an IRS campus prefix. There is no check digit, so a right prefix is null. |
| State file number, Entity ID or DOS ID | US_STATE_FILE | As printed. No check, so always null. |
An EIN with a wrong prefix is kept with valid: false, and the check identifier fails with at US_EIN. Ocost never finds a company by it. A state file number doesn't say its state, so Ocost never finds a company by it either. tax_registration_id may repeat the EIN, so read identifiers.
An address that prints no country is in the United States when it writes a state, by name or USPS code, before a ZIP or ZIP+4. A party with another country's VAT ID never is.
Sales tax
The United States has no VAT. Ocost reads sales tax as tax, never as a line. A state's, county's and city's tax printed apart become one vat_breakdown group. Its net is the amount they are charged on, its rate their rates added up. The check vat holds when the group's tax is its net times that rate.
tax_check is null. Ocost checks no American invoice rules and no sales tax rate. It checks the sums, the lines, the dates and the identifiers.
An invoice you write in Ocost for an American business starts each line at 0 %, with no exemption note.
E-invoices
Ocost reads an e-invoice in UBL or CII without a model. read_with is then e_invoice, and every value is checked.
Dates and amounts
Ocost writes dates as 2026-11-03 and amounts as 1270.92, whatever the document prints. A $ becomes USD when the issuer is in the United States. sources keeps the quote as printed. Units and codes lists the codes Ocost writes.
Your company
Ocost tells incoming from outgoing by your details in Settings › Company. An American company needs no field there to start. Add its EIN, its address, the state it was formed in and that state's file number. Ocost asks no American register, so you enter them yourself. An EIN with a wrong prefix is refused.
The legal forms are the same in every state: LLC, PLLC, Inc., Corp., PC, LP, LLP, LLLP, sole proprietorship, partnership and nonprofit corporation.
Mail to belege@<name>.ocost.io reaches Ocost. The name is yours without its legal form: Example Supply LLC gets example-supply.
Example
An excerpt of an incoming invoice from Texas:
{
"kind": "invoice",
"kind_detail": "invoice",
"type_code": "380",
"number": "INV-2207",
"currency": "USD",
"seller": {
"name": "Example Supply LLC",
"identifiers": [
{ "scheme": "US_EIN", "value": "123456789", "valid": null }
],
"vat_id": null,
"address": { "street": "200 Example Ave", "postal_code": "78701", "city": "Austin, TX", "country": "US" }
},
"totals": { "net": 1000, "tax": 82.5, "gross": 1082.5, "payable": null, "prices_include_vat": false },
"vat_breakdown": [
{ "category": "S", "rate": 8.25, "taxable_amount": 1000, "tax_amount": 82.5, "exemption_reason": null }
],
"tax_check": null,
"read_with": "reader"
}