810 Invoice

📄 NetSuite to EDI 810 Mapping Documentation

This document details how fields from NetSuite invoice records are mapped into the JSON representation of an 810 EDI document.

🧾 Invoice Header Information

NetSuite FieldEDI Field (JSON)Description
tranIdbeginningSegmentForInvoice.invoiceNumberNetSuite invoice number.
poNumberbeginningSegmentForInvoice.purchaseOrderNumberPurchase Order number from customer.
tranDatebeginningSegmentForInvoice.dateInvoice date.
dueDatebeginningSegmentForInvoice.date1Invoice due date.
terms.nametermsOfSaleDeferredTermsOfSale.descriptionTerm description.
terms.discountPercenttermsOfSaleDeferredTermsOfSale.termsDiscountPercentDiscount percent, if any.
terms.daysUntilExpirytermsOfSaleDeferredTermsOfSale.termsDiscountDaysDueNumber of days discount is valid.
terms.daysUntilNetDuetermsOfSaleDeferredTermsOfSale.termsNetDaysDays until net payment is due.
totaltotalMonetaryValueSummary.amountTotal invoice amount.
subtotaltotalMonetaryValueSummary.amount1Subtotal before discounts.
(calculated)totalMonetaryValueSummary.amount3Discount amount, if applicable.

🧾 Address and Entity Mappings

NetSuite FieldEDI Field (JSON)Description
Billing AddressN1_loop[].EntityIdentifier.Bill_ToCustomer billing address.
Shipping AddressN1_loop[].EntityIdentifier.Ship_ToCustomer shipping address.
Location AddressN1_loop[].EntityIdentifier.Ship_FromWarehouse or shipping location.
Payment AddressN1_loop[].EntityIdentifier.Remit_ToAddress to send payment to.
customerIdcustrecord_ord_tran_entityInternal ID of the customer.

📦 Shipment and Carrier Details

NetSuite FieldEDI Field (JSON)Description
shipDatedateTimeReference.dateDate items were shipped.
Fulfilled line itemsISS_loop.invoiceShipmentSummary.numberOfUnitsShippedTotal quantity shipped.
Carton weightISS_loop.invoiceShipmentSummary.weightCombined weight of all shipped cartons.
Tracking numbercarrierDetails.referenceIdentificationTracking number per line item.
SCAC codecarrierDetails.standardCarrierAlphaCodeCarrier SCAC code.
shipMethodcarrierDetails.routingShipping method used.
billOfLading / proNumbercarrierDetails.referenceIdentificationBOL or Pro number (fallback).

📦 Line Items and Charges

NetSuite FieldEDI Field (JSON)Description
Line items (invoiced)IT1_loop[]Individual invoiced items, with quantity, price, and product IDs.
Line items (discounts, SAC)SAC_loop[]Allowances, charges or discounts applicable to invoice lines.

🔁 Reference Information

NetSuite FieldEDI Field (JSON)Description
poNumberreferenceInformation[].referenceIdentification (PO)Customer’s PO number.
tranIdreferenceInformation[].referenceIdentification (Vendor)Vendor's order number (invoice ID).
customerOrderNumberreferenceInformation[].referenceIdentification (Customer)Additional customer order reference.
outboundConfig.vendorNumberreferenceInformation[].referenceIdentification (Vendor)Vendor number (if defined in config).