三分一技術士事務所

Nobuyuki SAMBUICHI
ISO/TC295 Audit data services/SG1 Semantic model Convener

説明文が改悪されています。

IBT-114 Rounding amount (丸めるための金額)

Ver 0.9.3
The amount to be added to the invoice total to round the amount to be paid.
支払金額に丸めるために請求書の合計金額に追加される金額。

だった記述が次の内容に

Ver 1.0
Syntax required attribute, value must equal invoice document currency (ibt-005)

これは@currencyIDの説明文なので、元の記述が正しい。

Semantic datatype が Amount の Business Trem に対応するXML要素には@currencyID属性が必須であり、それぞれが invoice document currency (ibt-005)なのか Tax currency code (ibt-006)なのかが説明されている。

Syntax required attribute, value must equal invoice document currency (ibt-005)

Syntax required attribute, value must equal invoice Tax currency code (ibt-006)

IBT-176 Terms amount（支払条件金額）の@currencyIDが定義されておらず、説明されていない。
IBT-180 Paid amount（支払済金額）も@currencyIDが定義されておらず、説明されていない。

Syntax bindingが表示するXML属性のページにそのXML属性が定義されているXML要素が対応しているBusiness Termも表示されています。
このため次の画面では、@schemeIDが対応するBusiness Termが２つあるという表示になっています。

正しい対応関係を表示するのであれば、次の画面では、@schemeIDが対応するBusiness Termは、
IBT-018-1 – The identification scheme identifier of the Invoiced object identifier.
だけです。

XML属性のページにそのXML属性が定義されているXML要素が対応しているBusiness Termも表示するのであれば、その旨の説明がBIS文書中になければ読者は理解できません。

それぞれに対応するXPathと合わせて表示すると次のようになっています。

IBT-018 – Invoiced object identifier
/Invoice/cac:AdditionalDocumentReference[cbc:DocumentTypeCode=’130′]/cbc:ID

IBT-018-1 – The identification scheme identifier of the Invoiced object identifier.
/Invoice/cac:AdditionalDocumentReference[cbc:DocumentTypeCode=’130′]/cbc:ID/@schemeID

IBT-018-1も含めて、次の属性がXML要素の対応先と合わせて表示されているが、これらは、XML属性の対応先に限定しないと正しいSyntax bindingの記載ではありません。

IBT-125 – Attached document
IBT-125-1 – Attached document Mime code

IBT-125 – Attached document
IBT-125-2 – Attached document Filename

IBT-034 – Seller electronic address
IBT-034-1 – Scheme identifier

IBT-029 – Seller identifier
IBT-029-1 – Scheme identifier

IBT-030 – Seller legal registration identifier
IBT-030-1 – Scheme identifier

IBT-049 – Buyer electronic address
IBT-049-1 – Scheme identifier

IBT-046 – Buyer identifier
IBT-046-1 – Scheme identifier

IBT-047 – Buyer legal registration identifier
IBT-047-1 – Scheme identifier

IBT-060 – Payee identifier
IBT-060-1 – Scheme identifier

IBT-061 – Payee legal registration identifier
IBT-061-1 – Scheme identifier

IBT-071 – Deliver to location identifier
IBT-071-1 – Scheme identifier

IBT-083 – Remittance information
IBT-083-1 – Scheme identifier

IBT-084 – Payment account identifier
IBT-084-1 – Scheme identifier

IBT-128 – Invoice line object identifier
IBT-128-1 – Scheme identifier

IBT-157 – Item standard identifier
IBT-157-1 – Scheme identifier

IBT-158 – Item classification identifier
IBT-158-1 – Scheme identifier

IBT-158 – Item classification identifier
IBT-158-2 – Scheme version identifier

なお、次のXML属性については、対応するBusiness Termとして記載されているのは、それぞれ一つだけです。
公開されているページの記載内容についての規定が文書として公開されておらず、このページを表示するだけでは標準仕様とはなりません。

IBT-082 – Payment means text

IBT-130 – Invoiced quantity unit of measure code

IBT-150 – Item price base quantity unit of measure code

XML属性の対応先をXML要素の対応先と合わせて表示するのであれば、次の表示とすべき。

ibt-081 – Payment means type code
ibt-082 – Payment means text
/Invoice/cac:PaymentMeans/cbc:PaymentMeansCode
/Invoice/cac:PaymentMeans/cbc:PaymentMeansCode/@name

ibt-129 – Invoiced quantity
ibt-130 – Invoiced quantity unit of measure code
/Invoice/cac:InvoiceLine/cbc:InvoicedQuantity
/Invoice/cac:InvoiceLine/cbc:InvoicedQuantity/@unitCode

ibt-149 – Item price base quantity
ibt-150 – Item price base quantity unit of measure code
/Invoice/cac:InvoiceLine/cac:Price/cbc:BaseQuantity
/Invoice/cac:InvoiceLine/cac:Price/cbc:BaseQuantity/@unitCode

Syntax bindingのページの説明文は、EN 16931-1 Table 2 Usage Note欄からの引用です。文章中の”the UNTDID 1153 code list [6] entries”は、規格の Bibriographyの文献を参照しています。

BIS Billing 3.0は、EN 16931-1に準拠していると宣言していましたので、[6]が規格の Bibriographyの文献を参照していても読者は理解できましたが、PINTは、EN 16931シリーズの規格ではなく、まだ存在しない”Peppol International model”に準拠しているそいうですので、[6]でEN 16931-1 のBibriographyの文献を参照したままなのはいかがなものでしょうか。EN 16931シリーズの規格との関連を明確に規定すべきです。

CEN/TS 16931-3-2 Electronic invoicing – Part 3-2: Syntax binding for ISO/IEC 19845 (UBL 2.1) invoice and credit note がSyntax biunding の欧州規格です。EN 16931-1では、BT-18にまとめてTable 2に記載されていましたが、Syntax biunding の対応付けは、XML要素とXML属性に分けてそれぞれBT-18およびBT-18-1の対応を定義しています。

Table 3 — Semantic model to UBL invoice syntax elements mapping (normative)では、BT-18のRules欄に with cbc:DocumentTypeCode = 130 の説明文を記載していますが、人が読んで理解して対応変換処理をプログラミングすることを期待しているようです。このように文章で表現するよりも、XMLが標準提供している XPathで次のように記述してあれば、機械的に変換処理を実装可能となります。

IBT-018 – Invoiced object identifier
/Invoice/cac:AdditionalDocumentReference[cbc:DocumentTypeCode=’130′]/cbc:ID

IBT-018-1 – The identification scheme identifier of the Invoiced object identifier.
/Invoice/cac:AdditionalDocumentReference[cbc:DocumentTypeCode=’130′]/cbc:ID/@schemeID

JP PINTでwith cbc:DocumentTypeCode = 130 の説明文がないのは、BIS Billing 3.0も同様なのでibt-018 Invoiced object identifier （請求するオブジェクトID）のcbc:DocumentTypeCodeに’130’以外も使用可能としたのか、単なる記述もれか判断に苦しむところです。

次のSharedルールで、cbc:DocumentTypeCode = ‘130’ を条件としているのは、ibt-018 Invoiced object identifier （請求するオブジェクトID）のcbc:DocumentTypeCodeが’130’であることが前提とされているからだと思います。

ibg-24 ADDITIONAL SUPPORTING DOCUMENTS（添付書類）には、次のSelector条件が指定されています。
cbc:DocumentTypeCode != 130

https://docs.peppol.eu/poac/jp/pint-jp/trn-invoice/syntax/cac-AdditionalDocumentReference-2/

この条件をふまえると、ibt-125 Attached document（添付書類）は次のXPathです。
/Invoice/cac:AdditionalDocumentReference[not(cbc:DocumentTypeCode=’130′)]/cac:Attachment/cbc:EmbeddedDocumentBinaryObject

こうしたことから、単なる記述漏れと思われます。

ibt-018 Invoiced object identifier （請求するオブジェクトID）とibg-24 ADDITIONAL SUPPORTING DOCUMENTS（添付書類）はどちらも、
/Invoice/cac:AdditionalDocumentReference
を使用します。
文書参照では、国連のコードリスト1001 UN/EDIFACT 1001 Document name code (Code specifying the document name.) から選択したコードを cbc:DocumentTypeCode の値として指定することで、どのような種類の文書を参照しているのか指定します。

インボイスのDocument name code 380もこのコードリスト1001で定義されており、130は次の定義です。

その後、調べなおしたところ次のページに記載されていました。

「他の場所に記載されています。」ではなく、IBT-018のページにXPathで説明していただきたいと思います。

/Invoice/cac:AdditionalDocumentReference[cbc:DocumentTypeCode=’130′]/cbc:ID

XMLでインスタンス文書中のXML要素や属性を選択する表現がXPathです。

XML Path Language (XPath) 2.0 (Second Edition)
W3C Recommendation 14 December 2010 (Link errors corrected 3 January 2011; Status updated October 2016)

PINTにおけるSelector指定には、このXPathを理解しているのか疑問になる表現がいくつも残っています。

『JP PINT Syntax binding の Selectorとは何ですか？』
『JP PINT 0.9.3 Seller TAX identifierのSelector \[cac:TaxScheme = ‘VAT’]は誤りです』

『JP PINT 解体新書2 JP PINTは適格請求書?』で紹介したJapan PINT Invoice UBL Example1-minimum.xmlに対して、XML編集ソフト XML SpyでXPathを実行した結果を次の図で示します。

cac:TaxTotal の　Selector が cac:TaxTotal/TaxAmount/@currency = cbc:DocumentCurrencyCode とされています。

/Invoice/cac:TaxTotal[cac:TaxTotal/TaxAmount/@currency = cbc:DocumentCurrencyCode] と指定しても、The expression did not return any items. で何も見つかりません。

正しいSelector条件は、

cbc:TaxAmount/@currencyID=/*/cbc:DocumentCurrencyCode

です。

/Invoice/cac:TaxTotal[cbc:TaxAmount/@currencyID=/*/cbc:DocumentCurrencyCode] と指定すると目的のcac:TaxTotalが見つかります。

Selector条件は、読者になんとなくわかってもらうためのものでなく、ソフトウエアが正しく処理するための条件とすべきです。 人が読んで何となく分かったようでもプログラムでは処理できません。+
XPathを正しく理解したうえで公開前に十分なテストを行うことが必要ではないでしょうか。

次の表は、Syntax bindingで記載されているUBL element と Selector とその改善ポイントです。

なお、明細行のIBT-147　Item price discount　品目単価値引(税抜き)を含むcac:AllowanceChargeは、cbc:ChargeIndicatorがfalse()に制限されていますので、cac:AllowanceCharge[cbc:ChargeIndicator=false()]がSelector条件に必要ではないでしょうか。

また、IBT-029 Seller identifierにはSelectorが定義されていないが、/Invoice/cac:PartyIdentificationは、IBT-090 Bank assigned creditor identifier も同じ要素を使用しているので、区別するためにSelectorが必要ではないでしょうか。

cac:PartyIdentification[cbc:ID/@schemeID!=’SEPA’]