EDIFACT message guide · Communications

REQDOC Request for document

The UN/EDIFACT message a party uses to request that data be sent or resent, as a document, a message or another agreed form.

Sent by
Any trading partner
Received by
Trading partner that holds the data
Standard
UN/EDIFACT · Batch message
X12 equivalent
No direct equivalent

What is the EDIFACT REQDOC message?

REQDOC is the UN/EDIFACT request for document message. The directory defines it as a message that lets a party request the sending, or re-sending, of data, either as a document or message or in another agreed form.

It is a general tool for recovering missing information: a buyer can ask for a copy of an invoice, a carrier for a missing instruction, or a customs authority for supporting documents. The request identifies the document and the form in which it should be delivered.

How the EDIFACT REQDOC message worksDiagram of the UN/EDIFACT REQDOC Request for document message. Any trading partner sends it to trading partner that holds the data. It usually starts the exchange. Inside the UNB and UNH envelopes, the directory D.21A requires, in the start of message: BGM (Beginning of message), DOC (Document/message details) and DTM (Date/time/period) and body and segment groups: the required SG2 loop with NAD (Name and address) and the required SG4 loop with LIN (Line item). 4 conditional segment groups are listed by their trigger segment.How the EDIFACT REQDOC message worksRequest for document: who sends it, where it fits and what the directory marks mandatory1 WHERE IT FITSUSUALLY FOLLOWSStarts the exchangeREQDOCSENDERAny trading partnerRECEIVERTrading partner thatholds the dataCONTRL syntax report back, if agreedUSUALLY FOLLOWED BYNo business reply expected2 WHAT DIRECTORY D.21A REQUIRESInterchange: sender and recipient IDsUNB … UNZMessage REQDOCUNH … UNTSTART OF MESSAGEBGMBeginning of messageDOCDocument/message detailsDTMDate/time/periodBODY AND SEGMENT GROUPSMandatory group SG2 · repeats up to 99NADName and addressMandatory group SG4 · repeats up to 999LINLine item+ 4 conditional groups, starting with:RFFCTANADBlue box: mandatory segment group. Conditional groups are listed by the trigger segment that starts them; a group is sent only when its data applies.Conditional segments outside groups are not drawn.Structure: mandatory segments and groups in the UN/EDIFACT directory D.21A listing for REQDOC. Your trading partner's implementation guide adds itsown requirements.
How the EDIFACT REQDOC message worksDiagram of the UN/EDIFACT REQDOC Request for document message. Any trading partner sends it to trading partner that holds the data. It usually starts the exchange. Inside the UNB and UNH envelopes, the directory D.21A requires, in the start of message: BGM (Beginning of message), DOC (Document/message details) and DTM (Date/time/period) and body and segment groups: the required SG2 loop with NAD (Name and address) and the required SG4 loop with LIN (Line item). 4 conditional segment groups are listed by their trigger segment.How the EDIFACT REQDOCmessage worksRequest for document: who sends it, where itfits and what the directory marks mandatory1 WHERE IT FITSUSUALLY FOLLOWSStarts the exchangeREQDOCSENDERAny tradingpartnerRECEIVERTrading partnerthat holds thedataCONTRL syntax report back, if agreedUSUALLY FOLLOWED BYNo business reply expected2 WHAT DIRECTORY D.21A REQUIRESInterchange: sender and recipient IDs(UNB … UNZ)Message REQDOC (UNH … UNT)START OF MESSAGEBGMBeginning of messageDOCDocument/message detailsDTMDate/time/periodBODY AND SEGMENT GROUPSMandatory group SG2 · repeats upto 99NADName and addressMandatory group SG4 · repeats upto 999LINLine item+ 4 conditional groups, starting with:RFFCTANADBlue box: mandatory segment group. Conditionalgroups are listed by the trigger segment thatstarts them; a group is sent only when its dataapplies. Conditional segments outside groups arenot drawn.Structure: mandatory segments and groups in theUN/EDIFACT directory D.21A listing for REQDOC.Your trading partner's implementation guide adds itsown requirements.

How to read this diagram: the top row shows who sends REQDOC, to whom, and which messages usually come before and after it. The lower part shows what the directory D.21A itself requires: the envelopes around REQDOC and the segments and segment groups it marks mandatory. Conditional groups are listed by their trigger segment rather than drawn in full. This is the directory's minimum, not a trading partner's requirement: a message implementation guide, such as an industry subset or a partner’s own guide, usually makes some conditional groups mandatory, restricts the codes and may use an older directory.

Expand diagram Download SVG

When it is used

  • Asking for a copy of an invoice or credit note
  • Requesting a message that was not received
  • Requesting supporting documents in another form

Where it fits in the message flow

This message REQDOC Request for document

No other message routinely comes directly before or after REQDOC; it is exchanged when the business event occurs. If the partners agree, the receiver confirms each interchange with a CONTRL syntax and service report.

Structure

Mandatory segments in REQDOC (directory D.21A)

In UN/EDIFACT directory D.21A, the REQDOC message has 24 segment positions arranged in 7 segment groups. These are the segments and segment groups marked mandatory at message level, in order; a mandatory group is shown with the segment that starts it. Segments inside conditional groups are needed only when the group is used. This is the directory’s requirement, not your trading partner’s: each partner’s message implementation guide names the directory it uses, often an older one such as D.96A or D.01B where the structure can differ, makes some conditional segments mandatory and restricts the codes.

  • UNH
  • BGM
  • DOC
  • DTM
  • SG2 (NAD)
  • SG4 (LIN)
  • UNT

Practical example

REQDOC in practice

A retailer's accounts payable team cannot find an invoice the supplier says it sent. Its system sends the supplier a REQDOC identifying the invoice number and asking for the INVOIC message to be resent. The supplier's EDI system resends it automatically, and the invoice is processed the same day.

Implementation

Implementation considerations for REQDOC

  • Identify the requested document precisely.
  • Agree the forms in which documents can be resent.
  • Mark resent messages as copies or duplicates where the partner needs it.
  • Track requests until the document arrives.

Related messages

Related communications messages

All 7 communications messages

Need help with REQDOC?

ECOM maps, tests and monitors EDIFACT messages for your trading partners and integrates them with your ERP.