| Table of Contents | ||||
|---|---|---|---|---|
|
Extension installation via composer for Magento 2.4.3
Latest Versions
Module | Version | Magento Commerce (aka. OpenSource) | Adobe Commerce (Adobe Commerce Cloud) | Adobe Commerce (Adobe Commerce Cloud) + Native B2B extension | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
tnw/sforcecountrystate |
|
|
|
|
Installation/Upgrade Instructions
STEP 1 - Register new composer repository
Register PowerSync repository
| Info |
|---|
NOTE: These steps are only necessary when installing our software for the first time |
| Code Block |
|---|
composer config repositories.powersync composer https://dist.powersync.biz |
STEP 2 - Enable maintenance mode
| Code Block |
|---|
bin/magento maintenance:enable |
STEP 3 - Install the product via composer
composer require
|
| Code Block |
|---|
composer upgrade tnw/soap-client tnw/salesforce tnw/sforceenterprise tnw/sforcecustomergroup tnw/sforcetierprice tnw/sforcerma tnw/sforcequickorder tnw/sforcecountrystate |
STEP 4 - Performing Magento upgrade
| Insert excerpt | ||||||
|---|---|---|---|---|---|---|
|
| Info |
|---|
Re-save configuration pages after the upgrade |
Extension installation via composer for Magento 2.4.4
Latest Versions
Module | Version | Magento Commerce (aka. OpenSource) | Adobe Commerce (Adobe Commerce Cloud) | Adobe Commerce (Adobe Commerce Cloud) + Native B2B extension | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
tnw/sforcecountrystate |
|
|
|
|
Installation/Upgrade Instructions
STEP 1 - Register new composer repository
Register PowerSync repository
| Info |
|---|
NOTE: These steps are only necessary when installing our software for the first time |
| Code Block |
|---|
composer config repositories.powersync composer https://dist.powersync.biz |
STEP 2
...
- Enable maintenance mode
| Code Block |
|---|
bin/magento maintenance:enable |
STEP 3 - Install the product via composer
composer require
|
| Code Block |
|---|
composer upgrade tnw/soap-client tnw/salesforce tnw/sforceenterprise tnw/sforcecustomergroup tnw/sforcetierprice tnw/sforcerma tnw/sforcequickorder tnw/sforcecountrystate |
STEP 4 - Performing Magento upgrade
| Insert excerpt | ||||||
|---|---|---|---|---|---|---|
|
| Info |
|---|
Re-save configuration pages after the upgrade |
Usage
Country State module provides you with the ability to import Countries and States from Salesforce to Magento
...
As a result, all Country State module options become available
...
| Note |
|---|
Important: Also you need to start related consumers:
Follow the manage message queues documentation and add the following listeners to your |
To Disable Country State module
...
As a result, all Country State module options will be hidden.
...
Country State module Connection to Salesforce
Country State module requires connection to Salesforce. You need to upload Metadata WSDL file and then click the Test Connection & Apply Salesforce changes button
...
To get Metadata WSDL file:
Go to Salesforce - Gears button - Setup
...
Start typing “API“ word into the “Search Setup“ field
Click on the “API integration” item in the Search list
...
Click on Generate Metadata WSDL link and save page content to file
...
go to Magento Admin panel - Salesforce (sidebar menu) - Country State - Country State Configuration tab
Click on the “Browse“ button and select the previously saved Metadate WSDL file
...
Click Save button
Click “Test Connection & Apply changes“
...
Enable Automatic Update
The “Enable Automatic Update” option allows you to Enable/Disables Automatic Country State import. If disabled, the import still can be performed manually
...
go to Magento Admin panel - Salesforce (sidebar menu) - Country State - Country State Configuration tab
set “Enable Update“ option to “Yes“
set “Enable Automatic Update” option to “No“
...
Manual
...
There are few possible ways for manual synchronization
...
update
You have the ability to manually Initialize Countries and States picklist update at any time
go to Magento Admin panel - Sales - ReturnsMark checkbox next to the return you want to manually synchronize Salesforce (sidebar menu) - Country State - Country State Configuration tab
Click the “Action” menu - “Sync with Salesforce”
...
Click on the created return
Click the “Salesforce Sync“ button on the Return page
...
Go to Magento Admin panel - Sales - Orders and scroll to the created order
Click the “Select -View“ action - “Returns“ tab
Mark checkbox next to the return you want to manually synchronize
Click the “Action” menu - “Sync with Salesforce”
...
Default Owner
This default owner will be assigned to the Salesforce Case when returns created
Update Now“ button
...
Manage Countries page
On Manage Countries page you could view all countries created in the Magento database
go to Magneto Admin panel - Sidebar menu - Salesforce icon
...
By clicking on “Manage Regions“ action link you will be able to view all regions/states created for selecte country
...
Use Cases
Create new Country
For example, you need to create a new country that is not listed among default Magento countries. You need to do next:
Go to Salesforce - Click on Gears button - Setup
...
Start typing the “picklist“ word into the “Search Setup“ field
Click on the “State and Country/Territory Picklists Data” item in the Search list
...
Click on “The Configure States, Countries, and Territories“ link
...
Click the “New Country/Territory“ button
Fill in all required fields and click Add button
...
go to Magento Admin panel - Salesforce (sidebar menu) - Returns Country State - Returns Country State Configuration tab
Expand Click the “Default Owner“ drop-down list and choose an owner
...
Update Now“ button
go to Magento Admin panel - Sales Stores - Configuration - Returns - scroll to the newly created return
Click on the “Salesforce ID“ link
...
Subject Prefix
...
General - Country Options tab
Find the newly created country in Allow Countries list
...
check new country is available on Frontend
...
Create new States
In case when you need to create a new state for an existing country that is not listed among default Magento states. Do next:
Let try to add new states for Andorra
...
Go to Salesforce - Click on Gears button - Setup
...
Start typing the “picklist“ word into the “Search Setup“ field
Click on the “State and Country/Territory Picklists Data” item in the Search list
...
Click on “The Configure States, Countries, and Territories“ link
...
Click the “Edit” link near Andorra country
...
Click the “New State“ button
...
Fill in all required fields and click Add button
...
go to Magento Admin panel - Salesforce (sidebar menu) - Returns Country State - Returns Country State Configuration tab
Type some prefix into Click the “Subject PrefixUpdate Now“ fieldbutton
...
go to Magento Admin panel - Sales - Returns - scroll to the newly created return
Click on the “Salesforce ID“ link
...
Go to Magento Frontend and check new States are available for Andorra
...
Place order for new state and check synchronization with Salesforce
...
Related articles
| Filter by label (Content by label) | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
| Page Properties | ||
|---|---|---|
| ||
|