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>