EDIFACT message guide · Projects and construction

CONDPV Direct payment valuation

The UN/EDIFACT message a contractor uses to instruct the party responsible for payments to pay subcontractors for work completed.

Sent by
Main contractor
Received by
Party responsible for payments, such as the client
Standard
UN/EDIFACT · Batch message
X12 equivalent
No direct equivalent

What is the EDIFACT CONDPV message?

CONDPV is the UN/EDIFACT direct payment valuation message. The directory defines it as the instruction by the contractor to the party responsible for payments to pay the subcontractors for work completed.

Some contracts and public procurement rules let the client pay approved subcontractors directly rather than through the main contractor. The direct payment valuation tells the payer how much each subcontractor is owed for the period, so the payments can be made and deducted from the main contractor's valuation. The amounts are usually based on agreed progress.

How the EDIFACT CONDPV message worksDiagram of the UN/EDIFACT CONDPV Direct payment valuation message. Main contractor sends it to party responsible for payments, such as the client. It usually follows CONQVA. It is usually followed by CONPVA. Inside the UNB and UNH envelopes, the directory D.21A requires, in the start of message: BGM (Beginning of message) and DTM (Date/time/period) and body and segment groups: the required SG2 loop with NAD (Name and address). 7 conditional segment groups are listed by their trigger segment.How the EDIFACT CONDPV message worksDirect payment valuation: who sends it, where it fits and what the directory marks mandatory1 WHERE IT FITSUSUALLY FOLLOWSCONQVAQuantity valuationCONDPVSENDERMain contractorRECEIVERParty responsible forpayments, such as theclientCONTRL syntax report back, if agreedUSUALLY FOLLOWED BYCONPVAPayment valuation2 WHAT DIRECTORY D.21A REQUIRESInterchange: sender and recipient IDsUNB … UNZMessage CONDPVUNH … UNTSTART OF MESSAGEBGMBeginning of messageDTMDate/time/periodBODY AND SEGMENT GROUPSMandatory group SG2 · repeats up to 9NADName and address+ 7 conditional groups, starting with:RFFDOCCTACUXINDBIIBlue 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 CONDPV. Your trading partner's implementation guide adds itsown requirements.
How the EDIFACT CONDPV message worksDiagram of the UN/EDIFACT CONDPV Direct payment valuation message. Main contractor sends it to party responsible for payments, such as the client. It usually follows CONQVA. It is usually followed by CONPVA. Inside the UNB and UNH envelopes, the directory D.21A requires, in the start of message: BGM (Beginning of message) and DTM (Date/time/period) and body and segment groups: the required SG2 loop with NAD (Name and address). 7 conditional segment groups are listed by their trigger segment.How the EDIFACT CONDPVmessage worksDirect payment valuation: who sends it, where itfits and what the directory marks mandatory1 WHERE IT FITSUSUALLY FOLLOWSCONQVAQuantity valuationCONDPVSENDERMain contractorRECEIVERPartyresponsible forpayments, suchas the clientCONTRL syntax report back, if agreedUSUALLY FOLLOWED BYCONPVAPayment valuation2 WHAT DIRECTORY D.21A REQUIRESInterchange: sender and recipient IDs(UNB … UNZ)Message CONDPV (UNH … UNT)START OF MESSAGEBGMBeginning of messageDTMDate/time/periodBODY AND SEGMENT GROUPSMandatory group SG2 · repeats upto 9NADName and address+ 7 conditional groups, starting with:RFFDOCCTACUXINDBIIBlue 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 CONDPV.Your trading partner's implementation guide adds itsown requirements.

How to read this diagram: the top row shows who sends CONDPV, 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 CONDPV 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

  • Instructing direct payment of subcontractors
  • Splitting a period's valuation between contractors
  • Supporting public works direct payment rules

Where it fits in the message flow

Usually follows CONQVA Quantity valuation
This message CONDPV Direct payment valuation
Usually followed by CONPVA Payment valuation

Structure

Mandatory segments in CONDPV (directory D.21A)

In UN/EDIFACT directory D.21A, the CONDPV message has 43 segment positions arranged in 15 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
  • DTM
  • SG2 (NAD)
  • UNT

Practical example

CONDPV in practice

On a public building project, the electrical subcontractor is paid directly by the authority. Each month the main contractor sends the authority a CONDPV stating the value of the subcontractor's completed work. The authority pays the subcontractor and deducts the amount from the main contractor's payment.

Implementation

Implementation considerations for CONDPV

  • Confirm that the contract allows direct payment.
  • Base amounts on agreed subcontractor progress.
  • Keep main contractor and subcontractor valuations consistent.
  • Record payments for both parties' accounts.

Need help with CONDPV?

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