Com o serviço web SOAP (Simple Object Access Protocol), é possível cadastrar uma tabela de preço com seus itens de maneira automatizada. Este recurso é utilizado para fazer integração e/ou automatização de processos de qualquer sistema com o Procedo.
Nome: TabprecoService
Tecnologia: WebserviceSOAP
URL WSDL: https://app.procedo.com.br/api/tabprecoservice?wsdl
URL WSDL de testes: https://qa.procedo.com.br/api/tabprecoservice?wsdl
Objetivo: Webservice que realiza operações vinculadas a Tabelas de preço, como a integração das cotações do ERP para o Procedo, bem como grava os itens das tabelas de preço.
Observação: Solicite seu token de segurança para utilizar os métodos do webservice [email protected]
Métodos
Método: gravaTabPreco
Descrição: Método responsável por inserir uma tabela de preço no Procedo.
Parâmetro | Obrigatório | Formato | Descrição |
token | sim | String | Identificador único da empresa para uso do método |
codigo | sim | String | Código da tabela de preço |
nome | sim | String | Nome da tabela de preço |
validade_inicio | sim | Date | Data em que a tabela de preço se torna válida. Data no formato AAAA-MM-DD |
validade_fim | sim | Date | Data em que a tabela de preço deixa de ser ativa. Data no formato AAAA-MM-DD |
situacao | sim | Int | 0 – Inativa / 1 – Ativa |
Retorno
Código | Retorno |
0 | Token inválido, neste caso é necessário entrar em contato novamente para obter o código de acesso |
1 | Operação realizada com sucesso |
9 | Erro ao salvar tabela de preço. Confirme os parâmetros utilizados. |
Exemplo
Exemplo de requisição para obter as cotações com as informações sendo enviadas através do SoapU:
<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">INFORMAR TOKEN</token>
<codigo xsi:type="xsd:string">123</codigo>
<nome xsi:type="xsd:string">Tabela XPTO</nome>
<validade_inicio xsi:type="xsd:string">2023-10-11</validade_inicio>
<validade_fim xsi:type="xsd:string">2023-10-11</validade_fim>
<situacao xsi:type="xsd:string">1</situacao>
</urn:gravaTabPreco>
</soapenv:Body>
</soapenv:Envelope>
Agora o exemplo de retorno com sucesso:
<SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:gravaTabPrecoResponse xmlns:ns1="urn:SOAPServerWSDL">
<return xsi:type="xsd:string">1</return>
</ns1:gravaTabPrecoResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Método: gravaPrecoItem
Descrição: método responsável por gravar os itens da tabela de preço
Parâmetro | Obrigatório | Formato | Descrição |
token | sim | String | Identificador único da empresa para uso do método |
tabpreco | sim | String | Código da tabela de preço |
item | sim | String | Código do produto/serviço cadastrado https://app.procedo.com.br/item |
preco_minimo | sim | Decimal | Preço mínimo a ser praticado. Formato >>9.99 |
quantidade_minima | não | Inteiro | Quantidade mínima do item a ser aceitável em uma cotação de vendas |
indisponivel | não | Inteiro | 0 – Não 1 – Sim |
cond_pagto | sim | Inteiro | Código da condição de pagamento do item dentro da tabela de preço https://app.procedo.com.br/condpagto |
Retorno
A tabela abaixo indica os possíveis retornos de erros ou confirmação para o método gravaPrecoItem.
Código | Retorno |
0 | Token inválido, neste caso é necessário entrar em contato novamente para obter o código de acesso |
1 | Operação realizada com sucesso |
9 | Item não encontrado |
11 | Tabela de Preço não encontrada |
Exemplo de requisição para gravar os dados de itens da tabela de preço
<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">b9c5247d-726a-11ee-95d9-1274f891389f</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>
Agora o exemplo de retorno com sucesso
<SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:gravaPrecoItemResponse xmlns:ns1="urn:SOAPServerWSDL">
<return xsi:type="xsd:string">1</return>
</ns1:gravaPrecoItemResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>