Documentation Portal

Prepare your CSV file containing your list of fixed prices and populate it.

Each column in your CSV file must have the following headers, respectively:

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.

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.

curl --location 'https://[globale domain]/[API]' \
--header 'MerchantGUID: D2ED2A7F-F6ED-4CCB-B611-B44AC8D02250' \
--header 'Content-Type: application/json' \
--data-raw '

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.

Upload your Fixed Price CSV File to Global-e.

PATH: https://<domain address>/PCE/UploadFile?merchantGUID=<Merchant GUID>

TYPE: POST

BODY:

<Fixed Price CSV File> (from data)

RESPONSE:

200 OK: 
      {
           RunId ": " b2b477e7 - 9e0e-4b07 - be89 - 2b9122788d6b "
      }

ERRORS:

{ 
"Message": "CSV file contains rows with invalid
 data. Make sure the file has the correct format
 and contains the correct information.",

"Errors": [
",43416058200314,,PLN,201,201,400",
",43416058200314,FR,EUR,301,401,400"
  ]
}

CUrl EXAMPLE:

curl--location--request POST 'https://<domain>.com/PCE/UploadFile?merchantGUID=<Guid>' \
--form '=@"/<Full Path Name>.csv"'

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>

TYPE: GET

RESPONSE:

200 OK:
{
    "RunId": "84f9929c-1ea1-4edd-bc56-c4ef73a92e88",
    "FileName": "[Ecommerce_Platform_Name]_QA_Artem_01.08.2023_06_all_valid.csv",
    "DateCreated": "2023-08-11T10:04:57.462022+00:00",
    "Status": "Completed",
    "HasErrors": false,
    "CompletionPercentage": 100
}

PARAMETERS:

ERRORS:

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>

TYPE: GET

RESPONSE:

          200 OK:
          File (application/octet-stream)

ERRORS:

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 F, as shown below:

Field Descriptions and Requirements

Headers / Fields	Description
SKU	Enter the Product SKU as it appears in your product catalogue . The SKU may not include spaces. If this field is empty, the Variant ID field must be populated.
Variant ID	Enter the Product Variant ID, as assigned in your product catalogue . If this field is empty, the SKU field must be populated.
country_code	Enter the ISO-2 country code to indicate the country relevant to this price. For instance, DE (Germany), US (USA). If this field is empty, the currency_code field must be populated.
currency_code	Enter the 3-char currency code (ISO-4271) to indicate the currency relevant for this change. For instance, USD (US dollar), AUD (Australian dollar), EUR (Euro), CHF (Swiss franc), and more. If this field is empty, the country_code field must be populated.
price	Enter the fixed price value for the product. This value can only contain numbers. Caution Do not include commas in the prices you list in the CSV file as the prices will not parse correctly. Keep empty to remove a previously set fixed price without setting a new one. In this case, the dynamic price conversion rules set for the current country apply.
compare_at_price	Enter the fixed price value of the product before the discount. This value can only contain numbers. Caution Do not include commas in the prices you list in the CSV file as the prices will not parse correctly. Keep empty to remove a previously set fixed price without setting a new one. In this case, the dynamic price conversion rules set for the current country apply.