United Kingdom

What Ocost reads on a British 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

Printed asFieldCheck
VAT registration number (GB and 9 or 12 digits)vat_id, identifiers as EU_VATCheck vat_id: its format. Ocost doesn't ask HMRC.
Company number (Companies House)legal_registration_idNone
IBANpayment.ibanCheck iban: its check digits

VAT

Ocost reads the rates a document prints, usually 20 %, 5 % or 0 %. Each rate is one vat_breakdown group. The check vat holds when a group's VAT is its net times its rate.

tax_check is null. Ocost checks no British invoice rules yet. It checks the sums, the lines, the dates, the IBAN and the identifiers.

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

British documents print 03/11/2026 and £1,270.92. Ocost writes 2026-11-03, 1270.92 and GBP. 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. A British company needs its registered office. A Ltd, PLC or LLP adds its Companies House number. Add the VAT number once you are VAT-registered.

When you add a British company to your group, Ocost looks it up at Companies House by its number or name. A VAT number it looks up at HMRC.

Ocost fills an empty address or VAT number from your documents and the group's, where an exact identifier names you. It never overwrites a value.

Mail to belege@<name>.ocost.io reaches Ocost. The name is yours without Ltd or Limited: Example Joinery Ltd gets example-joinery.

Example

An excerpt of an incoming invoice:

JSON
{
  "kind": "invoice",
  "kind_detail": "invoice",
  "type_code": "380",
  "number": "INV-2026-0318",
  "currency": "GBP",
  "seller": {
    "name": "Example Joinery Ltd",
    "identifiers": [
      { "scheme": "EU_VAT", "value": "GB123456789", "valid": null }
    ],
    "vat_id": "GB123456789",
    "legal_registration_id": "Company No. 01234567"
  },
  "totals": { "net": 500, "tax": 100, "gross": 600, "payable": null, "prices_include_vat": false },
  "vat_breakdown": [
    { "category": "S", "rate": 20, "taxable_amount": 500, "tax_amount": 100, "exemption_reason": null }
  ],
  "tax_check": null,
  "read_with": "reader"
}

See also