The Orders section defines general order information:

Mappable Fields

• Source: Identifies the sales channel/order source for the order.      
  When mapped, the Source and Number fields are used together to uniquely identify an order in Postsale.
• Number: The order number/ID of the order. Used to uniquely identify orders in Postsale.
  If the Number field is unmapped or if no order number is imported, Postsale will auto-generate sequential order numbers for you.
• Status: Identifies the status of the order. (shipped, not shipped, backordered, etc.)
• Requested Shipping: Indicates the shipping method your customer requested.
• Date: The date the order was placed.     
  
  

The Ship To and Bill To addresses are mapped together by default. Enable the Map ship-to and bill-to addresses separately option to map them independently. 

Use the Items section to map the details of the items on your orders. There are two line item strategies available:

• Map items in a collection: Use this option if all items on the order are contained in a single array.
• Map items individually: Use this option if each item on the order is listed individually.

Select the correct option from the Item Mapping drop-down menu. Then, follow the steps below for the strategy that matches how your request is configured. 

Map Items in a Collection

1. Map the Items Path to the array in your request that contains all of the item information. 
   
    
    
2. Then, map the remaining fields in the Items section to the correct elements in your request. 
   
   

Map Items Individually

Map items for the maximum number of line items on a single order. 

For example: If the largest order contains 3 different items, follow these steps to add and map three individual items: 

1. Click the Add button. 
   
    
    
2. Map the Postsale item fields to the correct elements in your request. Then, click Save. 
   
   

Use the Charges section to map the details of the charges on your orders, such as Tax or Shipping. There are two strategies available:

• Map charges in a collection: Use this option if all charges on the order are contained in a single array.
• Map charges individually: Use this option if each charge on the order is listed individually.

Select the correct option from the Charge Mapping drop-down menu. Then, follow the steps below for the strategy that matches how your request is configured.

Map Charges in a Collection

1. Map the Charges Path to the array in your request that contains all of the charge information. 
   
    
    
2. Then, map the remaining fields in the Charges section to the correct elements in your request. 
   
   

Map Charges Individually

1. Click the Add button.
   
   
    
2. Map the following fields:
   1. Description: Map to the field in your file that describes the additional charge on the order.
   2. Amount: The amount of the additional charge.      
       
3. Select the type of charge from the Type drop-down menu.
   If no Type is selected, Postsale will attempt to identify and apply the correct charge type based upon the charge's Description.
    
4. Click Save.     
   
   

Add as many charges as you need to for the orders in your file. 

Use the Notes section to map the details any notes associated with your orders. There are two strategies available:

• Map notes in a collection: Use this option if all notes associated to the order are contained in a single array.
• Map notes individually: Use this option if each note on the order is listed individually.

Select the correct option from the Note Mapping drop-down menu. Then, follow the steps below for the strategy that matches how your request is configured.

Map Notes in a Collection

1. Map the Notes Path to the array in your request that contains all of the note information. 
   
    
    
2. Then, map the remaining fields in the Notes section to the correct elements in your request.
   
   

Map Notes Individually

Add a map for each note associated with your orders.  

For example: If you have a thank you message to your customers and an internal note for each order, you will add two note mappings. 

1. Click the Add button. 
   
   
    
2. Map the Date and Content fields.
   When the Date field is left unmapped, Postsale assigns the current date as the import date. 
    
3. Click Save. 
     
   

Use the Payment section to map the Payments and additional Payment Details for orders in your source file. 

Payment

The payment fields are used to map the actual payment type and payment amount.

Map the Name and Amount fields.

• Name: Map to the column in your file that contains the payment type. (PayPal, Credit Card, etc.)
• Amount: Map to the column that contains the payment amount.    
  
     

Payment Details

Think of Payment Details as important information related to the Payment itself, such as the type of credit card used or the last four digits of a credit card number, etc. 

There are two strategies available when mapping additional payment details:

• Map payment details in a collection: Use this option if all payments associated with the order are contained in a single array.
• Map payments individually: Use this option if each payment on the order is listed individually.

Select the correct option from the Payments Mapping drop-down menu. Then, follow the steps below for the strategy that matches how your request is configured.

Map Payments in a Collection

1. Map the Payments Path to the array in your request that contains all of the payment information. 
   
    
    
2. Then, map the remaining fields in the Payments section to the correct elements in your request. 
   
   

Map Payment Details Individually

1. Click the Add button. 
   
    
    
2. Map the Name and Value fields. Then, click Save. 
   The additional payment details have been added. 
   
   
    
3. Repeat steps 1 and 2 to add multiple payment details.
   
   The mapped payment details will be listed in the Payment Details section.
   
   

The Shipment section allows you to map the shipment and package details for each order in your webhook request to the appropriate shipment and package fields in Postsale so that a shipment is automatically created for each order.

This has several, powerful advantages:

• It saves time. You won't need to create a shipment for each order.
• You can preview and select rates for each shipment as soon as the orders are added to Postsale.
• Orders can be batch processed right away since each order is already configured with valid shipment and package details.

Shipment Mapping

Use the Shipment Fields section to map the fields for the shipment information, such as the shipping carrier and service, insurance, shipping confirmation, etc.

Package Mapping

Correctly mapping the package information allows Postsale to associate multiple packages with a single shipment. There are two strategies for mapping package details (package type, dimensions, and weight) in the Shipment section.

• Map packages in a collection: Use this option if all package information is contained in a single array.
• Map packages individually: Use this option if each package is listed individually.

Select the correct option from the Shipment Package Mapping drop-down menu. Then, follow the steps below for the strategy that matches how your request is configured.

Map Packages in a Collection

1. Map the Packages Path to the array in your request containing all package information. 
   
    
    
2. Then, map the remaining package fields to the correct elements in your request. 
   
   

Map Packages Individually

Add a package map for the maximum number of packages associated with your orders.

For example: If you ship some of your orders in 2 separate packages, you'll add 2 package mappings.

1. Click the Add button. 
   
    
    
2. Map the package fields. Then, click Save. 
   
   

Shipment and Package Field Information