Contents
Overview
Key Features
- Standardised SFTP Submission Protocol: All 3PPMs were given a defined submission format — a CSV file paired with a csv-metadata.json descriptor — and a designated SFTP location to deliver it to. This replaced an ad-hoc, email-driven process with a consistent, auditable intake channel that the integration could reliably detect and process.
- csv-metadata.json Descriptor: The companion metadata file gave the pipeline the context it needed to validate and route a submission before inspecting the data itself. By declaring the filename, pay period, and business unit entities upfront, the JSON file allowed the integration to reject malformed or misrouted submissions at the earliest possible point, without opening the CSV.
- Two-Stage Validation Engine: Validation ran in two discrete, sequential stages. Stage one checked the JSON descriptor for structure and valid values. Stage two checked the CSV data against field-level and business-rule constraints specific to the file type. Decoupling the stages meant that structural problems with the descriptor were caught and reported before any data-level processing began, making failure notifications more actionable.
- Financial and Non-Financial Schema Enforcement: The validation rules applied in stage two differed depending on whether the submission was a financial trial balance or a non-financial property data file. The JSON descriptor declared the type, and the integration applied the corresponding schema — allowing a single pipeline to handle both data streams without conflating their different structural requirements.
- Email Notifications at Every Decision Point: Notifications were generated and dispatched at each stage of the pipeline — JSON validation pass or fail, CSV validation pass or fail, and batch approval or rejection. Every notification included the specific errors or the rejection reason rather than a generic status message, giving 3PPMs and accountants the information needed to act without a separate follow-up.
- Custom Web Portal Approval Workflow: Validated batches were queued in a custom-built web portal for explicit human sign-off before any data was posted to JDE. Authorised users could review the batch, approve it, or reject it with a stated reason — maintaining a controlled, auditable link between validated data and what actually entered the ERP.
- JDE Integration on Approval: Once a batch was approved in the portal, the integration posted the data directly to JD Edwards. The posting step was only reachable after a submission had passed both validation stages and received explicit portal approval, ensuring JDE received clean, reviewed data at every step.
- Batch State Audit Trail: Every submission was tracked through its full lifecycle — from arrival and validation outcomes through portal decision and JDE posting. This gave the team a complete audit trail for any batch and made it straightforward to answer questions about what was submitted, when, by whom, and what happened to it.