ECGrid Simplify

Canonical Invoice Format Specification

Version: 1.0    Date: April 23, 2026   Owner: ECGrid Product

1. Purpose

This document defines the canonical invoice format used by ECGrid Simplify. It's the single source of truth for invoice structure, field definitions, data types, length limits, required fields, and serialization rules across XML and JSON.

Both XML and JSON representations convey the same logical invoice. A JSON Schema (Simplify_XML_Invoice.schema.json) provides machine-enforceable validation. This document is the human-readable companion.

2. Scope

In scope:

• Invoice document structure (header and detail lines).
• Field-level definitions, data types, length limits, and validation rules.
• Canonical XML and JSON representations.
• Party identification, currency, and date conventions.

Out of scope:

• Transport (HTTPS, AS2, SFTP). Covered in ECGrid Simplify API docs.
• Functional acknowledgments, application responses, and remittance.
• Tax calculation logic, line-level discounts, and freight allocation.

3. Document structure

An invoice payload contains one or more invoices. Each invoice has a single header block. The header contains trading partner identifiers, document metadata, three party blocks (Seller, Buyer, ShipTo), currency, date information, and one or more detail lines.

Top-level shape:

invoices[]

  └── header (required, exactly one)

       ├── tradingPartnerID

       ├── sender / senderQualifier

       ├── receiver / receiverQualifier

       ├── invoiceNumber / invoiceDate

       ├── currency { currencyId, currency }

       ├── dateInformation.shipDateTime { date, time }

       ├── seller  (party address)

       ├── buyer   (party address)

       ├── shipTo  (party address)

       └── detail[] (1..n line items)

4. Header fields

5. Currency block

6. Date information block

Note: date and time are schema-required but accept empty strings when actual values are unavailable. Implementations should treat empty as "not supplied" rather than "zero".

7. Party address block

The same structure is used for seller, buyer, and shipTo.

8. Detail line

The detail array is required and must contain at least one line. Each line carries the fields below.

9. Naming conventions

• JSON: camelCase for all field names (e.g. invoiceNumber, shipDateTime).
• XML: PascalCase for all element names (e.g. InvoiceNumber, ShipDateTime).
• Field semantics and length limits are identical across both. Only casing differs.
• Empty optional values in XML use self-closing tags (e.g. <Date/>). In JSON, use empty string for string fields.

10. XML example

<Invoices>

  <Invoice>

    <Header>

       <TradingPartnerID>SEV2TEST01</TradingPartnerID>

       <SenderQualifier>SE</SenderQualifier>

      <Sender>SEV2TEST01</Sender>

       <ReceiverQualifier>SE</ReceiverQualifier>

       <Receiver>SEV2TEST02</Receiver>

       <InvoiceNumber>123456</InvoiceNumber>

       <InvoiceDate>20260423</InvoiceDate>

      <Currency>

        <CurrencyId>SE</CurrencyId>

        <Currency>USD</Currency>

      </Currency>

      <DateInformation>

        <ShipDateTime>

          <Date/>

          <Time/>

        </ShipDateTime>

      </DateInformation>

      <Seller>

         <PartyIdentification>12345</PartyIdentification>

         <PartyIdentificationTypeCode>92</PartyIdentificationTypeCode>

        <Name>SellerName</Name>

        <StreetAddress1>Seller Address1</StreetAddress1>

        <City>Seller City</City>

        <StateCode>NY</StateCode>

         <PostalCode>12207</PostalCode>

         <CountryCode>US</CountryCode>

      </Seller>

      <Buyer>

         <PartyIdentification>12345</PartyIdentification>

         <PartyIdentificationTypeCode>92</PartyIdentificationTypeCode>

        <Name>BuyerName</Name>

        <StreetAddress1>Buyer Address1</StreetAddress1>

        <City>Buyer City</City>

        <StateCode>NY</StateCode>

         <PostalCode>12207</PostalCode>

         <CountryCode>US</CountryCode>

      </Buyer>

      <ShipTo>

         <PartyIdentification>92</PartyIdentification>

         <PartyIdentificationTypeCode>ABCDE</PartyIdentificationTypeCode>

        <Name>ShipToName</Name>

        <StreetAddress1>ShipTo Address1</StreetAddress1>

        <City>ShipTo City</City>

        <StateCode>NY</StateCode>

         <PostalCode>12207</PostalCode>

         <CountryCode>US</CountryCode>

      </ShipTo>

      <Detail>

         <LineItemNumber>1</LineItemNumber>

        <Sku>HOR9904088</Sku>

         <SupplierAssignedPartNumber>VN123456789</SupplierAssignedPartNumber>

         <BuyerAssignedPartNumber>BY123456789</BuyerAssignedPartNumber>

        <InvoiceQty>2</InvoiceQty>

         <QuantityUnitOfMeasure>EA</QuantityUnitOfMeasure>

         <UnitPriceNet>100</UnitPriceNet>

      </Detail>

    </Header>

  </Invoice>

</Invoices>

11. JSON example

{

  "invoices": [

    {

      "header": {

        "tradingPartnerID": "SEV2TEST01",

        "sender": "SEV2TEST01",

        "senderQualifier": "SE",

        "receiver": "SEV2TEST02",

        "receiverQualifier": "SE",

        "invoiceNumber": "123456",

        "invoiceDate": "20260423",

        "currency": { "currencyId": "SE", "currency": "USD" },

        "dateInformation": {

          "shipDateTime": { "date": "", "time": "" }

        },

        "seller": {

          "partyIdentification": "12345",

           "partyIdentificationTypeCode": "92",

          "name": "SellerName",

          "streetAddress1": "Seller Address1",

          "city": "Seller City",

          "stateCode": "NY",

          "postalCode": "12207",

          "countryCode": "US"

        },

        "buyer": {

          "partyIdentification": "12345",

           "partyIdentificationTypeCode": "92",

          "name": "BuyerName",

          "streetAddress1": "Buyer Address1",

          "city": "Buyer City",

          "stateCode": "NY",

          "postalCode": "12207",

          "countryCode": "US"

        },

        "shipTo": {

          "partyIdentification": "92",

           "partyIdentificationTypeCode": "ABCDE",

          "name": "ShipToName",

          "streetAddress1": "ShipTo Address1",

          "city": "ShipTo City",

          "stateCode": "NY",

          "postalCode": "12207",

          "countryCode": "US"

        },

        "detail": [

          {

            "lineItemNumber": 1,

            "sku": "HOR9904088",

             "supplierAssignedPartNumber": "VN123456789",

             "buyerAssignedPartNumber": "BY123456789",

            "invoiceQty": 2,

            "quantityUnitOfMeasure": "EA",

            "unitPriceNet": 100

          }

        ]

      }

    }

  ]

}