O cadastro de Produto/Serviço é utilizado nas cotações dentro do módulo de CRM.

Para facilitar a integração entre o Procedo e outras soluções disponibilizamos essa API. Ela tem por objetivo inserir novos produtos/serviços no Procedo à partir de outros sistemas.

Com o serviço web SOAP (Simple Object Access Protocol) é possível integrar o seu ERP ao Procedo e realizar operações de modo automático. Este recurso é utilizado para fazer integração e/ou automatização de processos de qualquer sistema com o Procedo.

Nome: itemservice

Tecnologia: Webservice SOAP

Objetivo: Webservice que realiza operações vinculadas ao cadastro de Serviços/Produtos.

Observação: solicite seu token de segurança para utilizar os métodos do webservice [email protected]

Métodos

Método: gravaItem

Descrição: método responsável por incluir ou atualizar um novo produto/serviço no Procedo.

Parâmetro	Obrigatório	Formato	Descrição
token	sim	String	Identificação única da empresa para uso do método
código	sim	String	Código alfa-numérico do serviço/produto. Esse campo é chave primária. Não pode repetir.
nome	sim	String	Nome do produto ou serviço (Tamanho máximo: 100 caracteres)
linha	sim	String	Nome da linha de produto ou serviço. Se a linha informada ainda não existir, ela será cadastrada automaticamente.
narrativa	não	String	Narrativa complementar do item. Informações adicionais que poderão ser visualizada na exportação da cotação.
qtde múltipla	não	Decimal	Regra de inclusão na cotação que define a quantidade múltipla para o item
venda_fracionada	não	Int	Permite ou não que sejam feitas vendas fracionadas do item. (0 – Não / 1 – Sim)
tab_preco	não	String	Código alfanumérico da tabela de preço a ser utilizada por padrão

Caso o código informado já exista então será atualizado o registro.

Retorno

A tabela abaixo indica os possíveis retornos de erros ou confirmação para o método gravaItem. Esse retorno está visível no nível 5 do XML.

Código	Retorno
0	Token inválido, neste caso, é necessário entrar em contato novamente para obter o código de acesso
1	Ok
2	Tabela de preço não existe
35	Empresa sem acesso a funcionalidade solicitada
99	Erro desconhecido. Entre em contato com a Procedo.

Exemplo

Exemplo de requisição incluir um item de produto/serviço:

<x:Envelope xmlns:x="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:SOAPServerWSDL">
 <x:Header/>
 <x:Body>
 <urn:gravaItem>
 <urn:token>ses1s432f132de77dd4005fgh8da13f42943881c6455fQ2342</urn:token>
 <urn:item></urn:item>
    <urn:codigo>1.1.122</urn:codigo>
    <urn:nome>Serviço A</urn:nome>
    <urn:linha>Serviços</urn:linha>
    <urn:narrativa>Serviço de instalação de algo</urn:narrativa>
    <urn:qtde múltipla>2</urn:oportunidade>
    <urn:venda_fracionada>1</urn:venda_fracionada>
    <urn:tab_preco>Tabela A</urn:obs>
 </urn:gravaItem>
 </x:Body>
</x:Envelope>

Agora o exemplo de retorno com sucesso:

<?xml version="1.0" encoding="UTF-8"?>
<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:gravaItemResponse xmlns:ns1="urn:SOAPServerWSDL">
      <return xsi:type="xsd:string">1</return>
    </ns1:gravaItemResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>