Us Ny Freelance Intake

US-NY Freelance Developer Intake Skill v1.0

General reference only. This skill is general tax/accounting reference material for AI-assisted workflows. It has not been reviewed for any specific person's facts, documents, elections, deadlines, residency, filing status, or local procedures. Do not rely on it to file, pay, amend, or take a tax position without review by a qualified professional in the relevant jurisdiction.

Section 1 — The opening

When triggered, respond with ONE message that:

1. One-line greeting
2. One-line summary of the flow (scope check → upload → gaps → handoff to return assembly)
3. One-line reviewer reminder (must be reviewed by EA/CPA before filing)
4. Launch the refusal sweep immediately using ask_user_input_v0

Example first message:

Let's get your 2025 federal + New York return ready. Quick scope check, then you upload your documents, then I fill gaps. Target: 10 minutes.

Reminder: everything I produce needs signoff from a credentialed tax professional (EA, CPA, or tax attorney) before filing.

Scope check:

Then immediately call ask_user_input_v0 with the refusal questions.

Section 2 — Refusal sweep

Present the first batch as a single ask_user_input_v0 call with 3 questions:

Q1: "Business structure?"
    Options: ["Sole prop (no LLC)", "Single-member LLC", "Multi-member LLC", "S-corp", "C-corp", "Not sure"]

Q2: "Revenue range for 2025?"
    Options: ["Under $100K", "$100K–$250K", "$250K–$500K", "$500K–$1M", "Over $1M"]

Q3: "NYC resident (any of the 5 boroughs) or rest of NY state?"
    Options: ["NYC (Manhattan, Brooklyn, Queens, Bronx, Staten Island)", "Rest of NY state", "Part-year NYC / moved during 2025", "I don't live in NY"]

Evaluate:

• Q1 = Sole prop or Single-member LLC → continue

• Q1 = Multi-member LLC → stop. "Multi-member LLCs file Form 1065 as partnerships. You need a CPA familiar with partnership returns and NY PTET elections."

• Q1 = S-corp or C-corp → stop. "I don't cover corporate returns. S-corp (1120-S) and C-corp (1120) plus NY CT-3/CT-4 require a CPA."

• Q1 = Not sure → follow-up: "Did you file Form 2553 (S-corp election) or receive a W-2 from your own business? Yes to either = S-corp."

• Q2 → record for downstream. Over $1M triggers additional NYC UBT considerations.

• Q3 = NYC → continue, flag NYC UBT (Form NYC-202) + NYC personal income tax (Form NYC-1127 if applicable)

• Q3 = Rest of NY state → continue, no NYC taxes

• Q3 = Part-year NYC → continue with flag: NYC part-year allocation required

• Q3 = I don't live in NY → stop. "I'm set up for full-year New York residents only. Non-residents need Form IT-203 and multi-state allocation. You need a CPA who handles non-resident returns."

Second batch (after first batch passes):

Q4: "Filing status?"
    Options: ["Single, no dependents", "Single with dependents (HoH)", "Married filing jointly", "Married filing separately", "Qualified surviving spouse"]

Q5: "Did you file a 2024 return normally?"
    Options: ["Yes", "No (skipped year)", "Yes but amended / under audit"]

Q6: "Any of these in 2025?" (multi-select)
    Options: [
      "Rental property income",
      "Active crypto/day trading",
      "Foreign bank account over $10K",
      "W-2 employees on payroll",
      "Partnership income (K-1 from another entity)",
      "None of the above"
    ]

Q7: "NYS estimated tax payments made in 2025?"
    Options: ["Yes, all 4 quarters", "Yes, some quarters", "No", "Not sure"]

Q8: "Do you also have income sourced outside NY?"
    Options: ["No, all income is NY-sourced", "Yes, some income from other states", "Yes, significant out-of-state income"]

Evaluate Q4: Record filing status. All options in scope.

Evaluate Q5:

• Yes → continue
• No or amended/under audit → stop. "Skipped years or returns under audit need a CPA who can assess penalty exposure and represent you."

Evaluate Q6:

• Any of the first five options selected → stop with appropriate refusal
• "None of the above" → continue

Evaluate Q7: Record for downstream estimated tax analysis.

Evaluate Q8:

• All NY-sourced → continue
• Some or significant out-of-state → stop. "Multi-state income allocation requires IT-203 schedules and credit-for-taxes-paid-to-other-states analysis. You need a CPA who handles multi-state returns."

Section 3 — The dump

Once the refusal sweep passes, request the document dump:

Scope is good. Upload everything you have for 2025:

• Business bank statement(s) for 2025 (CSV or PDF)
• Tax forms received (1099-NEC, 1099-MISC, 1095-A/B/C, W-2 from side employment)
• Year-end retirement account statements
• NYS/NYC estimated tax payment confirmations or cancelled checks
• Your 2024 tax return (federal + NY)
• Any NY-specific notices (DTF correspondence, NYC Finance letters)
• LLC formation docs if applicable (Articles of Organization filed with NY DOS)
• Anything else tax-related

Drop it all in — I'll sort it out.

Section 4 — The inference pass

Parse all documents and extract:

Bank statement:

• Total deposits (gross receipts)
• Client retainer payments
• IRS EFTPS payments (federal estimated tax)
• NY DTF payments (state estimated tax)
• NYC Finance payments (city estimated tax or UBT)
• Retirement contributions
• Health insurance premiums
• Business expenses (SaaS, equipment, travel)
• Contractor payments
• NY LLC filing fee ($25 biennial)

1099-NEC received:

• Payer name, TIN, Box 1 amount
• Cross-check against bank deposits

Prior year return (federal + NY IT-201):

• Federal total tax (1040 Line 24)
• Federal AGI (1040 Line 11)
• NY taxable income (IT-201 Line 38)
• NY tax (IT-201 Line 39)
• NYC taxable income (IT-201 Line 47, if NYC resident)
• NYC tax (IT-201 Line 48)
• NY household credit claimed
• NYC UBT paid (Form NYC-202)

Retirement account statement:

• Plan type, contributions, dates
• Solo 401(k) limits: $23,500 employee + employer up to §415(c) $70,000 total

Section 5 — The confirmation

Present compact summary showing extracted data. Structure:

Identity

• [Name], [filing status], [dependents]
• Full-year NY resident ([NYC/rest of state])
• [Business structure]

Income

• Gross receipts: $X
• [Client breakdown]

Expenses

• [Category breakdown from bank statement]

NY-specific

• NYC UBT applicability: [Yes/No — triggered if NYC resident with business income]
• NYC UBT allocation: [100% if all work in NYC]
• NYS estimated payments made: $X
• NYC estimated payments made: $X

Flags:

• [Any issues identified]

Is any of this wrong?

Section 6 — Gap filling

Things that usually need asking:

1. Home office — exclusive use test, square footage
2. NYC UBT allocation — percentage of business conducted in NYC (if any work done outside city)
3. Health insurance source — NY State of Health marketplace vs employer vs COBRA
4. Commuter benefits — transit pre-tax (if also W-2 employment)
5. MCTMT — Metropolitan Commuter Transportation Mobility Tax: applies to self-employment income > $50,000 for NYC-area taxpayers (rate: 0.34% of net SE earnings allocated to MCTD)

Section 7 — NY-specific tax framework

New York State income tax (Form IT-201)

2025 rates (full-year resident):

• 4.00%: $0–$8,500
• 4.50%: $8,501–$11,700
• 5.25%: $11,701–$13,900
• 5.50%: $13,901–$80,650
• 6.00%: $80,651–$215,400
• 6.85%: $215,401–$1,077,550
• 9.65%: $1,077,551–$5,000,000
• 10.30%: $5,000,001–$25,000,000
• 10.90%: Over $25,000,000

NY standard deduction (2025): $8,000 (single), $16,050 (MFJ) NY itemized deduction: Based on federal Schedule A with NY modifications (no SALT deduction add-back at state level, but NY limits itemized deductions for high earners)

NYC personal income tax (NYC resident surcharge)

2025 rates:

• 3.078%: $0–$12,000
• 3.762%: $12,001–$25,000
• 3.819%: $25,001–$50,000
• 3.876%: $50,001 and over

Additional NYC surcharge for taxable income > $500,000 effectively brings top combined NYC rate to approximately 3.876% + additional tiers.

NYC Unincorporated Business Tax (UBT) — Form NYC-202

• Applies to any unincorporated business (sole prop, SMLLC) carried on in NYC
• Tax rate: 4% of taxable income after exemption
• Exemption: $95,000 (but phases out between $95,000 and $150,000 of NYC UBT taxable income)
• Partial credit against NYC personal income tax (Form NYC-1127 or IT-201 Line 51)
• UBT estimated tax: quarterly payments required if UBT liability expected to exceed $3,400

Metropolitan Commuter Transportation Mobility Tax (MCTMT)

• Applies to self-employed individuals with net earnings from self-employment allocated to the Metropolitan Commuter Transportation District (NYC + Dutchess, Nassau, Orange, Putnam, Rockland, Suffolk, Westchester)
• Rate: 0.34% on net SE earnings > $50,000 allocated to MCTD
• Reported on Form MTA-6 (annual) or quarterly
• Due dates align with estimated tax quarters

NY estimated tax (Form IT-2105)

• Required if NY tax liability expected to exceed $300 after credits and withholding
• Quarterly due dates: April 15, June 15, September 15, January 15
• Safe harbor: 100% of prior year NY tax OR 90% of current year NY tax
• Underpayment penalty: computed on Form IT-2105.9

Section 8 — Handoff

Once gap-filling is complete, produce handoff message and invoke us-ny-return-assembly:

Intake complete. Handing off to the return assembly workflow.

You'll receive:

1. Excel working paper (federal + NY + NYC lines)
2. Reviewer brief with positions, citations, and flags
3. Form packages (1040, IT-201, NYC-202 if applicable)
4. 2026 estimated tax vouchers (federal + NY + NYC)
5. Action items with deadlines

Starting now.

Section 9 — Refusal handling

When a refusal fires:

1. Stop the workflow
2. State the specific reason
3. Recommend the path forward
4. Do not try to work around the refusal

Sample refusals:

Stop — you have partnership income from a K-1. I can't handle multi-entity returns or the interplay between your K-1 income and your freelance Schedule C for NY allocation purposes. You need a CPA.

Stop — you moved out of NYC mid-year. Part-year NYC allocation on the UBT and city income tax requires Form NYC-1127 and careful day-counting. You need a CPA familiar with NYC part-year filings.

Section 10 — Self-checks

Check NY-IN1 — Refusal sweep used ask_user_input_v0. Check NY-IN2 — NYC vs rest-of-state determined before proceeding. Check NY-IN3 — UBT applicability flag set if NYC resident with business income. Check NY-IN4 — Upload-first flow honored. Check NY-IN5 — Documents parsed before gap-filling questions. Check NY-IN6 — MCTMT flagged for MCTD-area taxpayers. Check NY-IN7 — Filing status recorded for IT-201 rate determination. Check NY-IN8 — Handoff to us-ny-return-assembly is explicit.

End of Skill

Disclaimer

This skill and its outputs are provided for informational and computational purposes only and do not constitute tax, legal, or financial advice. Open Accountants and its contributors accept no liability for any errors, omissions, or outcomes arising from the use of this skill. All outputs must be reviewed and signed off by a qualified professional (such as a CPA, EA, tax attorney, or equivalent licensed practitioner in your jurisdiction) before filing or acting upon.

The most up-to-date, verified version of this skill is maintained at openaccountants.com. Log in to access the latest version, request a professional review from a licensed accountant, and track updates as tax law changes.

Source: OpenAccountants — open tax Guides for AI, reviewed by named CPAs/CAs/EAs. Quality: source-cited draft. For always-current figures and named-accountant backing, connect the OpenAccountants MCP server (openaccountants-mcp).