v1

latestOpenAPI 3.0.3Licença Sankhya2026-07-24161242654.8 KB
Preços

Obter preços de produtos de forma contextualizada

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.

post/v1/precos/contextualizado

Request body

codigoEmpresainteger 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

codigoClienteinteger 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

codigoVendedorinteger 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

codigoTipoOperacaointeger 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

codigoTipoNegociacaointeger 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

dataNegociacaostring

Data da negociação

simularInclusaoboolean

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.

Example request

{
  "codigoEmpresa": 1,
  "codigoCliente": 9541,
  "codigoVendedor": 11,
  "codigoTipoOperacao": 1001,
  "codigoTipoNegociacao": 10,
  "dataNegociacao": "16/10/2024",
  "simularInclusao": true,
  "produtos": [
    {
      "codigoProduto": 9145,
      "controle": "Verde",
      "unidade": "UN",
      "quantidade": 5
    }
  ]
}

Response

Operação bem sucedida. Clique aqui para mais detalhes.

codigointeger
tipostring
mensagemstring

Example response

{
  "precos": [
    {
      "codigoProduto": 9145,
      "controle": "Verde",
      "unidade": "UN",
      "valor": 458.49
    }
  ]
}