Skip to main content

Epicor Prophet 21 Error Messages

The error messages the Epicor Prophet 21 integration can raise during synchronization, what causes each one, and how subscribers can resolve them.

Overview

This article catalogs the error messages the Epicor Prophet 21 integration can record while synchronizing data between Prophet 21 and iPaaS.com. Errors appear in the iPaaS.com Dashboard under Dashboard / Integration Monitoring / Error Logs, alongside the record and mapping collection that produced them.

Every error carries a code in the form PR21-CAT-NNNN. The code is stable — the wording of a message may be improved over time, but its code never changes and is never reused. Search this page for the code shown in your error log to find the matching entry.

Some resolutions ask you to involve your Managed Integration Service Provider (MiSP) — the partner who owns your mappings, connection settings, and credentials, and who can adjust a mapping collection filter on your behalf. If you administer your own integration, those steps are yours to perform.

iPaaS.com categorizes errors by families. You can learn more about that categorization at Understanding iPaaS.com API Error Codes.

Supported Flows

  • Customer To iPaaS.com

  • Customer Address To iPaaS.com

  • Company To iPaaS.com

  • Location To iPaaS.com

  • Product To iPaaS.com

  • Product Inventory To iPaaS.com

  • Transaction To iPaaS.com

  • Transaction Line To iPaaS.com

  • Transaction Tracking Number To iPaaS.com

  • Transaction From iPaaS.com

  • Transaction Line From iPaaS.com

  • Customer Address From iPaaS.com

  • Transaction Address

Error Collection

Customer To iPaaS.com

Duplicate customer link risk (email address)

PR21-BIZL-1003 - Unable to dynamically link to existing Prophet 21 customer using email address. This may result in duplicate customer records.

  • Description: While preparing a customer for transfer, the integration found an existing record that matches by email address but could not confirm that it represents the same Prophet 21 customer. Continuing without a confirmed link could create a duplicate customer.

  • Resolution: Open the matching customer in iPaaS.com and confirm whether it already represents this Prophet 21 customer. If the same email address is shared by genuinely different customers, correct the conflicting address so each customer is uniquely identifiable, then re-run the transfer.

Customer not found in Prophet 21

PR21-NFND-1004 - Could not Get Customer in Prophet 21. Resource Not Found

  • Description: The integration requested a specific customer from Prophet 21 and Prophet 21 returned no record. This usually means the customer was deleted or renumbered in Prophet 21 after it was first synchronized, so the identifier iPaaS.com holds no longer resolves. The same message can appear during a company transfer, because a company transfer also retrieves its billing-contact customer.

  • Resolution: Look up the customer in Prophet 21 using the identifier shown alongside the error in the Error Logs. If the customer was deleted, remove or re-point the corresponding iPaaS.com record so the sync no longer requests it. If it was renumbered, re-run the customer sync so iPaaS.com picks up the current identifier.

Customer Address To iPaaS.com

Customer address not found in Prophet 21

PR21-NFND-1006 - Could not Get Customer Address in Prophet 21. Resource Not Found

  • Description: The integration requested a specific customer address from Prophet 21 and Prophet 21 returned no record. The address was most likely removed from the customer in Prophet 21 after it was first synchronized.

  • Resolution: Confirm in Prophet 21 whether the address still exists on the customer. If it was deleted intentionally, remove the corresponding address record in iPaaS.com. If it should exist, re-create it in Prophet 21 and re-run the customer sync so the address is picked up again.

Company To iPaaS.com

Duplicate company link risk (name)

PR21-BIZL-1004 - Unable to dynamically link to existing iPaaS Company using name. This may result in duplicate company records.

  • Description: The integration found an existing iPaaS.com company that matches by name but could not confirm that it represents the incoming Prophet 21 company. Proceeding could create a duplicate company.

  • Resolution: Review the matching company in iPaaS.com to confirm it is the same organization. If two distinct companies share a name, adjust the names so each is unique, then re-run the transfer.

Duplicate customer link risk (customer number)

PR21-BIZL-1005 - Unable to dynamically link to existing iPaaS customer using customer number. This may result in duplicate customer records.

  • Description: While transferring a company, the integration tried to link the company's billing contact to an existing iPaaS.com customer by customer number and could not confirm the match. Proceeding could create a duplicate customer.

  • Resolution: Verify that the customer number on the billing contact matches exactly one customer in iPaaS.com. Correct any mismatched or duplicated customer numbers, then re-run the transfer.

Customer prerequisite blocked

PR21-EXTN-1003 - Unable to create or transfer customer. This will prevent the transfer of the company.

  • Description: A company can only be transferred once its billing-contact customer exists in iPaaS.com. That customer could not be created, so the company transfer stops before it begins.

  • Resolution: Check the Error Logs for a customer error recorded in the same run — it normally names the underlying cause, such as a required customer field that has no value. Resolve that issue so the customer can be created, then re-run the company transfer.

Company not found in Prophet 21

PR21-NFND-1005 - Could not Get Company in Prophet 21. Resource Not Found

  • Description: The integration requested a specific company from Prophet 21 and Prophet 21 returned no record, typically because the company was deleted or renumbered in Prophet 21 after it was first synchronized.

  • Resolution: Look up the company in Prophet 21 using the identifier shown alongside the error in the Error Logs. If it was deleted, remove or re-point the corresponding iPaaS.com record. If it was renumbered, re-run the company sync so iPaaS.com picks up the current identifier.

Location To iPaaS.com

Duplicate location link risk

PR21-BIZL-1006 - Unable to dynamically link to existing iPaaS Location using name. This may result in duplicate location records.

  • Description: The integration found an existing iPaaS.com location matching by name but could not confirm that it represents the incoming Prophet 21 location, which could create a duplicate.

  • Resolution: Confirm in iPaaS.com whether the matching location is the same one. If distinct locations share a name, make the names unique, then re-run the transfer.

Location not found in Prophet 21

PR21-NFND-1009 - Could not Get Location in Prophet 21. Resource Not Found

  • Description: The integration requested a specific location from Prophet 21 and Prophet 21 returned no record. The location was most likely deleted or deactivated in Prophet 21 after it was first synchronized.

  • Resolution: Confirm the location still exists in Prophet 21. If it was retired intentionally, remove or re-point the corresponding iPaaS.com location so the sync no longer requests it; otherwise restore it in Prophet 21 and re-run the transfer.

Product To iPaaS.com

Duplicate product link risk

PR21-BIZL-1001 - Unable to dynamically link to existing iPaaS Product using Product No. This may result in duplicate product records.

  • Description: The integration found an existing iPaaS.com product matching by product number but could not confirm that it represents the incoming Prophet 21 product, which could create a duplicate. The same message can appear during a product inventory transfer, because inventory records resolve their parent product the same way.

  • Resolution: Check the matching product in iPaaS.com to confirm it is the same item. If two different products share a product number, correct the numbers so each is unique, then re-run the transfer.

Duplicate product inventory link risk

PR21-BIZL-1002 - Unable to dynamically link to existing iPaaS Product Inventory using Product and Location Id. This may result in duplicate product records.

  • Description: The integration found existing iPaaS.com product inventory matching by product and location but could not confirm that it represents the incoming Prophet 21 inventory record, which could create a duplicate.

  • Resolution: Confirm in iPaaS.com that the matching inventory record represents the same product-and-location combination. Correct any duplicated product or location identifiers, then re-run the transfer.

Product record not found in Prophet 21

PR21-NFND-1007 - Could not Get Item in Prophet 21. Resource Not Found

  • Description: The integration requested a specific product from Prophet 21 and Prophet 21 returned no record, typically because the item was deleted or its item ID was changed in Prophet 21 after it was first synchronized.

  • Resolution: Look up the item in Prophet 21 using the identifier shown alongside the error in the Error Logs. If it was deleted, remove or re-point the corresponding iPaaS.com product. If its item ID changed, re-run the product sync so iPaaS.com picks up the current identifier.

Product Inventory To iPaaS.com

Product creation blocked

PR21-EXTN-1002 - Unable to create product. This will prevent the transfer of the product.

  • Description: The integration attempted to create the product in iPaaS.com as part of the inventory transfer and the creation did not complete, so nothing is transferred.

  • Resolution: Review the Error Logs for a product error recorded in the same run — it normally explains the cause, such as a required field with no value in the product mapping. Resolve that issue and re-run the transfer.

Product inventory not found in Prophet 21

PR21-NFND-1008 - Could not Get Inventory Item in Prophet 21. Resource Not Found

  • Description: The integration requested a specific inventory record from Prophet 21 and Prophet 21 returned no record. This usually means the item was removed from that location in Prophet 21 after it was first synchronized.

  • Resolution: Confirm in Prophet 21 that the item is still stocked at the location shown alongside the error. If the combination was retired, remove the corresponding iPaaS.com inventory record; otherwise restore it in Prophet 21 and re-run the transfer.

Transaction To iPaaS.com

Duplicate transaction link risk

PR21-BIZL-1007 - Unable to dynamically link to existing Prophet 21 transaction using Invoice No. This may result in duplicate transaction records.

  • Description: The integration found an existing transaction matching by invoice number but could not confirm that it represents the same order, which could create a duplicate transaction.

  • Resolution: Confirm in Prophet 21 whether the matching transaction is the same order. If distinct orders share an invoice number, correct the numbering so each is unique, then re-run the transfer.

Company prerequisite blocked

PR21-EXTN-1004 - Unable to create Company in Prophet 21. This will prevent the transfer of the order.

  • Description: An order can only be transferred once its related company exists. The company could not be created, so the order is not transferred.

  • Resolution: Look in the Error Logs for a company error from the same run — it normally names the underlying cause, such as a required company field with no value. Resolve that issue so the company can be created, then re-run the order transfer.

Customer prerequisite blocked (order)

PR21-EXTN-1005 - Unable to create Customer in Prophet 21. This will prevent the transfer of the order.

  • Description: An order can only be transferred once its related customer exists. The customer could not be created, so the order is not transferred.

  • Resolution: Look in the Error Logs for a customer error from the same run — it normally names the underlying cause, such as a required customer field with no value. Resolve that issue so the customer can be created, then re-run the order transfer.

Product prerequisite blocked (order)

PR21-EXTN-1006 - Unable to create product in Prophet 21. This will prevent the transfer of the order.

  • Description: An order can only be transferred once every product on its lines exists. One of those products could not be created, so the order is not transferred.

  • Resolution: Look in the Error Logs for a product error from the same run — it normally names the underlying cause, such as a required product field with no value. Resolve that issue so the product can be created, then re-run the order transfer.

Transaction not found in Prophet 21

PR21-NFND-1010 - Could not Get Invoice in Prophet 21. Resource Not Found

  • Description: The integration requested a specific transaction from Prophet 21 and Prophet 21 returned no record, typically because the order was deleted or its invoice number was changed in Prophet 21 after it was first synchronized.

  • Resolution: Look up the order in Prophet 21 using the invoice number shown alongside the error in the Error Logs. If it was deleted, remove or re-point the corresponding iPaaS.com transaction. If the invoice number changed, re-run the transaction sync so iPaaS.com picks up the current value.

Transaction Line To iPaaS.com

Product not found in iPaaS.com

PR21-NFND-1002 - Product does not exist in iPaaS by Item Id: {ItemId}

  • Description: A transaction line references a product that has not yet been synchronized to iPaaS.com. The {ItemId} placeholder shows the Prophet 21 item identifier that could not be found. The line is held until the product exists in iPaaS.com.

  • Resolution: Run the product sync so the item reaches iPaaS.com, then re-run the transaction line transfer. If the product is intentionally excluded from iPaaS.com, you or your MiSP can change how missing products are handled by editing this mapping collection's filter in the iPaaS.com UI.

Transaction line not found in Prophet 21

PR21-NFND-1011 - Could not Get Invoice Line in Prophet 21. Resource Not Found

  • Description: The integration requested a specific transaction line from Prophet 21 and Prophet 21 returned no record. This usually means the line was removed from the order in Prophet 21 after it was first synchronized.

  • Resolution: Open the order in Prophet 21 and confirm whether the line still exists. If it was removed intentionally, remove the corresponding line in iPaaS.com; otherwise re-run the transaction sync so the order and its current lines are re-read together.

Transaction Tracking Number To iPaaS.com

Shipping method not found in iPaaS.com

PR21-NFND-1003 - Shipping Method {CarrierId} could not be found in iPaaS and must be manually created

  • Description: A tracking-number record references a shipping method (carrier) that does not exist in iPaaS.com. The {CarrierId} placeholder shows the carrier name from the source record. The record is held until a matching shipping method exists.

  • Resolution: Create the shipping method in iPaaS.com using the exact carrier name shown in the message — matching is by name, so the value must match exactly — then re-run the transfer. If unmatched carriers should be handled differently, you or your MiSP can adjust this mapping collection's filter in the iPaaS.com UI.

Transaction prerequisite blocked

PR21-EXTN-1007 - Unable to create or transfer transaction in Prophet 21. This will prevent the transfer of the transaction tracking number.

  • Description: A tracking number can only be transferred once its parent transaction exists. The parent transaction could not be created or transferred, so the tracking number is not sent.

  • Resolution: Confirm the parent order transferred successfully, and check the Error Logs for a transaction error from the same run explaining why it did not. Resolve that issue and re-run so the transaction is in place before its tracking number.

Transaction From iPaaS.com

Duplicate SKUs on order lines

PR21-BIZL-1010 - Order line items contain duplicate SKUs not allowed in Prophet 21: {duplicateSkus}

  • Description: The order being sent to Prophet 21 has the same SKU on more than one line item. Prophet 21 does not accept an order with duplicate line-item SKUs, so the transfer is stopped before the order is sent. The {duplicateSkus} placeholder lists the SKUs that appear more than once.

  • Resolution: Edit the source order so each SKU appears on a single line — combine the duplicated lines into one line carrying the correct total quantity — then re-run the transfer. If your business genuinely requires repeated SKUs on an order, you or your MiSP can change how duplicates are handled by editing this mapping collection's filter in the iPaaS.com UI.

Duplicate company link risk (customer email address)

PR21-BIZL-1008 - Unable to dynamically link to existing Prophet 21 company using iPaaS customer email address. This may result in duplicate customer records in Prophet 21.

  • Description: While preparing the transfer, the integration found an existing Prophet 21 company matching the iPaaS.com customer's email address but could not confirm the link, which could create a duplicate customer in Prophet 21. The same message can appear during a customer transfer from iPaaS.com, which resolves its company the same way.

  • Resolution: Confirm in Prophet 21 whether the matching company is the same customer. If different customers share an email address, correct the conflicting address so each is uniquely identifiable, then re-run the transfer.

Transaction creation blocked (tracking number)

PR21-EXTN-1008 - Unable to create transaction. This will prevent the transfer of the Transaction Tracking Number.

  • Description: A tracking number requires its parent transaction to exist in Prophet 21. The integration attempted to create that transaction as a prerequisite and the creation did not complete, so the tracking number is not sent.

  • Resolution: Check the Error Logs for a transaction error from the same run — it normally explains why the order could not be created, such as a rejected field value. Resolve that issue and re-run so the transaction is created before its tracking number.

Order could not be created

PR21-EXTN-1009 - Order cannot be created, Error in Order Creation

  • Description: The integration sent the order to Prophet 21 and Prophet 21 did not return a created order. Prophet 21 rejected the write, usually because a value on the order or one of its lines violates a Prophet 21 rule.

  • Resolution: Look for a Prophet 21 response recorded alongside this error in the Error Logs — it names the field or rule that was rejected. Correct that value on the iPaaS.com order, or adjust the corresponding record in Prophet 21, then re-run the transfer.

Order could not be updated

PR21-EXTN-1010 - Order cannot be updated. Error in order update.

  • Description: The integration sent an update for an existing order to Prophet 21 and Prophet 21 did not return an updated order. This usually means a changed value violates a Prophet 21 rule, or the order has reached a status Prophet 21 no longer allows to be modified.

  • Resolution: Open the order in Prophet 21 and confirm it is still in a state that accepts changes. Review the Prophet 21 response recorded alongside this error in the Error Logs for the field or rule that was rejected, correct it, then re-run the transfer.

Transaction Line From iPaaS.com

Product not found in Prophet 21

PR21-NFND-1001 - Product not found in Prophet 21: The specified product does not exist or is unavailable in the Prophet 21 system.

  • Description: While building an order line, the integration looked up the line's product in Prophet 21 by SKU and found no matching, available product. The line cannot be created without a valid Prophet 21 product. The same message appears when the line carries no SKU at all.

  • Resolution: Confirm the order line has a SKU, that a product with that exact SKU exists in Prophet 21, and that it is available — matching is exact, so differences in case or spacing will not resolve. Create or activate the product in Prophet 21, or correct the SKU on the iPaaS.com order, then re-run the transfer.

Customer Address From iPaaS.com

Duplicate customer address link risk

PR21-BIZL-1009 - Unable to dynamically link to existing customer Address in Prophet 21 using iPaaS customer address. This may result in duplicate customer address records in Prophet 21.

  • Description: The integration found an existing Prophet 21 customer address matching the iPaaS.com customer address but could not confirm the link, which could create a duplicate address in Prophet 21.

  • Resolution: Review the matching address in Prophet 21 to confirm it is the same address. If genuinely different addresses appear identical, adjust them so each is distinguishable, then re-run the transfer.

Transaction Address

Transaction address retrieval not available

PR21-INTL-1001 - Retrieving a single Transaction Address record is not supported by the Prophet 21 integration.

  • Description: Something requested one transaction address record on its own. The integration transfers transaction addresses only as part of their parent transaction and cannot retrieve one independently, so the request fails.

  • Resolution: Re-run the transfer at the transaction level so the address moves with its parent order rather than on its own. If this error appears during a normal scheduled sync rather than a targeted single-record request, contact iPaaS.com Support at support@ipaas.com with the date, time, and mapping collection shown in the Error Logs.

All flows

Prophet 21 API call failed

PR21-EXTN-1001 - Error calling Prophet 21 CallWrapper.{action}: {details} (Http Code: {status})

  • Description: The integration called Prophet 21 and the call did not succeed. This single message covers every failed call to Prophet 21, in any flow: the request never reached Prophet 21, or Prophet 21 returned a failure. The {action} placeholder names the operation that was attempted, {details} carries the response Prophet 21 returned, and {status} is the HTTP status — shown by name, such as NotFound or Unauthorized, rather than as a number.

When the request never reaches Prophet 21 at all — a network or connectivity failure — the same code is recorded with a shorter message instead: Prophet 21 Error Response is: followed by the underlying failure. Either way the code is the same, so search on PR21-EXTN-1001.

Because the response text comes from Prophet 21 rather than from the integration, its wording is not standardized here — read it as Prophet 21's own message. - Resolution: Start with {details}, which usually identifies the field or rule Prophet 21 rejected; correct that value and re-run the transfer. A status of Unauthorized or Forbidden points at the connection instead — have your MiSP confirm the Prophet 21 credentials and permissions on the integration's connection settings, and re-authorize if the password or token has changed. A status of NotFound on a record you can see in Prophet 21 usually means the identifier in iPaaS.com is stale; re-run the parent sync to refresh it. If the call keeps failing with valid data and a healthy connection, contact iPaaS.com Support at support@ipaas.com with the full message, including {action} and {status}.

Related Documents

Did this answer your question?