Skip to content
ERP Migration

How to Document As-Is Processes Before Starting an ERP Modernization Project

A practical guide for CIOs and ERP consultants on documenting current business processes to reduce migration risk, ensure data integrity, and define clear requirements for ERP modernization.

9 min readSysGenPro Editorial
How to Document As-Is Processes Before Starting an ERP Modernization Project

How to Document As-Is Processes Before Starting an ERP Modernization Project

Documenting as-is processes involves systematically capturing the current state of business operations, including workflows, data flows, system dependencies, and manual workarounds, before initiating an ERP modernization. This foundational step is critical because it establishes a baseline for gap analysis, ensures accurate data migration planning, and identifies hidden risks that could disrupt operational continuity. Without a clear understanding of how the business currently functions, organizations risk migrating inefficiencies, overlooking critical compliance requirements, or failing to configure the new ERP system to meet actual user needs. The primary risks to control include data loss due to incomplete mapping, process breakdowns during cutover, and user resistance caused by unaddressed workflow changes. A rigorous as-is documentation phase reduces these risks by providing a factual basis for decision-making, enabling stakeholders to distinguish between necessary legacy functions and obsolete practices that should be eliminated in the new system.

Preparation: Defining Scope and Stakeholders

Before beginning documentation, define the scope of the modernization project. Identify which business units, departments, and processes are included in the initial phase. This prevents scope creep and ensures that documentation efforts are focused on areas that will be impacted by the new ERP. Establish a governance structure that includes a project sponsor, a process owner for each major business area, and a technical lead responsible for system-level details. The process owner is accountable for the accuracy of the business logic, while the technical lead documents system configurations, integrations, and data structures. It is essential to secure executive buy-in for this phase, as it requires significant time from operational staff who are often focused on day-to-day tasks. Communicate the value of this work clearly: accurate documentation leads to a smoother implementation, lower total cost of ownership, and a system that better supports business goals.

Identifying Key Process Owners

Select process owners who have deep knowledge of both the business logic and the current system's limitations. These individuals should be able to explain not only how a process is supposed to work but also how it actually works, including any manual workarounds or exceptions. Avoid selecting owners solely based on seniority; instead, choose those who are actively involved in the daily execution of the process. For complex processes, consider involving multiple stakeholders to capture different perspectives, such as finance, operations, and IT. Document the roles and responsibilities of each stakeholder in a RACI matrix to ensure clarity on who is responsible for providing information, who is accountable for its accuracy, and who must be consulted or informed.

Data Collection Methods and Techniques

Use a combination of qualitative and quantitative methods to gather information. Qualitative methods include interviews, workshops, and shadowing, where the documentation team observes employees performing their tasks. These methods are effective for uncovering tacit knowledge, informal workarounds, and pain points that are not visible in system logs. Quantitative methods involve analyzing system data, such as transaction volumes, error rates, and user activity logs, to understand the scale and frequency of processes. Combine these approaches to create a comprehensive picture of the current state. For example, an interview might reveal that a specific approval step is often bypassed due to delays, while system logs can confirm the frequency of these bypasses and the associated financial impact. This dual approach ensures that the documentation reflects both the intended and actual state of the business.

Conducting Effective Interviews and Workshops

Prepare structured interview guides that cover key areas such as process triggers, inputs, outputs, decision points, and exceptions. Ask open-ended questions to encourage detailed responses, such as 'Walk me through how you handle a customer return from start to finish.' Follow up with specific questions to clarify ambiguities, such as 'What happens if the customer does not have a receipt?' Record these sessions with permission, and share the recordings or transcripts with participants for verification. Workshops are useful for validating findings and reaching consensus among stakeholders. Use visual aids, such as whiteboards or digital collaboration tools, to map out processes in real-time. This interactive approach helps identify gaps and inconsistencies immediately, rather than waiting for the documentation to be finalized.

Mapping Business Processes and Data Flows

Create visual diagrams that illustrate the sequence of activities, decision points, and handoffs between roles or systems. Use standard notations, such as BPMN (Business Process Model and Notation), to ensure clarity and consistency. Include both the happy path and exception paths, as exceptions often reveal critical risks and opportunities for improvement. Map data flows alongside process flows to show how information moves through the system. Identify where data is created, modified, stored, and consumed. This is particularly important for data migration planning, as it helps determine which data elements need to be extracted, transformed, and loaded into the new ERP. Highlight any manual data entry points, as these are often sources of errors and inefficiencies that can be automated in the new system.

Process ElementDescriptionCurrent SystemManual WorkaroundRisk Level
Order EntryCustomer orders are received via email and manually entered into the legacy system.Legacy ERPNoneHigh
Inventory AdjustmentPhysical counts are performed monthly and adjustments are made via spreadsheet.ExcelManual reconciliation with ERPMedium
Invoice ApprovalInvoices over $10,000 require CFO approval, which is often delayed.Legacy ERPEmail requests to CFOHigh

Identifying System Dependencies and Integrations

Document all systems that interact with the current ERP, including CRM, e-commerce platforms, payment gateways, and third-party logistics providers. For each integration, specify the data exchanged, the frequency of exchange, the protocol used (e.g., API, file transfer), and the error handling mechanisms. Identify any custom code or middleware that facilitates these integrations, as these components will need to be re-evaluated or rebuilt for the new ERP. Understand the dependencies between processes and systems; for example, if the inventory system relies on real-time data from the warehouse management system, any disruption in this flow could impact order fulfillment. This information is critical for planning the integration architecture of the new ERP and for identifying potential bottlenecks or single points of failure.

Analyzing Custom Configurations and Code

Review any customizations made to the legacy ERP, including custom fields, reports, workflows, and code. Determine whether these customizations are essential to the business or if they were implemented to work around limitations in the standard system. If they are essential, document the business requirement they address so that the new ERP can be configured to meet the same need. If they are workarounds, consider whether the new ERP's standard functionality can eliminate the need for customization. This analysis helps reduce technical debt and simplifies the new system's architecture. Be cautious when assuming that custom code can be migrated directly; compatibility with the new ERP's platform and APIs must be verified against the vendor's official documentation.

Gap Analysis and Requirements Definition

Compare the documented as-is processes with the capabilities of the target ERP system. Identify gaps where the new system does not natively support a current business process. For each gap, determine whether it can be addressed through configuration, customization, or process change. Prioritize gaps based on their impact on business operations and the cost of resolution. This gap analysis forms the basis for the requirements specification, which will guide the configuration and development of the new ERP. Ensure that the requirements are specific, measurable, achievable, relevant, and time-bound (SMART). For example, instead of stating 'The system should handle returns,' specify 'The system should allow customers to initiate returns online, generate a return authorization number, and update inventory within 24 hours of receipt.' This level of detail ensures that the new system meets the business's needs and provides a clear basis for testing and acceptance.

Validation and Sign-Off

Before finalizing the as-is documentation, validate it with the process owners and key stakeholders. Schedule review sessions to walk through the documented processes and data flows, and solicit feedback. Address any discrepancies or omissions promptly. Obtain formal sign-off from the process owners, indicating that the documentation accurately reflects the current state of the business. This sign-off is crucial for establishing a baseline and for holding stakeholders accountable for the accuracy of the information provided. It also serves as a reference point for future audits and for measuring the success of the modernization project. If significant changes are identified during validation, update the documentation and re-validate as necessary.

Common Pitfalls and How to Avoid Them

  • Assuming that the documented process is the actual process: Always verify with system logs and user interviews to uncover workarounds.
  • Overlooking exception paths: Focus on the happy path and neglecting exceptions can lead to critical failures during implementation.
  • Involving only IT staff: Business users have the most accurate knowledge of process details and pain points.
  • Failing to document data quality issues: Poor data quality in the legacy system can compromise the integrity of the new ERP.
  • Not securing executive buy-in: Without support from leadership, process owners may not prioritize documentation tasks.

Leveraging Documentation for Future Phases

The as-is documentation is not a one-time deliverable; it is a living document that should be updated as the project progresses. Use it to inform the design of the to-be processes, the data migration strategy, and the testing plan. For example, the data flow maps can be used to define the data migration scope and to identify data cleansing requirements. The process maps can be used to design user acceptance tests and to train end users. By leveraging the as-is documentation throughout the project, you ensure that the new ERP system is aligned with the business's needs and that the transition is as smooth as possible. Regularly review and update the documentation to reflect any changes in the business or the project scope.

Conclusion

Documenting as-is processes is a critical step in any ERP modernization project. It provides the foundation for a successful implementation by ensuring that the new system is configured to meet the business's actual needs, that data is migrated accurately, and that risks are identified and mitigated. By following a structured approach that includes stakeholder engagement, comprehensive data collection, detailed process mapping, and rigorous validation, organizations can reduce the risk of project failure and achieve a smoother transition to the new ERP. Invest the time and resources necessary to get this phase right, and you will reap the benefits of a more efficient, reliable, and scalable ERP system.

Written by
SysGenPro Editorial

SysGenPro Editorial

Platform & solutions team

Practical guidance on ERP, AI automation, cloud deployment and enterprise transformation from the SysGenPro team.

Share this article

Frequently asked questions

Common questions on this topic. Talk to our team for anything specific to your business.

01What is the difference between as-is and to-be process documentation?

As-is documentation captures the current state of business processes, including all workarounds and inefficiencies. To-be documentation describes the desired future state, optimized for the new ERP system. The gap between the two informs the implementation strategy.

02How detailed should as-is process documentation be for an ERP project?

Documentation should be detailed enough to understand the business logic, data flows, and system dependencies. It should include exception paths and manual workarounds, but does not need to document every minor task. Focus on processes that will be impacted by the new ERP.

03Who is responsible for documenting as-is processes in an ERP migration?

A combination of business process owners, IT staff, and ERP consultants. Process owners provide business knowledge, IT staff provide system details, and consultants facilitate the documentation process and ensure best practices are followed.

04What tools are best for mapping as-is business processes?

Tools like Lucidchart, Visio, or Miro are popular for creating process maps. For data flow mapping, tools like Draw.io or specialized BPMN tools can be used. The choice of tool should depend on the team's familiarity and the complexity of the processes.

05How do you handle undocumented manual processes during ERP modernization?

Identify these processes through interviews and shadowing. Document them as part of the as-is state, and then evaluate whether they should be automated, eliminated, or retained in the new system. This is an opportunity to improve efficiency and reduce errors.

06Why is documenting as-is processes critical for data migration?

It helps identify which data elements are critical to the business, where they are stored, and how they are used. This information is essential for planning the data extraction, transformation, and loading process, and for ensuring data integrity in the new system.

Continue learning
View all articles
Explore the platform

Where to go next

Browse the knowledge hub

See how SysGenPro fits your business

Discuss your workflows, modules and deployment options with our team.

Back to resources