XML structures of eBIZ/TC Upstream documents (Draft)

Introduction to the XML document template

The structure of the XML documents is the very prescriptive part of the eBIZ/TC Upstream framework: using the eBIZ/TC Upstream documents, the prescriptions must be completely respected about structure of the documents, names and coding, optionality or mandatory use of elements, meaning of each element.
Otherwise the documents could be not validable with the XML Schema (that are the only way to check the formal compliance of the documents) or could generate misunderstandings about the meaning of the message on the side of your partners.
The allowable customisations are about the use or not of a document or about the elements of the document that are declared 'optional'; they can be used to simplify the documents (not all the elements are always necessary).

The (template of) eBIZ/TC Upstream documents of each release are on www.ebiz.enea.it or www.moda-ml.org and are represented by:

XML Schemas, public but that cannot be modified, they must be used to validate the XML documents.
User Guides, that completely describe the structure and the aim of the documents, together with the elements and their coding rules.
Compare version User Guides, with comparison against the previous version of the same document (available for this version: FALSE).
Equivalent JSON schema towards XML Schema of the document (available for this version: TRUE).
in some cases, Samples and Stylesheets(XSL) might be available and can be used to visualize with a browser the content of the XML documents. The proposed stylesheets should be considered as a sample or a reference to be used directly or customised or ignored and substituted with custom stylesheets.

release 11/ott/2022

		Document Document Availability Advise
Document		Document Availability Advise (New)
Description		Document Availability Advise, contains a list of references to documents that are currently available.
Release date		28/05/2022
Scope		This guide aims to illustrate to fashion companies the standard XML format of the document type "NEW DOCUMENT ADVISE", providing instructions for its use in the context of a TRACEABILITY SYSTEM involving Fashion Manufacturers, their customers, third parties and in case customs authorities, eBusiness and eCommerce platforms. All the rules necessary for the construction and validation of the document are expressed through a specific XML schema, which is presented in detail in the paragraph "Implementation Guide".
Generalities		This document is intended to inform a party, be it a company or a service platform, that one or more (new) documents are available and to provide some metadata, including information on where they can be found. For each reported document, among the metadata, there is a flag that indicates whether the availability of the document requires taking some specific action, indications on any document to which it refers and finally an indication of traceable objects to which it refers. The document could be included in the message as a binary object, choice not recommended for practical reasons, or it could be indicated with a file name or with an external reference though a URI.
Credits		This document was produced by Piero De Sabbata, Arianna Brutti e Gessica Ciaccio for ENEA X-LAB with the contribution of the partners of the TRICK project.
Back compatibility		New
Document Code		TRC005
Resources		[Guide] [XML Schema] [JSON Schema]
Specific for TRICK Document: Document Availability Advise		An alert is sent to the producer to advise him about a new document on TRICK related to raw material availability at the supplier facility. In this way he can connect to the platform and get the contents of this file.
Resources specific for TRICK		[Guide - Specific for TRICK]
Used in Processes		P1. Sustainability Tracing

		Document Fashion Catalogue
Document		Fashion Catalogue
Description		Trade document containing the prices and the technical properties of the FASHION articles offered by the manufacturer
Release date		05/11/2018
Scope		The present guide has been issued to assist the companies of the Fashion sector in the implementation of the standard XML document type FASHION CATALOGUE”, providing all the instruction required for its use in any context of e-commerce between Fashion Producers and their customers and eBusiness and eCommerce platforms. All the rules required for the construction and validation of the document are embedded into the specific XML-Schema, which is detailed in section "Implementation guide".
Generalities		This document is usable as a catalog (showcase / offer) as well as to exchange in advance the product data between Suppliers and Customers, in order to allow the synchronization of the corresponding data-base. . Furthermore, a Producer can use it to publish is offer on ePlatforms. It contains the items that compose the Fashion Manufacturer's offer (codes, descriptions, prices and terms of sale) and may include some technical-descriptive data of the product (trade name, composition, weight and height, …) as well as marketing information (images, verbose descriptions, …)
Credits		This XML document was created by Arianna Brutti with the support of Piero De Sabbata (ENEA) in collaboration with Francesco Melani and Simone Gabellini (Kykos), Virginia Fani (University of Florence) as part of the eBIZ 4.0 project.
Back compatibility		Unchanged
Document Code		G080
Resources		[Guide] [XML Schema] [JSON Schema] [XSL] [XML+XSL]
Resources specific for TRICK		[Guide - Specific for TRICK]
Used in Processes		P1. Sustainability Tracing S3 PEF and environmental footprint service S4 Health protection assessment service S5 Social and Ethical protection assessment service Sales on eService

		Document Health Protection Information
Document		Health Protection Information (New)
Description		Health Protection Information, contains information to accomplish the Health Protection and Assessment service.
Release date		06/09/2022
Scope		This guide aims to illustrate the standard XML format of the document type "Health Protection Information", providing instructions for its use in the context of a TRANSPARENCY SYSTEM involving Fashion Manufacturers, their customers, third parties and in case customs authorities, eBusiness and eCommerce platforms. All the rules necessary for the construction and validation of the document are expressed through a specific XML schema, which is presented in detail in the paragraph "Implementation Guide".
Credits		This document was produced by Piero De Sabbata, Arianna Brutti e Gessica Ciaccio for ENEA X-LAB with the contribution of the partners of the TRICK project.
Back compatibility		New
Document Code		TRC008
Diagrams		+
Resources		[Guide] [XML Schema] [JSON Schema]
Used in Processes		S4 Health protection assessment service

		Document Health Protection Preliminary Information
Document		Health Protection Preliminary Information (New)
Description		Health Protection Preliminary Information, contains preliminary information to start the Health Protection and Assessment service.
Release date		06/09/2022
Scope		This guide aims to illustrate the standard XML format of the document type "Health Protection Preliminary Information", providing instructions for its use in the context of a TRANSPARENCY SYSTEM involving Fashion Manufacturers, their customers, third parties and in case customs authorities, eBusiness and eCommerce platforms. All the rules necessary for the construction and validation of the document are expressed through a specific XML schema, which is presented in detail in the paragraph "Implementation Guide".
Credits		This document was produced by Piero De Sabbata, Arianna Brutti e Gessica Ciaccio for ENEA X-LAB with the contribution of the partners of the TRICK project.
Back compatibility		New
Document Code		TRC006
Diagrams		+
Resources		[Guide] [XML Schema] [JSON Schema]
Used in Processes		S4 Health protection assessment service

		Document Indicators declaration
Document		Indicators declaration (New)
Description		Results of the assessment performed by the service, includes the study as a separate document attached and, in case, a list of calculated indicators, possibly publishable.
Release date		06/09/2022
Scope		This guide aims to illustrate the standard XML format of the document type that declares a list of indicators calculated by a service, providing instructions for its use in the context of a TRANSPARENCY SYSTEM involving Fashion Manufacturers, their customers, third parties and in case customs authorities, eBusiness and eCommerce platforms. All the rules necessary for the construction and validation of the document are expressed through a specific XML schema, which is presented in detail in the paragraph "Implementation Guide".
Credits		This document was produced by Piero De Sabbata, Arianna Brutti e Gessica Ciaccio for ENEA X-LAB with the contribution of the partners of the TRICK project.
Back compatibility		New
Document Code		TRC009
Resources		[Guide] [XML Schema] [JSON Schema]
Used in Processes		S3 PEF and environmental footprint service S4 Health protection assessment service S5 Social and Ethical protection assessment service

		Document Party Information
Document		Party Information
Description		The "Party Information" document is used to communicate information about people or companies.
Release date		05/11/2018
Scope		This guide is intended to illustrate to FASHION companies the standard XML form of the document type "Party Information", providing instructions for its use in any context of electronic commerce between different subjects of the production and sales chain. All the rules necessary for the construction and validation of the document are expressed through a specific XML schema, which is presented in detail in the paragraph "Implementation Guide".
Generalities		The message is issued to communicate information about people or organisations (for example, lists of customers enabled to operate on an eCommerce site). The sender forwards this document when he has to feed a registry of persons or organizations. Main function of the message is transferring information about people or companies: personal or business data (name, address, contacts, billing information, categories of belonging to subjects useful for commercial purposes).
Credits		This XML document was created by Arianna Brutti with the support of Piero De Sabbata (ENEA) in collaboration with Giuliano Dal Brun and Elisa Sciascia (Cotonificio Monti), Manuel Toniato e Ilenia Trevisan (Develon). This XML document & egrave; updated by Arianna Brutti with the support of Piero De Sabbata (ENEA) in collaboration with Francesco Melani and Simone Gabellini (Kykos), Virginia Fani (Università scope of the eBIZ 4.0 project.
Back compatibility		Unchanged
Document Code		G079
Resources		[Guide] [XML Schema] [JSON Schema] [XSL] [XML+XSL]
Resources specific for TRICK		[Guide - Specific for TRICK]
Used in Processes		P1. Sustainability Tracing S3 PEF and environmental footprint service S4 Health protection assessment service S5 Social and Ethical protection assessment service Sales on eService

		Document PEF and environmental footprint Information
Document		PEF and environmental footprint Information (New)
Description		PEF and environmental footprint Assessment Information, contains information to accomplish the PEF and environmental footprint Assessment service.
Release date		06/09/2022
Scope		This guide aims to illustrate the standard XML format of the document type "PEF and environmental footprint Information", providing instructions for its use in the context of a TRANSPARENCY SYSTEM involving Fashion Manufacturers, their customers, third parties and in case customs authorities, eBusiness and eCommerce platforms. All the rules necessary for the construction and validation of the document are expressed through a specific XML schema, which is presented in detail in the paragraph "Implementation Guide".
Credits		This document was produced by Piero De Sabbata, Arianna Brutti e Gessica Ciaccio for ENEA X-LAB with the contribution of the partners of the TRICK project.
Back compatibility		New
Document Code		TRC013
Diagrams		+
Resources		[Guide] [XML Schema] [JSON Schema]
Used in Processes		S3 PEF and environmental footprint service

		Document PEF and environmental footprint Preliminary Information
Document		PEF and environmental footprint Preliminary Information (New)
Description		PEF and environmental footprint assessment preliminary Information, contains preliminary information to start the PEF and environmental footprint Assessment service.
Release date		06/09/2022
Scope		This guide aims to illustrate the standard XML format of the document type "PEF and environmental footprint Assessment Preliminary Information", providing instructions for its use in the context of a TRANSPARENCY SYSTEM involving Fashion Manufacturers, their customers, third parties and in case customs authorities, eBusiness and eCommerce platforms. All the rules necessary for the construction and validation of the document are expressed through a specific XML schema, which is presented in detail in the paragraph "Implementation Guide".
Credits		This document was produced by Piero De Sabbata, Arianna Brutti e Gessica Ciaccio for ENEA X-LAB with the contribution of the partners of the TRICK project.
Back compatibility		New
Document Code		TRC014
Diagrams		+
Resources		[Guide] [XML Schema] [JSON Schema]
Used in Processes		S3 PEF and environmental footprint service

		Document Reaction to service results
Document		Reaction to service results (New)
Description		User reaction to the results of the assessment performed by the service. Includes disclosure instructions.
Release date		06/09/2022
Scope		This guide aims to illustrate the standard XML format of the document type originated by a service, providing instructions for its use in the context of a TRANSPARENCY SYSTEM involving Fashion Manufacturers, their customers, third parties and in case customs authorities, eBusiness and eCommerce platforms. All the rules necessary for the construction and validation of the document are expressed through a specific XML schema, which is presented in detail in the paragraph "Implementation Guide".
Credits		This document was produced by Piero De Sabbata, Arianna Brutti e Gessica Ciaccio for ENEA X-LAB with the contribution of the partners of the TRICK project.
Back compatibility		New
Document Code		TRC012
Resources		[Guide] [XML Schema] [JSON Schema]
Used in Processes		S3 PEF and environmental footprint service S4 Health protection assessment service S5 Social and Ethical protection assessment service

		Document Service final response
Document		Service final response (New)
Description		Results of the assessment performed by the service, includes the study as a separate document attached and, in case, a list of calculated indicators, possibly publishable.
Release date		06/09/2022
Scope		This guide aims to illustrate the standard XML format of the document type originated by a service, providing instructions for its use in the context of a TRANSPARENCY SYSTEM involving Fashion Manufacturers, their customers, third parties and in case customs authorities, eBusiness and eCommerce platforms. All the rules necessary for the construction and validation of the document are expressed through a specific XML schema, which is presented in detail in the paragraph "Implementation Guide".
Credits		This document was produced by Piero De Sabbata, Arianna Brutti e Gessica Ciaccio for ENEA X-LAB with the contribution of the partners of the TRICK project.
Back compatibility		New
Document Code		TRC009
Resources		[Guide] [XML Schema] [JSON Schema]
Used in Processes		S3 PEF and environmental footprint service S4 Health protection assessment service S5 Social and Ethical protection assessment service

		Document Service Information Request
Document		Service Information Request (New)
Description		Information requested to accomplish the requested service.
Release date		06/09/2022
Scope		This guide aims to illustrate the standard XML format of the document type "Health Protection Information Request", providing instructions for its use in the context of a TRANSPARENCY SYSTEM involving Fashion Manufacturers, their customers, third parties and in case customs authorities, eBusiness and eCommerce platforms. All the rules necessary for the construction and validation of the document are expressed through a specific XML schema, which is presented in detail in the paragraph "Implementation Guide".
Credits		This document was produced by Piero De Sabbata, Arianna Brutti e Gessica Ciaccio for ENEA X-LAB with the contribution of the partners of the TRICK project.
Back compatibility		New
Document Code		TRC007
Resources		[Guide] [XML Schema] [JSON Schema]
Used in Processes		S3 PEF and environmental footprint service S4 Health protection assessment service S5 Social and Ethical protection assessment service

		Document Social and Ethic Accountability Information
Document		Social and Ethic Accountability Information (New)
Description		Social and Ethic Accountability Information, contains information to accomplish the Social and Ethic Accountability Assessment service.
Release date		06/09/2022
Scope		This guide aims to illustrate the standard XML format of the document type originated by a service, providing instructions for its use in the context of a TRANSPARENCY SYSTEM involving Fashion Manufacturers, their customers, third parties and in case customs authorities, eBusiness and eCommerce platforms. All the rules necessary for the construction and validation of the document are expressed through a specific XML schema, which is presented in detail in the paragraph "Implementation Guide".
Credits		This document was produced by Piero De Sabbata, Arianna Brutti e Gessica Ciaccio for ENEA X-LAB with the contribution of the partners of the TRICK project.
Back compatibility		New
Document Code		TRC010
Diagrams		+
Resources		[Guide] [XML Schema] [JSON Schema]
Used in Processes		S5 Social and Ethical protection assessment service

		Document Social and Ethic Accountability Preliminary Information
Document		Social and Ethic Accountability Preliminary Information (New)
Description		Social and Ethic Accountability Preliminary Information, contains preliminary information to start the Social and Ethic Accountability Assessment service.
Release date		06/09/2022
Scope		This guide aims to illustrate the standard XML format of the document type "Social and Ethic Accountabilityn Preliminary Information", providing instructions for its use in the context of a TRANSPARENCY SYSTEM involving Fashion Manufacturers, their customers, third parties and in case customs authorities, eBusiness and eCommerce platforms. All the rules necessary for the construction and validation of the document are expressed through a specific XML schema, which is presented in detail in the paragraph "Implementation Guide".
Credits		This document was produced by Piero De Sabbata, Arianna Brutti e Gessica Ciaccio for ENEA X-LAB with the contribution of the partners of the TRICK project.
Back compatibility		New
Document Code		TRC011
Diagrams		+
Resources		[Guide] [XML Schema] [JSON Schema]
Used in Processes		S5 Social and Ethical protection assessment service

		Document Textile Invoice
Document		Textile Invoice
Description		Invoice used to debit supplies and works or miscellaneous services in the Textile-Clothing industry. It can be also used to credit amounts.
Release date		05/11/2018
Scope		The present guide has been issued to assist the companies of the Textile-Clothing sector in the implementation of the standard XML document type “Textile INVOICE”, providing all the instruction required for its use in any context of e-commerce between Apparel Producers and their partners. All the rules required for the construction and validation of the document are embedded into the specific XML-Schema, which is detailed in section "Implementation guide".
Generalities		The document "Textile invoice" can be used to debit the Client for any kind of supply or service. This document can be used to debit standard supply using the option "texItem", and additional goods or services using the option "prodServItem", even in the same invoice. The use of quantity and unit price is mandatory only with "texItem".
Credits		The first version of this XML document was made in the framework of MODA-ML project by Guido Cucchiara, PROGEMA - Gruppo SOI, supported by Thomas Imolesi and Arianna Brutti, XML-Lab (initiative of ENEA and Forum per la Tecnologia dell'Informazione). Other participants: Alessandro Barberis Canonico (Lanificio Vitale Barberis Canonico), Albino Botto Poala (Lanificio Successori Reda), Gustavo Cametti (Lanificio Piacenza), Massimo Perona (Domina srl), Piero De Sabbata e Piergiorgio Censoni (ENEA) Gianfranco Irico (Lanificio Loro Piana), Luca Mainetti (Politecnico di Milano, Hypermedia Open center), Federico Tamburini e Ivano Begnozzi (Fratelli Corneliani). Subsequent developments in this document have been financed by the TQR consortium, partly self-financed by the partners and the eBIZ 4.0 project More information can be acquired in http://www.ebiz.enea.it.
Back compatibility		Unchanged
Document Code		G011
Resources		[Guide] [XML Schema] [JSON Schema] [XSL] [XML+XSL]
Resources specific for TRICK		[Guide - Specific for TRICK]
Used in Processes		Fabric supply P1. Sustainability Tracing Subcontracted fashion production Subcontracted knitwear production

		Document Traceability Despatching Advice
Document		Traceability Despatching Advice (New)
Description		Traceability Despatching Advise of the goods sent upon any business transaction
Release date		28/05/2022
Scope		This guide aims to illustrate to fashion companies the standard XML format of the document type "TRACEABILITY DESPATCHING ADVISE", providing instructions for its use in the context of a TRACEABILITY SYSTEM involving Fashion Manufacturers, their customers, third parties and in case customs authorities, eBusiness and eCommerce platforms. All the rules necessary for the construction and validation of the document are expressed through a specific XML schema, which is presented in detail in the paragraph "Implementation Guide".
Generalities		The message is issued to record in the traceability system and anticipate to the destinationparty the information of the shipment of the product (it does not indicate the 'ready to send' condition, for this purpose use a normal despatch Advise); it may contain information such as transaction certificates relating to the goods shipped. Each line of Traceability Despatch Advice must indicate the product with a unique code and can specify the Order line or other document to which it refers.
Credits		This document was produced by Piero De Sabbata, Arianna Brutti e Gessica Ciaccio for ENEA X-LAB with the contribution of the partners of the TRICK project.
Back compatibility		New
Document Code		TRC003
Resources		[Guide] [XML Schema] [JSON Schema]
Resources specific for TRICK		[Guide - Specific for TRICK]
Used in Processes		P1. Sustainability Tracing

Document Traceability Receiving Advice

Document

Traceability Receiving Advice
(New)

Description

Traceability Receiving Advise of the goods received upon upon any business transaction

Release date

28/05/2022

Scope

This guide aims to illustrate to fashion companies the standard XML format of the document type "TRACEABILITY RECEIVING ADVISE", providing instructions for its use in the context of a TRACEABILITY SYSTEM involving Fashion Manufacturers, their customers, third parties and in case customs authorities, eBusiness and eCommerce platforms.

All the rules necessary for the construction and validation of the document are expressed through a specific XML schema, which is presented in detail in the paragraph "Implementation Guide".

Generalities

The Traceability Receiving Advice is a notice that may be addressed to both the sender of the goods as well as the traceability systems; can be used by the Receiver of the goods (purchased or received on account; including in the case of import) both to confirm the regular receipt of the goods against despatching by partners already within the traceability system as well as to communicate the entry into the traceability system, for example following import; it can also be used to notify discrepancies between what was declared by the sender and what was received and accepted.

In the first and third cases, this document must be used in association with the Traceability Despatching advice document (linked via mandatory cross-references); in the second case (import / entry into the system) the document stands alone.

It is recommended to issue an Receipt Notice for each Shipment Notice.

Credits

This document was produced by Piero De Sabbata, Arianna Brutti e Gessica Ciaccio for ENEA X-LAB with the contribution of the partners of the TRICK project.

Back compatibility

New

Document Code

TRC002

Resources

[Guide]
[XML Schema]
[JSON Schema]

Specific for TRICK Activity transactions: P1.A2 Incoming material/Traceability Receiving Advice

Traceability Receiving Advice in activity P1.A2 for the TRICK Pilot (Trick context specific)

In TRICK Pilots this transaction has the aim to inform the platform that raw materials have been received and activate the tracing activity by registering their lots.

In this initial activity also custom documentation related to extra UE imported raw material will be uploaded by the importer

Resources specific for TRICK

[Guide - Specific for TRICK]

Used in Processes

P1. Sustainability Tracing

		Document Traceability report
Document		Traceability report (New)
Description		This documentsi is a Traceability Report containing information related to a single tracing unit (lot or single item or…) and its history and references to its components/raw materials.
Release date		28/05/2022
Scope		This guide aims to illustrate to fashion companies the standard XML format of the document type "TRACEABILITY REPORT", providing instructions for its use in the context of a TRACEABILITY SYSTEM involving Fashion Manufacturers, their customers, third parties and in case customs authorities, eBusiness and eCommerce platforms. All the rules necessary for the construction and validation of the document are expressed through a specific XML schema, which is presented in detail in the paragraph "Implementation Guide".
Generalities		This document has a double function: - it can be used to RETRIEVE the FULL HISTORY of a traceability unit (in this case all the events relating to the traceability unit - the history - are contained in the document from the beginning of its history; the events relating to the components can be or not included depending on the level of detail requested and the disclosure allowed to the applicant); in some cases it might also retrieve information relating to more than one traceability units. In this use, the report is usually a response to a request for information. When reporting the complete history of a traceability unit the document would contain an item with attribute primaryItemFlag=true- which identifies the primary lot of the history, while the remaining items are related to the components. otherwise - it can be used to NOTIFY to a partner (for example the customer) or to the traceability system the NEW or (exceptionally) MODIFIED events relating to one or more traceability units (in this case the events contained in the document must be added to the history of the traceability unit to which they refer, as long as the sender has the appropriate authorization level). In this case the report is sent to the receiver and constitutes a request for registration. Validity of the report: the report contents are guaranteed at the issueing time: the past cannot be changed (with the exception of error corrections), but it may evolve with new events. It is important to distinguish between two stages of the product life: reports up to the 'ready for use' status and circularity reports that include its life after usage up to dismantling: 1) when the product is finished, the ‘technical history’ of a lot of product is ended 2) changes may happen on logistic or ownership or usage between sales/delivering and recollection/dismantling - logistic: changes of the lots (before sales/deliver) for example sent to different warehouses… - usage: should not affect the tracing report
Credits		This document was produced by Piero De Sabbata, Arianna Brutti e Gessica Ciaccio for ENEA X-LAB with the contribution of the partners of the TRICK project.
Back compatibility		New
Document Code		TRC004
Resources		[Guide] [XML Schema] [JSON Schema]
Specific for TRICK Document: Traceability report		Doc_NOTAxPCOAllegatoEN.htm
Resources specific for TRICK		[Guide - Specific for TRICK]
Used in Processes		P1. Sustainability Tracing

		Document Transparency and Sustainability Report
Document		Transparency and Sustainability Report (New)
Description		This report collects all the basic information about the productive process, the facilities and the organisation that are necessary to describe the sustainability characteristcs of the products, enable transparency within the supply chains and activate traceability.
Release date		28/05/2022
Credits		This document was produced by Piero De Sabbata, Arianna Brutti e Gessica Ciaccio for ENEA X-LAB with the contribution of the partners of the TRICK project.
Back compatibility		New
Document Code		TRC001
Resources		[Guide] [XML Schema] [JSON Schema]
Resources specific for TRICK		[Guide - Specific for TRICK]
Used in Processes		P1. Sustainability Tracing S3 PEF and environmental footprint service S4 Health protection assessment service S5 Social and Ethical protection assessment service