postalref

Electronic Documentation (eDoc)

Electronic Documentation, or eDoc, is an electronic postage statement that can also carry barcode information and qualification reports for a mailing. Mailers submit it to PostalOne! in place of hardcopy postage statements and qualification reports. It is required for Full-Service Intelligent Mail and Seamless Acceptance.

Updated October 28, 202629 sources

What it is

eDoc is the computer-readable version of a mailing's paperwork, and it replaces the hardcopy postage statement and qualification report. USPS encourages every mailer to submit postage statements electronically, and it requires eDoc for Full-Service and Seamless Acceptance. eDoc gives faster and more accurate pricing and acceptance of postage statements.

An eDoc carries the postage statement and supporting documentation, such as qualification reports. It names the party that submits it, and the Mail Owner and Mail Preparer. It lists barcodes for the mailpieces, trays, sacks and containers in the mailing.

PostalOne!, a USPS information management system, receives the eDoc. It links a customer's mailing information to USPS acceptance and induction of business mail. It produces postage statements and supporting documentation. Seamless Acceptance compares the eDoc with scans of the mail itself, so the eDoc becomes the record USPS checks the mail against.

How it works

A mailer submits eDoc in one of four ways:

  • The IMsb Tool, a free web tool for small mailers, builds the mailing and submits its postage statement automatically.
  • Postal Wizard, a web form, takes postage statement information the mailer types in by hand.
  • Mail.dat, an industry-defined database structure of files linked by key fields, stores complete information about a mailing.
  • Mail.XML, an XML-based specification for web services, offers an alternative to exchanging the entire Mail.dat database.

Each method ends with an electronic postage statement on the PostalOne! Dashboard. A Full-Service letter or flat mailing goes in by Mail.dat in these steps.

Submitting a Mail.dat job to PostalOne!.

  1. Register on the Business Customer Gateway, which assigns a new business account a CRID automatically.
  2. Open Mailing Services, then Electronic Data Exchange, to reach the Mail.dat Client link.
  3. Download and install the Production for Mailers Client.
  4. Sign in to the Client and upload the job through the Job Validation/Upload link.
  5. Choose to upload after validation, then validate and upload the job.
  6. Check the upload history for any Client or Server Validation Errors.
  7. Find the job's postage statement on the Dashboard by its Job ID.
  8. Compare the postage statement and qualification report on the Dashboard with the Mail.dat file.

Submission methods

The IMsb Tool serves small business mailers who prepare their own Full-Service mailings. It handles mailings of fewer than 50,000 pieces entered at a BMEU. It creates an Intelligent Mail barcode for mailpieces and tray and sack labels. It is not designed for Mail Service Providers that prepare mail for others.

Postal Wizard creates the electronic postage statement and submits it to the PostalOne! Dashboard. Its user needs a Business Customer Gateway account with an active mailing permit. It does not make barcodes, so separate software must generate them. A mailing must be all Full-Service pieces or no Full-Service pieces.

Postal Wizard handles basic or Full-Service mailings up to 9,999 pieces. Full-Service mailings of 10,000 or more pieces need approved software or the IMsb Tool. A USPS fact sheet dated August 2024 gives a higher limit, fewer than 50K pieces per Full-Service mailing.

Mail.dat and Mail.XML both need presort software. All of a job's Mail.dat files go in at one time through a client application. A Mail.dat submission is made up of 20 different types of files. Mail.XML is built of families of related messages that travel by web services.

Mail.XML complements Mail.dat rather than replacing it. A mailer can keep Mail.dat as its database and use Mail.XML for communication between businesses.

Mail.dat and Mail.XML users go through testing in the Testing Environment for Mailers before production. Mail.XML software must use the WSDL and XSD files USPS provides.

Identifying the mail owner and preparer

Every Full-Service eDoc names two parties: the Mailing Agent, the "By", and the Mail Owner, the "For". The Mail Owner makes the business decisions about the mailpiece and pays for its postage. A Mail Service Provider acts for one or more Mail Owners.

A party can be named by a Mailer ID, a Customer Registration ID, a permit number or a publication number. When one party has several of these, USPS uses the Mailer ID first, then the CRID, then the permit or publication number.

USPS makes Full-Service data available to the Mail Owner and Mail Preparer based on the By/For information in the eDoc. Sending that data to a third party, called Data Delegation, works only when both parties are named by Mailer ID.

A mail owner presenting fewer than 5,000 pieces in a Full-Service mailing need not be named in the eDoc. This exception does not apply to nonprofit mailings.

Rules

eDoc submitters of Full Service mailings are required to accurately identify the Mail Owner and Mail Preparer in the eDoc.

Whoever submits the eDoc for a Full-Service mailing must name the Mail Owner and the Mail Preparer correctly.

In both cases, all pieces from a single mail owner of 5,000 or more pieces must have the actual mail owner identified in the eDoc.

A mail owner with 5,000 or more pieces in the mailing must be named as itself in the eDoc. A shared stand-in identifier cannot cover that volume.

The JACKPOT CRID/MID is never to be used to identify an eDoc Submitter or a Mail Preparer and can only be used to identify mail owners.

A JACKPOT CRID/MID must not name the eDoc submitter or the Mail Preparer. It may name only mail owners.

A JACKPOT MID can never be used/printed within the IMb on a mailpiece, handling unit, or container placard.

A JACKPOT MID must not appear in any barcode on a mailpiece, handling unit or container placard.

Mail.dat® and Mail.XML® users must go through TEM processing (Testing Environment for Mailers).

A mailer that submits by Mail.dat or Mail.XML must pass testing in the Testing Environment for Mailers.

When programming to create Mail.XML software, developers must use USPS-provided Web Services Description Language (WSDL) and XML schema document and templates (XSD).

Developers who write Mail.XML software must build it on the WSDL and XSD files that USPS supplies.

What goes wrong

The Mail.dat Client reports Client and Server Validation Errors in the job's upload history. Each error shows its description and the action that corrects it. For help with a job, the Mailing & Shipping Solutions Center asks for the Job ID.

By/For checks log an error in three cases. They are a missing Mail Owner in mailings of 5,000 or more pieces, a Mail Owner that is also the Mail Preparer, and a Mail Owner identified as a Mail Service Provider.

Error codeMeaning
7140The Mail Owner and Mail Preparer are the same entity.
7142The Mail Owner was identified as a Mail Preparer within the past 90 days.

A Mail Service Provider that names itself as owner of small volumes triggers error 7140. An authorized JACKPOT CRID/MID removes these errors when used correctly. Misuse can get the authorization revoked.

Under Seamless Acceptance, scans from handheld devices, processing equipment and Surface Visibility are compared with the eDoc to find preparation errors. An undocumented piece is one whose barcode was scanned but appears on no eDoc. Errors are measured against thresholds across all pieces mailed in a calendar month.

A mailer that crosses a threshold may be charged additional postage. USPS collects postage for sampling errors only after a mailer exceeds the Postage Adjustment Factor more than 3 times in a rolling 12-month period. Mail Characteristic failures count against the eDoc submitter, whoever the Mail Owner is.

When a Seamless Acceptance postage statement does not auto-finalize on the mailing date, PostalOne! tries 4 times a day for the next 14 days. On the 15th day, an acceptance employee must finalize it by hand after funds are added.

Terms

Electronic DocumentationeDoc, Electronic Documentation of Mailing Information, electronic document, electronic mailing documentation
an electronic postage statement that may also contain specific information about a mailing such as barcode information and qualification reports
PostalOne!PostalOne! system
the information management system that provides an electronic linkage between a customer’s mailing information and the Postal Service’s business mail acceptance and induction processes. It produces postage statements and supporting documentation.
Mail.dat
Mail.dat is an industry-defined database structure consisting of files linked by key fields.
Mail.xml
Mail.XML is an XML-based DTAC specification for web services.
Postal WizardPW, PSW, Postage Statement Wizard
a tool that provides a secure way to submit postage statements online
Intelligent Mail for Small Business MailersIMsb, Intelligent Mail Small Business Tool, Intelligent Mail for Small Business, IMsb for Small Business Mailers, Intelligent Mail Small Business, IMsb Tool
is a Full-Service mailing solution specifically designed for small business mailers who wish to prepare their own mailings.
Full-Service Intelligent MailFS, Full-Service, Full-Service Intelligent Mail option
One of two Intelligent Mail offerings that requires a maximum 31-digit Intelligent Mail barcode comprising five fields: the Barcode ID, Service Type Identifier, Mailer ID, Serial Number, and Routing Code. The Full-Service Intelligent Mail option requires unique mailpiece barcodes, the use of Intelligent Mail barcodes on tray labels or container placards, electronic documentation, and the use of Facility Access and Shipment Tracking to schedule appointments for the entry of mailings.
Seamless Acceptance
allows the USPS and mailers to answer 3 key questions by comparing information submitted in the electronic postage statement to mailpiece characteristic data obtained during mail processing.
Mail OwnerMO
the business entity, organization, or individual who makes business decisions regarding the mailpiece content, directly benefits from the mailing, and ultimately pays for the postage on the mailpiece directly or by way of a Mail Service Provider
Mail Service ProviderMSP, Mailing Service Providers, Mailing Agent
a business entity, organization, or individual acting on behalf of one or more Mail Owners by providing mailing services for which the Mail Owners compensate the Mail Service Provider.
eDoc submitter
the mailer who submitted the electronic documentation for the mailing
Postage Adjustment FactorPAF
a method to apply an error rate determined from handheld scanner samplings to the entire population of mailings within a calendar month

Documents

Contacts

The Mailing and Shipping Solutions Center answers eDoc questions. Its phone number is 1-877-672-0007. Its email is mssc@usps.gov.

A Mail Service Provider requests a JACKPOT CRID/MID by email to the Reconciliation Specialist team at recon@usps.gov.

Sources