# Monitoring Errors

A DX2 document will go through the steps specified in the rule applied to it. Read the Rules Documentation here. If a document fails at any step of the rule, its status will change to Error. The document will not proceed to the next step or will move to the Complete status till the error is fixed.

Errors can be monitored from the Documents page. Filter on the Document Status and select Error. This will display all documents which have errors. Further filters can also be applied on Document Date, Trading Partners, Document Types and Analysis Tags.

Error filter in Documents Page

Please Note

DX2 should be monitored for errors regularly to fix issues on a timely basis

Click on the errored Document(s) one at a time and investigate and resolve the issues by reviewing the errors and solutions below. If unable to resolve these yourself, please contact Olympic support at support@olympic.co.nz.

  • Click on a document with an error to view the timeline of the document where you can see the rule applied to the document and the steps it has been through.
Selecting a Document with an error
  • Click on the triple ellipses at the step the document has errored and select Error Details which will give more information on the reason for the error.
Selecting the Error Details

# What's the Difference between Retry and Replay?

TIP

Only users with the Resubmit Document permission can take these actions.

You can only retry a document when it has the status Error. Generally, the error condition should be fixed before attempting the retry.

Retry option for a Document with an error
  • You would use replay where no error exists, but you want to redo the action as per the timeline actions. Generally used more around resending documents via FTP/SFTP or resending an email action.
Replay option for a Document

Replay creates another branch on the Timeline, as shown in this example of a Document with a replay:

Replayed Document

# Common Dynamics GP Errors

# The Account does not exist for Account Number String and/or the Account Number String passed does not exist in the GL00105 table

Document with a GP error
Document with a GP error
  • Check that the Account Code indicated exists in the ERP.
    • If the account code is missing Add the account to the ERP application. This will cover future documents from erroring.
    • Retry the document from the Document Timeline.
Retry option for a Document with a GP error
  • The document was coded incorrectly
    • For a captured document that has already been approved you will need to Replay the document (from the SendToApprovals timeline entry) and Recode and send through approvals again (or get the Final Approver to fast track).

    • For an EDI Document change the raw data and Retry as per below.

      • Drill into the document timeline and click retry from the ellipsis.
      Retry option for a Document
      • Click on Amend Document.
      Click amend when retrying a Document
      • Change the account number to the correct code then click on Save and Retry.
Amending a document before retrying
  • Check the source, for example with Go documents the GL Account is sent from Go and the control account and tax account are sourced from the transform in DX2 so both places should be checked for validity.

    • If the Source is incorrect then change the data in the raw xml (as above) and retry the document. The source will need to be corrected for future documents or the transform fixed if that is incorrect.

# The Vendor number does not exist in the ERP system

Missing vendor number in ERP system
  • Things to look for
    • Check that the Supplier number indicated exists in the ERP Application.
    • Check the Supplier Code used in DX2 is correct via My Company Internal Info on the Trading Partner.
  • Solution
    • After adding the Supplier Code in the ERP Application, retry the erred Document.
    • If incorrect in DX2 then correct the code via Internal Info against the Trading Partner, Amend the xml raw data and retry the document or discard the document and start again from capture.

# The Customer Number does not exist in the ERP system

Missing customer number in ERP system
  • Things to look for
    • Check that the Customer number indicated exists in the ERP Application.
    • Check the Customer Code used in DX2 is correct via My Company Internal Info on the Trading Partner.
  • Solution
    • After adding the Customer in the ERP Application, retry the erred Document.
    • If incorrect in DX2 then correct the code via Internal Info against the Trading Partner, Amend the xml raw data and retry the document or discard the document and start again from capture.

# The Document Number (DOCNUMBER) already exists in the ERP System

This error will come up if in the ERP system this document number has already been used for the same supplier code.

Most ERP systems are setup to not allow a user to use the same document number more than once for a Supplier.

Document number already exists in ERP system

Please Note

A warning is given during Capture if a duplicate is detected.

  • Check and confirm if the document in the DX2 portal is a duplicate.
  • If it is a duplicate document and the original document has been Completed and processed in the ERP system the errored document should be discarded in the DX2 portal.
  • If the document number was manually entered during capture or the during manual entry of an invoice or Credit note and is incorrect, capture or re-enter the document again.
  • If your document is not a duplicate and it is due to being a recurring invoice for example, you can add a number or a letter to allow this to pass through. E.g. INV1234_1 or INV1234_JAN20.

# There is a Duplicate Tax Node ID in the RM10601 table

This error will come up if in the ERP system this document number has already been used for the same supplier code.

Most ERP systems are setup to not allow a user to use the same document number more than once for a Supplier.

Duplicate tax number error in ERP system

Please Note

A warning is given during Capture if a duplicate is detected.

  • Check and confirm if the document in the DX2 portal is a duplicate.
  • If it is a duplicate document and the original document has been Completed and processed in the ERP system the errored document should be discarded in the DX2 portal.
  • If the document number was manually entered during capture or the during manual entry of an invoice or Credit note and is incorrect, capture or re-enter the document again.
  • If your document is not a duplicate and it is due to being a recurring invoice for example, you can add a number or a letter to allow this to pass through. E.g. INV1234_1 or INV1234_JAN20.

# The Account passed is inactive in Account Maintenance

This error usually occurs if the GL Account Code used in DX2 is not active in the ERP Application.

Inactive account error in ERP system
  • Check that the account code is re-activated in the ERP Application and retry the document.
  • The document was coded incorrectly.
    • For a captured document that has already been approved you will need to Replay the document (from the SendToApprovals timeline entry) and Recode and send through approvals again (or get the Final Approver to fast track).
    • For an EDI Document change the raw data and Retry

# Failed to get Tax Schedule Id and Tax Detail Id for vendorId

This error occurs if the Supplier in GP has not been set up with a Tax Schedule ID.

Tax Schedule error in ERP system
  • Add the Tax Schedule ID for the Supplier in GP and retry the document.

# A valid Exchange Rate could not be found for the Document Date specified

This error usually occurs when a valid exchange rate is not setup in the ERP application for the document date or the supplier code is missing.

Exchange Rate error in ERP system
  • Check that the Supplier code exists in the ERP Application
  • If Supplier code exists, is the correct currency /exchange rate set up in the ERP application.
Exchange Rate setup in ERP system
Exchange Rate setup in ERP system page 2
  • Use the ‘Retry function’ to send the document to the ERP once the information is updated in the ERP Application.

TIP

Multi-currency must be set up inside Dynamics GP to allow DX2 to send documents of a currency that is not the base currency being used in the GP company. If you need assistance with the set up please contact Olympic.

  • The following set up is required:
  • Multi-currency is activated
  • Each currency that is intended to be used is set up, with valid exchange tables and assigned to the relevant company databases
  • Valid exchange rates are maintained inside Dynamics GP
  • The relevant GL accounts are marked to allow transactions in the relevant currencies
  • The vendors are set up with the relevant currency ID’s.

# DX2 is Not Working for all Users

  • Check if you can access any other sites on your browser to ensure the internet connection is not down.
  • Check that no internal network issues exist.
  • If the above two appear to not be the cause contact Olympic support via support@olympic.co.nz and log a priority 1 support call.

# Common Dynamics 365 Business Central Errors

# Error Type: 3 (Account Not Found)

365 error Type 3
  • Check that the Account Code indicated exists in the ERP.
    • If the account code is missing Add the account to the ERP application. This will cover future documents from erroring.
    • Retry the document from the Document Timeline
Retry a Document with an error

# The document was coded incorrectly

  • Change the raw data and Retry as per below (particularly if this is an EDI document).
  • Drill into the document timeline and click Retry from the triple ellipsis.
Retry option for a Document
  • Click on Amend Document.
Click amend when retrying a Document
  • Change the account number to the correct code then click on Save and Retry.
Amending a document before retrying

# Error Type: 1 (Invalid or Missing Supplier)

365 error Type 1
  • Things to look for:

    • Check that the Supplier number indicated exists in the ERP Application.
    • Check the Supplier Code used in DX2 is correct via My Company Internal Info on the Trading Partner.
  • Solution

    • After adding the Supplier Code in the ERP Application, retry the erred Document.
    Retry option for a Document
    • If incorrect in DX2 then correct the code via Internal Info against the Trading Partner, Amend the xml raw data and retry the document or discard the document and start again from capture.
Last Updated: 11/06/2020, 3:50:50 am