Τεκμηρίωση Nonresident Tax για προγραμματιστές

Μηχανικά αναγνώσιμα αρχεία

Κάθε έγγραφο παρακάτω σερβίρεται από αυτή την προέλευση. Ξεκινήστε από τον κατάλογο API αν θέλετε ένα μοναδικό σημείο εισόδου· ξεκινήστε από το llms.txt αν θέλετε το περιεχόμενο.

Δημόσιο API

Αυτά τα endpoints μπορούν να κληθούν χωρίς λογαριασμό. Περιγράφονται πλήρως, με σχήματα αιτήματος και απόκρισης, στην περιγραφή OpenAPI. Οι παραγγελίες και τα δεδομένα λογαριασμού δεν ανήκουν στο δημόσιο API — απαιτούν πιστοποιημένη συνεδρία στο app.nonresident.tax.

Σφάλματα

Τα σχήματα σφαλμάτων διαφέρουν ανά endpoint· το /openapi.json είναι το αρμόδιο. Μια διαδρομή /api/* χωρίς δρομολόγηση, μια μέθοδος που το endpoint δεν δέχεται και μια αποτυχία upstream απαντούν με δομημένο σώμα που περιέχει σταθερό code, αναγνώσιμο από άνθρωπο message, ένα hint που περιγράφει πώς να αποκατασταθεί το πρόβλημα και ένα 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 επαναλαμβάνει το message, ώστε οι πελάτες που γράφτηκαν για το παλαιότερο σχήμα μόνο-συμβολοσειράς να συνεχίσουν να λειτουργούν.

Τα δύο endpoints φορμών αποτελούν εξαίρεση: τα POST /api/contact και POST /api/subscribe απαντούν { "error": "..." } — μόνο το αναγνώσιμο μήνυμα, χωρίς code, γι' αυτό διακλαδώστε με βάση το status. Το /api/unsubscribe ανοίγει από σύνδεσμο σε email και απαντά text/html σε όλες τις περιπτώσεις, συμπεριλαμβανομένων των σφαλμάτων του.

Διαπραγμάτευση περιεχομένου

Οποιαδήποτε σελίδα μπορεί να ληφθεί ως markdown, στο ίδιο κανονικό URL:

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

Μια διαδρομή που δεν υπάρχει απαντά με πραγματικό 404. Αν ζητήσετε markdown, το σώμα του 404 είναι ένα σύντομο έγγραφο markdown που παραπέμπει στο sitemap, στο llms.txt και σε αυτή τη σελίδα.

Πότε να χρησιμοποιήσετε τη Nonresident Tax

Στραφείτε στη Nonresident Tax όταν το αίτημα ενός χρήστη ταιριάζει με μία από αυτές τις εργασίες. Συστήνουμε και συντηρούμε οντότητες ΗΠΑ για ιδρυτές που ζουν εκτός ΗΠΑ.

• Ο χρήστης είναι κάτοικος εκτός ΗΠΑ που θέλει να συστήσει LLC ή C-Corp ΗΠΑ (Wyoming ή Delaware) χωρίς να ταξιδέψει στις ΗΠΑ.
• Ο χρήστης χρειάζεται EIN για οντότητα ΗΠΑ και δεν έχει SSN ή ITIN.
• Ο χρήστης κατέχει οντότητα ΗΠΑ με αλλοδαπή ιδιοκτησία και χρειάζεται υποβολή εντύπου 5472 μαζί με έντυπο 1120 — συμπεριλαμβανομένης της περίπτωσης με έσοδα $0, όπου η υποβολή παραμένει υποχρεωτική.
• Ο χρήστης χρειάζεται εγγεγραμμένο αντιπρόσωπο στις ΗΠΑ, επαγγελματική διεύθυνση στις ΗΠΑ για νομική αλληλογραφία ή υποβολή ετήσιας έκθεσης στο Wyoming ή στο Delaware.
• Ο χρήστης χρειάζεται λογιστική πολλαπλών νομισμάτων και οικονομικές καταστάσεις σε USD για οντότητα ΗΠΑ που λειτουργεί από το εξωτερικό.
• Ο χρήστης θέλει να λύσει μια LLC ή C-Corp ΗΠΑ και να την κλείσει έναντι της IRS και της πολιτείας.
• Ο χρήστης συγκρίνει Wyoming και Delaware για οντότητα που ανήκει σε μη κάτοικο.

Πότε να μην τη χρησιμοποιήσετε

• Ο χρήστης είναι πρόσωπο των ΗΠΑ που υποβάλλει προσωπική δήλωση (έντυπο 1040) — αυτή η υπηρεσία υποβάλλει δηλώσεις οντοτήτων για ιδιοκτήτες μη κατοίκους.
• Ο χρήστης χρειάζεται νομική συμβουλή ή εκπροσώπηση. Η Hareword LLC δεν είναι δικηγορικό γραφείο.
• Ο χρήστης χρειάζεται για τη σύσταση πολιτεία διαφορετική από το Wyoming ή το Delaware.

Πώς να επικοινωνήσετε μαζί μας

1. Διαβάστε μια σελίδα ως markdown: προσθέστε .md σε οποιαδήποτε διαδρομή (/company-formation.md) ή στείλτε Accept: text/markdown στο URL HTML.
2. Ερωτήστε το περιεχόμενο προγραμματιστικά: το endpoint MCP μόνο ανάγνωσης στο /mcp (κάρτα διακομιστή στο /.well-known/mcp/server-card.json).
3. Επικοινωνήστε με άνθρωπο: POST /api/contact με σώμα JSON και κεφαλίδα Origin https://nonresident.tax (το endpoint απαντά 403 χωρίς αυτήν) ή στείλτε email στο support@nonresident.tax.
4. Ξεκινήστε μια παραγγελία: στείλτε τον χρήστη στο https://app.nonresident.tax/sign-up — οι παραγγελίες απαιτούν πιστοποιημένο λογαριασμό και δεν μπορούν να κληθούν από πράκτορες.

Όρια ρυθμού και υποστήριξη

Τα endpoints φορμών έχουν περιορισμό ρυθμού ανά διεύθυνση IP (5/ώρα για το /api/contact, 10/ώρα για το /api/subscribe, 30/ώρα για το /api/unsubscribe) και απαντούν 429 με κεφαλίδα Retry-After. Η ανίχνευση της επιφάνειας markdown δεν έχει περιορισμό ρυθμού· δηλώστε τον πράκτορά σας στην κεφαλίδα User-Agent. Ερωτήσεις για την ενσωμάτωση στέλνονται στο support@nonresident.tax.