XML

Standards & Guidelines

Ag eStandards Naming Note

Over the years people have referred to Ag eStandards using several names. The following list explains the most common.

  • Chem eStandards: The name of the XML standards that CIDX developed for the global chemical industry, which is currently owned and maintained by OAGi. CIDX first used Chem eStandards in 2001 and still uses it today. (CIDX merged into OAGi in 2009.)
  • AgGateway Open Standards: The brand name AgGateway began to refer to OAGi's Chem eStandards in 2014. The name never caught on and Ag eStandards is most often used today.
  • Ag eStandards: The brand name that AgGateway uses to refer to OAGi's Chem eStandards. See entry on AgGateway Open Standards
  • AgGateway Standards: May refer to Ag eStandards or may refer more broadly, depending on the context. This name is just descriptive--not referring to any particular resources.
  • CIDX Standards: Descriptive synonym for Chem eStandards.
  • ChemXML: An early name for Chem eStandards, which CIDX replaced with Chem eStandards in 2001.

Ag eStandards 7.1

Download

Changes / additions (changes in italics; additions in bold)

  • RetailerOrderSummaryReportProductLineItem structure
    • ...various elements...
    • TransfersInQuantity 1..1
    • TransfersOutQuantity 1..1
    • ReturnsQuantity 1..1 → 0..1
    • ProductReturnsQuantity 0..1
    • HaulbackReturnsQuantity 0..1
    • RecallReturnsQuantity 0..1
  • RetailerOrderSummaryReportProperties
    • ProductYear 0..1
  • RetailerOrderSummaryRequestProperties
    • ProductYear 0..1

Rules

If ReturnsQuantity and any of ProductReturnsQuantity, HaulbackReturnsQuantity, or RecallReturnsQuantity are present, then ReturnsQuantity must be greater than or equal to the sum of the others. One should not assume anything in particular if ReturnsQuantity is greater than the sum of the others.

At least one of ReturnsQuantity, ProductReturnsQuantity, HaulbackReturnsQuantity, or RecallReturnsQuantity is required.

Definitions

ReturnsQuantity – The quantity of the specified product returned in the specified product year.

  • Net returns quantity that would represent all types of seed returns a supplier may record for the Buyer during the indicated product year.
  • Ideally this value will be inclusive of “physical” product returns, soybean haulbacks, recalls and relative adjustments.

ProductReturnsQuantity – The quantity of the specified product physically returned in the specified product year for returns (does not include recalls).

  • Net physical product returns that would represent post-shipment end-of-season seed returns from the Buyer to the supplier.
  • In practice this is the unsold seed that a supplier will pick up from the Buyer at the end of the market year.
  • Such activity is termed “Product” type in ProductReturnsRequest enumerated code list values: cidxListReturnType = “Product”.

HaulbackReturnsQuantity – The quantity of the specified product returned in the specified product year for returns associated with haulbacks.

  • Net Buyer reported soybean haulback quantity for the indicated product year.
  • In practice this is the record of untreated soybean seed dumped at an elevator at the end of the market year.
  • Such activity is termed “Haulback” type in ProductReturnsRequest enumerated code list values: cidxListReturnType = “Haulback”.

RecallReturnsQuantity – The quantity of the specified product physically returned in the specified product year for returns associated with recalls.

  • Net seed recalls that would represent post-shipment pre-season/in-season seed returns (from the Buyer to the supplier) due to a recall issued by the supplier.

Ag eStandards 7.0

Download

This release includes the following changes to ProductTransfersRequest:

  • Add TransferStatus to ProductTransfersRequestProperties
  • Add CreationDateTime to to ProductTransfersRequestProperties
  • Add LastModificationDateTime to ProductTransfersRequestProperties
  • ProductTransfersRequest/ProductTransfersRequestBody minOccurs set to 0

This release includes the following changes to ProductTransfersResponse:

  • Add ProductIdentification to ProductTransfersResponseLineItem - breaking change
  • Add CreationDateTime to to ProductTransfersResponseProperties
  • Add LastModificationDateTime to ProductTransfersResponseProperties
  • Change the occurrence of ProductTransfersResponse/ProductTransfersResponseBody to unbounded

This release includes the following other ProductTransfers-related changes:

  • Add "TransferSummaryRequest" to cidxListTransferType
  • Add ReferenceInformation to ReceivingEntity

This release includes several changes to support expressing booking information, including:

  • Added ShipTo to InventoryUsageLineItem
  • Added Pricing to InventoryUsageActual
  • Added OriginalBookingQuantity to InventoryUsageActual
  • Added OutstandingBookingQuantity to InventoryUsageActual
  • Added BookingType to InventoryUsageActual
  • Added PrepaymentIdentification to InventoryUsageActual

Ag eStandards 6.0

Download

  • Correct minor discrepancies present in versions 4 through 5.4.
  • Adjust naming and design rule implementation to support alignment with ISO 15000-5, which paves the way for OAGi Score use.
  • Added six new messages to support seed-related processes in agriculture:
  • ProductReturnsRequest
  • ProductTransfersRequest
  • ProductTransfersResponse
  • SeedReplantClaim
  • LicenseZoneRequest
  • LicenseZoneResponse

Ag eStandards 5.4

Download

  • Implemented numerous additions and changes for the Japanese chemical industry to support transition from JPCA-BP EDI to Chem eStandards for supply chain operations involving trading houses. Changes are defined to address the following messages:
  • Implemented numerous additions and changes to support the North American agriculture industry, including:

Ag eStandards 5.3

Download

New messages:

  • FeedTonnageReport
  • FertilizerTonnageReport
  • PriceSheetRequest
  • OrderResponseLogRequest
  • OrderResponseLogResponse
  • RetailerOrderSummaryRequest
  • RetailerOrderSummaryReport
  • ProductBooking
  • ProductBookingResponse

Message Use Guidelines

The message use guidelines are available on the wiki. The set of guidelines is a members-only resource, which requires a wiki account. Member Services can provide a wiki account for those members that need one.

Ag eStandards 5.0, 5.1, 5.1.1, and 5.2

AgGateway's Implementation Guidance for OASIS's ebMS 2.0

Download (pdf; 272k)

Price Sheet Direct Links

Unless you are looking for these specifically, you can safely ignore them. They are here for legacy purposes.

Namespace Prefix Guidelines

Note: AgGateway's CTO recommends against implementing these guidelines given that they violate XML-implementation best practices. This document was produced by a project team during the DTD-to-XML Schema transition period and was intended to address very narrow and immediate implementation challenges. The guidelines remain here for legacy purposes.

Download (pdf; 115k)