Billing Document
Summary
A billing document is a formal record or statement that outlines the details of a financial transaction between a seller and a buyer. It serves as a proof of the products or services provided, the quantities, the agreed-upon prices, any applicable taxes, and the total amount due for payment.
Common types of billing documents include:
- Invoice: This is one of the most common types of billing documents. An invoice is a request for payment sent by a seller to a buyer, detailing the products or services provided, their quantities, unit prices, total charges, and any applicable taxes or discounts.
- Credit Note: A credit note is a document issued by a seller to a buyer to indicate a reduction in the amount owed. This could be due to various reasons, such as returned goods, errors in invoicing, or adjustments in pricing.
- Debit Note: Similar to a credit note, a debit note is issued by a seller to a buyer to indicate an increase in the amount owed. This could be due to additional charges, corrections in pricing, or other adjustments.
Schema
Relationships
- A billing document has zero-to-many BillingDocumentItems
- A billing document has zero-to-many BusinessPartners
- A billing document has exactly one reference to a CustomerAccount
- A billing document has zero-or-one references to a SalesOrder
Data Definitions
BillingDocument
Data Type | Field Name | Rules | About |
---|---|---|---|
DateTime | billingDocumentDate | Exactly 1 | The date of the billing document |
BillingDocumentLifeCycle | billingDocumentLifeCycle | Zero or One | The life cycle state of the document. |
String | billingDocumentType | Exactly 1 | The type of the billing document. |
BusinessPartner | businessPartner | One to Many | A list of all other potential business partners involved in the billing document |
CustomerAccount | customerAccount | Exactly 1 | Document reference to the customer account document for which the billing document is for. |
Monetary | grossAmount | Zero or One | Total amount of a billing document, before any adjustments. |
Monetary | netAmount | Zero or One | The amount of a billing document after any discounts, returns, or allowances have been applied. |
Monetary | taxAmount | Zero or One | Monetary amount of tax applied to the billing document |
TaxType | taxType | Zero or One | Document Reference to the TaxType document describing the tax applied to the billing document. |
String | transactionNumber | Zero or One | Business defined canonical user facing billing document number. |
BilllingDocumentItem | txDocItem | Zero to Many | A collection of all the items included in the billing document. |
Note omitted fields: attributeField, extendedBy, externalIdentity, recordedBy, sourceSystemCode, sourceSystemId, uniqueText
BillingDocumentItem
Data Type | Field Name | Rules | About |
---|---|---|---|
Product | catalogItem | Exactly 1 | The product the billing document item is for |
Monetary | costAmount | Zero or One | The monetary amount of cost to the seller of the billing document. |
Monetary | grossAnount | Zero or One | The monetary amount of the item before adjustments. |
String | itemIdentifier | Zero or One | The customer-facing identifier for this item. |
String | lineNumber | Zero or One | The line number of this item |
Monetary | netAmount | Exactly 1 | The monetary amount of the item after adjustments. |
PriceElement | priceElement | Zero to Many | The monetary pricing elements for this item. See Price Element. |
Magnitude | quantity | Exactly 1 | The quantity of catalog items for this item. |
String | salesItemCategoryDescription | Zero or One | A descriptive text about the sales item category. |
Monetary | taxAmount | Zero or One | The monetary amount of tax for this item. |
Decimal | taxRate | Zero or One | The tax rate for this item. |
TaxType | taxType | Zero or One | The tax type for this item. |
Note omitted fields: attributeField, extendedBy, externalIdentity, recordedBy, sourceSystemCode, sourceSystemId, uniqueText
Sample JSON
{
"@type": "BillingDocument",
"transactionNumber": "90038690",
"grossAmount": {
"@type": "Monetary",
"decimalValue": "1548.08",
"currency": {
"@type": "DataReference",
"schemaName": "limber",
"shapeName": "CurrencyUnit",
"iri": "https://schema.limbergraph.com/limber/CurrencyUnit#NZD",
"keys": [
{
"code": "NZD"
}
],
"label": "NZD"
},
"uniqueText": "daaad965-5ea9-4fdc-9049-f45d1ff5605c"
},
"netAmount": {
"@type": "Monetary",
"decimalValue": "1346.16",
"currency": {
"@type": "DataReference",
"schemaName": "limber",
"shapeName": "CurrencyUnit",
"iri": "https://schema.limbergraph.com/limber/CurrencyUnit#NZD",
"keys": [
{
"code": "NZD"
}
],
"label": "NZD"
},
"uniqueText": "b7bd6600-eda4-4f23-9921-b0d55070ece1"
},
"taxAmount": {
"@type": "Monetary",
"decimalValue": "201.92",
"currency": {
"@type": "DataReference",
"schemaName": "limber",
"shapeName": "CurrencyUnit",
"iri": "https://schema.limbergraph.com/limber/CurrencyUnit#NZD",
"keys": [
{
"code": "NZD"
}
],
"label": "NZD"
},
"uniqueText": "2716e5f2-9841-4140-9b48-5af035de53db"
},
"billingDocumentDate": "2022-05-03T00:00:00Z",
"billingDocumentType": "F2",
"customerAccount": {
"@type": "DataReference",
"schemaName": "limber",
"shapeName": "CustomerAccount",
"iri": "https://schema.limbergraph.com/limber/CustomerAccount#4d4429c0-b137-4db3-b114-d9d7133d9727",
"keys": [
{
"accountCode": "SapS4-1000647::6900::10::03"
},
{
"uniqueText": "4d4429c0-b137-4db3-b114-d9d7133d9727"
}
],
"label": "SapS4-1000647::6900::10::03"
},
"billingDocumentLifeCycle": {
"@type": "DataReference",
"schemaName": "limber",
"shapeName": "BillingDocumentLifeCycle",
"iri": "https://schema.limbergraph.com/limber/BillingDocumentLifeCycle#Completed",
"keys": [
{
"code": "Completed"
}
],
"label": "Completed"
},
"businessPartner": [
{
"@type": "BusinessPartner",
"businessPartnerRole": [
{
"@type": "DataReference",
"schemaName": "limber",
"shapeName": "BusinessPartnerRole",
"iri": "https://schema.limbergraph.com/limber/BusinessPartnerRole#Buyer",
"keys": [
{
"code": "Buyer"
}
],
"label": "Buyer"
},
{
"@type": "DataReference",
"schemaName": "limber",
"shapeName": "BusinessPartnerRole",
"iri": "https://schema.limbergraph.com/limber/BusinessPartnerRole#Payer",
"keys": [
{
"code": "Payer"
}
],
"label": "Payer"
}
],
"uniqueText": "6c1cf08c-6ab4-4112-9b6a-35d2987d9877"
},
{
"@type": "BusinessPartner",
"businessPartnerRole": [
{
"@type": "DataReference",
"schemaName": "limber",
"shapeName": "BusinessPartnerRole",
"iri": "https://schema.limbergraph.com/limber/BusinessPartnerRole#Receiver",
"keys": [
{
"code": "Receiver"
}
],
"label": "Receiver"
}
],
"uniqueText": "9dc690ad-6599-4a83-be92-7bda9d38143b"
},
{
"@type": "BusinessPartner",
"code": "6900",
"businessPartnerRole": [
{
"@type": "DataReference",
"schemaName": "limber",
"shapeName": "BusinessPartnerRole",
"iri": "https://schema.limbergraph.com/limber/BusinessPartnerRole#Seller",
"keys": [
{
"code": "Seller"
}
],
"label": "Seller"
}
],
"uniqueText": "943e327d-3017-4a06-b6b9-b5265e93ab2f"
}
],
"txDocItem": [
{
"@type": "BillingDocumentItem",
"lineNumber": "10",
"taxRate": "100.96",
"grossAmount": {
"@type": "Monetary",
"decimalValue": "673.08",
"currency": {
"@type": "DataReference",
"schemaName": "limber",
"shapeName": "CurrencyUnit",
"iri": "https://schema.limbergraph.com/limber/CurrencyUnit#NZD",
"keys": [
{
"code": "NZD"
}
],
"label": "NZD"
},
"uniqueText": "b458764b-80d3-4375-83ad-da99f4223c1f"
},
"netAmount": {
"@type": "Monetary",
"decimalValue": "673.08",
"currency": {
"@type": "DataReference",
"schemaName": "limber",
"shapeName": "CurrencyUnit",
"iri": "https://schema.limbergraph.com/limber/CurrencyUnit#NZD",
"keys": [
{
"code": "NZD"
}
],
"label": "NZD"
},
"uniqueText": "9c520fb1-ea5f-4f4c-afce-b38dbcdd4022"
},
"costAmount": {
"@type": "Monetary",
"decimalValue": "533.64",
"currency": {
"@type": "DataReference",
"schemaName": "limber",
"shapeName": "CurrencyUnit",
"iri": "https://schema.limbergraph.com/limber/CurrencyUnit#NZD",
"keys": [
{
"code": "NZD"
}
],
"label": "NZD"
},
"uniqueText": "f06264ae-571e-4a10-8542-80213e130dcb"
},
"catalogItem": {
"@type": "DataReference",
"schemaName": "limber",
"shapeName": "Product",
"iri": "https://schema.limbergraph.com/limber/Product#7e268780-e30b-42bf-b014-dc2c1f536a15",
"keys": [
{
"uniqueText": "7e268780-e30b-42bf-b014-dc2c1f536a15"
}
],
"label": "My Example Product 1"
},
"quantity": {
"@type": "Magnitude",
"decimalValue": "12",
"uom": {
"@type": "DataReference",
"schemaName": "limber",
"shapeName": "UnitOfMeasure",
"iri": "https://schema.limbergraph.com/limber/UnitOfMeasure#each",
"keys": [
{
"code": "each"
}
],
"label": "each"
},
"uniqueText": "74da23e9-284d-4798-8928-fb87461fac03"
},
"priceElement": [
{
"@type": "PriceElement",
"adjustmentAmount": {
"@type": "Monetary",
"decimalValue": "56.09",
"currency": {
"@type": "DataReference",
"schemaName": "limber",
"shapeName": "CurrencyUnit",
"iri": "https://schema.limbergraph.com/limber/CurrencyUnit#NZD",
"keys": [
{
"code": "NZD"
}
],
"label": "NZD"
},
"uniqueText": "b298881e-d0a2-4721-80ee-f2c2743f7bb7"
},
"priceElementType": {
"@type": "DataReference",
"schemaName": "limber",
"shapeName": "PriceElementType",
"iri": "https://schema.limbergraph.com/limber/PriceElementType#ListAmount",
"keys": [
{
"code": "ListAmount"
}
],
"label": "ListAmount"
},
"uniqueText": "7ebe6b8a-e53a-4acc-aa1e-998e2075290b"
},
{
"@type": "PriceElement",
"adjustmentAmount": {
"@type": "Monetary",
"decimalValue": "100.96",
"currency": {
"@type": "DataReference",
"schemaName": "limber",
"shapeName": "CurrencyUnit",
"iri": "https://schema.limbergraph.com/limber/CurrencyUnit#NZD",
"keys": [
{
"code": "NZD"
}
],
"label": "NZD"
},
"uniqueText": "b9e66630-d4e4-447f-8515-f2f47754a266"
},
"priceElementType": {
"@type": "DataReference",
"schemaName": "limber",
"shapeName": "PriceElementType",
"iri": "https://schema.limbergraph.com/limber/PriceElementType#Tax",
"keys": [
{
"code": "Tax"
}
],
"label": "Tax"
},
"uniqueText": "38efa4bd-5ce9-4735-8b24-8fd7b0be6aa6"
},
{
"@type": "PriceElement",
"adjustmentAmount": {
"@type": "Monetary",
"decimalValue": "44.47",
"currency": {
"@type": "DataReference",
"schemaName": "limber",
"shapeName": "CurrencyUnit",
"iri": "https://schema.limbergraph.com/limber/CurrencyUnit#NZD",
"keys": [
{
"code": "NZD"
}
],
"label": "NZD"
},
"uniqueText": "0971689a-8dc0-4b61-9a90-2f1c04499abc"
},
"priceElementType": {
"@type": "DataReference",
"schemaName": "limber",
"shapeName": "PriceElementType",
"iri": "https://schema.limbergraph.com/limber/PriceElementType#Cost",
"keys": [
{
"code": "Cost"
}
],
"label": "Cost"
},
"uniqueText": "f423f760-c697-491d-9f96-56b82855e07b"
}
],
"uniqueText": "aff1f435-02ad-46d2-967c-965f90a4b76c"
},
{
"@type": "BillingDocumentItem",
"lineNumber": "20",
"taxRate": "100.96",
"grossAmount": {
"@type": "Monetary",
"decimalValue": "673.08",
"currency": {
"@type": "DataReference",
"schemaName": "limber",
"shapeName": "CurrencyUnit",
"iri": "https://schema.limbergraph.com/limber/CurrencyUnit#NZD",
"keys": [
{
"code": "NZD"
}
],
"label": "NZD"
},
"uniqueText": "c6e5207f-d1ba-4a2b-9690-c07b960de959"
},
"netAmount": {
"@type": "Monetary",
"decimalValue": "673.08",
"currency": {
"@type": "DataReference",
"schemaName": "limber",
"shapeName": "CurrencyUnit",
"iri": "https://schema.limbergraph.com/limber/CurrencyUnit#NZD",
"keys": [
{
"code": "NZD"
}
],
"label": "NZD"
},
"uniqueText": "d73015f2-a89d-4689-b8bb-ef46e6cc3a26"
},
"costAmount": {
"@type": "Monetary",
"decimalValue": "510.12",
"currency": {
"@type": "DataReference",
"schemaName": "limber",
"shapeName": "CurrencyUnit",
"iri": "https://schema.limbergraph.com/limber/CurrencyUnit#NZD",
"keys": [
{
"code": "NZD"
}
],
"label": "NZD"
},
"uniqueText": "76678a51-4852-4c21-8ad6-e7da2dd2ebde"
},
"catalogItem": {
"@type": "DataReference",
"schemaName": "limber",
"shapeName": "Product",
"iri": "https://schema.limbergraph.com/limber/Product#7ab9595a-22e7-47f6-b893-e9b7bcd7d577",
"keys": [
{
"sku": "30000782"
},
{
"uniqueText": "7ab9595a-22e7-47f6-b893-e9b7bcd7d577"
}
],
"label": "My Example Product 2"
},
"quantity": {
"@type": "Magnitude",
"decimalValue": "12",
"uom": {
"@type": "DataReference",
"schemaName": "limber",
"shapeName": "UnitOfMeasure",
"iri": "https://schema.limbergraph.com/limber/UnitOfMeasure#each",
"keys": [
{
"code": "each"
}
],
"label": "each"
},
"uniqueText": "352722b3-d35b-4486-9e9d-f510b788a691"
},
"priceElement": [
{
"@type": "PriceElement",
"adjustmentAmount": {
"@type": "Monetary",
"decimalValue": "56.09",
"currency": {
"@type": "DataReference",
"schemaName": "limber",
"shapeName": "CurrencyUnit",
"iri": "https://schema.limbergraph.com/limber/CurrencyUnit#NZD",
"keys": [
{
"code": "NZD"
}
],
"label": "NZD"
},
"uniqueText": "d83a386a-659e-4f47-a73e-789c68b81777"
},
"priceElementType": {
"@type": "DataReference",
"schemaName": "limber",
"shapeName": "PriceElementType",
"iri": "https://schema.limbergraph.com/limber/PriceElementType#ListAmount",
"keys": [
{
"code": "ListAmount"
}
],
"label": "ListAmount"
},
"uniqueText": "f07ea506-8703-40c1-9cf1-41303b27d237"
},
{
"@type": "PriceElement",
"adjustmentAmount": {
"@type": "Monetary",
"decimalValue": "100.96",
"currency": {
"@type": "DataReference",
"schemaName": "limber",
"shapeName": "CurrencyUnit",
"iri": "https://schema.limbergraph.com/limber/CurrencyUnit#NZD",
"keys": [
{
"code": "NZD"
}
],
"label": "NZD"
},
"uniqueText": "8ff82635-c453-4ebe-8802-f3dbfa81399f"
},
"priceElementType": {
"@type": "DataReference",
"schemaName": "limber",
"shapeName": "PriceElementType",
"iri": "https://schema.limbergraph.com/limber/PriceElementType#Tax",
"keys": [
{
"code": "Tax"
}
],
"label": "Tax"
},
"uniqueText": "85a2d823-fe6d-400b-9ef0-8c91bad7a1ae"
},
{
"@type": "PriceElement",
"adjustmentAmount": {
"@type": "Monetary",
"decimalValue": "42.51",
"currency": {
"@type": "DataReference",
"schemaName": "limber",
"shapeName": "CurrencyUnit",
"iri": "https://schema.limbergraph.com/limber/CurrencyUnit#NZD",
"keys": [
{
"code": "NZD"
}
],
"label": "NZD"
},
"uniqueText": "3299a72a-e6eb-4805-a9e9-7ea7b91f278e"
},
"priceElementType": {
"@type": "DataReference",
"schemaName": "limber",
"shapeName": "PriceElementType",
"iri": "https://schema.limbergraph.com/limber/PriceElementType#Cost",
"keys": [
{
"code": "Cost"
}
],
"label": "Cost"
},
"uniqueText": "b66c9842-7e26-450d-8bef-e78c431f3fef"
}
],
"uniqueText": "50cdd300-3ad3-49ae-9cbd-17df239dda26"
}
],
"uniqueText": "0003ee15-2e80-479d-bf24-9fdc5b3d005b",
"@version": 1
}