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
}

Billing Document

Summary​

Schema​

Relationships​

Data Definitions​

BillingDocument​

BillingDocumentItem​

Sample JSON​