США
Що Ocost читає в американському документі і куди записує це в ocost.document.v1. Рахунок, кредит-нота, накладна чи чек отримують той самий kind, що й будь-де.
Ідентифікатори
Ocost записує кожен номер до identifiers сторони за scheme:
| Надруковано як | scheme | valid |
|---|---|---|
EIN, Employer Identification Number (12-3456789) | US_EIN | 9 цифр, перші дві — префікс центру IRS. Контрольної цифри немає, тому за правильного префікса значення null. |
| State file number, Entity ID чи DOS ID | US_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.
Приклад
Уривок вхідного рахунку з Техасу:
{
"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"
}