{"section":"tutorials","requestedLocale":"en","requestedSlug":"creating-pickup-points","locale":"en","slug":"creating-pickup-points","path":"docs/en/tutorials/shipping/pickup-points/creating-pickup-points.md","branch":"main","content":"Pickup points are physical locations where customers can pick up orders placed on ecommerce platforms. Configuring pickup points is an optional step in your store's [shipping strategy](/en/docs/tutorials/shipping-strategy). \n\nYou can create pickup points using the [Create/update pickup point API](https://developers.vtex.com/vtex-rest-api/reference/pickup-points-1#createupdate) or via VTEX Admin. This article explains how to perform the second process.\n\nThere are two ways to create a pickup point in the Admin:\n\n* [Creating pickup points individually](#creating-pickup-points-individually)\n* [Creating pickup points using the template](#reating-pickup-points-using-the-template)\n\n> ⚠️ Creating pickup points is one of the steps required for the feature to work properly. Please refer to the article [pickup points](/en/docs/tutorials/pickup-points) to see the other [settings necessary](/en/docs/tutorials/pickup-points#setup) to make pickup points available to your customers.\n\n## Creating pickup points individually\n\n1. In the VTEX Admin, go to **Shipping > Pickup points**, or type *Pickup points* in the search bar at the top of the page. \n3. Click <i class=\"fas fa-plus\"></i> `Add pickup point`.\n4. Fill in the [fields](#fields).\n5. Click `Save changes`.\n\n### Fields\n\n#### General information\n\n* **Name:** name of the pickup point as it will be displayed at checkout.\n* **ID:** identification of the pickup point. If this field is not filled in, the system will choose an ID automatically. Do not use space characters.\n* **Third-party pickup point:** check this box if the pickup point is not related to your store. Third-party pickup points are displayed with less relevance than those of your own store.\n\n  > ❗ The **Third-party pickup point** configuration currently is not available.\n\nSelect <i class=\"fas fa-toggle-on\"></i> to activate the pickup point.\n\n#### Pickup point address\n\n* **Country:** the country where the pickup point is located.\n* **Search address:** enter the address information for the search. You can use the zip code, street, city, number, and additional address information. \n* To edit the address information, click `Edit`. \n* To add a different address, click `Clear` and search again.> ℹ️ The address information and the location on the map will be displayed at checkout.\n\n#### Additional information\n\n* **Pickup instructions:** enter information that will help your customer pick up the packages at the pickup point. For example, at which door the items can be picked up or which documents the customer must present when picking up their order. These instructions will be displayed at checkout, when the customer chooses the pickup point. \n* **Tags:** add tags to group pickup points. These tags are used to link [shipping policies](/en/docs/tutorials/shipping-policy) to pickup points.  \n\n#### Business Hours\n\n* **Days of the week:**\n    1. Check the boxes for the days the pickup point will be available for your customers to pick up their orders. \n    2. Select the pickup point's business hours for each day.> ℹ️ If this field is not filled in, the platform will consider that the pickup point operates 24 hours a day.\n\n* **Exceptions or holidays:** to add specific days when the pickup point is not operating, follow the steps below.\n    3. Click `Add an exception`;\n    4. Fill in the day and time;\n    5. Click on `Add`.\n\n> ⚠️ The business hours defined for a pickup point are for informative purposes only and are not used for SLA calculation. To change the settings that influence the delivery time frame, please specify the business hours in the [shipping policy](/en/docs/tutorials/shipping-policy) related to the pickup point. Holidays must be configured on the [Holidays page](/en/docs/tutorials/registering-holidays), so that they can be considered in the delivery time calculation.\n\n## Creating pickup points using the template\n\nYou can create pickup points by importing the template (XLS file). This way, you can create more than one pickup point at a time.\n\n> ℹ️ The XLS file must not exceed 10MB (approximately 50,000 pick points). If necessary, you can upload more than one template.\n\n1. In the VTEX Admin, go to **Shipping > Pickup points**, or type *Pickup points* in the search bar at the top of the page. \n2. Click <i class=\"fas fa-upload\"></i> `Upload an XLS`.\n3. Download the template and fill in the [fields](#template-fields).> ℹ️ Please note that the template comes with example values, which must be replaced with the data from your store's pickup points.\n4. After uploading the template, click `OK`.   \n\n### Template fields\n\nFill in the template according to the information in the table below.\n\n<table class=\"w-100 center mv7 bb b--gray\">\n    <thead class=\"w-100 center mv7 bb b--gray\">\n  <tr class=\"t-body fw5 c-muted-1 bb bw1 pa2 pb3 b--muted-3 tl\">\n            <th class=\"t-body fw5 c-muted-1 bb bw1 pa2 pb3 b--muted-3 tl\">**Template column**\n   </th>\n   <th class=\"t-body fw5 c-muted-1 bb bw1 pa2 pb3 b--muted-3 tl\">**Description**\n   </th>\n   <th class=\"t-body fw5 c-muted-1 bb bw1 pa2 pb3 b--muted-3 tl\">**Required field**\n   </th>\n   <th class=\"t-body fw5 c-muted-1 bb bw1 pa2 pb3 b--muted-3 tl\">**Example**\n   </th>\n  </tr>\n  <tr class=\"bb b--muted-3\">\n            <td class=\"t-body pa5\">**ID**\n   </td>\n   <td>Identification code of the pickup point.\n   </td>\n   <td><center>No</center>\n   </td>\n   <td><span class=\"t-body c-on-base pa2 mw6 br2 bg-muted-4\">123</span>\n   </td>\n  </tr>\n  <tr class=\"bb b--muted-3\">\n            <td class=\"t-body pa5\">**Name**\n   </td>\n   <td>Name of the pickup point displayed to the customer at checkout.\n   </td>\n   <td><center>Yes</center>\n   </td>\n   <td><span class=\"t-body c-on-base pa2 mw6 br2 bg-muted-4\">Pickup point A</span>\n   </td>\n  </tr>\n  <tr class=\"bb b--muted-3\">\n            <td class=\"t-body pa5\">**Description**\n   </td>\n   <td>Description of the pickup point displayed at checkout.\n   </td>\n   <td><center>No</center>\n   </td>\n   <td><span class=\"t-body c-on-base pa2 mw6 br2 bg-muted-4\">Store located in mall X</span>\n   </td>\n  </tr>\n  <tr class=\"bb b--muted-3\">\n            <td class=\"t-body pa5\">**Instructions**\n   </td>\n   <td>Instructions to facilitate the pickup.\n   </td>\n   <td><center>No</center>\n   </td>\n   <td><span class=\"t-body c-on-base pa2 mw6 br2 bg-muted-4\">Pick up your package at the main entrance</span>\n   </td>\n  </tr>\n  <tr class=\"bb b--muted-3\">\n            <td class=\"t-body pa5\">**CountryName**\n   </td>\n   <td>Country where the pickup point is located.\n   </td>\n   <td><center>No</center>\n   </td>\n   <td><span class=\"t-body c-on-base pa2 mw6 br2 bg-muted-4\">United States</span>\n   </td>\n  </tr>\n  <tr class=\"bb b--muted-3\">\n            <td class=\"t-body pa5\">**City**\n   </td>\n   <td>City where the pickup point is located.\n   </td>\n   <td><center>No</center>\n   </td>\n   <td><span class=\"t-body c-on-base pa2 mw6 br2 bg-muted-4\">Los Angeles</span>\n   </td>\n  </tr>\n  <tr class=\"bb b--muted-3\">\n            <td class=\"t-body pa5\">**PostalCode**\n   </td>\n   <td>Zip code of the pickup point location. \n   </td>\n   <td><center>Yes</center>\n   </td>\n   <td><span class=\"t-body c-on-base pa2 mw6 br2 bg-muted-4\">90007</span>\n   </td>\n  </tr>\n  <tr class=\"bb b--muted-3\">\n            <td class=\"t-body pa5\">**CountryAcronym**\n   </td>\n   <td>3-digit country code according to ISO 8601 (RFC 3339).\n   </td>\n   <td><center>Yes</center>\n   </td>\n   <td><span class=\"t-body c-on-base pa2 mw6 br2 bg-muted-4\">USA</span>\n   </td>\n  </tr>\n  <tr class=\"bb b--muted-3\">\n            <td class=\"t-body pa5\">**State**\n   </td>\n   <td>State where the pickup point is located (abbreviation).\n   </td>\n   <td><center>No</center>\n   </td>\n   <td><span class=\"t-body c-on-base pa2 mw6 br2 bg-muted-4\">CA</span>\n   </td>\n  </tr>\n  <tr class=\"bb b--muted-3\">\n            <td class=\"t-body pa5\">**Latitude**\n   </td>\n   <td>Latitude of the pickup point.\n   </td>\n   <td><center>Yes</center>\n   </td>\n   <td><span class=\"t-body c-on-base pa2 mw6 br2 bg-muted-4\">-22,94</span>\n   </td>\n  </tr>\n  <tr class=\"bb b--muted-3\">\n            <td class=\"t-body pa5\">**Longitude**\n   </td>\n   <td>Longitude of the withdrawal point. \n   </td>\n   <td><center>Yes</center>\n   </td>\n   <td><span class=\"t-body c-on-base pa2 mw6 br2 bg-muted-4\">-43</span>\n   </td>\n  </tr>\n  <tr class=\"bb b--muted-3\">\n            <td class=\"t-body pa5\">**Neighborhood**\n   </td>\n   <td>Neighborhood where the pickup point is located.\n   </td>\n   <td><center>No</center>\n   </td>\n   <td><span class=\"t-body c-on-base pa2 mw6 br2 bg-muted-4\">Downtown Los Angeles</span>\n   </td>\n  </tr>\n  <tr class=\"bb b--muted-3\">\n            <td class=\"t-body pa5\">**Street**\n   </td>\n   <td>Street where the pickup point is located.\n   </td>\n   <td><center>No</center>\n   </td>\n   <td><span class=\"t-body c-on-base pa2 mw6 br2 bg-muted-4\">S Grand Avenue</span>\n   </td>\n  </tr>\n  <tr class=\"bb b--muted-3\">\n            <td class=\"t-body pa5\">**Number**\n   </td>\n   <td>Number (address) of the pickup point.\n   </td>\n   <td><center>No</center>\n   </td>\n   <td><span class=\"t-body c-on-base pa2 mw6 br2 bg-muted-4\">300</span>\n   </td>\n  </tr>\n  <tr class=\"bb b--muted-3\">\n            <td class=\"t-body pa5\">**Complement**\n   </td>\n   <td>Additional address information.\n   </td>\n   <td><center>No</center>\n   </td>\n   <td><span class=\"t-body c-on-base pa2 mw6 br2 bg-muted-4\">#100</span>\n   </td>\n  </tr>\n  <tr class=\"bb b--muted-3\">\n            <td class=\"t-body pa5\">**Reference**\n   </td>\n   <td>Reference point to help the customer find the pickup point.\n   </td>\n   <td><center>No</center>\n   </td>\n   <td><span class=\"t-body c-on-base pa2 mw6 br2 bg-muted-4\">In front of the park</span>\n   </td>\n  </tr>\n  <tr class=\"bb b--muted-3\">\n            <td class=\"t-body pa5\">**IsActive**\n   </td>\n   <td>Enter <span class=\"t-body c-on-base pa2 mw6 br2 bg-muted-4\">true</span> to activate the pickup point or <span class=\"t-body c-on-base pa2 mw6 br2 bg-muted-4\">false</span> to deactivate it. Active pickup points are displayed at checkout.\n   </td>\n   <td><center>No</center>\n   </td>\n   <td><span class=\"t-body c-on-base pa2 mw6 br2 bg-muted-4\">true</span>\n   </td>\n  </tr>\n  <tr class=\"bb b--muted-3\">\n            <td class=\"t-body pa5\">**BusinessHours**\n   </td>\n   <td>Indicates the operating hours of the pickup point. It must be filled in as follows:\n<body>\n<ul>\n<li>WeekDay,StartTime,EndTime, without spaces, separated by commas. </li>\n<li>Add one weekday at a time, with its respective opening hours, separated by semicolons (;). </li>\n<li>The days of the week must be filled in according to the following codes: 0 = Sunday, 1 = Monday, 2 = Tuesday, 3 = Wednesday, 4 = Thursday, 5 = Friday, 6 = Saturday.</li>\n<li>Times must follow the 24-hour standard and the hh:mm format, where hh represents the hour and mm represents the minutes.</li>\nThis field is not considered for SLA calculation.  To change the settings that influence the delivery time frame, please specify the hours of operation in the [shipping policy](/en/docs/tutorials/shipping-policy) related to the pickup point. Holidays must be configured on the [Holidays](/en/docs/tutorials/registering-holidays) page, so that they can be considered in the delivery time calculation.\n</ul>\n</body>\n   </td>\n   <td><center>No</center>\n   </td>\n   <td>For example, if a pickup point operates on Mondays and Tuesdays from 9:00 am to 6:00 pm, the field must be filled in as follows: <span class=\"t-body c-on-base pa2 mw6 br2 bg-muted-4\">1,09:00:00,18:00:00;2,09:00:00,18:00:00;</span>\n   </td>\n  </tr>\n  <tr class=\"bb b--muted-3\">\n            <td class=\"t-body pa5\">PickupHolidays\n   </td>\n   <td>Fill in this field if there are days when the pickup points are not available. It must be filled in as follows:\n<body>\n<ul>\n<li>Date,StartTime,EndTime, without using spaces, separated by commas. </li>\n<li>The date must be entered following the format yyyy-mm-dd, where yyyy represents the year, mm represents the month, and dd represents the day.</li>\n<li>Holidays must be added one by one. To add more than one holiday, separate them using semicolons (;), without using spaces.</li>\n<li>Times must follow the 24-hour standard and the hh:mm format, where hh represents the hour and mm represents the minutes.</li>\n</ul>\n</body>\n   </td>\n   <td><center>No</center>\n   </td>\n   <td>A holiday on December 28, 2018 would be filled in as follows:\n<span class=\"t-body c-on-base pa2 mw6 br2 bg-muted-4\">2018-12-28,00:00,00:00</span>\nA holiday on November 25, 2016 with operation starting at 1:00 pm would be filled in as follows: \n<span class=\"t-body c-on-base pa2 mw6 br2 bg-muted-4\">2016-11-25,00:00, 13:00;2018-11-17T00:00:00Z,00:00,00:00</span>\n   </td>\n  </tr>\n  <tr class=\"bb b--muted-3\">\n            <td class=\"t-body pa5\">Tags\n   </td>\n   <td>Enter tags to identify a group of pickup points.\n   </td>\n   <td><center>No</center>\n   </td>\n   <td><span class=\"t-body c-on-base pa2 mw6 br2 bg-muted-4\">pickup1;pickup2;pickup3</span>\n   </td>\n  </tr>\n  </table>"}