{"info":{"_postman_id":"49786601-b95d-43b1-be87-b670b6e43462","name":"API Pública Montink","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"description":"<html><head></head><body></body></html>","owner":"18114936","collectionId":"49786601-b95d-43b1-be87-b670b6e43462","publishedId":"2sB3Wnvgm6","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-10-29T19:50:56.000Z"},"item":[{"name":"Criar Pedido","event":[{"listen":"prerequest","script":{"id":"d42b05ab-867c-4740-8411-7bbf3da1a26f","exec":[""],"type":"text/javascript","packages":{}}}],"id":"1f4cf684-9577-4ffd-bf44-5372b7e5b7c4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorizationtoken","value":"TOKEN_ENVIADO","description":"<p>Token de Autorização recebido pela equipe ou gerado na integração</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{\r\n    \"customer_name\": \"Nome Completo\",\r\n    \"customer_email\": \"email@email.com\",\r\n    \"customer_document\": \"9999999999\",\r\n    \"customer_phone\": \"(11) 99999-9999\",\r\n    \"payment_method\": \"pix\",\r\n    \"value_total\": 150.00,\r\n    \"external_order_id\": \"123456789\",\r\n    \"shipping_id\": 15,\r\n    \"address\": {\r\n        \"zipcode\": \"00000-000\",\r\n        \"street\": \"Logradouro do Endereço\",\r\n        \"number\": \"100\",\r\n        \"neighborhood\": \"Bairro\",\r\n        \"city\": \"Cidade\",\r\n        \"state\": \"UF\",\r\n        \"complement\": \"Casa A\"\r\n    },\r\n    \"products\": [\r\n        {\r\n            \"product_id\": 99999,\r\n            \"sku\": 999999999,\r\n            \"quantity\": 4,\r\n            \"var1\": \"G\",\r\n            \"var2\": \"Branco\",\r\n            \"var3\": null,\r\n            \"price\": 150.00\r\n        },\r\n        {\r\n            \"product_id\": 99999,\r\n            \"sku\": 999999999,\r\n            \"quantity\": 4,\r\n            \"var1\": \"G\",\r\n            \"var2\": \"Branco\",\r\n            \"var3\": null,\r\n            \"price\": 150.00\r\n        }\r\n    ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.montink.com/create_order","description":"<p>Endpoint responsável por gerar um pedido em sua plataforma. Seu pedido aparecerá diretamente em sua dashboard, na página de Pedidos Externos. Após importar o pedido, é necessário efetuar o pagamento utilizando o saldo de sua conta para pagar os custos do pedido, e enviá-lo a produção.</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parâmetro</strong></th>\n<th><strong>Descrição</strong></th>\n<th><strong>Descrição Adicional</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>customer_name (Obrigatório)</td>\n<td>Nome Completo do Cliente Comprador</td>\n<td>String</td>\n</tr>\n<tr>\n<td>customer_email (Obrigatório)</td>\n<td>E-mail do Cliente Comprador</td>\n<td>String - O e-mail será validado em nosso sistema, e caso seja inválido, não será importado.</td>\n</tr>\n<tr>\n<td>customer_document (Obrigatório)</td>\n<td>Documento do Cliente Comprador</td>\n<td>String - CPF ou CNPJ</td>\n</tr>\n<tr>\n<td>customer_name (Obrigatório)</td>\n<td>Telefone do Cliente Comprador</td>\n<td>String - Enviar de Preferência no Formato (DD) 90000-0000</td>\n</tr>\n<tr>\n<td>payment_method (Opcional)</td>\n<td>Forma de Pagamento do Pedido</td>\n<td>String - Todos os pedidos serão importados para pagamento via saldo. Outras formas de pagamentos disponíveis em breve.</td>\n</tr>\n<tr>\n<td>value_total (Obrigatório)</td>\n<td>Valor Total do Pedido</td>\n<td>Double - Valor demonstrativo do valor do pedido. Esse não será o valor final de compra pago via saldo, o valor será calculado pelo nosso sistema.</td>\n</tr>\n<tr>\n<td>external_order_id (Opcional)</td>\n<td>ID do Pedido em Sua Plataforma</td>\n<td>String - Utilizado para identificação de seu pedido em nossa plataforma</td>\n</tr>\n<tr>\n<td>shipping_id (Opcional)</td>\n<td>ID da Transportadora de Envio</td>\n<td>Integer - Para obter o ID da Transportadora, utilize o endpoint calculate_shipping. Caso o ID da Transportadora não seja enviado, selecionaremos a opção com menor preço.</td>\n</tr>\n<tr>\n<td>address[zipcode] (Obrigatório)</td>\n<td>CEP do Endereço Entrega</td>\n<td>O Cep informado será validado pelo nosso sistema. Não será possível importar pedidos com Ceps incorretos.</td>\n</tr>\n<tr>\n<td>address[street] (Obrigatório)</td>\n<td>Logradouro do Endereço de Entrega</td>\n<td>String</td>\n</tr>\n<tr>\n<td>address[number] (Obrigatório)</td>\n<td>Número do Endereço de Entrega</td>\n<td>String</td>\n</tr>\n<tr>\n<td>address[neighborhood] (Obrigatório)</td>\n<td>Bairro do Endereço de Entrega</td>\n<td>String</td>\n</tr>\n<tr>\n<td>address[city] (Obrigatório)</td>\n<td>Cidade do Endereço de Entrega</td>\n<td>String</td>\n</tr>\n<tr>\n<td>address[state] (Obrigatório)</td>\n<td>UF do Endereço de Entrega</td>\n<td>String - Apenas dois Dígitos. Ex: MG, SP, RJ, BA</td>\n</tr>\n<tr>\n<td>address[complement] (Opcional)</td>\n<td>Complemento do Endereço</td>\n<td>String</td>\n</tr>\n<tr>\n<td>products[] (Obrigatório)</td>\n<td>Produtos do Pedido</td>\n<td>Array - Combinação dos produtos com os dados obtidos pelo endpoint products ou product</td>\n</tr>\n<tr>\n<td>products[product_id] (Obrigatório)</td>\n<td>ID do Produto criado na Montink</td>\n<td>Integer</td>\n</tr>\n<tr>\n<td>products[sku] (Opcional)</td>\n<td>SKU das Variações do Produto</td>\n<td>String - Opcional caso não seja enviado os campos var1, var2 e var3 (var3 é opcional)</td>\n</tr>\n<tr>\n<td>products[quantity](Obrigatório)</td>\n<td>Quantidade de Produtos</td>\n<td>Integer</td>\n</tr>\n<tr>\n<td>products[var1](Opcional em alguns casos)</td>\n<td>Variante 1, normalmente relacionada a tamanho</td>\n<td>String - Caso o produto esteja nas categorias de Canecas, Bonés, Garrafas ou Copos, esse campo se torna opcional. Também é aceito o valor ÚNICO</td>\n</tr>\n<tr>\n<td>products[var2] (Obrigatório)</td>\n<td>Variante 2, normalmente relacionada a cor</td>\n<td>String</td>\n</tr>\n<tr>\n<td>products[var3] (Opcional)</td>\n<td>Variante 3, normalmente relacionada a escolha do Papel</td>\n<td>String - Caso o produto seja na categoria Posters, o campo é obrigatório</td>\n</tr>\n<tr>\n<td>products[price] (Obrigatório)</td>\n<td>Preço demonstrativo do Produto</td>\n<td>Double</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["create_order"],"host":["api","montink","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"1f4cf684-9577-4ffd-bf44-5372b7e5b7c4"},{"name":"Listagem de Pedidos","id":"eb5cb3d8-a5c4-491d-bba1-ad0873694f34","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"key":"Authorizationtoken","value":"TOKEN_ENVIADO","description":"<p>Token de Autorização recebido pela equipe ou gerado na integração</p>\n","type":"default"}],"url":"https://api.montink.com/orders","description":"<p>Pedidos efetuados na plataforma.</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Filtro Disponível</strong></th>\n<th><strong>Formato de Valor</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>inicio</td>\n<td>Data no Formato Y-m-d</td>\n</tr>\n<tr>\n<td>fim</td>\n<td>Data no Formato Y-m-d</td>\n</tr>\n<tr>\n<td>filtro</td>\n<td>Filtragem por Pagamentos. Valores aceitos: carrinho_abandonado, pedidos_pendentes, pedidos_pagos</td>\n</tr>\n<tr>\n<td>idPedido</td>\n<td>ID específico do Pedido</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["orders"],"host":["api","montink","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"eb5cb3d8-a5c4-491d-bba1-ad0873694f34"},{"name":"Detalhes do Pedido","id":"d6daf7f7-968a-43c8-bbd0-efd8bc2f4986","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"key":"Authorizationtoken","value":"TOKEN_ENVIADO","description":"<p>Token de Autorização recebido pela equipe ou gerado na integração</p>\n","type":"default"}],"url":"https://api.montink.com/order/{IDPEDIDO}","urlObject":{"protocol":"https","path":["order","{IDPEDIDO}"],"host":["api","montink","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"d6daf7f7-968a-43c8-bbd0-efd8bc2f4986"},{"name":"Listagem de Produtos","id":"6cd7713f-d424-4fe5-b824-27c4daeadfa8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"key":"Authorizationtoken","value":"TOKEN_ENVIADO","description":"<p>Token de Autorização recebido pela equipe ou gerado na integração</p>\n","type":"default"}],"url":"https://api.montink.com/products","urlObject":{"protocol":"https","path":["products"],"host":["api","montink","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"6cd7713f-d424-4fe5-b824-27c4daeadfa8"},{"name":"Calculo de Frete","id":"0fc9358f-437c-49cd-9023-9b2940c17501","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorizationtoken","value":"TOKEN_ENVIADO","description":"<p>Token de Autorização recebido pela equipe ou gerado na integração</p>\n","type":"text"}],"url":"https://api.montink.com/calculate_shipping/CEP/QUANTIDADE_PRODUTOS","urlObject":{"protocol":"https","path":["calculate_shipping","CEP","QUANTIDADE_PRODUTOS"],"host":["api","montink","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"0fc9358f-437c-49cd-9023-9b2940c17501"},{"name":"Autenticar","id":"e0045409-5f44-42b8-8bac-79ed2577fa44","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.montink.com/autenticar","description":"<h3 id=\"post\">POST</h3>\n<p>Autenticar</p>\n<h3 id=\"descrição\">Descrição</h3>\n<p>Endpoint responsável por autenticar sua conta e retornar um token de acesso (válido por 30 dias).</p>\n<h3 id=\"url\">URL</h3>\n<p><code>https://api.montink.com/autenticar</code></p>\n<h3 id=\"headers\">HEADERS</h3>\n<ul>\n<li><code>Content-Type</code>: <code>application/x-www-form-urlencoded</code></li>\n</ul>\n<h3 id=\"body-x-www-form-urlencoded\">BODY (x-www-form-urlencoded)</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Parâmetro</th>\n<th>Obrigatório</th>\n<th>Tipo</th>\n<th>Descrição</th>\n<th>Observações</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>login</td>\n<td>Sim</td>\n<td>String</td>\n<td>E-mail do usuário</td>\n<td>—</td>\n</tr>\n<tr>\n<td>senha</td>\n<td>Sim</td>\n<td>String</td>\n<td>Senha do usuário</td>\n<td>—</td>\n</tr>\n<tr>\n<td>token</td>\n<td>Sim</td>\n<td>String</td>\n<td>Token de requisição</td>\n<td>Deve ser igual a <code>TOKEN_REQUEST</code> informado pela equipe</td>\n</tr>\n</tbody>\n</table>\n</div><h3 id=\"example-request\">Example Request</h3>\n<p>Autenticar (cURL)</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-bash\">curl --location 'https://api.montink.com/autenticar' \\\n  --header 'Content-Type: application/x-www-form-urlencoded' \\\n  --data 'login=SEU_EMAIL&amp;senha=SUA_SENHA&amp;token=TOKEN_REQUEST'\n</code></pre>\n<h3 id=\"example-response\">Example Response</h3>\n<p>Sucesso (200)</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"success\": true,\n  \"msg\": \"Login efetuado com sucesso\",\n  \"dados\": { \"access_token\": \"&lt;TOKEN_DE_ACESSO&gt;\" }\n}\n</code></pre>\n<p>Erro (200 — validação)</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"success\": false,\n  \"msg\": \"Envie todos os dados necessários\"\n}\n</code></pre>\n<h3 id=\"notas\">Notas</h3>\n<ul>\n<li>Não usa <code>Authorizationtoken</code> (esse é gerado após autenticar).</li>\n<li>Há proteção de rate-limit por e-mail e IP; em excesso de tentativas pode retornar mensagem genérica de falha.</li>\n</ul>\n","urlObject":{"protocol":"https","path":["autenticar"],"host":["api","montink","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"e0045409-5f44-42b8-8bac-79ed2577fa44"},{"name":"dashboard","id":"dfaced25-f246-4377-8ea0-8b96759be57e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.montink.com/dashboard","description":"<h3 id=\"get\">GET</h3>\n<p>Dashboard</p>\n<h3 id=\"descrição\">Descrição</h3>\n<p>Retorna indicadores e resumo da conta (saldo, quantidade de pedidos recentes, faturamento e lista de pedidos).</p>\n<h3 id=\"url\">URL</h3>\n<p><code>https://api.montink.com/dashboard</code></p>\n<h3 id=\"headers\">HEADERS</h3>\n<ul>\n<li><code>Authorizationtoken</code>: <code>TOKEN_ENVIADO</code></li>\n</ul>\n<h3 id=\"example-request\">Example Request</h3>\n<p>Dashboard (cURL)</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-bash\">curl --location 'https://api.montink.com/dashboard' \\\n  --header 'Authorizationtoken: TOKEN_ENVIADO'\n\n</code></pre>\n<h3 id=\"example-response\">Example Response</h3>\n<p>Sucesso (200)</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"success\": true,\n  \"msg\": \"Processo finalizado\",\n  \"dados\": {\n    \"saldo_disponivel\": \"R$123,45\",\n    \"quantidade_pedidos\": 5,\n    \"faturamento\": \"R$ 1.234\",\n    \"pedidos\": [\n      {\n        \"id\": 123,\n        \"data_aprovado\": \"2025-10-29 12:00:00\",\n        \"valor_venda\": 100.0,\n        \"lojista_lucro\": 20.0,\n        \"pedido_id_formatado\": \"Pedido #123\",\n        \"valor_venda_formatado\": \"R$ 100,00\",\n        \"data_pedido\": \"29/10 12:00\"\n      }\n    ]\n  }\n}\n\n</code></pre>\n<p>Erro (200 — exemplo)</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"success\": false,\n  \"msg\": \"Token de Autorização não enviado.\"\n}\n\n</code></pre>\n<h3 id=\"notas\">Notas</h3>\n<ul>\n<li><p>Exige <code>Authorizationtoken</code> válido.</p>\n</li>\n<li><p>Método permitido: GET.</p>\n</li>\n</ul>\n","urlObject":{"protocol":"https","path":["dashboard"],"host":["api","montink","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"dfaced25-f246-4377-8ea0-8b96759be57e"},{"name":"Detalhes do Produto","id":"a60e207b-2048-4b14-ac38-388426ddecdc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.montink.com/product?ProductId={IDPRODUTO}","description":"<h3 id=\"get\">GET</h3>\n<p>Detalhes do Produto</p>\n<h3 id=\"url-canônica-em-produção\">URL (canônica em produção)</h3>\n<p><code>https://api.montink.com/product?ProductId={IDPRODUTO}</code></p>\n<h3 id=\"url-alternativa-apenas-onde-a-rota-estiver-habilitada\">URL alternativa (apenas onde a rota estiver habilitada)</h3>\n<p><code>https://api.montink.com/product/{IDPRODUTO}</code></p>\n<h3 id=\"headers\">HEADERS</h3>\n<ul>\n<li><code>Authorizationtoken</code>: <code>TOKEN_ENVIADO</code></li>\n</ul>\n<h3 id=\"example-request-curl--canônica\">Example Request (cURL) — canônica</h3>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-bash\">curl --location 'https://api.montink.com/product?ProductId=12345' \\\n  --header 'Authorizationtoken: TOKEN_ENVIADO'\n\n</code></pre>\n<h3 id=\"example-response\">Example Response</h3>\n<p>Sucesso (200)</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"success\": true,\n  \"msg\": \"Processo finalizado\",\n  \"dados\": { \"...\": \"...\" }\n}\n\n</code></pre>\n<p>Erro (200)</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{ \"success\": false, \"msg\": \"Token de Autorização não enviado.\" }\n\n</code></pre>\n<h3 id=\"notas\">Notas</h3>\n<ul>\n<li><p>Em produção, utilize preferencialmente <code>?ProductId=</code> (case sensitive).</p>\n</li>\n<li><p>O formato <code>/product/{IDPRODUTO}</code> só funciona em instalações onde a rota foi atualizada.</p>\n</li>\n</ul>\n","urlObject":{"protocol":"https","path":["product"],"host":["api","montink","com"],"query":[{"key":"ProductId","value":"{IDPRODUTO}"}],"variable":[]}},"response":[],"_postman_id":"a60e207b-2048-4b14-ac38-388426ddecdc"},{"name":"data_analysis","id":"01727af9-24de-4f00-9e8e-351455c070d6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.montink.com/data_analysis","description":"<p>curl --location '<a href=\"https://api.montink.com/data_analysis?agrupar=mes&amp;filtroDash=30'\">https://api.montink.com/data_analysis?agrupar=mes&amp;filtroDash=30'</a><br />--header 'Authorizationtoken: TOKEN_ENVIADO'</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>  Example Response\n  Sucesso (200)\n  ```json\n  {\n    \"success\": true,\n    \"msg\": \"Dados recebidos com sucesso\",\n    \"dados\": {\n      \"dadosGraficoAnual\": [\n        { \"x\": \"01/2025\", \"y\": 1234.56 }\n      ],\n      \"dadosGraficoMensal\": [\n        { \"x\": \"01/10/2025\", \"y\": 123.45 }\n      ],\n      \"dadosGraficoAnualX\": [1, 2, 3],\n      \"dadosGraficoAnualY\": [1234.56, 2345.67, 3456.78],\n      \"dadosDash\": {\n        \"total_pedidos\": 42,\n        \"ticket_medio\": 97.5\n      }\n    }\n  }\n\n</code></pre><p>Erro (200 — exemplo)</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">  { \"success\": false, \"msg\": \"Token de Autorização não enviado.\" }\n\n</code></pre>\n<p>Notas</p>\n<ul>\n<li><p>GET obrigatório com Authorizationtoken.</p>\n</li>\n<li><p>Sem filtros, o período padrão é 180 dias.</p>\n</li>\n</ul>\n","urlObject":{"protocol":"https","path":["data_analysis"],"host":["api","montink","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"01727af9-24de-4f00-9e8e-351455c070d6"}]}