Documentazione per sviluppatori di Nonresident Tax

File leggibili dalle macchine

Ogni documento qui sotto è servito da questa origine. Parta dal catalogo API se vuole un unico punto di ingresso; parta da llms.txt se vuole i contenuti.

API pubblica

Questi endpoint possono essere chiamati senza un account. Sono descritti per intero, con gli schemi di richiesta e risposta, nella descrizione OpenAPI. Gli ordini e i dati dell’account non fanno parte dell’API pubblica: richiedono una sessione autenticata su app.nonresident.tax.

Errori

La forma degli errori varia a seconda dell’endpoint; fa fede /openapi.json. Un percorso /api/* non instradato, un metodo non accettato dall’endpoint e un errore a monte rispondono con un corpo strutturato che contiene un code stabile, un message leggibile, un hint che indica come rimediare e 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 ripete message in modo che i client scritti per la vecchia forma a sola stringa continuino a funzionare.

I due endpoint dei moduli fanno eccezione: POST /api/contact e POST /api/subscribe rispondono con { "error": "..." }, solo il messaggio leggibile, senza code, quindi si ramifichi in base allo stato. /api/unsubscribe si apre da un link in un’e-mail e risponde sempre con text/html, anche per gli errori.

Negoziazione del contenuto

Qualsiasi pagina può essere ottenuta in markdown, allo stesso URL canonico:

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

Un percorso inesistente risponde con un vero 404. Se richiede il markdown, il corpo del 404 è un breve documento markdown che rimanda alla sitemap, a llms.txt e a questa pagina.

Quando usare Nonresident Tax

Si rivolga a Nonresident Tax quando la richiesta di un utente corrisponde a uno di questi compiti. Costituiamo e manteniamo entità americane per fondatori che vivono fuori dagli Stati Uniti.

• L’utente è un non residente negli Stati Uniti che vuole costituire una LLC o una C-Corp americana (Wyoming o Delaware) senza recarsi negli Stati Uniti.
• L’utente ha bisogno di un EIN per un’entità americana e non ha SSN né ITIN.
• L’utente possiede un’entità americana a titolarità estera e ha bisogno che vengano presentati il Modulo 5472 e il Modulo 1120, anche con ricavi pari a 0 USD, caso in cui la presentazione resta comunque obbligatoria.
• L’utente ha bisogno di un registered agent americano, di un indirizzo aziendale americano per la corrispondenza legale o di un annual report presentato in Wyoming o Delaware.
• L’utente ha bisogno di una contabilità multivaluta e di bilanci in USD per un’entità americana gestita dall’estero.
• L’utente vuole sciogliere una LLC o una C-Corp americana e chiuderla con l’IRS e lo Stato.
• L’utente sta confrontando Wyoming e Delaware per un’entità di proprietà di un non residente.

Quando non usarlo

• L’utente è un US person che presenta una dichiarazione personale (Modulo 1040): questo servizio presenta dichiarazioni di entità per titolari non residenti.
• L’utente ha bisogno di consulenza o rappresentanza legale. Hareword LLC non è uno studio legale.
• L’utente ha bisogno, per la costituzione, di uno Stato diverso da Wyoming o Delaware.

Come interagire con noi

1. Leggere una pagina come markdown: aggiunga .md a qualsiasi percorso (/company-formation.md), oppure invii Accept: text/markdown all’URL HTML.
2. Interrogare i contenuti in modo programmatico: l’endpoint MCP in sola lettura su /mcp (server card su /.well-known/mcp/server-card.json).
3. Contattare una persona: POST /api/contact con un corpo JSON e un header Origin pari a https://nonresident.tax (senza di esso l’endpoint risponde 403), oppure scrivere a support@nonresident.tax.
4. Avviare un ordine: indirizzare l’utente a https://app.nonresident.tax/sign-up; gli ordini richiedono un account autenticato e non sono richiamabili dagli agenti.

Limiti di frequenza e assistenza

Gli endpoint dei moduli hanno un limite di frequenza per indirizzo IP (5/ora per /api/contact, 10/ora per /api/subscribe, 30/ora per /api/unsubscribe) e rispondono 429 con un header Retry-After. La scansione della superficie markdown non ha limiti di frequenza; La preghiamo di identificare il Suo agente nell’header User-Agent. Le domande sull’integrazione vanno a support@nonresident.tax.