When connecting Tradebox to Magento 2 for the first time, you may encounter an error message on attempting to connect. Most of the errors that we have come across to date are due to configuration issues with your site or third party plugins blocking Tradebox from accessing your site's API. Below are some of the known issues with Magento 2 connections.
How to interpret the error message you receive
Most error messages you see during the connection process in Tradebox won't tell you immediately what the exact issue is, and can often require a web developer to check them over or to resolve.
If you receive an error message like this:
The full error message is stored in the Magento error logs. You will need to contact your web developer and give them the report ID mentioned in the error and ask them to provide the full error details. They may be able to troubleshoot the error on their own, or if they are not familiar with it and it doesn't appear in our list of errors below, contact firstname.lastname@example.org for further advice.
You may also see a generic error message like this:
"The SOAP connection to the Magento website failed with the following error returned by the API: Server returned an invalid SOAP Fault. Please see InnerException for more details."
If that's the case, go to Logs > Issues in Tradebox to see the full error message. If the log is blank, contact email@example.com with the connection details you're using to make the connection.
Any Magento Version
You receive the error message:
The following error occurred when connecting to Magento2: Server returned an invalid SOAP Fault. Please see InnerException for more details.
Inner exception: System.Xml.XmlException: Unbound prefix used in qualified name 'rpc:ProcedureNotPresent'.
This error may indicate that you have not entered the website url correctly. Try including 'www.' if it's not already present, e.g., https://www.tradebox.co.uk/soap as opposed to just https://tradebox.co.uk/soap
Magento 2.4 and above
If you are using Magento 2.4.0 or higher, 2 factor authentication is enabled on your site by default. If you are unable to connect using the username and password, you may need to connect using an access token instead. The instructions for obtaining that can be found here.
There is a known issue in versions of Magento 2.3 which can block the Tradebox connection. The error message you receive will be a variation of:
The "\DateTime" parameter type is invalid. Verify the parameter and try again.
If you are experiencing this particular error, refer your developer here. This error can usually be resolved by updating your website to Magento 2.4.
The following plugin is known to cause an issue with Tradebox connecting:
Ebizmart Sagepay module 1.4.5.
This was resolved by rolling back the plugin to version 1.4.3. If you are using this plugin and getting an error in Tradebox, speak to your web developer for further information.
My Web Developer has made a change, how do I check if it's worked?
If you are setting up a new connection in Tradebox for the first time, you will be prompted to test the connection on setting up the channel. If the problem has occurred on a channel that was already set up, you can test if the problem has been resolved by going to Channels, double clicking on the channel, then selecting Actions > Test Connection.
This will return either an error if the problem still exists, or a successful connection message if the problem has been resolved.