США
Что 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"
}