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.
Suppliersupplierorg.PartySupplier represents the entity supplying the goods or services in the original transaction.
Customercustomerorg.PartyCustomer is optional and describes the recipient of the original services.
Orderingorderingbill.OrderingOrdering provides links to related documents and additional details about which parties may be involved in the transaction.
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 seller that will be shared with either the customer, a fifth-corner entity such as a government agency, or both.
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