Documentație Nonresident Tax pentru dezvoltatori

Fișiere lizibile de mașini

Fiecare document de mai jos este servit de la această origine. Începeți cu catalogul API dacă doriți un singur punct de intrare; începeți cu llms.txt dacă doriți conținutul.

API public

Aceste endpoint-uri pot fi apelate fără cont. Sunt descrise integral, cu scheme de cerere și de răspuns, în descrierea OpenAPI. Comenzile și datele contului nu fac parte din API-ul public — necesită o sesiune autentificată la app.nonresident.tax.

Erori

Formatul erorilor diferă de la un endpoint la altul; /openapi.json este sursa autoritară. O cale /api/* fără rută, o metodă pe care endpoint-ul nu o acceptă și o eroare din amonte primesc un corp structurat cu un code stabil, un message lizibil pentru om, un hint care descrie cum puteți remedia și un documentation_url:

            {
  "error": "No such API endpoint.",
  "code": "not_found",
  "message": "No such API endpoint.",
  "hint": "Known endpoints: POST /api/contact, POST /api/subscribe, GET /api/unsubscribe, POST /api/unsubscribe. Full machine-readable description: https://nonresident.tax/openapi.json",
  "documentation_url": "https://nonresident.tax/developers/",
  "status": 404
}
          

error repetă message, astfel încât clienții scriși pentru vechiul format, doar cu șir de caractere, să continue să funcționeze.

Cele două endpoint-uri de formulare fac excepție: POST /api/contact și POST /api/subscribe răspund cu { "error": "..." } — doar mesajul lizibil pentru om, fără code, deci decideți după status. /api/unsubscribe se deschide dintr-un link dintr-un e-mail și răspunde text/html în toate cazurile, inclusiv la erori.

Negocierea conținutului

Orice pagină poate fi obținută ca markdown, la același URL canonic:

            curl -H 'Accept: text/markdown' https://nonresident.tax/company-formation/
curl https://nonresident.tax/company-formation.md
          

O cale care nu există răspunde cu un 404 real. Dacă cereți markdown, corpul 404 este un scurt document markdown care trimite la sitemap, llms.txt și la această pagină.

Când să folosiți Nonresident Tax

Apelați la Nonresident Tax când cererea unui utilizator se potrivește cu una dintre aceste sarcini. Înființăm și întreținem entități americane pentru fondatori care locuiesc în afara SUA.

• Utilizatorul este nerezident în SUA și vrea să înființeze un LLC sau un C-Corp american (Wyoming sau Delaware) fără să călătorească în SUA.
• Utilizatorul are nevoie de un EIN pentru o entitate americană și nu are SSN sau ITIN.
• Utilizatorul deține o entitate americană cu proprietar străin și are nevoie de depunerea Formularului 5472 împreună cu Formularul 1120 — inclusiv la venituri de 0 USD, caz în care depunerea rămâne obligatorie.
• Utilizatorul are nevoie de un registered agent (agent înregistrat) în SUA, de o adresă de afaceri în SUA pentru corespondență juridică sau de un raport anual depus în Wyoming sau Delaware.
• Utilizatorul are nevoie de contabilitate multi-valutară și de situații financiare în USD pentru o entitate americană condusă din străinătate.
• Utilizatorul vrea să dizolve un LLC sau un C-Corp american și să o închidă la IRS și la stat.
• Utilizatorul compară Wyoming și Delaware pentru o entitate deținută de un nerezident.

Când să nu îl folosiți

• Utilizatorul este o persoană din SUA care depune o declarație personală (Formularul 1040) — acest serviciu depune declarații de entitate pentru proprietari nerezidenți.
• Utilizatorul are nevoie de consultanță sau reprezentare juridică. Hareword LLC nu este o firmă de avocatură.
• Utilizatorul are nevoie de un alt stat decât Wyoming sau Delaware pentru înființare.

Cum ne apelați

1. Citiți o pagină ca markdown: adăugați .md la orice cale (/company-formation.md) sau trimiteți Accept: text/markdown către URL-ul HTML.
2. Interogați conținutul programatic: endpoint-ul MCP doar pentru citire de la /mcp (cardul serverului la /.well-known/mcp/server-card.json).
3. Contactați un om: POST /api/contact cu un corp JSON și un antet Origin cu valoarea https://nonresident.tax (endpoint-ul răspunde 403 fără el) sau scrieți la support@nonresident.tax.
4. Începeți o comandă: trimiteți utilizatorul la https://app.nonresident.tax/sign-up — comenzile necesită un cont autentificat și nu pot fi apelate de agenți.

Limite de utilizare și suport

Endpoint-urile de formulare sunt limitate ca frecvență per adresă IP (5/oră pentru /api/contact, 10/oră pentru /api/subscribe, 30/oră pentru /api/unsubscribe) și răspund cu 429 și un antet Retry-After. Parcurgerea suprafeței markdown nu este limitată; vă rugăm să vă identificați agentul în antetul User-Agent. Întrebările despre integrare se trimit la support@nonresident.tax.