In this article
Migrating EDI into Microsoft Dynamics 365 is a high-stakes project with immediate business impact if not handled precisely. The risk is real: a poorly managed migration can disrupt live order fulfillment, delay invoice payments, and even break crucial trading partner relationships. The following in-depth checklist consolidates years of BOLD VAN experience with D365, combining expert-recommended safeguards and actionable steps so your migration delivers continuity, compliance, and cost control—all while protecting your open orders and invoices.
Migration Risk in D365 EDI Projects
Moving EDI to D365 involves changes to your ERP, data integration layer, and EDI mapping at once. Each of these areas introduces risk:
- EDI field misalignments causing stuck or rejected orders
- Tax or freight fields misconfigured, leading to invoice denial
- Potential for duplicate shipments if handover between old and new systems is unclear
Forward-thinking teams manage D365 migrations as structured, phased programs. This approach provides explicit controls over live orders, posted invoices, and each window of partner testing. When you follow a proven migration checklist and leverage a robust partner such as BOLD VAN, you sharply minimize both downtime and compliance errors.
Always document: your complete trading partner and document inventory, a timeline-driven cutover runbook, and a rigorously tested rollback plan. These elements are proven to prevent the most costly EDI mistakes during migration.
D365 EDI Pre-Migration Checklist
Before any technical activity, create complete transparency over your legacy EDI environment and what success inside D365 should look like. Use this checklist to de-risk your migration step by step.
1. Inventory Your EDI Flows
- List all trading partners (retailers, 3PLs, marketplaces, etc.)
- Map current document types: 850, 855, 856, 810, 940, 945, 997, etc.
- Quantify transaction volumes: daily, weekly peaks
- Note current VAN/AS2/API setup and system endpoints
- Diagram connections to ERP, WMS, and portals
2. Map Legacy vs. Future D365 Data Flows
- Diagram how orders, shipments, and invoices move today
- Clarify how this must change inside D365
- Identify system(s) of record for each type pre- and post-migration
3. Cleanse and Validate Key Data
- Audit customer/vendor IDs, item masters, and terms
- Validate EDI-relevant fields match what D365 will expect
- Create readiness scorecards for each key data domain
4. Confirm All EDI Mappings
- Map every inbound/outbound EDI field to its D365 counterpart
- Document conditional logic (tax, payment terms, customer-specified fields)
- Define behaviors for missing data, error trapping, and validation handling
5. Select Integration Partner and Migration Model Early
- Decide: maintain existing VAN or select a new modern provider
- Evaluate cost/benefit (for example, BOLD VAN’s trading partner pricing enables up to 83% cost reductions)
- Ensure integration provider is chosen before testing—build in time for parallel runs and robust onboarding
| Checklist Activity | Responsibility | Recommended Timing |
|---|---|---|
| Trading partner and doc inventory | EDI coordinator | 4 months before cutover |
| Legacy/D365 data flow diagrams | IT/solutions architect | 100 days before cutover |
| Data cleansing | Data/operations team | 90 days before cutover |
| Mapping and transformation rules | EDI team | 75 days before cutover |
| EDI provider selection/contract | CFO/IT | 60 days before cutover |
| Partner notifications | EDI/operations | 2-3 months before cutover |
Protecting Orders and Invoices During Cutover
The days leading up to D365 go-live represent the highest risk. Separating master data from transactional data, agreeing on systems of record, and rehearsing a detailed runbook are essential.
6. Migrate Master Data Early
- Load customers, items, and locations in advance of the actual cutover
- Test EDI flows with this master data before introducing new live orders/invoices
7. Assign System Ownership for Transactions
- During transition, only one ERP should own newly received orders
- Suppress shipment/invoice updates from the legacy system post-cutover
- Flag open transactions for traceability across both systems
8. Test and Document Your Cutover Runbook
- List and sequence all endpoint switches and freeze windows
- Export/import open orders and invoices with checkpoints for verification
- Schedule spot checks for volume and financial accuracy
- Practice the entire cutover in a rehearsal prior to the real event
9. Prepare a Clear, Rehearsed Rollback Plan
- Have the ability to redirect EDI endpoints back to the legacy stack on short notice
- Set clear rollback thresholds—e.g., invoice error rates or failed acknowledgments
- Draft partner communication templates for any contingency
Partner Testing and Parallel Runs Explained
Trading partner testing is not a checkbox exercise. Success requires real end-to-end scenarios, with at least 60–90 days of advance notification and a minimum two-week parallel run. Avoiding rejections and chargebacks after go-live depends on the rigor of these cycles.
10. Coordinate and Notify Partners Early
- Send clear migration notices well ahead of time, with specifics on document types and endpoints
- Share new testing requirements, endpoint credentials, and go-live criteria
- Confirm testing support windows with each partner
11. Execute Multi-Stage Testing per Partner
- Run connection and acknowledgment tests, business scenario validations, and timed volume spikes
- Simulate peak production patterns
- Address errors in mapping or endpoint setup immediately
12. Parallel Feeds: Your Best Insurance
- Route real orders and acknowledgments through both legacy and new D365-connected flows in parallel
- Compare order status, error rates, and financial impact side by side
- With BOLD VAN, all test and production traffic can be monitored in real time in the BOLD Manager portal, simplifying issue resolution and making parallel runs manageable—even for teams with limited support bandwidth
Post-Go-Live Monitoring and Audit
Even smooth migrations require special vigilance the first 30 days after cutover. Early detection and rapid reaction will keep operations stable and preserve trading partner trust.
13. Conversion Runbook and Checklist for Go Live
- Verify each migrated dataset and endpoint
- Monitor 997 and acknowledgment flows for completeness
- Spot-check invoice and order posting for financial precision
- Use backup data for cross-checking and issue remediation
14. Focused Monitoring: Metrics That Matter
- Track order and invoice rejection/acceptance rates daily
- Monitor 997s (and equivalents) for prompt acknowledgment
- Review chargebacks, deduction trends, and any mapping or transactional anomalies
- Maintain full auditability using searchable portals like BOLD Manager, which stores 90 days of live and 7 years of archived EDI data
15. Legacy System Retirement
- Do not decommission old systems until all cutover validation, partner confirmations, and data reconciliation steps are complete
- Prepare audit-ready reports proving every partner has switched and all traffic is flowing only through D365
- Ensure historical EDI data is archived in compliance with audit requirements
Frequently asked questions
How far in advance should you start EDI partner testing for a D365 migration?
Most experts recommend beginning partner-by-partner testing 60 to 90 days ahead of final cutover—enough time for mapping corrections and two or more testing cycles.
Is a parallel EDI run necessary during migration?
Yes, running parallel feeds between the legacy platform and D365-connected system is best practice. Many companies maintain both flows for at least two weeks, using the live data for validation.
How do you avoid duplicate orders or invoices?
Clearly define which ERP system owns transaction creation and fulfillment during the migration phase. Only one should process new live orders at a given time, with cross-system flags for transparency.
What does a D365 EDI migration runbook include?
A comprehensive runbook lists step-by-step tasks, timing, accountabilities, dependencies, verification checks, and rollback criteria—supported by clear documentation for EDI endpoints and trading partner transitions.
How does BOLD VAN reduce D365 EDI migration risk and cost?
BOLD VAN enables fast, low-risk migration—often completed in a single day, without service interruption or the need to update partner connections. Its trading partner pricing and unlimited transaction model create proven cost reductions up to 83%, with all document history accessible for audits and daily troubleshooting. The BOLD Manager portal and expert customer support help you stay ahead of potential issues.




