Magento2 Integration

Overview

• Integrate Starshipit with Magento2, so you can import Magento2 orders.
• Starshipit will write back tracking information when you print a label (or when you manifest, depending upon your settings).
• There are two ways to connect your Magento2 store with Starshipit. Token based authentication is recommended especially if you are using two-factor authentication on your store.
• As of Magento 2.4 two-factor authentication is enabled by default on Magento2. This means you will need to use token authentication to connect with Starshipit.
• As of Magento 2.4.4 users will need to enable token access in the Admin by setting the Stores > Configuration > Services > OAuth > Consumer Settings > Allow OAuth Access Tokens to be used as standalone Bearer tokens option to Yes. 

1. Set up access for Starshipit to Magento2

Token Authentication (recommended)

Create a access token.

1. Log into your Magento2 admin page.
2. At the very bottom left of the sidebar click System > Extensions > Integrations.
3. Click Add New Integration.
   • Enter Starshipit in the Name field.
   • Enter your admin password in the Your Password field. Leave all other fields blank.
   • Click the API tab.
   • Under the Resource Access dropdown select All.
   • Click Save in the top right of the screen.
4. You will then be taken back to the Integrations page.
5. Click Allow.
6. A dialog will appear with a Consumer Key, Consumer Secret, Access Token, and Access Token Secret.
7. Only the Access Token is required. Copy your Access Token and click Done.

User Authentication 

Note: Skip this section if you have completed the steps above for Token Authentication

Create a new role

1. Go to your Magento Admin Dashboard and select System.
2. Under Permissions, select User Roles.
3. Click Add New Role.
4. In Role Name, enter Integration, then select the Role Resources tab.
5. From the Resource Access dropdown, select All.
6. Click Save Role.

Assign your new role to a user

1. From the Dashboard panel, select System.
2. Under Permissions, select All Users.
3. From the Users page, click Add New User.
4. Enter the required user information. We recommend you note your username and password for later use.
5. Select the User Role tab, then select the Integration role you previously created.
6. Click Save User.

2. Enter your Magento2 details in Starshipit

1. In your Starshipit account select Settings, then select Integrations.
2. Click Add a new integration, and select Magento2.
3. Click the Enable Magento2 checkbox. 
4. Select your Authentication Method from step 1.
5. Enter the URL of your site, e.g. https://www.myShop.com
6. Enter your Access Token or Username and Password.
7. Select your import status.
8. Import Dimensions Unit: Select the UOM measure you use for dimensions 
9. Test your connection, and then click Save.

3. (Optional) Import delivery information

Give your customers the option to choose between Signature on Delivery and Authority to Leave during the checkout process. To set this up, create the following custom fields:

• delivery_comment (String max 100) for the delivery instruction 
• authority_to_leave: values can be 0, 1, true, false, yes or no
• signature_required: values can be 0, 1, true, false, yes or no

NOTE: To add the file to /rest/V1/orders/ you need to add them to the order search Criteria API.