JSON Release 1
Delimiters: ~ Segment * Element > Component
Certified March 8, 2024
Canal
JSON 810 Invoice
This Draft Standard for Trial Use contains the format and establishes the data contents of the Invoice Transaction Set (810) for use within the context of an Electronic Data Interchange (EDI) environment.
interchangeControlHeader
Interchange Control Header
Optional
Max Use 1
To start and identify an interchange of zero or more functional groups and interchange-related control segments
authorizationInformationQualifier
I01
Authorization Information Qualifier
Required
id (undefined)
Min 2 Max 2
Code identifying the type of information in the Authorization Information
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
authorizationInformation
I02
Authorization Information
Required
alphanumeric (undefined)
Min 10 Max 10
Information used for additional identification or authorization of the interchange sender or the data in the interchange; the type of information is set by the Authorization Information Qualifier (I01)
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
securityInformationQualifier
I03
Security Information Qualifier
Required
id (undefined)
Min 2 Max 2
Code identifying the type of information in the Security Information
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
securityInformation
I04
Security Information
Required
alphanumeric (undefined)
Min 10 Max 10
This is used for identifying the security information about the interchange sender or the data in the interchange; the type of information is set by the Security Information Qualifier (I03)
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
interchangeIDQualifier
I05
Interchange ID Qualifier
Required
id (undefined)
Min 2 Max 2
Code indicating the system/method of code structure used to designate the sender or receiver ID element being qualified
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
interchangeSenderID
I06
Interchange Sender ID
Required
alphanumeric (undefined)
Min 15 Max 15
Identification code published by the sender for other parties to use as the receiver ID to route data to them; the sender always codes this value in the sender ID element
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
interchangeIDQualifier1
I05
Interchange ID Qualifier
Required
id (undefined)
Min 2 Max 2
Code indicating the system/method of code structure used to designate the sender or receiver ID element being qualified
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
interchangeReceiverID
I07
Interchange Receiver ID
Required
alphanumeric (undefined)
Min 15 Max 15
Identification code published by the receiver of the data; When sending, it is used by the sender as their sending ID, thus other parties sending to them will use this as a receiving ID to route data to them
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
interchangeDate
I08
Interchange Date
Required
date (undefined)
Min 6 Max 6
Date of the interchange
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
interchangeTime
I09
Interchange Time
Required
time (undefined)
Min 4 Max 4
Time of the interchange
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
repetitionSeparator
I65
Repetition Separator
Required
Min 1 Max 1
Type is not applicable; the repetition separator is a delimiter and not a data element; this field provides the delimiter used to separate repeated occurrences of a simple data element or a composite data structure; this value must be different than the data element separator, component element separator, and the segment terminator
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
interchangeControlVersionNumberCode
I11
Interchange Control Version Number Code
Required
id (undefined)
Min 5 Max 5
Code specifying the version number of the interchange control segments, the version of the data elements within the control segments, and the code values within those data elements.
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
interchangeControlNumber
I12
Interchange Control Number
Required
numeric (undefined)
Min 9 Max 9
A control number assigned by the interchange sender
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
acknowledgmentRequestedCode
I13
Acknowledgment Requested Code
Required
id (undefined)
Min 1 Max 1
Code indicating sender's request for an interchange acknowledgment
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
interchangeUsageIndicatorCode
I14
Interchange Usage Indicator Code
Required
id (undefined)
Min 1 Max 1
Code indicating whether data enclosed by this interchange envelope is test, production or information
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
componentElementSeparator
I15
Component Data Element Separator
Required
Min 1 Max 1
Type is not applicable; the component data element separator is a delimiter and not a data element; this field provides the delimiter used to separate component data elements within a composite data structure; this value must be different than the data element separator and the segment terminator
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
functionalGroupHeader
Functional Group Header
Optional
Max Use 1
To indicate the beginning of a functional group and to provide control information
functionalIdentifierCode
479
Functional Identifier Code
Required
id (undefined)
Min 2 Max 2
Code identifying a group of application related transaction sets
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
applicationSendersCode
142
Application Sender's Code
Required
alphanumeric (undefined)
Min 2 Max 15
Code identifying party sending transmission; codes agreed to by trading partners
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
applicationReceiversCode
124
Application Receiver's Code
Required
alphanumeric (undefined)
Min 2 Max 15
Code identifying party receiving transmission; codes agreed to by trading partners
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
date
373
Date
Required
longDate (undefined)
Min 8 Max 8
Date expressed as CCYYMMDD where CC represents the first two digits of the calendar year
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
time
337
Time
Required
time (undefined)
Min 4 Max 8
Time expressed in 24-hour clock time as follows: HHMM, or HHMMSS, or HHMMSSD, or HHMMSSDD, where H = hours (00-23), M = minutes (00-59), S = integer seconds (00-59) and DD = decimal seconds; decimal seconds are expressed as follows: D = tenths (0-9) and DD = hundredths (00-99)
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
groupControlNumber
28
Group Control Number
Required
numeric (undefined)
Min 1 Max 9
Assigned number originated and maintained by the sender
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
responsibleAgencyCode
455
Responsible Agency Code
Required
id (undefined)
Min 1 Max 2
Code identifying the issuer of the standard; this code is used in conjunction with Data Element 480
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
versionReleaseIndustryIdentifierCode
480
Version / Release / Industry Identifier Code
Required
alphanumeric (undefined)
Min 1 Max 12
Code indicating the version, release, and industry identifier of the EDI Standard being used, including the GS and GE segments; if the code in DE455 in the GS segment is X, then DE 480 positions 1-3 are the version number; positions 4-6 are the release level of the version; and positions 7-12 are the industry or trade association identifiers (optionally assigned by user); if the code in DE455 in the GS segment is T, other formats are allowed.
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
transactionSetHeader
Transaction Set Header
Required
Max Use 1
To indicate the start of a transaction set and to assign a control number
transactionSetIdentifierCode
143
Transaction Set Identifier Code
Required
id (undefined)
Min 3 Max 3
Code identifying a Transaction Set
810
Invoice
transactionSetControlNumber
329
Transaction Set Control Number
Required
alphanumeric (undefined)
Min 4 Max 9
Identifying control number that must be unique within the transaction set functional group assigned by the originator for a transaction set
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
beginningSegmentForInvoice
Beginning Segment for Invoice
Required
Max Use 1
To indicate the beginning of an invoice transaction set and transmit identifying numbers and dates
date
373
Date
Required
longDate (undefined)
Min 8 Max 8
Date expressed as CCYYMMDD where CC represents the first two digits of the calendar year
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
invoiceNumber
76
Invoice Number
Required
alphanumeric (undefined)
Min 1 Max 22
Identifying number assigned by issuer
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
purchaseOrderNumber
324
Purchase Order Number
Required
alphanumeric (undefined)
Min 1 Max 22
Identifying number for Purchase Order assigned by the orderer/purchaser
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
currency
Currency
Required
Max Use 1
To specify the currency (dollars, pounds, francs, etc.) used in a transaction
entityIdentifierCode
98
Entity Identifier Code
Required
id (undefined)
Min 2 Max 3
Code identifying an organizational entity, a physical location, property or an individual
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
currencyCode
100
Currency Code
Required
id (undefined)
Min 3 Max 3
Code specifying the Standard ISO code for country in whose currency the charges are specified
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
N1 loop
Min Items
Max Loop 200
partyIdentification
Party Identification
Required
Max Use 1
To identify a party by type of organization, name, and code
Syntax Notes
At least one of name or identificationCodeQualifier is required.
If any of identificationCodeQualifier or identificationCode are present, then all are required.
entityIdentifierCode
98
Entity Identifier Code
Required
id (undefined)
Min 2 Max 3
Code identifying an organizational entity, a physical location, property or an individual
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
name
93
Name
Required
alphanumeric (undefined)
Min 1 Max 60
Free-form name
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
partyLocation
Party Location
Required
Max Use 2
To specify the location of the named party
addressInformation
166
Address Information
Required
alphanumeric (undefined)
Min 1 Max 55
Address information
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
geographicLocation
Geographic Location
Required
Max Use 1
To specify the geographic place of the named party
cityName
19
City Name
Required
alphanumeric (undefined)
Min 2 Max 30
Free-form text for city name
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
stateOrProvinceCode
156
State or Province Code
Required
id (undefined)
Min 2 Max 2
Code specifying the Standard State/Province as defined by appropriate government agency
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
postalCode
116
Postal Code
Required
id (undefined)
Min 3 Max 15
Code specifying international postal zone code excluding punctuation and blanks (zip code for United States)
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
IT1 loop
Required
Min Items
Max Loop 200000
baselineItemDataInvoice
Baseline Item Data (Invoice)
Required
Max Use 1
To specify the basic and most frequently used line item data for the invoice and related transactions
Syntax Notes
If any of quantityInvoiced, unitOrBasisForMeasurementCode or unitPrice are present, then all are required.
If any of productServiceIDQualifier or productServiceID are present, then all are required.
If any of productServiceIDQualifier1 or productServiceID1 are present, then all are required.
If any of productServiceIDQualifier2 or productServiceID2 are present, then all are required.
If any of productServiceIDQualifier3 or productServiceID3 are present, then all are required.
If any of productServiceIDQualifier4 or productServiceID4 are present, then all are required.
If any of productServiceIDQualifier5 or productServiceID5 are present, then all are required.
If any of productServiceIDQualifier6 or productServiceID6 are present, then all are required.
If any of productServiceIDQualifier7 or productServiceID7 are present, then all are required.
If any of productServiceIDQualifier8 or productServiceID8 are present, then all are required.
If any of productServiceIDQualifier9 or productServiceID9 are present, then all are required.
quantityInvoiced
358
Quantity Invoiced
Required
decimal (undefined)
Min 1 Max 15
Number of units invoiced (supplier units)
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
unitOrBasisForMeasurementCode
355
Unit or Basis for Measurement Code
Required
id (undefined)
Min 2 Max 2
Code specifying the units in which a value is being expressed, or manner in which a measurement has been taken
EA
Each
unitPrice
212
Unit Price
Required
decimal (undefined)
Min 1 Max 17
Price per unit of product, service, commodity, etc.
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
productServiceIDQualifier
235
Product/Service ID Qualifier
Required
id (undefined)
Min 2 Max 2
Code identifying the type/source of the descriptive number used in Product/Service ID (234)
SK
Stock Keeping Unit (SKU)
productServiceID
234
Product/Service ID
Required
alphanumeric (undefined)
Min 1 Max 48
Identifying number for a product or service
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
productServiceIDQualifier1
235
Product/Service ID Qualifier
Optional
id (undefined)
Min 2 Max 2
Code identifying the type/source of the descriptive number used in Product/Service ID (234)
UP
UCC - 12
productServiceID1
234
Product/Service ID
Optional
alphanumeric (undefined)
Min 1 Max 48
Identifying number for a product or service
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
totalMonetaryValueSummary
Total Monetary Value Summary
Required
Max Use 1
To specify the total invoice discounts and amounts
amount
610
Amount
Required
decimal (undefined)
Min 1 Max 15
Monetary amount
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
SAC loop
Required
Min Items
Max Loop 2
servicePromotionAllowanceOrChargeInformation
Service, Promotion, Allowance, or Charge Information
Required
Max Use 2
To request or identify a service, promotion, allowance, or charge; to specify the amount or percentage for the service, promotion, allowance, or charge
Syntax Notes
At least one of servicePromotionAllowanceOrChargeCode or agencyQualifierCode is required.
If any of agencyQualifierCode or agencyServicePromotionAllowanceOrChargeCode are present, then all are required.
If any of allowanceChargePercentQualifier or percentDecimalFormat are present, then all are required.
If any of unitOrBasisForMeasurementCode or quantity are present, then all are required.
servicePromotionAllowanceOrChargeCode
1300
Service, Promotion, Allowance, or Charge Code
Required
id (undefined)
Min 2 Max 4
Code identifying the service, promotion, allowance, or charge
G821
Shipping
CF
Commission and Fees
amount
610
Amount
Required
decimal (undefined)
Min 1 Max 15
Monetary amount
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
transactionSetTrailer
Transaction Set Trailer
Required
Max Use 1
To indicate the end of the transaction set and provide the count of the transmitted segments (including the beginning (ST) and ending (SE) segments)
numberOfIncludedSegments
96
Number of Included Segments
Required
numeric (undefined)
Min 1 Max 10
Total number of segments included in a transaction set including ST and SE segments
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
transactionSetControlNumber
329
Transaction Set Control Number
Required
alphanumeric (undefined)
Min 4 Max 9
Identifying control number that must be unique within the transaction set functional group assigned by the originator for a transaction set
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here