Integration

Epicor Prophet 21 (Prophet 21) and Salesforce

Epicor Prophet 21 (Prophet 21) to Salesforce, and changes in Salesforce back to Epicor Prophet 21 (Prophet 21). Both directions are separate sync products, configured independently, and this page shows what the shipped catalogue sets up for this pair.

  • Phase 1 · forward sync
  • Phase 2 · write-back
How Epicor Prophet 21 (Prophet 21) and Salesforce are connectedCommercient Sync Agent reads Epicor Prophet 21 (Prophet 21) into the Data Lake. CRMPro pushes from the Data Lake into Salesforce. TxDownloaderPro carries changes made in Salesforce back through the Data Lake to Epicor Prophet 21 (Prophet 21).Epicor Prophet 21your ERPData LakeCommercientSalesforceyour CRMSync AgentCRMProPhase 1 · forward syncPhase 2 · TxDownloaderPro write-back

In plain wordsRecords from Epicor Prophet 21 (Prophet 21) are pushed into Salesforce, and changes made in Salesforce are carried back to Epicor Prophet 21 (Prophet 21). Each direction is its own sync with its own configuration.

This page documents what the shipped catalogue sets up. For the commercial overview of the same pair — editions, licensing and how to buy it — Commercient publishes Epicor Prophet 21 (Prophet 21) to Salesforce integration on commercient.com .

Phase 1 — Epicor Prophet 21 (Prophet 21) to Salesforce

What you getRecords from Epicor Prophet 21 (Prophet 21) become Commercient Prophet 21 Ship To Address Managed Custom Object, Commercient Prophet 21 Inventory Master Managed Custom Object, products, Commercient Prophet 21 Warehouse Managed Custom Object, accounts, Commercient Prophet 21 Terms Managed Custom Object, contacts, Commercient Prophet 21 Customer Managed Custom Object, Commercient Prophet 21 Salesperson Managed Custom Object, Opportunity, Opportunity line item, Order, Order product, Quote, Quote line item, Commercient Prophet 21 Invoice Header Managed Custom Object, Commercient Prophet 21 Invoice Line Managed Custom Object, Price book object, Price book entry, Commercient Prophet 21 Sales Order Detail Managed Custom Object, Commercient Prophet 21 Sales Order Header Managed Custom Object in Salesforce. New records are created and existing ones updated.

GroupBusiness outcomeObjectsSource tables and views
Ship toERP Customer, shipping address data becomes Commercient Prophet 21 Ship To Address Managed Custom Object in Salesforce. New records are created and existing ones updated; none are deleted.Commercient Prophet 21 Ship To Address Managed Custom Objectshipping addresses, customers
Inv MasterThe templates push Commercient Prophet 21 Inventory Master Managed Custom Object to Salesforce. New records are created and existing ones updated; none are deleted.Commercient Prophet 21 Inventory Master Managed Custom Objectinventory items
ProductERP inventory master data becomes Product in Salesforce. New records are created and existing ones updated; none are deleted.Productinventory items
WarehouseERP inventory location, inventory master, location data becomes Commercient Prophet 21 Warehouse Managed Custom Object in Salesforce. New records are created and existing ones updated; none are deleted.Commercient Prophet 21 Warehouse Managed Custom Objectinventory locations, inventory items, locations
Product item Reverse lookupERP inventory master data becomes Commercient Prophet 21 Inventory Master Managed Custom Object in Salesforce. New records are created and existing ones updated; none are deleted.Commercient Prophet 21 Inventory Master Managed Custom Objectinventory items
AccountIn addition to creating the Account record from your ERP customer records, Commercient syncs over the entire Accounting AR Customer record into a Commercient AR Customer object which is a Managed Custom Object (MCO). A lookup field is provided to lookup to the default AR Customer record MCO from the Account record. New records are created and existing ones updated; none are deleted.Account, Commercient Prophet 21 Terms Managed Custom Object, Contact, Commercient Prophet 21 Customer Managed Custom Object, Commercient Prophet 21 Salesperson Managed Custom Objectcustomers, addresses, shipping addresses, terms, contacts
CRM Opportunity and LineERP order entry header, quote header, inventory master data becomes Opportunity, Opportunity line item in Salesforce. New records are created and existing ones updated; none are deleted.Opportunity, Opportunity line itemquote headers, order entry headers, quote lines, inventory items
CRM Order and LineERP Address, order entry header, quote header data becomes Order, Order product in Salesforce. New records are created and existing ones updated; none are deleted.Order, Order productorder entry headers, addresses, quote headers, order entry lines, inventory items
CRM Quote and LineERP Address, order entry header, quote header data becomes Quote, Quote line item in Salesforce. New records are created and existing ones updated; none are deleted.Quote, Quote line itemquote headers, order entry headers, addresses, quote lines, order entry lines, inventory items
Invoice History HeadersThe Invoices from the ERP invoice module are synchronized to the Commercient Invoice Header (MCO) object in CRM. Customer service and sales people can visualize the status of the Invoice such as open, closed, as well as the balance remaining and the due date. New records are created and existing ones updated; none are deleted.Commercient Prophet 21 Invoice Header Managed Custom Objectinvoice headers
Open AR Invoice HeaderThe detail lines on open invoices are visible too so that you are aware of what items you are awaiting payment on from your customer. New records are created and existing ones updated; none are deleted.Commercient Prophet 21 Invoice Line Managed Custom Objectinvoice lines
PricebookERP inventory master data becomes Price book object, Price book entry, Price book entry in Salesforce. New records are created and existing ones updated; none are deleted.Price book object, Price book entryinventory items
Sales orderThe templates push Commercient Prophet 21 Sales Order Detail Managed Custom Object, Commercient Prophet 21 Sales Order Header Managed Custom Object to Salesforce. New records are created and existing ones updated; none are deleted.Commercient Prophet 21 Sales Order Detail Managed Custom Object, Commercient Prophet 21 Sales Order Header Managed Custom Objectorder entry lines, order entry headers

Destination objects

  • Commercient Prophet 21 Ship To Address Managed Custom Object
  • Commercient Prophet 21 Inventory Master Managed Custom Object
  • Product
  • Commercient Prophet 21 Warehouse Managed Custom Object
  • Account
  • Commercient Prophet 21 Terms Managed Custom Object
  • Contact
  • Commercient Prophet 21 Customer Managed Custom Object
  • Commercient Prophet 21 Salesperson Managed Custom Object
  • Opportunity
  • Opportunity line item
  • Order
  • Order product
  • Quote
  • Quote line item
  • Commercient Prophet 21 Invoice Header Managed Custom Object
  • Commercient Prophet 21 Invoice Line Managed Custom Object
  • Price book object
  • Price book entry
  • Commercient Prophet 21 Sales Order Detail Managed Custom Object
  • Commercient Prophet 21 Sales Order Header Managed Custom Object

Phase 2 — Salesforce back to Epicor Prophet 21 (Prophet 21)

What you getChanges made in Salesforce to Quote, Opportunity, Order, Sales Order, accounts, contacts, Customer, Work Order, Service Order, Work order, Ship to are carried back to Epicor Prophet 21 (Prophet 21).

ProcessWhat it deliversSource → destinationTemplatesOperations
Sales OrderSalesforce Quote to Epicor Prophet 21 QuoteQuote, Opportunity, Order → Quote, Sales Order7create / update
Create CustomerSalesforce Account to Epicor Prophet 21 CustomerAccount → Contact, Customer2create / update
Create ContactSalesforce Contact to Epicor Prophet 21 Contact ImportContact → Contact1create / update
Create Customer Export FilesSalesforce Account to Epicor Prophet 21 Customer - TSV File ExportAccount → Customer1create / update
Create Customer File ExportSalesforce Account to Epicor Prophet 21 Customer File ExportAccount → Customer1create
Create New Service Order - File ExportSalesforce Work Order to Epicor Service Order - File ExportWork Order → Service Order1create
Create New Service Order with Transaction APISalesforce Work Order to Epicor Prophet 21 Service OrderWork Order → Service Order1create
(unnamed)Salesforce Work Order to Epicor Prophet 21 Service OrderWork order → Service Order1create
(unnamed)Salesforce Account to Epicor Prophet 21 Ship toAccount → Ship to1create

Objects moved

  • Quote
  • Opportunity
  • Order
  • Sales Order
  • Account
  • Contact
  • Customer
  • Work Order
  • Service Order
  • Work order
  • Ship to

Setting up Epicor Prophet 21 (Prophet 21) and Salesforce from the CLI

One wizard stands the tenant up, and it is the same five steps for every pair: register, capture the server IP, connect the CRM, declare the ERP connector, then import and enable the sync processes. What changes between pairs is the CRM’s connection mode and the ERP’s connector type.

1. Register the tenant

Registration creates the account, emails a verification link, and — once the Data Lake is seeded — prints a once-only bootstrap API key valid for seven days. The three consent flags are the registrant’s own decision, and the server refuses start without all three.

# which instance types sign-up accepts - run this first and use Epicor Prophet 21 (Prophet 21)'s code below
$ dlake register erps

# the three consent flags are the registrant’s decision - ask before passing them
$ dlake register start --generate-password \
$   --email <email> --company "<Company Name>" --phone <tel> \
$   --instance-type <code from dlake register erps> \
$   --consent-crm-backup --consent-erp-backup --consent-phone

# after the human clicks the verification link: watch for the seed and catch the key
$ dlake register status --watch

# the bootstrap key expires in 7 days - mint a durable one while it is still valid
$ dlake admin create_api_key --keyName "<tenant>-setup" --expirationDays 90

2. Connect Salesforce and declare Epicor Prophet 21 (Prophet 21)

Steps 3 to 5 of the wizard are admin-plane tools, they are safe to re-run, and the server enforces their order — attempt the CRM step before the server IP is captured and it answers 409 naming the step you skipped.

# the authoritative answer to where a registration got to - first call when resuming
$ dlake admin registration_state

# step 3: record the server IP (a prerequisite for the CRM step)
$ dlake admin registration_capture_server_ip --ipAddress <ip>

# step 4: the catalog lists every CRM with its authMode and the fields it needs
$ dlake admin registration_crm_catalog
$ dlake admin registration_crm_select --crmName Salesforce
# an OAuth CRM: the catalog’s callbackMode says which leg this one takes
$ dlake registration oauth --crm Salesforce
# this provider’s flow ends in a PIN, emailed by the complete call itself; the verb reads it hidden (or --pin-stdin)
$ dlake registration pin --crm Salesforce
# the connection is incomplete without this call, however healthy the rest looks
$ dlake registration action --crm Salesforce --action SalesforceSetup
$ dlake admin registration_crm_finalize

# step 5: the catalog lists the connector types and the fields each one needs
$ dlake admin registration_connector_catalog
$ dlake admin registration_connector_submit \
$   --connectorType <type from the catalog> --erpName <Epicor Prophet 21 (Prophet 21) code> --fields @fields.json
$ dlake admin registration_connector_provision
$ dlake admin registration_provisioning_status

3. Review and enable the Phase 1 processes

The shipped templates listed above are what crmpro_apply_template imports. Every one of them imports its process inactive, so an imported process does nothing until an operator activates it — read the process and its field mapping first, because an object with no mapped fields pushes nothing and records no error.

# the default-template catalog, and the mapping each template carries
$ dlake admin crmpro_templates --profile <tenant>

# what exists on the tenant now, and the master sync flag
$ dlake admin crmpro_list_processes --profile <tenant>
$ dlake admin crmpro_sync_status --profile <tenant>

# read a process and its field mapping BEFORE activating it
$ dlake admin crmpro_get_process --profile <tenant> --recordId <id>
$ dlake admin crmpro_field_mapping --profile <tenant> --recordId <id>

# turn the forward sync on
$ dlake admin crmpro_set_sync_enabled --profile <tenant> --enabled true

Processes run in a fixed order, and that order is a dependency order: a process that depends on another’s records sees them only once that process has run, so a parent flows on one run and its children on the next. The full order for this pair is on the Phase 1 page.

The wizard in full, including resuming a setup days later: Setting up an integration with dlake · Registering a new Data Lake · CRMPro (forward sync).

0

Source on GitHub

This page is generated from the skill pages in the dlake CLI repository. Those pages are the authority; if they disagree with anything here, they are right.

Epicor Prophet 21 (Prophet 21) and Salesforce: common questions

Which way does data move between Epicor Prophet 21 (Prophet 21) and Salesforce?

Both ways, as two separate syncs. Phase 1 is CRMPro, the forward sync that pushes Epicor Prophet 21 (Prophet 21) records into Salesforce. Phase 2 is TxDownloaderPro, the write-back that carries changes made in Salesforce back to Epicor Prophet 21 (Prophet 21). They are configured independently, and a tenant can run either on its own.

What do Phase 1 and Phase 2 mean?

They are the two sync products the on-premises agent can run. Phase 1 is CommercientCRMPro, product 11, the forward sync from the source system into the CRM. Phase 2 is CommercientTxDownloaderPro, product 22, the write-back in the other direction. Registering a product says what to run; the Phase 1 and Phase 2 configuration says what it runs on.

What does the forward sync into Salesforce actually create?

The shipped catalogue carries 13 template groups for this pair: Ship to, Inv Master, Product, Warehouse, Product item Reverse lookup, Account, CRM Opportunity and Line, CRM Order and Line and 5 more. Each group sets up its own sync process, and the integration page says what each one delivers.

Which Salesforce objects does the forward sync write?

Commercient Prophet 21 Ship To Address Managed Custom Object, Commercient Prophet 21 Inventory Master Managed Custom Object, Product, Commercient Prophet 21 Warehouse Managed Custom Object, Account, Commercient Prophet 21 Terms Managed Custom Object, Contact, Commercient Prophet 21 Customer Managed Custom Object and 13 more. Those are the kinds of Salesforce record the shipped templates write for a Epicor Prophet 21 (Prophet 21) source; nothing else is written unless you add templates of your own.

Does the forward sync delete anything in the CRM?

No. Every shipped group for this pair creates new records and updates existing ones; none are deleted.

What does the write-back from Salesforce create in Epicor Prophet 21 (Prophet 21)?

The default set ships 9 processes for this pair: Sales Order, Create Customer, Create Contact, Create Customer Export Files, Create Customer File Export, Create New Service Order - File Export, Create New Service Order with Transaction API, (unnamed) and 1 more. Each one takes a saved query against Salesforce, an inbound mapping document, and writes the result into Epicor Prophet 21 (Prophet 21).

View moreShow less
Which objects does the write-back move?

Quote, Opportunity, Order, Sales Order, Account, Contact, Customer, Work Order and 3 more. Those are the kinds of Salesforce record the shipped processes carry back to Epicor Prophet 21 (Prophet 21).

What does "Phase 2 ready" mean?

It means the tenant has at least one TxDownloaderPro process. Creating a process with txdownloaderpro_create_process is what flips a customer to Phase 2 ready; registering the product alone does not, because registering says what to run and the configuration says what it runs on.

How do I see the write-back processes and whether they are failing?

dlake admin txdownloaderpro_list_processes returns every Phase 2 process with its 30-day unresolved-error count, which is the same grid the portal shows. txdownloaderpro_get_process returns one process in its edit shape, including the query and both mapping documents.

How do I stop the two directions looping?

dlake admin txdownloaderpro_circular_sync_check takes a process id and names the CRM objects that also have an active Phase 1 configuration. Those are the objects where a write-back can be picked up again by the forward sync, so check it before activating a process on this pair.

Can an AI agent set this up?

Yes, over the admin control plane or the CLI — the same tools either way. The crmpro_* and txdownloaderpro_* tools cover listing, reading, creating and updating processes. They need a full-scope key that belongs to a user holding the Admin role, and every write is audited.

Where is the authoritative source for this pair?

The skill pages in the dlake CLI repository, which is where this page is generated from. The forward sync page is linked at the foot of the integration page, and the same text is readable in the terminal with dlake skills show.

Related

Every ERP and CRM integration · CRMPro (forward sync) · TxDownloaderPro (writeback sync) · AI agents & MCP · Salesforce integrations on commercient.com