W3C home > Mailing lists > Public > public-vocabs@w3.org > December 2014

Re: [Proposal]: New schema for Invoices

From: Martin Hepp <martin.hepp@unibw.de>
Date: Mon, 15 Dec 2014 18:09:06 +0100
Cc: W3C Web Schemas Task Force <public-vocabs@w3.org>
Message-Id: <38203AC4-05E9-4CF5-86E6-D8D7B393CEFF@unibw.de>
To: Vicki Tardif Holland <vtardif@google.com>
Hi Vicki:

Thanks - such an entity was indeed missing. A few questions:

1. With invoice, do you mean a) a receipt of payment b) a document representing a payment request or c) the union of both. In other words, how is an invoice related to (1) an actual payment, (2) a legal obligation to pay a certain amount, and (3) an underlying transfer of rights that causes the obligation to pay a compensation?

2. How is an invoice linked to a) http://schema.org/Offer and b) the subtypes of http://schema.org/TradeAction, like
- http://schema.org/BuyAction 
- http://schema.org/PayAction
- http://schema.org/RentAction
- http://schema.org/SellAction
- http://schema.org/TipAction

I can imagine invoices without either one, e.g. invoices without offer nor transaction for prepayments or advances.

But if the entities exist, they should be linkable.

3. I think we should have a method for including a list of items in the invoice. One could define a new property "itemsIncluded" with an ItemList that links to entities of the type of http://schema.org/TypeAndQuantityNode.

4. Currently, the support for modeling tax information in price information in schema.org and GoodRelations is pretty simple; we may want to expand this part and add it to Invoice, too, because e.g. the ability to expose VAT rates and absolute values may be very relevant for European users.

5. Also, we currently have no model for staged payments and financing in GoodRelations and schema.org; this will also touch Invoice (image a car invoice with a single down payment and four installments with individual due dates).


martin hepp
e-business & web science research group
universitaet der bundeswehr muenchen

e-mail:  martin.hepp@unibw.de
phone:   +49-(0)89-6004-4217
fax:     +49-(0)89-6004-4620
www:     http://www.unibw.de/ebusiness/ (group)
         http://www.heppnetz.de/ (personal)
skype:   mfhepp 
twitter: mfhepp

On 15 Dec 2014, at 17:43, Vicki Tardif Holland <vtardif@google.com> wrote:

> Schema.org currently has schema.org/Offer for offering items for sale/lease. It has schema.org/Order to model when a purchase has been made, but there is no type for marking up Invoices requesting payment.
> To that end, we are proposing adding a new type: schema.org/Invoice where an invoice is defined as "a statement of the money due for goods or services; a bill."
> The new Invoice type has the following properties:
>   - accountId
>   - billingPeriod
>   - broker
>   - category
>   - confirmationNumber
>   - customer
>   - minimumPaymentDue
>   - payFromAccountId
>   - paymentDue
>   - paymentStatus
>   - provider
>   - scheduledPaymentDate
>   - totalPaymentDue
> I have added the new type and properties to my github repository. Details (including descriptions) can be found at 

> Comments are welcome,
> Vicki
> Vicki Tardif Holland | Ontologist | vtardif@google.com 
Received on Monday, 15 December 2014 17:09:36 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 21:29:46 UTC