A shareholder receives a Schedule K-1 showing a $40,000 loss and remembers taking a $20,000 distribution during the year. The tax software imports the loss, subtracts the distribution, and produces a clean-looking draft. The draft can still be wrong if it does not know the owner’s beginning basis, the tax investment in stock and qualifying shareholder loans, contributions, nondeductible expenses, prior suspended losses, and other limits.
Software for S corporation basis and K-1s has to connect two returns and several workpapers. The S corporation files Form 1120-S, while each shareholder receives a Schedule K-1 (Form 1120-S) showing that shareholder’s share of the corporation’s items. The shareholder then uses those items, plus separate basis and limitation records, on the shareholder’s return.
An S corporation is a corporation that has made a federal election allowing certain income, losses, deductions, and credits to pass through to shareholders. Stock basis is the shareholder’s tax investment in the corporation’s stock. Debt basis is the shareholder’s tax basis in qualifying loans the shareholder personally made to the S corporation. Basis is a tax workpaper balance, not the corporation’s bank balance and not the amount of cash distributed.
In this series, Tangle Tax Agent means a proposed workflow from Tangle, the project behind this series, that collects entity records, prepares Form 1120-S and K-1 workpapers, updates basis calculations, and stops for review before filing. It does not mean a public Tangle product can decide a shareholder’s basis or loss limits without the underlying records and approval. A review packet is the source-linked basis workpaper, open questions, draft forms, and approval state that a shareholder or advisor inspects before filing.
This is not tax advice. S corporation returns and shareholder basis can require professional review.
The K-1 is an allocation, not a deduction certificate
The IRS’s current Form 1120-S instructions say Schedule K-1 shows each shareholder’s separate share of the corporation’s income, deductions, credits, and other information. The same instructions say the ordinary business income or loss on the K-1 is reported without applying the shareholder’s basis, at-risk, or passive-activity limitations. Those limitations are determined at the shareholder level.
That creates a boundary the software must preserve.
| Record | What it tells the shareholder | What it does not settle |
|---|---|---|
| Form 1120-S | The corporation’s income, gains, losses, deductions, credits, and other federal information | The shareholder’s available stock or debt basis |
| Schedule K-1 | The shareholder’s allocated items and attached information | Whether every loss or deduction is currently usable |
| Basis workpaper | How stock and debt basis changed during the year | Whether at-risk, passive-activity, or excess-business-loss limits also apply |
| Distribution ledger | Cash or property moved from the corporation to the shareholder | Whether the distribution is taxable after stock-basis analysis |
| Payroll records | Wages and withholding reported through payroll systems | Whether a distribution can be reclassified or whether the payroll record is complete |
| Ownership records | Shares held, acquired, transferred, or redeemed during the year | How every allocation or state filing should be handled without reviewing the entity return |
The IRS stock and debt basis guidance states that a shareholder can have an S corporation loss on a K-1 without being entitled to deduct the full amount. It also states that a non-dividend distribution is tested against stock basis, while debt basis is used for certain loss and deduction amounts after stock basis is exhausted.
A worked basis calculation
Consider Jordan, the sole shareholder of an illustrative S corporation. The values below demonstrate the ordering of a simplified basis workpaper. They are not a tax result for a real taxpayer.
| Basis event | Amount | Stock basis after event |
|---|---|---|
| Beginning stock basis | $30,000 | $30,000 |
| Pass-through income items | +$15,000 | $45,000 |
| Additional capital contribution | +$5,000 | $50,000 |
| Non-dividend distribution | -$20,000 | $30,000 |
| Nondeductible expenses | -$2,000 | $28,000 |
| Pass-through loss and deduction items | -$40,000 | $0, with $12,000 beyond stock basis |
The simplified order is important. The IRS describes the annual order as increasing stock basis for income items, decreasing it for distributions, decreasing it for nondeductible expenses, and then decreasing it for loss and deduction items. The current IRS basis page provides the ordering and a worked example.
Assume Jordan also has $7,000 of valid debt basis from a personally made loan. The $12,000 beyond stock basis may use up to $7,000 of debt basis, leaving a $5,000 amount subject to suspension or other applicable limits. The phrase “may use” matters because at-risk, passive-activity, and other rules can still affect the amount currently allowed.
The calculation can be expressed as a reviewable worksheet:
stock basis before loss = $30,000 + $15,000 + $5,000 - $20,000 - $2,000
stock basis before loss = $28,000
loss allocated on K-1 = $40,000
loss absorbed by stock basis = $28,000
loss remaining after stock basis = $12,000
available debt basis = $7,000
loss using debt basis candidate = $7,000
remaining loss candidate = $5,000A final worksheet must use the correct K-1 items, ordering rules, debt documentation, and taxpayer facts. The example’s purpose is to show why a product that imports a K-1 without a beginning balance and source-linked adjustments cannot produce a trustworthy basis answer.
Replay the distribution when one source disagrees
Jordan’s $20,000 distribution should be traceable as a sequence of records rather than as a negative number typed into a basis field. The following review table shows the minimum evidence for the illustrative calculation.
| Input | Source record | Review question |
|---|---|---|
| $30,000 beginning stock basis | Prior-year basis workpaper or Form 7203 support | Does the opening balance agree with the prior-year ending balance? |
| $15,000 pass-through income | Form 1120-S workpapers and shareholder K-1 | Which income items increase stock basis under the year’s ordering rules? |
| $5,000 contribution | Bank record and corporate capital account | Did Jordan contribute cash or property, and when? |
| $20,000 distribution | Corporate distribution ledger and bank record | Was the transfer cash or property, and does the ledger agree with the bank? |
| $2,000 nondeductible expense | Form 1120-S workpapers and K-1 information | Is the item correctly classified before it reduces basis? |
| $40,000 loss | Shareholder K-1 and attached statements | Which amount remains after stock and documented debt basis? |
| $7,000 shareholder loan | Signed loan agreement, funding trail, and repayment history | Does the record support debt basis rather than a guarantee or informal advance? |
If the bank record shows $20,000 leaving the company but the distribution ledger shows $18,000, the system should open a reconciliation question and keep both amounts visible. It should not silently choose the larger amount because that would change the distribution and basis result. If the beginning basis workpaper later changes, the application should recalculate the downstream rows and retain the earlier draft for comparison.
This replay also exposes a common failure mode. A product can produce the correct arithmetic for the illustrative inputs while still producing the wrong taxpayer result if the loan is not qualifying debt, the K-1 is corrected, ownership changed during the year, or another shareholder-level limitation applies. The source-linked workpaper makes those risks reviewable before the output is treated as a filing input.
Form 7203 makes the basis boundary visible
Form 7203 is the IRS form for S corporation shareholder stock and debt basis limitations. The current IRS Form 7203 page says shareholders use it to figure potential limitations on deductions, credits, and other items. The IRS instructions identify situations such as claiming an S corporation loss, receiving a non-dividend distribution, disposing of stock, or receiving a loan repayment.
Software should include the Form 7203 question in the workflow rather than treat it as an afterthought. The shareholder’s packet should show which K-1 lines, contributions, distributions, loan documents, and prior-year carryovers feed the calculation.
The calculation should remain inspectable even when a form is not required for a particular return. An annual basis workpaper makes the beginning balance for the next year visible and gives a reviewer a way to find a discrepancy before it compounds.
The application should also distinguish these balances:
| Balance | Meaning | Common mistake |
|---|---|---|
| Stock basis | Tax basis in the shareholder’s stock | Treating it as the company’s book equity or cash balance |
| Debt basis | Basis in qualifying shareholder loans to the company | Treating a guarantee or informal advance as the same as documented debt |
| Suspended loss | A loss not currently usable because a limitation applied | Forgetting the year and limitation that carried it forward |
| Distribution amount | Cash or property transferred by the company | Treating the amount as automatically taxable or automatically tax-free |
The shareholder instructions for Schedule K-1 (Form 1120-S) also caution that a shareholder can owe tax on an allocated share of income whether or not the corporation distributed cash. That is another reason the K-1 and distribution ledger must remain separate.
A small calculation model can enforce the right questions
The following TypeScript is a toy example of the ordering logic. It is intentionally incomplete and should not be used to prepare a real return.
type BasisInput = {
openingStockBasis: number
incomeItems: number
contributions: number
distributions: number
nondeductibleExpenses: number
lossItems: number
openingDebtBasis: number
}
function reviewBasis(input: BasisInput) {
const stockBeforeDistribution =
input.openingStockBasis
+ input.incomeItems
+ input.contributions
const distributionExcessCandidate = Math.max(
0,
input.distributions - stockBeforeDistribution,
)
const stockAfterDistribution = Math.max(
0,
stockBeforeDistribution - input.distributions,
)
const stockBeforeLoss = Math.max(
0,
stockAfterDistribution - input.nondeductibleExpenses,
)
const lossUsingStock = Math.min(stockBeforeLoss, input.lossItems)
const lossAfterStock = input.lossItems - lossUsingStock
const lossUsingDebt = Math.min(input.openingDebtBasis, lossAfterStock)
return {
stockBeforeLoss,
endingStockBasis: stockBeforeLoss - lossUsingStock,
endingDebtBasis: input.openingDebtBasis - lossUsingDebt,
lossUsingDebt,
suspendedCandidate: lossAfterStock - lossUsingDebt,
distributionExcessCandidate,
needsOtherLimitReview: true,
}
}
const example = reviewBasis({
openingStockBasis: 30_000,
incomeItems: 15_000,
contributions: 5_000,
distributions: 20_000,
nondeductibleExpenses: 2_000,
lossItems: 40_000,
openingDebtBasis: 7_000,
})
console.log(example)An illustrative basis-review API could return the calculation candidate and its missing inputs. This is a product-design example, not a public Tangle endpoint.
POST /shareholder-basis-reviews
Content-Type: application/json
{
"taxYear": 2025,
"entityId": "example-s-corporation",
"shareholderId": "example-shareholder",
"requireDebtDocuments": true
}The distributionExcessCandidate field keeps any distribution above the toy stock-basis balance visible instead of silently turning it into zero.
The needsOtherLimitReview field is deliberate.
The code calculates a mechanical candidate and then refuses to represent that candidate as the final deductible loss.
Production software would need a tax-year-specific rule set, source references, reviewed fixtures, and additional handling for the full set of shareholder-level limits.
Payroll, ownership, and state records belong beside the K-1
Payroll and distributions answer different questions. Payroll records show wages and withholding through the employer’s payroll process. Distribution records show cash or property moved from the corporation. The K-1 reports allocated items from the entity return. The software should reconcile those records without merging them into one “owner compensation” field.
Ownership changes create another dependency. The current Form 1120-S instructions explain that items can be allocated according to shares held during the year and describe elections that can divide a tax year after certain terminations or qualifying dispositions. An application needs the dates, shares, transaction documents, and any election statement before it can explain why a K-1 was allocated the way it was.
State work also needs its own view. The IRS says the S corporation K-1 can include information a shareholder needs for state and local returns. That information does not make the federal K-1 a complete state return. Keep state income, withholding, composite filing notices, and allocation statements linked to the source pages and jurisdiction.
Keep the shareholder draft open when basis is incomplete
The product should keep the return in review when:
| Stop condition | What remains unresolved |
|---|---|
| Beginning stock basis does not agree with the prior-year workpaper | The loss and distribution limits cannot be carried forward safely |
| A shareholder loan lacks a signed agreement, funding trail, or repayment history | Debt-basis treatment needs review |
| Distributions exceed available stock basis in the workpaper | Potential taxable distribution treatment needs review |
| K-1 loss items exceed stock and documented debt basis | Suspended-loss and other limitation analysis is incomplete |
| Ownership changed during the tax year | Allocation dates and any election need review |
| Payroll, books, and the entity return disagree | The source conflict must be resolved before the shareholder draft is accepted |
| State or international attachments are missing | The federal boxes do not contain the whole filing input |
| A corrected Form 1120-S or K-1 arrives | Dependent basis, state, and shareholder outputs need a new version |
The stop should be informative. It should name the missing record, the affected calculation, and the person who must answer the question. “Basis incomplete because the prior-year workpaper is missing” is a useful state. “Low confidence” leaves the shareholder with no next action.
Put the basis workpaper at the Tangle boundary
The proposed Tangle Tax Agent workflow should keep the entity return and shareholder return connected without collapsing them. It can ingest the books and prior-year packet, organize Form 1120-S workpapers, extract K-1 items, calculate basis candidates, reconcile distributions and payroll, and prepare a review packet.
collect books, prior return, payroll, ownership, and distribution records
-> draft Form 1120-S workpapers
-> prepare shareholder K-1 records
-> compute stock and debt basis candidates
-> apply source-linked review questions for limits and state items
-> compare corrections and preserve prior versions
-> obtain approval before the filing package is finalizedThe product’s useful boundary is the basis workpaper. It should show the beginning balance, every increase and decrease, the source for each item, the loss or distribution amount that remains unresolved, and the next review action. For the founder return that combines this basis work with other entities and assets, continue with complex tax situations software for founder returns.
For the multi-entity K-1 workflow, read K-1 Tax Filing For Multiple Entities. For the founder context, read Complex Tax Situations Software For Founders. For the broader source-backed preparation model, read AI Accountant For Complex Tax Returns.
If the workflow later runs as a public service, an automated calculation remains a candidate until the source documents and reviewer decisions are attached. The system should not describe a successful run as proof that the shareholder’s basis or tax position is correct.
Basis workpapers narrow the claim
A K-1 does not prove that a shareholder can deduct every loss printed on it. A distribution amount does not prove that the distribution is taxable or nontaxable without stock-basis analysis. A bank transfer does not prove debt basis without the required debt facts. A completed Form 7203 does not eliminate at-risk, passive-activity, or other applicable limitations.
The software also cannot infer missing prior-year history from the current K-1. It can carry an unresolved balance forward, list the missing workpaper, and route the question to a taxpayer or advisor.
Choose the system that carries basis forward
Choose S corp tax software only when it connects Form 1120-S, shareholder K-1s, stock and debt basis, distributions, payroll, ownership changes, and state details in one versioned review packet. If it produces a K-1 document and a single deductible-loss number without the basis calculation behind it, it is not ready for a complex S corporation return. For one shareholder with complete prior-year basis records and no ownership or correction issues, conventional tax software plus a reviewed Form 7203 workpaper may be the better fit.
What is S corp tax software?
It is software for preparing and reviewing an S corporation’s Form 1120-S and the related shareholder reporting. For a useful result, it must preserve the entity return, K-1s, basis workpapers, distributions, and open questions together.
Why does shareholder basis matter?
Basis can limit the loss or deduction a shareholder may use and can affect the treatment of a non-dividend distribution. Stock basis and debt basis are separate balances with different roles.
Does a K-1 loss automatically reduce my taxable income?
No. The K-1 reports an allocated item, while basis, at-risk, passive-activity, and other shareholder-level limits determine how much may be usable in the current year.
What should the software show before filing?
It should show the prior-year basis, contributions, income, distributions, nondeductible items, loss ordering, debt documentation, suspended amounts, state details, source links, and reviewer decisions.
Can Tangle Tax Agent prepare an S corporation return without review?
The workflow described here should prepare source-backed drafts and require review before filing. It should stop when basis, ownership, distributions, payroll, corrections, or state information is incomplete.