v1

latestOpenAPI 3.0.3Licença Sankhya2026-07-24161242654.8 KB
Serviços Especialistas

Consulta de Preços

<h1>Regras de negócio</h1> Para realizar consulta “Tabela de Preço” no carregamento das regras/exceções da tabela de preço, o sistema irá trazer os registros de forma paginada, ou seja, os dados não irão ser carregados todos de uma vez só. O sistema irá trazer aos poucos os registros, para que você possa ir utilizando a tela enquanto as informações não são totalmente carregadas.<br /> Além disso, é possível que seja editado um registro (somente no modo formulário) enquanto os demais registros são carregados na tela. Quando estiver sendo feita a edição de um registro e o carregamento de todos os registros for concluído, o sistema irá emitir uma mensagem para confirmação da edição.<br /> <b>OBS:</b> Caso tenha alguma necessidade de configuração do ERP procure “Consultor” ou acesso o link de apoio:<br /> https://ajuda.sankhya.com.br/hc/pt-br/articles/360044603854-Tabelas-de-Pre%C3%A7os<br /> <h3>Dependências</h3> <b><font color=red>Não possui dependências</font></b><br /><br /> <h3>Detalhes Técnicos</h3> No endpoint ConsultaProdutosSP.consultaProdutos, não é possível informar os parâmetros codtab ou nutab, pois o serviço retorna exclusivamente os preços previamente configurados na própria consulta de produtos, desconsiderando quaisquer códigos de tabela informados na requisição. <h3>Exemplo de uso:</h3> <ul> <li>URL Gateway Produção: https://api.sankhya.com.br/</li> <li>URL Gateway Sandbox: https://api.sandbox.sankhya.com.br/</li> </ul> <b>URL de chamada</b>: https://[URL_GATEWAY]/gateway/v1/mgecom/service.sbr?serviceName=ConsultaProdutosSP.consultaProdutos&outputType=json <br /> <b>Corpo de requisição</b>
{
    "serviceName": "ConsultaProdutosSP.consultaProdutos",
      "requestBody": {
          "filtros": {
              "criterio": {
                  "resourceID": "br.com.sankhya.com.cons.consultaProdutos",
                  "PERCDESC": "0",
                  "CODPROD": {
                      "$": "6"
                  }
              },
              "isPromocao": {
                  "$": "false"
              },
              "isLiquidacao": {
                  "$": "false"
        }
      }
    }
  }
}

<b>Retorno:</b><br />

{
    "serviceName": "ConsultaProdutosSP.consultaProdutos",
      "status": "1",
      "pendingPrinting": "false",
      "transactionId": "DA7090050593CA45FA74E760480BAA0B",
      "responseBody": {
          "produtos": {
              "maxregconsprod": {
                  "$": "0"
              },
              "produto": {
                  "ISPROMOCAO": "false",
                  "ISLIQUIDACAO": "false",
                  "Cadastro_COMPLDESC": {},
                  "Cadastro_CODPROD": {
                      "$": "6"
                  },
                  "Cadastro_DESCRPROD": {
                      "$": "AR CONDICIONADO YORK 18.000 BTU'S"
                  },
                  "TIPCONTEST": {
                      "$": "N"
                  },
                  "TIPLANCNOTA": {
                      "$": "A"
                  },
                  "Preço_1": {
                      "$": "0.00",
                      "PRECOBASE_Preço_1": "0"
                  },
                  "DECQTD": {
                      "$": "0"
                  },
                  "ORDEMMEDIDA": {
                      "$": "0"
                  },
                  "Estoque_1": {},
                  "DECVLR": {
                      "$": "2"
                  },
                  "CODVOL": {
                      "$": "UN"
                  },
                  "DESCRPROD": {
                      "$": "AR CONDICIONADO YORK 18.000 BTU'S"
                  },
                  "CODPROD": {
                      "$": "6"
                  },
                  "TEMIMAGEM": {
                      "$": "N"
                  },
                  "PRECOBASE": {
                      "$": "0.00"
                }
            }
        }
    }
}
get/PrecoProduto

Response

Cadastro efetuado com sucesso