Skip to main content
Status represents a system or business event that needs to be recorded for compliance purposes.

Schema ID

https://gobl.org/draft-0/bill/status

Properties

TitlePropertyTypeDescription
Tax Regime$regimetax.RegimeCodeCountry code that identifies the tax regime applicable to the document. It determines which country-specific tax rules, normalizations, and validations are applied. It may be determined automatically via normalization of a supplier or issuer tax identity country code.
Addons$addonstax.AddonListAddons defines a list of keys used to identify tax addons that apply special normalization, scenarios, and validation rules to a document.
UUIDuuidstringUniversally Unique Identifier.
Typetypecbc.KeyType of status being reported (e.g. “system” for internal events).
Issue Dateissue_datecal.DateIssueDate is the date when the status is to be considered effective.
Issue Timeissue_timecal.TimeIssueTime is used when extra precision is required to determine when exactly the status was issued.
Seriesseriescbc.CodeSeries is an optional code to group related status events together.
Codecodecbc.CodeCode provides a way to identify the specific status event being reported.
Extensionsexttax.ExtensionsExt provides additional structured data specific to the regime or addon.
Orderingorderingbill.OrderingOrdering provides links to related documents and details that may have occurred before this status was created.
Suppliersupplierorg.PartySupplier represents the entity supplying the goods or services in the original transaction and may not be the issuer of the document.
Customercustomerorg.PartyCustomer is optional and describes the recipient of the original services. In the case of a local or system event, this will be empty.
Issuerissuerorg.PartyIssuer represents an intermediary acting on behalf of either the supplier or customer in order to provide a status update, this is useful specifically if only the third party is registered on a network. (Optional).
Recipientrecipientorg.PartyRecipient represents another intermediary responsible for receiving the event when the supplier or customer do not have networking capabilities. May also be a tax agency in a five corner model. (Optional).
Lineslinesarray of bill.StatusLineLines contain the main payload of the message used to describe individual documents which have a status.
Notesnotesarray of org.NoteNotes for additional details about the event.
Metametacbc.MetaMeta contains unstructured data useful for internal tools.

Type Values

ValueDescription
responseA response to a document that has been submitted, often used in a two way communication between a customer and supplier.
updateIssued by the supplier (or issuer) that may be shared with the customer, but more likely with a fifth-corner, like a government agency.
systemA system event that is not directly related to a specific document, but needs to be recorded for compliance purposes.

Validation Rules

FieldTestValidation Code / Message
type
  • Present
GOBL-BILL-STATUS-01
Status type is required
type
  • One of [response, update, system]
GOBL-BILL-STATUS-02
Status type is not valid
supplier
  • Present
GOBL-BILL-STATUS-03
Status supplier is required
lines
  • Present
GOBL-BILL-STATUS-04
Status must have at least one line