Skip to main content

Overview

The Fixed Price Management feature lets you manage your local market prices by uploading a file describing the fixed prices for specific products and territories. Note that these prices override Shopify pricelists set via API, ignoring country or currency restrictions. In the past you could only submit new prices to update immediately. Now you can select a date and time for your price submissions to go into effect. The following figure shows the Fixed Price Management screen:

Uploaded File Table

The following figure shows the uploaded file table:
The table above shows the file, status, submission date, effective date, and user.

Accessing Fixed Price Management

To access the Fixed Price Management feature
  1. Navigate to Merchants > Product Management > Fixed Price Management from the top menu.
  2. Select a merchant from merchant menu located at the top of the page.

Setting Up Your Price Sheet

Price sheets you submit must be in CSV format, and you can download a sample CSV format to use as the basis for your submissions by clicking Download Sample. The sample file includes an example and explanation of each value. The downloadable sample does not include the product_id column yet. To upload prices by product, add product_id as the first column, as shown in the example below. Price sheets require the following information: Uploading prices by product No setup is required. Add the product_id column to your file.
  • A row with a product_id and no variant_id or sku applies the price to all variants of that product.
  • If the variant_id field is populated, the price applies to that variant only.
  • You can mix product rows and variant rows in the same file.
  • Variants added to a product after the upload do not get the uploaded price. Upload the price again for that product.
  • Files without the product_id column are still supported.
The following example shows a file with both kinds of row:
The first row prices all variants of the product. The second row prices a single variant.

Populating Your File

Once you’ve set up your file, you can populate it.
Global-e does not support uploading XLS files. Enabling Editing in your CSV file may cause your security settings to change the CSV file format to XLS. Before uploading a file, verify that you’ve saved it in the CSV format.
Including commas in your file will not upload.
To populate your file
  1. Add a list of products with one product per row.
  2. Save your file in CSV format.

Submitting Price Sheets

To submit price sheets
  1. Select one of the following:
    • Submit Now – Skip to Step 2.
    • Schedule Upload – Set your start date and time.
  2. Upload your csv file by clicking Upload CSV File.
  3. Click Submit. The file is added to the table showing all the uploaded price sheets.
  4. (Optional) If your file fails uploading, resolve the issue and continue with Step 5. See Fixing Validation Errors to identify and resolve the cause of your failed upload.
  5. Provide an email address.
You can sort the uploaded price sheets by date using the From Date and To Date fields to the right of the email field.
Global‑e will send you a notification email when you upload a list and a follow-up email when the upload is completed. Note that you can dragdown the email address field from the arrows to see previously entered email addresses.

Rescheduling Your Upload Date

You can edit your upload schedule as long as your file in the Ready for upload stage and has not completed uploading. To reschedule your upload date
  1. Click located at the far right in a row.
  2. Reschedule your upload and click Update.

Cancelling a Publish

You can cancel a publish as long as your file has not completely unloaded. You can do by this by clicking located at the far right in a row.

Reviewing Current Fixed Prices

You can review your current fixed prices by downloading a CSV file containing the current fixed prices. To this, click located near the upper right corner of the table.

Tracking File Status

The Fixed Price Management feature displays the file upload and file validation statuses when you upload your files. This section describes these statuses.

File Upload Statuses

The file upload status describes whether your file has uploaded or not, due to an error. The file upload statuses are shown in the table below: For more information on fixing validation errors, see Fixing Validation Errors.

File Validation Statuses

The file validation status describes whether your file has been validated or not. The file validation statuses are shown in the table below: You can click on the indicators displayed in the table, which opens a csv sheet containing only the valid or invalid rows respectively. All invalid files must be corrected and uploaded separately. For information on fixing validation errors, see Fixing Validation Errors.

Fixing Validation Errors

This section describes the validation errors that may occur when you upload your price lists.

Fixed Prices Upload via API

The Upload Fixed Prices API lets you upload your list of fixed prices to Global-e. In addition, you can check the upload status and retrieve the error file.

Prerequisites

Prepare your CSV file containing your list of fixed prices and populate it. The columns must be in this order:
Do not use commas as part of the values in the following fields: price and compare-at-price For more information, see Set Up a New Price List.

Authentication: MerchantGUID

To implement API calls with Global-e the only required information is the merchantGUID provided by Global-e. For authentication, make sure to include your Merchant GUID as part of each call or as part of the header so that Global-e can verify your identity. Make sure to use the appropriate merchantGUID, depending on the Global‑e integration environment used for development or production purposes. See Global-e Environments. MerchantGUID in URL Add your MerchantGUID as part of each API URL. MerchantGUID as part of the header Add your MerchantGUID as part of the header as illustrated below.

Flow

  1. Call the UploadFile endpoint to upload your Fixed Prices CSV file to Global-e.
  2. Call the GetUploadedFileDetails to get the details of the file you uploaded and verify the Upload status.
  3. Call GetFileWithValidationErrors to retrieve the file containing the errors.
If previously configured, you can retrieve your configuration file, modify your price list, and re-upload it. However, note that the prices (data) are overwritten and a new RunId (Global-e ID) is created.

UploadFile

Upload your Fixed Price CSV File to Global-e. MethodURL
Request <Fixed Price CSV File> (from data) Response
Errors CUrl EXAMPLE:

GetUploadedFileDetails

This endpoint returns the details of the uploaded file, including the upload completion status. PATH: [https://<domain address> /PCE/GetUploadedFileDetails?merchantGUID=<Merchant GUID>&runId=<GUID provided by Upload file endpoint>](https://<domain address> /PCE/GetUploadedFileDetails?merchantGUID=<Merchant GUID>&runId=<GUID provided by Upload file endpoint>) TYPE: GET RESPONSE:
PARAMETERS: ERRORS:

GetFileWithValidationErrors

This endpoint always returns a CSV file with the headers. If there are errors, the file contains the rows where errors were identified. PATH: [https://<domain address> /PCE/GetFileWithValidationErrors?merchantGUID=<Merchant GUID>&runId=<GUID provided by Upload file endpoint>](https://<domain address> /PCE/GetFileWithValidationErrors?merchantGUID=<Merchant GUID>&runId=<GUID provided by Upload file endpoint>) TYPE: GET RESPONSE:
ERRORS:

Set up a New Price List

The following procedure details the steps required to set up a new list of fixed prices and upload it to Global‑e.

Step 1. Prepare your Price List in CSV Format

In your CSV file, make sure to name the columns headers A through G, as shown below:

Field Descriptions and Requirements

Step 2. Populate your CSV File

When enabling editing in your CSV file, your security settings may change the CSV file format to Excel. Make sure to save your file back to CSV before uploading it to Global-e.
To populate your CSV file:
  1. Add your list of products, one product per row with the relevant information in the relevant column, according to the Field Descriptions and Requirements in Step 1. To ensure optimal accuracy, make sure to use the following values when populating fixed price data in your CSV file.
    Do not include commas in the prices you list in the CSV file as the prices will not parse correctly.
    • Price per country and currency:
      OR (based on variant_id):
    • Price per currency (affects all countries with the same currency):
      OR (based on variant_id):
    • Price per product (affects all variants of the product):
  2. When done, make sure to save your file as CSV.