{"info":{"name":"API Lojas Leve On V1 - Sandbox e Integracao","description":"Colecao oficial para homologar integradores externos com API Key, sandbox, leitura segura e webhooks HMAC. Comece pelo grupo Sandbox antes de usar dados reais.","schema":"https://schema.getpostman.com/json/collection/v2.1.0/collection.json"},"variable":[{"key":"baseUrl","value":"https://lojasleveon.com.br"},{"key":"apiKey","value":"llon_live_copie_sua_chave_aqui"},{"key":"integrationName","value":"ERP Homologacao"},{"key":"sellerId","value":"8"},{"key":"produtoId","value":"4322"},{"key":"pedidoId","value":"1"},{"key":"categoriaId","value":"12"},{"key":"webhookSecret","value":"secret_copiado_ao_criar_webhook"}],"item":[{"name":"1. Sandbox sem gravar dados reais","description":"Use esta pasta primeiro. Todas as chamadas exigem API Key com escopo sandbox:read.","item":[{"name":"Status do sandbox","request":{"method":"GET","header":[{"key":"X-API-Key","value":"{{apiKey}}","type":"text"},{"key":"Accept","value":"application/json","type":"text"},{"key":"X-Integration-Name","value":"{{integrationName}}","type":"text"},{"key":"X-Request-Id","value":"{{$guid}}","type":"text"}],"description":"Confirma se a chave, escopo e ambiente estao prontos para homologacao.","url":"{{baseUrl}}/api/v1/integracoes/sandbox/status"}},{"name":"Validar produto sem salvar","request":{"method":"POST","header":[{"key":"X-API-Key","value":"{{apiKey}}","type":"text"},{"key":"Accept","value":"application/json","type":"text"},{"key":"X-Integration-Name","value":"{{integrationName}}","type":"text"},{"key":"X-Request-Id","value":"{{$guid}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"description":"Valida payload de produto sem criar anuncio real.","url":"{{baseUrl}}/api/v1/integracoes/sandbox/produtos/validar","body":{"mode":"raw","raw":"{\n  \"sku\": \"TESTE-001\",\n  \"nome\": \"Produto sandbox\",\n  \"preco\": 99.9,\n  \"estoque\": 10,\n  \"peso_kg\": 0.5,\n  \"largura\": 20,\n  \"altura\": 10,\n  \"comprimento\": 30\n}","options":{"raw":{"language":"json"}}}}},{"name":"Simular pedido sem salvar","request":{"method":"POST","header":[{"key":"X-API-Key","value":"{{apiKey}}","type":"text"},{"key":"Accept","value":"application/json","type":"text"},{"key":"X-Integration-Name","value":"{{integrationName}}","type":"text"},{"key":"X-Request-Id","value":"{{$guid}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"},{"key":"Idempotency-Key","value":"sandbox-pedido-{{$guid}}","type":"text"}],"description":"Simula pedido com Idempotency-Key para o integrador testar repeticao segura.","url":"{{baseUrl}}/api/v1/integracoes/sandbox/pedidos/simular","body":{"mode":"raw","raw":"{\n  \"seller_id\": \"{{sellerId}}\",\n  \"subtotal\": 199.8,\n  \"frete\": 24.5,\n  \"metodo\": \"pix\",\n  \"servico\": \"PAC\"\n}","options":{"raw":{"language":"json"}}}}},{"name":"Simular assinatura HMAC de webhook","request":{"method":"POST","header":[{"key":"X-API-Key","value":"{{apiKey}}","type":"text"},{"key":"Accept","value":"application/json","type":"text"},{"key":"X-Integration-Name","value":"{{integrationName}}","type":"text"},{"key":"X-Request-Id","value":"{{$guid}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"description":"Retorna raw_body, headers e X-Llon-Signature para validar a comparacao HMAC no sistema externo.","url":"{{baseUrl}}/api/v1/integracoes/sandbox/webhooks/assinatura","body":{"mode":"raw","raw":"{\n  \"secret\": \"{{webhookSecret}}\",\n  \"event\": \"pedido.paid\"\n}","options":{"raw":{"language":"json"}}}}},{"name":"Disparar webhook.test","request":{"method":"POST","header":[{"key":"X-API-Key","value":"{{apiKey}}","type":"text"},{"key":"Accept","value":"application/json","type":"text"},{"key":"X-Integration-Name","value":"{{integrationName}}","type":"text"},{"key":"X-Request-Id","value":"{{$guid}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"description":"Enfileira webhook de teste para webhooks ativos do vendedor.","url":"{{baseUrl}}/api/v1/integracoes/sandbox/webhooks/test","body":{"mode":"raw","raw":"{\n  \"event\": \"webhook.test\"\n}","options":{"raw":{"language":"json"}}}}}]},{"name":"2. Leitura do vendedor","description":"Consultas seguras por vendedor. A API Key so acessa o seller vinculado.","item":[{"name":"Financeiro do vendedor","request":{"method":"GET","header":[{"key":"X-API-Key","value":"{{apiKey}}","type":"text"},{"key":"Accept","value":"application/json","type":"text"},{"key":"X-Integration-Name","value":"{{integrationName}}","type":"text"},{"key":"X-Request-Id","value":"{{$guid}}","type":"text"}],"description":"","url":"{{baseUrl}}/api/v1/integracoes/vendedores/{{sellerId}}/financeiro"}},{"name":"Extrato do vendedor","request":{"method":"GET","header":[{"key":"X-API-Key","value":"{{apiKey}}","type":"text"},{"key":"Accept","value":"application/json","type":"text"},{"key":"X-Integration-Name","value":"{{integrationName}}","type":"text"},{"key":"X-Request-Id","value":"{{$guid}}","type":"text"}],"description":"","url":"{{baseUrl}}/api/v1/integracoes/vendedores/{{sellerId}}/extrato"}},{"name":"Categorias do marketplace","request":{"method":"GET","header":[{"key":"X-API-Key","value":"{{apiKey}}","type":"text"},{"key":"Accept","value":"application/json","type":"text"},{"key":"X-Integration-Name","value":"{{integrationName}}","type":"text"},{"key":"X-Request-Id","value":"{{$guid}}","type":"text"}],"description":"Use para mapear categoria_id antes de criar produto por API.","url":"{{baseUrl}}/api/v1/integracoes/categorias?limit=300"}},{"name":"Produtos do vendedor","request":{"method":"GET","header":[{"key":"X-API-Key","value":"{{apiKey}}","type":"text"},{"key":"Accept","value":"application/json","type":"text"},{"key":"X-Integration-Name","value":"{{integrationName}}","type":"text"},{"key":"X-Request-Id","value":"{{$guid}}","type":"text"}],"description":"","url":"{{baseUrl}}/api/v1/integracoes/vendedores/{{sellerId}}/produtos?limit=50&offset=0"}},{"name":"Produto por ID","request":{"method":"GET","header":[{"key":"X-API-Key","value":"{{apiKey}}","type":"text"},{"key":"Accept","value":"application/json","type":"text"},{"key":"X-Integration-Name","value":"{{integrationName}}","type":"text"},{"key":"X-Request-Id","value":"{{$guid}}","type":"text"}],"description":"","url":"{{baseUrl}}/api/v1/integracoes/vendedores/{{sellerId}}/produtos/{{produtoId}}"}},{"name":"Pedidos do vendedor","request":{"method":"GET","header":[{"key":"X-API-Key","value":"{{apiKey}}","type":"text"},{"key":"Accept","value":"application/json","type":"text"},{"key":"X-Integration-Name","value":"{{integrationName}}","type":"text"},{"key":"X-Request-Id","value":"{{$guid}}","type":"text"}],"description":"","url":"{{baseUrl}}/api/v1/integracoes/vendedores/{{sellerId}}/pedidos?limit=50&offset=0"}},{"name":"Pedido por ID","request":{"method":"GET","header":[{"key":"X-API-Key","value":"{{apiKey}}","type":"text"},{"key":"Accept","value":"application/json","type":"text"},{"key":"X-Integration-Name","value":"{{integrationName}}","type":"text"},{"key":"X-Request-Id","value":"{{$guid}}","type":"text"}],"description":"","url":"{{baseUrl}}/api/v1/integracoes/vendedores/{{sellerId}}/pedidos/{{pedidoId}}"}}]},{"name":"3. Catalogo com escrita homologada","description":"Use somente depois que a equipe liberar os escopos produtos:write e estoque:write. Todas as escritas precisam de Idempotency-Key.","item":[{"name":"Criar produto real","request":{"method":"POST","header":[{"key":"X-API-Key","value":"{{apiKey}}","type":"text"},{"key":"Accept","value":"application/json","type":"text"},{"key":"X-Integration-Name","value":"{{integrationName}}","type":"text"},{"key":"X-Request-Id","value":"{{$guid}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"},{"key":"Idempotency-Key","value":"produto-create-{{$guid}}","type":"text"}],"description":"Cria produto real para o vendedor vinculado. Requer pelo menos 3 image_urls HTTPS.","url":"{{baseUrl}}/api/v1/integracoes/vendedores/{{sellerId}}/produtos","body":{"mode":"raw","raw":"{\n  \"nome\": \"Produto homologado via API\",\n  \"descricao\": \"Produto criado pelo integrador durante homologacao, com descricao completa para validacao.\",\n  \"preco\": 99.9,\n  \"estoque\": 10,\n  \"categoria_id\": \"{{categoriaId}}\",\n  \"sku\": \"ERP-TESTE-001\",\n  \"peso_kg\": 0.5,\n  \"comprimento_cm\": 20,\n  \"largura_cm\": 20,\n  \"altura_cm\": 10,\n  \"image_urls\": [\n    \"https://cdn.exemplo.com/produto-1.jpg\",\n    \"https://cdn.exemplo.com/produto-2.jpg\",\n    \"https://cdn.exemplo.com/produto-3.jpg\"\n  ],\n  \"video_url\": \"https://cdn.exemplo.com/produto.mp4\"\n}","options":{"raw":{"language":"json"}}}}},{"name":"Editar produto real","request":{"method":"PATCH","header":[{"key":"X-API-Key","value":"{{apiKey}}","type":"text"},{"key":"Accept","value":"application/json","type":"text"},{"key":"X-Integration-Name","value":"{{integrationName}}","type":"text"},{"key":"X-Request-Id","value":"{{$guid}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"},{"key":"Idempotency-Key","value":"produto-update-{{$guid}}","type":"text"}],"description":"Atualiza somente os campos enviados. Para trocar imagens, envie image_urls com 3 a 8 URLs.","url":"{{baseUrl}}/api/v1/integracoes/vendedores/{{sellerId}}/produtos/{{produtoId}}","body":{"mode":"raw","raw":"{\n  \"nome\": \"Produto atualizado via API\",\n  \"descricao\": \"Descricao atualizada pelo integrador externo.\",\n  \"preco\": 109.9,\n  \"estoque\": 7\n}","options":{"raw":{"language":"json"}}}}},{"name":"Atualizar somente estoque","request":{"method":"PATCH","header":[{"key":"X-API-Key","value":"{{apiKey}}","type":"text"},{"key":"Accept","value":"application/json","type":"text"},{"key":"X-Integration-Name","value":"{{integrationName}}","type":"text"},{"key":"X-Request-Id","value":"{{$guid}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"},{"key":"Idempotency-Key","value":"estoque-update-{{$guid}}","type":"text"}],"description":"Rota curta para ERP atualizar saldo sem mexer no restante do cadastro.","url":"{{baseUrl}}/api/v1/integracoes/vendedores/{{sellerId}}/produtos/{{produtoId}}/estoque","body":{"mode":"raw","raw":"{\n  \"estoque\": 8\n}","options":{"raw":{"language":"json"}}}}}]},{"name":"4. Pedido, envio, NF-e e pos-venda","description":"Rotas consultivas por pedido. Use pedidoId de um pedido pertencente ao vendedor da API Key.","item":[{"name":"Pos-venda do pedido","request":{"method":"GET","header":[{"key":"X-API-Key","value":"{{apiKey}}","type":"text"},{"key":"Accept","value":"application/json","type":"text"},{"key":"X-Integration-Name","value":"{{integrationName}}","type":"text"},{"key":"X-Request-Id","value":"{{$guid}}","type":"text"}],"description":"","url":"{{baseUrl}}/api/v1/integracoes/pedidos/{{pedidoId}}/posvenda"}},{"name":"Envio e rastreio do pedido","request":{"method":"GET","header":[{"key":"X-API-Key","value":"{{apiKey}}","type":"text"},{"key":"Accept","value":"application/json","type":"text"},{"key":"X-Integration-Name","value":"{{integrationName}}","type":"text"},{"key":"X-Request-Id","value":"{{$guid}}","type":"text"}],"description":"","url":"{{baseUrl}}/api/v1/integracoes/pedidos/{{pedidoId}}/envio"}},{"name":"NF-e do pedido","request":{"method":"GET","header":[{"key":"X-API-Key","value":"{{apiKey}}","type":"text"},{"key":"Accept","value":"application/json","type":"text"},{"key":"X-Integration-Name","value":"{{integrationName}}","type":"text"},{"key":"X-Request-Id","value":"{{$guid}}","type":"text"}],"description":"","url":"{{baseUrl}}/api/v1/integracoes/pedidos/{{pedidoId}}/nfe"}},{"name":"Enviar NF-e autorizada pelo ERP","request":{"method":"POST","header":[{"key":"X-API-Key","value":"{{apiKey}}","type":"text"},{"key":"Accept","value":"application/json","type":"text"},{"key":"X-Integration-Name","value":"{{integrationName}}","type":"text"},{"key":"X-Request-Id","value":"{{$guid}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"},{"key":"Idempotency-Key","value":"nfe-{{pedidoId}}-{{$guid}}","type":"text"}],"description":"","url":"{{baseUrl}}/api/v1/integracoes/pedidos/{{pedidoId}}/nfe","body":{"mode":"raw","raw":"{\n  \"numero\": \"105\",\n  \"serie\": \"1\",\n  \"chave\": \"33260811562906000116550010000001051701854768\",\n  \"status\": \"authorized\",\n  \"danfe_url\": \"https://erp.exemplo.com/danfes/105.pdf\",\n  \"xml_url\": \"https://erp.exemplo.com/xmls/105.xml\",\n  \"protocolo\": \"333260000123456\",\n  \"emitida_em\": \"2026-08-17T15:20:23-03:00\",\n  \"provider\": \"erp_homologado\"\n}","options":{"raw":{"language":"json"}}}}}]}]}