Troubleshooting
# Display of the last order error
When the Sendcloud plugin fails to push order data to Sendcloud, you will be able to see the latest error (occurred) message in the Sendcloud panel on the order details page. You can click the 'i' icon to see the full message text.
# Problems with pushing orders and creating labels
When the plugin fails to push an order to Sendcloud or create a label, you will be able to see the last error related to the order on the order edit page in the Sendcloud sidebar panel. One frequent problem can be invalid data inside the order. You have to make sure that all the data that comes from the users (address/phone fields for example) is validated properly on your checkout page and no fields exceed Sendcloud limitations. Also make sure the HS code and country of origin fields (if enabled) contain valid data and your shipping methods are configured properly (for example, service point picker is required for every service point shipping method). After you've resolved any problems with an order, you can try to push it again manually by clicking the corresponding button on the order details page.
# Error logging
This plugin produces its logs into the Craft’s logging system marked with a separate category, ‘commerce-sendcloud’. Inspect the application log to find Sendcloud error messages. Additionally, for Craft 3, you can always extract Sendcloud log messages into a separate log target. To make it work, you can configure your config/app.php file like this:
# Craft 3.x
return [
'*' => [
'components' => [
'log' => function() {
$config = craft\helpers\App::logConfig();
if ($config) {
$config['targets']['commerce-sendcloud'] = [
'class' => \craft\log\FileTarget::class,
'logFile' => '@storage/logs/sendcloud.log',
'categories' => ['commerce-sendcloud'],
//'levels' => Logger::LEVEL_ERROR | Logger::LEVEL_WARNING, 'logVars' => [],
];
}
return $config ? Craft::createObject($config) : null;
},
]
]
];
# Craft 3.6+
return [
'*' => [
'components' => [
'log' => [
'targets' => [
'__fileTarget' => function() {
if (!class_exists(FileTarget::class)) {
return null;
}
return Craft::createObject([
'class' => FileTarget::class,
'logFile' => '@storage/logs/sendcloud.log',
'categories' => ['commerce-sendcloud'],
//'levels' => Logger::LEVEL_ERROR | Logger::LEVEL_WARNING,
'logVars' => [],
]);
}
],
],
]
],
];
# Connection issues
When you use the Craft plugin settings to disconnect from Sendcloud the integration will still be active in Sendcloud. You have to disconnect the integration manually in Sendcloud too.
Also the other way around, when you disconnect the integration in Sendcloud the connection will still be active in Craft. You have to disconnect the integration manually in Craft too.
# Sendcloud order cancelling
When an order is cancelled in Sendcloud, the Craft webhook will be triggered and the Sendcloud data will be deleted in the plugin’s custom table too. The cancellation of orders in Sendcloud can be a bit delayed, so as long as the Sendcloud status is “Cancellation requested” the order will not be deleted from the custom table.
# Sendcloud support
Contact Sendcloud if you have questions about the plugin and the configuration of Sendcloud dashboard.