Skip to main content
States
States are labels that do not reflect the internal state of the document. They are labels that don’t represent the condition of the document itself. This decoupling means the state system provides metadata about workflow events, not assertions about the document’s validity or integrity. Instead, states help you track the history of what happened to your document through a job run. For example, if a job encounters an error but doesn’t explicitly set a state label, the document’s state won’t be marked as Error, even though the document may actually be affected. The state label only changes when you explicitly change it through the “Set State” workflow step or through the API (though Empty and Invalid are exceptions to this rule). We provide the following states to label the document throughout its lifecycle. Here they are described in order to assist you in selecting appropriate states for your documents (via API or workflows).
InvalidThis state cannot be selected. It is set by the system when a GOBL document is uploaded through the API with the allow_invalid option, or is received through a network such as Peppol or SDI which allow receiving invoices.
EmptyInitial creation state before processing
DraftMainly used to mark documents that will require further changes.
ProcessingMainly used to indicate the document is being processed. Typically, the Set State step will be placed at the beginning of a workflow and changed later in the workflow, such as Sent or Error depending on the outcome.
RegisteredWhen a party has been granted invoice issuing entitlements, or a document has been registered for reporting.
CompletedGeneric label for completion of a process.
SentDocument has been successfully transmitted (e.g., to tax authority or customer)
ReceivedDocument has been successfully received (e.g., receiving a document in your Peppol inbox).
ErrorProcessing failed with an error, often placed in the error handling area of a workflow.
RejectedRejected by the tax authority or by a third party (e.g., Peppol participant)
PaidDocument (invoice or receipt) has been marked as paid
VoidDocument or party has been cancelled or voided
The Activity tab in the Console shows a chronological log of all state transitions and significant events affecting the document.