США

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

См. также