--- title: "Obter preços de produtos de forma contextualizada" method: POST path: "/v1/precos/contextualizado" tags: ["Preços"] --- # Obter preços de produtos de forma contextualizada `POST /v1/precos/contextualizado` Este serviço retorna os preços dos produtos de forma contextualizada, levando em conta as condições específicas de uma negociação. O preço pode variar com base em diversos fatores, como forma de pagamento, localização do cliente, vendedor responsável pela negociação, entre outros. A consulta permite até 50 produtos por solicitação. ## Request body - ProdutoPrecosContextoPost - `codigoEmpresa` integer, required — Insira o código da Empresa utilizado na negociação. Esse código é facilmente acessível através da nossa API, na entidade "Empresa" (CODEMP). Obtenha essa informação e mantenha seus registros sempre atualizados. Para saber mais, [clique aqui](https://developer.sankhya.com.br/reference/get_loadrecords) - `codigoCliente` integer, required — Insira o código do cliente utilizado na negociação. Esse código é facilmente acessível através da nossa API, na entidade "Parceiro" (CODPARC). Obtenha essa informação e mantenha seus registros sempre atualizados. Para saber mais, [clique aqui](https://developer.sankhya.com.br/reference/get_loadrecords) - `codigoVendedor` integer, required — Insira o código do vendedor responsável pela negociação. Esse código é facilmente acessível através da nossa API, na entidade "Vendedor" (CODVEND). Obtenha essa informação e mantenha seus registros sempre atualizados. Para saber mais, [clique aqui](https://developer.sankhya.com.br/reference/get_loadrecords) - `codigoTipoOperacao` integer, required — Insira o código do Tipo de Operação utilizado na negociação. Esse código é facilmente acessível através da nossa API, na entidade "TipoOperacao" (CODTIPOPER). Obtenha essa informação e mantenha seus registros sempre atualizados. Para saber mais, [clique aqui](https://developer.sankhya.com.br/reference/get_loadrecords) - `codigoTipoNegociacao` integer, required — Insira o código do Tipo de Negociação utilizado na negociação. Esse código é facilmente acessível através da nossa API, na entidade "TipoNegociacao" (CODTIPVENDA). Obtenha essa informação e mantenha seus registros sempre atualizados. Para saber mais, [clique aqui](https://developer.sankhya.com.br/reference/get_loadrecords) - `dataNegociacao` string — Data da negociação - `simularInclusao` boolean — Quando definido como "true", este atributo realiza uma simulação da inclusão da negociação, item por item. Trata-se de uma operação com baixa performance e deve ser utilizada apenas quando o cliente possui preços personalizados que diferem do padrão fornecido pelo SankhyaOm. - `produtos` PrecosProdutoContextoPost[] - `codigoProduto` integer, required — Informe neste atributo o "código do produto" disponível no SankhyaOm. Esse código é facilmente acessível através da nossa API, na entidade "Produto" (CODPROD). Para saber mais, [clique aqui](https://developer.sankhya.com.br/reference/get_loadrecords) - `codigoLocalEstoque` integer, required — Código do Local de Estoque para o produto desejado. Quando este atributo é informado, o serviço retornará apenas os preços definidos para o local especificado. Caso não seja enviado, o serviço retornará todos os preços disponíveis para o produto, independentemente do local. Necessário quando existe controle de preços por local de estoque. Essa informação deve ser obtida previamente pela entidade "Estoque" (CODLOCAL). Para saber mais, [clique aqui](https://developer.sankhya.com.br/reference/get_loadrecords) - `controle` string, required — Insira neste campo o "controle" correspondente. Quando este atributo é informado, o serviço retornará apenas os preços definidos para o controle especificado. Caso não seja enviado, o serviço retornará todos os preços disponíveis para o produto, independentemente do controle. No SankhyaOm, o controle é essencial para a gestão de estoque/preços e pode incluir características como voltagem, sabor, tamanho, cor, entre outros. Por exemplo, para um produto controlado por cor, o valor "verde" seria uma informação esperada. Certifique-se de obter esses dados previamente através das entidades "Produto" ou "Estoque". Veja como funciona controle adicional de estoque em nossa ajuda [clicando aqui](https://ajuda.sankhya.com.br/hc/pt-br/articles/360045112113-Cadastro-de-Produtos#sub-abacontroleadicional). Para saber mais, [clique aqui](https://developer.sankhya.com.br/reference/get_loadrecords) - `unidade` string, required — Informe neste atributo a "unidade de medida" disponível no SankhyaOm. Quando este atributo é informado, o serviço retornará apenas os preços definidos para a unidade especificada. Caso não seja enviado, o serviço retornará todos os preços disponíveis para o produto, independentemente da unidade. Essa informação é facilmente acessível através da nossa API, na entidade "Produto" ou "UnidadeAlternativa" (CODVOL). Para saber mais, [clique aqui](https://developer.sankhya.com.br/reference/get_loadrecords) - `quantidade` number, required ## Response `200` Operação bem sucedida. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - RetornoPreco - `codigo` integer - `tipo` string - `mensagem` string - `precos` PrecosProduto[] - `codigoProduto` integer, required — Informe neste atributo o "código do produto" disponível no SankhyaOm. Esse código é facilmente acessível através da nossa API, na entidade "Produto" (CODPROD). Para saber mais, [clique aqui](https://developer.sankhya.com.br/reference/get_loadrecords) - `codigoLocalEstoque` integer — Código do Local de Estoque para o produto desejado. Quando este atributo é informado, o serviço retornará apenas os preços definidos para o local especificado. Caso não seja enviado, o serviço retornará todos os preços disponíveis para o produto, independentemente do local. Necessário quando existe controle de preços por local de estoque. Essa informação deve ser obtida previamente pela entidade "Estoque" (CODLOCAL). Para saber mais, [clique aqui](https://developer.sankhya.com.br/reference/get_loadrecords) - `controle` string — Insira neste campo o "controle" correspondente. Quando este atributo é informado, o serviço retornará apenas os preços definidos para o controle especificado. Caso não seja enviado, o serviço retornará todos os preços disponíveis para o produto, independentemente do controle. No SankhyaOm, o controle é essencial para a gestão de estoque/preços e pode incluir características como voltagem, sabor, tamanho, cor, entre outros. Por exemplo, para um produto controlado por cor, o valor "verde" seria uma informação esperada. Certifique-se de obter esses dados previamente através das entidades "Produto" ou "Estoque". Veja como funciona controle adicional de estoque em nossa ajuda [clicando aqui](https://ajuda.sankhya.com.br/hc/pt-br/articles/360045112113-Cadastro-de-Produtos#sub-abacontroleadicional). Para saber mais, [clique aqui](https://developer.sankhya.com.br/reference/get_loadrecords) - `unidade` string — Informe neste atributo a "unidade de medida" disponível no SankhyaOm. Quando este atributo é informado, o serviço retornará apenas os preços definidos para a unidade especificada. Caso não seja enviado, o serviço retornará todos os preços disponíveis para o produto, independentemente da unidade. Essa informação é facilmente acessível através da nossa API, na entidade "Produto" ou "UnidadeAlternativa" (CODVOL). Para saber mais, [clique aqui](https://developer.sankhya.com.br/reference/get_loadrecords) - `valor` number, required ## Other responses - `400` — Informações Inválidas. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - `401` — Não autenticado. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - `403` — Autenticação inválida. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - `404` — Dados não encontrados. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - `500` — Erro interno no servidor. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - `501` — Não implementado. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - `502` — Retorno inválido do servidor. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - `503` — Serviço indisponível no momento. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - `504` — Tempo de execução excedido. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. --- [API](https://skmtc.net/sankhya/apis/api-sankhya.md) · [All operations](https://skmtc.net/sankhya/apis/api-sankhya/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sankhya/api-sankhya/revisions/0a3e81ca6195/schema)