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>

 

Deixe uma resposta

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *