Skip to content

Company programs: submit

The Company Verbs submit as MCP do programs, with inputs, result, refusals and an example.

Reference for Company, one group of Company programs.

Company.submit

Submit files one tax return for a jurisdiction and its Periods, pays the tax due, and keeps the return as a Document. Verb page.

Text
do: return await $.Company.submit(input)

Emits Company.submitted.

Inputs

InputTypeRequiredDescription
jurisdictionstringrequiredWhere the return is filed, such as US-TX.
kindstringrequiredWhat the return reports: sales tax, VAT, GST, income, franchise tax, or an information return.
periodslist of PeriodrequiredThe locked Periods the return covers: one month, a quarter or a year.

Returns

OutputTypeRequiredDescription
taxReturnDocumentrequiredThe return as submitted, with the authority’s confirmation.
paymentTransactionThe payment of the tax due; none for an information return.
companyCompanyrequiredThe Company that filed the return.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.

Example

JSON
{
  "name": "do",
  "arguments": {
    "code": "return await $.Company.submit({ jurisdiction: 'US-TX', kind: 'salesTax', periods: ['period_VEVuYACTsH'] })"
  }
}