Tabela de Preço

Webservice: Método gravaTabPreco

Este método permite a criação e atualização de cabeçalhos de Tabelas de Preço de forma automatizada via integração SOAP.

1. Informações de Conexão

  • URL WSDL (Produção): https://app.procedo.com.br/api/tabprecoservice?wsdl

  • URL WSDL (Testes/QA): https://qa.procedo.com.br/api/tabprecoservice?wsdl

  • Tecnologia: SOAP

  • Observação: Solicite seu token de segurança via [email protected].

2. Parâmetros e Regras

Parâmetro

Obrigatório

Formato

Descrição

token

Sim

String

Identificador único da empresa.

codigo

Sim

String

Código identificador da tabela.

nome

Sim

String

Nome descritivo da tabela.

validade_inicio

Sim

Date

Início da vigência (AAAA-MM-DD).

validade_fim

Sim

Date

Término da vigência (AAAA-MM-DD).

situacao

Sim

Int

0 – Inativa / 1 – Ativa.

Códigos de Retorno: 0 (Token inválido), 1 (Sucesso), 9 (Erro ao salvar - verifique os parâmetros).

3. Exemplo de Requisição (SOAP)

<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:SOAPServerWSDL">
   <soapenv:Header/>
   <soapenv:Body>
      <urn:gravaTabPreco soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
         <token xsi:type="xsd:string">SEU_TOKEN_AQUI</token>
         <codigo xsi:type="xsd:string">123</codigo>
         <nome xsi:type="xsd:string">Tabela XPTO</nome>
         <validade_inicio xsi:type="xsd:string">2026-02-27</validade_inicio>
         <validade_fim xsi:type="xsd:string">2026-12-31</validade_fim>
         <situacao xsi:type="xsd:string">1</situacao>
      </urn:gravaTabPreco>
   </soapenv:Body>
</soapenv:Envelope>

📑 Webservice: Método gravaPrecoItem

Este método é responsável por alimentar a tabela de preço com os itens (produtos/serviços), definindo seus valores e condições comerciais.

1. Parâmetros de Entrada

Parâmetro

Obrigatório

Formato

Descrição

token

Sim

String

Identificador único da empresa.

tabpreco

Sim

String

Código da tabela de preço de destino.

item

Sim

String

Código do produto/serviço no sistema.

preco_minimo

Sim

Decimal

Preço mínimo permitido (Formato: 9.99).

preco

Sim

Decimal

Preço de tabela praticado.

cond_pagto

Sim

Inteiro

Código da condição de pagamento.

indisponivel

Não

Inteiro

0 – Não / 1 – Sim.

Códigos de Retorno: 1 (Sucesso), 9 (Item não encontrado), 11 (Tabela de Preço não encontrada).

2. Exemplo de Requisição (Inserção de Item)

<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:SOAPServerWSDL">
   <soapenv:Header/>
   <soapenv:Body>
      <urn:gravaPrecoItem soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
         <token xsi:type="xsd:string">SEU_TOKEN_AQUI</token>
         <tabpreco xsi:type="xsd:string">TabPreco01</tabpreco>
         <item xsi:type="xsd:string">122</item>
         <preco_minimo xsi:type="xsd:string">120.23</preco_minimo>
         <preco xsi:type="xsd:string">153.24</preco>
         <quantidade_minima xsi:type="xsd:string">2</quantidade_minima>
         <indisponivel xsi:type="xsd:string">0</indisponivel>
         <cond_pagto xsi:type="xsd:string">1</cond_pagto>
      </urn:gravaPrecoItem>
   </soapenv:Body>
</soapenv:Envelope>

3. Exemplo de Retorno com Sucesso

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Body>
      <ns1:gravaPrecoItemResponse xmlns:ns1="urn:SOAPServerWSDL">
         <return xsi:type="xsd:string">1</return>
      </ns1:gravaPrecoItemResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>