bringing UBL "billing" documents in sync

All,

As part of the analysis of tickets UBL-44, UBL-60 and UBL-137 I have looked at all the billing documents in UBL and see where they are “not in sync” with each other.

I have looked at the following billing documents:

Invoice

CreditNote

SelfBilledInvoice

SelfBilledCreditNote

FreightInvoice

I have done a comparison of the various UBL elements that are in these documents on “header level”.

This is the result:

cbc:DueDate

This is only available in Invoice, and not in the other documents.

As part of bringing all billing documents in sync I would propose to add this the the 4 other billing documents (preferably at the same “position” as invoice)

cbc:InvoiceTypeCode / cbc:CreditNoteTypeCode

In all documents except SelfBilledCreditNote there is a “TypeCode” element.

I would propose to add the cbc:CreditNoteTypeCode to the SelfBilledCreditNote to bring it in line with the normal CreditNote Document.

cbc:BuyerReference

This element is available in Invoice and CreditNote, but not in the SelfBilled equivalents.

I would propose to add this to both SelfBilledInvoice and SelfBilledCreditNote

I would NOT include It in the FreightInvoice to avoid confusion about “Buyer” in the FreightInvoice context.

cac:DiscrepancyResponse

This element is available in both the CreditNote and SelfBilledCreditNote, not in the other documents

I would propose to leave this .. because this is a specific element that is only relevant in the CreditNote context as far as I can tell.

cac:Shipment

This element is only available in the FreightInvoice, and is the only real element that is different with a “normal” invoice.

I would NOT add this to the other documents to keep the separate status of FreightInvoice.

cac:StatementDocumentReference

This element is missing from the FreightInvoice.

As far as I can tell the statements can not be used for “Freight” purpuses .. so not having this on the FreightInvoice makes sense

cac:ProjectReference

This element is only available in the Invoice, not in the other 4 billing documents.

I would propose to add this element also to all the other billing documents.

cac:BuyerCustomerParty / cac:SellerSupplierParty

These two element are not available in the FreightInvoice

It makes sense that they are NOT in the freightInvoice, but what would be the equivalants for Freight? Based on TransportExecutionPlan(Request)Type I would think TransportUserParty / TransportServiceProviderParty but I would leave that discussion for 2.3

cac:Delivery / cac:DeliveryTerms

These elements are not available in the FreighInvoice

I would NOT add them to FreightInvoice, as that they are really “Ordering” related

cac:PrepaidPayment

This element is not available in the CreditNote and SelfBilledCreditNote

But it makes sense that it is NOT there, because prepaying your credit … that does not make sense at all J

cac:WithholdingTaxTotal

This element is only available in the Invoice not in the other documents

I would propose that we also add this to all the other elements to bring the WithHoldingTax handling on all documents in line with each other.

Please lets discuss this in today call.

Kees D.

ubl message