We also have a Quick Tip video that walks you through the steps in this article.

You'll need to locate your Miva Store Code and enter it into Postsale. Here's how:

1. Open a new web browser window and log into your Miva store admin.
2. Go to Settings > Store Settings > Store Details.
   
   
    
3. Select and copy the Store Code from the Identification section of the Store Details screen.
   
   
    
4. Switch back to Postsale. Paste or enter the Store Code from your Miva store into the Store Code field in Postsale.
   
   

Continue with step 2 - Create the Miva API Token.

Next, you'll create an API Token in Miva. Once created, the API Token will include the Endpoint URL, Access Token, and Signature Key which you will enter into Postsale. You will also enter the Postsale Whitelist IP Address into Miva. Here's how to create the API Token:

1. Switch back to your Miva store admin.
2. Go to Settings > User Management > API Tokens.
   
   
    
3. Click Add API Token.
   
   
   
   The Add API Token screen opens.
    
4. Enter a name for your API Token into the Name field.
   The name can be anything you wish. You may wish to name it something like ‘Postsale API’ so that it is easy to identify.
   
   
    
5. Perform the following actions to ensure the correct information is entered into Postsale and Miva:
   1. Copy the Endpoint URL from Miva to the Endpoint URL field in Postsale.
   2. Copy the Access Token from Miva into the Access Token field in Postsale.
   3. Copy the signature key from the Signature field in Miva into the Signature Key field in Postsale.
   4. Enter the Whitelist IP Address shown in Postsale into the Allowed IP Address(es) field in Miva.
      
      
       
6. Click Save in Miva to save your API Token.
   The API Token will be displayed in the list of tokens.
   
   
   
    
7. Select Groups at the top of the Miva Users screen.
   
   
    
8. Check the box to the left of Order Processing & Fulfillment to select it. Then, click the kabob menu and select API Tokens.
   
   
    
9. Locate the API Token you just created. Set the toggle switch in the Assigned column to the on position. Then, click Close.
   
   
   

Continue with step 3 - Create the Miva Workflow & Webhook.

Now, you'll create a webhook so that Miva knows how to send order information to Postsale. Here's how:

1. In your Miva admin, go to Settings > Utilities > Order Workflows. Then, click Add Workflow.
   
   
    
2. Enter a name for your Workflow into the Workflow Name field. Leave Workflow enabled and Wait Until True as disabled. Click Next.
   
   
    
3. Select all of the triggers on the Triggers screen by clicking on them. Then, click Next.
   
   
    
4. No conditions are needed. Click Next to skip the Conditions screen.
   
   
    
5. Click Add An Action. 
   
   
    
6. Select Webhook (POST) from the Action drop-down menu.
   
   
    
7. Switch back to Postsale. Click the Copy To Clipboard button to copy the Webhook URL.
   Then, switch back to Miva and paste the URL into the Webhook URL field. Click Next.
   
   
   
    
8. Click Create on the Overview screen.
   You may be prompted that there are no conditions. If so, click Save.
   
   
    
9. Locate the Order Workflow you just created and ensure that it is enabled.
   
   

You are now ready to switch back to Postsale and complete the store setup.

Continue with step 4 - Complete the Postsale Store Setup.

1. Switch back to Postsale and click Next in the Connect Your Miva Store to Postsale screen.
   
   
    
2. Select the number of days (1 - 7) of order history to import into Postsale from the Days Back drop-down menu. Then, click Next. 
   
   Uncheck the Download Historical Order Data checkbox if you do not wish to import any order history.
   
   
   

   Double Check Historical Order Data

   To prevent duplicate shipments, carefully review all order statuses shown in the Online Status column, as some orders may have already been shipped outside of Postsale.

    

3. Verify that you wish for Postsale to perform the following actions automatically. Then, click Next.
   
   
   • When an order is first imported
     • Set the order's status to [select the status from the drop-down menu]
     • Enable this option to specify what the local status of the order should be set to when order's are imported for the first time. With this option disabled, the order's local status will be blank when imported.
   • When a shipment is processed
     • Set the order's status to ‘Shipped’
     • Upload the shipment information to Miva
   • When a shipment is voided
     • Set the order's status to ‘Voided’

4. Enter a name for the store into the Store Name field.
   
   • The store name you enter will be considered the Order Source in Postsale
   • The store name will be displayed in the Source column on the Orders Grid
   • Use the store name as the Order Source when creating Advanced Searches for orders associated with this store
     
     
      

5. (Optional) Click the Logo tile. Then, select an image file (png or jpg) from your computer.
    
   • Postsale supports JPEG and PNG files with a recommended size of 3 MB or less.
   • Larger image files will be reduced to the maximum file size of 3 megabytes when uploaded.
   • The image will be uploaded and become the logo for this store. 
   • The logo will automatically display in Postsale templates that include a logo, such as the Invoice with Logo template. 
   • Learn about editing an image in Postsale 
     
     
      
6. (Optional) Click Add Store Address to add a unique Ship From address from this store.
   Learn how to configure your Default Shipment settings so that the Store Address is automatically selected as the Ship From address for your shipments.
   
   
   
   Once entered, the address is displayed.
   
   
    
7. Click Finish.
   
   Your store is added and is displayed in the list of stores.
   Historical orders will be automatically imported into Postsale based on the number of days you selected.