{"info":{"_postman_id":"da96198e-d68b-4fca-a838-972f3ec0de29","name":"API Zoom&Buscapé Comparador","description":"

A API REST fornece uma opção de integração entre os lojistas e o Zoom&Buscapé. Através dela, os lojistas podem adicionar, remover, alterar e buscar produtos do seu portfólio que estão no Zoom&Buscapé.

O ambiente utilizado de produção na url é https://merchant.zoom.com.br/api/merchant

\n\n

A API do Zoom&Buscapé usa BASIC Authentication com usuário e senha (Chaves API's), que são disponibilizados pela equipe de integração do Zoom&Buscapé.

\n

Contact Support:

\n

Name: Integracao

\n

Email: integracao@zoom.com.br

\n \n\n

Requisições

\n

Nosso API tem limite no tamanho de cada requisição, a mesma não pode passar de 2MB. Caso contrário, irá aparecer mensagem de erro.\nPara solucionar este problema, recomenda-se separar a requisição em partes de 1.5MB cada.

\n
<title>413 Request Entity Too Large</title>\n<center>nginx</center>\n
\n

É importante ressaltar que temos vários servidores atendendo às requisições. Portanto, dependendo de como as mensagens sejam enviadas, a garantia de ordem cronológica da chegada das requisições pode ser comprometida pelo seguinte motivo.

\n

Caso seja enviado alterações de preço de um mesmo produto, possivelmente represadas e enviadas num intervalo de 20 segundos por exemplo, essas mensagens em geral serão atendidas por servidores diferentes, e tratadas num processo posterior por ordem cronológica de chegada.

\n

Como temos uma janela de cerca de 30 segundos para agrupamento e processamento das mensagens recebidas, não seria aconselhável enviar atualizações de um mesmo produto por requests diferentes em um intervalo de tempo tão curto, podendo causando uma situação de race condition entre os servidores, comprometendo o resultado final da atualização, principalmente em casos de informações sensíveis como o preço, estoque e disponibilidade do produto.

\n

Portanto, recomendamos que alterações de dos produtos sejam feitas em intervalos mínimos de 30 segundos.

\n

Nossa API é assíncrona, response será de um ticket e pode-se verificar o resultado do ticket no Endpoint (api/merchant/receipt/ticketid). Nesse ambiente a loja irá performar normalmente, uma vez que estiver ativa.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"4582221","collectionId":"da96198e-d68b-4fca-a838-972f3ec0de29","publishedId":"SWTK3tt8","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EF5B25"},"publishDate":"2020-02-10T16:50:00.000Z"},"item":[{"name":"product","item":[{"name":"Insere ou atualiza todos os dados de um produto","id":"76a34962-5174-451c-9aab-0e45be73fc54","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":""},{"key":"password","value":""}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"department\": \"\",\n \"id\": \"\",\n \"name\": \"\",\n \"price\": \"\",\n \"sub_department\": \"\",\n \"url\": \"\",\n \"url_images\": [\n {\n \"url\": \"\",\n \"main\": \"\"\n },\n {\n \"url\": \"\",\n \"main\": \"\"\n }\n ],\n \"attributes\": [\n {\n \"name\": \"\",\n \"value\": \"\"\n },\n {\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"availability\": \"\",\n \"condition\": \"\",\n \"cross_border\": \"\",\n \"base_price\": \"\",\n \"book\": {\n \"author\": \"\",\n \"genre\": \"\",\n \"isbn\": \"\",\n \"publisher\": \"\"\n },\n \"description\": \"\",\n \"ean\": \"\",\n \"free_shipping\": \"\",\n \"installments\": {\n \"amount_months\": \"\",\n \"price\": \"\"\n },\n \"quantity\": \"\",\n \"seller_info\": {\n \"type\": \"\",\n \"name\": \"\"\n },\n \"sku\": \"\",\n \"specifications\": \"\",\n \"stock_info\": {\n \"height\": \"\",\n \"length\": \"\",\n \"weight\": \"\",\n \"width\": \"\",\n \"cross_docking\": \"\"\n }\n}"},"url":"http://merchant.zoom.com.br/api/merchant/product","description":"

Este serviço permite que os lojistas insiram ou atualizem os dados de um produto por vez no Zoom&Buscapé.

Embora o serviço tenha sido executado com sucesso, a criação/atualização pode não ser realizada imediatamente já que o seu processamento é assíncrono.

Para consultar o andamento e resultado da criação/atualização, é necessário utilizar os endpoints de receipt com o número de ticket retornado.

\n\n
    \n
  • Seller_info.type é para informar se a oferta é da própria loja ou se a oferta é de terceiros, possíveis eventos são 1P (ofertas próprias) e 3P (ofertas de marketplace).
    • \n
  • Seller_info.name Nome do vendedor real do produto. Obrigatório caso o tipo de vendedor seja 3P
    • \n
\n

Para o campo condition são aceitos os seguintes valores:

\n
    \n
  • NEW
    • \n
  • USED
    • \n
  • REFURBISHED
    • \n
  • DAMAGED
    • \n
\n","urlObject":{"path":["product"],"host":["http://merchant.zoom.com.br/api/merchant"],"query":[],"variable":[]}},"response":[{"id":"dee0470f-cda8-4f53-b265-f35b5ae0fbe0","name":"Response com ticket id","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"department\": \"\",\n \"id\": \"\",\n \"name\": \"\",\n \"price\": \"\",\n \"sub_department\": \"\",\n \"url\": \"\",\n \"url_images\": [\n {\n \"url\": \"\",\n \"main\": \"\"\n },\n {\n \"url\": \"\",\n \"main\": \"\"\n }\n ],\n \"attributes\": [\n {\n \"name\": \"\",\n \"value\": \"\"\n },\n {\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"availability\": \"\",\n \"base_price\": \"\",\n \"book\": {\n \"author\": \"\",\n \"genre\": \"\",\n \"isbn\": \"\",\n \"publisher\": \"\"\n },\n \"description\": \"\",\n \"ean\": \"\",\n \"free_shipping\": \"\",\n \"installments\": {\n \"amount_months\": \"\",\n \"price\": \"\"\n },\n \"quantity\": \"\",\n \"seller_info\": {\n \"type\": \"\",\n \"name\": \"\"\n },\n \"sku\": \"\",\n \"specifications\": \"\",\n \"stock_info\": {\n \"height\": \"\",\n \"length\": \"\",\n \"weight\": \"\",\n \"width\": \"\",\n \"cross_docking\": \"\"\n }\n}"},"url":"http://merchant.zoom.com.br/api/merchant/product"},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"product_id\": \"IdProduto\",\n \"status\": 200,\n \"message\": \"Em Processamento\",\n \"ticket\": \"eb68490c-49d8-49c2-96d1-9edf66e34649\"\n}"}],"_postman_id":"76a34962-5174-451c-9aab-0e45be73fc54"},{"name":"Remove um produto","id":"3e8e4ea2-0ecb-47f7-a859-e8d302d535c6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"DELETE","header":[],"url":"http://merchant.zoom.com.br/api/merchant/product/:id","description":"

Este serviço permite que os lojistas removam um produto de cada vez do seu portfólio ativo dentro do Zoom&Buscapé.

É importante ressaltar que \"remover\" significa desabilitar o produto.

Embora o serviço tenha sido executado com sucesso, a remoção pode não ser realizada imediatamente já que o seu processamento é assíncrono.

Para consultar o andamento e resultado da remoção, é necessário utilizar os endpoints de receipt com o número de ticket retornado.

","urlObject":{"path":["product",":id"],"host":["http://merchant.zoom.com.br/api/merchant"],"query":[],"variable":[{"id":"a290bf11-c63f-4b4a-8455-3137626902af","description":{"content":"

Id do produto

\n","type":"text/plain"},"type":"string","value":"","key":"id"}]}},"response":[{"id":"67c5970c-6ba1-4d5f-8d44-e8024ae23fb8","name":"Response com ticket id","originalRequest":{"method":"DELETE","header":[],"url":{"raw":"http://merchant.zoom.com.br/api/merchant/product/:id","host":["http://merchant.zoom.com.br/api/merchant"],"path":["product",":id"],"variable":[{"id":"a290bf11-c63f-4b4a-8455-3137626902af","key":"id","value":"","type":"string","description":{"content":"Id do produto","type":"text/plain"}}]}},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"product_id\": \"IdProduto\",\n \"status\": 200,\n \"message\": \"Em Processamento\",\n \"ticket\": \"eb68490c-49d8-49c2-96d1-9edf66e34649\"\n}"}],"_postman_id":"3e8e4ea2-0ecb-47f7-a859-e8d302d535c6"},{"name":"Atualiza disponibilidade, preço e parcelamento de um produto","id":"9c86dc45-7f8d-454e-b7c4-7c9114dd39d1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"PUT","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"availability\": \"\",\n \"id\": \"\",\n \"cross_docking\": \"\",\n \"condition\": \"\",\n \"cross_border\": \"\",\n \"installments\": {\n \"amount_months\": \"\",\n \"price\": \"\"\n },\n \"price\": \"\",\n \"quantity\": \"\",\n \"url\": \"\"\n}"},"url":"http://merchant.zoom.com.br/api/merchant/product","description":"

Este serviço permite que os lojistas atualizem a disponibilidade, preço e parcelamento de um de seus produtos no Zoom&Buscapé. Caso o lojista esteja desabilitando (removendo) um produto, ele não poderá alterar o preço e o parcelamento do mesmo.

Embora o serviço tenha sido executado com sucesso, a atualização pode não ser realizada imediatamente já que o seu processamento é assíncrono.

Para consultar o andamento e resultado da atualização, é necessário utilizar os endpoints de receipt com o número de ticket retornado.

\n\n

Para o campo condition são aceitos os seguintes valores:

\n
    \n
  • NEW
    • \n
  • USED
    • \n
  • REFURBISHED
    • \n
  • DAMAGED
    • \n
\n","urlObject":{"path":["product"],"host":["http://merchant.zoom.com.br/api/merchant"],"query":[],"variable":[]}},"response":[{"id":"6f0472f1-1260-4643-9475-605f1a7a4e92","name":"Response com ticket id","originalRequest":{"method":"PUT","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"availability\": \"\",\n \"id\": \"\",\n \"cross_docking\": \"\",\n \"installments\": {\n \"amount_months\": \"\",\n \"price\": \"\"\n },\n \"price\": \"\",\n \"quantity\": \"\",\n \"url\": \"\"\n}"},"url":"http://merchant.zoom.com.br/api/merchant/product"},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"product_id\": \"IdProduto\",\n \"status\": 200,\n \"message\": \"Em Processamento\",\n \"ticket\": \"eb68490c-49d8-49c2-96d1-9edf66e34649\"\n}"}],"_postman_id":"9c86dc45-7f8d-454e-b7c4-7c9114dd39d1"}],"id":"d189d835-d070-41ea-9923-6a6fbc24b720","event":[{"listen":"prerequest","script":{"id":"f1050a41-0ae3-4aad-9dad-3908bd9bd949","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"6bbaa4b4-1717-4b39-a98a-8c6593c55226","type":"text/javascript","exec":[""]}}],"_postman_id":"d189d835-d070-41ea-9923-6a6fbc24b720","description":"","auth":{"type":"basic","basic":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"da96198e-d68b-4fca-a838-972f3ec0de29","id":"da96198e-d68b-4fca-a838-972f3ec0de29","name":"API Zoom&Buscapé Comparador","type":"collection"}}},{"name":"products","item":[{"name":"Insere ou atualiza todos os dados de produtos em lotes","id":"6ab05b65-8430-4d60-9932-ef00c6afccfa","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"products\": [\n {\n \"department\": \"\",\n \"id\": \"\",\n \"name\": \"\",\n \"price\": \"\",\n \"sub_department\": \"\",\n \"url\": \"\",\n \"url_images\": [\n {\n \"url\": \"\",\n \"main\": \"\"\n },\n {\n \"url\": \"\",\n \"main\": \"\"\n }\n ],\n \"attributes\": [\n {\n \"name\": \"\",\n \"value\": \"\"\n },\n {\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"availability\": \"\",\n \"condition\": \"\",\n \"cross_border\": \"\",\n \"base_price\": \"\",\n \"book\": {\n \"author\": \"\",\n \"genre\": \"\",\n \"isbn\": \"\",\n \"publisher\": \"\"\n },\n \"description\": \"\",\n \"ean\": \"\",\n \"free_shipping\": \"\",\n \"installments\": {\n \"amount_months\": \"\",\n \"price\": \"\"\n },\n \"quantity\": \"\",\n \"seller_info\": {\n \"type\": \"\",\n \"name\": \"\"\n },\n \"sku\": \"\",\n \"specifications\": \"\",\n \"stock_info\": {\n \"height\": \"\",\n \"length\": \"\",\n \"weight\": \"\",\n \"width\": \"\",\n \"cross_docking\": \"\"\n }\n },\n {\n \"department\": \"\",\n \"id\": \"\",\n \"name\": \"\",\n \"price\": \"\",\n \"sub_department\": \"\",\n \"url\": \"\",\n \"url_images\": [\n {\n \"url\": \"\",\n \"main\": \"\"\n },\n {\n \"url\": \"\",\n \"main\": \"\"\n }\n ],\n \"attributes\": [\n {\n \"name\": \"\",\n \"value\": \"\"\n },\n {\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"availability\": \"\",\n \"base_price\": \"\",\n \"book\": {\n \"author\": \"\",\n \"genre\": \"\",\n \"isbn\": \"\",\n \"publisher\": \"\"\n },\n \"description\": \"\",\n \"ean\": \"\",\n \"free_shipping\": \"\",\n \"installments\": {\n \"amount_months\": \"\",\n \"price\": \"\"\n },\n \"quantity\": \"\",\n \"seller_info\": {\n \"type\": \"\",\n \"name\": \"\"\n },\n \"sku\": \"\",\n \"specifications\": \"\",\n \"stock_info\": {\n \"height\": \"\",\n \"length\": \"\",\n \"weight\": \"\",\n \"width\": \"\",\n \"cross_docking\": \"\"\n }\n }\n ]\n}"},"url":"http://merchant.zoom.com.br/api/merchant/products","description":"

Este serviço permite que os lojistas insiram ou atualizem os dados de seus produtos em lotes de até 1000 no Zoom&Buscapé.

Embora o serviço tenha sido executado com sucesso, as criações/atualizações podem não ser realizadas imediatamente já que o seu processamento é assíncrono.

Para consultar o andamento e resultado das criações/atualizações, é necessário utilizar os endpoints de receipt com o número de ticket retornado.

O serviço irá retornar uma lista de resultados, onde cada elemento dessa lista representa o resultado do registro da requisição para cada produto passado no lote.

\n\n

Para o campo condition são aceitos os seguintes valores:

\n
    \n
  • NEW
    • \n
  • USED
    • \n
  • REFURBISHED
    • \n
  • DAMAGED
    • \n
\n","urlObject":{"path":["products"],"host":["http://merchant.zoom.com.br/api/merchant"],"query":[],"variable":[]}},"response":[{"id":"0163af17-a536-47e1-8a51-d176a4678283","name":"Response com ticket id","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"products\": [\n {\n \"department\": \"\",\n \"id\": \"\",\n \"name\": \"\",\n \"price\": \"\",\n \"sub_department\": \"\",\n \"url\": \"\",\n \"url_images\": [\n {\n \"url\": \"\",\n \"main\": \"\"\n },\n {\n \"url\": \"\",\n \"main\": \"\"\n }\n ],\n \"attributes\": [\n {\n \"name\": \"\",\n \"value\": \"\"\n },\n {\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"availability\": \"\",\n \"base_price\": \"\",\n \"book\": {\n \"author\": \"\",\n \"genre\": \"\",\n \"isbn\": \"\",\n \"publisher\": \"\"\n },\n \"description\": \"\",\n \"ean\": \"\",\n \"free_shipping\": \"\",\n \"installments\": {\n \"amount_months\": \"\",\n \"price\": \"\"\n },\n \"quantity\": \"\",\n \"seller_info\": {\n \"type\": \"\",\n \"name\": \"\"\n },\n \"sku\": \"\",\n \"specifications\": \"\",\n \"stock_info\": {\n \"height\": \"\",\n \"length\": \"\",\n \"weight\": \"\",\n \"width\": \"\",\n \"cross_docking\": \"\"\n }\n },\n {\n \"department\": \"\",\n \"id\": \"\",\n \"name\": \"\",\n \"price\": \"\",\n \"sub_department\": \"\",\n \"url\": \"\",\n \"url_images\": [\n {\n \"url\": \"\",\n \"main\": \"\"\n },\n {\n \"url\": \"\",\n \"main\": \"\"\n }\n ],\n \"attributes\": [\n {\n \"name\": \"\",\n \"value\": \"\"\n },\n {\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"availability\": \"\",\n \"base_price\": \"\",\n \"book\": {\n \"author\": \"\",\n \"genre\": \"\",\n \"isbn\": \"\",\n \"publisher\": \"\"\n },\n \"description\": \"\",\n \"ean\": \"\",\n \"free_shipping\": \"\",\n \"installments\": {\n \"amount_months\": \"\",\n \"price\": \"\"\n },\n \"quantity\": \"\",\n \"seller_info\": {\n \"type\": \"\",\n \"name\": \"\"\n },\n \"sku\": \"\",\n \"specifications\": \"\",\n \"stock_info\": {\n \"height\": \"\",\n \"length\": \"\",\n \"weight\": \"\",\n \"width\": \"\",\n \"cross_docking\": \"\"\n }\n }\n ]\n}"},"url":"http://merchant.zoom.com.br/api/merchant/products"},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"ticket\": \"625373e4-a917-4ad3-bc36-68608b243360\",\n \"results\": [\n {\n \"product_id\": \"productid1\",\n \"status\": 200,\n \"message\": \"Em processamento\"\n },\n {\n \"product_id\": \"productid2\",\n \"status\": 200,\n \"message\": \"Em processamento\"\n }\n ]\n}"}],"_postman_id":"6ab05b65-8430-4d60-9932-ef00c6afccfa"},{"name":"Atualiza a disponibilidade, preço e parcelamento de produtos em lotes","id":"e94647f3-eac8-48a0-ad74-1180662fef8f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"PUT","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"products\": [\n {\n \"availability\": \"\",\n \"id\": \"\",\n \"cross_docking\": \"\",\n \"installments\": {\n \"amount_months\": \"\",\n \"price\": \"\"\n },\n \"price\": \"\",\n \"quantity\": \"\",\n \"url\": \"\"\n },\n {\n \"availability\": \"\",\n \"condition\": \"\",\n \"cross_border\": \"\",\n \"id\": \"\",\n \"cross_docking\": \"\",\n \"installments\": {\n \"amount_months\": \"\",\n \"price\": \"\"\n },\n \"price\": \"\",\n \"quantity\": \"\",\n \"url\": \"\"\n }\n ]\n}"},"url":"http://merchant.zoom.com.br/api/merchant/products","description":"

Este serviço permite que os lojistas atualizem a disponibilidade, preço e parcelamento dos seus produtos em lotes de até 1000 no Zoom&Buscapé.

Embora o serviço tenha sido executado com sucesso, as atualizações podem não ser realizadas imediatamente já que o seu processamento é assíncrono.

Para consultar o andamento e resultado das atualizações, é necessário utilizar os endpoints de receipt com o número de ticket retornado.

O serviço irá retornar uma lista de resultados, onde cada elemento dessa lista representa o resultado do registro da requisição para cada produto passado no lote.

\n\n

Para o campo condition são aceitos os seguintes valores:

\n
    \n
  • NEW
    • \n
  • USED
    • \n
  • REFURBISHED
    • \n
  • DAMAGED
    • \n
\n","urlObject":{"path":["products"],"host":["http://merchant.zoom.com.br/api/merchant"],"query":[],"variable":[]}},"response":[{"id":"b91d1216-783c-4233-bcf4-760d42d163d0","name":"Response com ticket id","originalRequest":{"method":"PUT","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"products\": [\n {\n \"availability\": \"\",\n \"id\": \"\",\n \"cross_docking\": \"\",\n \"installments\": {\n \"amount_months\": \"\",\n \"price\": \"\"\n },\n \"price\": \"\",\n \"quantity\": \"\",\n \"url\": \"\"\n },\n {\n \"availability\": \"\",\n \"id\": \"\",\n \"cross_docking\": \"\",\n \"installments\": {\n \"amount_months\": \"\",\n \"price\": \"\"\n },\n \"price\": \"\",\n \"quantity\": \"\",\n \"url\": \"\"\n }\n ]\n}"},"url":"http://merchant.zoom.com.br/api/merchant/products"},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"ticket\": \"625373e4-a917-4ad3-bc36-68608b243360\",\n \"results\": [\n {\n \"product_id\": \"productid1\",\n \"status\": 200,\n \"message\": \"Em processamento\"\n },\n {\n \"product_id\": \"productid2\",\n \"status\": 200,\n \"message\": \"Em processamento\"\n }\n ]\n}"}],"_postman_id":"e94647f3-eac8-48a0-ad74-1180662fef8f"},{"name":"Remove produtos em lotes","id":"7429251c-b048-4246-9b00-db455bbb8b36","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"DELETE","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"products\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}"},"url":"http://merchant.zoom.com.br/api/merchant/products","description":"

Este serviço permite que os lojistas removam seus produtos em lotes de até 1000 no Zoom&Buscapé.

É importante ressaltar que \"remover\" significa desabilitar o produto.

Embora o serviço tenha sido executado com sucesso, as remoções podem não ser realizadas imediatamente já que o seu processamento é assíncrono.

Para consultar o andamento e resultado das remoções, é necessário utilizar os endpoints de receipt com o número de ticket retornado.

O serviço irá retornar uma lista de resultados, onde cada elemento dessa lista representa o resultado do registro da requisição para cada produto passado no lote.

","urlObject":{"path":["products"],"host":["http://merchant.zoom.com.br/api/merchant"],"query":[],"variable":[]}},"response":[{"id":"7168c97d-3feb-4f47-96a8-4da7a9babb76","name":"Response com ticket id","originalRequest":{"method":"DELETE","header":[],"body":{"mode":"raw","raw":"{\n \"products\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}"},"url":"http://merchant.zoom.com.br/api/merchant/products"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"text/plain"}],"cookie":[],"responseTime":null,"body":"{\n \"ticket\": \"625373e4-a917-4ad3-bc36-68608b243360\",\n \"results\": [\n {\n \"product_id\": \"productid1\",\n \"status\": 200,\n \"message\": \"Em processamento\"\n },\n {\n \"product_id\": \"productid2\",\n \"status\": 200,\n \"message\": \"Em processamento\"\n }\n ]\n}"}],"_postman_id":"7429251c-b048-4246-9b00-db455bbb8b36"},{"name":"Busca produtos sem atualização","id":"24cf8cd4-f830-4dfc-aebb-9234977a61bb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"http://merchant.zoom.com.br/api/merchant/products/untouched?days=1","description":"

Este serviço permite que os lojistas busquem os produtos, do seu portfólio, que não são atualizados a um determinado tempo.

O serviço possui uma restrição de aceitar somente uma chamada a cada 30 minutos.

","urlObject":{"path":["products","untouched"],"host":["http://merchant.zoom.com.br/api/merchant"],"query":[{"description":{"content":"

Número de dias sem atualização

\n","type":"text/plain"},"key":"days","value":"1"}],"variable":[]}},"response":[{"id":"acf5f473-fe99-47db-a4f7-78ffb061239f","name":"Response","originalRequest":{"method":"GET","header":[],"url":{"raw":"http://merchant.zoom.com.br/api/merchant/products/untouched?days=1","host":["http://merchant.zoom.com.br/api/merchant"],"path":["products","untouched"],"query":[{"key":"days","value":"1"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"*/*"}],"cookie":[],"responseTime":null,"body":"{\n \"products\": [\n {\n \"id\": \"produto1\"\n },\n {\n \"id\": \"produto2\"\n },\n {\n \"id\": \"produto3\"\n }\n ]\n}"}],"_postman_id":"24cf8cd4-f830-4dfc-aebb-9234977a61bb"}],"id":"f9e48a74-0191-4168-b4c1-6e742f851515","event":[{"listen":"prerequest","script":{"id":"793a4070-283b-48ea-ae27-3c245e94c760","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"f07f7e78-08d3-4fed-9f5d-379997432c82","type":"text/javascript","exec":[""]}}],"_postman_id":"f9e48a74-0191-4168-b4c1-6e742f851515","description":"","auth":{"type":"basic","basic":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"da96198e-d68b-4fca-a838-972f3ec0de29","id":"da96198e-d68b-4fca-a838-972f3ec0de29","name":"API Zoom&Buscapé Comparador","type":"collection"}}},{"name":"receipt","item":[{"name":"{date and hour}","item":[{"name":"Busca paginada por protocolos de atendimento.","id":"df2baa86-eeb2-402c-8a46-5cc22e77bc6a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"http://merchant.zoom.com.br/api/merchant/receipt/:date_and_hour","description":"

Busca a primeira página de informações sobre requisições de atualização de produto realizadas.

","urlObject":{"path":["receipt",":date_and_hour"],"host":["http://merchant.zoom.com.br/api/merchant"],"query":[],"variable":[{"id":"0e3a1451-9878-4fcb-afbc-fbbafdcc6b2f","description":{"content":"

Data e Hora

\n","type":"text/plain"},"type":"string","value":" formato yyyy-MM-dd","key":"date_and_hour"}]}},"response":[],"_postman_id":"df2baa86-eeb2-402c-8a46-5cc22e77bc6a"},{"name":"Avança busca paginada por protocolos de atendimento.","id":"86a25744-c534-40df-8ae1-3cb1e03714d1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"http://merchant.zoom.com.br/api/merchant/receipt/:date_and_hour/:next_page_id","description":"

Busca a próxima página de informações sobre requisições de atualização de produto realizadas.

Caso não existam mais páginas, uma lista vazia será retornada.

","urlObject":{"path":["receipt",":date_and_hour",":next_page_id"],"host":["http://merchant.zoom.com.br/api/merchant"],"query":[],"variable":[{"id":"09588f37-c368-4ed8-a764-6cda5a83e154","description":{"content":"

Data e Hora

\n","type":"text/plain"},"type":"string","value":" formato yyyy-MM-dd","key":"date_and_hour"},{"id":"1bf57391-2008-4b34-b892-39be9819a1d5","description":{"content":"

Identificador da consulta corrente

\n","type":"text/plain"},"type":"string","value":"","key":"next_page_id"}]}},"response":[{"id":"04e6b507-2353-46d7-b581-01f1e7b19304","name":"Ocorreu um erro interno inesperado","originalRequest":{"method":"GET","header":[],"url":{"raw":"http://merchant.zoom.com.br/api/merchant/receipt/:date_and_hour/:next_page_id","host":["http://merchant.zoom.com.br/api/merchant"],"path":["receipt",":date_and_hour",":next_page_id"],"variable":[{"key":"date_and_hour"},{"key":"next_page_id"}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"text/plain"}],"cookie":[],"responseTime":null,"body":""},{"id":"59e2c34e-54de-4719-8257-9e28301eb66a","name":"Protocolo(s) encontrado(s) com sucesso.","originalRequest":{"method":"GET","header":[],"url":{"raw":"http://merchant.zoom.com.br/api/merchant/receipt/:date_and_hour/:next_page_id","host":["http://merchant.zoom.com.br/api/merchant"],"path":["receipt",":date_and_hour",":next_page_id"],"variable":[{"key":"date_and_hour"},{"key":"next_page_id"}]}},"status":"OK","code":200,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"*/*"}],"cookie":[],"responseTime":null,"body":""}],"_postman_id":"86a25744-c534-40df-8ae1-3cb1e03714d1"}],"id":"9b53bc4a-e3e4-4976-ab43-2ace3eb363bf","_postman_id":"9b53bc4a-e3e4-4976-ab43-2ace3eb363bf","description":"","auth":{"type":"basic","basic":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"da96198e-d68b-4fca-a838-972f3ec0de29","id":"da96198e-d68b-4fca-a838-972f3ec0de29","name":"API Zoom&Buscapé Comparador","type":"collection"}}},{"name":"Obtem resultado por protocolo de atendimento.","id":"3b87e37e-f1f6-4cf0-9db4-937711392792","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"http://merchant.zoom.com.br/api/merchant/receipt/:ticket","description":"

Obtém as respostas de uma requisição de atualização de produto utilizando o protocolo de atendimento (ticket). Caso a requisição ainda não tenha sido totalmente processada, um resultado parcial será retornado.

A tabela a seguir detalha os status possíveis de cada tipo de requisição.

Insere ou atualiza todos os dados de um produto
200O produto foi atualizado com sucesso
201O produto foi inserido com sucesso
Atualiza disponibilidade, preço e parcelamento de um produto
200O produto foi atualizado/removido com sucesso
404Quando é fornecido um id de produto que está fora do portfólio ativo dentro do Zoom
Atualiza preço de um produto
200O produto foi atualizado com sucesso
403Quando um lojista não market place tenta acessa o serviço
404Quando é fornecido um id de produto que não existe no Zoom
Remove um produto
200O produto foi removido com sucesso
404Quando é fornecido um id de produto que está fora do portfólio ativo dentro do Zoom

Além destes, existe alguns status que podem ocorrer para qualquer um dos tipos de requisições. A tabela a seguir detalha esses status.

StatusDescrição
400Foram fornecidos dados inválidos, verificar o campo message para saber qual dado esta incorreto
409Devido a natureza assíncrona e concorrente do processamento das requisições, essa requisição foi descartada pois se tornou obsoleta já que já foi processada uma requisição que modifica os mesmos dados que esta e que foi enviada posteriormente

Mesmo quando o resultado buscado indicar que a operação realizada foi bem sucedida (status 200 ou 201), é possível que existam mensagens de aviso relacionadas a verificações internas do Zoom. A tabela a seguir detalha quais mensagens de aviso podem ser geradas.

MensagemDescrição
Alguns atributos foram descartados pois já haviam sido atualizados por uma requisição posteriorDevido a natureza assíncrona e concorrente do processamento das requisições, essa requisição foi modificada pois alguns campos se tornaram obsoletos já que já foi processada uma requisição que modifica esses mesmos campos e que foi enviada posteriormente
O produto está bloqueado pelo departamento comercialInternamente no Zoom, o departamento comercial pode bloquear um produto específico (por id) ou uma categoria da qual este produto faz parte
O produto foi bloqueado por mudança de preço excessivaPor motivos de segurança, quando ocorre, na opinião do Zoom, uma mudança excessiva de preço, o produto é bloqueado para que o departamento comercial verifique com a loja se realmente esse preço está correto
O produto foi bloqueado por mudança de nome excessivaPor motivos de segurança, quando ocorre, na opinião do Zoom, uma mudança excessiva de nome, o produto é bloqueado para que o departamento comercial verifique com a loja se realmente esse nome está correto
Nem todos os dados do produto foram atualizados pois ele está no controle de divergênciaInternamente no Zoom temos um controle de divergência das informações do produto que estão na nossa base de dados com o que está sendo vinculado no site do lojista. Caso exista um controle de divergência para o produto passado na requisição, os dados de preço, parcelamento e disponibilidade não serão alterados e serão checados novamente com o site do lojista
O parcelamento foi zerado pois é menor que o preçoQuando a quantidade de parcelas multiplicadas pelo preço de cada parcela for menor do que o preço do produto, o parcelamento é anulado
","urlObject":{"path":["receipt",":ticket"],"host":["http://merchant.zoom.com.br/api/merchant"],"query":[],"variable":[{"id":"226cbf2a-66ae-49ba-80ce-77609b523cff","description":{"content":"

Identificador associado a requisição cujos resultados serão consultados

\n","type":"text/plain"},"type":"string","value":"","key":"ticket"}]}},"response":[{"id":"3dd1f882-498c-492c-a91a-e9c05ab041a2","name":"Sucesso","originalRequest":{"method":"GET","header":[],"url":{"raw":"http://merchant.zoom.com.br/api/merchant/receipt/:ticket","host":["http://merchant.zoom.com.br/api/merchant"],"path":["receipt",":ticket"],"variable":[{"id":"226cbf2a-66ae-49ba-80ce-77609b523cff","key":"ticket","value":"","type":"string","description":{"content":"Identificador associado a requisição cujos resultados serão consultados","type":"text/plain"}}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"quantity\": 1,\n \"finished\": true,\n \"requestTimestamp\": \"2020-05-11T12:17:28\",\n \"results\": [\n {\n \"product_id\": \"abc123\",\n \"status\": 200,\n \"message\": \"O produto foi atualizado com sucesso\"\n }\n ]\n}"},{"id":"9ef484fa-065a-4516-9b32-38c4b51f5a9f","name":"Ainda em processamento","originalRequest":{"method":"GET","header":[],"url":{"raw":"http://merchant.zoom.com.br/api/merchant/receipt/:ticket","host":["http://merchant.zoom.com.br/api/merchant"],"path":["receipt",":ticket"],"variable":[{"id":"226cbf2a-66ae-49ba-80ce-77609b523cff","key":"ticket","value":"","type":"string","description":{"content":"Identificador associado a requisição cujos resultados serão consultados","type":"text/plain"}}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"quantity\": 1,\n \"finished\": false,\n \"requestTimestamp\": \"2020-05-11T12:17:28\",\n \"results\": []\n}"},{"id":"e3484434-fcd2-4f2b-957e-d5d245e9d0b8","name":"Sucesso com warning","originalRequest":{"method":"GET","header":[],"url":{"raw":"http://merchant.zoom.com.br/api/merchant/receipt/:ticket","host":["http://merchant.zoom.com.br/api/merchant"],"path":["receipt",":ticket"],"variable":[{"id":"226cbf2a-66ae-49ba-80ce-77609b523cff","key":"ticket","value":"","type":"string","description":{"content":"Identificador associado a requisição cujos resultados serão consultados","type":"text/plain"}}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"quantity\": 1,\n \"finished\": true,\n \"requestTimestamp\": \"2020-05-11T12:31:37\",\n \"results\": [\n {\n \"product_id\": \"abc123\",\n \"status\": 200,\n \"message\": \"O produto foi atualizado com sucesso\",\n \"warning_messages\": [\n \"O produto foi bloqueado por mudança de preço excessiva.\"\n ]\n }\n ]\n}"}],"_postman_id":"3b87e37e-f1f6-4cf0-9db4-937711392792"},{"name":"Busca paginada por protocolos de atendimento.","id":"1b293a09-617c-4c38-8193-7b9bc3bb299b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"http://merchant.zoom.com.br/api/merchant/receipt","description":"

Busca informações sobre requisições de atualização de produto realizadas.

","urlObject":{"path":["receipt"],"host":["http://merchant.zoom.com.br/api/merchant"],"query":[],"variable":[]}},"response":[{"id":"a210420b-27c1-4e6f-953e-f5d75dd731ac","name":"Protocolo(s) encontrado(s) com sucesso.","originalRequest":{"method":"GET","header":[],"url":"http://merchant.zoom.com.br/api/merchant/receipt"},"status":"OK","code":200,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"*/*"}],"cookie":[],"responseTime":null,"body":""},{"id":"c36e8286-8742-4e08-b113-e60c734252a0","name":"Ocorreu um erro interno inesperado","originalRequest":{"method":"GET","header":[],"url":"http://merchant.zoom.com.br/api/merchant/receipt"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"text/plain"}],"cookie":[],"responseTime":null,"body":""}],"_postman_id":"1b293a09-617c-4c38-8193-7b9bc3bb299b"},{"name":"Avança busca paginada por protocolos de atendimento.","id":"2dd3c481-00e5-41c7-a3c2-582c794178e3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"http://merchant.zoom.com.br/api/merchant/receipt/scroll/:scroll_id","description":"

Busca a próxima página de informações sobre requisições de atualização de produto realizadas.

Caso não existam mais páginas, uma lista vazia será retornada.

","urlObject":{"path":["receipt","scroll",":scroll_id"],"host":["http://merchant.zoom.com.br/api/merchant"],"query":[],"variable":[{"id":"10836420-ca73-40aa-8a39-520945cfc822","description":{"content":"

Identificador da consulta corrente

\n","type":"text/plain"},"type":"string","value":"","key":"scroll_id"}]}},"response":[{"id":"037f5fe8-ef56-411f-a30d-ef4db532b2b0","name":"Protocolo(s) encontrado(s) com sucesso.","originalRequest":{"method":"GET","header":[],"url":{"raw":"http://merchant.zoom.com.br/api/merchant/receipt/scroll/:scroll_id","host":["http://merchant.zoom.com.br/api/merchant"],"path":["receipt","scroll",":scroll_id"],"variable":[{"key":"scroll_id"}]}},"status":"OK","code":200,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"*/*"}],"cookie":[],"responseTime":null,"body":""},{"id":"287eb223-0cd2-4cce-8e39-449dc43a3b99","name":"Ocorreu um erro interno inesperado","originalRequest":{"method":"GET","header":[],"url":{"raw":"http://merchant.zoom.com.br/api/merchant/receipt/scroll/:scroll_id","host":["http://merchant.zoom.com.br/api/merchant"],"path":["receipt","scroll",":scroll_id"],"variable":[{"key":"scroll_id"}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"text/plain"}],"cookie":[],"responseTime":null,"body":""}],"_postman_id":"2dd3c481-00e5-41c7-a3c2-582c794178e3"}],"id":"1d470f6e-a59f-45ed-81ba-b7adc351e82c","description":"

Automatização

\n

Como forma de automatização, recomendamos fazer GET do ticket até que dê retorno.\nExistem cenários que \"não mostrem\" o resultado do ticket, são elas:

\n
    \n
  • Cenário 1- Dá 404 pois existe um delay entre a geração de ticket e a disponibilidade de ticket para a busca;
    • \n
  • Cenário 2- Quando o Finished da False e results vem vazio, isso acontece pois o processamento ainda não foi finalizado.

    Nesses 2 cenários recomendamos fazer o retry do get.

    • \n
\n","event":[{"listen":"prerequest","script":{"id":"6bdbb146-468b-4a44-aea8-269ee0b54857","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"3db7741d-8cee-4294-b6b1-0968e638e581","type":"text/javascript","exec":[""]}}],"_postman_id":"1d470f6e-a59f-45ed-81ba-b7adc351e82c","auth":{"type":"basic","basic":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"da96198e-d68b-4fca-a838-972f3ec0de29","id":"da96198e-d68b-4fca-a838-972f3ec0de29","name":"API Zoom&Buscapé Comparador","type":"collection"}}}],"auth":{"type":"basic","basic":{"basicConfig":[]}},"event":[{"listen":"prerequest","script":{"id":"3d2c79ec-fb78-4f77-9378-1a565e88f449","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"3b92f091-0800-42c9-8c21-6675889ed5e0","type":"text/javascript","exec":[""]}}],"variable":[{"key":"baseUrl","value":"http://merchant.zoom.com.br/api/merchant"}]}