D18A
Message D18A/CONPVA
Payment valuation message
Typically this message will be used between a contractor and the client's representative, during the process of approving the value and payment for work completed for a given period of time.
Message description
UNH
M(1) : Message headerA service segment starting and uniquely identifying a message. The message type code for the Payment valuation message is CONPVA. Note: Payment valuation messages conforming to this document must contain the following data in segment UNH, composite S009: Data element 0065 CONPVA 0052 D 0054 18A 0051 UN
BGM
M(1) : Beginning of messageA segment for unique identification of the Payment valuation document name, number and function.
DTM
M(9) : Date/time/periodA segment specifying the dates that apply, e.g. date of valuation, date of submission, acceptance date, etc.
AUT
C(2) : Authentication resultA segment used to authenticate the message by exchanging a password or some other form of identification agreed between the trading partners.
FTX
C(5) : Free textA segment with free text information, in coded or clear form, used for any textual qualification. In computer to computer exchanges, such text will require the receiver to process this segment manually.
SG1 C(99) : RFF-DTM
A group of segments for quoting references and their relevant dates that are applicable to the message.
RFF
M(1) : ReferenceA segment for quoting references that are applicable to this whole message. e.g. contract identity, operational references, former valuation reference number.
DTM
C(5) : Date/time/periodDates of references quoted in the previous RFF segment.
SG2 M(9) : NAD-LOC-FII-SG3-SG4-SG5
A group of segments identifying the parties with associated information.
NAD
M(1) : Name and addressA segment identifying names and addresses of the parties, in coded or clear form, and their functions relevant to the valuation. Identification of the contractor and client parties is mandatory for the valuation message. It is recommended that where possible only the coded form of the party ID should be specified.
LOC
C(25) : Place/location identificationA segment giving more specific location information of the party specified in the NAD segment e.g. internal site/building number.
FII
C(5) : Financial institution informationA segment identifying the financial institution (e.g. bank) and relevant account numbers for the contractor, client and where necessary other parties.
SG3 C(10) : RFF-DTM
A group of segments for giving references only relevant to the specified party rather than the whole valuation.
RFF
M(1) : ReferenceA segment identifying the reference by its number and where appropriate a line number within a document.
DTM
C(5) : Date/time/periodA segment specifying the date and/or time related to the reference.
SG4 C(5) : DOC-DTM
A group of segments identifying the documentary requirements of the specified party.
DOC
M(1) : Document/message detailsA segment identifying and providing information relating to the documents required by the party specified by the NAD.
DTM
C(5) : Date/time/periodA segment specifying the date and/or time of the document.
SG5 C(5) : CTA-COM
A group of segments giving contact details of the specific person or department within the party identified in the NAD segment.
CTA
M(1) : Contact informationA segment to identify a person or department, and their function, to whom communications should be directed.
COM
C(5) : Communication contactA segment to identify a communications type and number for the contact specified in the CTA segment.
SG6 C(5) : CUX-DTM
A group of segments specifying the currencies and related dates/periods valid for the whole valuation. Currency data may be omitted in national applications but will be required for international transactions.
CUX
M(1) : CurrenciesA segment identifying the currencies required in the valuation e.g. the valuation currency. A rate of exchange may be given to convert a reference currency into a target currency.
DTM
C(5) : Date/time/periodA segment specifying the date/time/period related to the rate of exchange.
SG7 C(100) : IND-RFF-DTM
A group of segments to convey the new fluctuation indices values.
IND
M(1) : Index detailsA segment to provide a new value of the quoted index.
RFF
M(1) : ReferenceA segment to indicate the reference of the index.
DTM
C(1) : Date/time/periodA segment to convey the new date of value of the quoted index.
SG8 C(1000) : BII-RCS-PAI-PYT-PCD-SG9-SG10-SG19
A group of segments to indicate: - the financial total amounts of the valuation or parts of it - conditions of payments - conditions of allowances and charges, bonuses and penalties - the total amounts to be paid directly to subcontractors (request or confirmation).
BII
M(1) : Structure identificationA segment to identify the group of items to which the valuation amounts stated in the group of segments apply. The identification of the groups of items referred to here has already been conveyed through another appropriate EDI message.
RCS
C(1) : Requirements and conditionsA segment to provide requirements that are applicable to the whole group of items referred to in BII.
PAI
C(1) : Payment instructionsA segment indicating conditions of payment, guarantee and method of payment for the whole group of items referred to in BII.
PYT
C(1) : Payment termsA segment indicating the payment terms, date/time basis, and additional terms valid for the whole group of items referred to in BII.
PCD
C(9) : Percentage detailsA segment used to provide percentages at contract or sub- contract level.
SG9 C(2) : APR-DTM
A group of segments to convey the results of the computation of the fluctuation formulas and the relevant dates/periods. This group is used to provide only price variation resulting from the computation of the fluctuation price formula, excluding any amount.
APR
M(1) : Additional price informationA segment to indicate the price fluctuation computation.
DTM
C(5) : Date/time/periodA segment to indicate the date or period of application of the factor quoted in APR.
SG10 M(100) : ARD-MOA-FTX-SG11-SG12-SG13
A group of segments to convey the financial amounts related to the group of items referred to in BII and their relevant taxes and if necessary the details of their computation.
ARD
M(1) : Monetary amount functionA segment to convey a financial status of the following information.
MOA
M(6) : Monetary amountA segment to convey monetary amounts related to the group of items referred to in BII and to the financial nature quoted in ARD.
FTX
C(10) : Free textA segment with free text information, in coded or clear form, used for any textual qualification. In computer to computer exchanges, such text will require the receiver to process this segment manually.
SG11 C(5) : TAX-MOA-LOC
A group of segments specifying tax related information, and when necessary, the location(s) to which that tax information relates.
TAX
M(1) : Duty/tax/fee detailsA segment specifying a tax type, category and rate, or exemption, relating to the group of items referred to in BII. e.g. Value Added Tax at the standard rate is applicable for all items.
MOA
C(1) : Monetary amountA segment specifying the amount for the identified tax/fee.
LOC
C(5) : Place/location identificationA segment indicating the location to which the tax or exemption specified in the TAX segment applies, e.g. city or state or country tax.
SG12 C(99) : APR-RFF-DTM-MOA-TAX
A group of segments used to provide amounts breakdown related to price variation rate. It provides all information needed to compute these amounts.
APR
M(1) : Additional price informationA segment used to provide the price variation rate which is used as a basis for calculation of the following amounts.
RFF
C(9) : ReferenceA segment used to provide references used as a basis for calculation of the following amounts.
DTM
C(9) : Date/time/periodA segment to provide dates used for the calculation of the price variation rate.
MOA
C(9) : Monetary amountA segment used to provide the amount to be paid and all amounts used in the calculation of this amount.
TAX
C(9) : Duty/tax/fee detailsA segment used to provide tax related information.
SG13 C(99) : ALC-ALI-RFF-DTM-FTX-SG14-SG15-SG16-SG17-
SG18 A group of segments specifying allowances and charges for the group of items referred to in BII. The allowance or charge specified within this Segment group may either relate to the group of items referred to in BII in which case it cannot be overridden at item level, or it can relate to the line items as a default allowance/charge and can be overridden by the ALC Segment group within the item section. Where relevant, additional information, tax and alternate currency details are to be indicated in the TAX and MOA segments. The basis for the calculation of the allowance/charge may be a quantity, a percentage, an amount or a rate and one of the Segment group 14-17 should be used accordingly.
ALC
M(1) : Allowance or chargeA segment identifying the charge or allowance and, where necessary its calculation sequence.
ALI
C(5) : Additional informationA segment indicating that allowance or charge specified is subject to special conditions owing to origin, customs preference or commercial factors.
RFF
C(9) : ReferenceTo reference rules applied when setting the bonus or penalty. This may apply to price variation calculation formula itself described in price fluctuations above.
DTM
C(9) : Date/time/periodTo provide dates used in setting bonus and penalty.
FTX
C(9) : Free textTo provide free text information used in setting bonus and penalty. It may be used to provide the nature of the bonus or penalty or to provide complex calculation rules.
SG14 C(1) : QTY-RNG
A group of segments specifying the quantity of the allowance or charge with its measure unit specifier. A range to which the allowance or charge applies may be specified. e.g. An allowance of a free quantity of 20 pieces may be specified if the quantity ordered is greater than 1000 pieces.
QTY
M(1) : QuantityA segment identifying the type of quantity and the quantity related to the allowance or charge.
RNG
C(1) : Range detailsA segment specifying, if required, the range to which the allowance or charge applies.
SG15 C(1) : PCD-RNG
A group of segments specifying the percentage for the allowance or charge, e.g. The allowance/charge amount is calculated as 5% of the goods value or a price reduction of 5% may be specified if the goods quantity ordered is within the range 5 tons to 10 tons.
PCD
M(1) : Percentage detailsA segment identifying the percentage and the percentage basis for the calculation of the allowance or charge.
RNG
C(1) : Range detailsA segment specifying, if required, a range for the application of the percentage.
SG16 C(1) : MOA-RNG
A group of segments specifying a monetary amount for an allowance or charge. A range to which the allowance or charge applies can be specified.
MOA
M(1) : Monetary amountA segment identifying the monetary amount for the allowance or charge.
RNG
C(1) : Range detailsA segment specifying, if required, a range for the application of the allowance/charge amount.
SG17 C(1) : RTE-RNG
A group of segments specifying the rate per unit and basis to which the allowance or charge applies, e.g. The allowance/charge amount is 3 DEM per 10 tons.
RTE
M(1) : Rate detailsA segment specifying the rate per unit and the basis for calculation.
RNG
C(1) : Range detailsA segment specifying, if required, the range for the application of the allowance/charge rate.
SG18 C(1) : TAX-MOA
A group of segments specifying tax related information for the allowance or charge and, when necessary, the location(s) to which that tax information relates.
TAX
M(1) : Duty/tax/fee detailsA segment specifying the tax type, category, and rate, or exemption, related to the allowance or charge.
MOA
C(1) : Monetary amountA segment specifying the amount for the allowance or charge.
SG19 C(99) : NAD-LOC-FII-MOA-SG20-SG21-SG22
A group of segments identifying the parties with associated information for the group of items referred to in BII.
NAD
M(1) : Name and addressA segment identifying names and addresses of the parties, in coded or clear form, and their functions relevant to the valuation. Identification of the contractor and client parties is mandatory for the valuation message. It is recommended that where possible only the coded form of the party ID should be specified. e.g. The contractor and client are known to each other, thus only the coded ID is required, but the subcontractors addresses may vary and would have to be clearly specified, preferably in structured format.
LOC
C(25) : Place/location identificationA segment giving more specific location information of the party specified in the NAD segment e.g. internal site/building number.
FII
C(5) : Financial institution informationA segment identifying the financial institution (e.g. bank) and relevant account numbers for the contractor, client and where necessary other parties.
MOA
C(99) : Monetary amountTo provide amounts to be paid to each beneficiary, especially sub-contractors.
SG20 C(10) : RFF-DTM
A group of segments for giving references only relevant to the specified party rather than the whole valuation.
RFF
M(1) : ReferenceA segment identifying the reference by its number and where appropriate a line number within a document.
DTM
C(5) : Date/time/periodA segment specifying the date and/or time related to the reference.
SG21 C(5) : DOC-DTM
A group of segments identifying the documentary requirements of the specified party.
DOC
M(1) : Document/message detailsA segment identifying and providing information relating to the documents required by the party specified by the NAD.
DTM
C(5) : Date/time/periodA segment specifying the date and/or time of the document.
SG22 C(5) : CTA-COM
A group of segments giving contact details of the specific person or department within the party identified in the NAD segment.
CTA
M(1) : Contact informationA segment to identify a person or department, and their function, to whom communications should be directed.
COM
C(5) : Communication contactA segment to identify a communications type and number for the contact specified in the CTA segment.
UNS
M(1) : Section controlA service segment placed at the beginning of the detail section to avoid collision.
SG23 C(9999) : BII-RCS-QTY-PRI-MOA-SG24-SG26-SG27-SG28
A group of segments providing the quantities and the corresponding prices of the works performed for each item, or group of items.
BII
M(1) : Structure identificationA segment to identify the item of work (or group of items) to which the quantities apply.
RCS
C(1) : Requirements and conditionsA segment to provide requirements that are applicable to the whole group of segments: financial status (when an item is added to the BOQ, dayworks for example), and an action request.
QTY
M(6) : QuantityA segment giving the quantity of works performed, in cumulative, last period cumulative, quantity of the period, and other forms as required.
PRI
C(1) : Price detailsA segment used to indicate the unit price of the items.
MOA
M(6) : Monetary amountA segment used to indicate monetary amount which are the computation of the unit price and quantities quoted in QTY.
SG24 M(100) : LIN-SG25
A group of segments to record descriptive text for items that are added into existing groups during the completion of the works, e.g. dayworks.
LIN
M(1) : Line itemA segment to record a qualifier specifying that we are at item level.
SG25 C(1000) : IMD-RFF-GEI
A group of segments to record the description line details together with text reference numbers and change action codes used to identify who is authorised to apply changes.
IMD
M(1) : Item descriptionThis segment is used to convey any descriptive material to be recorded for the item. This descriptive material can apply to the item description and item heading information.
RFF
C(5) : ReferenceA segment used to record up to two text reference numbers per item description line.
GEI
C(5) : Processing informationA segment used to record up to two text change action codes per item description line. In this context suppression is not allowed.
SG26 C(2) : APR-DTM
A group of segments to convey the results of the computation of the fluctuation formulas and the relevant dates/periods for this item when it is different from the group to which this item belongs.
APR
M(1) : Additional price informationA segment to indicate the date or period of application of the factor quoted in APR.
DTM
C(5) : Date/time/periodA segment to indicate the date or period of application of the factor quoted in APR.
SG27 C(5) : TAX-MOA-LOC
A group of segments specifying tax related information for this item when it is specific to this item or different from the group to which it belongs, and when necessary, the location(s) to which that tax information relates.
TAX
M(1) : Duty/tax/fee detailsA segment specifying a tax type, category and rate, or exemption, relating to the group of items referred to in BII. e.g. Value Added Tax at the standard rate is applicable for all items.
MOA
C(1) : Monetary amountA segment specifying the amount for the identified tax/fee.
LOC
C(5) : Place/location identificationA segment indicating the location to which the tax or exemption specified in the TAX segment applies, e.g. city or state or country tax.
SG28 C(20) : ALC-ALI-SG29-SG30-SG31-SG32-SG33
A group of segments specifying allowances and charges for the item referred to in BII where this is different to or not specified within the group of items to which it belongs.
ALC
M(1) : Allowance or chargeA segment identifying the charge or allowance and, where necessary its calculation sequence.
ALI
C(1) : Additional informationA segment indicating that allowance or charge specified is subject to special conditions owing to origin, customs preference or commercial factors.
SG29 C(1) : QTY-RNG
A group of segments specifying the quantity of the allowance or charge with its measure unit specifier. A range to which the allowance or charge applies may be specified. e.g. An allowance of a free quantity of 20 pieces may be specified if the quantity ordered is greater than 1000 pieces.
QTY
M(1) : QuantityA segment identifying the type of quantity and the quantity related to the allowance or charge.
RNG
C(1) : Range detailsA segment specifying, if required, the range to which the allowance or charge applies.
SG30 C(1) : PCD-RNG
A group of segments specifying the percentage for the allowance or charge, e.g. The allowance/charge amount is calculated as 5% of the goods value or a price reduction of 5% may be specified if the goods quantity ordered is within the range 5 tons to 10 tons.
PCD
M(1) : Percentage detailsA segment identifying the percentage and the percentage basis for the calculation of the allowance or charge.
RNG
C(1) : Range detailsA segment specifying, if required, a range for the application of the percentage.
SG31 C(1) : MOA-RNG
A group of segments specifying a monetary amount for an allowance or charge. A range to which the allowance or charge applies can be specified.
MOA
M(1) : Monetary amountA segment identifying the monetary amount for the allowance or charge.
RNG
C(1) : Range detailsA segment specifying, if required, a range for the application of the allowance/charge amount.
SG32 C(1) : RTE-RNG
A group of segments specifying the rate per unit and basis to which the allowance or charge applies, e.g. The allowance/charge amount is 3 DEM per 10 tons.
RTE
M(1) : Rate detailsA segment specifying the rate per unit and the basis for calculation.
RNG
C(1) : Range detailsA segment specifying, if required, the range for the application of the allowance/charge rate.
SG33 C(1) : TAX-MOA
A group of segments specifying tax related information for the allowance or charge and, when necessary, the location(s) to which that tax information relates.
TAX
M(1) : Duty/tax/fee detailsA segment specifying the tax type, category, and rate, or exemption, related to the allowance or charge.
MOA
C(1) : Monetary amountA segment specifying the amount for the allowance or charge.
UNS
M(1) : Section controlA service segment placed at the beginning of the summary section to avoid collision.
SG34 C(10) : TAX-MOA
CNT
C(5) : Control totalA segment by which control totals may be provided by the sender for checking by the receiver.
UNT
M(1) : Message trailerA service segment ending a message, giving the total number of segments in the message (including the UNH & UNT) and the control reference number of the message.
Message structure
UNH, Message header M 1 BGM, Beginning of message M 1 DTM, Date/time/period M 9 AUT, Authentication result C 2 FTX, Free text C 5 --- Segment Group 1 ------------------------- C 99 -------+ RFF, Reference M 1 | DTM, Date/time/period C 5 | ---- -----------------------------------------------------------+ --- Segment Group 2 ------------------------- M 9 -------+ NAD, Name and address M 1 | LOC, Place/location identification C 25 | FII, Financial institution information C 5 | | --- Segment Group 3 ------------------------- C 10 ------+| RFF, Reference M 1 || DTM, Date/time/period C 5 || ---- ----------------------------------------------------------+| | --- Segment Group 4 ------------------------- C 5 ------+| DOC, Document/message details M 1 || DTM, Date/time/period C 5 || ---- ----------------------------------------------------------+| | --- Segment Group 5 ------------------------- C 5 ------+| CTA, Contact information M 1 || COM, Communication contact C 5 || ---- ----------------------------------------------------------++ --- Segment Group 6 ------------------------- C 5 -------+ CUX, Currencies M 1 | DTM, Date/time/period C 5 | ---- -----------------------------------------------------------+ --- Segment Group 7 ------------------------- C 100 -------+ IND, Index details M 1 | RFF, Reference M 1 | DTM, Date/time/period C 1 | ---- -----------------------------------------------------------+ --- Segment Group 8 ------------------------- C 1000 -------+ BII, Structure identification M 1 | RCS, Requirements and conditions C 1 | PAI, Payment instructions C 1 | PYT, Payment terms C 1 | PCD, Percentage details C 9 | | --- Segment Group 9 ------------------------- C 2 ------+| APR, Additional price information M 1 || DTM, Date/time/period C 5 || ---- ----------------------------------------------------------+| | --- Segment Group 10 ------------------------ M 100 ------+| ARD, Monetary amount function M 1 || MOA, Monetary amount M 6 || FTX, Free text C 10 || || --- Segment Group 11 ------------------------ C 5 -----+|| TAX, Duty/tax/fee details M 1 ||| MOA, Monetary amount C 1 ||| LOC, Place/location identification C 5 ||| ---- ---------------------------------------------------------+|| || --- Segment Group 12 ------------------------ C 99 -----+|| APR, Additional price information M 1 ||| RFF, Reference C 9 ||| DTM, Date/time/period C 9 ||| MOA, Monetary amount C 9 ||| TAX, Duty/tax/fee details C 9 ||| ---- ---------------------------------------------------------+|| || --- Segment Group 13 ------------------------ C 99 -----+|| ALC, Allowance or charge M 1 ||| ALI, Additional information C 5 ||| RFF, Reference C 9 ||| DTM, Date/time/period C 9 ||| FTX, Free text C 9 ||| ||| --- Segment Group 14 ------------------------ C 1 ----+||| QTY, Quantity M 1 |||| RNG, Range details C 1 |||| ---- --------------------------------------------------------+||| ||| --- Segment Group 15 ------------------------ C 1 ----+||| PCD, Percentage details M 1 |||| RNG, Range details C 1 |||| ---- --------------------------------------------------------+||| ||| --- Segment Group 16 ------------------------ C 1 ----+||| MOA, Monetary amount M 1 |||| RNG, Range details C 1 |||| ---- --------------------------------------------------------+||| ||| --- Segment Group 17 ------------------------ C 1 ----+||| RTE, Rate details M 1 |||| RNG, Range details C 1 |||| ---- --------------------------------------------------------+||| ||| --- Segment Group 18 ------------------------ C 1 ----+||| TAX, Duty/tax/fee details M 1 |||| MOA, Monetary amount C 1 |||| ---- --------------------------------------------------------+++| | --- Segment Group 19 ------------------------ C 99 ------+| NAD, Name and address M 1 || LOC, Place/location identification C 25 || FII, Financial institution information C 5 || MOA, Monetary amount C 99 || || --- Segment Group 20 ------------------------ C 10 -----+|| RFF, Reference M 1 ||| DTM, Date/time/period C 5 ||| ---- ---------------------------------------------------------+|| || --- Segment Group 21 ------------------------ C 5 -----+|| DOC, Document/message details M 1 ||| DTM, Date/time/period C 5 ||| ---- ---------------------------------------------------------+|| || --- Segment Group 22 ------------------------ C 5 -----+|| CTA, Contact information M 1 ||| COM, Communication contact C 5 ||| ---- ---------------------------------------------------------+++ UNS, Section control M 1 --- Segment Group 23 ------------------------ C 9999 -------+ BII, Structure identification M 1 | RCS, Requirements and conditions C 1 | QTY, Quantity M 6 | PRI, Price details C 1 | MOA, Monetary amount M 6 | | --- Segment Group 24 ------------------------ M 100 ------+| LIN, Line item M 1 || || --- Segment Group 25 ------------------------ C 1000 -----+|| IMD, Item description M 1 ||| RFF, Reference C 5 ||| GEI, Processing information C 5 ||| ---- ---------------------------------------------------------++| | --- Segment Group 26 ------------------------ C 2 ------+| APR, Additional price information M 1 || DTM, Date/time/period C 5 || ---- ----------------------------------------------------------+| | --- Segment Group 27 ------------------------ C 5 ------+| TAX, Duty/tax/fee details M 1 || MOA, Monetary amount C 1 || LOC, Place/location identification C 5 || ---- ----------------------------------------------------------+| | --- Segment Group 28 ------------------------ C 20 ------+| ALC, Allowance or charge M 1 || ALI, Additional information C 1 || || --- Segment Group 29 ------------------------ C 1 -----+|| QTY, Quantity M 1 ||| RNG, Range details C 1 ||| ---- ---------------------------------------------------------+|| || --- Segment Group 30 ------------------------ C 1 -----+|| PCD, Percentage details M 1 ||| RNG, Range details C 1 ||| ---- ---------------------------------------------------------+|| || --- Segment Group 31 ------------------------ C 1 -----+|| MOA, Monetary amount M 1 ||| RNG, Range details C 1 ||| ---- ---------------------------------------------------------+|| || --- Segment Group 32 ------------------------ C 1 -----+|| RTE, Rate details M 1 ||| RNG, Range details C 1 ||| ---- ---------------------------------------------------------+|| || --- Segment Group 33 ------------------------ C 1 -----+|| TAX, Duty/tax/fee details M 1 ||| MOA, Monetary amount C 1 ||| ---- ---------------------------------------------------------+++ UNS, Section control M 1 --- Segment Group 34 ------------------------ C 10 -------+ TAX, Duty/tax/fee details M 1 | MOA, Monetary amount C 2 | ---- -----------------------------------------------------------+ CNT, Control total C 5 UNT, Message trailer M 1