patch
https://api.everee.com/integration/v1/partner/companies//tax-setup
Set a draft company's federal return type and the states where it pays employees.
Use this endpoint to set the company's tax setup. It is a partial update: a field you leave out keeps its current value.
Part of Taxes and funding account. For how this fits into onboarding, see the guide: Collecting company information: taxes.
| Field | Notes |
|---|---|
returnType | FORM_941 (quarterly) or FORM_944 (annual). |
states | The complete list of states where the company pays W-2 employees. It replaces the previous list, so send every state each time. Send [] to clear it. |
A company that pays W-2 employees must have at least one state before it can be submitted. Until then TAX_STATES appears in readiness.missing.
When you can call this
Only while the onboarding is a DRAFT and the contract documents haven't been signed. Otherwise it returns 409.
Errors
| Status | Meaning |
|---|---|
401 | The API key is missing, malformed or expired. |
404 | No company with this ID belongs to your partner account. |
409 | The onboarding is no longer a DRAFT, or the contract has been signed. |
422 | A value isn't valid, for example an unknown returnType or state. |