Bill
Delivery
Bill
Delivery
Delivery document used to describe the delivery of goods or potentially also services.
Schema ID
https://gobl.org/draft-0/bill/delivery
Properties
| Title | Property | Type | Req. | Description |
|---|---|---|---|---|
| Tax Regime | $regime | l10n.TaxCountryCode | ||
| Addons | $addons | array of cbc.Key | Addons defines a list of keys used to identify tax addons that apply special normalization, scenarios, and validation rules to a document. | |
| Tags | $tags | array of cbc.Key | Tags are used to help identify specific tax scenarios or requirements that will apply changes to the contents of the invoice. Tags by design should always be optional, it should always be possible to build a valid invoice without any tags. | |
| UUID | uuid | string | Universally Unique Identifier. | |
| Type | type | cbc.Key | true | Type of delivery document. |
| Series | series | cbc.Code | Series is used to identify groups of deliveries by date, business area, project, type, customer, a combination of any, or other company specific data. If the output format does not support the series as a separate field, it will be prepended to the code for presentation with a dash (-) for separation. | |
| Code | code | cbc.Code | Code is a sequential identifier that uniquely identifies the delivery. The code can be left empty initially, but is required to sign the document. | |
| Issue Date | issue_date | cal.Date | When the delivery document is to be issued. | |
| Value Date | value_date | cal.Date | When the taxes of this delivery become accountable, if none set, the issue date is used. | |
| Currency | currency | currency.Code | Currency for all delivery totals. | |
| Exchange Rates | exchange_rates | array of currency.ExchangeRate | Exchange rates to be used when converting the invoices monetary values into other currencies. | |
| Ordering | ordering | bill.Ordering | Ordering details for the delivery, including links to other documents. | |
| Preceding Details | preceding | array of org.DocumentRef | Key information regarding previous delivery documents that this one will either extend or replace. | |
| Tracking | tracking | bill.Tracking | Tracking is used to define specific codes or IDs that may be used to identify and track delivery. | |
| Despatch Date | despatch_date | cal.Date | DespatchDate is the date when the goods are expected to be despatched. | |
| Receive Date | receive_date | cal.Date | ReceiveDate is the date when the goods are expected to be received. | |
| Tax | tax | bill.Tax | Special tax configuration for calculating totals. | |
| Supplier | supplier | org.Party | true | The entity supplying the goods or services and usually responsible for paying taxes. |
| Customer | customer | org.Party | Legal entity receiving the goods or services, may be nil in certain circumstances such as simplified invoices. | |
| Despatcher | despatcher | org.Party | The party who will despatch the goods defined in the invoice. | |
| Receiver | receiver | org.Party | The party who will receive delivery of the goods defined in the invoice. | |
| Courier | courier | org.Party | The courier responsible for delivering the goods. | |
| Lines | lines | array of bill.Line | List of lines representing each of the items to be ordered. | |
| Discounts | discounts | array of bill.Discount | Discounts or allowances applied to order totals | |
| Charges | charges | array of bill.Charge | Charges or surcharges applied to order totals | |
| Totals | totals | bill.Totals | Summary of all the order totals, including taxes (calculated). | |
| Notes | notes | array of org.Note | Unstructured information that is relevant to the delivery, such as correction or additional legal details. | |
| Complements | complements | array of schema.Object | Additional complementary objects that add relevant information to the delivery. | |
| Meta | meta | cbc.Meta | Additional semi-structured data that doesn’t fit into the body of the delivery. | |
| Attachments | attachments | array of org.Attachment | Attachments provide additional information or supporting documents that are not included in the main document. It is important that attachments are not used for alternative versions of the PDF, for that, see “links” inside the envelope headers. |
Tax Regime Values
| Value | Description |
|---|---|
AE | United Arab Emirates |
AT | Austria |
BE | Belgium |
BR | Brazil |
CA | Canada |
CH | Switzerland |
CO | Colombia |
DE | Germany |
EL | Greece |
ES | Spain |
FR | France |
GB | United Kingdom |
IN | India |
IT | Italy |
MX | Mexico |
NL | The Netherlands |
PL | Poland |
PT | Portugal |
US | United States of America |
Type Values
| Value | Description |
|---|---|
advice | A delivery or despatch advice document send by the supplier to indicate how an order is to be delivered. |
note | A delivery note is a document accompanying a shipment of goods that lists the items included in the shipment. |
waybill | A waybill is a document issued by a carrier giving details and instructions relating to the shipment of a consignment of goods. |
receipt | A delivery receipt is a document that is signed by the person who receives goods to confirm that they have been received. |