Amount Decimal 28 23.3 N Reserved for future use. Omit. ScheduledPayDate Date 10 XML Date N Reserved for future use. Omit . PaymentMethod String 3 Y Identifies the type of disbursement to generate. Permitted values are: ACH - Automated Clearing House CHK - Check WIR - Wire Transfer SeparatePayment String 1 N Controls consolidation of Payment Requests into a single disbursement. Permitted values are: Y – separate disbursement required, consolidation not permitted N – separate disbursement not required, consolidation permitted (default) If blank the system will default to ‘N”. PaymentHandlingCode String 4 Upper N Specifies the Treasury disbursement distribution instructions. Permitted values are: AGPY – Return to Attorney General (Payroll) RTBC – Return to BCPO (Payroll) RADG – Return to Auditor General Comptroller RTCM – Return to Comptroller RTPY – Return to Comptroller (Payroll) RTTR – Return to Treasury Comptroller TREM – Treasury Required for all Checks and for ACH disbursements that are to print a remittance advice. PrintRemittance String 1 N Controls whether or not to print a Remittance Advice Statement for an ACH disbursement. Permitted values are: Y –print the Remittance Advice Statement (default) N – suppress the printing of the Remittance Advice Statement
CN – vendor location to which the contract was issued when different than the Remit-To RecipientLocation on the Header node. Optional. IV – location code for the vendor issuing the invoice when different than the Remit-To RecipientLocation on the Header node. Optional PO – vendor location to which the purchase order was issued when different than the Remit-To RecipientLocation on the Header node. Optional. VendorTaxpayerId String 9 Upper N Used with the following ItemTypes: AC – taxpayer identifier (SSN/EIN) for vendor to which the advancement account check was issued. Optional. CN –taxpayer identifier (SSN/EIN) for vendor to the contract was issued when different than the Remit-To TaxpayerId on the Header node. Optional. IV – taxpayer identifier (SSN/EIN) for the vendor issuing the invoice when different than the Remit-To TaxpayerId on the Header node. Optional. PO – taxpayer identifier (SSN/EIN) for vendor to the purchase order was issued when different than the Remit-To TaxpayerId on the Header node. Optional. Do not include spaces or dashes. SCDUNoncustodialParentName String 10 Upper N Used with the following ItemTypes: SU - First seven letters of the non-custodial parent’s last name, followed by the first three letters of the non-custodial parent’s first name. A comma must be used to separate the last name from the first name when the last name is less than seven characters. Mandatory when the ItemType is SU. SCDUNoncustodialParentSSN Integer 9 Upper N Used with the following ItemTypes: SU - Non-custodial parent’s Social Security Number. Mandatory when the ItemType is SU. SCDUEmploymentTerminated String 1 Upper N Used with the following ItemTypes: SU - The employment termination indicator is used to notify the child support enforcement agency that an individual’s employment has terminated. A Y is placed in this field if the employee has terminated; otherwise the field is not used and should be populated with a blank space.
Node Name Message Parent Node Control Min 0 Max Occurs Unbounded Description Standard response message for inbound interfaces. This will include messages related to processing the request. Attribute Name Data Type Size Format Required Description class String 1 Upper Y must always be “R” Element Name Data Type Size Format Required Description MessageNumber Integer 5 Y This will be PA Treasury generated error message sub - set number. MessageSet Integer 5 Y This will be PA Treasury generated message set number. Severity String 1 Upper Y Severity of message. Values are: E – Error: the issue identified in the document will prevent all payment requests from being processed. M – Message: the message is informational only. W – Warning: the issue with the document not prevent payment requests from being processed. Text String 254 Y Text description of the message. Node Name DataModule Parent Node Acknowledgement Min Occur 0 Max Occurs Unbounded Description DataModule includes messages related to transaction processing. In the standard acknowledgement each payment request is considered a “data module” and is identified by a unique trace identifier. Attribute Name Data Type Size Format Required Description Element Name Data Type Size Format Required Description
Reference Element Y References identifying data sent on the inbound request for each transaction that was processed and related messages. Node Name Reference Parent Node DataModule Min Occur 1 Max Occurs 1 Description References identifying data sent on the inbound request for each Payment Request that was processed and related messages. Attribute Name Data Type Size Format Required Description class String 1 Upper Y Value must always be “R”. Element Name Data Type Size Format Required Description TraceId String 36 Y TraceId sent on the inbound request for each Payment Request that was processed. TraceIdTwo String 36 N Not applicable for this interface, the field will be blank. ErrorFlag String 1 Y Shows if there was an error in the Payment Request. Valid values are “Y” and “N”. If there are errors associated with the TraceId, the value will be passed as “Y”. SystemReferenceOne String 20 N Not implemented on this interface. SystemReferenceTwo String 20 N Not implemented on this interface. SystemReferenceThree Integer 20 N Not implemented on this interface. SystemReferenceFour Integer 20 N Not implemented on this interface. ValidationMessage Element N Standard transactional data message response for inbound interfaces. Node Name ValidationMessage Parent Node DataModule
Expedited Payment Processing Rule: A payment will qualify for expedited processing by Treasury if: a) Comptroller and the responsible Agency secure advance approval from Treasury; b) The payment request includes an appropriate priority code; and c) The payment request a Due Date not more than five days after the Treasury Received Date. Discounted Invoices Payment Rules: • If a payment request includes the Payment Terms and the Payment Terms Basis Date, Treasury will calculate the Discount Date. If the Discount Date allows five or more business days for processing, Treasury will calculate and apply the discount amount to the payment. • If a payment request fails to include either the Payment Terms or Payment Terms Basis Date, the payment request will be rejected. • If a payment request includes a Due Date in addition to the Payment Terms and the Payment Terms Basis Date, Treasury will disregard the Due Date and will calculate the Discount Date. o If the Discount Date allows five or more business days for processing, Treasury will calculate and apply the discount amount to the payment. o If the Discount Date allows less than five business days for processing, or if for any other reason Treasury cannot meet the Discount Date, it will assign payment for the net amount and Net Date provided for by the Payment Terms. o If the Net Date provides less than five business days for processing, Treasury will utilize the Invalid Due Date Rules (non-payroll) to establish the Scheduled Payment Date. The following are examples of how different Payment Term scenarios will be handled: Scenario Due Date Payment Terms Payment Basis Date Discount and Net Date Treasury Received Date Scheduled Payment Date Action Payment Terms provided. Discount can be met but Due Date Less than 5 days from today's date Not provided 2% 10 days Net 30 days 3/28/13 D: 4/8/13 N: 4/26/13 4/4/13 4/26/13 Use Net Date. No Invalid Due Date Apply Payment Terms provided. Not provided 2% 10 days Net 30 days 4/1/13 D: 4/11/13 N: 5/1/13 4/4/13 4/11/13 Use Discount Date. No Invalid
SourceSystem Code list provided in Appendix A of the Guide. Header <internal use> Business Unit Assignment Failure: Please contact support. All payments requests must be assigned an internal Treasury Business Unit to process through the Treasury system. The Business Unit is derived from the SourceSystem and potentially the Funding Department, Payment Class, and Funding Appropriation. Error Header <internal use> Vendor Assignment Failure: Please contact support. All payments requests must be assigned an internal Treasury Vendor Identifier to process through the Treasury system. Error Header <node> ForceBatchProcessing enabled and related PR in same Batch has errors. All PRs in a are marked in Error if one or more PRs in the Batch enountered a validation error and ForceBatchProcessing is enabled. Warning Header BatchId BatchType and BatchId must either both be present and populated or both be omitted. BatchType and BatchId must either both be present and populated or both be omitted. Error Header BatchId Missing BatchId Agencies under the Governor’s jurisdiction that submit payment requests to Treasury that do not flow through the Comptroller Operations IES system are required to provide a 14 digit BatchID. Error Header BatchType Invalid Translate value. BatchType value must be BPO or GRP. Error Header DocumentFormat Invalid Translate value. DocumentFormat must be IMG or XML. Error Header DocumentFormat Missing DocumentFormat - required when DocumentURL is specified The DocumentFormat must be specified when a DocumentURL is provided. Error Header DocumentType Missing Required value. DocumentType is required. Error Header DocumentType Invalid DocumentType - incompatible with SourceSystem The DocumentType must match a value that is eligible to be used for the submitting source system. IES and non-IES use differents sets of values. Error Header DocumentURL Missing DocumentURL - required when DocumentFormat is specified The DocumentURL must be provided when a DocumentFormat is present.