{ "info": { "name": "Hub B2B API — Token Master", "description": "Collection do Token Master (admin).\r\n\r\nPreencha duas variáveis e todas as chamadas já saem autenticadas:\r\n\r\n- `Master Token` — token único do admin (`plux_…`) da tela Credenciais. Vira `Authorization: Bearer`.\r\n- `seller_id` — Seller ID da loja onde a requisição será feita. Vira o cabeçalho `X-Seller-Id` em toda chamada.\r\n\r\nO Master Token não fica preso a uma loja. Cada chamada entra na loja do Seller ID informado. Sem o Seller ID, a API responde 422.\r\n\r\nNas vendas de marketplace, a query `seller_id` é o ID da loja no canal (ML, Shopee, TikTok ou iFood). Ela não substitui o Seller ID do Hub.", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "variable": [ { "key": "baseUrl", "value": "https://teste.myplux.com.br/api", "type": "string", "description": "URL base. Teste: https://teste.myplux.com.br/api" }, { "key": "Master Token", "value": "", "type": "string", "description": "Master Token. Token único do admin (plux_…), na tela Credenciais. Entra em Authorization: Bearer." }, { "key": "seller_id", "value": "", "type": "string", "description": "Seller ID da loja onde a requisição será feita. Obrigatório em toda chamada. É o Seller ID da tela Credenciais dessa loja." }, { "key": "sku", "value": "ERP-001", "type": "string", "description": "SKU do produto. Usado na URL ao detalhar e atualizar." }, { "key": "produto_uuid", "value": "", "type": "string", "description": "Não é necessário na API pública. O identificador do produto é o SKU." }, { "key": "imagem_ordem", "value": "0", "type": "string", "description": "Ordem da imagem do produto." }, { "key": "tabela_preco", "value": "Atacado", "type": "string", "description": "Nome da tabela de preço." }, { "key": "forma_pagamento_uuid", "value": "", "type": "string", "description": "UUID da forma de pagamento, se for atualizar ou excluir por UUID." }, { "key": "forma_pagamento_id", "value": "12", "type": "string", "description": "ID numérico da forma de pagamento." }, { "key": "numero_pedido", "value": "PED-0001", "type": "string", "description": "Número do pedido no Hub." }, { "key": "seller_id_ml", "value": "759409162", "type": "string", "description": "ID numérico da conta no Mercado Livre. Só na query das vendas ML." }, { "key": "seller_id_shopee", "value": "", "type": "string", "description": "shop_id da Shopee. Só na query das vendas Shopee." }, { "key": "seller_id_tiktok", "value": "", "type": "string", "description": "shop_id do TikTok Shop. Só na query das vendas TikTok." }, { "key": "seller_id_ifood", "value": "", "type": "string", "description": "merchant_id do iFood. Só na query das vendas iFood." }, { "key": "order_id_ml", "value": "2000001234567890", "type": "string", "description": "order_id da venda no Mercado Livre." }, { "key": "order_sn_shopee", "value": "", "type": "string", "description": "order_sn da venda na Shopee." }, { "key": "order_id_tiktok", "value": "", "type": "string", "description": "order_id da venda no TikTok Shop." }, { "key": "order_id_ifood", "value": "", "type": "string", "description": "order_id da venda no iFood." } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{Master Token}}", "type": "string" } ] }, "event": [ { "listen": "prerequest", "script": { "type": "text/javascript", "exec": [ "const sellerId = pm.variables.get('seller_id') || '';", "if (!String(sellerId).trim()) {", " console.warn('Passe o Seller ID da loja na variável seller_id. Toda chamada do Token Master precisa do cabeçalho X-Seller-Id.');", "}", "pm.request.headers.upsert({ key: 'X-Seller-Id', value: String(sellerId) });" ] } } ], "item": [ { "name": "Autenticação", "description": "Cole o Master Token (plux_ da tela Credenciais do admin) na variável Master Token. Em toda chamada, passe o Seller ID da loja na variável seller_id. Esse Seller ID vira o cabeçalho X-Seller-Id e escolhe a loja.", "item": [ { "name": "Conferir token e Seller ID", "request": { "method": "GET", "url": "{{baseUrl}}/usuarios/me", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nDeve responder 200. Se vier 422, falta X-Seller-Id. Se vier 401, o token ou o Seller ID não confere.\n\nConferir token e Seller ID.\n\n`GET {{baseUrl}}/usuarios/me`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ] }, "response": [ { "name": "Exemplo OK", "originalRequest": { "method": "GET", "url": "{{baseUrl}}/usuarios/me", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nDeve responder 200. Se vier 422, falta X-Seller-Id. Se vier 401, o token ou o Seller ID não confere.\n\nConferir token e Seller ID.\n\n`GET {{baseUrl}}/usuarios/me`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ] }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\"id\":1,\"nome\":\"Conta\",\"seller_id\":\"SEU_SELLER_ID\"}" } ] } ] }, { "name": "Categorias", "item": [ { "name": "Listar categorias", "request": { "method": "GET", "url": "{{baseUrl}}/categorias", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nListar categorias.\n\n`GET {{baseUrl}}/categorias`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`." }, "response": [ { "name": "Exemplo OK", "originalRequest": { "method": "GET", "url": "{{baseUrl}}/categorias", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nListar categorias.\n\n`GET {{baseUrl}}/categorias`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`." }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\"categorias\":[{\"nome\":\"Vestuário\",\"subcategorias\":[{\"caminho\":\"Camisetas > Básicas\"}]}]}" } ] }, { "name": "Detalhar categoria", "request": { "method": "GET", "url": "{{baseUrl}}/categorias/Vestuário", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nDetalhar categoria.\n\n`GET {{baseUrl}}/categorias/Vestuário`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`." }, "response": [ { "name": "Exemplo OK", "originalRequest": { "method": "GET", "url": "{{baseUrl}}/categorias/Vestuário", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nDetalhar categoria.\n\n`GET {{baseUrl}}/categorias/Vestuário`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`." }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\"categoria\":{\"nome\":\"Vestuário\",\"subcategorias\":[{\"caminho\":\"Camisetas > Básicas\"}]}}" } ] }, { "name": "Criar categoria", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nome\": \"Vestuário\"\n}" }, "url": "{{baseUrl}}/categorias", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nCriar categoria.\n\n`POST {{baseUrl}}/categorias`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"nome\": \"Vestuário\"\n}\n```" }, "response": [ { "name": "Exemplo Created", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nome\": \"Vestuário\"\n}" }, "url": "{{baseUrl}}/categorias", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nCriar categoria.\n\n`POST {{baseUrl}}/categorias`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"nome\": \"Vestuário\"\n}\n```" }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\"message\":\"Categoria criada.\",\"categoria\":{\"nome\":\"Vestuário\",\"subcategorias\":[]}}" } ] }, { "name": "Criar subcategoria", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"caminho\": \"Camisetas > Básicas\"\n}" }, "url": "{{baseUrl}}/categorias/Vestuário/subcategorias", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nCriar subcategoria.\n\n`POST {{baseUrl}}/categorias/Vestuário/subcategorias`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"caminho\": \"Camisetas > Básicas\"\n}\n```" }, "response": [ { "name": "Exemplo Created", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"caminho\": \"Camisetas > Básicas\"\n}" }, "url": "{{baseUrl}}/categorias/Vestuário/subcategorias", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nCriar subcategoria.\n\n`POST {{baseUrl}}/categorias/Vestuário/subcategorias`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"caminho\": \"Camisetas > Básicas\"\n}\n```" }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\"message\":\"Subcategoria criada.\",\"subcategoria\":{\"caminho\":\"Camisetas > Básicas\"}}" } ] }, { "name": "Renomear categoria", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nome\": \"Vestuário\"\n}" }, "url": "{{baseUrl}}/categorias/Vestuário", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nRenomear categoria.\n\n`PATCH {{baseUrl}}/categorias/Vestuário`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"nome\": \"Vestuário\"\n}\n```" }, "response": [ { "name": "Exemplo OK", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nome\": \"Vestuário\"\n}" }, "url": "{{baseUrl}}/categorias/Vestuário", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nRenomear categoria.\n\n`PATCH {{baseUrl}}/categorias/Vestuário`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"nome\": \"Vestuário\"\n}\n```" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\"message\":\"Categoria atualizada.\",\"categoria\":{\"nome\":\"Vestuário\"}}" } ] } ] }, { "name": "Unidades de medida", "item": [ { "name": "Listar unidades", "request": { "method": "GET", "url": "{{baseUrl}}/unidades-medida", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nListar unidades.\n\n`GET {{baseUrl}}/unidades-medida`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`." }, "response": [ { "name": "Exemplo OK", "originalRequest": { "method": "GET", "url": "{{baseUrl}}/unidades-medida", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nListar unidades.\n\n`GET {{baseUrl}}/unidades-medida`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`." }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\"unidades\":[{\"nome\":\"Unidade\",\"sigla\":\"UN\"}]}" } ] }, { "name": "Detalhar unidade", "request": { "method": "GET", "url": "{{baseUrl}}/unidades-medida/UN", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nDetalhar unidade.\n\n`GET {{baseUrl}}/unidades-medida/UN`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`." }, "response": [ { "name": "Exemplo OK", "originalRequest": { "method": "GET", "url": "{{baseUrl}}/unidades-medida/UN", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nDetalhar unidade.\n\n`GET {{baseUrl}}/unidades-medida/UN`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`." }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\"unidade\":{\"nome\":\"Unidade\",\"sigla\":\"UN\"}}" } ] }, { "name": "Criar unidade", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nome\": \"Unidade\",\n \"sigla\": \"UN\"\n}" }, "url": "{{baseUrl}}/unidades-medida", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nCriar unidade.\n\n`POST {{baseUrl}}/unidades-medida`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"nome\": \"Unidade\",\n \"sigla\": \"UN\"\n}\n```" }, "response": [ { "name": "Exemplo Created", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nome\": \"Unidade\",\n \"sigla\": \"UN\"\n}" }, "url": "{{baseUrl}}/unidades-medida", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nCriar unidade.\n\n`POST {{baseUrl}}/unidades-medida`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"nome\": \"Unidade\",\n \"sigla\": \"UN\"\n}\n```" }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\"message\":\"Unidade de medida criada.\",\"unidade\":{\"nome\":\"Unidade\",\"sigla\":\"UN\"}}" } ] }, { "name": "Atualizar unidade", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nome\": \"Unidade\",\n \"sigla\": \"UN\"\n}" }, "url": "{{baseUrl}}/unidades-medida/UN", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nAtualizar unidade.\n\n`PATCH {{baseUrl}}/unidades-medida/UN`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"nome\": \"Unidade\",\n \"sigla\": \"UN\"\n}\n```" }, "response": [ { "name": "Exemplo OK", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nome\": \"Unidade\",\n \"sigla\": \"UN\"\n}" }, "url": "{{baseUrl}}/unidades-medida/UN", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nAtualizar unidade.\n\n`PATCH {{baseUrl}}/unidades-medida/UN`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"nome\": \"Unidade\",\n \"sigla\": \"UN\"\n}\n```" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\"message\":\"Unidade de medida atualizada.\",\"unidade\":{\"nome\":\"Unidade\",\"sigla\":\"UN\"}}" } ] } ] }, { "name": "Variações", "item": [ { "name": "Listar variações", "request": { "method": "GET", "url": "{{baseUrl}}/variacoes", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nListar variações.\n\n`GET {{baseUrl}}/variacoes`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`." }, "response": [ { "name": "Exemplo OK", "originalRequest": { "method": "GET", "url": "{{baseUrl}}/variacoes", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nListar variações.\n\n`GET {{baseUrl}}/variacoes`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`." }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\"variacoes\":[{\"nome\":\"Tamanho e Cor\",\"opcoes\":[{\"nome\":\"P AZUL\",\"ordem\":1}]}]}" } ] }, { "name": "Detalhar variação", "request": { "method": "GET", "url": "{{baseUrl}}/variacoes/Tamanho e Cor", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nDetalhar variação.\n\n`GET {{baseUrl}}/variacoes/Tamanho e Cor`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`." }, "response": [ { "name": "Exemplo OK", "originalRequest": { "method": "GET", "url": "{{baseUrl}}/variacoes/Tamanho e Cor", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nDetalhar variação.\n\n`GET {{baseUrl}}/variacoes/Tamanho e Cor`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`." }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\"variacao\":{\"nome\":\"Tamanho e Cor\",\"opcoes\":[{\"nome\":\"P AZUL\",\"ordem\":1},{\"nome\":\"M BRANCO\",\"ordem\":2}]}}" } ] }, { "name": "Criar variação", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nome\": \"Tamanho e Cor\",\n \"opcoes\": [\"P AZUL\", \"M BRANCO\"]\n}" }, "url": "{{baseUrl}}/variacoes", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nCriar variação.\n\n`POST {{baseUrl}}/variacoes`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"nome\": \"Tamanho e Cor\",\n \"opcoes\": [\"P AZUL\", \"M BRANCO\"]\n}\n```" }, "response": [ { "name": "Exemplo Created", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nome\": \"Tamanho e Cor\",\n \"opcoes\": [\"P AZUL\", \"M BRANCO\"]\n}" }, "url": "{{baseUrl}}/variacoes", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nCriar variação.\n\n`POST {{baseUrl}}/variacoes`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"nome\": \"Tamanho e Cor\",\n \"opcoes\": [\"P AZUL\", \"M BRANCO\"]\n}\n```" }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\"message\":\"Variação criada.\",\"variacao\":{\"nome\":\"Tamanho e Cor\",\"opcoes\":[{\"nome\":\"P AZUL\"},{\"nome\":\"M BRANCO\"}]}}" } ] }, { "name": "Atualizar variação", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nome\": \"Tamanho e Cor\"\n}" }, "url": "{{baseUrl}}/variacoes/Tamanho e Cor", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nAtualizar variação.\n\n`PATCH {{baseUrl}}/variacoes/Tamanho e Cor`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"nome\": \"Tamanho e Cor\"\n}\n```" }, "response": [ { "name": "Exemplo OK", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nome\": \"Tamanho e Cor\"\n}" }, "url": "{{baseUrl}}/variacoes/Tamanho e Cor", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nAtualizar variação.\n\n`PATCH {{baseUrl}}/variacoes/Tamanho e Cor`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"nome\": \"Tamanho e Cor\"\n}\n```" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\"message\":\"Variação atualizada.\",\"variacao\":{\"nome\":\"Tamanho e Cor\"}}" } ] }, { "name": "Adicionar opção", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nome\": \"G PRETO\"\n}" }, "url": "{{baseUrl}}/variacoes/Tamanho e Cor/opcoes", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nAdicionar opção.\n\n`POST {{baseUrl}}/variacoes/Tamanho e Cor/opcoes`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"nome\": \"G PRETO\"\n}\n```" }, "response": [ { "name": "Exemplo Created", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nome\": \"G PRETO\"\n}" }, "url": "{{baseUrl}}/variacoes/Tamanho e Cor/opcoes", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nAdicionar opção.\n\n`POST {{baseUrl}}/variacoes/Tamanho e Cor/opcoes`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"nome\": \"G PRETO\"\n}\n```" }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\"message\":\"Opção criada.\",\"opcao\":{\"nome\":\"G PRETO\"}}" } ] } ] }, { "name": "Adicionais", "item": [ { "name": "Listar adicionais", "request": { "method": "GET", "url": "{{baseUrl}}/adicionais", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nListar adicionais.\n\n`GET {{baseUrl}}/adicionais`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`." }, "response": [ { "name": "Exemplo OK", "originalRequest": { "method": "GET", "url": "{{baseUrl}}/adicionais", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nListar adicionais.\n\n`GET {{baseUrl}}/adicionais`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`." }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\"adicionais\":[{\"nome\":\"Bebidas\",\"tipo\":\"OFFER_UNIT\",\"min\":1,\"max\":2,\"opcoes\":[{\"nome\":\"Coca-Cola\",\"preco\":1}]}]}" } ] }, { "name": "Detalhar adicional", "request": { "method": "GET", "url": "{{baseUrl}}/adicionais/Bebidas", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nDetalhar adicional.\n\n`GET {{baseUrl}}/adicionais/Bebidas`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`." }, "response": [ { "name": "Exemplo OK", "originalRequest": { "method": "GET", "url": "{{baseUrl}}/adicionais/Bebidas", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nDetalhar adicional.\n\n`GET {{baseUrl}}/adicionais/Bebidas`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`." }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\"adicional\":{\"nome\":\"Bebidas\",\"tipo\":\"OFFER_UNIT\",\"min\":1,\"max\":2,\"opcoes\":[{\"nome\":\"Coca-Cola\",\"preco\":1}]}}" } ] }, { "name": "Criar adicional", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nome\": \"Bebidas\",\n \"tipo\": \"OFFER_UNIT\",\n \"min\": 0,\n \"max\": 1,\n \"opcoes\": [\n { \"sku\": \"REFRI-001\", \"preco\": 0 },\n { \"sku\": \"REFRI-002\", \"preco\": 6.5 }\n ]\n}" }, "url": "{{baseUrl}}/adicionais", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nCriar adicional.\n\n`POST {{baseUrl}}/adicionais`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"nome\": \"Bebidas\",\n \"tipo\": \"OFFER_UNIT\",\n \"min\": 0,\n \"max\": 1,\n \"opcoes\": [\n { \"sku\": \"REFRI-001\", \"preco\": 0 },\n { \"sku\": \"REFRI-002\", \"preco\": 6.5 }\n ]\n}\n```" }, "response": [ { "name": "Exemplo Created", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nome\": \"Bebidas\",\n \"tipo\": \"OFFER_UNIT\",\n \"min\": 0,\n \"max\": 1,\n \"opcoes\": [\n { \"sku\": \"REFRI-001\", \"preco\": 0 },\n { \"sku\": \"REFRI-002\", \"preco\": 6.5 }\n ]\n}" }, "url": "{{baseUrl}}/adicionais", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nCriar adicional.\n\n`POST {{baseUrl}}/adicionais`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"nome\": \"Bebidas\",\n \"tipo\": \"OFFER_UNIT\",\n \"min\": 0,\n \"max\": 1,\n \"opcoes\": [\n { \"sku\": \"REFRI-001\", \"preco\": 0 },\n { \"sku\": \"REFRI-002\", \"preco\": 6.5 }\n ]\n}\n```" }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\"message\":\"Adicional criado.\",\"adicional\":{\"nome\":\"Bebidas\",\"tipo\":\"OFFER_UNIT\",\"min\":1,\"max\":2}}" } ] }, { "name": "Atualizar adicional", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nome\": \"Bebidas\",\n \"tipo\": \"OFFER_UNIT\",\n \"min\": 1,\n \"max\": 2\n}" }, "url": "{{baseUrl}}/adicionais/Bebidas", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nAtualizar adicional.\n\n`PATCH {{baseUrl}}/adicionais/Bebidas`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"nome\": \"Bebidas\",\n \"tipo\": \"OFFER_UNIT\",\n \"min\": 1,\n \"max\": 2\n}\n```" }, "response": [ { "name": "Exemplo OK", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nome\": \"Bebidas\",\n \"tipo\": \"OFFER_UNIT\",\n \"min\": 1,\n \"max\": 2\n}" }, "url": "{{baseUrl}}/adicionais/Bebidas", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nAtualizar adicional.\n\n`PATCH {{baseUrl}}/adicionais/Bebidas`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"nome\": \"Bebidas\",\n \"tipo\": \"OFFER_UNIT\",\n \"min\": 1,\n \"max\": 2\n}\n```" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\"message\":\"Adicional atualizado.\",\"adicional\":{\"nome\":\"Bebidas\",\"tipo\":\"OFFER_UNIT\",\"min\":1,\"max\":2}}" } ] }, { "name": "Adicionar opção", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nome\": \"Guaraná\",\n \"preco\": 1.5\n}" }, "url": "{{baseUrl}}/adicionais/Bebidas/opcoes", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nAdicionar opção.\n\n`POST {{baseUrl}}/adicionais/Bebidas/opcoes`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"nome\": \"Guaraná\",\n \"preco\": 1.5\n}\n```" }, "response": [ { "name": "Exemplo Created", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nome\": \"Guaraná\",\n \"preco\": 1.5\n}" }, "url": "{{baseUrl}}/adicionais/Bebidas/opcoes", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nAdicionar opção.\n\n`POST {{baseUrl}}/adicionais/Bebidas/opcoes`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"nome\": \"Guaraná\",\n \"preco\": 1.5\n}\n```" }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\"message\":\"Opção criada.\",\"opcao\":{\"nome\":\"Guaraná\",\"preco\":1.5}}" } ] } ] }, { "name": "Produtos", "item": [ { "name": "Listar produtos", "request": { "method": "GET", "url": "{{baseUrl}}/produtos?page=1&per_page=20", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nLista os produtos da conta, paginado.\n\n`GET {{baseUrl}}/produtos?page=1&per_page=20`\n\n`page` começa em 1. `per_page` padrão 20, máximo 100.\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`." }, "response": [ { "name": "Exemplo OK", "originalRequest": { "method": "GET", "url": "{{baseUrl}}/produtos?sku=&nome=&categoria=&status=&page=1", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nListar produtos.\n\n`GET {{baseUrl}}/produtos?sku=&nome=&categoria=&status=&page=1`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`." }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\"data\":[{\"sku\":\"ERP-001\",\"nome\":\"Produto Exemplo\",\"status\":\"ativo\"}]}" } ] }, { "name": "Criar produto", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"sku\": \"{{sku}}\",\n \"codigo_barras\": \"7891234567890\",\n \"nome\": \"Produto Exemplo\",\n \"categoria\": \"Geral\",\n \"subcategoria\": \"Linha A\",\n \"descricao\": \"Descrição do produto\",\n \"marca\": \"Marca Exemplo\",\n \"custo\": 50,\n \"preco_venda\": 99.90,\n \"quantidade_estoque\": 10,\n \"estoque_minimo\": 2,\n \"unidade\": \"UN\",\n \"altura_cm\": 10,\n \"largura_cm\": 20,\n \"comprimento_cm\": 30,\n \"peso_kg\": 1.5,\n \"imagem\": \"https://erp.exemplo.com/imgs_produtos/produto.jpg\",\n \"status\": \"ativo\"\n}" }, "url": "{{baseUrl}}/produtos", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nCriar produto.\n\n`POST {{baseUrl}}/produtos`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"sku\": \"{{sku}}\",\n \"codigo_barras\": \"7891234567890\",\n \"nome\": \"Produto Exemplo\",\n \"categoria\": \"Geral\",\n \"subcategoria\": \"Linha A\",\n \"descricao\": \"Descrição do produto\",\n \"marca\": \"Marca Exemplo\",\n \"custo\": 50,\n \"preco_venda\": 99.90,\n \"quantidade_estoque\": 10,\n \"estoque_minimo\": 2,\n \"unidade\": \"UN\",\n \"altura_cm\": 10,\n \"largura_cm\": 20,\n \"comprimento_cm\": 30,\n \"peso_kg\": 1.5,\n \"imagem\": \"https://erp.exemplo.com/imgs_produtos/produto.jpg\",\n \"status\": \"ativo\"\n}\n```" }, "response": [ { "name": "Exemplo Created", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"sku\": \"{{sku}}\",\n \"codigo_barras\": \"7891234567890\",\n \"nome\": \"Produto Exemplo\",\n \"categoria\": \"Geral\",\n \"subcategoria\": \"Linha A\",\n \"descricao\": \"Descrição do produto\",\n \"marca\": \"Marca Exemplo\",\n \"custo\": 50,\n \"preco_venda\": 99.90,\n \"quantidade_estoque\": 10,\n \"estoque_minimo\": 2,\n \"unidade\": \"UN\",\n \"altura_cm\": 10,\n \"largura_cm\": 20,\n \"comprimento_cm\": 30,\n \"peso_kg\": 1.5,\n \"imagem\": \"https://erp.exemplo.com/imgs_produtos/produto.jpg\",\n \"status\": \"ativo\"\n}" }, "url": "{{baseUrl}}/produtos", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nCriar produto.\n\n`POST {{baseUrl}}/produtos`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"sku\": \"{{sku}}\",\n \"codigo_barras\": \"7891234567890\",\n \"nome\": \"Produto Exemplo\",\n \"categoria\": \"Geral\",\n \"subcategoria\": \"Linha A\",\n \"descricao\": \"Descrição do produto\",\n \"marca\": \"Marca Exemplo\",\n \"custo\": 50,\n \"preco_venda\": 99.90,\n \"quantidade_estoque\": 10,\n \"estoque_minimo\": 2,\n \"unidade\": \"UN\",\n \"altura_cm\": 10,\n \"largura_cm\": 20,\n \"comprimento_cm\": 30,\n \"peso_kg\": 1.5,\n \"imagem\": \"https://erp.exemplo.com/imgs_produtos/produto.jpg\",\n \"status\": \"ativo\"\n}\n```" }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\"message\":\"Produto criado.\",\"produto\":{\"sku\":\"ERP-001\",\"nome\":\"Produto Exemplo\",\"preco\":99.9,\"estoque\":10,\"status\":\"ativo\"}}" } ] }, { "name": "Criar produto com grade", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"sku\": \"ERP-GRADE-001\",\n \"codigo_barras\": \"7891234567890\",\n \"nome\": \"Produto do ERP\",\n \"categoria\": \"Eletrônicos\",\n \"subcategoria\": \"Celulares > Smartphones\",\n \"descricao\": \"Descrição completa do produto.\",\n \"marca\": \"Marca Exemplo\",\n \"custo\": 1200,\n \"preco_venda\": 1999.9,\n \"quantidade_estoque\": 50,\n \"estoque_minimo\": 5,\n \"unidade\": \"UN\",\n \"altura_cm\": 10,\n \"largura_cm\": 20,\n \"comprimento_cm\": 30,\n \"peso_kg\": 1.5,\n \"imagem\": \"https://erp.exemplo.com/imgs_produtos/produto.jpg\",\n \"status\": \"ativo\",\n \"variacao\": {\n \"nome\": \"Tamanho e Cor\",\n \"opcoes\": [\n { \"nome\": \"P AZUL\", \"estoque\": 5, \"custo\": 20, \"preco\": 49.9 },\n { \"nome\": \"M BRANCO\", \"estoque\": 8, \"custo\": 22, \"preco\": 54.9 }\n ]\n }\n}" }, "url": "{{baseUrl}}/produtos", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nCriar produto com grade.\n\n`POST {{baseUrl}}/produtos`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"sku\": \"ERP-GRADE-001\",\n \"codigo_barras\": \"7891234567890\",\n \"nome\": \"Produto do ERP\",\n \"categoria\": \"Eletrônicos\",\n \"subcategoria\": \"Celulares > Smartphones\",\n \"descricao\": \"Descrição completa do produto.\",\n \"marca\": \"Marca Exemplo\",\n \"custo\": 1200,\n \"preco_venda\": 1999.9,\n \"quantidade_estoque\": 50,\n \"estoque_minimo\": 5,\n \"unidade\": \"UN\",\n \"altura_cm\": 10,\n \"largura_cm\": 20,\n \"comprimento_cm\": 30,\n \"peso_kg\": 1.5,\n \"imagem\": \"https://erp.exemplo.com/imgs_produtos/produto.jpg\",\n \"status\": \"ativo\",\n \"variacao\": {\n \"nome\": \"Tamanho e Cor\",\n \"opcoes\": [\n { \"nome\": \"P AZUL\", \"estoque\": 5, \"custo\": 20, \"preco\": 49.9 },\n { \"nome\": \"M BRANCO\", \"estoque\": 8, \"custo\": 22, \"preco\": 54.9 }\n ]\n }\n}\n```" }, "response": [ { "name": "Exemplo Created", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"sku\": \"ERP-GRADE-001\",\n \"codigo_barras\": \"7891234567890\",\n \"nome\": \"Produto do ERP\",\n \"categoria\": \"Eletrônicos\",\n \"subcategoria\": \"Celulares > Smartphones\",\n \"descricao\": \"Descrição completa do produto.\",\n \"marca\": \"Marca Exemplo\",\n \"custo\": 1200,\n \"preco_venda\": 1999.9,\n \"quantidade_estoque\": 50,\n \"estoque_minimo\": 5,\n \"unidade\": \"UN\",\n \"altura_cm\": 10,\n \"largura_cm\": 20,\n \"comprimento_cm\": 30,\n \"peso_kg\": 1.5,\n \"imagem\": \"https://erp.exemplo.com/imgs_produtos/produto.jpg\",\n \"status\": \"ativo\",\n \"variacao\": {\n \"nome\": \"Tamanho e Cor\",\n \"opcoes\": [\n { \"nome\": \"P AZUL\", \"estoque\": 5, \"custo\": 20, \"preco\": 49.9 },\n { \"nome\": \"M BRANCO\", \"estoque\": 8, \"custo\": 22, \"preco\": 54.9 }\n ]\n }\n}" }, "url": "{{baseUrl}}/produtos", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nCriar produto com grade.\n\n`POST {{baseUrl}}/produtos`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"sku\": \"ERP-GRADE-001\",\n \"codigo_barras\": \"7891234567890\",\n \"nome\": \"Produto do ERP\",\n \"categoria\": \"Eletrônicos\",\n \"subcategoria\": \"Celulares > Smartphones\",\n \"descricao\": \"Descrição completa do produto.\",\n \"marca\": \"Marca Exemplo\",\n \"custo\": 1200,\n \"preco_venda\": 1999.9,\n \"quantidade_estoque\": 50,\n \"estoque_minimo\": 5,\n \"unidade\": \"UN\",\n \"altura_cm\": 10,\n \"largura_cm\": 20,\n \"comprimento_cm\": 30,\n \"peso_kg\": 1.5,\n \"imagem\": \"https://erp.exemplo.com/imgs_produtos/produto.jpg\",\n \"status\": \"ativo\",\n \"variacao\": {\n \"nome\": \"Tamanho e Cor\",\n \"opcoes\": [\n { \"nome\": \"P AZUL\", \"estoque\": 5, \"custo\": 20, \"preco\": 49.9 },\n { \"nome\": \"M BRANCO\", \"estoque\": 8, \"custo\": 22, \"preco\": 54.9 }\n ]\n }\n}\n```" }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\"message\":\"Produto criado.\",\"produto\":{\"sku\":\"ERP-GRADE-001\",\"is_grade\":true,\"variacao\":{\"nome\":\"Tamanho e Cor\"},\"grade_itens\":[{\"opcao\":\"P AZUL\",\"estoque\":5,\"preco\":49.9}]}}" } ] }, { "name": "Criar produto com adicionais", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"sku\": \"PIZZA-001\",\n \"codigo_barras\": \"7891234567890\",\n \"nome\": \"Pizza\",\n \"categoria\": \"Pizzas\",\n \"subcategoria\": \"Salgadas\",\n \"descricao\": \"Descrição completa do produto.\",\n \"marca\": \"Marca Exemplo\",\n \"custo\": 12,\n \"preco_venda\": 39.9,\n \"quantidade_estoque\": 10,\n \"estoque_minimo\": 2,\n \"unidade\": \"UN\",\n \"altura_cm\": 4,\n \"largura_cm\": 30,\n \"comprimento_cm\": 30,\n \"peso_kg\": 0.8,\n \"imagem\": \"https://erp.exemplo.com/imgs_produtos/pizza.jpg\",\n \"status\": \"ativo\",\n \"tem_adicionais\": true,\n \"adicionais\": [\n {\n \"nome\": \"Bebidas\",\n \"tipo\": \"OFFER_UNIT\",\n \"min\": 1,\n \"max\": 2,\n \"opcoes\": [\n { \"nome\": \"Coca-Cola\", \"preco\": 1, \"ativo\": true },\n { \"nome\": \"Pepsi\", \"preco\": 2, \"ativo\": false }\n ]\n }\n ]\n}" }, "url": "{{baseUrl}}/produtos", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nCriar produto com adicionais.\n\n`POST {{baseUrl}}/produtos`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"sku\": \"PIZZA-001\",\n \"codigo_barras\": \"7891234567890\",\n \"nome\": \"Pizza\",\n \"categoria\": \"Pizzas\",\n \"subcategoria\": \"Salgadas\",\n \"descricao\": \"Descrição completa do produto.\",\n \"marca\": \"Marca Exemplo\",\n \"custo\": 12,\n \"preco_venda\": 39.9,\n \"quantidade_estoque\": 10,\n \"estoque_minimo\": 2,\n \"unidade\": \"UN\",\n \"altura_cm\": 4,\n \"largura_cm\": 30,\n \"comprimento_cm\": 30,\n \"peso_kg\": 0.8,\n \"imagem\": \"https://erp.exemplo.com/imgs_produtos/pizza.jpg\",\n \"status\": \"ativo\",\n \"tem_adicionais\": true,\n \"adicionais\": [\n {\n \"nome\": \"Bebidas\",\n \"tipo\": \"OFFER_UNIT\",\n \"min\": 1,\n \"max\": 2,\n \"opcoes\": [\n { \"nome\": \"Coca-Cola\", \"preco\": 1, \"ativo\": true },\n { \"nome\": \"Pepsi\", \"preco\": 2, \"ativo\": false }\n ]\n }\n ]\n}\n```" }, "response": [ { "name": "Exemplo Created", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"sku\": \"PIZZA-001\",\n \"codigo_barras\": \"7891234567890\",\n \"nome\": \"Pizza\",\n \"categoria\": \"Pizzas\",\n \"subcategoria\": \"Salgadas\",\n \"descricao\": \"Descrição completa do produto.\",\n \"marca\": \"Marca Exemplo\",\n \"custo\": 12,\n \"preco_venda\": 39.9,\n \"quantidade_estoque\": 10,\n \"estoque_minimo\": 2,\n \"unidade\": \"UN\",\n \"altura_cm\": 4,\n \"largura_cm\": 30,\n \"comprimento_cm\": 30,\n \"peso_kg\": 0.8,\n \"imagem\": \"https://erp.exemplo.com/imgs_produtos/pizza.jpg\",\n \"status\": \"ativo\",\n \"tem_adicionais\": true,\n \"adicionais\": [\n {\n \"nome\": \"Bebidas\",\n \"tipo\": \"OFFER_UNIT\",\n \"min\": 1,\n \"max\": 2,\n \"opcoes\": [\n { \"nome\": \"Coca-Cola\", \"preco\": 1, \"ativo\": true },\n { \"nome\": \"Pepsi\", \"preco\": 2, \"ativo\": false }\n ]\n }\n ]\n}" }, "url": "{{baseUrl}}/produtos", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nCriar produto com adicionais.\n\n`POST {{baseUrl}}/produtos`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"sku\": \"PIZZA-001\",\n \"codigo_barras\": \"7891234567890\",\n \"nome\": \"Pizza\",\n \"categoria\": \"Pizzas\",\n \"subcategoria\": \"Salgadas\",\n \"descricao\": \"Descrição completa do produto.\",\n \"marca\": \"Marca Exemplo\",\n \"custo\": 12,\n \"preco_venda\": 39.9,\n \"quantidade_estoque\": 10,\n \"estoque_minimo\": 2,\n \"unidade\": \"UN\",\n \"altura_cm\": 4,\n \"largura_cm\": 30,\n \"comprimento_cm\": 30,\n \"peso_kg\": 0.8,\n \"imagem\": \"https://erp.exemplo.com/imgs_produtos/pizza.jpg\",\n \"status\": \"ativo\",\n \"tem_adicionais\": true,\n \"adicionais\": [\n {\n \"nome\": \"Bebidas\",\n \"tipo\": \"OFFER_UNIT\",\n \"min\": 1,\n \"max\": 2,\n \"opcoes\": [\n { \"nome\": \"Coca-Cola\", \"preco\": 1, \"ativo\": true },\n { \"nome\": \"Pepsi\", \"preco\": 2, \"ativo\": false }\n ]\n }\n ]\n}\n```" }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\"message\":\"Produto criado.\",\"produto\":{\"sku\":\"PIZZA-001\",\"tem_adicionais\":true,\"adicionais\":[{\"nome\":\"Bebidas\",\"opcoes\":[{\"nome\":\"Coca-Cola\",\"preco\":1,\"ativo\":true}]}]}}" } ] }, { "name": "Atualizar produto simples", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nome\": \"Produto Exemplo atualizado\",\n \"preco_venda\": 109.9,\n \"quantidade_estoque\": 8\n}" }, "url": "{{baseUrl}}/produtos/{{sku}}", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nAtualiza o produto simples pelo SKU. Só grava o campo que mudou. Se o valor for igual ao salvo, o campo fica como está.\n\n`PATCH {{baseUrl}}/produtos/{{sku}}`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`." } }, { "name": "Atualizar produto com grade", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"sku\": \"ERP-GRADE-001\",\n \"nome\": \"Produto do ERP\",\n \"variacao\": {\n \"nome\": \"Tamanho e Cor\",\n \"opcoes\": [\n {\n \"nome\": \"P AZUL\",\n \"estoque\": 6,\n \"custo\": 20,\n \"preco\": 49.9\n },\n {\n \"nome\": \"M BRANCO\",\n \"estoque\": 8,\n \"custo\": 22,\n \"preco\": 54.9\n }\n ]\n }\n}" }, "url": "{{baseUrl}}/produtos/ERP-GRADE-001", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nMesmo JSON da grade. A opção que veio igual não é regravada. A que mudou é atualizada.\n\n`PATCH {{baseUrl}}/produtos/ERP-GRADE-001`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`." } }, { "name": "Atualizar produto com adicionais", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"sku\": \"LANCHE-001\",\n \"nome\": \"Lanche\",\n \"tem_adicionais\": true,\n \"adicionais\": [\n {\n \"nome\": \"Bebidas\",\n \"tipo\": \"OFFER_UNIT\",\n \"min\": 1,\n \"max\": 2,\n \"opcoes\": [\n {\n \"nome\": \"Coca-Cola\",\n \"preco\": 2,\n \"ativo\": true\n }\n ]\n }\n ]\n}" }, "url": "{{baseUrl}}/produtos/LANCHE-001", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nMesmo JSON de adicionais. Só grava grupo, opção ou campo do produto que veio diferente.\n\n`PATCH {{baseUrl}}/produtos/LANCHE-001`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`." } } ] }, { "name": "Tabelas de Preço", "item": [ { "name": "Listar tabelas", "request": { "method": "GET", "url": "{{baseUrl}}/tabelas-preco", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nListar tabelas.\n\n`GET {{baseUrl}}/tabelas-preco`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`." }, "response": [ { "name": "Exemplo OK", "originalRequest": { "method": "GET", "url": "{{baseUrl}}/tabelas-preco", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nListar tabelas.\n\n`GET {{baseUrl}}/tabelas-preco`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`." }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\"tabelas\":[{\"nome\":\"Atacado\",\"status\":\"ativo\"}]}" } ] }, { "name": "Detalhar tabela", "request": { "method": "GET", "url": "{{baseUrl}}/tabelas-preco/{{tabela_preco}}", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nDetalhar tabela.\n\n`GET {{baseUrl}}/tabelas-preco/{{tabela_preco}}`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`." }, "response": [ { "name": "Exemplo OK", "originalRequest": { "method": "GET", "url": "{{baseUrl}}/tabelas-preco/{{tabela_preco}}", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nDetalhar tabela.\n\n`GET {{baseUrl}}/tabelas-preco/{{tabela_preco}}`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`." }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\"tabela\":{\"nome\":\"Atacado\",\"status\":\"ativo\"}}" } ] }, { "name": "Criar tabela", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nome\": \"{{tabela_preco}}\",\n \"descricao\": \"Tabela importada do ERP\",\n \"status\": \"ativo\"\n}" }, "url": "{{baseUrl}}/tabelas-preco", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nCriar tabela.\n\n`POST {{baseUrl}}/tabelas-preco`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"nome\": \"{{tabela_preco}}\",\n \"descricao\": \"Tabela importada do ERP\",\n \"status\": \"ativo\"\n}\n```" }, "response": [ { "name": "Exemplo Created", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nome\": \"{{tabela_preco}}\",\n \"descricao\": \"Tabela importada do ERP\",\n \"status\": \"ativo\"\n}" }, "url": "{{baseUrl}}/tabelas-preco", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nCriar tabela.\n\n`POST {{baseUrl}}/tabelas-preco`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"nome\": \"{{tabela_preco}}\",\n \"descricao\": \"Tabela importada do ERP\",\n \"status\": \"ativo\"\n}\n```" }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\"message\":\"Tabela de preços criada.\",\"tabela\":{\"nome\":\"Atacado\",\"status\":\"ativo\"}}" } ] }, { "name": "Atualizar tabela", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nome\": \"{{tabela_preco}}\",\n \"descricao\": \"Tabela atualizada\",\n \"status\": \"ativo\"\n}" }, "url": "{{baseUrl}}/tabelas-preco/{{tabela_preco}}", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nAtualizar tabela.\n\n`PATCH {{baseUrl}}/tabelas-preco/{{tabela_preco}}`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"nome\": \"{{tabela_preco}}\",\n \"descricao\": \"Tabela atualizada\",\n \"status\": \"ativo\"\n}\n```" }, "response": [ { "name": "Exemplo OK", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nome\": \"{{tabela_preco}}\",\n \"descricao\": \"Tabela atualizada\",\n \"status\": \"ativo\"\n}" }, "url": "{{baseUrl}}/tabelas-preco/{{tabela_preco}}", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nAtualizar tabela.\n\n`PATCH {{baseUrl}}/tabelas-preco/{{tabela_preco}}`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"nome\": \"{{tabela_preco}}\",\n \"descricao\": \"Tabela atualizada\",\n \"status\": \"ativo\"\n}\n```" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\"message\":\"Tabela de preços atualizada.\",\"tabela\":{\"nome\":\"Atacado\",\"status\":\"ativo\"}}" } ] }, { "name": "Excluir tabela", "request": { "method": "DELETE", "url": "{{baseUrl}}/tabelas-preco/{{tabela_preco}}", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nExcluir tabela.\n\n`DELETE {{baseUrl}}/tabelas-preco/{{tabela_preco}}`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`." } }, { "name": "Produtos da tabela", "request": { "method": "GET", "url": "{{baseUrl}}/tabelas-preco/{{tabela_preco}}/produtos", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nProdutos da tabela.\n\n`GET {{baseUrl}}/tabelas-preco/{{tabela_preco}}/produtos`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`." } }, { "name": "Salvar preços em lote", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"itens\": [\n { \"sku\": \"{{sku}}\", \"valor\": 99.90 }\n ]\n}" }, "url": "{{baseUrl}}/tabelas-preco/{{tabela_preco}}/produtos", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nSalvar preços em lote.\n\n`PUT {{baseUrl}}/tabelas-preco/{{tabela_preco}}/produtos`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"itens\": [\n { \"sku\": \"{{sku}}\", \"valor\": 99.90 }\n ]\n}\n```" } }, { "name": "Upsert tabela e valor por SKU", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nome\": \"{{tabela_preco}}\",\n \"descricao\": \"Lista importada do ERP\",\n \"status\": \"ativo\",\n \"valor\": 99.90\n}" }, "url": "{{baseUrl}}/tabelas-preco/{{tabela_preco}}/produtos/{{sku}}", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nUpsert tabela e valor por SKU.\n\n`PUT {{baseUrl}}/tabelas-preco/{{tabela_preco}}/produtos/{{sku}}`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"nome\": \"{{tabela_preco}}\",\n \"descricao\": \"Lista importada do ERP\",\n \"status\": \"ativo\",\n \"valor\": 99.90\n}\n```" }, "response": [ { "name": "Exemplo OK", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nome\": \"{{tabela_preco}}\",\n \"descricao\": \"Lista importada do ERP\",\n \"status\": \"ativo\",\n \"valor\": 99.90\n}" }, "url": "{{baseUrl}}/tabelas-preco/{{tabela_preco}}/produtos/{{sku}}", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nUpsert tabela e valor por SKU.\n\n`PUT {{baseUrl}}/tabelas-preco/{{tabela_preco}}/produtos/{{sku}}`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"nome\": \"{{tabela_preco}}\",\n \"descricao\": \"Lista importada do ERP\",\n \"status\": \"ativo\",\n \"valor\": 99.90\n}\n```" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\"message\":\"Valor salvo.\",\"sku\":\"ERP-001\",\"valor\":99.9}" } ] }, { "name": "Tabelas do produto", "request": { "method": "GET", "url": "{{baseUrl}}/produtos/{{sku}}/tabelas-preco", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nTabelas do produto.\n\n`GET {{baseUrl}}/produtos/{{sku}}/tabelas-preco`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`." } }, { "name": "Definir valor individual", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"valor\": 99.90\n}" }, "url": "{{baseUrl}}/produtos/{{sku}}/tabelas-preco/{{tabela_preco}}", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nDefinir valor individual.\n\n`PUT {{baseUrl}}/produtos/{{sku}}/tabelas-preco/{{tabela_preco}}`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"valor\": 99.90\n}\n```" }, "response": [ { "name": "Exemplo OK", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"valor\": 99.90\n}" }, "url": "{{baseUrl}}/produtos/{{sku}}/tabelas-preco/{{tabela_preco}}", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nDefinir valor individual.\n\n`PUT {{baseUrl}}/produtos/{{sku}}/tabelas-preco/{{tabela_preco}}`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"valor\": 99.90\n}\n```" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\"message\":\"Valor salvo.\",\"sku\":\"ERP-001\",\"valor\":99.9}" } ] } ] }, { "name": "Formas de Pagamento", "item": [ { "name": "Listar formas de pagamento", "request": { "method": "GET", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nLista formas. Resposta inclui id estável para o ERP.\n\nListar formas de pagamento.\n\n`GET {{baseUrl}}/formas-pagamento?ativo=1`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.", "url": "{{baseUrl}}/formas-pagamento?ativo=1", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ] }, "response": [ { "name": "Exemplo OK", "originalRequest": { "method": "GET", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nLista formas. Resposta inclui id estável para o ERP.\n\nListar formas de pagamento.\n\n`GET {{baseUrl}}/formas-pagamento?ativo=1`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.", "url": "{{baseUrl}}/formas-pagamento?ativo=1", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ] }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\"formas\":[{\"id\":12,\"nome\":\"Cartão 3x\",\"tipo\":\"parcelado\",\"ativo\":true}]}" } ] }, { "name": "Detalhar forma de pagamento por ID", "request": { "method": "GET", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nBusca por ID numérico (forma_pagamento_id do pedido) ou UUID.\n\nDetalhar forma de pagamento por ID.\n\n`GET {{baseUrl}}/formas-pagamento/{{forma_pagamento_id}}`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.", "url": "{{baseUrl}}/formas-pagamento/{{forma_pagamento_id}}", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ] } }, { "name": "Criar forma de pagamento", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nome\": \"Cartão 3x\",\n \"tipo\": \"parcelado\",\n \"quantidade_parcelas\": 3,\n \"taxa_tipo\": \"percentual\",\n \"taxa_valor\": 2.99,\n \"ativo\": true\n}" }, "url": "{{baseUrl}}/formas-pagamento", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nCriar forma de pagamento.\n\n`POST {{baseUrl}}/formas-pagamento`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"nome\": \"Cartão 3x\",\n \"tipo\": \"parcelado\",\n \"quantidade_parcelas\": 3,\n \"taxa_tipo\": \"percentual\",\n \"taxa_valor\": 2.99,\n \"ativo\": true\n}\n```" }, "response": [ { "name": "Exemplo Created", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nome\": \"Cartão 3x\",\n \"tipo\": \"parcelado\",\n \"quantidade_parcelas\": 3,\n \"taxa_tipo\": \"percentual\",\n \"taxa_valor\": 2.99,\n \"ativo\": true\n}" }, "url": "{{baseUrl}}/formas-pagamento", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nCriar forma de pagamento.\n\n`POST {{baseUrl}}/formas-pagamento`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"nome\": \"Cartão 3x\",\n \"tipo\": \"parcelado\",\n \"quantidade_parcelas\": 3,\n \"taxa_tipo\": \"percentual\",\n \"taxa_valor\": 2.99,\n \"ativo\": true\n}\n```" }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\"message\":\"Forma de pagamento criada.\",\"forma\":{\"id\":12,\"nome\":\"Cartão 3x\"}}" } ] }, { "name": "Atualizar forma de pagamento", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"nome\": \"Cartão 3x\",\n \"tipo\": \"parcelado\",\n \"quantidade_parcelas\": 3,\n \"taxa_tipo\": \"percentual\",\n \"taxa_valor\": 2.49,\n \"ativo\": true\n}" }, "url": "{{baseUrl}}/formas-pagamento/{{forma_pagamento_uuid}}", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nAtualizar forma de pagamento.\n\n`PATCH {{baseUrl}}/formas-pagamento/{{forma_pagamento_uuid}}`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"nome\": \"Cartão 3x\",\n \"tipo\": \"parcelado\",\n \"quantidade_parcelas\": 3,\n \"taxa_tipo\": \"percentual\",\n \"taxa_valor\": 2.49,\n \"ativo\": true\n}\n```" } }, { "name": "Excluir forma de pagamento", "request": { "method": "DELETE", "url": "{{baseUrl}}/formas-pagamento/{{forma_pagamento_uuid}}", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nExcluir forma de pagamento.\n\n`DELETE {{baseUrl}}/formas-pagamento/{{forma_pagamento_uuid}}`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`." } } ] }, { "name": "Pedidos", "item": [ { "name": "Listar pedidos", "request": { "method": "GET", "url": "{{baseUrl}}/pedidos", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nListar pedidos.\n\n`GET {{baseUrl}}/pedidos`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`." } }, { "name": "Exportar pedidos para ERP", "request": { "method": "GET", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nResposta inclui canal_venda (plataforma da loja ou Manual).\n\nExportar pedidos para ERP.\n\n`GET {{baseUrl}}/pedidos/exportacao?somente_nao_importados=1&status=novo,em_separacao,faturado,enviado,concluido&page=1&per_page=50`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.", "url": "{{baseUrl}}/pedidos/exportacao?somente_nao_importados=1&status=novo,em_separacao,faturado,enviado,concluido&page=1&per_page=50", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ] } }, { "name": "Próximo número", "request": { "method": "GET", "url": "{{baseUrl}}/pedidos/proximo-numero", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nPróximo número.\n\n`GET {{baseUrl}}/pedidos/proximo-numero`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`." } }, { "name": "Criar pedido", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"data_pedido\": \"2026-10-07\",\n \"cliente_nome\": \"Cliente Exemplo\",\n \"cliente_documento\": \"00000000000\",\n \"cliente_email\": \"cliente@exemplo.com\",\n \"loja\": \"Loja Principal\",\n \"status\": \"novo\",\n \"prioridade\": \"normal\",\n \"forma_pagamento_id\": {{forma_pagamento_id}},\n \"desconto\": 0,\n \"frete\": 10,\n \"itens\": [\n {\n \"sku\": \"{{sku}}\",\n \"produto_nome\": \"Produto Exemplo\",\n \"quantidade\": 1,\n \"valor_unitario\": 99.90\n }\n ]\n}" }, "url": "{{baseUrl}}/pedidos", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nCriar pedido.\n\n`POST {{baseUrl}}/pedidos`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"data_pedido\": \"2026-10-07\",\n \"cliente_nome\": \"Cliente Exemplo\",\n \"cliente_documento\": \"00000000000\",\n \"cliente_email\": \"cliente@exemplo.com\",\n \"loja\": \"Loja Principal\",\n \"status\": \"novo\",\n \"prioridade\": \"normal\",\n \"forma_pagamento_id\": {{forma_pagamento_id}},\n \"desconto\": 0,\n \"frete\": 10,\n \"itens\": [\n {\n \"sku\": \"{{sku}}\",\n \"produto_nome\": \"Produto Exemplo\",\n \"quantidade\": 1,\n \"valor_unitario\": 99.90\n }\n ]\n}\n```" }, "response": [ { "name": "Exemplo Created", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"data_pedido\": \"2026-10-07\",\n \"cliente_nome\": \"Cliente Exemplo\",\n \"cliente_documento\": \"00000000000\",\n \"cliente_email\": \"cliente@exemplo.com\",\n \"loja\": \"Loja Principal\",\n \"status\": \"novo\",\n \"prioridade\": \"normal\",\n \"forma_pagamento_id\": {{forma_pagamento_id}},\n \"desconto\": 0,\n \"frete\": 10,\n \"itens\": [\n {\n \"sku\": \"{{sku}}\",\n \"produto_nome\": \"Produto Exemplo\",\n \"quantidade\": 1,\n \"valor_unitario\": 99.90\n }\n ]\n}" }, "url": "{{baseUrl}}/pedidos", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nCriar pedido.\n\n`POST {{baseUrl}}/pedidos`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"data_pedido\": \"2026-10-07\",\n \"cliente_nome\": \"Cliente Exemplo\",\n \"cliente_documento\": \"00000000000\",\n \"cliente_email\": \"cliente@exemplo.com\",\n \"loja\": \"Loja Principal\",\n \"status\": \"novo\",\n \"prioridade\": \"normal\",\n \"forma_pagamento_id\": {{forma_pagamento_id}},\n \"desconto\": 0,\n \"frete\": 10,\n \"itens\": [\n {\n \"sku\": \"{{sku}}\",\n \"produto_nome\": \"Produto Exemplo\",\n \"quantidade\": 1,\n \"valor_unitario\": 99.90\n }\n ]\n}\n```" }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\"message\":\"Pedido criado.\",\"pedido\":{\"numero\":\"PED-0001\",\"status\":\"novo\"}}" } ] }, { "name": "Detalhar pedido", "request": { "method": "GET", "url": "{{baseUrl}}/pedidos/{{numero_pedido}}", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nDetalhar pedido.\n\n`GET {{baseUrl}}/pedidos/{{numero_pedido}}`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`." }, "response": [ { "name": "Exemplo OK", "originalRequest": { "method": "GET", "url": "{{baseUrl}}/pedidos/{{numero_pedido}}", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nDetalhar pedido.\n\n`GET {{baseUrl}}/pedidos/{{numero_pedido}}`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`." }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\"pedido\":{\"numero\":\"PED-0001\",\"status\":\"novo\"}}" } ] }, { "name": "Atualizar pedido", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"status\": \"em_separacao\",\n \"prioridade\": \"alta\"\n}" }, "url": "{{baseUrl}}/pedidos/{{numero_pedido}}", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nAtualizar pedido.\n\n`PATCH {{baseUrl}}/pedidos/{{numero_pedido}}`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"status\": \"em_separacao\",\n \"prioridade\": \"alta\"\n}\n```" }, "response": [ { "name": "Exemplo OK", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"status\": \"em_separacao\",\n \"prioridade\": \"alta\"\n}" }, "url": "{{baseUrl}}/pedidos/{{numero_pedido}}", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nAtualizar pedido.\n\n`PATCH {{baseUrl}}/pedidos/{{numero_pedido}}`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"status\": \"em_separacao\",\n \"prioridade\": \"alta\"\n}\n```" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\"message\":\"Pedido atualizado.\",\"pedido\":{\"numero\":\"PED-0001\",\"status\":\"em_separacao\"}}" } ] }, { "name": "Marcar pedido como importado", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"erp_import_id\": \"ERP-123\",\n \"erp_import_status\": \"importado\",\n \"erp_import_message\": \"Venda criada no ERP.\",\n \"status\": \"em_separacao\"\n}" }, "url": "{{baseUrl}}/pedidos/{{numero_pedido}}/marcar-importado", "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nMarcar pedido como importado.\n\n`POST {{baseUrl}}/pedidos/{{numero_pedido}}/marcar-importado`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`.\n\nExemplo de body:\n```json\n{\n \"erp_import_id\": \"ERP-123\",\n \"erp_import_status\": \"importado\",\n \"erp_import_message\": \"Venda criada no ERP.\",\n \"status\": \"em_separacao\"\n}\n```" } }, { "name": "Excluir pedido", "request": { "method": "DELETE", "url": "{{baseUrl}}/pedidos/{{numero_pedido}}", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nExcluir pedido.\n\n`DELETE {{baseUrl}}/pedidos/{{numero_pedido}}`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`." } } ] }, { "name": "Vendas Mercado Livre", "description": "Só consulta. GET da lista (page e per_page) e GET pelo ID da venda já salva no Hub. O seller_id da query é o ID da loja no canal.", "item": [ { "name": "Listar vendas", "request": { "method": "GET", "url": "{{baseUrl}}/mercadolivre/vendas?seller_id={{seller_id_ml}}&page=1&per_page=20", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nLista as vendas já salvas, com page e per_page.\n\n`GET {{baseUrl}}/mercadolivre/vendas?seller_id={{seller_id_ml}}&page=1&per_page=20`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`." } }, { "name": "Consultar venda pelo ID", "request": { "method": "GET", "url": "{{baseUrl}}/mercadolivre/vendas/{{order_id_ml}}?seller_id={{seller_id_ml}}", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nConsulta a venda já salva pelo ID.\n\n`GET {{baseUrl}}/mercadolivre/vendas/{{order_id_ml}}?seller_id={{seller_id_ml}}`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`." } } ] }, { "name": "Vendas Shopee", "description": "Só consulta. GET da lista (page e per_page) e GET pelo ID da venda já salva no Hub. O seller_id da query é o ID da loja no canal.", "item": [ { "name": "Listar vendas", "request": { "method": "GET", "url": "{{baseUrl}}/shopee/vendas?seller_id={{seller_id_shopee}}&page=1&per_page=20", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nLista as vendas já salvas, com page e per_page.\n\n`GET {{baseUrl}}/shopee/vendas?seller_id={{seller_id_shopee}}&page=1&per_page=20`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`." } }, { "name": "Consultar venda pelo ID", "request": { "method": "GET", "url": "{{baseUrl}}/shopee/vendas/{{order_sn_shopee}}?seller_id={{seller_id_shopee}}", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nConsulta a venda já salva pelo ID.\n\n`GET {{baseUrl}}/shopee/vendas/{{order_sn_shopee}}?seller_id={{seller_id_shopee}}`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`." } } ] }, { "name": "Vendas TikTok Shop", "description": "Só consulta. GET da lista (page e per_page) e GET pelo ID da venda já salva no Hub. O seller_id da query é o ID da loja no canal.", "item": [ { "name": "Listar vendas", "request": { "method": "GET", "url": "{{baseUrl}}/tiktok/vendas?seller_id={{seller_id_tiktok}}&page=1&per_page=20", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nLista as vendas já salvas, com page e per_page.\n\n`GET {{baseUrl}}/tiktok/vendas?seller_id={{seller_id_tiktok}}&page=1&per_page=20`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`." } }, { "name": "Consultar venda pelo ID", "request": { "method": "GET", "url": "{{baseUrl}}/tiktok/vendas/{{order_id_tiktok}}?seller_id={{seller_id_tiktok}}", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nConsulta a venda já salva pelo ID.\n\n`GET {{baseUrl}}/tiktok/vendas/{{order_id_tiktok}}?seller_id={{seller_id_tiktok}}`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`." } } ] }, { "name": "Vendas iFood", "description": "Só consulta. GET da lista (page e per_page) e GET pelo ID da venda já salva no Hub. O seller_id da query é o ID da loja no canal.", "item": [ { "name": "Listar vendas", "request": { "method": "GET", "url": "{{baseUrl}}/ifood/vendas?seller_id={{seller_id_ifood}}&page=1&per_page=20", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nLista as vendas já salvas, com page e per_page.\n\n`GET {{baseUrl}}/ifood/vendas?seller_id={{seller_id_ifood}}&page=1&per_page=20`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`." } }, { "name": "Consultar venda pelo ID", "request": { "method": "GET", "url": "{{baseUrl}}/ifood/vendas/{{order_id_ifood}}?seller_id={{seller_id_ifood}}", "header": [ { "key": "X-Seller-Id", "value": "{{seller_id}}", "type": "text" } ], "description": "Use a variável Master Token e passe o Seller ID da loja na variável seller_id. O cabeçalho X-Seller-Id é obrigatório em toda chamada e define a loja.\n\nConsulta a venda já salva pelo ID.\n\n`GET {{baseUrl}}/ifood/vendas/{{order_id_ifood}}?seller_id={{seller_id_ifood}}`\n\nCabeçalhos: `Authorization: Bearer {{Master Token}}` e `X-Seller-Id: {{seller_id}}`." } } ] } ] }