США

Що Ocost читає в американському документі і куди записує це в ocost.document.v1. Рахунок, кредит-нота, накладна чи чек отримують той самий kind, що й будь-де.

Ідентифікатори

Ocost записує кожен номер до identifiers сторони за scheme:

Надруковано якschemevalid
EIN, Employer Identification Number (12-3456789)US_EIN9 цифр, перші дві — префікс центру IRS. Контрольної цифри немає, тому за правильного префікса значення null.
State file number, Entity ID чи DOS IDUS_STATE_FILEЯк надруковано. Без перевірки, тому завжди null.

EIN із хибним префіксом зберігається з valid: false, а перевірка identifier не проходить, і її at дорівнює US_EIN. Ocost ніколи не шукає за таким номером компанію. State file number не називає свого штату, тож за ним Ocost компанію теж не шукає. tax_registration_id може повторювати EIN, тому читайте identifiers.

Адреса без країни належить до США, коли перед ZIP чи ZIP+4 називає штат, назвою або кодом USPS. Сторона з номером ПДВ іншої країни — ніколи.

Sales tax

У США немає ПДВ. Ocost читає sales tax як податок, ніколи як рядок. Податки штату, округу й міста, надруковані окремо, стають однією групою vat_breakdown. Її нетто — сума, з якої їх стягують, її ставка — сума їхніх ставок. Перевірка vat проходить, коли податок групи дорівнює її сумі нетто, помноженій на цю ставку.

tax_check дорівнює null. Ocost не перевіряє американських правил для рахунків і ставок sales tax. Він перевіряє суми, рядки, дати та ідентифікатори.

Рахунок, який ви складаєте в Ocost для американської компанії, починає кожен рядок із 0 %, без примітки про звільнення.

Електронні рахунки

Ocost читає електронний рахунок в UBL або CII без моделі. Тоді read_with дорівнює e_invoice, і кожне значення має checked.

Дати і суми

Ocost пише дати як 2026-11-03, а суми як 1270.92, хоч би що друкував документ. $ стає USD, коли емітент перебуває в США. sources зберігає цитату так, як її надруковано. Коди, які пише Ocost, перелічує сторінка Одиниці та коди.

Ваша компанія

Ocost відрізняє вхідні документи від вихідних за вашими даними в Налаштуваннях › Реквізити. Американській компанії для початку там не потрібне жодне поле. Додайте її EIN, адресу, штат, у якому її засновано, і file number цього штату. Ocost не звертається до жодного американського реєстру, тож ви вносите їх самі. EIN із хибним префіксом відхиляється.

Організаційно-правові форми в кожному штаті ті самі: LLC, PLLC, Inc., Corp., PC, LP, LLP, LLLP, sole proprietorship, partnership і nonprofit corporation.

Пошта на belege@<name>.ocost.io надходить до Ocost. Ім’я — ваша назва без організаційно-правової форми: Example Supply LLC отримує example-supply.

Приклад

Уривок вхідного рахунку з Техасу:

JSON
{
  "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"
}

Див. також