1. ChannelEngine Help Center
  2. Marketplaces
  3. Macy's

Articles in this section

Macy's: marketplace guide

  • Created
  • Updated

About this guide

This is a ChannelEngine guide on the New York-based marketplace Macy's. Here you can find information on how to request a Macy's account, how to configure this marketplace on ChannelEngine, what the specific requirements are, and more.

Table of contents

Commercial information

How to request an account

Associated costs

Marketplace features

Settings and configuration

Marketplace-specific requirements and exceptions

Additional information

FAQs

Macy_s_-_front_end.png

Commercial information

Founded 28 October 1858
Headquarters New York, New York, United States
Area served (orders) United States
Area served (shipments) United States
Revenue circa USD 590 million (2021)
Number of monthly visits circa 100 million
Website Macy's
Setup cost none
Commission it depends on the category
Other costs none
Payment twice/month
Product categories cameras, fashion, cooking, DIY/gardening, electronics, erotic products, food, furniture/interior design, games/toys, healthcare, household appliances, kids/babies, pets, telecommunications equipment, video games
Input language English, French
Input currency USD
Content creation yes
Minimum number of SKUs no
Advertisement options yes
Profile on ChannelEngine Macy's

How to request an account

Macy's is an invite-only marketplace. If you are invited to sell on Macy's, the following requirements apply:

  • Verified UPC codes in the GS1 database for every proposed product.
  • UPS account for returns.
  • Hand-signed W-9 form (October 2018).
  • US business tax ID.
  • US-based warehouse(s).
  • US-based address(es​).

Associated costs

Macy's does not charge a setup fee or a monthly fee, but it does charge a commission fee that varies per product category.

Marketplace features

Supported Not supported
Product offers Repricing
Product content Marketplace fulfillment service
Orders HTML formatting
Cancelations Returns (marketplace)
Returns (merchant) Sales channels
Shipments  
Carrier mapping  
Refurbished products  

Settings and configuration

Setting up each marketplace on ChannelEngine follows the same flow, once you add the marketplace:

  1. Go through the Setup.
  2. Create a Product selection.
  3. Complete the Categorization.
  4. Set up the Mappings: content, offers, and carriers.
  5. Configure the Pricing: rules and currency conversion.
  6. Finish the Activation.
  7. Check the Listed products overview.

Marketplace-specific requirements and exceptions

Setup

On ChannelEngine

Macy's is a Mirakl-based marketplace, so you can connect it to ChannelEngine using a Mirakl Connect SSO account. For more information on this, check out the Mirakl-based channels: SSO authorization article.

Invoice uploads

To configure your invoice settings, click Advanced settings. You can then click the dropdown menu Enable invoice uploading, which contains the following options:

  • ChannelEngine invoices - when ChannelEngine receives a shipment, it automatically generates an invoice and attaches it to the shipment before exporting it.
  • Merchant invoices (optional) - when ChannelEngine receives a shipment, it exports it – even if there is no invoice attached to it.
  • Merchant invoices (required) - when ChannelEngine receives a shipment, it only exports it if an invoice is attached to it. If not, you receive a notification.
  • None - when ChannelEngine receives a shipment, it takes no action other than notifying you that no invoice is present.

If you select one of the Merchant invoices options, make sure to enable the invoice upload to ChannelEngine via the Merchant API. For that, call the POST /v2/orders/{merchantOrderNo}/invoice endpoint. Note that only invoices in PDF are supported.

Invalid XML characters

To remove invalid XML characters from your product data, click Advanced settings and enable the Check and filter invalid XML characters setting. ChannelEngine checks product data submitted in the XML format for invalid characters (e.g.: Ã, ¢, â, etc.). Once identified, invalid characters are removed or converted to a valid equivalent.

Categorization

Categorization on Macy's is straightforward, and all categories are listed in English.

Mappings

Content

All products (required)

  • Brand name - the product's brand or manufacturer.
  • Country of origin - state if the product was made in the US, or if it is imported.
  • Features and benefits bullet 1-3 - the product's main highlights. The maximum number of characters allowed is 254. E.g.: made with the finest organic cotton.
  • Legal warnings - the product's applicable warnings, if any. E.g.: may contain dairy, gluten, or nut ingredients.
  • Main image - the product's main image. The requirements are:
    • File format - JPEG/JPG or PNG.
    • Resolution - at least 1,000x1,000 px, since Macy's resizes and fills outsides with white to match 1,768x2,160 px (flat images, that is, with little contrast) or 3,894x4,755 px (on-figure images).
    • Resolution (swatch images) - 200x200 px.
    • Background - white (255, 255, 255 RGB).
    • No computer-generated images, except for computer-aided design (CAD) drawings for furniture.
    • No placeholders.
    • No blurry or poor-quality images.
    • No accessories that do not come with the product.
    • No duplicates.
    • Images must be appropriate. E.g.: no nudity.
    • Lifestyle images must make sense for the product being sold.
    • Images of nothing but a logo/badge are not accepted.
    • Include only images for which you have the right to use.
    • Include the energy rating label, if applicable.
  • MSRP (Manufacturer suggested retail price) - the product's recommended retail price.
  • NRF color code - the product's color code, according to the National Retail Federation (NRF). Ask your contact person at Macy's for this information.
  • NRF size code - the product's size code, according to the National Retail Federation (NRF). Ask your contact person at Macy's for this information.
  • NRF tax code - the product's tax code, according to the National Retail Federation (NRF). Ask your contact person at Macy's for this information.
  • Product dimensions 1 - the product's primary dimension in inches. Multiple values can be separated by commas (,). E.g.: 25, 30.
  • Product long description - the product's description, written in English. The maximum number of characters allowed is 300.
  • Product name - the product's name, written in English. The maximum number of characters allowed is 254.
  • Second image - the product's secondary image. For the image requirements, check out Main image.
  • Shop SKU - your internal product reference, usually the Merchant product number or SKU.
  • UPC - the product's universal product code (UPC). This is the unique identifier on Macy's.
  • Variant group code - enables variations of the parent product. Use the Parent SKU to group child products or the Merchant product number or UPC for standalone products.
  • Warranty - indicates if the product includes a warranty. If yes (Y), make sure to mention it in a Features and benefits bullet.

All products (optional)

  • Care instructions - the instructions related to the cleaning and drying of the product. E.g.: machine washable.
  • Features and benefits bullet 4-5 - the product's additional highlights. The maximum number of characters allowed is 254. E.g.: Encrusted with the shiniest crystals.
  • Product dimensions 1-2 - the product's secondary dimension in inches. Multiple values can be separated by commas. E.g.: 25, 30.
  • Product material - what the product is made of. Multiple materials can be separated by commas (,) or forward slashes (/), with each value capitalized. The maximum number of characters allowed is 254. E.g.: '60% Cotton/40% Piñatex' or '60% Cotton, 40% Piñatex'.
  • Product weight - the product's weight in lbs. The maximum number of digits after the decimal point is two. E.g.: 2.75.
  • Prop 65 warning - the product's applicable warning, if any, in compliance with California's Prop 65. 
  • Shipping dimension unit of measure - the unit of measurement related to the dimensions your shipments. The only option is inches.
  • Shipping height - the height of the packaged product.
  • Shipping length - the length of the packaged product.
  • Shipping weight - the weight of the packaged product.
  • Shipping weight unit of measure - the unit of measurement related to the weight your shipments. The only option is pounds.
  • Shipping width - the width of the packaged product.
  • Site color description - the product's color visible to buyers on Macy's. Note that this attribute must be associated with the NRF color code to avoid errors. E.g.: if the NRF color code is '000', the Site color description should be 'no color'.
  • Swatch image - the URL of the product variants' thumbnails.
  • Third image - the product's tertiary image. For the image requirements, check out Main image.

Offer

All products (required)

The only mandatory offer mapping is Price, which is your desired sale price.

All products (optional)

  • Discount end date - the date until when the product's sale price is valid, if applicable. The date format is YYYY-MM-DD HH:MM:SS ZZ. E.g.: 2022-12-31 23:59:59 +00.
  • Discount price - the product's sale price, if applicable.
  • Discount quantity threshold - the minimum quantity required for the discount rate to be available.
  • Discount start date - the date from when the product's sale price is valid, if applicable. The date format is YYYY-MM-DD HH:MM:SS ZZ. E.g.: 2022-12-31 23:59:59 +00.
  • Eco contributions - the environmental tax that applies to the product. The format is: [manufacturer identifier] | [amount, including decimals]. Multiple taxes can be split with a comma. E.g.: Fabricante | 2.50, Fabricant | 1.00.
  • Product tax code - determines the taxation that applies to the product.
  • Duties - the product’s duties value, if applicable. If you add duties, the value you enter in the Price attribute should be inclusive of duties. All products must be delivery-duty paid (DDP), so buyers are not charged duties for their purchases.

Working with discounts

  • To set up a discount, you must map the Discount price, Discount start date, and Discount end date attributes. If you want to set a permanent discount, map the Discount end date attribute with a date in the far future instead of leaving it unmapped. Otherwise the offer is not exported, and errors are shown on the Validation and feedback tab.
  • If your discounted price is not lower than the base price, it is not exported.
  • If you do not want to set a bulk discount, leave the Discount quantity threshold attribute unmapped – otherwise the export is broken.
  • If you do want to set a bulk discount, the Discount quantity threshold must be set to a value higher than 1. E.g.: a value of 2 indicates that two or more of the product must be purchased at the same time for the buyer to benefit from the discount.

The following offer attributes are common to some Mirakl-based marketplaces, particularly in France and Germany:

  • ECO #1-5 - Amount - the amount due for the eco-contribution related to the product. E.g.: 2.50.
  • ECO #1-5 - EPR category code - the extended producer responsibility (EPR) code that applies to the product. For a list of category codes, check out the article Providing data to comply with circular economy regulations in Mirakl's help center (note that you need to be logged in to Mirakl to access this page). E.g.: DE-WEEE, FR-DEA, etc. 
  • ECO #1-5 - Producer ID - your producer ID, received upon registering with a packaging register, such as Germany's LUCID. The maximum number of characters is 255.

The following offer attributes are common to Mirakl-based marketplaces:

  • Leadtime to shipment - the number of days before you ship the product. By default, this is set to two. You can create your own unique rules, if applicable.
  • Minimum quantity alert - map this attribute to receive a notification from ChannelEngine if your stock drops below the threshold defined.
  • Offer state - the product's condition. Find your option from the dropdown menu by selecting the fixed value to apply to all.
  • Product tax code - the taxation code applicable to the product.
  • Logistic class - your optional shipping class. Make sure to map it using the marketplace’s codes, not the labels visible in the front-end. These codes vary per marketplace. Below you can find the codes used by this marketplace:
Code Label Description
s small Small items. Less than 2 lbs, and less than 3 ft (LxWxH).
m medium Medium items. Between 2 and 10 lbs, and less than 6 ft (LxWxH).
l large Large items. Between 10 and 30 lbs, and less than 12 ft (LxWxH).
o1 oversize Oversized items. over 30 lbs, or more than 12 ft (LxWxH).

Carrier

Carrier mapping is not required on Macy's. However, you can map your carrier to a specific list of carriers maintained by Macy's. This allows for working tracking codes in the back-end, as well as for the buyer. If your default carrier is missing, contact Macy's.

Note that if you select Unknown as the carrier, you still need to provide a working tracking code.

It is mandatory to include a packing slip in your packages. This packing slip must reference the Commercial order ID, which is not exactly the same as Mirakl's Logistic order ID displayed on ChannelEngine as the order number.

If you are unable to provide the correct order number in the packing slip, you can use a placeholder footer. E.g.:

Thank you for shopping with a Macy’s Marketplace seller. 
Returns are accepted within 30 days of your initial shipping confirmation. 

To process a return, please follow the prompts within your profile on https://macys.com, where you’ll be able to print a label and drop off the package at any UPS store nationwide. 

Please refer to your order number without using any letters. Exchanges are not permitted.

Pricing

Macy's requires the prices to be submitted in USD. If you do not have pricing attributes in USD, you need to set a currency conversion.

Listed products

If you have problems with products not appearing on Mirakl-based marketplaces – especially if you are trying to create products – check the Listed products page for more information.

You can either filter on Channel status (select Invalid to show all products that ChannelEngine has not exported, such as products with an empty GTIN or that currently do not exist on the marketplace) or use the Validation and feedback tab to see all known errors for specific products.

For detailed status reports, go to the Mirakl back-end. Their reports contain specific errors if a product or product offer cannot be created. To find them, go to My inventory, Import from file, Track offer imports/Track product imports. By hovering over the 'i' under the Status section, you can see how many products in the file were processed correctly and how many had errors, etc.

If there are errors, the last column shows a downloadable file in which they are listed. The same goes for the product file import, but this can contain multiple files because processing goes through several systems. There is also a manual check of your submitted content, which, once approved, goes to staging as well. Note that you need to map as much as possible to prevent products from not being created.

Additional information

FAQs

How often does each task run on Mirakl-based marketplaces?

By default, Mirakl-based marketplaces follow the schedule below:

Task Frequency
Export product data to marketplace every 60 minutes
Export product offers to marketplace every 15 minutes
Import product offers from marketplace every 15 minutes
Import orders from marketplace every 15 minutes
Export order shipments to marketplace every 15 minutes
Export returns to marketplace every 30 minutes

Related articles

Comments

0 comments

Article is closed for comments.