Release 1.5

This release updates the library to version 1.5 of the Ecommerce Standards Documents. Download the attached "ecommerce-standards-document-1.5.jar", place into your chosen Java application's directory and referenced the library to start using its classes. Also note that the library has dependencies on version 2.8 or higher of the Jackson Java library at https://github.com/FasterXML/jackson to serialise/deserialise the documents into JSON data. The dependent jars are provided and may be required if you don't already have Jackson embedded in your java application.

This version contains a number of new document and record classes, as well as additional properties for a number of existing records. It also deprecates properties associated with the Download entity, in favour of a more broader Asset entity introduced.

A new record type has been created called ESDRecordAsset to represent any kind of asset. An asset can be a physical or non physical object, that may be created, owned transferred, shared, and ultimately destroyed. An asset could be an automobile, a shareholding, or a house.

Another new record type called ESDRecordAssetComponent can be used to link assets together, where an asset may have many component assets that make up its final composition in a hierachy. For example a building may be an asset, and each floor of the building could be component assets. Then each floor could be broken into room assets. Then each room asset could have individual furniture assets. This kind of hierarchical structure can be used by harnessing the Asset Component class.

For existing records that reference the Download entity, these have been deprecated in favour if using the Asset class, since a download is a digital file type of asset. In a future major library release the Download entity will be completely removed from the library.

The Alternate Code record class now has an additional property called codeType that can define the type of code being stored in the record. The ESDocumentConstants defines the types of values that the codeType can be set as. This includes popular barcode formats, and manufacturer part numbers, and other common code definitions.

Product and Stock quantity record types can now define the last date time that stock has become available, as well as on hold, ordered, reserved, back ordered, or consigned. This can provide additional information on movements of stock.

Trading records now have a new property called deliveryPurchaseOrderCode, that allows the code of a purchase order to be included in delivery information, that is useful in drop shipping and freight processes.

Release 1.4

This release updates the library to version 1.4 of the Ecommerce Standards Documents. Download the attached "ecommerce-standards-document-1.4.jar", place into your chosen Java application's directory and referenced the library to start using its classes. Also note that the library has dependencies on version 2.8 or higher of the Jackson Java library at https://github.com/FasterXML/jackson to serialise/deserialise the documents into JSON data. The dependent jars are provided and may be required if you don't already have Jackson embedded in your java application.

This 1.4 version of the Ecommerce Standards Documents library contains a number of new document and record classes, as well as additional properties for a number of existing records.

A new record type has been created called ESDRecordCategoryTree to represent category trees. Each category tree record allow a collection of category records to live within it, with the category tree representing an overall hierarchies of categories, using for representing product catalogues or brochures.

The Image record type now supports linking images to categories, category trees, makes, and make-model records. The image record now allows a primary image to be specified, as well as ordering property, that both can be used to determine how images should be sorted in a list when belonging to the same referencing record entity (such as a product or category).

The document constants now outlines standardised codes for units of measure, supporting both metric and imperial units across mass, length, and volume. These codes can be set within product, purchase order, sales order, supplier invoice, customer invoice and, sell unit records, to define the length, volume and mass measurements set for ordered goods.

The Sell Unit record type now contains measurement properties to define the width, height, depth and weight of a sell unit, as well its package dimensions, and units of measure codes. This makes possible to show and differentiate between sell unit physical sizes. Two additional properties can specify the minimum quantity of a sell unit that can be purchased, putting a floor to the sell unit's quantity, as well as identifying the incrementing amount that a sell unit may be purchased in. This is relevant if sell units represent a fraction of a whole, such as if selling grain or fresh produce i.e. buying 0.1kg of something in increments of 0.2kg.

The Location record type now supports linking attribute values to locations, allow any amount of additional/high custom information to be stored against each location.

The Delivery Notice record type now contains properties that allow customer accounts, supplier accounts, sales orders, purchase orders, supplier invoices, and customer invoices to be linked to a delivery notice. This can provided references to the records where the delivered goods were ordered from or are assigned against. The record type now can store the date time that a delivery may have been cancelled,

Release 1.3

This release updates the library to version 1.3 of the Ecommerce Standards Documents. Download the attached "ecommerce-standards-document-1.3.jar", place into your chosen Java application's directory and referenced the library to start using its classes.

This version contains a number of new document and record classes, as well as additional properties for a number of existing records. Several new document and record types have been created for storing invoice data associated to customers and suppliers.

A new document and record type has been created for storing delivery notice information (A.K.A advanced shipping notices ASNs, Goods Received Notices), useful for tracking goods being delivered and where the location of the delivery taking place. Many of these delivery notices could be raised as the status of a shipment moves.

A new document and record type has been created for storing currency exchange information, useful for transferring currency information between systems. The currencies specified can be fiat based currencies, or any digital currencies, such as crypto currencies.

A new document and record type has been created for storing General Ledger Account information, useful for accounting purposes and processes, such assigning general ledger accounts to supplier invoice lines, accounts, or products.

The new document classes include in the 1.3 library release:

ESDocumentCurrencyExchangeRate - Stores a list of currency exchange rates.
ESDocumentGeneralLedgerAccount.cs - Stores a list of general ledger account records.
ESDocumentSupplierInvoice - Stores a list of supplier invoices within the document.
ESDocumentCustomerInvoice- Stores a list of customer invoice records within a single document.
ESDocumentDeliveryNotice - Stores a list of delivery notice records.
ESDocumentType - Stores IDs of each type of Ecommerce Standards document

The new record classes include in the 1.3 library release:

ESDRecordType - Stores IDs of each type of Ecommerce Standards record
ESDRecordCurrencyExchangeRate - Stores the details of an exchange rate between 2 currencies.
ESDRecordGeneralLedgerAccount - Stores the details of a general ledger account.
ESDRecordSupplierInvoice - Stores the details of a single supplier invoice. The invoice indicates the products purchased and payment required aginst a supplier.
ESDRecordSupplierInvoiceLine - Added record class to store the details of a single line associated to a supplier invoice record.
ESDRecordCustomerInvoice- Stores details of a single customer invoice record.
ESDRecordCustomerInvoiceLine - Stores details of a single line associated to a customer invoice record.
ESDRecordInvoiceLineAttribute - Stores details of a single attribute and its value associated to an attribute profile and invoice line record.
ESDRecordInvoiceLineAttributeProfile - Stores details of a single attribute profile assigned to an invoice line record.
ESDRecordInvoiceLineTax - Stores taxes applied against a line within an invoice record.
ESDRecordInvoicePayment - Stores the details of a payment applied against a single invoice record.
ESDRecordInvoiceSurcharge - Stores the details of surcharge applied against a single invoice record.
ESDRecordDeliveryNotice - Stores the details of a single delivery notice, that contains the status of products being delivered.
ESDRecordDeliveryNoticeLine - Stores the details of a single line associated to a delivery notice. The line contains the details of the product being delivered, and which invoice and purchase order it is associated against.

Release 1.2

Release 1.2 contains changes to document and class records update the library to version 1.2 of the Ecommerce Standards Documents.

This release includes the newly added classes:

• ESDRecordAccountPaymentSurcharge
• ESDRecordAccountPaymentSurchargeTax
• ESDRecordCustomerAccountEnquiryQuote
• ESDRecordCustomerAccountEnquiryQuoteLine
• ESDRecordMaker
• ESDRecordMakerModel
• ESDRecordMakerModelMapping
• ESDocumentMaker
• ESDocumentMakerModel
• ESDocumentMakerModelMapping

Release 1.1

Release 1.1 contains refactoring of library packages from EcommerceStandardsDocuments to org.esd.EcommernceStandardsDocuments. Additionally contains a fix to allow product combination default child products to allowed to occur. Also contains additional classes to allow document and record types to be referenced based on IDs given for each document and record type.

Release 1.0

Contains all the Java document and records classes based on version 1.1 of the Ecommerce Standards Documents (ESD) standards.