Busca preços de Produtos

Para obtermos informações sobre preços do produto devemos utilizar o serviço ConsultaProdutosSP.getDetalhesPrecos do módulo mgecom.

É possível consultar preços de um produto por vez.
Os preços retornados neste serviço dependem da configuração realizada na tela 'Consulta de Produtos', ou seja, se nesta tela tivermos configurados 5 tipos de preços diferentes, então teremos 5 preços diferentes sendo retornados pelo serviço.

Sugere-se configurar a tela para o usuário utilizado na integração do sistema, desta forma apenas os preços utilizados no sistema externo serão retornados.

Parâmetros de chamada

criterio

Elemento XML que possui diversos atributos que devem ser utilizados para refinar e configurar a consulta.
Os atributos disponíveis estão documentados no exemplo contido neste documento.

Dados modificados

Nenhuma informação é modificada por este serviço, pois trata-se de um serviço exclusivo para consultas.

Detalhes do HTTP

Método de requisição: POST
URL:
https://api.sankhya.com.br/gateway/v1/mgecom/service.sbr?serviceName=ConsultaProdutosSP.getDetalhesPrecos

Headers HTTP:

Content-Type: text/xml;charset=ISO-8859-1
Autorization: bearerToken=[TOKEN gerado no serviço de autenticação]

Estrutura básica da requisição:

<criterio
CODPROD='9999'
RESOURCEID='br.com.sankhya.com.cons.consultaProdutos'
CODPARC='9999'
CODLOCAL='9999'
CODEMP='999'
CODVOL='XX'
CONTROLE='XXXXX'
MANDARVOLUMES='S|N'
/>

Descrição dos atributos

Nome	Tipo	Descrição
CODPROD	Inteiro	Cód. Produto a ser consultado
RESOURCEID	String	Identificador para configurações. Informar sempre o valor fixo do exemplo.
CODPARC	Inteiro	Cód.Parceiro para obter preço. Só deve ser usado caso a empresa use tabelas de preço por cliente ou caso use promoção específica por parceiro.
CODLOCAL	Inteiro	Cód.Local estque. Só deve ser usado caso a empresa use preço por local ou use promoção específica por local
CODEMP	Inteiro	Cód.Empresa. Se deve ser usado caso se utilize preço por empresa ou use promoção específica por empresa.
CODVOL	String	Unidade de venda. Caso seja informada o sistema busca o preço por esta unidade, caso haja. Caso contrário o preço será pela unidade padrão
CONTROLE	String	Controle especial de estoque. Só deve ser informado caso o produto possua controle específico e o preço seja diferente por controle.
MANDARVOLUMES	Boolean	Flag (true\|false). Quando ligada o sistema retorna, junto com o preço, as informações sobre as unidades de venda do produto consultado.

Estrutura básica do retorno:

<produto>
           <precos>
                <preco/>
           </precos>
		<volumes>
			<volume/>
		</volumes>
        </produto>

Exemplo de uso

Corpo da requisição:

<serviceRequest serviceName="ConsultaProdutosSP.getDetalhesPrecos">
	<requestBody>
		<criterio CODPROD='13' RESOURCEID='br.com.sankhya.com.cons.consultaProdutos'/>
	</requestBody>
</serviceRequest>

Resultado bem sucedido:

<?xml version="1.0" encoding="UTF-8"?>
<serviceResponse serviceName="ConsultaProdutosSP.getDetalhesPrecos" status="1" pendingPrinting="false" transactionId="5f38bba9-bde6-4575-ab49-d54c8405746f">
    <responseBody>
        <produto>
            <precos>
                <preco>
<!-- 
descrição da tabela na configuração da tela Consulta de Produtos-->
                    <DESCRICAO>Preço especial</DESCRICAO>

<!-- Nro.único da promoção (TGFDES), caso tenha -->
                    <NUNICOPROM>0</NUNICOPROM>
				<!-- 
nro.único interno da tabela de preços (TGFTAB)
-->
                    <NUTAB>201</NUTAB>

<!-- código da tabela. Neste exemplo tabela zero -->
                    <CODTAB>0</CODTAB>
                    <NOMETAB>&lt;TABELA PADRAO&gt;</NOMETAB>
<!-- valor unitário de venda -->
                    <VALOR>12.000</VALOR>
<!-- valor promocional, caso tenha -->
                    <PROMOCAO>0.00</PROMOCAO>
                </preco>
                <preco>
                    <DESCRICAO>Preço 10%</DESCRICAO>
                    <NUNICOPROM>0</NUNICOPROM>
                    <NUTAB>201</NUTAB>
                    <CODTAB>0</CODTAB>
                    <NOMETAB>&lt;TABELA PADRAO&gt;</NOMETAB>
                    <VALOR>16.500</VALOR>
                    <PROMOCAO>0.00</PROMOCAO>
                </preco>
                <preco>
                    <DESCRICAO>Preço</DESCRICAO>
                    <NUNICOPROM>0</NUNICOPROM>
                    <NUTAB>201</NUTAB>
                    <CODTAB>0</CODTAB>
                    <NOMETAB>&lt;TABELA PADRAO&gt;</NOMETAB>
                    <VALOR>15.000</VALOR>
                    <PROMOCAO>0.00</PROMOCAO>
                </preco>
            </precos>
        </produto>
    </responseBody>
</serviceResponse>