POST
Submit a filing (client account)
Client space Accounting module Cannot be undone For: Accountant · Permission: statement_filings.file Conditions
  • The accounting module must be part of the organization’s plan.
  • A filing that is already filed is refused, and a superseded filing is refused as immutable.
  • The fiscal year must still be closed.
  • The draft must be current: it is refused as stale if the year was reopened and closed again since the draft was computed, or if the data it was built from changed (the note inputs; for prix_de_transfert, the related parties it declares and the written answers of the year).
  • For the normal form, the balance sheet and cash flow coherence checks stored in the payload must pass; the transfer-pricing form has none.
  • For the normal form, every mandatory declarative note must carry data; the transfer-pricing form has no notes.
  • When another filing of the same book, fiscal year and form is already filed, this filing must name it in supersedes_filing_id; otherwise it is refused.
What else happens
  • Sets the status to filed and stamps filed_at and the filing actor; the payload is never recomputed afterwards.
  • When it names a filed filing, that earlier filing becomes superseded.
Part of File annual statements.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

statementFiling
string
required

Identifier of the filing (27-character KSUID string).

Query Parameters

response
enum<string>
default:none

Response mode. Default none; none answers 204 No Content.

Available options:
none,
resource
fields
string

Comma-separated JSON keys of the root resource (id is always rendered). Available: id, owner_type, fiscal_year_id, system, status, generated_at, generated_by, generated_by_type, filed_at, filed_by, filed_by_type, supersedes_filing_id, created_at, updated_at, payload.

include
string

Comma-separated include paths, each optionally followed by its fields in parentheses: units(id,sku),units.uomUnit(id,name). Max depth 6, max 40 paths. Available: fiscalYear.

Response

Resource (only with response=resource).

id

Identifier of the filing (27-character KSUID string).

owner_type

Kind of owner of the book the filing belongs to (for example organization or client account); set by the server from the selected book.

fiscal_year_id

Identifier of the closed fiscal year the filing covers (27-character KSUID string).

fiscal_year
object

The fiscal year, present only when requested with ?include=fiscalYear and the caller has the permission fiscal_years.retrieve; omitted otherwise.

system

DGI form the filing is made on: normal (Systeme Normal), prix_de_transfert (the transfer-pricing declaration, CGI art. 470) or pays_par_pays. Only normal and prix_de_transfert can be generated.

status

State of the filing: draft (editable by regenerate), filed (declared), superseded (replaced by a later filed correction).

payload
object

Frozen content computed when the draft was created or regenerated. For the normal form: system, balance_sheet, income_statement, cash_flow and notes. For prix_de_transfert: the declaration that the transfer-pricing preview returns (obligation, operations, loans and narrative). Omitted from lists.

generated_at

When the figures were last computed, ISO 8601; replaced by each regenerate.

generated_by

Identifier of the member or agent account that created or last regenerated the draft; null when the actor could not be validated.

generated_by_type

Kind of actor in generated_by; null when generated_by is null.

filed_at

When the filing was filed, ISO 8601; null while it is a draft.

filed_by

Identifier of the actor that filed it; null until filed.

filed_by_type

Kind of actor in filed_by; null until filed.

supersedes_filing_id

Identifier of the filed filing this one replaces once it is filed; null for a first filing.

created_at

Date and time the record was created (ISO 8601, UTC).

updated_at

Date and time the record was last changed (ISO 8601, UTC).