X12 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. The transaction set can be used to provide for customary and established business and industry practice relative to the billing for goods and services provided.
- ~ Segment
- * Element
- > Component
- ^ Repetition
- None included
Interchange Control Header
To start and identify an interchange of zero or more functional groups and interchange-related control segments
Code identifying the type of information in the Authorization Information
- 00
- No Authorization Information Present (No Meaningful Information in I02)
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)
Code identifying the type of information in the Security Information
- 00
- No Security Information Present (No Meaningful Information in I04)
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)
Code indicating the system/method of code structure used to designate the sender or receiver ID element being qualified
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
Code indicating the system/method of code structure used to designate the sender or receiver ID element being qualified
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
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
- ^
- Repetition Separator
Code specifying the version number of the interchange control segments
- 00403
- Draft Standards for Trial Use Approved for Publication by ASC X12 Procedures Review Board through October 1999
A control number assigned by the interchange sender
Code indicating sender's request for an interchange acknowledgment
- 0
- No Acknowledgment Requested
- 1
- Interchange Acknowledgment Requested
Code indicating whether data enclosed by this interchange envelope is test, production or information
- I
- Information
- P
- Production Data
- T
- Test Data
Type is not applicable; the component 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
- >
- Component Element Separator
Functional Group Header
To indicate the beginning of a functional group and to provide control information
Code identifying a group of application related transaction sets
- IN
- Invoice Information (810)
Code identifying party sending transmission; codes agreed to by trading partners
Code identifying party receiving transmission; codes agreed to by trading partners
Date expressed as CCYYMMDD where CC represents the first two digits of the calendar year
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)
Assigned number originated and maintained by the sender
Code identifying the issuer of the standard; this code is used in conjunction with Data Element 480
- T
- Transportation Data Coordinating Committee (TDCC)
- X
- Accredited Standards Committee X12
Code indicating the version, release, subrelease, and industry identifier of the EDI standard being used, including the GS and GE segments; if code in DE455 in GS segment is X, then in DE 480 positions 1-3 are the version number; positions 4-6 are the release and subrelease, level of the version; and positions 7-12 are the industry or trade association identifiers (optionally assigned by user); if code in DE455 in GS segment is T, then other formats are allowed
- 004030
- Draft Standards Approved for Publication by ASC X12 Procedures Review Board through October 1999
Heading
Transaction Set Header
To indicate the start of a transaction set and to assign a control number
Code uniquely identifying a Transaction Set
- The transaction set identifier (ST01) is used by the translation routines of the interchange partners to select the appropriate transaction set definition (e.g., 810 selects the Invoice Transaction Set).
- 810
- Invoice
Beginning Segment for Invoice
To indicate the beginning of an invoice transaction set and transmit identifying numbers and dates
Family Dollar cannot accept corrected invoices unless an EDI 864 Transaction notifies you of the rejection.
If a new invoice is required please send a request to FDAP@familydollar.com to remove the original invoice prior to sending the invoice again. If this step isn't done you will receive an 864 stating duplicate invoice.
Date expressed as CCYYMMDD where CC represents the first two digits of the calendar year
- BIG01 is the invoice issue date.
Date expressed as CCYYMMDD where CC represents the first two digits of the calendar year
- BIG03 is the date assigned by the purchaser to purchase order.
Identifying number for Purchase Order assigned by the orderer/purchaser
PO Number is a required field when the Invoice is against the PO. PO must be a valid Family Dollar Purchase Order Number.
Code specifying the type of transaction
- BIG07 is used only to further define the type of invoice when needed.
This element is only used for Services charges. For Miscellaneous Service Invoice that is only for service charges without line items, such as a freight invoice use the code 26.
- 26
- Miscellaneous Services Invoice
System Number
To specify identifying information
The usage of this segment will be for the Oracle Site ID for remittance for Domestic Vendors.
If you require Family Dollar to remit to anyone but your company you will need to provide a corresponding Oracle ID number.
This ID can be obtained through the Accounts Payable Department at Family Dollar or from the REF (06) segment of the 850 (Purchase Order) document.
If this ID is not provided Family Dollar will default to the primary ID number.
Code qualifying the Reference Identification
- 06
- System Number
The usage on this segment will be for the Oracle Site ID. If you require FamilyDollar to remit to anyone but your company you will need to provide a corresponding Oracle ID number that can be obtained through the Accounts Payable
Department at Family Dollar, or through the REF segment of the 850 Purchase Order. If this ID is not provided Family Dollar will default to the primary ID number.
Vendor ID Number
To specify identifying information
This segment is required. This number can be found on the REF (IA/ VR) of the 850 Purchase Order document or you will need to obtain this information from the Account Payable Department of Family Dollar.
The 810 will not be processed unless the correct vendor number is provided in this segment.
You will get a reject message in an EDI 864 transaction and will need to correct and resend the invoice.
Code qualifying the Reference Identification
- VR
- Vendor ID Number
Reference information as defined for a particular Transaction Set or as specified by the Reference Identification Qualifier
Family Dollar Vendor Number that was sent on the 850 (Purchase Order) document; this number can be found on the REF (IA/VR) of the 850 (Purchase Order) document.
If the vendor number is not available please obtain this information from the Account Payable Department of Family Dollar prior to the invoice being sent EDI.
The 810 will not be processed unless the correct vendor number is provided in this segment.
You will receive a reject message in an EDI 864 transaction and will need to correct and resend the invoice.
Administrative Communications Contact
To identify a person or office to whom administrative communications should be directed
This segment is to be used to supply a contact and telephone number of someone that can assist the Family Dollar AP Department in the event there is an issue with this invoice.
Code identifying the major duty or responsibility of the person or group named
- ZZ
- Mutually Defined
Code identifying the type of communication number
- TE
- Telephone
Complete communications number including country or area code when applicable
Only send a valid telephone number with no dashes or spaces as the field length is only 10 digits.
This is to be used for a contact telephone number of anyone that can assist Family Dollar AP Department should issues on the invoice arise.
Name
To identify a party by type of organization, name, and code
Address Information
To specify the location of the named party
Vendor's Remit To Address
Geographic Location
To specify the geographic place of the named party
Vendor's Remit To City, State and ZIP
Free-form text for city name
- A combination of either N401 through N404, or N405 and N406 may be adequate to specify a location.
Code (Standard State/Province) as defined by appropriate government agency
- N402 is required only if city name (N401) is in the U.S. or Canada.
Name
To identify a party by type of organization, name, and code
DUNS# 024472631
When N103 = "92" then N104 must be 4 Digit Whse Loc or 5 Digit Store Number. (If Store number is only 4 digits you will need to add a zero to the front)
When N103 = "9" then N104 must be DUNS+4 Digit Whse Loc (13 digits) only.
The N103 (ST) and N104 (ST) are required for payment.
The invoice will be rejected and an EDI 864 message will be generated so that the correct WHSE/STORE location can be provided on the invoice.
Code identifying an organizational entity, a physical location, property or an individual
- ST
- Ship To
Code designating the system/method of code structure used for Identification Code (67)
- 9
- D-U-N-S+4, D-U-N-S Number with Four Character Suffix
- 92
- Assigned by Buyer or Buyer's Agent
Code identifying a party or other code
- This segment, used alone, provides the most efficient method of providing organizational identification. To obtain this efficiency the "ID Code" (N104) must provide a key to the table maintained by the transaction processing party.
Family Dollar's Location Number represented as 4 digits.
Address Information
To specify the location of the named party
Family Dollar's Location Address
Geographic Location
To specify the geographic place of the named party
Family Dollar's Location City, State and ZIP
Free-form text for city name
- A combination of either N401 through N404, or N405 and N406 may be adequate to specify a location.
Code (Standard State/Province) as defined by appropriate government agency
- N402 is required only if city name (N401) is in the U.S. or Canada.
Terms of Sale/Deferred Terms of Sale
To specify terms of sale
Although the only required element of the ITD is the ITD12, you may provide as many elements as necessary to describe payment terms.
Code identifying type of payment terms
- If the code in ITD01 is "04", then ITD07 or ITD09 is required and either ITD10 or ITD11 is required; if the code in ITD01 is "05", then ITD06 or ITD07 is required.
- 01
- Basic
- 03
- Fixed Date
Code identifying the beginning of the terms period
- 3
- Invoice Date
Terms discount percentage, expressed as a percent, available to the purchaser if an invoice is paid on or before the Terms Discount Due Date
Date payment is due if discount is to be earned expressed in format CCYYMMDD where CC represents the first two digits of the calendar year
Number of days in the terms discount period by which payment is due if terms discount is earned
Date when total invoice amount becomes due expressed in format CCYYMMDD where CC represents the first two digits of the calendar year
Number of days until total invoice amount is due (discount not applicable)
Date/Time Reference
To specify pertinent dates and times
F.O.B. Related Instructions
To specify transportation instructions relating to shipment
Code identifying payment terms for transportation charges
- FOB01 indicates which party will pay the carrier.
- CC
- Collect
- CD
- Collect on Delivery
- DF
- Defined by Buyer and Seller
- MX
- Mixed
- PC
- Prepaid but Charged to Customer
- PP
- Prepaid (by Seller)
Code identifying type of location
- FOB02 is the code specifying transportation responsibility location.
- DE
- Destination (Shipping)
- OR
- Origin (Shipping Point)
- ZZ
- Mutually Defined
Detail
Baseline Item Data (Invoice)
To specify the basic and most frequently used line item data for the invoice and related transactions
Credit lines CAN NOT be sent on an invoice.
Loop IT1 is only optional for the NON-MERCHANDISE Invoice where the BIG07 is 26.
You will get a rejected FA and the invoice will be rejected by the EDI translator if a negative sign is received in the IT1 SEGMENT.
Family Dollar requires that you use the UOM of Each or CASE.
We do not need the ITEM or CASE UPC if you can provide the family Dollar SKU Number provided on the 850. Either the ITEM orCASE UPC is required based on the UOM in case the SKU number is not provided. BOTH THE ITEM AND CASE UPC SHOULD NOT BE SEND IN ANY CASE.
PLEASE ENSURE THAT YOU HAVE PROVIDED THE FAMILY DOLLAR MERCHANDISING DEPARTMENT WITH THE UPC FOREACH ITEM. ALSO THE DEFAULT UOM ON THE 810 IS THE UOM PROVIDED ON THE 850. IN CASE YOU WANT TO CHANGE THE UOM, THE APPROPRIATE ITEM/CASE UPC NEEDS TO BE PROVIDED AND THE UOM ON THE 850 WILL ALSO BE CHANGED.
IF THE UOM IS EACH, EITHER AN ITEM UPC WITH A (UP) QUALIFIER IN THE 1-5-5-1 FORMAT IS REQUIRED or the GTIN can be sent with the “UK” Qualifier.
IF THE UOM IS CASE, EITHER A CASE/SHIPPER UPC WITH A (UA) QUALIFIER IS REQUIRED IN THE 2-5-5 FORMAT or the GTIN can be sent with the “UK” Qualifier.
PLEASE ENSURE THAT YOU HAVE PROVIDED THE FAMILY DOLLAR MERCHANDISING DEPARTMENT WITH THE UPC FOREACH ITEM. ALSO THE DEFAULT UOM ON THE 810?S IS THE UOM PROVIDED ON THE 850. IN CASE YOU WANT TO CHANGE THE UOM, THE APPROPRIATE ITEM/CASE UPC NEEDS TO BE PROVIDED AND THE UOM ON THE 850 WILL ALSOBE CHANGED.
Alphanumeric characters assigned for differentiation within a transaction set
- IT101 is the line item identification.
Number of units invoiced (supplier units)
This MUST be a positive number.
CREDIT MEMO SPECIFIC: If the BIG07 is CR and your system only handles negatives you will need to change your mapping that would multiply this number by a -1.
Code specifying the units in which a value is being expressed, or manner in which a measurement has been taken
- CA
- Case
- EA
- Each
Price per unit of product, service, commodity, etc.
This MUST be a positive number.
CREDIT MEMO SPECIFIC: If the BIG07 is CR and your system only handles negatives you will need to change your mapping that would multiply this number by a -1.
Code identifying the type of unit price for an item
- UM
- Price per Unit of Measure
Code identifying the type/source of the descriptive number used in Product/Service ID (234)
- IT106 through IT125 provide for ten different product/service IDs for each item. For example: Case, Color, Drawing No., U.P.C. No., ISBN No., Model No., or SKU.
Either the ITEM "UP" or CASE "UA" UPC is required based on the UOM in case the Family Dollar SKU number is not provided.
IF THE UOM IS EACH, EITHER AN ITEM UPC WITH A (UP) QUALIFIER IN THE 1-5-5-1 FORMAT IS REQUIRED or the GTIN can be sent with the “UK” Qualifier.
IF THE UOM IS CASE, EITHER A CASE/SHIPPER UPC WITH A (UA) QUALIFIER IS REQUIRED IN THE 2-5-5 FORMAT or the GTIN can be sent with the “UK” Qualifier.
- SK
- Stock Keeping Unit (SKU)
Identifying number for a product or service
If a valid FD SKU is not sent, then we will use the UPC to find the valid FD SKU.
If the UPC is not found on our system you will receive an 864 document for the error.
Code identifying the type/source of the descriptive number used in Product/Service ID (234)
- UA
- U.P.C./EAN Case Code (2-5-5)
- UP
- UCC - 12
Data structure for the 12 digit EAN.UCC (EAN International.Uniform Code Council) Global Trade Identification Number (GTIN). Also known as the Universal Product Code (U.P.C.).
Identifying number for a product or service
Code identifying the type/source of the descriptive number used in Product/Service ID (234)
- UK
- EAN/UCC - 14
Data structure for the 14 digit EAN.UCC (EAN International.Uniform Code Council) Global Trade Identification Number (GTIN).
Product/Item Description
To describe a product or process in coded or free-form format
Code indicating the format of a description
- If PID01 equals "F", then PID05 is used. If PID01 equals "S", then PID04 is used. If PID01 equals "X", then both PID04 and PID05 are used.
- F
- Free-form
Service, Promotion, Allowance, or Charge Information
To request or identify a service, promotion, allowance, or charge; to specify the amount or percentage for the service, promotion, allowance, or charge
YOU CANNOT SEND A NEGATIVE VALUE IN THE SAC SEGMENT.
The allowance 'A' or charge 'C' indicator will alert FD as to how the dollar value should be handled.
If you require additional codes you must contact the EDI Department at Family Dollar (FD_EDI_IS@dollartree.com).
Code which indicates an allowance or charge for the service specified
- If SAC01 is "A" or "C", then at least one of SAC05, SAC07, or SAC08 is required.
- A
- Allowance
- C
- Charge
Code identifying the service, promotion, allowance, or charge
- A260
- Advertising Allowance
- A400
- Allowance Non-performance
- B210
- Co-op Credit
- B630
- Container/Trailer Allowance
- B660
- Contract Allowance
- B720
- Cooperative Advertising/Merchandising Allowance (Performance)
- C320
- Display Allowance
- C540
- Early Buy Allowance
- D270
- Fuel Surcharge
- D290
- Full Truckload Allowance
- E730
- New Item Allowance
- F280
- Performance Allowance
- F340
- Pick/Up
- F800
- Promotional Allowance
- F810
- Promotional Discount
- F910
- Quantity Discount
- H080
- Special Freight Supplements
- I310
- Truckload Discount
- I530
- Volume Discount
Monetary amount
- SAC05 is the total amount for the service, promotion, allowance, or charge.
- If SAC05 is present with SAC07 or SAC08, then SAC05 takes precedence.
A validation is conducted on this element, if the validation doesn't equal what is sent in the element you will receive an 864 document for this error.
Validation: IT102 * SAC08 = SAC05. If the IT103 code = "EA" then the SAC08 needs to be an each rate; however, if IT103 code = "CA" then the SAC08 needs to be a case rate. If the calculation of IT102*SAC08 doesn't match what was sent in the SAC05 you will receive an 864 document for the error.
Rate expressed in the standard monetary denomination for the currency specified
- SAC08 is the allowance or charge rate per unit.
Summary
Total Monetary Value Summary
To specify the total invoice discounts and amounts
Monetary amount
- TDS01 is the total amount of invoice (including charges, less allowances) before terms discount (if discount is applicable).
TDS01 (INVOICE TOTAL (NET AMOUNT)) = [QUANTITY (IT102) * GROSS
UNIT PRICE (IT104)] + CHARGES (SAC01 = C) – ALLOWANCES (SACO1 = A).
Monetary amount
- TDS02 indicates the amount upon which the terms discount amount is calculated.
- TDS02 is required if the dollar value subject to discount is not equal to the dollar value of TDS01.
TDS02 (Total GROSS Invoice Amount) = Quantity (IT102) * Gross Unit cost (IT104).
Monetary amount
- TDS03 is the amount of invoice due if paid by terms discount due date (total invoice or installment amount less cash discount).
TDS03 is mandatory if a cash discount is available to Family Dollar.
TDS03 = This is the $ Amount of what Family Dollar is allowed to deduct from the vendor if paid within the vendor's terms.
Example: 2%30 days on a $1000.00 invoice would be $20.00
This must be a positive number. If your system only handles negatives you will need to change the mapping to multiply this number by a -1
Carrier Detail
To specify transportation details for the transaction
Bill of Lading not mandatory if it is vendor managed inventory at the store level or the invoice is not against a Family Dollar PO.
Free-form description of the routing or requested routing for shipment, or the originating carrier's identity
Code qualifying the Reference Identification
Bill of Lading not mandatory if it is vendor managed inventory at the store level or the invoice is not against a Family Dollar PO.
FOR IMPORTS ONLY: Use code "BM"
- 2I
- Tracking Number
- 98
- Container/Packaging Specification Number
A numeric or alphanumeric identification assigned to a unique packaging/container configuration.
- BM
- Bill of Lading Number
- CN
- Carrier's Reference Number (PRO/Invoice)
Reference information as defined for a particular Transaction Set or as specified by the Reference Identification Qualifier
"BM" (Bill of lading) if it's a trailer.
"CN" (Container Number) if it's a container for UPS/AIR.
Vendor Bill of lading if it's a trailer then Number is the Container number and if it's a container Shipper tracking number for UPS/Air.
FOR IMPORTS ONLY: This must be the FCR Number (i.e. FDS-XXX-XXXXX)
This information can be found in your booking information through the Freight Forwarder - Yusen Logistics.
Service, Promotion, Allowance, or Charge Information
To request or identify a service, promotion, allowance, or charge; to specify the amount or percentage for the service, promotion, allowance, or charge
YOU CANNOT SEND A NEGATIVE VALUE IN THE SAC SEGMENT.
The allowance 'A' or charge 'C' indicator will alert FD as to how the dollar value should be handled.
If you require additional codes you must contact the EDI Department at Family Dollar (FD_EDI_IS@dollartree.com).
Code which indicates an allowance or charge for the service specified
- If SAC01 is "A" or "C", then at least one of SAC05, SAC07, or SAC08 is required.
- A
- Allowance
- C
- Charge
Code identifying the service, promotion, allowance, or charge
- B785
- Coupon Reimbursement
- B950
- Damaged Merchandise
- C000
- Defective Allowance
- C090
- Deposit Charges
- D240
- Freight
- D270
- Fuel Surcharge
- D290
- Full Truckload Allowance
- D750
- Inbound Freight Charges
- E170
- Labeling
- E660
- Monthly Rental
- E720
- New Distribution Allowance
- E740
- New Store Allowance
- F340
- Pick/Up
- G960
- Slotting Allowance
- H080
- Special Freight Supplements
- H740
- Tax - Sales and Use
- H760
- Tax - State Hazardous Substance
- H850
- Tax
- I310
- Truckload Discount
Monetary amount
- SAC05 is the total amount for the service, promotion, allowance, or charge.
- If SAC05 is present with SAC07 or SAC08, then SAC05 takes precedence.
Rate expressed in the standard monetary denomination for the currency specified
- SAC08 is the allowance or charge rate per unit.
Invoice Shipment Summary
To specify summary details of total items shipped in terms of quantity, weight, and volume
Numeric value of units shipped in manufacturer's shipping units for a line item or transaction set
Transaction Totals
To transmit a hash total for a specific element in the transaction set
- Number of line items (CTT01) is the accumulation of the number of IT1 segments.
If used CTT02 is the hash total of the quantities invoiced (IT102) for each IT1 segment.
Transaction Set Trailer
To indicate the end of the transaction set and provide the count of the transmitted segments (including the beginning (ST) and ending (SE) segments)
Total number of segments included in a transaction set including ST and SE segments
Functional Group Trailer
To indicate the end of a functional group and to provide control information
Total number of transaction sets included in the functional group or interchange (transmission) group terminated by the trailer containing this data element
Interchange Control Trailer
To define the end of an interchange of zero or more functional groups and interchange-related control segments
Stedi is a registered trademark of Stedi, Inc. All names, logos, and brands of third parties listed on this page are trademarks of their respective owners (including “X12”, which is a trademark of X12 Incorporated). Stedi, Inc. and its products and services are not endorsed by, sponsored by, or affiliated with these third parties. Use of these names, logos, and brands is for identification purposes only, and does not imply any such endorsement, sponsorship, or affiliation.