{ "info": { "name": "API do Hotel das Lojas", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "description": "Preencha a variável chave com a sua chave hdl_live_..." }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{chave}}", "type": "string" } ] }, "variable": [ { "key": "base", "value": "https://api.hoteldaslojas.com.br/v1" }, { "key": "chave", "value": "hdl_live_0d89ec3f4713ce7ac670e12f14afb33e47194d0a12bba0da" } ], "item": [ { "name": "Loja", "item": [ { "name": "Obter Loja", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/loja", "host": [ "{{base}}" ], "path": [ "loja" ], "variable": [], "query": [] }, "description": "Retorna os dados da loja dona da chave. Escopo: loja.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/loja/obter-loja" } }, { "name": "Editar Loja", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/loja", "host": [ "{{base}}" ], "path": [ "loja" ], "variable": [], "query": [] }, "description": "Altera descrição, contatos e pedido mínimo. Escopo: loja.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/loja/editar-loja", "body": { "mode": "raw", "raw": "{\n \"pedido_minimo\": 30,\n \"contato\": {\n \"whatsapp\": \"41999990000\",\n \"instagram\": \"paginadobrada\"\n }\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Obter Chave", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/chave", "host": [ "{{base}}" ], "path": [ "chave" ], "variable": [], "query": [] }, "description": "Mostra a loja e os escopos da chave usada na chamada. Escopo: (qualquer chave). Docs: https://docs.hoteldaslojas.com.br/api-reference/loja/obter-chave" } } ] }, { "name": "Produtos", "item": [ { "name": "Listar Produtos", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/produtos", "host": [ "{{base}}" ], "path": [ "produtos" ], "variable": [], "query": [ { "key": "pagina", "value": "", "disabled": true, "description": "Página (padrão 1)." }, { "key": "por_pagina", "value": "", "disabled": true, "description": "Itens por página, de 1 a 100 (padrão 20)." }, { "key": "busca", "value": "", "disabled": true, "description": "Procura no nome, SKU e marca." }, { "key": "sku", "value": "", "disabled": true, "description": "SKU exato." }, { "key": "categoria_id", "value": "", "disabled": true, "description": "Só desta categoria." }, { "key": "ativo", "value": "", "disabled": true, "description": "true = só ativos, false = só desativados." }, { "key": "atualizado_desde", "value": "", "disabled": true, "description": "Só alterados a partir desta data (AAAA-MM-DD ou ISO 8601). Ideal para sincronizar." }, { "key": "ordem", "value": "", "disabled": true, "description": "id, -id (padrão), nome, preco, -preco, atualizado, -atualizado." } ] }, "description": "Lista os produtos da loja com filtros e paginação. Escopo: produtos.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/produtos/listar-produtos" } }, { "name": "Obter Produto", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/produtos/:id", "host": [ "{{base}}" ], "path": [ "produtos", ":id" ], "variable": [ { "key": "id", "value": "2291" } ], "query": [] }, "description": "Retorna um produto com imagens, estoque e variações. Escopo: produtos.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/produtos/obter-produto" } }, { "name": "Criar Produto", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/produtos", "host": [ "{{base}}" ], "path": [ "produtos" ], "variable": [], "query": [] }, "description": "Cadastra um produto novo no catálogo. Escopo: produtos.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/produtos/criar-produto", "body": { "mode": "raw", "raw": "{\n \"nome\": \"Camiseta Básica Algodão\",\n \"preco\": 79.9,\n \"preco_promocional\": 69.9,\n \"categoria_id\": 783,\n \"sku\": \"CAM-001\",\n \"marca\": \"Minha Marca\",\n \"estoque\": {\n \"controlado\": true,\n \"quantidade\": 25\n },\n \"peso_kg\": 0.3,\n \"variacoes\": [\n {\n \"nome\": \"Tamanho\",\n \"escolha_minima\": 1,\n \"escolha_maxima\": 1,\n \"opcoes\": [\n {\n \"nome\": \"P\"\n },\n {\n \"nome\": \"M\"\n },\n {\n \"nome\": \"G\",\n \"valor_adicional\": 5\n }\n ]\n }\n ]\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Editar Produto", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/produtos/:id", "host": [ "{{base}}" ], "path": [ "produtos", ":id" ], "variable": [ { "key": "id", "value": "2291" } ], "query": [] }, "description": "Altera só os campos enviados. Escopo: produtos.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/produtos/editar-produto", "body": { "mode": "raw", "raw": "{\n \"preco\": 89.9,\n \"preco_promocional\": null,\n \"ativo\": true\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Listar Imagens", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/produtos/:id/imagens", "host": [ "{{base}}" ], "path": [ "produtos", ":id", "imagens" ], "variable": [ { "key": "id", "value": "2291" } ], "query": [] }, "description": "Imagens do produto: a principal (id 0) e a galeria. Escopo: produtos.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/produtos/listar-imagens" } }, { "name": "Enviar Imagem", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/produtos/:id/imagens", "host": [ "{{base}}" ], "path": [ "produtos", ":id", "imagens" ], "variable": [ { "key": "id", "value": "2291" } ], "query": [] }, "description": "Envia uma foto por URL pública ou em base64. Escopo: produtos.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/produtos/enviar-imagem", "body": { "mode": "raw", "raw": "{\n \"url\": \"https://cdn.seuerp.com.br/fotos/cam-001-frente.jpg\",\n \"principal\": true\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Tornar Imagem Principal", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/produtos/:id/imagens/{imagem_id}", "host": [ "{{base}}" ], "path": [ "produtos", ":id", "imagens", "{imagem_id}" ], "variable": [ { "key": "id", "value": "2291" } ], "query": [] }, "description": "Troca a imagem de capa do produto. Escopo: produtos.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/produtos/imagem-principal", "body": { "mode": "raw", "raw": "{\n \"principal\": true\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Remover Imagem", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/produtos/:id/imagens/{imagem_id}", "host": [ "{{base}}" ], "path": [ "produtos", ":id", "imagens", "{imagem_id}" ], "variable": [ { "key": "id", "value": "2291" } ], "query": [] }, "description": "Tira a imagem do produto. Escopo: produtos.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/produtos/apagar-imagem" } }, { "name": "Alterar Produtos em Lote", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/produtos/lote", "host": [ "{{base}}" ], "path": [ "produtos", "lote" ], "variable": [], "query": [] }, "description": "Muda preço, promoção e situação de até 100 produtos numa chamada. Escopo: produtos.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/produtos/produtos-lote", "body": { "mode": "raw", "raw": "{\n \"itens\": [\n {\n \"sku\": \"LIV-001\",\n \"preco\": 64.9,\n \"preco_promocional\": 54.9\n },\n {\n \"id\": 2292,\n \"ativo\": false\n },\n {\n \"sku\": \"NAO-EXISTE\",\n \"preco\": 10\n }\n ]\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Obter Kit", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/produtos/:id/kit", "host": [ "{{base}}" ], "path": [ "produtos", ":id", "kit" ], "variable": [ { "key": "id", "value": "2291" } ], "query": [] }, "description": "Componentes do produto vendido como kit. Escopo: produtos.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/produtos/obter-kit" } }, { "name": "Definir Kit", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/produtos/:id/kit", "host": [ "{{base}}" ], "path": [ "produtos", ":id", "kit" ], "variable": [ { "key": "id", "value": "2291" } ], "query": [] }, "description": "Define os componentes (vender o kit baixa os componentes). Escopo: produtos.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/produtos/gravar-kit", "body": { "mode": "raw", "raw": "{\n \"componentes\": [\n {\n \"sku\": \"LIV-001\",\n \"quantidade\": 1\n },\n {\n \"sku\": \"ACE-004\",\n \"quantidade\": 2\n }\n ]\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Produtos de Dropshipping", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/dropshipping/produtos", "host": [ "{{base}}" ], "path": [ "dropshipping", "produtos" ], "variable": [], "query": [ { "key": "pagina", "value": "", "disabled": true, "description": "Página (padrão 1)." }, { "key": "por_pagina", "value": "", "disabled": true, "description": "Itens por página, de 1 a 100 (padrão 20)." } ] }, "description": "Produtos importados do AliExpress com custo e SKU do fornecedor. Escopo: produtos.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/produtos/dropshipping-produtos" } }, { "name": "Duplicar Produto", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/produtos/:id/duplicar", "host": [ "{{base}}" ], "path": [ "produtos", ":id", "duplicar" ], "variable": [ { "key": "id", "value": "2291" } ], "query": [] }, "description": "Copia dados, variações e imagens. Escopo: produtos.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/produtos/duplicar-produto", "body": { "mode": "raw", "raw": "{\n \"sku\": \"LIV-001-BOX\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Sincronizar com Marketplaces", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/marketplaces/sincronizar", "host": [ "{{base}}" ], "path": [ "marketplaces", "sincronizar" ], "variable": [], "query": [] }, "description": "Reenvia preço, estoque e dados aos canais (ou publica/despublica). Escopo: produtos.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/produtos/sincronizar-marketplaces", "body": { "mode": "raw", "raw": "{\n \"produtos\": [\n 2291,\n 2292\n ],\n \"canal\": \"mercadolivre\",\n \"publicar\": true\n}", "options": { "raw": { "language": "json" } } } } } ] }, { "name": "Estoque", "item": [ { "name": "Obter Estoque", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/produtos/:id/estoque", "host": [ "{{base}}" ], "path": [ "produtos", ":id", "estoque" ], "variable": [ { "key": "id", "value": "2291" } ], "query": [] }, "description": "Saldo do produto e de cada opção de variação. Escopo: produtos.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/estoque/obter-estoque" } }, { "name": "Ajustar Estoque", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/produtos/:id/estoque", "host": [ "{{base}}" ], "path": [ "produtos", ":id", "estoque" ], "variable": [ { "key": "id", "value": "2291" } ], "query": [] }, "description": "Soma, subtrai ou define a quantidade em estoque. Escopo: estoque.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/estoque/ajustar-estoque", "body": { "mode": "raw", "raw": "{\n \"operacao\": \"subtrair\",\n \"quantidade\": 2,\n \"motivo\": \"Venda no balcão\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Estoque por Variação", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/produtos/:id/estoque/variacoes", "host": [ "{{base}}" ], "path": [ "produtos", ":id", "estoque", "variacoes" ], "variable": [ { "key": "id", "value": "2291" } ], "query": [] }, "description": "Define o saldo de cada opção (tamanho, cor...). Escopo: estoque.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/estoque/estoque-variacoes", "body": { "mode": "raw", "raw": "{\n \"itens\": [\n {\n \"variacao\": \"Tamanho\",\n \"opcao\": \"M\",\n \"quantidade\": 8,\n \"sku\": \"CAM-001-M\"\n },\n {\n \"variacao\": \"Tamanho\",\n \"opcao\": \"G\",\n \"quantidade\": 0\n }\n ]\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Estoque em Lote", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/estoque/lote", "host": [ "{{base}}" ], "path": [ "estoque", "lote" ], "variable": [], "query": [] }, "description": "Define o saldo de até 100 produtos ou opções de variação. Escopo: estoque.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/estoque/estoque-lote", "body": { "mode": "raw", "raw": "{\n \"motivo\": \"Inventário do ERP\",\n \"itens\": [\n {\n \"sku\": \"LIV-001\",\n \"quantidade\": 12\n },\n {\n \"produto_id\": 2291,\n \"variacao\": \"Capa\",\n \"opcao\": \"Dura\",\n \"quantidade\": 4\n }\n ]\n}", "options": { "raw": { "language": "json" } } } } } ] }, { "name": "Categorias", "item": [ { "name": "Listar Categorias", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/categorias", "host": [ "{{base}}" ], "path": [ "categorias" ], "variable": [], "query": [ { "key": "pagina", "value": "", "disabled": true, "description": "Página (padrão 1)." }, { "key": "por_pagina", "value": "", "disabled": true, "description": "Itens por página, de 1 a 100 (padrão 20)." }, { "key": "pai_id", "value": "", "disabled": true, "description": "Só as filhas desta categoria (0 = raiz)." } ] }, "description": "Lista as categorias em ordem de exibição. Escopo: categorias.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/categorias/listar-categorias" } }, { "name": "Obter Categoria", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/categorias/:id", "host": [ "{{base}}" ], "path": [ "categorias", ":id" ], "variable": [ { "key": "id", "value": "783" } ], "query": [] }, "description": "Retorna uma categoria. Escopo: categorias.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/categorias/obter-categoria" } }, { "name": "Criar Categoria", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/categorias", "host": [ "{{base}}" ], "path": [ "categorias" ], "variable": [], "query": [] }, "description": "Cadastra uma categoria nova. Escopo: categorias.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/categorias/criar-categoria", "body": { "mode": "raw", "raw": "{\n \"nome\": \"Lançamentos\",\n \"ordem\": 1\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Editar Categoria", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/categorias/:id", "host": [ "{{base}}" ], "path": [ "categorias", ":id" ], "variable": [ { "key": "id", "value": "783" } ], "query": [] }, "description": "Altera só os campos enviados. Escopo: categorias.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/categorias/editar-categoria", "body": { "mode": "raw", "raw": "{\n \"visivel\": false\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Apagar Categoria", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/categorias/:id", "host": [ "{{base}}" ], "path": [ "categorias", ":id" ], "variable": [ { "key": "id", "value": "783" } ], "query": [] }, "description": "Remove uma categoria vazia. Escopo: categorias.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/categorias/apagar-categoria" } } ] }, { "name": "Pedidos", "item": [ { "name": "Listar Pedidos", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/pedidos", "host": [ "{{base}}" ], "path": [ "pedidos" ], "variable": [], "query": [ { "key": "pagina", "value": "", "disabled": true, "description": "Página (padrão 1)." }, { "key": "por_pagina", "value": "", "disabled": true, "description": "Itens por página, de 1 a 100 (padrão 20)." }, { "key": "status", "value": "", "disabled": true, "description": "Um ou mais, separados por vírgula: pendente, pago, aceito, enviado, pronto_retirada, concluido, cancelado, reembolsado." }, { "key": "situacao_pagamento", "value": "", "disabled": true, "description": "pendente, em_analise, aprovado, recusado, estornado, cancelado." }, { "key": "desde", "value": "", "disabled": true, "description": "Compras a partir desta data." }, { "key": "ate", "value": "", "disabled": true, "description": "Compras até esta data." }, { "key": "cliente_id", "value": "", "disabled": true, "description": "Pedidos de um cliente." }, { "key": "email", "value": "", "disabled": true, "description": "Pedidos deste e-mail." }, { "key": "id_maior_que", "value": "", "disabled": true, "description": "Só pedidos com número maior (importação incremental)." }, { "key": "ordem", "value": "", "disabled": true, "description": "id (mais antigos primeiro) ou padrão (mais novos primeiro)." }, { "key": "incluir_itens", "value": "", "disabled": true, "description": "true traz itens, notas e histórico em cada pedido." } ] }, "description": "Lista os pedidos com filtros por status, data e cliente. Escopo: pedidos.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/pedidos/listar-pedidos" } }, { "name": "Obter Pedido", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/pedidos/:id", "host": [ "{{base}}" ], "path": [ "pedidos", ":id" ], "variable": [ { "key": "id", "value": "2178" } ], "query": [] }, "description": "Retorna o pedido com itens, endereço, valores e histórico. Escopo: pedidos.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/pedidos/obter-pedido" } }, { "name": "Mudar Status do Pedido", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/pedidos/:id/status", "host": [ "{{base}}" ], "path": [ "pedidos", ":id", "status" ], "variable": [ { "key": "id", "value": "2178" } ], "query": [] }, "description": "Avança o pedido (pago, aceito, enviado, pronto para retirada, concluído) ou cancela. Escopo: pedidos.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/pedidos/mudar-status", "body": { "mode": "raw", "raw": "{\n \"status\": \"enviado\",\n \"observacao\": \"Despachado pela transportadora\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Informar Rastreio", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/pedidos/:id/rastreio", "host": [ "{{base}}" ], "path": [ "pedidos", ":id", "rastreio" ], "variable": [ { "key": "id", "value": "2178" } ], "query": [] }, "description": "Grava ou remove o código de rastreio. Escopo: pedidos.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/pedidos/rastreio", "body": { "mode": "raw", "raw": "{\n \"codigo\": \"AA123456789BR\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Adicionar Nota Interna", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/pedidos/:id/notas", "host": [ "{{base}}" ], "path": [ "pedidos", ":id", "notas" ], "variable": [ { "key": "id", "value": "2178" } ], "query": [] }, "description": "Acrescenta uma nota interna ao pedido (o cliente não vê). Escopo: pedidos.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/pedidos/adicionar-nota", "body": { "mode": "raw", "raw": "{\n \"texto\": \"NF-e 1234 emitida pelo ERP\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Criar Pedido", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/pedidos", "host": [ "{{base}}" ], "path": [ "pedidos" ], "variable": [], "query": [] }, "description": "Registra uma venda feita fora da loja (marketplace, balcão, outro sistema). Escopo: pedidos.criar. Docs: https://docs.hoteldaslojas.com.br/api-reference/pedidos/criar-pedido", "body": { "mode": "raw", "raw": "{\n \"referencia_externa\": \"ML-2000009876543\",\n \"cliente\": {\n \"nome\": \"Marina Duarte\",\n \"email\": \"marina@exemplo.com.br\",\n \"whatsapp\": \"41999990000\"\n },\n \"itens\": [\n {\n \"sku\": \"LIV-001\",\n \"quantidade\": 3\n },\n {\n \"nome\": \"Embalagem presente\",\n \"preco_unitario\": 5\n }\n ],\n \"entrega\": {\n \"forma\": \"Transportadora X\",\n \"valor\": 15,\n \"endereco\": {\n \"cep\": \"01310100\",\n \"rua\": \"Av. Paulista\",\n \"numero\": \"1000\",\n \"bairro\": \"Bela Vista\",\n \"cidade\": \"São Paulo\",\n \"estado\": \"SP\"\n }\n },\n \"desconto\": 3,\n \"pagamento\": {\n \"forma\": \"Pix no balcão\",\n \"situacao\": \"pago\"\n }\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Pagamentos do Pedido", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/pedidos/:id/pagamentos", "host": [ "{{base}}" ], "path": [ "pedidos", ":id", "pagamentos" ], "variable": [ { "key": "id", "value": "2178" } ], "query": [] }, "description": "Transações e avisos recebidos dos meios de pagamento. Escopo: pedidos.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/pedidos/pagamentos-pedido" } }, { "name": "Obter Nota Fiscal", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/pedidos/:id/nota-fiscal", "host": [ "{{base}}" ], "path": [ "pedidos", ":id", "nota-fiscal" ], "variable": [ { "key": "id", "value": "2178" } ], "query": [] }, "description": "Nota fiscal informada para o pedido. Escopo: pedidos.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/pedidos/obter-nota-fiscal" } }, { "name": "Informar Nota Fiscal", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/pedidos/:id/nota-fiscal", "host": [ "{{base}}" ], "path": [ "pedidos", ":id", "nota-fiscal" ], "variable": [ { "key": "id", "value": "2178" } ], "query": [] }, "description": "Grava ou substitui a NF-e do pedido (emitida no seu emissor). Escopo: pedidos.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/pedidos/informar-nota-fiscal", "body": { "mode": "raw", "raw": "{\n \"numero\": \"1234\",\n \"serie\": \"1\",\n \"chave\": \"35261012345678000199550010000012341000012345\",\n \"valor\": 196.7,\n \"url_danfe\": \"https://erp.exemplo.com.br/nfe/1234.pdf\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Remover Nota Fiscal", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/pedidos/:id/nota-fiscal", "host": [ "{{base}}" ], "path": [ "pedidos", ":id", "nota-fiscal" ], "variable": [ { "key": "id", "value": "2178" } ], "query": [] }, "description": "Tira a nota fiscal do pedido (ex.: nota cancelada). Escopo: pedidos.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/pedidos/apagar-nota-fiscal" } }, { "name": "Rastreamento do Pedido", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/pedidos/:id/rastreamento", "host": [ "{{base}}" ], "path": [ "pedidos", ":id", "rastreamento" ], "variable": [ { "key": "id", "value": "2178" } ], "query": [] }, "description": "Linha do tempo da entrega (Correios). Escopo: pedidos.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/pedidos/rastreamento" } }, { "name": "Dropshipping do Pedido", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/pedidos/:id/dropshipping", "host": [ "{{base}}" ], "path": [ "pedidos", ":id", "dropshipping" ], "variable": [ { "key": "id", "value": "2178" } ], "query": [] }, "description": "Situação do pedido no fornecedor (AliExpress). Escopo: pedidos.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/pedidos/dropshipping-pedido" } } ] }, { "name": "Pagamentos", "item": [ { "name": "Meios de Pagamento", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/pagamentos/meios", "host": [ "{{base}}" ], "path": [ "pagamentos", "meios" ], "variable": [], "query": [] }, "description": "Aplicativos de pagamento instalados e formas da própria loja. Escopo: pagamentos.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/pagamentos/meios-pagamento" } }, { "name": "Gerar Link de Pagamento", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/pedidos/:id/cobranca", "host": [ "{{base}}" ], "path": [ "pedidos", ":id", "cobranca" ], "variable": [ { "key": "id", "value": "2178" } ], "query": [] }, "description": "Cria a cobrança no meio escolhido e devolve o link para o cliente pagar. Escopo: pagamentos.cobrar. Docs: https://docs.hoteldaslojas.com.br/api-reference/pagamentos/gerar-cobranca", "body": { "mode": "raw", "raw": "{\n \"meio\": \"asaas\"\n}", "options": { "raw": { "language": "json" } } } } } ] }, { "name": "Clientes", "item": [ { "name": "Listar Clientes", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/clientes", "host": [ "{{base}}" ], "path": [ "clientes" ], "variable": [], "query": [ { "key": "pagina", "value": "", "disabled": true, "description": "Página (padrão 1)." }, { "key": "por_pagina", "value": "", "disabled": true, "description": "Itens por página, de 1 a 100 (padrão 20)." }, { "key": "busca", "value": "", "disabled": true, "description": "Nome, e-mail ou WhatsApp." }, { "key": "email", "value": "", "disabled": true, "description": "E-mail exato." }, { "key": "criado_desde", "value": "", "disabled": true, "description": "Cadastrados a partir desta data." } ] }, "description": "Lista os clientes cadastrados. Escopo: clientes.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/clientes/listar-clientes" } }, { "name": "Obter Cliente", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/clientes/:id", "host": [ "{{base}}" ], "path": [ "clientes", ":id" ], "variable": [ { "key": "id", "value": "512" } ], "query": [] }, "description": "Retorna um cliente. Escopo: clientes.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/clientes/obter-cliente" } }, { "name": "Cadastrar Cliente", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/clientes", "host": [ "{{base}}" ], "path": [ "clientes" ], "variable": [], "query": [] }, "description": "Cadastra um cliente na loja. Escopo: clientes.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/clientes/criar-cliente", "body": { "mode": "raw", "raw": "{\n \"nome\": \"Marina Duarte\",\n \"whatsapp\": \"41999990000\",\n \"email\": \"marina@exemplo.com.br\",\n \"tags\": [\n \"atacado\"\n ]\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Editar Cliente", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/clientes/:id", "host": [ "{{base}}" ], "path": [ "clientes", ":id" ], "variable": [ { "key": "id", "value": "512" } ], "query": [] }, "description": "Altera só os campos enviados. Escopo: clientes.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/clientes/editar-cliente", "body": { "mode": "raw", "raw": "{\n \"tags\": [\n \"vip\",\n \"atacado\"\n ],\n \"documento\": \"12345678909\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Listar Endereços", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/clientes/:id/enderecos", "host": [ "{{base}}" ], "path": [ "clientes", ":id", "enderecos" ], "variable": [ { "key": "id", "value": "512" } ], "query": [] }, "description": "Endereços salvos na conta do cliente. Escopo: clientes.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/clientes/listar-enderecos" } }, { "name": "Adicionar Endereço", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/clientes/:id/enderecos", "host": [ "{{base}}" ], "path": [ "clientes", ":id", "enderecos" ], "variable": [ { "key": "id", "value": "512" } ], "query": [] }, "description": "Salva um endereço na conta do cliente. Escopo: clientes.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/clientes/criar-endereco", "body": { "mode": "raw", "raw": "{\n \"apelido\": \"Casa\",\n \"cep\": \"01310100\",\n \"rua\": \"Av. Paulista\",\n \"numero\": \"1000\",\n \"complemento\": \"Ap 5\",\n \"bairro\": \"Bela Vista\",\n \"cidade\": \"São Paulo\",\n \"estado\": \"SP\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Editar Endereço", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/clientes/:id/enderecos/{endereco_id}", "host": [ "{{base}}" ], "path": [ "clientes", ":id", "enderecos", "{endereco_id}" ], "variable": [ { "key": "id", "value": "512" } ], "query": [] }, "description": "Altera só os campos enviados. Escopo: clientes.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/clientes/editar-endereco", "body": { "mode": "raw", "raw": "{\n \"complemento\": \"Ap 52\",\n \"padrao\": true\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Remover Endereço", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/clientes/:id/enderecos/{endereco_id}", "host": [ "{{base}}" ], "path": [ "clientes", ":id", "enderecos", "{endereco_id}" ], "variable": [ { "key": "id", "value": "512" } ], "query": [] }, "description": "Apaga um endereço do cliente. Escopo: clientes.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/clientes/apagar-endereco" } }, { "name": "Listar Favoritos", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/clientes/:id/favoritos", "host": [ "{{base}}" ], "path": [ "clientes", ":id", "favoritos" ], "variable": [ { "key": "id", "value": "512" } ], "query": [] }, "description": "Produtos que o cliente marcou como favoritos. Escopo: clientes.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/clientes/favoritos" } }, { "name": "Histórico do Cliente", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/clientes/:id/historico", "host": [ "{{base}}" ], "path": [ "clientes", ":id", "historico" ], "variable": [ { "key": "id", "value": "512" } ], "query": [ { "key": "pagina", "value": "", "disabled": true, "description": "Página (padrão 1)." }, { "key": "por_pagina", "value": "", "disabled": true, "description": "Itens por página, de 1 a 100 (padrão 20)." } ] }, "description": "Alterações no cadastro: campo, antes, depois e quem mudou. Escopo: clientes.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/clientes/historico-cliente" } } ] }, { "name": "Frete", "item": [ { "name": "Cotar Frete", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/frete/cotacao", "host": [ "{{base}}" ], "path": [ "frete", "cotacao" ], "variable": [], "query": [] }, "description": "As mesmas opções de entrega que o cliente vê no carrinho. Escopo: frete.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/frete/cotar-frete", "body": { "mode": "raw", "raw": "{\n \"cep\": \"01310100\",\n \"itens\": [\n {\n \"sku\": \"LIV-001\",\n \"quantidade\": 2\n }\n ]\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Listar Faixas de CEP", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/frete/faixas-cep", "host": [ "{{base}}" ], "path": [ "frete", "faixas-cep" ], "variable": [], "query": [ { "key": "pagina", "value": "", "disabled": true, "description": "Página (padrão 1)." }, { "key": "por_pagina", "value": "", "disabled": true, "description": "Itens por página, de 1 a 100 (padrão 20)." } ] }, "description": "Tabela de frete própria da loja. Escopo: frete.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/frete/listar-faixas" } }, { "name": "Obter Faixa de CEP", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/frete/faixas-cep/:id", "host": [ "{{base}}" ], "path": [ "frete", "faixas-cep", ":id" ], "variable": [ { "key": "id", "value": "149" } ], "query": [] }, "description": "Retorna uma faixa. Escopo: frete.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/frete/obter-faixa" } }, { "name": "Criar Faixa de CEP", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/frete/faixas-cep", "host": [ "{{base}}" ], "path": [ "frete", "faixas-cep" ], "variable": [], "query": [] }, "description": "Cria uma faixa de CEP com valor e prazo. Escopo: frete.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/frete/criar-faixa", "body": { "mode": "raw", "raw": "{\n \"nome\": \"Capital SP\",\n \"cep_inicio\": \"01000000\",\n \"cep_fim\": \"05999999\",\n \"valor\": 12.5,\n \"prazo_dias\": 2,\n \"gratis_acima\": 199\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Editar Faixa de CEP", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/frete/faixas-cep/:id", "host": [ "{{base}}" ], "path": [ "frete", "faixas-cep", ":id" ], "variable": [ { "key": "id", "value": "149" } ], "query": [] }, "description": "Altera só os campos enviados. Escopo: frete.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/frete/editar-faixa", "body": { "mode": "raw", "raw": "{\n \"valor\": 10\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Apagar Faixa de CEP", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/frete/faixas-cep/:id", "host": [ "{{base}}" ], "path": [ "frete", "faixas-cep", ":id" ], "variable": [ { "key": "id", "value": "149" } ], "query": [] }, "description": "Remove a faixa. Escopo: frete.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/frete/apagar-faixa" } }, { "name": "Listar Entrega Local", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/frete/entrega-local", "host": [ "{{base}}" ], "path": [ "frete", "entrega-local" ], "variable": [], "query": [ { "key": "pagina", "value": "", "disabled": true, "description": "Página (padrão 1)." }, { "key": "por_pagina", "value": "", "disabled": true, "description": "Itens por página, de 1 a 100 (padrão 20)." }, { "key": "tipo", "value": "", "disabled": true, "description": "taxa_regiao ou outra_opcao." } ] }, "description": "Taxas por região e outras opções de entrega ou retirada. Escopo: frete.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/frete/listar-entrega-local" } }, { "name": "Criar Entrega Local", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/frete/entrega-local", "host": [ "{{base}}" ], "path": [ "frete", "entrega-local" ], "variable": [], "query": [] }, "description": "Cria uma taxa por região ou outra opção de entrega. Escopo: frete.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/frete/criar-entrega-local", "body": { "mode": "raw", "raw": "{\n \"nome\": \"Retirada no shopping\",\n \"valor\": 0,\n \"tipo\": \"outra_opcao\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Editar Entrega Local", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/frete/entrega-local/:id", "host": [ "{{base}}" ], "path": [ "frete", "entrega-local", ":id" ], "variable": [ { "key": "id", "value": "77" } ], "query": [] }, "description": "Altera só os campos enviados. Escopo: frete.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/frete/editar-entrega-local", "body": { "mode": "raw", "raw": "{\n \"valor\": 5\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Apagar Entrega Local", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/frete/entrega-local/:id", "host": [ "{{base}}" ], "path": [ "frete", "entrega-local", ":id" ], "variable": [ { "key": "id", "value": "77" } ], "query": [] }, "description": "Remove a opção. Escopo: frete.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/frete/apagar-entrega-local" } } ] }, { "name": "Cupons", "item": [ { "name": "Listar Cupons", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/cupons", "host": [ "{{base}}" ], "path": [ "cupons" ], "variable": [], "query": [ { "key": "pagina", "value": "", "disabled": true, "description": "Página (padrão 1)." }, { "key": "por_pagina", "value": "", "disabled": true, "description": "Itens por página, de 1 a 100 (padrão 20)." }, { "key": "codigo", "value": "", "disabled": true, "description": "Código exato." } ] }, "description": "Lista os cupons de desconto. Escopo: cupons.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/cupons/listar-cupons" } }, { "name": "Obter Cupom", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/cupons/:id", "host": [ "{{base}}" ], "path": [ "cupons", ":id" ], "variable": [ { "key": "id", "value": "381" } ], "query": [] }, "description": "Retorna um cupom. Escopo: cupons.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/cupons/obter-cupom" } }, { "name": "Criar Cupom", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/cupons", "host": [ "{{base}}" ], "path": [ "cupons" ], "variable": [], "query": [] }, "description": "Cria um cupom de desconto. Escopo: cupons.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/cupons/criar-cupom", "body": { "mode": "raw", "raw": "{\n \"codigo\": \"VOLTA15\",\n \"tipo\": \"porcentagem\",\n \"valor\": 15,\n \"quantidade_disponivel\": 100,\n \"validade\": \"2026-12-31\",\n \"pedido_minimo\": 150\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Editar Cupom", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/cupons/:id", "host": [ "{{base}}" ], "path": [ "cupons", ":id" ], "variable": [ { "key": "id", "value": "381" } ], "query": [] }, "description": "Altera só os campos enviados. Escopo: cupons.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/cupons/editar-cupom", "body": { "mode": "raw", "raw": "{\n \"quantidade_disponivel\": 50,\n \"validade\": \"2027-01-31\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Apagar Cupom", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/cupons/:id", "host": [ "{{base}}" ], "path": [ "cupons", ":id" ], "variable": [ { "key": "id", "value": "381" } ], "query": [] }, "description": "Remove o cupom (pedidos que já usaram não mudam). Escopo: cupons.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/cupons/apagar-cupom" } }, { "name": "Usos do Cupom", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/cupons/:id/usos", "host": [ "{{base}}" ], "path": [ "cupons", ":id", "usos" ], "variable": [ { "key": "id", "value": "381" } ], "query": [ { "key": "pagina", "value": "", "disabled": true, "description": "Página (padrão 1)." }, { "key": "por_pagina", "value": "", "disabled": true, "description": "Itens por página, de 1 a 100 (padrão 20)." } ] }, "description": "Pedidos em que o cupom foi usado. Escopo: cupons.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/cupons/usos-cupom" } } ] }, { "name": "Marketing", "item": [ { "name": "Carrinhos Abandonados", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/carrinhos", "host": [ "{{base}}" ], "path": [ "carrinhos" ], "variable": [], "query": [ { "key": "pagina", "value": "", "disabled": true, "description": "Página (padrão 1)." }, { "key": "por_pagina", "value": "", "disabled": true, "description": "Itens por página, de 1 a 100 (padrão 20)." }, { "key": "desde", "value": "", "disabled": true, "description": "Atualizados a partir desta data." }, { "key": "cliente_id", "value": "", "disabled": true, "description": "" } ] }, "description": "Sacolas de clientes com conta paradas há mais de 1 hora. Escopo: marketing.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/marketing/listar-carrinhos" } }, { "name": "Obter Carrinho", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/carrinhos/:id", "host": [ "{{base}}" ], "path": [ "carrinhos", ":id" ], "variable": [ { "key": "id", "value": "31" } ], "query": [] }, "description": "Retorna um carrinho. Escopo: marketing.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/marketing/obter-carrinho" } }, { "name": "Listar Newsletter", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/newsletter", "host": [ "{{base}}" ], "path": [ "newsletter" ], "variable": [], "query": [ { "key": "pagina", "value": "", "disabled": true, "description": "Página (padrão 1)." }, { "key": "por_pagina", "value": "", "disabled": true, "description": "Itens por página, de 1 a 100 (padrão 20)." }, { "key": "situacao", "value": "", "disabled": true, "description": "confirmado, aguardando_confirmacao ou descadastrado." }, { "key": "email", "value": "", "disabled": true, "description": "" } ] }, "description": "E-mails inscritos para receber novidades. Escopo: marketing.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/marketing/listar-newsletter" } }, { "name": "Inscrever na Newsletter", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/newsletter", "host": [ "{{base}}" ], "path": [ "newsletter" ], "variable": [], "query": [] }, "description": "Inscreve um e-mail (a pessoa confirma pelo e-mail). Escopo: marketing.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/marketing/inscrever-newsletter", "body": { "mode": "raw", "raw": "{\n \"email\": \"leitor@exemplo.com.br\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Descadastrar da Newsletter", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/newsletter/:id", "host": [ "{{base}}" ], "path": [ "newsletter", ":id" ], "variable": [ { "key": "id", "value": "14" } ], "query": [] }, "description": "Marca o e-mail como descadastrado. Escopo: marketing.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/marketing/remover-newsletter" } }, { "name": "Listar Promoções", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/promocoes", "host": [ "{{base}}" ], "path": [ "promocoes" ], "variable": [], "query": [ { "key": "pagina", "value": "", "disabled": true, "description": "Página (padrão 1)." }, { "key": "por_pagina", "value": "", "disabled": true, "description": "Itens por página, de 1 a 100 (padrão 20)." } ] }, "description": "Promoções automáticas do carrinho. Escopo: marketing.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/marketing/listar-promocoes" } }, { "name": "Obter Promoção", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/promocoes/:id", "host": [ "{{base}}" ], "path": [ "promocoes", ":id" ], "variable": [ { "key": "id", "value": "98" } ], "query": [] }, "description": "Retorna uma promoção. Escopo: marketing.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/marketing/obter-promocao" } }, { "name": "Criar Promoção", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/promocoes", "host": [ "{{base}}" ], "path": [ "promocoes" ], "variable": [], "query": [] }, "description": "Leve X pague Y, desconto por quantidade ou acima de um valor. Escopo: marketing.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/marketing/criar-promocao", "body": { "mode": "raw", "raw": "{\n \"nome\": \"Leve 3 pague 2\",\n \"tipo\": \"leve_pague\",\n \"leve\": 3,\n \"pague\": 2,\n \"fim\": \"2026-11-30T23:59:59-03:00\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Editar Promoção", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/promocoes/:id", "host": [ "{{base}}" ], "path": [ "promocoes", ":id" ], "variable": [ { "key": "id", "value": "98" } ], "query": [] }, "description": "Altera só os campos enviados. Escopo: marketing.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/marketing/editar-promocao", "body": { "mode": "raw", "raw": "{\n \"ativo\": false\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Apagar Promoção", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/promocoes/:id", "host": [ "{{base}}" ], "path": [ "promocoes", ":id" ], "variable": [ { "key": "id", "value": "98" } ], "query": [] }, "description": "Remove a promoção. Escopo: marketing.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/marketing/apagar-promocao" } }, { "name": "Avisos de Estoque", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/avisos-estoque", "host": [ "{{base}}" ], "path": [ "avisos-estoque" ], "variable": [], "query": [ { "key": "pagina", "value": "", "disabled": true, "description": "Página (padrão 1)." }, { "key": "por_pagina", "value": "", "disabled": true, "description": "Itens por página, de 1 a 100 (padrão 20)." }, { "key": "produto_id", "value": "", "disabled": true, "description": "" }, { "key": "pendentes", "value": "", "disabled": true, "description": "true = só quem ainda não foi avisado." } ] }, "description": "Pedidos de \"avise-me quando chegar\". Escopo: marketing.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/marketing/avisos-estoque" } } ] }, { "name": "Fidelidade", "item": [ { "name": "Saldo de Cashback", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/clientes/:id/cashback", "host": [ "{{base}}" ], "path": [ "clientes", ":id", "cashback" ], "variable": [ { "key": "id", "value": "512" } ], "query": [] }, "description": "Saldo e extrato de cashback do cliente. Escopo: fidelidade.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/fidelidade/obter-cashback" } }, { "name": "Lançar Cashback", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/clientes/:id/cashback", "host": [ "{{base}}" ], "path": [ "clientes", ":id", "cashback" ], "variable": [ { "key": "id", "value": "512" } ], "query": [] }, "description": "Crédito (bônus) ou débito manual no saldo do cliente. Escopo: fidelidade.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/fidelidade/lancar-cashback", "body": { "mode": "raw", "raw": "{\n \"tipo\": \"credito\",\n \"valor\": 20,\n \"validade_dias\": 60\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Listar Cartões-presente", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/cartoes-presente", "host": [ "{{base}}" ], "path": [ "cartoes-presente" ], "variable": [], "query": [ { "key": "pagina", "value": "", "disabled": true, "description": "Página (padrão 1)." }, { "key": "por_pagina", "value": "", "disabled": true, "description": "Itens por página, de 1 a 100 (padrão 20)." }, { "key": "codigo", "value": "", "disabled": true, "description": "" }, { "key": "email", "value": "", "disabled": true, "description": "" } ] }, "description": "Cartões emitidos e saldos. Escopo: fidelidade.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/fidelidade/listar-cartoes" } }, { "name": "Obter Cartão-presente", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/cartoes-presente/:id", "host": [ "{{base}}" ], "path": [ "cartoes-presente", ":id" ], "variable": [ { "key": "id", "value": "2" } ], "query": [] }, "description": "Retorna um cartão. Escopo: fidelidade.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/fidelidade/obter-cartao" } }, { "name": "Emitir Cartão-presente", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/cartoes-presente", "host": [ "{{base}}" ], "path": [ "cartoes-presente" ], "variable": [], "query": [] }, "description": "Gera um código com saldo (enviado por e-mail). Escopo: fidelidade.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/fidelidade/emitir-cartao", "body": { "mode": "raw", "raw": "{\n \"valor\": 50,\n \"email\": \"presenteado@exemplo.com.br\",\n \"nome\": \"Joana\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Cancelar Cartão-presente", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/cartoes-presente/:id", "host": [ "{{base}}" ], "path": [ "cartoes-presente", ":id" ], "variable": [ { "key": "id", "value": "2" } ], "query": [] }, "description": "O código deixa de valer. Escopo: fidelidade.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/fidelidade/cancelar-cartao" } }, { "name": "Usos do Cartão-presente", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/cartoes-presente/:id/usos", "host": [ "{{base}}" ], "path": [ "cartoes-presente", ":id", "usos" ], "variable": [ { "key": "id", "value": "2" } ], "query": [ { "key": "pagina", "value": "", "disabled": true, "description": "Página (padrão 1)." }, { "key": "por_pagina", "value": "", "disabled": true, "description": "Itens por página, de 1 a 100 (padrão 20)." } ] }, "description": "Pedidos que usaram o saldo do cartão. Escopo: fidelidade.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/fidelidade/usos-cartao" } } ] }, { "name": "Avaliações", "item": [ { "name": "Listar Avaliações", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/avaliacoes", "host": [ "{{base}}" ], "path": [ "avaliacoes" ], "variable": [], "query": [ { "key": "pagina", "value": "", "disabled": true, "description": "Página (padrão 1)." }, { "key": "por_pagina", "value": "", "disabled": true, "description": "Itens por página, de 1 a 100 (padrão 20)." }, { "key": "status", "value": "", "disabled": true, "description": "pendente, publicada ou recusada." }, { "key": "produto_id", "value": "", "disabled": true, "description": "" }, { "key": "desde", "value": "", "disabled": true, "description": "" } ] }, "description": "Avaliações dos produtos. Escopo: avaliacoes.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/avaliacoes/listar-avaliacoes" } }, { "name": "Obter Avaliação", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/avaliacoes/:id", "host": [ "{{base}}" ], "path": [ "avaliacoes", ":id" ], "variable": [ { "key": "id", "value": "626" } ], "query": [] }, "description": "Retorna uma avaliação. Escopo: avaliacoes.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/avaliacoes/obter-avaliacao" } }, { "name": "Moderar Avaliação", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/avaliacoes/:id", "host": [ "{{base}}" ], "path": [ "avaliacoes", ":id" ], "variable": [ { "key": "id", "value": "626" } ], "query": [] }, "description": "Publica, recusa ou responde. Escopo: avaliacoes.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/avaliacoes/moderar-avaliacao", "body": { "mode": "raw", "raw": "{\n \"status\": \"publicada\",\n \"resposta\": \"Obrigado, André! Boa leitura.\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Listar Perguntas", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/perguntas", "host": [ "{{base}}" ], "path": [ "perguntas" ], "variable": [], "query": [ { "key": "pagina", "value": "", "disabled": true, "description": "Página (padrão 1)." }, { "key": "por_pagina", "value": "", "disabled": true, "description": "Itens por página, de 1 a 100 (padrão 20)." }, { "key": "status", "value": "", "disabled": true, "description": "pendente, respondida ou recusada." }, { "key": "produto_id", "value": "", "disabled": true, "description": "" } ] }, "description": "Perguntas feitas nas páginas dos produtos. Escopo: avaliacoes.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/avaliacoes/listar-perguntas" } }, { "name": "Obter Pergunta", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/perguntas/:id", "host": [ "{{base}}" ], "path": [ "perguntas", ":id" ], "variable": [ { "key": "id", "value": "88" } ], "query": [] }, "description": "Retorna uma pergunta. Escopo: avaliacoes.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/avaliacoes/obter-pergunta" } }, { "name": "Responder Pergunta", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/perguntas/:id/resposta", "host": [ "{{base}}" ], "path": [ "perguntas", ":id", "resposta" ], "variable": [ { "key": "id", "value": "88" } ], "query": [] }, "description": "Publica a resposta e avisa quem perguntou. Escopo: avaliacoes.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/avaliacoes/responder-pergunta", "body": { "mode": "raw", "raw": "{\n \"resposta\": \"Tem sim, na opção Capa dura.\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Recusar Pergunta", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/perguntas/:id/recusar", "host": [ "{{base}}" ], "path": [ "perguntas", ":id", "recusar" ], "variable": [ { "key": "id", "value": "88" } ], "query": [] }, "description": "A pergunta não aparece no produto. Escopo: avaliacoes.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/avaliacoes/recusar-pergunta" } } ] }, { "name": "Conteúdo", "item": [ { "name": "Listar Posts do Blog", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/blog", "host": [ "{{base}}" ], "path": [ "blog" ], "variable": [], "query": [ { "key": "pagina", "value": "", "disabled": true, "description": "Página (padrão 1)." }, { "key": "por_pagina", "value": "", "disabled": true, "description": "Itens por página, de 1 a 100 (padrão 20)." }, { "key": "publicado", "value": "", "disabled": true, "description": "" } ] }, "description": "Posts do blog da loja. Escopo: conteudo.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/conteudo/listar-blog" } }, { "name": "Obter Post", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/blog/:id", "host": [ "{{base}}" ], "path": [ "blog", ":id" ], "variable": [ { "key": "id", "value": "320" } ], "query": [] }, "description": "Retorna um post. Escopo: conteudo.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/conteudo/obter-post" } }, { "name": "Criar Post", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/blog", "host": [ "{{base}}" ], "path": [ "blog" ], "variable": [], "query": [] }, "description": "Cria um post. Escopo: conteudo.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/conteudo/criar-post", "body": { "mode": "raw", "raw": "{\n \"titulo\": \"Como escolher o próximo livro\",\n \"resumo\": \"Cinco perguntas que ajudam na escolha.\",\n \"conteudo\": \"Primeiro parágrafo do post.\\n\\n- dica um\\n- dica dois\",\n \"publicado\": true\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Editar Post", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/blog/:id", "host": [ "{{base}}" ], "path": [ "blog", ":id" ], "variable": [ { "key": "id", "value": "320" } ], "query": [] }, "description": "Altera só os campos enviados. Escopo: conteudo.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/conteudo/editar-post", "body": { "mode": "raw", "raw": "{\n \"publicado\": false\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Apagar Post", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/blog/:id", "host": [ "{{base}}" ], "path": [ "blog", ":id" ], "variable": [ { "key": "id", "value": "320" } ], "query": [] }, "description": "Remove o post. Escopo: conteudo.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/conteudo/apagar-post" } }, { "name": "Listar Banners", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/banners", "host": [ "{{base}}" ], "path": [ "banners" ], "variable": [], "query": [ { "key": "pagina", "value": "", "disabled": true, "description": "Página (padrão 1)." }, { "key": "por_pagina", "value": "", "disabled": true, "description": "Itens por página, de 1 a 100 (padrão 20)." } ] }, "description": "Banners do carrossel da página inicial. Escopo: conteudo.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/conteudo/listar-banners" } }, { "name": "Obter Banner", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/banners/:id", "host": [ "{{base}}" ], "path": [ "banners", ":id" ], "variable": [ { "key": "id", "value": "188" } ], "query": [] }, "description": "Retorna um banner. Escopo: conteudo.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/conteudo/obter-banner" } }, { "name": "Criar Banner", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/banners", "host": [ "{{base}}" ], "path": [ "banners" ], "variable": [], "query": [] }, "description": "Cria um banner. Escopo: conteudo.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/conteudo/criar-banner", "body": { "mode": "raw", "raw": "{\n \"titulo\": \"Semana do livro\",\n \"imagem_desktop\": \"https://cdn.seuerp.com.br/banners/semana-livro.jpg\",\n \"link\": \"/categoria?filtro=4\",\n \"fim\": \"2026-11-07T23:59:59-03:00\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Editar Banner", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/banners/:id", "host": [ "{{base}}" ], "path": [ "banners", ":id" ], "variable": [ { "key": "id", "value": "188" } ], "query": [] }, "description": "Altera só os campos enviados. Escopo: conteudo.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/conteudo/editar-banner", "body": { "mode": "raw", "raw": "{\n \"ativo\": false\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Apagar Banner", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/banners/:id", "host": [ "{{base}}" ], "path": [ "banners", ":id" ], "variable": [ { "key": "id", "value": "188" } ], "query": [] }, "description": "Remove o banner. Escopo: conteudo.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/conteudo/apagar-banner" } }, { "name": "Listar Páginas", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/paginas", "host": [ "{{base}}" ], "path": [ "paginas" ], "variable": [], "query": [ { "key": "pagina", "value": "", "disabled": true, "description": "Página (padrão 1)." }, { "key": "por_pagina", "value": "", "disabled": true, "description": "Itens por página, de 1 a 100 (padrão 20)." } ] }, "description": "Páginas institucionais. Escopo: conteudo.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/conteudo/listar-paginas" } }, { "name": "Obter Página", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/paginas/:id", "host": [ "{{base}}" ], "path": [ "paginas", ":id" ], "variable": [ { "key": "id", "value": "320" } ], "query": [] }, "description": "Retorna uma página. Escopo: conteudo.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/conteudo/obter-pagina" } }, { "name": "Criar Página", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/paginas", "host": [ "{{base}}" ], "path": [ "paginas" ], "variable": [], "query": [] }, "description": "Cria uma página. Escopo: conteudo.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/conteudo/criar-pagina", "body": { "mode": "raw", "raw": "{\n \"titulo\": \"Trocas e devoluções\",\n \"conteudo\": \"Você pode trocar em até 7 dias depois de receber o pedido.\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Editar Página", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/paginas/:id", "host": [ "{{base}}" ], "path": [ "paginas", ":id" ], "variable": [ { "key": "id", "value": "320" } ], "query": [] }, "description": "Altera só os campos enviados. Escopo: conteudo.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/conteudo/editar-pagina", "body": { "mode": "raw", "raw": "{\n \"ativa\": false\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Apagar Página", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/paginas/:id", "host": [ "{{base}}" ], "path": [ "paginas", ":id" ], "variable": [ { "key": "id", "value": "320" } ], "query": [] }, "description": "Remove a página. Escopo: conteudo.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/conteudo/apagar-pagina" } } ] }, { "name": "Aplicativos", "item": [ { "name": "Listar Aplicativos", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/aplicativos", "host": [ "{{base}}" ], "path": [ "aplicativos" ], "variable": [], "query": [ { "key": "categoria", "value": "", "disabled": true, "description": "vendas, logistica, dropshipping, pagamento, frete ou marketplace." }, { "key": "instalado", "value": "", "disabled": true, "description": "true = só os instalados." } ] }, "description": "Todos os aplicativos da loja e a situação de cada um. Escopo: aplicativos.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/aplicativos/listar-aplicativos" } }, { "name": "Obter Aplicativo", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/aplicativos/{slug}", "host": [ "{{base}}" ], "path": [ "aplicativos", "{slug}" ], "variable": [], "query": [] }, "description": "Situação do aplicativo e, nos de vendas e frete, as regras. Escopo: aplicativos.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/aplicativos/obter-aplicativo" } }, { "name": "Definir Regras do Aplicativo", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/aplicativos/{slug}/regras", "host": [ "{{base}}" ], "path": [ "aplicativos", "{slug}", "regras" ], "variable": [], "query": [] }, "description": "Substitui as regras de um aplicativo de vendas ou do gestor de frete. Escopo: aplicativos.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/aplicativos/regras-aplicativo", "body": { "mode": "raw", "raw": "{\n \"regras\": [\n {\n \"nome\": \"Combo leitura\",\n \"produto_id\": 2291,\n \"itens\": [\n 2268\n ],\n \"desconto_percentual\": 10\n }\n ]\n}", "options": { "raw": { "language": "json" } } } } } ] }, { "name": "Mídias", "item": [ { "name": "Listar Mídias", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/midias", "host": [ "{{base}}" ], "path": [ "midias" ], "variable": [], "query": [ { "key": "pagina", "value": "", "disabled": true, "description": "Página (padrão 1)." }, { "key": "por_pagina", "value": "", "disabled": true, "description": "Itens por página, de 1 a 100 (padrão 20)." }, { "key": "busca", "value": "", "disabled": true, "description": "Título, texto alternativo ou nome do arquivo." } ] }, "description": "Biblioteca de imagens da loja. Escopo: midias.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/midias/listar-midias" } }, { "name": "Enviar Mídia", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/midias", "host": [ "{{base}}" ], "path": [ "midias" ], "variable": [], "query": [] }, "description": "Envia uma imagem para a biblioteca da loja. Escopo: midias.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/midias/enviar-midia", "body": { "mode": "raw", "raw": "{\n \"url\": \"https://cdn.seuerp.com.br/fotos/vitrine.jpg\",\n \"titulo\": \"Vitrine de outubro\",\n \"alt\": \"Livros na vitrine\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Editar Mídia", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/midias/:id", "host": [ "{{base}}" ], "path": [ "midias", ":id" ], "variable": [ { "key": "id", "value": "4407" } ], "query": [] }, "description": "Altera título, texto alternativo e legenda. Escopo: midias.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/midias/editar-midia", "body": { "mode": "raw", "raw": "{\n \"alt\": \"Livros na vitrine da loja\"\n}", "options": { "raw": { "language": "json" } } } } } ] }, { "name": "Configurações", "item": [ { "name": "Listar E-mails", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/emails", "host": [ "{{base}}" ], "path": [ "emails" ], "variable": [], "query": [] }, "description": "Avisos enviados aos clientes e o texto de cada um. Escopo: configuracoes.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/configuracoes/listar-emails" } }, { "name": "Editar E-mail", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/emails/{tipo}", "host": [ "{{base}}" ], "path": [ "emails", "{tipo}" ], "variable": [], "query": [] }, "description": "Personaliza assunto e texto, ou liga e desliga o aviso. Escopo: configuracoes.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/configuracoes/editar-email", "body": { "mode": "raw", "raw": "{\n \"assunto\": \"Recebemos seu pedido #{pedido}!\",\n \"ativo\": true\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Restaurar E-mail Padrão", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/emails/{tipo}", "host": [ "{{base}}" ], "path": [ "emails", "{tipo}" ], "variable": [], "query": [] }, "description": "Volta o aviso ao texto padrão do Hotel das Lojas. Escopo: configuracoes.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/configuracoes/email-padrao" } }, { "name": "Regras de Pedidos", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/configuracoes/regras-pedidos", "host": [ "{{base}}" ], "path": [ "configuracoes", "regras-pedidos" ], "variable": [], "query": [] }, "description": "Cancelamento automático de pedidos não pagos. Escopo: configuracoes.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/configuracoes/obter-regras-pedidos" } }, { "name": "Editar Regras de Pedidos", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/configuracoes/regras-pedidos", "host": [ "{{base}}" ], "path": [ "configuracoes", "regras-pedidos" ], "variable": [], "query": [] }, "description": "Prazo para cancelar pedido com pagamento online pendente. Escopo: configuracoes.escrever. Docs: https://docs.hoteldaslojas.com.br/api-reference/configuracoes/editar-regras-pedidos", "body": { "mode": "raw", "raw": "{\n \"cancelar_nao_pagos_horas\": 48\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Listar Equipe", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/equipe", "host": [ "{{base}}" ], "path": [ "equipe" ], "variable": [], "query": [ { "key": "pagina", "value": "", "disabled": true, "description": "Página (padrão 1)." }, { "key": "por_pagina", "value": "", "disabled": true, "description": "Itens por página, de 1 a 100 (padrão 20)." } ] }, "description": "Pessoas com acesso ao painel da loja. Escopo: configuracoes.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/configuracoes/listar-equipe" } }, { "name": "Solicitações LGPD", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/lgpd/solicitacoes", "host": [ "{{base}}" ], "path": [ "lgpd", "solicitacoes" ], "variable": [], "query": [ { "key": "pagina", "value": "", "disabled": true, "description": "Página (padrão 1)." }, { "key": "por_pagina", "value": "", "disabled": true, "description": "Itens por página, de 1 a 100 (padrão 20)." }, { "key": "desde", "value": "", "disabled": true, "description": "" } ] }, "description": "Pedidos de clientes sobre os próprios dados. Escopo: configuracoes.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/configuracoes/lgpd" } } ] }, { "name": "Relatórios", "item": [ { "name": "Resumo de Vendas", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/relatorios/resumo", "host": [ "{{base}}" ], "path": [ "relatorios", "resumo" ], "variable": [], "query": [ { "key": "desde", "value": "", "disabled": true, "description": "Início (padrão: 30 dias antes de ate)." }, { "key": "ate", "value": "", "disabled": true, "description": "Fim (padrão: hoje). Período máximo de 366 dias." } ] }, "description": "Faturamento, ticket médio, itens, clientes novos e pedidos por status. Escopo: relatorios.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/relatorios/resumo" } }, { "name": "Vendas por Período", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/relatorios/vendas", "host": [ "{{base}}" ], "path": [ "relatorios", "vendas" ], "variable": [], "query": [ { "key": "desde", "value": "", "disabled": true, "description": "Início (padrão: 30 dias antes de ate)." }, { "key": "ate", "value": "", "disabled": true, "description": "Fim (padrão: hoje). Período máximo de 366 dias." }, { "key": "agrupar", "value": "", "disabled": true, "description": "dia (padrão), semana ou mes." } ] }, "description": "Pedidos e faturamento por dia, semana ou mês. Escopo: relatorios.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/relatorios/vendas" } }, { "name": "Produtos Mais Vendidos", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/relatorios/produtos-mais-vendidos", "host": [ "{{base}}" ], "path": [ "relatorios", "produtos-mais-vendidos" ], "variable": [], "query": [ { "key": "desde", "value": "", "disabled": true, "description": "Início (padrão: 30 dias antes de ate)." }, { "key": "ate", "value": "", "disabled": true, "description": "Fim (padrão: hoje). Período máximo de 366 dias." }, { "key": "limite", "value": "", "disabled": true, "description": "De 1 a 100 (padrão 20)." }, { "key": "ordem", "value": "", "disabled": true, "description": "quantidade (padrão) ou faturamento." } ] }, "description": "Ranking por quantidade ou faturamento. Escopo: relatorios.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/relatorios/produtos-mais-vendidos" } }, { "name": "Movimentos de Estoque", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/estoque/movimentos", "host": [ "{{base}}" ], "path": [ "estoque", "movimentos" ], "variable": [], "query": [ { "key": "pagina", "value": "", "disabled": true, "description": "Página (padrão 1)." }, { "key": "por_pagina", "value": "", "disabled": true, "description": "Itens por página, de 1 a 100 (padrão 20)." }, { "key": "produto_id", "value": "", "disabled": true, "description": "" }, { "key": "tipo", "value": "", "disabled": true, "description": "entrada, saida, pedido, devolucao ou inventario." }, { "key": "pedido_id", "value": "", "disabled": true, "description": "" }, { "key": "desde", "value": "", "disabled": true, "description": "" }, { "key": "ate", "value": "", "disabled": true, "description": "" } ] }, "description": "Entradas, saídas, vendas, devoluções e contagens. Escopo: relatorios.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/relatorios/movimentos-estoque" } }, { "name": "Anúncios nos Marketplaces", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/marketplaces/produtos", "host": [ "{{base}}" ], "path": [ "marketplaces", "produtos" ], "variable": [], "query": [ { "key": "pagina", "value": "", "disabled": true, "description": "Página (padrão 1)." }, { "key": "por_pagina", "value": "", "disabled": true, "description": "Itens por página, de 1 a 100 (padrão 20)." }, { "key": "canal", "value": "", "disabled": true, "description": "Ex.: mercadolivre, shopee." }, { "key": "produto_id", "value": "", "disabled": true, "description": "" }, { "key": "situacao", "value": "", "disabled": true, "description": "" } ] }, "description": "Situação de cada produto em cada canal. Escopo: relatorios.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/relatorios/marketplaces-produtos" } }, { "name": "Pedidos dos Marketplaces", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/marketplaces/pedidos", "host": [ "{{base}}" ], "path": [ "marketplaces", "pedidos" ], "variable": [], "query": [ { "key": "pagina", "value": "", "disabled": true, "description": "Página (padrão 1)." }, { "key": "por_pagina", "value": "", "disabled": true, "description": "Itens por página, de 1 a 100 (padrão 20)." }, { "key": "canal", "value": "", "disabled": true, "description": "" }, { "key": "situacao", "value": "", "disabled": true, "description": "importado ou erro." } ] }, "description": "Pedidos importados dos canais e o número na loja. Escopo: relatorios.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/relatorios/marketplaces-pedidos" } }, { "name": "Categorias nos Marketplaces", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/marketplaces/categorias", "host": [ "{{base}}" ], "path": [ "marketplaces", "categorias" ], "variable": [], "query": [ { "key": "pagina", "value": "", "disabled": true, "description": "Página (padrão 1)." }, { "key": "por_pagina", "value": "", "disabled": true, "description": "Itens por página, de 1 a 100 (padrão 20)." }, { "key": "canal", "value": "", "disabled": true, "description": "" } ] }, "description": "Ligação das categorias da loja com as de cada canal. Escopo: relatorios.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/relatorios/marketplaces-categorias" } }, { "name": "Registro dos Marketplaces", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/marketplaces/log", "host": [ "{{base}}" ], "path": [ "marketplaces", "log" ], "variable": [], "query": [ { "key": "pagina", "value": "", "disabled": true, "description": "Página (padrão 1)." }, { "key": "por_pagina", "value": "", "disabled": true, "description": "Itens por página, de 1 a 100 (padrão 20)." }, { "key": "canal", "value": "", "disabled": true, "description": "" }, { "key": "desde", "value": "", "disabled": true, "description": "" } ] }, "description": "O que aconteceu em cada canal (publicações, erros, pedidos). Escopo: relatorios.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/relatorios/marketplaces-log" } }, { "name": "Teste A/B da Vitrine", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/relatorios/teste-ab", "host": [ "{{base}}" ], "path": [ "relatorios", "teste-ab" ], "variable": [], "query": [] }, "description": "Vistas, cliques e taxa de clique de cada variante. Escopo: relatorios.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/relatorios/teste-ab" } }, { "name": "Exportar Planilha", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/exportacoes/{tipo}", "host": [ "{{base}}" ], "path": [ "exportacoes", "{tipo}" ], "variable": [], "query": [ { "key": "desde", "value": "", "disabled": true, "description": "Criados a partir desta data." }, { "key": "ate", "value": "", "disabled": true, "description": "Criados até esta data." } ] }, "description": "Pedidos, clientes ou produtos em CSV (abre no Excel). Escopo: relatorios.ler. Docs: https://docs.hoteldaslojas.com.br/api-reference/relatorios/exportacoes" } } ] }, { "name": "Webhooks", "item": [ { "name": "Listar Webhooks", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/webhooks", "host": [ "{{base}}" ], "path": [ "webhooks" ], "variable": [], "query": [] }, "description": "Lista os webhooks da loja. Escopo: webhooks.gerenciar. Docs: https://docs.hoteldaslojas.com.br/api-reference/webhooks/listar-webhooks" } }, { "name": "Criar Webhook", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/webhooks", "host": [ "{{base}}" ], "path": [ "webhooks" ], "variable": [], "query": [] }, "description": "Cadastra um endereço para receber eventos. Escopo: webhooks.gerenciar. Docs: https://docs.hoteldaslojas.com.br/api-reference/webhooks/criar-webhook", "body": { "mode": "raw", "raw": "{\n \"url\": \"https://erp.exemplo.com.br/webhooks/hotel\",\n \"eventos\": [\n \"pedido.criado\",\n \"pedido.status_alterado\"\n ]\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Editar Webhook", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/webhooks/:id", "host": [ "{{base}}" ], "path": [ "webhooks", ":id" ], "variable": [ { "key": "id", "value": "1" } ], "query": [] }, "description": "Muda endereço, eventos ou pausa/reativa. Escopo: webhooks.gerenciar. Docs: https://docs.hoteldaslojas.com.br/api-reference/webhooks/editar-webhook", "body": { "mode": "raw", "raw": "{\n \"ativo\": true\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Apagar Webhook", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/webhooks/:id", "host": [ "{{base}}" ], "path": [ "webhooks", ":id" ], "variable": [ { "key": "id", "value": "1" } ], "query": [] }, "description": "Remove o webhook e cancela entregas pendentes. Escopo: webhooks.gerenciar. Docs: https://docs.hoteldaslojas.com.br/api-reference/webhooks/apagar-webhook" } }, { "name": "Testar Webhook", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/webhooks/:id/testar", "host": [ "{{base}}" ], "path": [ "webhooks", ":id", "testar" ], "variable": [ { "key": "id", "value": "1" } ], "query": [] }, "description": "Envia na hora um evento \"teste\" assinado. Escopo: webhooks.gerenciar. Docs: https://docs.hoteldaslojas.com.br/api-reference/webhooks/testar-webhook" } }, { "name": "Listar Entregas", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base}}/webhooks/:id/entregas", "host": [ "{{base}}" ], "path": [ "webhooks", ":id", "entregas" ], "variable": [ { "key": "id", "value": "1" } ], "query": [ { "key": "pagina", "value": "", "disabled": true, "description": "Página (padrão 1)." }, { "key": "por_pagina", "value": "", "disabled": true, "description": "Itens por página, de 1 a 100 (padrão 20)." } ] }, "description": "Histórico de envios do webhook (30 dias). Escopo: webhooks.gerenciar. Docs: https://docs.hoteldaslojas.com.br/api-reference/webhooks/entregas-webhook" } } ] } ] }