{"id":8775,"date":"2021-04-26T18:09:01","date_gmt":"2021-04-26T22:09:01","guid":{"rendered":"https:\/\/impresee.com\/?page_id=8775"},"modified":"2021-09-29T12:16:23","modified_gmt":"2021-09-29T15:16:23","slug":"services-for-integrators","status":"publish","type":"page","link":"https:\/\/impresee.com\/es\/services-for-integrators\/","title":{"rendered":"Services for Integrators"},"content":{"rendered":"<p>[et_pb_section fb_built=&#8221;1&#8243; _builder_version=&#8221;4.7.7&#8243; _module_preset=&#8221;default&#8221; da_disable_devices=&#8221;off|off|off&#8221; global_colors_info=&#8221;{}&#8221; da_is_popup=&#8221;off&#8221; da_exit_intent=&#8221;off&#8221; da_has_close=&#8221;on&#8221; da_alt_close=&#8221;off&#8221; da_dark_close=&#8221;off&#8221; da_not_modal=&#8221;on&#8221; da_is_singular=&#8221;off&#8221; da_with_loader=&#8221;off&#8221; da_has_shadow=&#8221;on&#8221;][et_pb_row column_structure=&#8221;3_4,1_4&#8243; _builder_version=&#8221;4.7.7&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;][et_pb_column type=&#8221;3_4&#8243; _builder_version=&#8221;4.7.7&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;][et_pb_text _builder_version=&#8221;4.9.3&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<h1 class=\"flex-auto min-width-0 mb-2 mb-md-0 mr-0 mr-md-2 gh-header-title\">Impresee API for platform integrators<\/h1>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.3&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<p><strong>This document describes how you can integrate <em>Impresee&#8217;s <\/em>services into any e-commerce platform.\u00a0<\/strong><\/p>\n<p>[\/et_pb_text][et_pb_text module_id=&#8221;basics&#8221; _builder_version=&#8221;4.7.7&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<h2>Lo esencial<\/h2>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.3&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<p>Impresee has released different services to allow the integration of our search engine into any e-commerce platform, and also to enable the creation of individual instances of the search engine for every different store. To access these services it is necessary to have an <strong>integrator api key<\/strong>. This key will be provided by Impresee. If you want to integrate our services into your platform you can request an api key sending us an email to <a href=\"mailto:support@impresee.com\">support@impresee.com<\/a> .<\/p>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.3&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<p>The services that are available to integrators are documented in detail below:<\/p>\n<p>[\/et_pb_text][\/et_pb_column][et_pb_column type=&#8221;1_4&#8243; _builder_version=&#8221;4.7.7&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;][et_pb_text _builder_version=&#8221;4.10.7&#8243; _module_preset=&#8221;default&#8221; hover_enabled=&#8221;0&#8243; global_colors_info=&#8221;{}&#8221; sticky_enabled=&#8221;0&#8243;]<\/p>\n<ul>\n<li><a href=\"#create_a_store\">Create a store<\/a><\/li>\n<li><a href=\"#create_the_catalog\">Create the catalog<\/a><\/li>\n<li><a href=\"#register_snippet_webhook\">Register snippet webhook<\/a><\/li>\n<li><a href=\"#refresh_the_catalog\">Refresh the catalog<\/a><\/li>\n<li><a href=\"#register_conversion\">Register conversion<\/a><\/li>\n<li><a href=\"#signup_into_the_impresee_console\">Login into the Impresee Console<\/a><\/li>\n<li><a href=\"#delete_store\">Delete store<\/a><\/li>\n<\/ul>\n<p>[\/et_pb_text][\/et_pb_column][\/et_pb_row][et_pb_row _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;][et_pb_column type=&#8221;4_4&#8243; _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;][et_pb_text module_id=&#8221;create_a_store&#8221; _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<h2>Create a store<\/h2>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<p><span class=\"Y2IQFc\" lang=\"en\"><span><br \/>The first step to integrate with impresee is to create an instance of the search engine for a store, for this you only need an integrator api key. The URL to create a store is the following:<\/span><\/span><\/p>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<p><span style=\"color: #999999;\"><em>POST<br \/><\/em><\/span><span style=\"color: #999999;\"><em>https:\/\/api.impresee.com\/ImpreseeAdmin\/api\/integrators\/v1\/create_store\/{integrator-api-key}<\/em><\/span><\/p>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<p>The above request corresponds to a POST, where the store data is sent through a json in the body, below is an example of a valid json.<\/p>\n<p>[\/et_pb_text][et_pb_code _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<script src=\"https:\/\/gist.github.com\/anibal-fuentes-impresee\/9468e9879c481d5622b3879acc3b3d7b.js\"><\/script>[\/et_pb_code][et_pb_text _builder_version=&#8221;4.9.3&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<p>The description of each parameter is documented below:<\/p>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<pre class=\"line-numbers  language-markdown\" title=\"Double click to select all\"><code class=\"language-markdown\" id=\"result-code\">| Field         | Type   | Required | Description                             |\n|---------------|--------|----------|-----------------------------------------|\n| store_url     | String | yes      | store url                               |\n| store_name    | String | yes      | store name                              |\n| store_country | String | yes      | store country                           |\n| store_city    | String | yes      | store city                              |\n| locale_code   | String | yes      | store language and territory identifier |\n| timezone_code | String | yes      | timezone code for the store             |\n| user_name     | String | yes      | store owner name                        |\n| user_email    | String | yes      | store owner email                       |<\/code><\/pre>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<p>The server will return status 200 with the following json:<\/p>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<pre class=\"line-numbers  language-markdown\" title=\"Double click to select all\"><code class=\"language-markdown\" id=\"result-code\">| Field         | Type   | Description                                                                |\n|---------------|--------|----------------------------------------------------------------------------|\n| status        | int    | 0: success, 1: error                                                       |\n| error_message | String | If status=1, a message with the error description                          |\n| store_key     | String | Store key, if will be used to access the rest of the services of the store |<\/code><\/pre>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<p><strong>It is critical to save the store-key in some database<\/strong>, because it will allow you to access the rest of the services.<\/p>\n<p>[\/et_pb_text][\/et_pb_column][\/et_pb_row][et_pb_row _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;][et_pb_column type=&#8221;4_4&#8243; _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;][et_pb_text module_id=&#8221;create_the_catalog&#8221; _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<h2>Create the store catalog<\/h2>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<p>Once a store has been created, it is necessary to create and update its catalog, this is done in three steps: create the catalog itself, register a webhook to update the js code with which the search engine will be displayed within the store, and finally refresh the catalog to download the product information and process the images.<\/p>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<p>The first step is then to create the catalog itself, which consists of registering the download and format information of the catalog, <span>together with its product types. This service will return a url with the code that must be inserted in the store&#8217;s html header in order to use the search tools. The url of the service is:<\/span><\/p>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<p><span style=\"color: #999999;\"><em>POST<br \/><\/em><\/span><span style=\"color: #999999;\"><em>https:\/\/api.impresee.com\/ImpreseeAdmin\/api\/integrators\/v1\/create_catalog\/{integrator-api-key}\/{store-key}<\/em><\/span><\/p>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<p>The above request corresponds to a POST, where the catalog data is sent through a json in the body, below is an example of a valid json.<\/p>\n<p>[\/et_pb_text][et_pb_code _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<script src=\"https:\/\/gist.github.com\/anibal-fuentes-impresee\/81b69b01556aa4635b4cd14c26fa8d65.js\"><\/script>[\/et_pb_code][et_pb_text _builder_version=&#8221;4.9.3&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<p>The description of each parameter is documented below:<\/p>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<pre class=\"line-numbers  language-markdown\" title=\"Double click to select all\"><code class=\"language-markdown\" id=\"result-code\">| Field                | Type   | Required | Description                                                                                                                                                   |\n|----------------------|--------|----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| catalog<span class=\"token property\">_url_<\/span>download | String | yes      | Public url from which the catalog products can be downloaded.                                                                                                 |\n| catalog_format       | string | no       | Format in which the catalog products are stored in the previous url. Allowed values are: \"<a href=\"https:\/\/github.com\/Impresee\/public-documentation\/wiki\/How-to-create-a-catalog-(english)\" title=\"xml_impresee_20\">xml<span class=\"token property\">_impresee_<\/span>20<\/a>\" (default), \"<a href=\"https:\/\/github.com\/Impresee\/public-documentation\/wiki\/How-to-create-a-catalog-csv-(english)\" title=\"csv_impresee_10\">csv<span class=\"token property\">_impresee_<\/span>10<\/a>\" ,  \"json<span class=\"token property\">_impresee_<\/span>20\" |\n| downloader_code      | string | no       | Catalog download algorithm, allowed values are: \"download_url\" (default), \"samurai_paged\"                                                                     |\n| catalog_market       | string | no       | Types of products in the catalog, the allowed values are \"HOMEDECO\" (default), \"CLOTHES\", \"ALL\", \"OTHER\".                                                     |<\/code><\/pre>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<p>The server will return status 200 with the following json:<\/p>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<pre class=\"line-numbers  language-markdown\" title=\"Double click to select all\"><code class=\"language-markdown\" id=\"result-code\">| Field         | Type   | Description                                                                                                 |\n|---------------|--------|-------------------------------------------------------------------------------------------------------------|\n| status        | int    | 0: success, 1: error                                                                                        |\n| error_message | String | If status=1, a message with the error description                                                           |\n| snippet_url   | String | Url with the javascript code that must be inserted in the html header of the store, to use the search tools |<\/code><\/pre>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<p>It is important that the url of the snippet can change when there is a modification in the snippet configuration, so it should be possible to add and remove this url from the store html.<\/p>\n<p>[\/et_pb_text][\/et_pb_column][\/et_pb_row][et_pb_row _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;][et_pb_column type=&#8221;4_4&#8243; _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;][et_pb_text module_id=&#8221;register_snippet_webhook&#8221; _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<h2>Register the snippet webhook<\/h2>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<p>As mentioned above, every time a change is made to the integration settings (for example search by photo is disabled), a new snippet (javascript file) with the current configuration is generated and stored in our servers. When this new javascript file is generated, our system calls a webhook, which must be implemented to remove the previous javascript code and add the new code to the store html header.\u00a0<\/p>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<p>To register the webhook to call the following url is used:<\/p>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<p><span style=\"color: #999999;\"><em>POST<br \/><\/em><\/span><span style=\"color: #999999;\"><em>https:\/\/api.impresee.com\/ImpreseeAdmin\/api\/integrators\/v1\/register_snippet_webhook\/{integrator-api-key}\/{store-key}<\/em><\/span><\/p>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<p>The above request corresponds to a POST, where the catalog data is sent through a json in the body, below is an example of a valid json.<\/p>\n<p>[\/et_pb_text][et_pb_code _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<script src=\"https:\/\/gist.github.com\/anibal-fuentes-impresee\/495f787da3dfc0690e5aace52406ad3b.js\"><\/script>[\/et_pb_code][et_pb_text _builder_version=&#8221;4.9.3&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<p>The description of each parameter is documented below:<\/p>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<pre class=\"line-numbers  language-markdown\" title=\"Double click to select all\"><code class=\"language-markdown\" id=\"result-code\">| Field          | Type   | Required | Description                                                                                                             |\n|----------------|--------|----------|-------------------------------------------------------------------------------------------------------------------------|\n| webhook_url    | String | yes      | Url to be called to register a new snippet for the store. For security reasons, we recommend adding an uuid to this url |<\/code><\/pre>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<p>The server will return status 200 with the following json:<\/p>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<pre class=\"line-numbers  language-markdown\" title=\"Double click to select all\"><code class=\"language-markdown\" id=\"result-code\">| Field         | Type   | Description                                                                                                 |\n|---------------|--------|-------------------------------------------------------------------------------------------------------------|\n| status        | int    | 0: success, 1: error                                                                                        |\n| error_message | String | If status=1, a message with the error description                                                           |<\/code><\/pre>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<p>Once a webhook has been registered, it will be called every time there is a change in the browser configuration. This call will be a post request, with a field &#8220;snippet_url&#8221; containing the new snippet url. This url must be added to the store header, and the previous url must be removed.<\/p>\n<p>[\/et_pb_text][\/et_pb_column][\/et_pb_row][et_pb_row _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;][et_pb_column type=&#8221;4_4&#8243; _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;][et_pb_text module_id=&#8221;refresh_the_catalog&#8221; _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<h2>Refresh the catalog<\/h2>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<p>Once the catalog has been created and the webhook has been registered, the catalog must be refreshed. This process will download the catalog and process each product and its images so that they are available in the search engine. If it is the first time the catalog is refreshed, the download process will be slower, since each product must be processed.<\/p>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<p>The url to refresh the catalog is the following:<\/p>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<p><span style=\"color: #999999;\"><em>POST<br \/><\/em><\/span><span style=\"color: #999999;\"><em>https:\/\/api.impresee.com\/ImpreseeAdmin\/api\/integrators\/v1\/refresh_catalog\/{integrator-api-key}\/{store-key}<\/em><\/span><\/p>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<p>The above request corresponds to a POST, where the catalog data is sent through a json in the body, below is an example of a valid json.<\/p>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<p>The server will return status 200 with the following json:<\/p>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<pre class=\"line-numbers  language-markdown\" title=\"Double click to select all\"><code class=\"language-markdown\" id=\"result-code\">| Field         | Type   | Description                                                                                                 |\n|---------------|--------|-------------------------------------------------------------------------------------------------------------|\n| status        | int    | 0: success, 1: error                                                                                        |\n| error_message | String | If status=1, a message with the error description                                                           |<\/code><\/pre>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<p>Once a webhook has been registered, it will be called every time there is a change in the browser configuration. This call will be a post request, with a field &#8220;snippet_url&#8221; containing the new snippet url. This url must be added to the store header, and the previous url must be removed.<\/p>\n<p>[\/et_pb_text][\/et_pb_column][\/et_pb_row][et_pb_row _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;][et_pb_column type=&#8221;4_4&#8243; _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;][et_pb_text module_id=&#8221;register_conversion&#8221; _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<h2>Register conversion events<\/h2>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.3&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<p><span class=\"Y2IQFc\" lang=\"en\">Conversion events are triggered by purchases within a store. <span>These events contain information about the purchased products, the transaction itself and the user who performed the transaction. The URL to register a conversion event is the following:<\/span><\/span><\/p>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.3&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<p><span style=\"color: #999999;\"><em>POST<br \/><\/em><\/span><span style=\"color: #999999;\"><em>https:\/\/api.impresee.com\/ImpreseeAdmin\/api\/integrators\/v1\/conversion\/{integrator-api-key}\/{store-key}<\/em><\/span><\/p>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.3&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<p>The above request corresponds to a POST, where the event data is sent through a json in the body, below is an example of a valid json.<\/p>\n<p>[\/et_pb_text][et_pb_code _builder_version=&#8221;4.9.3&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<script src=\"https:\/\/gist.github.com\/anibal-fuentes-impresee\/57f9505713ba721c5167702c72c2c05d.js\"><\/script>[\/et_pb_code][et_pb_text _builder_version=&#8221;4.9.3&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<p>The description of each parameter is documented below:<\/p>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.3&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<pre class=\"line-numbers  language-markdown\" title=\"Double click to select all\"><code class=\"language-markdown\" id=\"result-code\">| Field                  | Type          | Required | Description                                                    |\n|------------------------|---------------|----------|----------------------------------------------------------------|\n| transaction_ip         | String        | yes      | ip of the customer who made a purchase                         |\n| transaction<span class=\"token property\">_user_<\/span>agent | String        | yes      | user agent of the customer                                     |\n| transaction_id         | String        | no       | unique id of the transaction, to avoid duplicate transactions  |\n| currency               | String        | no       | three-letter ISO currency code. Example: \u201cusd\u201d, \u201cclp\u201d          |\n| total                  | float         | no       | total amount of the transaction, measured in the currency unit |\n| discount               | float         | no       | transaction discount, measured in the currency unit            |\n| shipping_cost          | float         | no       | transaction discount measured in the currency unit             |\n| user                   | <a href=\"#user\">User<\/a>          | no       | user data                                                      |\n| products               | <a href=\"#product\">Product<\/a> array | yes      | products purchased in the transaction                          |<\/code><\/pre>\n<p>[\/et_pb_text][et_pb_text module_id=&#8221;user&#8221; _builder_version=&#8221;4.9.3&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<h4>User<\/h4>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.3&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<pre class=\"line-numbers  language-markdown\" title=\"Double click to select all\"><code class=\"language-markdown\" id=\"result-code\">| Field   | Type   | Required | Description               |\n|---------|--------|----------|---------------------------|\n| id      | String | no       | unique id of the customer |\n| name    | String | no       | customer name             |\n| email   | String | no       | customer email            |\n| phone   | String | no       | customer phone            |\n| address | String | no       | customer address          |\n| city    | String | no       | customer city             |\n| country | String | no       | customer country          |<\/code><\/pre>\n<p>[\/et_pb_text][et_pb_text module_id=&#8221;product&#8221; _builder_version=&#8221;4.9.3&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<h4>Product<\/h4>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.3&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<pre class=\"line-numbers  language-markdown\" title=\"Double click to select all\"><code class=\"language-markdown\" id=\"result-code\">| Field    | Type   | Required | Description                  |\n|----------|--------|----------|------------------------------|\n| id       | String | yes      | unique id of the product     |\n| price    | String | yes      | product price                |\n| quantity | String | yes      | number of products purchased |\n| sku      | String | no       | product sku                  |\n| name     | String | no       | product name                 |\n| category | String | no       | product category name        |<\/code><\/pre>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<p>The server will return status 200 with the following json:<\/p>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<pre class=\"line-numbers  language-markdown\" title=\"Double click to select all\"><code class=\"language-markdown\" id=\"result-code\">| Field         | Type   | Description                                                   |\n|---------------|--------|---------------------------------------------------------------|\n| status        | int    | 0: success, 1: error                                          |\n| error_message | String | If status=1, a message with the error description             |<\/code><\/pre>\n<p>[\/et_pb_text][\/et_pb_column][\/et_pb_row][et_pb_row _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;][et_pb_column type=&#8221;4_4&#8243; _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;][et_pb_text module_id=&#8221;signup_into_the_impresee_console&#8221; _builder_version=&#8221;4.10.7&#8243; _module_preset=&#8221;default&#8221; hover_enabled=&#8221;0&#8243; global_colors_info=&#8221;{}&#8221; sticky_enabled=&#8221;0&#8243;]<\/p>\n<h2>Login into the Impresee Console<\/h2>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.10.7&#8243; _module_preset=&#8221;default&#8221; hover_enabled=&#8221;0&#8243; global_colors_info=&#8221;{}&#8221; sticky_enabled=&#8221;0&#8243;]<\/p>\n<p>In order for store owners to see their search metrics, configure their tool, and sign up for a plan, they need to sign up in the Impresee Console. For this, we let the following api available, which returns a url with a login token, with which the store owner can login directly into our system.<\/p>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.10.7&#8243; _module_preset=&#8221;default&#8221; hover_enabled=&#8221;0&#8243; global_colors_info=&#8221;{}&#8221; sticky_enabled=&#8221;0&#8243;]<\/p>\n<p>The url to request a login token is the following:<\/p>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<p><span style=\"color: #999999;\"><em>POST<br \/><\/em><\/span><span style=\"color: #999999;\"><em>https:\/\/api.impresee.com\/ImpreseeAdmin\/api\/integrators\/v1\/store_signup_request\/{integrator-api-key}\/{store-key}<\/em><\/span><\/p>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<p>The above request corresponds to a POST. In addition, for security reasons you must send certain information about the user who is requesting the token:<\/p>\n<p>[\/et_pb_text][et_pb_code _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<script src=\"https:\/\/gist.github.com\/anibal-fuentes-impresee\/b5124252b6e7a15b6ef7e3eba7a59d9d.js\"><\/script>[\/et_pb_code][et_pb_text _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<p>Each parameter is described below<\/p>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.10.7&#8243; _module_preset=&#8221;default&#8221; hover_enabled=&#8221;0&#8243; global_colors_info=&#8221;{}&#8221; sticky_enabled=&#8221;0&#8243;]<\/p>\n<pre class=\"line-numbers  language-markdown\" title=\"Double click to select all\"><code class=\"language-markdown\" id=\"result-code\">| Field       | Type   | Required | Description                                                  |\n|-------------|--------|----------|--------------------------------------------------------------|\n| user_agent  | String | no       | user agent of the store owner who requested the signup token |\n| remote_ip   | string | yes      | ip of the store owner who requested the signup token         |<\/code><\/pre>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<p>The server will return status 200 with the following json:<\/p>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.10.7&#8243; _module_preset=&#8221;default&#8221; hover_enabled=&#8221;0&#8243; global_colors_info=&#8221;{}&#8221; sticky_enabled=&#8221;0&#8243;]<\/p>\n<pre class=\"line-numbers  language-markdown\" title=\"Double click to select all\"><code class=\"language-markdown\" id=\"result-code\">| Field         | Type   | Description                                                   |\n|---------------|--------|---------------------------------------------------------------|\n| status        | int    | 0: success, 1: error                                          |\n| error_message | String | If status=1, a message with the error description             |\n| url           | String | Url with the token, with which the store owner must log in    |<\/code><\/pre>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.10.7&#8243; _module_preset=&#8221;default&#8221; hover_enabled=&#8221;0&#8243; global_colors_info=&#8221;{}&#8221; sticky_enabled=&#8221;0&#8243;]<\/p>\n<p>Once this url is generated, it can be put into an &lt;a href=&quot;{url}&quot;&gt; element inside the store owner admin page.<\/p>\n<p>[\/et_pb_text][\/et_pb_column][\/et_pb_row][et_pb_row _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;][et_pb_column type=&#8221;4_4&#8243; _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;][et_pb_text module_id=&#8221;delete_store&#8221; _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<h2>Delete a store<\/h2>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<p>If a user decides to uninstall Impresee in his store, the script tag should be removed from the header of his page, and the following service must be called:<\/p>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<p><span style=\"color: #999999;\"><em>POST<br \/><\/em><\/span><span style=\"color: #999999;\"><em>https:\/\/api.impresee.com\/ImpreseeAdmin\/api\/integrators\/v1\/delete_store\/{integrator-api-key}\/{store-key}<\/em><\/span><\/p>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<p>The server will return status 200 with the following json:<\/p>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.9.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<pre class=\"line-numbers  language-markdown\" title=\"Double click to select all\"><code class=\"language-markdown\" id=\"result-code\">| Field         | Type   | Description                                                   |\n|---------------|--------|---------------------------------------------------------------|\n| status        | int    | 0: success, 1: error                                          |\n| error_message | String | If status=1, a message with the error description             |<\/code><\/pre>\n<p>[\/et_pb_text][\/et_pb_column][\/et_pb_row][\/et_pb_section]<\/p>","protected":false},"excerpt":{"rendered":"<p>Impresee API for platform integratorsThis document describes how you can integrate Impresee&#8217;s services into any e-commerce platform.\u00a0BasicsImpresee has released different services to allow the integration of our search engine into any e-commerce platform, and also to enable the creation of individual instances of the search engine for every different store. To access these services it [&hellip;]<\/p>","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_et_pb_use_builder":"on","_et_pb_old_content":"","_et_gb_content_width":"","footnotes":""},"class_list":["post-8775","page","type-page","status-publish","hentry"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v24.1 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Services for Integrators &#8211; Impresee: Search bar and navigation solutions for eCommerce<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/impresee.com\/es\/services-for-integrators\/\" \/>\n<meta property=\"og:locale\" content=\"es_ES\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Services for Integrators &#8211; Impresee: Search bar and navigation solutions for eCommerce\" \/>\n<meta property=\"og:description\" content=\"Impresee API for platform integratorsThis document describes how you can integrate Impresee&#039;s services into any e-commerce platform.\u00a0BasicsImpresee has released different services to allow the integration of our search engine into any e-commerce platform, and also to enable the creation of individual instances of the search engine for every different store. To access these services it [&hellip;]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/impresee.com\/es\/services-for-integrators\/\" \/>\n<meta property=\"og:site_name\" content=\"Impresee: Search bar and navigation solutions for eCommerce\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/impresee\/\" \/>\n<meta property=\"article:modified_time\" content=\"2021-09-29T15:16:23+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/impresee.com\/wp-content\/uploads\/2019\/01\/favicon-1.png\" \/>\n\t<meta property=\"og:image:width\" content=\"200\" \/>\n\t<meta property=\"og:image:height\" content=\"200\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:site\" content=\"@impresee\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/impresee.com\/services-for-integrators\/\",\"url\":\"https:\/\/impresee.com\/services-for-integrators\/\",\"name\":\"Services for Integrators &#8211; Impresee: Search bar and navigation solutions for eCommerce\",\"isPartOf\":{\"@id\":\"https:\/\/impresee.com\/#website\"},\"datePublished\":\"2021-04-26T22:09:01+00:00\",\"dateModified\":\"2021-09-29T15:16:23+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/impresee.com\/services-for-integrators\/#breadcrumb\"},\"inLanguage\":\"es-CL\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/impresee.com\/services-for-integrators\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/impresee.com\/services-for-integrators\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/impresee.com\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Services for Integrators\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/impresee.com\/#website\",\"url\":\"https:\/\/impresee.com\/\",\"name\":\"Impresee\",\"description\":\"AI search bar, filters and discount games for eCommerce to get more visitors, increase conversion and get repeat sales. Available for Shopify, Woocomerce, Magento and others\",\"publisher\":{\"@id\":\"https:\/\/impresee.com\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/impresee.com\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"es-CL\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/impresee.com\/#organization\",\"name\":\"Impresee\",\"url\":\"https:\/\/impresee.com\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"es-CL\",\"@id\":\"https:\/\/impresee.com\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/impresee.com\/wp-content\/uploads\/2019\/01\/logo_color_negro_sf_web-e1547827174322.png\",\"contentUrl\":\"https:\/\/impresee.com\/wp-content\/uploads\/2019\/01\/logo_color_negro_sf_web-e1547827174322.png\",\"width\":400,\"height\":152,\"caption\":\"Impresee\"},\"image\":{\"@id\":\"https:\/\/impresee.com\/#\/schema\/logo\/image\/\"},\"sameAs\":[\"https:\/\/www.facebook.com\/impresee\/\",\"https:\/\/x.com\/impresee\",\"https:\/\/www.instagram.com\/impresee.ai\/\",\"https:\/\/www.linkedin.com\/company\/impresee\",\"https:\/\/www.youtube.com\/channel\/UC5ZniKfJGvG8t4GrOOgYczA\"]}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Services for Integrators &#8211; Impresee: Search bar and navigation solutions for eCommerce","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/impresee.com\/es\/services-for-integrators\/","og_locale":"es_ES","og_type":"article","og_title":"Services for Integrators &#8211; Impresee: Search bar and navigation solutions for eCommerce","og_description":"Impresee API for platform integratorsThis document describes how you can integrate Impresee's services into any e-commerce platform.\u00a0BasicsImpresee has released different services to allow the integration of our search engine into any e-commerce platform, and also to enable the creation of individual instances of the search engine for every different store. To access these services it [&hellip;]","og_url":"https:\/\/impresee.com\/es\/services-for-integrators\/","og_site_name":"Impresee: Search bar and navigation solutions for eCommerce","article_publisher":"https:\/\/www.facebook.com\/impresee\/","article_modified_time":"2021-09-29T15:16:23+00:00","og_image":[{"width":200,"height":200,"url":"https:\/\/impresee.com\/wp-content\/uploads\/2019\/01\/favicon-1.png","type":"image\/png"}],"twitter_card":"summary_large_image","twitter_site":"@impresee","schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/impresee.com\/services-for-integrators\/","url":"https:\/\/impresee.com\/services-for-integrators\/","name":"Services for Integrators &#8211; Impresee: Search bar and navigation solutions for eCommerce","isPartOf":{"@id":"https:\/\/impresee.com\/#website"},"datePublished":"2021-04-26T22:09:01+00:00","dateModified":"2021-09-29T15:16:23+00:00","breadcrumb":{"@id":"https:\/\/impresee.com\/services-for-integrators\/#breadcrumb"},"inLanguage":"es-CL","potentialAction":[{"@type":"ReadAction","target":["https:\/\/impresee.com\/services-for-integrators\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/impresee.com\/services-for-integrators\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/impresee.com\/"},{"@type":"ListItem","position":2,"name":"Services for Integrators"}]},{"@type":"WebSite","@id":"https:\/\/impresee.com\/#website","url":"https:\/\/impresee.com\/","name":"Impresee","description":"AI search bar, filters and discount games for eCommerce to get more visitors, increase conversion and get repeat sales. Available for Shopify, Woocomerce, Magento and others","publisher":{"@id":"https:\/\/impresee.com\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/impresee.com\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"es-CL"},{"@type":"Organization","@id":"https:\/\/impresee.com\/#organization","name":"Impresee","url":"https:\/\/impresee.com\/","logo":{"@type":"ImageObject","inLanguage":"es-CL","@id":"https:\/\/impresee.com\/#\/schema\/logo\/image\/","url":"https:\/\/impresee.com\/wp-content\/uploads\/2019\/01\/logo_color_negro_sf_web-e1547827174322.png","contentUrl":"https:\/\/impresee.com\/wp-content\/uploads\/2019\/01\/logo_color_negro_sf_web-e1547827174322.png","width":400,"height":152,"caption":"Impresee"},"image":{"@id":"https:\/\/impresee.com\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.facebook.com\/impresee\/","https:\/\/x.com\/impresee","https:\/\/www.instagram.com\/impresee.ai\/","https:\/\/www.linkedin.com\/company\/impresee","https:\/\/www.youtube.com\/channel\/UC5ZniKfJGvG8t4GrOOgYczA"]}]}},"_links":{"self":[{"href":"https:\/\/impresee.com\/es\/wp-json\/wp\/v2\/pages\/8775","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/impresee.com\/es\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/impresee.com\/es\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/impresee.com\/es\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/impresee.com\/es\/wp-json\/wp\/v2\/comments?post=8775"}],"version-history":[{"count":39,"href":"https:\/\/impresee.com\/es\/wp-json\/wp\/v2\/pages\/8775\/revisions"}],"predecessor-version":[{"id":9932,"href":"https:\/\/impresee.com\/es\/wp-json\/wp\/v2\/pages\/8775\/revisions\/9932"}],"wp:attachment":[{"href":"https:\/\/impresee.com\/es\/wp-json\/wp\/v2\/media?parent=8775"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}