Skip to content
ERP Migration

How to Document As-Is Processes Before Starting ERP Migration

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 the target ERP system.

8 min readSysGenPro Editorial
How to Document As-Is Processes Before Starting ERP Migration

How to Document As-Is Processes Before Starting ERP Migration

Documenting as-is processes before starting an ERP migration involves systematically capturing current business workflows, data flows, system dependencies, and manual workarounds to establish a factual baseline for the target system. This step is critical because it reveals hidden complexities, identifies gaps between current operations and standard ERP functionality, and defines the scope of customization or process re-engineering required. Without accurate as-is documentation, projects face significant risks of scope creep, data loss, integration failures, and user resistance. The primary goal is to create a shared understanding among stakeholders, IT teams, and business users, ensuring that the migration plan addresses real operational needs rather than assumptions. This documentation serves as the foundation for requirements definition, data mapping, and testing strategies, directly impacting project cost, timeline, and long-term success.

Why As-Is Documentation Is Critical for Migration Success

Many ERP migrations fail not due to technical limitations but because of a misunderstanding of current business operations. As-is documentation provides the evidence needed to make informed decisions about which processes to automate, which to standardize, and which to redesign. It helps identify dependencies on legacy systems, third-party applications, and manual spreadsheets that may not be immediately visible. By documenting the current state, project teams can accurately estimate the effort required for data cleansing, interface development, and user training. Furthermore, it establishes a baseline for measuring post-migration performance and validating that the new system meets business objectives. This phase reduces the risk of overlooking critical business rules or exception handling procedures that could disrupt operations during cutover.

Step 1: Define Scope and Identify Process Owners

The first step is to define the scope of the migration, identifying which business units, departments, and processes are included. Not all processes may be migrated immediately, especially in phased rollouts. For each in-scope process, assign a process owner who has deep knowledge of the current workflow and authority to make decisions. These owners should be involved from the start to ensure accuracy and buy-in. Create a process inventory that lists all major business processes, such as order-to-cash, procure-to-pay, and record-to-report. This inventory serves as the roadmap for the documentation effort. Ensure that the scope aligns with the project charter and that all stakeholders agree on the boundaries of the migration.

Step 2: Conduct Process Discovery Workshops

Engage business users, managers, and IT staff in structured workshops to map out current processes. Use techniques such as interviews, observation, and document review to gather information. Focus on understanding the 'why' behind each step, not just the 'what.' Identify decision points, approval hierarchies, and exception handling procedures. Capture both the ideal process and the actual process, as discrepancies often reveal areas for improvement or hidden risks. Document the systems and tools used at each step, including legacy ERP modules, spreadsheets, email, and third-party applications. This discovery phase is crucial for uncovering manual workarounds and undocumented practices that could impact the migration.

Step 3: Map Data Flows and System Dependencies

For each process, map the data entities involved and how they flow between systems. Identify the source systems, target systems, and any intermediate storage or transformation steps. Document the data fields, formats, and validation rules applied at each stage. This data flow mapping is essential for planning data migration, integration development, and reconciliation. Identify dependencies on other systems, such as CRM, WMS, or financial reporting tools. Understand the frequency and volume of data exchanges, as well as the error handling mechanisms in place. This technical documentation helps IT teams design the integration architecture and data migration strategy for the new ERP system.

Step 4: Identify Business Rules and Exceptions

Business rules are the logic that governs how processes operate, such as pricing rules, discount policies, or approval thresholds. Document these rules explicitly, as they often require customization in the new ERP system. Identify exception handling procedures, which are the steps taken when a process deviates from the standard flow. These exceptions are critical to capture because they often represent complex business logic that is difficult to replicate in a standard ERP configuration. Failure to document exceptions can lead to operational disruptions and user frustration after go-live. Use a consistent format to record business rules, including the condition, action, and owner.

Step 5: Document Manual Workarounds and Gaps

Manual workarounds are common in legacy environments and often indicate gaps in the current system. Document these workarounds, including the steps involved, the tools used, and the frequency of occurrence. These workarounds may need to be automated or redesigned in the new ERP system. Identify gaps between the current process and the standard functionality of the target ERP. This gap analysis helps determine the level of customization required and the potential impact on project cost and timeline. Prioritize workarounds based on their business impact and frequency, focusing on those that pose the highest risk or offer the greatest opportunity for improvement.

Step 6: Validate Documentation with Stakeholders

Once the as-is documentation is drafted, validate it with process owners and key stakeholders. Conduct review sessions to ensure accuracy and completeness. Address any discrepancies or missing information promptly. This validation step is crucial for building trust and ensuring that the documentation reflects the true state of operations. Use the validated documentation as the basis for defining to-be processes and requirements. Establish a change control process for any updates to the as-is documentation, ensuring that all changes are tracked and approved. This rigorous validation process reduces the risk of misalignment and rework later in the project.

Common Pitfalls in As-Is Process Documentation

  • Assuming that the documented process is the actual process without verifying with users.
  • Failing to capture exception handling and manual workarounds.
  • Overlooking dependencies on third-party systems or legacy applications.
  • Not involving process owners in the documentation and validation process.
  • Using inconsistent formats or terminology across different process maps.
  • Ignoring data quality issues and validation rules in the current system.
  • Failing to document security roles and permissions for each process step.
  • Not updating documentation as processes change during the discovery phase.

Tools and Techniques for Effective Documentation

Use a combination of tools and techniques to create clear and comprehensive as-is documentation. Swimlane diagrams are effective for showing responsibilities across different departments or systems. Flowcharts can illustrate decision points and process flows. Data flow diagrams help visualize the movement of data between systems. Use a centralized repository to store all documentation, ensuring that it is accessible and up-to-date. Consider using process mining tools to analyze system logs and identify actual process paths, which can reveal deviations from the documented process. Combine these tools with qualitative insights from workshops and interviews to create a holistic view of the current state.

Linking As-Is Documentation to Migration Planning

The as-is documentation directly informs the migration plan by defining the scope of work for data migration, integration development, and customization. Use the data flow maps to plan data cleansing and transformation rules. Use the system dependency maps to design the integration architecture. Use the business rules and exception handling documentation to define customization requirements. This linkage ensures that the migration plan is grounded in reality and addresses the specific needs of the business. It also helps in estimating the effort and resources required for each workstream. By connecting as-is documentation to migration planning, project teams can make informed decisions and manage risks more effectively.

Best Practices for Maintaining Documentation Quality

Maintain high quality in as-is documentation by establishing clear standards and processes. Use a consistent template for all process maps and data flow diagrams. Define a glossary of terms to ensure that all stakeholders use the same language. Assign a document controller to manage versions and changes. Regularly review and update documentation as new information is discovered. Encourage feedback from stakeholders and incorporate it into the documentation. Use peer reviews to ensure accuracy and completeness. By maintaining high-quality documentation, project teams can reduce misunderstandings and rework, leading to a more successful migration.

Conclusion: The Foundation of a Successful ERP Migration

Documenting as-is processes is a critical step in any ERP migration project. It provides the factual basis for defining requirements, planning data migration, and designing integrations. By following a structured approach to process discovery, mapping, and validation, project teams can reduce risks and improve the chances of a successful migration. Invest time and resources in this phase, as it pays dividends in the form of a more accurate project plan, better user adoption, and a more effective new ERP system. Remember that the goal is not just to document the current state but to understand it deeply enough to make informed decisions about the future state. This foundational work is essential for achieving the business objectives of the migration project.

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 steps, systems, and workarounds. To-be documentation defines the future state of processes after ERP implementation, focusing on standard functionality and improvements. As-is is the baseline for gap analysis, while to-be is the target for configuration and customization.

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

Documentation should be detailed enough to capture all business rules, exception handling, data flows, and system dependencies. It should include specific steps, decision points, and roles involved. The level of detail should be sufficient to plan data migration, integration, and customization without being overly granular to the point of impracticality.

03Who should be responsible for documenting as-is processes?

A combination of business process owners, IT staff, and ERP consultants should be responsible. Process owners provide domain knowledge, IT staff provide technical insights, and consultants facilitate the documentation process and ensure best practices are followed.

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

Tools such as swimlane diagrams, flowcharts, and data flow diagrams are commonly used. Process mining tools can also be used to analyze system logs and identify actual process paths. A centralized repository is essential for storing and managing documentation.

05How long does it take to document as-is processes for a large ERP?

The duration varies depending on the complexity of the business and the number of processes involved. For a large ERP migration, it can take several weeks to a few months. It is important to allocate sufficient time for thorough discovery and validation.

06Why is documenting manual workarounds important in ERP migration?

Manual workarounds often indicate gaps in the current system and may need to be automated or redesigned in the new ERP. Failing to document them can lead to operational disruptions and user frustration after go-live. They are critical for identifying customization requirements.

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