Stany Zjednoczone
Co Ocost odczytuje z amerykańskiego dokumentu i gdzie to zapisuje w ocost.document.v1. Faktura, faktura korygująca, dowód dostawy lub paragon dostaje ten sam kind co wszędzie.
Identyfikatory
Ocost zapisuje każdy numer w identifiers strony według scheme:
| Drukowany jako | scheme | valid |
|---|---|---|
EIN, Employer Identification Number (12-3456789) | US_EIN | 9 cyfr, pierwsze dwie to prefiks ośrodka IRS. Nie ma cyfry kontrolnej, więc przy prawidłowym prefiksie jest null. |
| State file number, Entity ID lub DOS ID | US_STATE_FILE | Tak, jak wydrukowano. Bez kontroli, więc zawsze null. |
EIN z błędnym prefiksem zostaje zachowany z valid: false, a kontrola identifier kończy się niepowodzeniem z at równym US_EIN. Ocost nigdy nie szuka po nim firmy. State file number nie podaje swojego stanu, więc po nim Ocost też nie szuka firmy. tax_registration_id może powtarzać EIN, więc czytaj identifiers.
Adres bez kraju leży w Stanach Zjednoczonych, gdy przed kodem ZIP lub ZIP+4 podaje stan, nazwą lub kodem USPS. Strona z numerem VAT innego kraju nigdy tam nie leży.
Sales tax
Stany Zjednoczone nie mają VAT. Ocost odczytuje sales tax jako podatek, nigdy jako pozycję. Podatki stanu, hrabstwa i miasta wydrukowane osobno tworzą jedną grupę vat_breakdown. Jej kwota netto to kwota, od której się je pobiera, a jej stawka to suma ich stawek. Kontrola vat przechodzi, gdy podatek grupy równa się jej kwocie netto razy ta stawka.
tax_check ma wartość null. Ocost nie sprawdza amerykańskich przepisów o fakturach ani stawek sales tax. Sprawdza sumy, pozycje, daty i identyfikatory.
Faktura, którą wystawiasz w Ocost dla amerykańskiej firmy, zaczyna każdą pozycję od 0 %, bez adnotacji o zwolnieniu.
E-faktury
Ocost odczytuje e-fakturę w UBL lub CII bez modelu. read_with ma wtedy wartość e_invoice, a każda wartość jest checked.
Daty i kwoty
Ocost zapisuje daty jako 2026-11-03, a kwoty jako 1270.92, niezależnie od tego, co drukuje dokument. $ staje się USD, gdy wystawca jest w Stanach Zjednoczonych. sources zachowuje cytat tak, jak wydrukowano. Jednostki i kody wymienia kody, które zapisuje Ocost.
Twoja firma
Ocost odróżnia dokumenty przychodzące od wychodzących po Twoich danych w Ustawienia › Firma. Amerykańska firma nie potrzebuje tam na start żadnego pola. Dodaj jej EIN, adres, stan, w którym ją założono, i file number tego stanu. Ocost nie pyta żadnego amerykańskiego rejestru, więc wpisujesz je sam. EIN z błędnym prefiksem zostaje odrzucony.
Formy prawne są takie same w każdym stanie: LLC, PLLC, Inc., Corp., PC, LP, LLP, LLLP, sole proprietorship, partnership i nonprofit corporation.
Poczta na belege@<name>.ocost.io trafia do Ocost. Nazwa to Twoja nazwa bez formy prawnej: Example Supply LLC dostaje example-supply.
Przykład
Fragment faktury przychodzącej z Teksasu:
{
"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"
}