Grupos de preço são grupos onde clientes são adicionados para obter faixas de preço específicas para determinados produtos.
Este serviço possibilita que os grupos de preço sejam criados e atualizados.
Os endpoints desta integração fazem parte dos endpoints v2.
Início > Grupo de preço
Versão: 2.0
Grupo de preço
Última Atualização: 15/03/2024
Sintaxe da Requisição
Para que a requisição do método Post seja bem-sucedida, é necessário que
seja passado os seguintes valores dentro de um JSON:
Elementos da requisição
nome *
Nome do grupo de preço.
Tipo: String.
status *
Status do grupo.(ativo ou inativo)
Tipo: String.
embalagens *
Lista de todos os produtos que irão contemplar o grupo de preço. Abaixo os campos necessários
ean_ou_dun *
Código do EAN do produto ou DUN caso o produto seja vendido em caixa.
Tipo: String.
pallet_multiplo_dun *
Campo para informar o múltiplo mínimo de vendas, caso utilizem o formato de quantidade mínimas por produto.
Tipo: Integer.
preco_embalagem *
Preço do produto para venda nesse grupo de preço. Esse valor irá sobrescrever o preço padrão informado em produtos para a lista de clientes.
Tipo: Float.
preco_minimo_embalagem *
Preço mínimo do produto para venda. Funcionalidade para quem utiliza flutuação de preço (verba flex). Caso não utilizar, repetir o valor do preço.
Tipo: Float.
preco_maximo_embalagem
Preço máximo do produto para venda. Funcionalidade para quem utiliza flutuação de preço (verba flex).
Tipo: Float.
preco_base
Preço base da embalagem.
Tipo: Float.
desconto
Desconto sobre o produto.
Tipo: Float.
imposto
Total da soma dos impostos.
Tipo: Float.
icms
Imposto de ICMS.
Tipo: Float.
ipi
Imposto de IPI.
Tipo: Float.
st
Imposto de ST.
Tipo: Float.
icmsfcp
Imposto de ICMS FCP.
Tipo: Float.
stfcp
Imposto de ST FCP.
Tipo: Float.
pis
Imposto de pis.
Tipo: Float.
cofins
Imposto de cofins.
Tipo: Float.
isencao_encargos
Identificador boleano para produtos com isenção de encargos.
Tipo: Boolean.
clientes *
Lista contendo todos os clientes que irão contemplar o grupo de preço. OBS: O mesmo cliente não pode pertencer a mais de um grupo de preço.
Tipo: String.
codigo_no_fornecedor *
Código do grupo de preço no ERP do fornecedor.
Tipo: String.
Sintaxe da Resposta
Caso ocorra tudo certo com a requisição e retorne o status code 200, essa será a resposta que você receberá:
Elementos da Resposta
lista
Id interno da lista.
Tipo: Integer.
grupo_precos
Id interno do grupo de preço.
Tipo: Integer.
Respostas para erros
Caso ocorra algum erro durante a requisição, os possíveis erros são:
400 Bad Request
422 Validation Error
POST grupo de preço
Última Atualização: 15/03/2024
Este endpoint irá adicionar novos grupos de preço, informando o valor do produto e os clientes que vão fazer parte do grupo de preço.
Endpoint POST
isencao_encargos
Indicador boleano para produtos com isenção de encargo.
Tipo: Boolean.
Respostas para erros
Caso ocorra algum erro durante a requisição, os possíveis erros são:
400 Bad Request
404 Not Found
Caso o campo codigo_no_fornecedor seja inexistente:
422 Validation Error
PATCH grupo de preço
Última Atualização: 15/03/2024
Este endpoint é responsável para criação de grupos de preço no estoque do fornecedor.
Endpoint PATCH
Sintaxe da Requisição
Caso a requisição seja bem-sucedida e retorne o status code 200, essa será a resposta que você receberá:
Elementos da requisição
nome *
Nome do grupo de preço.
Tipo: String.
status *
Status do grupo. Ativo ou Inativo
Tipo: String.
embalagens *
Lista de todos os produtos que irão contemplar o grupo de preço.
Tipo: Array de JSON.
ean_ou_dun *
Código do EAN do produto ou DUN caso o produto seja vendido em caixa.
Tipo: String.
pallet_multiplo_dun *
Campo para informar o múltiplo mínimo de vendas, caso utilizem o formato de quantidade mínimas por produto
Tipo: Float.
preco_embalagem *
Preço do produto para venda neste grupo de preço. Este valor substituirá o preço padrão informado nos produtos para os clientes especificados na lista de clientes.
Tipo: Float.
preco_minimo_embalagem *
Preço mínimo do produto para venda. Funcionalidade para quem utiliza flutuação de preço (verba flex). Caso não utilizar, repetir o valor do preço.
Tipo: Float.
preco_maximo_embalagem
Preço máximo do produto para venda. Funcionalidade para quem utiliza flutuação de preço (verba flex).
Tipo: Float.
clientes *
Lista contendo todos os clientes que irão contemplar o grupo de preço.
OBS: O mesmo cliente não pode pertencer a mais de um grupo de preço.
Tipo: String.
codigo_no_fornecedor *
Código do grupo de preço no ERP do fornecedor.
Tipo: String.
Sintaxe da Resposta
Caso a requisição seja bem-sucedida e retorne o status code 200, essa será a resposta que você receberá: