{"info":{"_postman_id":"900e4b41-1396-4bba-adf3-0ac48e9ac304","name":"API Zoom&Buscapé","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":"900e4b41-1396-4bba-adf3-0ac48e9ac304","publishedId":"SWTK3tt9","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EF5B25"},"publishDate":"2020-02-19T13:34:58.000Z"},"item":[{"name":"product","item":[{"name":"Insere ou atualiza todos os dados de um produto","id":"ac262f16-fd9c-4684-9232-8d57040d3818","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 \"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

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":"2adfe5fa-d692-42e8-a871-34abcbe6ef79","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 \"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"},"code":200,"_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":"ac262f16-fd9c-4684-9232-8d57040d3818"},{"name":"Remove um produto","id":"5295e7ff-e2d7-4cae-a2d5-c94aae2424fa","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":"5f0a1663-23d7-478d-890f-dca314cb729c","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":"5295e7ff-e2d7-4cae-a2d5-c94aae2424fa"},{"name":"Atualiza disponibilidade, preço e parcelamento de um produto","id":"3cf5289a-4721-4654-9070-85842c808371","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 \"base_price\": \"\",\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":"761c7aa8-a859-401a-b818-6b2b0c81e7d9","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":"3cf5289a-4721-4654-9070-85842c808371"},{"name":"Atualiza preço de um produto","id":"3fd93c64-d95e-4cb7-8774-55131eb22ade","request":{"auth":{"type":"noauth","isInherited":false},"method":"PUT","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id\": \"\",\n \"price\": \"\"\n}"},"url":"http://merchant.zoom.com.br/api/merchant/product/price","description":"

Este serviço permite que os lojistas atualizem o preço de um de seus produtos no Zoom&Buscapé.

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.

","urlObject":{"path":["product","price"],"host":["http://merchant.zoom.com.br/api/merchant"],"query":[],"variable":[]}},"response":[{"id":"6983d78c-88db-4bd9-a38f-d99da0b0044f","name":"Response com Ticket id","originalRequest":{"method":"PUT","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id\": \"\",\n \"price\": \"\"\n}"},"url":"http://merchant.zoom.com.br/api/merchant/product/price"},"_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":"3fd93c64-d95e-4cb7-8774-55131eb22ade"}],"id":"e45927cb-d399-4cd1-a938-3ba50cac5f59","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":"e45927cb-d399-4cd1-a938-3ba50cac5f59","description":"","auth":{"type":"basic","basic":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"900e4b41-1396-4bba-adf3-0ac48e9ac304","id":"900e4b41-1396-4bba-adf3-0ac48e9ac304","name":"API Zoom&Buscapé","type":"collection"}}},{"name":"products","item":[{"name":"Insere ou atualiza todos os dados de produtos em lotes","id":"4103a0ed-8b00-42e8-9474-8f6225c54ef3","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 \"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 \"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":"a88bd0d5-ceae-4055-a073-51d1b34dede6","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 \"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 \"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":"{\r\n \"ticket\": \"625373e4-a917-4ad3-bc36-68608b243360\",\r\n \"results\": [\r\n {\r\n \"product_id\": \"productid1\",\r\n \"status\": 200,\r\n \"message\": \"Em processamento\"\r\n },\r\n {\r\n \"product_id\": \"productid2\",\r\n \"status\": 200,\r\n \"message\": \"Em processamento\"\r\n }\r\n ]\r\n}"}],"_postman_id":"4103a0ed-8b00-42e8-9474-8f6225c54ef3"},{"name":"Atualiza a disponibilidade, preço e parcelamento de produtos em lotes","id":"594572d0-cfe3-465d-add6-7840a6321a34","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":"20cc1aed-d535-439a-86fa-356cccf02e4d","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":"594572d0-cfe3-465d-add6-7840a6321a34"},{"name":"Remove produtos em lotes","id":"69214631-b92b-4821-940e-f1a9edb36523","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":"9e670521-7d9a-43b4-8207-76dc1344de1b","name":"Response com ticket id","originalRequest":{"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"},"_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":"69214631-b92b-4821-940e-f1a9edb36523"},{"name":"Atualiza preço dos produtos em lotes","id":"26e14cee-22a7-4f76-a190-acdbec05ef7f","request":{"auth":{"type":"noauth","isInherited":false},"method":"PUT","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"products\": [\n {\n \"id\": \"\",\n \"price\": \"\"\n },\n {\n \"id\": \"\",\n \"price\": \"\"\n }\n ]\n}"},"url":"http://merchant.zoom.com.br/api/merchant/products/price","description":"

Este serviço permite que os lojistas atualizem o preço 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.

","urlObject":{"path":["products","price"],"host":["http://merchant.zoom.com.br/api/merchant"],"query":[],"variable":[]}},"response":[{"id":"1d4880da-8875-45fe-800e-7938d8220b77","name":"Response com ticket id","originalRequest":{"method":"PUT","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"products\": [\n {\n \"id\": \"\",\n \"price\": \"\"\n },\n {\n \"id\": \"\",\n \"price\": \"\"\n }\n ]\n}"},"url":"http://merchant.zoom.com.br/api/merchant/products/price"},"_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":"26e14cee-22a7-4f76-a190-acdbec05ef7f"},{"name":"Busca produtos sem atualização","id":"fe67dd9e-726b-4bb0-8003-aa9e013de04c","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":"7230380f-da8b-4a34-b7d1-11b5c80a476c","name":"Busca produtos sem atualização","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","description":"Número de dias sem atualização"}]}},"_postman_previewlanguage":"json","header":null,"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":"fe67dd9e-726b-4bb0-8003-aa9e013de04c"}],"id":"76f8d111-120f-4c01-ba9b-efb11d8f08f9","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":"76f8d111-120f-4c01-ba9b-efb11d8f08f9","description":"","auth":{"type":"basic","basic":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"900e4b41-1396-4bba-adf3-0ac48e9ac304","id":"900e4b41-1396-4bba-adf3-0ac48e9ac304","name":"API Zoom&Buscapé","type":"collection"}}},{"name":"receipt","item":[{"name":"{date and hour}","item":[{"name":"Busca paginada por protocolos de atendimento.","id":"8e815418-c268-4622-806d-76f70a6de955","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":[{"description":{"content":"

Data e Hora

\n","type":"text/plain"},"type":"string","value":" formato yyyy-MM-dd","key":"date_and_hour"}]}},"response":[{"id":"d12c46e2-7118-45d7-805b-87d2c5a9d437","name":"Ocorreu um erro interno inesperado","originalRequest":{"method":"GET","header":[],"url":{"raw":"http://merchant.zoom.com.br/api/merchant/receipt/:date_and_hour","host":["http://merchant.zoom.com.br/api/merchant"],"path":["receipt",":date_and_hour"],"variable":[{"key":"date_and_hour"}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"text/plain"}],"cookie":[],"responseTime":null,"body":""},{"id":"ea58818e-14cf-45eb-bacd-39b39f1a2a85","name":"Protocolo(s) encontrado(s) com sucesso.","originalRequest":{"method":"GET","header":[],"url":{"raw":"http://merchant.zoom.com.br/api/merchant/receipt/:date_and_hour","host":["http://merchant.zoom.com.br/api/merchant"],"path":["receipt",":date_and_hour"],"variable":[{"key":"date_and_hour"}]}},"status":"OK","code":200,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"*/*"}],"cookie":[],"responseTime":null,"body":""}],"_postman_id":"8e815418-c268-4622-806d-76f70a6de955"},{"name":"Avança busca paginada por protocolos de atendimento.","id":"2eb126c8-36c2-48f3-b73f-a28c2127496f","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":[{"description":{"content":"

Data e Hora

\n","type":"text/plain"},"type":"string","value":" formato yyyy-MM-dd","key":"date_and_hour"},{"description":{"content":"

Identificador da consulta corrente

\n","type":"text/plain"},"type":"string","value":"","key":"next_page_id"}]}},"response":[{"id":"22724bff-fd74-403b-bfe3-2d0a40defb26","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":""},{"id":"f94ce683-0826-43fa-9356-771059c9447e","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":""}],"_postman_id":"2eb126c8-36c2-48f3-b73f-a28c2127496f"}],"id":"0c36d1e5-eee8-4639-aa7b-7e482e37da3e","_postman_id":"0c36d1e5-eee8-4639-aa7b-7e482e37da3e","description":"","auth":{"type":"basic","basic":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"900e4b41-1396-4bba-adf3-0ac48e9ac304","id":"900e4b41-1396-4bba-adf3-0ac48e9ac304","name":"API Zoom&Buscapé","type":"collection"}}},{"name":"Obtem resultado por protocolo de atendimento.","id":"c78900fc-5dbe-4cd6-8418-076d96ab08ca","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":"3cdf4cad-fddc-4673-8f77-7265d4d0769d","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}"},{"id":"62ea7bc0-8a9d-4bdd-8f10-fddc820cd32c","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":"bd8cff4e-0d99-4fd1-98a1-6ecc6e4cac1b","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}"}],"_postman_id":"c78900fc-5dbe-4cd6-8418-076d96ab08ca"},{"name":"Busca paginada por protocolos de atendimento.","id":"7c78c7fa-83c2-4a5f-a2cb-944462d6e9dc","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":"76816567-b6ea-4b9b-bf65-18f02868408d","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":"882bf552-c261-4693-8a88-a1ff323267f2","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":"7c78c7fa-83c2-4a5f-a2cb-944462d6e9dc"},{"name":"Avança busca paginada por protocolos de atendimento.","id":"68741a8c-fc98-4a9c-91e9-b6a9e234c0c9","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":"34791031-3fa6-4f25-91a0-e451b3818165","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":""},{"id":"bf5261e3-db52-41fa-befa-f1b64cdc0314","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":""}],"_postman_id":"68741a8c-fc98-4a9c-91e9-b6a9e234c0c9"}],"id":"88be7933-f977-460e-94ad-2b269717803b","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":"88be7933-f977-460e-94ad-2b269717803b","auth":{"type":"basic","basic":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"900e4b41-1396-4bba-adf3-0ac48e9ac304","id":"900e4b41-1396-4bba-adf3-0ac48e9ac304","name":"API Zoom&Buscapé","type":"collection"}}},{"name":"freight","item":[{"name":"Requisicao","id":"6810f4ee-e145-4d1c-bc9e-819c405ea9e6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"zipcode\": \"22220080\",\r\n \"items\": [\r\n {\r\n \"amount\": 1,\r\n \"sku\": \"20-18\",\r\n \"price\": 59.99,\r\n \"weight\": 1.2,\r\n \"height\": 0.26,\r\n \"width\": 0.17,\r\n \"length\": 0.17\r\n }\r\n ]\r\n}\r\n"},"url":"{{URLdeFreteDaLoja}}","description":"

Unidades de medidas

\n

Dimensão do produto é enviado em Metros;

\n

Peso do produto é enviado em Kilos;

\n","auth":{"type":"basic","basic":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"900e4b41-1396-4bba-adf3-0ac48e9ac304","id":"900e4b41-1396-4bba-adf3-0ac48e9ac304","name":"API Zoom&Buscapé","type":"collection"}},"urlObject":{"host":["{{URLdeFreteDaLoja}}"],"query":[],"variable":[]}},"response":[{"id":"7ef730e9-a66b-4c3a-8357-fab3552437c4","name":"Resposta Esperada Sucesso","originalRequest":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"zipcode\": \"22220080\",\r\n \"items\": [\r\n {\r\n \"amount\": 1,\r\n \"sku\": \"20-18\",\r\n \"price\": 59.99,\r\n \"weight\": 1.2,\r\n \"height\": 0.26,\r\n \"width\": 0.17,\r\n \"length\": 0.17\r\n }\r\n ]\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"{{URLdeFreteDaLoja}}"},"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"20-18\",\n \"estimates\": [\n {\n \"shippingPrice\": 2.15,\n \"daysToDelivery\": 15,\n \"methodId\": \"PAC\",\n \"methodName\": \"Correios - Pac\"\n },\n {\n \"shippingPrice\": 8.5,\n \"daysToDelivery\": 8,\n \"methodId\": \"TRANS\",\n \"methodName\": \"Transportadora\"\n }\n ]\n}"},{"id":"ce69be76-e177-4943-8f4d-d773795e66f6","name":"Resposta de Erro Detalhado","originalRequest":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"zipcode\": \"22220080\",\r\n \"items\": [\r\n {\r\n \"amount\": 1,\r\n \"sku\": \"20-18\",\r\n \"price\": 59.99,\r\n \"weight\": 1.2,\r\n \"height\": 0.26,\r\n \"width\": 0.17,\r\n \"length\": 0.17\r\n }\r\n ]\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"{{URLdeFreteDaLoja}}"},"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\r\n \"status\": null,\r\n \"messages\": [\r\n \"tShippingResponseErrorMessage [key=quote.no.delivery.options, type=ERROR, text=\\\"Produto sem estoque\\\"]\",\r\n null\r\n ]\r\n}\r\n"},{"id":"fae9d753-f224-4e80-beca-47a44e78bc10","name":"Loja Não Entrega no CEP","originalRequest":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"zipcode\": \"22220080\",\r\n \"items\": [\r\n {\r\n \"amount\": 1,\r\n \"sku\": \"20-18\",\r\n \"price\": 59.99,\r\n \"weight\": 1.2,\r\n \"height\": 0.26,\r\n \"width\": 0.17,\r\n \"length\": 0.17\r\n }\r\n ]\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"{{URLdeFreteDaLoja}}"},"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"20-18\",\n \"estimates\": []\n}"}],"_postman_id":"6810f4ee-e145-4d1c-bc9e-819c405ea9e6"}],"id":"308523b5-bab3-4d6e-9f9e-50a89f43dba3","description":"

Ao integrar no modelo MKP do Zoom&Buscapé é necessário informar um serviço principal de frete que pode ser:

\n
    \n
  • Endpoint gerada pela Loja ou HUB/Integradora;
    • \n
  • Credenciais para Intelipost:
      \n
    • Chave de acesso;
      • \n
    • CEP de Origem;
      • \n
    • Unidades de medidas cadastradas no Intelipost.
      • \n
    \n
    • \n
\n

Oferecemos também a possibilidade de cadastro de uma planilha de contingência, assim podemos garantir que será exibida uma resposta de frete no site mesmo em casos de falha do serviço principal.

\n

Quando há um acesso à página de oferta, uma requisição é realizada ao serviço de frete e o Zoom&Buscapé exibirá prioritariamente a estimativa de menor custo.

\n

Sistemas mais comuns são erro de Read Timed Out e Connection Timed Out, isso se dá ao fato da nossa API ter uma tolerância de até 5000ms para retorno de frete.

\n","event":[{"listen":"prerequest","script":{"id":"0716d929-e90f-48f5-bdf1-ebbbd137b6bc","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"f194032d-ace8-4a57-a91b-2975573e946a","type":"text/javascript","exec":[""]}}],"_postman_id":"308523b5-bab3-4d6e-9f9e-50a89f43dba3","auth":{"type":"basic","basic":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"900e4b41-1396-4bba-adf3-0ac48e9ac304","id":"900e4b41-1396-4bba-adf3-0ac48e9ac304","name":"API Zoom&Buscapé","type":"collection"}}},{"name":"order","item":[{"name":"{id}","item":[{"name":"Busca pedido for ID.","id":"3cf6db97-4c96-430e-9bd4-19fb895ffa16","request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"http://merchant.zoom.com.br/api/merchant/order/:id","description":"

Este serviço permite que os lojista busque um pedido feito pelo Marketplace do Zoom&Buscapé, por ID.

\n\n

Promotions é a promoção pré acordado entre a loja e o nosso comercial.

\ntotal_discount_value (number) Valor total de desconto

\ntotal_interest_value (number) Valor total de juros

\n

Como calcular valor total do pedido?

\n

Valor total do pedido

\n

O valor total do pedido deve ser calculado da seguinte forma:\nitems.total + shipping.freight_price - total_discount_value

\n","urlObject":{"path":["order",":id"],"host":["http://merchant.zoom.com.br/api/merchant"],"query":[],"variable":[{"id":"8fb55d55-b671-4f6a-b149-cc03301e6819","description":{"content":"

Id do pedido

\n","type":"text/plain"},"type":"string","value":"","key":"id"}]}},"response":[{"id":"5e72281e-ec4a-4291-86a7-65fb22906133","name":"Pedido ApprovedPayment","originalRequest":{"method":"GET","header":[],"url":{"raw":"http://merchant.zoom.com.br/api/merchant/order/:id","host":["http://merchant.zoom.com.br/api/merchant"],"path":["order",":id"],"variable":[{"id":"8fb55d55-b671-4f6a-b149-cc03301e6819","key":"id","value":"","type":"string","description":{"content":"Id do pedido","type":"text/plain"}}]}},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ApprovedPayment\",\n \"customer\": {\n \"cpf\": \"99999999999\",\n \"first_name\": \"nome1\",\n \"second_name\": \"sobrenome\",\n \"user_phone\": \"08008925021\"\n },\n \"items\": [\n {\n \"amount\": 3,\n \"total\": 789.15,\n \"product_id\": \"6626880777\",\n \"product_name\": \"Tablet Amazon Fire 7 16gb 9ª Geração Preto\",\n \"product_price\": 263.05\n }\n ],\n \"shipments\": [],\n \"shipping\": {\n \"freight_price\": 42.71,\n \"estimate_shipping\": 8,\n \"quote_type\": \"INTELIPOST\",\n \"shipping_quote_log_id\": 0,\n \"shipping_method_id\": \"2\",\n \"shipping_method_name\": \"Correios Sedex\",\n \"external_quote_id\": \"99999999990\"\n },\n \"order_number\": \"999999999\",\n \"creation_date\": \"04/02/2020 08:13:02\",\n \"approved_date\": \"04/02/2020 08:21:07\",\n \"last_modification_date\": \"04/02/2020 08:21:07\",\n \"estimated_delivery_day\": \"14/02/2020 23:59:59\",\n \"delivery_address\": {\n \"reference\": \"\",\n \"zipcode\": \"99999999\",\n \"state\": \"RN\",\n \"city\": \"Natal\",\n \"neighborhood\": \"Lagoa velha\",\n \"address_number\": \"Nº de endereço\",\n \"additional_info\": \"Esquina com Av Jaozinhoa\",\n \"address_place\": \"Avenida Miguel Castro\",\n \"address_receiver\": \"Endereço\"\n },\n \"billing_address\": {\n \"zipcode\": \"99999999\",\n \"state\": \"SP\",\n \"city\": \"Campinas\",\n \"neighborhood\": \"Alphaville Campinas\",\n \"address_number\": \"99\",\n \"additional_info\": \"casa xxx\",\n \"address_place\": \"Endereço\"\n }\n}"},{"id":"dbec9e97-d3a6-4617-9d32-10a71dfacc4a","name":"Pedido New (Aguardando pagamento)","originalRequest":{"method":"GET","header":[],"url":{"raw":"http://merchant.zoom.com.br/api/merchant/order/:id","host":["http://merchant.zoom.com.br/api/merchant"],"path":["order",":id"],"variable":[{"id":"8fb55d55-b671-4f6a-b149-cc03301e6819","key":"id","value":"","type":"string","description":{"content":"Id do pedido","type":"text/plain"}}]}},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"status\": \"New\",\n \"customer\": {\n \"cpf\": \"99999999999\",\n \"first_name\": \"nome\",\n \"second_name\": \"sobrenome\",\n \"user_phone\": \"08008925021\"\n },\n \"items\": [\n {\n \"amount\": 6,\n \"total\": 1722.78,\n \"promotions\": [\n {\n \"name\": \"6%\",\n \"value\": 103.37,\n \"promotion_id\": \"91920561935\"\n }\n ],\n \"product_id\": \"6626880777\",\n \"product_name\": \"Tablet Amazon Fire 9 Geração Preto\",\n \"product_price\": 287.13\n }\n ],\n \"shipments\": [],\n \"shipping\": {\n \"freight_price\": 152.14,\n \"estimate_shipping\": 9,\n \"quote_type\": \"EXTERNAL\",\n \"shipping_quote_log_id\": 0,\n \"shipping_method_id\": \"2\",\n \"shipping_method_name\": \"Correios Sedex\",\n \"external_quote_id\": \"xxxxxxxxx\"\n },\n \"order_number\": \"99999999999\",\n \"creation_date\": \"15/01/2020 14:52:16\",\n \"last_modification_date\": \"20/01/2020 15:37:16\",\n \"delivery_address\": {\n \"reference\": \"\",\n \"zipcode\": \"99999999\",\n \"state\": \"RN\",\n \"city\": \"Natal\",\n \"neighborhood\": \"Lagoa velha\",\n \"address_number\": \"Nº de endereço\",\n \"additional_info\": \"Esquina com Av Jaozinhoa\",\n \"address_place\": \"Avenida Miguel Castro\",\n \"address_receiver\": \"Endereço\"\n },\n \"billing_address\": {},\n \"total_discount_value\": 103.37\n}"}],"_postman_id":"3cf6db97-4c96-430e-9bd4-19fb895ffa16"},{"name":"Busca pedido for ID com informação de pagamento","id":"ab544957-ad3f-4583-84e8-831b9c052bd7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"http://merchant.zoom.com.br/api/merchant/order/:id/withpayment","description":"

Este serviço permite que os lojista busque um pedido, com informação de pagamento, feito pelo Marketplace do Zoom&Buscapé, por ID.

","urlObject":{"path":["order",":id","withpayment"],"host":["http://merchant.zoom.com.br/api/merchant"],"query":[],"variable":[{"id":"50bb7e6a-313b-47a7-9497-8f3613947d63","description":{"content":"

Id do pedido

\n","type":"text/plain"},"type":"string","value":"","key":"id"}]}},"response":[{"id":"8618faeb-7c65-4a7a-891b-0b8faa5b5c0c","name":"Busca pedido for ID com informação de pagamento","originalRequest":{"method":"GET","header":[],"url":{"raw":"http://merchant.zoom.com.br/api/merchant/order/:id/withpayment","host":["http://merchant.zoom.com.br/api/merchant"],"path":["order",":id","withpayment"],"variable":[{"description":{"content":"Id do pedido","type":"text/plain"},"id":"50bb7e6a-313b-47a7-9497-8f3613947d63","key":"id","type":"string","value":""}]}},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"status\": \"New\",\n \"customer\": {\n \"cpf\": \"99999999999\",\n \"first_name\": \"nome\",\n \"second_name\": \"sobrenome\",\n \"user_phone\": \"08008925021\"\n },\n \"items\": [\n {\n \"amount\": 6,\n \"total\": 1722.78,\n \"promotions\": [\n {\n \"name\": \"6%\",\n \"value\": 103.37,\n \"promotion_id\": \"91920561935\"\n }\n ],\n \"product_id\": \"6626880777\",\n \"product_name\": \"Tablet Amazon Fire 9 Geração Preto\",\n \"product_price\": 287.13\n }\n ],\n \"shipments\": [],\n \"shipping\": {\n \"freight_price\": 152.14,\n \"estimate_shipping\": 9,\n \"quote_type\": \"EXTERNAL\",\n \"shipping_quote_log_id\": 0,\n \"shipping_method_id\": \"2\",\n \"shipping_method_name\": \"Correios Sedex\",\n \"external_quote_id\": \"xxxxxxxxx\"\n },\n \"order_number\": \"99999999999\",\n \"creation_date\": \"15/01/2020 14:52:16\",\n \"last_modification_date\": \"20/01/2020 15:37:16\",\n \"delivery_address\": {\n \"reference\": \"\",\n \"zipcode\": \"99999999\",\n \"state\": \"RN\",\n \"city\": \"Natal\",\n \"neighborhood\": \"Lagoa velha\",\n \"address_number\": \"Nº de endereço\",\n \"additional_info\": \"Esquina com Av Jaozinhoa\",\n \"address_place\": \"Avenida Miguel Castro\",\n \"address_receiver\": \"Endereço\"\n },\n \"billing_address\": {},\n \"total_discount_value\": 103.37,\n \"order_payment\": {\n \"amount\": 1771.55,\n \"method_type\": 2,\n \"number_installments\": 1\n }\n}"}],"_postman_id":"ab544957-ad3f-4583-84e8-831b9c052bd7"},{"name":"Operação para informar que um pedido foi processado.","id":"70b66238-40d8-4127-9b3b-94b9a2a7cc02","request":{"auth":{"type":"noauth","isInherited":false},"method":"PUT","header":[],"url":"http://merchant.zoom.com.br/api/merchant/order/:id/processed","description":"

Operação para informar que um pedido foi processado, ou seja, o lojista confirma que tem o produto em estoque e o mesmo será entregue.

","urlObject":{"path":["order",":id","processed"],"host":["http://merchant.zoom.com.br/api/merchant"],"query":[],"variable":[{"id":"f8167fb4-a94a-4784-8a2e-31b54e93f1d4","description":{"content":"

Id do pedido

\n","type":"text/plain"},"type":"string","value":"","key":"id"}]}},"response":[{"id":"7cf34419-8dec-4265-92da-87a8c628ae77","name":"O pedido foi processado com sucesso.","originalRequest":{"method":"PUT","header":[],"url":{"raw":"http://merchant.zoom.com.br/api/merchant/order/:id/processed","host":["http://merchant.zoom.com.br/api/merchant"],"path":["order",":id","processed"],"variable":[{"key":"id"}]}},"status":"OK","code":200,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"*/*"}],"cookie":[],"responseTime":null,"body":""},{"id":"98260014-094a-4226-ba9b-e8f6bfb993ad","name":"Pedido não foi encontrado.","originalRequest":{"method":"PUT","header":[],"url":{"raw":"http://merchant.zoom.com.br/api/merchant/order/:id/processed","host":["http://merchant.zoom.com.br/api/merchant"],"path":["order",":id","processed"],"variable":[{"key":"id"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"*/*"}],"cookie":[],"responseTime":null,"body":""},{"id":"deeebecf-2935-40d2-bf9b-af3b9b6abcd4","name":"Modificação do status do pedido é inválida.","originalRequest":{"method":"PUT","header":[],"url":{"raw":"http://merchant.zoom.com.br/api/merchant/order/:id/processed","host":["http://merchant.zoom.com.br/api/merchant"],"path":["order",":id","processed"],"variable":[{"key":"id"}]}},"status":"Conflict","code":409,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"*/*"}],"cookie":[],"responseTime":null,"body":""},{"id":"e1c3de7f-fb2b-48f8-a1b9-e0a44a463b89","name":"Ocorreu um erro inesperado.","originalRequest":{"method":"PUT","header":[],"url":{"raw":"http://merchant.zoom.com.br/api/merchant/order/:id/processed","host":["http://merchant.zoom.com.br/api/merchant"],"path":["order",":id","processed"],"variable":[{"key":"id"}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"*/*"}],"cookie":[],"responseTime":null,"body":""}],"_postman_id":"70b66238-40d8-4127-9b3b-94b9a2a7cc02"},{"name":"Atualiza o Pedido com os dados de envio e nota fiscal","id":"b989b89d-6fac-4fbc-b5a8-94fb762c0271","request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"invoice\": {\n \"number\": \"\",\n \"access_key\": \"\",\n \"cnpj\": \"\",\n \"issue_date\": \"\",\n \"series\": \"\",\n \"url\": \"\"\n },\n \"sent_date\": \"\",\n \"carrier_name\": \"\",\n \"sent_items\": [\n {\n \"product_id\": \"\",\n \"quantity\": \"\"\n },\n {\n \"product_id\": \"\",\n \"quantity\": \"\"\n }\n ],\n \"shipment_id\": \"\",\n \"tracking_number\": \"\",\n \"url\": \"\"\n}"},"url":"http://merchant.zoom.com.br/api/merchant/order/:id/shipment","description":"

Operação para informar que um pedido foi enviado, junto com os dados na nota fiscal.

","urlObject":{"path":["order",":id","shipment"],"host":["http://merchant.zoom.com.br/api/merchant"],"query":[],"variable":[{"id":"6cd85cee-c631-4ec2-baf5-ad5ef67d2770","description":{"content":"

Id do pedido

\n","type":"text/plain"},"type":"string","value":"","key":"id"}]}},"response":[{"id":"0d06ddb2-ae32-4b46-bf2a-aa7a0adfdb06","name":"Foram fornecidos dados inválidos para essa requisição:
  • Os dados do transporte não foram enviados no corpo da requisição
  • Envio referencia um ID de produto que não faz parte do pedido informado
  • Já foi feito um envio parcial deste","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"invoice\": {\n \"number\": \"\",\n \"access_key\": \"\",\n \"cnpj\": \"\",\n \"issue_date\": \"\",\n \"series\": \"\",\n \"url\": \"\"\n },\n \"sent_date\": \"\",\n \"carrier_name\": \"\",\n \"sent_items\": [\n {\n \"product_id\": \"\",\n \"quantity\": \"\"\n },\n {\n \"product_id\": \"\",\n \"quantity\": \"\"\n }\n ],\n \"shipment_id\": \"\",\n \"tracking_number\": \"\",\n \"url\": \"\"\n}"},"url":{"raw":"http://merchant.zoom.com.br/api/merchant/order/:id/shipment","host":["http://merchant.zoom.com.br/api/merchant"],"path":["order",":id","shipment"],"variable":[{"key":"id"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"*/*"}],"cookie":[],"responseTime":null,"body":""},{"id":"86ef244c-dc9c-4a91-b1b1-2a163ef26270","name":"Modificação do status do pedido é inválida.","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"invoice\": {\n \"number\": \"\",\n \"access_key\": \"\",\n \"cnpj\": \"\",\n \"issue_date\": \"\",\n \"series\": \"\",\n \"url\": \"\"\n },\n \"sent_date\": \"\",\n \"carrier_name\": \"\",\n \"sent_items\": [\n {\n \"product_id\": \"\",\n \"quantity\": \"\"\n },\n {\n \"product_id\": \"\",\n \"quantity\": \"\"\n }\n ],\n \"shipment_id\": \"\",\n \"tracking_number\": \"\",\n \"url\": \"\"\n}"},"url":{"raw":"http://merchant.zoom.com.br/api/merchant/order/:id/shipment","host":["http://merchant.zoom.com.br/api/merchant"],"path":["order",":id","shipment"],"variable":[{"key":"id"}]}},"status":"Conflict","code":409,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"*/*"}],"cookie":[],"responseTime":null,"body":""},{"id":"871ba52c-236e-42c7-854c-3da55a914c62","name":"O pedido foi marcado como indisponível.","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"invoice\": {\n \"number\": \"\",\n \"access_key\": \"\",\n \"cnpj\": \"\",\n \"issue_date\": \"\",\n \"series\": \"\",\n \"url\": \"\"\n },\n \"sent_date\": \"\",\n \"carrier_name\": \"\",\n \"sent_items\": [\n {\n \"product_id\": \"\",\n \"quantity\": \"\"\n },\n {\n \"product_id\": \"\",\n \"quantity\": \"\"\n }\n ],\n \"shipment_id\": \"\",\n \"tracking_number\": \"\",\n \"url\": \"\"\n}"},"url":{"raw":"http://merchant.zoom.com.br/api/merchant/order/:id/shipment","host":["http://merchant.zoom.com.br/api/merchant"],"path":["order",":id","shipment"],"variable":[{"key":"id"}]}},"status":"OK","code":200,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"*/*"}],"cookie":[],"responseTime":null,"body":""},{"id":"9f5fb028-6fe0-4e2a-aae4-c991a822e1c4","name":"Ocorreu um erro inesperado.","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"invoice\": {\n \"number\": \"\",\n \"access_key\": \"\",\n \"cnpj\": \"\",\n \"issue_date\": \"\",\n \"series\": \"\",\n \"url\": \"\"\n },\n \"sent_date\": \"\",\n \"carrier_name\": \"\",\n \"sent_items\": [\n {\n \"product_id\": \"\",\n \"quantity\": \"\"\n },\n {\n \"product_id\": \"\",\n \"quantity\": \"\"\n }\n ],\n \"shipment_id\": \"\",\n \"tracking_number\": \"\",\n \"url\": \"\"\n}"},"url":{"raw":"http://merchant.zoom.com.br/api/merchant/order/:id/shipment","host":["http://merchant.zoom.com.br/api/merchant"],"path":["order",":id","shipment"],"variable":[{"key":"id"}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"*/*"}],"cookie":[],"responseTime":null,"body":""},{"id":"ce4828b6-7eaa-41ad-8ebd-d3b8c969f8d2","name":"Pedido não foi encontrado.","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"invoice\": {\n \"number\": \"\",\n \"access_key\": \"\",\n \"cnpj\": \"\",\n \"issue_date\": \"\",\n \"series\": \"\",\n \"url\": \"\"\n },\n \"sent_date\": \"\",\n \"carrier_name\": \"\",\n \"sent_items\": [\n {\n \"product_id\": \"\",\n \"quantity\": \"\"\n },\n {\n \"product_id\": \"\",\n \"quantity\": \"\"\n }\n ],\n \"shipment_id\": \"\",\n \"tracking_number\": \"\",\n \"url\": \"\"\n}"},"url":{"raw":"http://merchant.zoom.com.br/api/merchant/order/:id/shipment","host":["http://merchant.zoom.com.br/api/merchant"],"path":["order",":id","shipment"],"variable":[{"key":"id"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"*/*"}],"cookie":[],"responseTime":null,"body":""}],"_postman_id":"b989b89d-6fac-4fbc-b5a8-94fb762c0271"},{"name":"Operação para informar que um pedido foi entregue.","id":"90af67b4-560c-4df8-865b-43d2afd50a83","request":{"auth":{"type":"noauth","isInherited":false},"method":"PUT","header":[],"url":"http://merchant.zoom.com.br/api/merchant/order/:id/delivered?delivered_date=","description":"

    Operação para informar que um pedido foi recebido, ou seja, o lojista confirma que todos os items do pedido foram entregues. Deve ser chamada somente depois de adicionar informações sobre os item enviados.

    Opcionalmente pode ser informada a data que o cliente recebeu o pedido.

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

    Data que o cliente recebeu o pedido no formato dd/MM/yyyy

    \n","type":"text/plain"},"key":"delivered_date","value":""}],"variable":[{"id":"8d4b7f19-25f2-41b9-9261-ae6ce131063a","description":{"content":"

    Id do pedido

    \n","type":"text/plain"},"type":"string","value":"","key":"id"}]}},"response":[{"id":"07dd6864-065a-4e2d-9faf-a633a096f369","name":"Modificação do status do pedido é inválida.","originalRequest":{"method":"PUT","header":[],"url":{"raw":"http://merchant.zoom.com.br/api/merchant/order/:id/delivered?delivered_date=","host":["http://merchant.zoom.com.br/api/merchant"],"path":["order",":id","delivered"],"query":[{"key":"delivered_date","value":""}],"variable":[{"key":"id"}]}},"status":"Conflict","code":409,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"*/*"}],"cookie":[],"responseTime":null,"body":""},{"id":"10823e8f-d785-4e71-8bb6-4a51cd81cefd","name":"O pedido foi entregue com sucesso.","originalRequest":{"method":"PUT","header":[],"url":{"raw":"http://merchant.zoom.com.br/api/merchant/order/:id/delivered?delivered_date=","host":["http://merchant.zoom.com.br/api/merchant"],"path":["order",":id","delivered"],"query":[{"key":"delivered_date","value":""}],"variable":[{"key":"id"}]}},"status":"OK","code":200,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"*/*"}],"cookie":[],"responseTime":null,"body":""},{"id":"4955c386-c61a-48ff-938e-1bd44339b606","name":"Pedido não foi encontrado.","originalRequest":{"method":"PUT","header":[],"url":{"raw":"http://merchant.zoom.com.br/api/merchant/order/:id/delivered?delivered_date=","host":["http://merchant.zoom.com.br/api/merchant"],"path":["order",":id","delivered"],"query":[{"key":"delivered_date","value":""}],"variable":[{"key":"id"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"*/*"}],"cookie":[],"responseTime":null,"body":""},{"id":"8711fe59-1a96-43a5-a3c3-ed6b62f7822a","name":"Foram fornecidos dados inválidos para essa requisição:
    • Faltam items a serem enviados no pedido. Foram enviados menos itens do que a quantidade comprada
    • Data que o cliente recebeu o pedido deve ser maior que a data do pedido enviado.","host":["http://merchant.zoom.com.br/api/merchant"],"path":["order",":id","delivered"],"query":[{"key":"delivered_date","value":""}],"variable":[{"key":"id"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"*/*"}],"cookie":[],"responseTime":null,"body":""},{"id":"cc2069d9-9041-4c71-b6d3-c09acbea3b21","name":"Ocorreu um erro inesperado.","originalRequest":{"method":"PUT","header":[],"url":{"raw":"http://merchant.zoom.com.br/api/merchant/order/:id/delivered?delivered_date=","host":["http://merchant.zoom.com.br/api/merchant"],"path":["order",":id","delivered"],"query":[{"key":"delivered_date","value":""}],"variable":[{"key":"id"}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"*/*"}],"cookie":[],"responseTime":null,"body":""}],"_postman_id":"90af67b4-560c-4df8-865b-43d2afd50a83"}],"id":"1ce034f1-3251-4bd3-937b-639000bdece7","_postman_id":"1ce034f1-3251-4bd3-937b-639000bdece7","description":"","auth":{"type":"basic","basic":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"900e4b41-1396-4bba-adf3-0ac48e9ac304","id":"900e4b41-1396-4bba-adf3-0ac48e9ac304","name":"API Zoom&Buscapé","type":"collection"}}},{"name":"Busca pedidos","id":"caf8e0e6-01f1-43aa-af23-c402992e55ef","request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"http://merchant.zoom.com.br/api/merchant/orders?crtDateRngEnd=&crtDateRngStart=&date=&first=&modDateRngEnd=&modDateRngStart=&offset=&orderByDesc=&status=","description":"

      Este serviço permite que os lojistas busquem os pedidos feitos pelo Marketplace do Zoom&Buscapé. A busca dos pedidos pode ser paginada, sendo necessário efetuar chamadas indicando a página requerida. Além disso, pode ser filtrado por Status e data de criação do pedido. Os pedidos são sempre ordenados por data, em ordem crescente.

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

      Filtro por data de criação do pedido até a data no formato yyyy-MM-dd

      \n","type":"text/plain"},"key":"crtDateRngEnd","value":""},{"description":{"content":"

      Filtro por data de criação do pedido a partir de data no formato yyyy-MM-dd

      \n","type":"text/plain"},"key":"crtDateRngStart","value":""},{"description":{"content":"

      Filtro por data de criação do pedido no formato yyyy-MM-dd

      \n","type":"text/plain"},"key":"date","value":""},{"description":{"content":"

      Primeiro pedido da paginação

      \n","type":"text/plain"},"key":"first","value":""},{"description":{"content":"

      Filtro por data de última modificação do pedido até data no formato yyyy-MM-dd

      \n","type":"text/plain"},"key":"modDateRngEnd","value":""},{"description":{"content":"

      Filtro por data de última modificação do pedido a partir de data no formato yyyy-MM-dd

      \n","type":"text/plain"},"key":"modDateRngStart","value":""},{"description":{"content":"

      Quantidade de pedidos da paginação

      \n","type":"text/plain"},"key":"offset","value":""},{"description":{"content":"

      Ordenação do resultado

      \n","type":"text/plain"},"key":"orderByDesc","value":""},{"description":{"content":"

      Filtro por status do pedido

      \n","type":"text/plain"},"key":"status","value":""}],"variable":[]}},"response":[{"id":"7a208903-fe0a-4319-9703-d04840c81f98","name":"Lista de pedidos obtida com sucesso.","originalRequest":{"method":"GET","header":[],"url":{"raw":"http://merchant.zoom.com.br/api/merchant/orders?crtDateRngEnd=&crtDateRngStart=&date=&first=&modDateRngEnd=&modDateRngStart=&offset=&orderByDesc=&status=","host":["http://merchant.zoom.com.br/api/merchant"],"path":["orders"],"query":[{"key":"crtDateRngEnd","value":""},{"key":"crtDateRngStart","value":""},{"key":"date","value":""},{"key":"first","value":""},{"key":"modDateRngEnd","value":""},{"key":"modDateRngStart","value":""},{"key":"offset","value":""},{"key":"orderByDesc","value":""},{"key":"status","value":""}]}},"status":"OK","code":200,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"*/*"}],"cookie":[],"responseTime":null,"body":""},{"id":"dd86e0c9-0e84-4a37-ba79-40c874afc91b","name":"Ocorreu um erro ao validar os parâmetros da requisição.","originalRequest":{"method":"GET","header":[],"url":{"raw":"http://merchant.zoom.com.br/api/merchant/orders?crtDateRngEnd=&crtDateRngStart=&date=&first=&modDateRngEnd=&modDateRngStart=&offset=&orderByDesc=&status=","host":["http://merchant.zoom.com.br/api/merchant"],"path":["orders"],"query":[{"key":"crtDateRngEnd","value":""},{"key":"crtDateRngStart","value":""},{"key":"date","value":""},{"key":"first","value":""},{"key":"modDateRngEnd","value":""},{"key":"modDateRngStart","value":""},{"key":"offset","value":""},{"key":"orderByDesc","value":""},{"key":"status","value":""}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"*/*"}],"cookie":[],"responseTime":null,"body":""},{"id":"e066c1c5-f355-42cd-a5c3-5087840dab20","name":"Ocorreu um erro interno inesperado","originalRequest":{"method":"GET","header":[],"url":{"raw":"http://merchant.zoom.com.br/api/merchant/orders?crtDateRngEnd=&crtDateRngStart=&date=&first=&modDateRngEnd=&modDateRngStart=&offset=&orderByDesc=&status=","host":["http://merchant.zoom.com.br/api/merchant"],"path":["orders"],"query":[{"key":"crtDateRngEnd","value":""},{"key":"crtDateRngStart","value":""},{"key":"date","value":""},{"key":"first","value":""},{"key":"modDateRngEnd","value":""},{"key":"modDateRngStart","value":""},{"key":"offset","value":""},{"key":"orderByDesc","value":""},{"key":"status","value":""}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"*/*"}],"cookie":[],"responseTime":null,"body":""}],"_postman_id":"caf8e0e6-01f1-43aa-af23-c402992e55ef"},{"name":"Notificação de Pedido","id":"dc37a2d0-fbec-4c61-be33-2bc7ab9d6934","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{ \"orderNumber\": \"5015679200\",\r\n \"status\": \"New\" }\r\n\r\n'eventos possíveis: \"ApprovedPayment\" e \"Canceled\".\r\n"},"url":"{{URLNotificaçãoLoja}}","description":"

      Precisamos de um endpoint da loja também, pois implementamos do nosso lado um serviço de notificação de mudança de status do pedido. A URL do serviço de notificação será fornecida pelo Hub/Lojista.

      \n

      Em caso de atualização do pedido é executado um POST para esta URL no formato abaixo. A implementação deste serviço é opcional, mas permite ao Hub atualizar mais rapidamente as informações de estoque e o pedido para a loja:

      \n","auth":{"type":"basic","basic":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"900e4b41-1396-4bba-adf3-0ac48e9ac304","id":"900e4b41-1396-4bba-adf3-0ac48e9ac304","name":"API Zoom&Buscapé","type":"collection"}},"urlObject":{"host":["{{URLNotificaçãoLoja}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"dc37a2d0-fbec-4c61-be33-2bc7ab9d6934"}],"id":"d027fbaf-d72f-42a0-8933-ac58085a6c65","description":"

      Status dos pedidos

      \n
      \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
      STATUSSIGNIFICADO
      NewPedido realizado pelo cliente, porém pagamento ainda não foi aprovado
      ApprovedPaymentPagamento aprovado, loja deve começar operacionar o pedido
      ProcessedPedido em manuseio
      ShippedPedido já despachado para transportadora
      DeliveredPedido já entregue para cliente
      CanceledPedido Cancelado pelo Zoom&Buscapé ou pelo Cliente
      \n

      Fluxo do Pedido

      \n

      As mudanças de estado representadas por setas verdes e vermelhas são possíveis automaticamente por integração na API. As setas roxas representam alterações manuais que só podem ser realizadas via atendimento, sejam elas solicitadas pela loja ou pelo cliente.

      \n

      \"Fluxo

      \n

      O fluxo de pedido é gerado através de uma comunicação mútua entre as plataformas, será explicado em cada status o que ocorre e como deve ocorrer a comunicação. Abaixo temos uma imagem que exemplifica melhor o fluxo de cada status.

      \n

      \"Fluxo

      \n","event":[{"listen":"prerequest","script":{"id":"82c12c68-3f6b-4dde-b871-461ec562a3fc","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"bdba5098-c109-49bb-b0d5-daa1980df0cd","type":"text/javascript","exec":[""]}}],"_postman_id":"d027fbaf-d72f-42a0-8933-ac58085a6c65","auth":{"type":"basic","basic":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"900e4b41-1396-4bba-adf3-0ac48e9ac304","id":"900e4b41-1396-4bba-adf3-0ac48e9ac304","name":"API Zoom&Buscapé","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"}]}