Produto Serviço
Webservice: Método gravaItem
Este método é responsável por incluir novos produtos ou serviços no Procedo ou atualizar registros existentes. Ele permite que a sua base de itens esteja sempre sincronizada com o seu ERP ou sistema de inventário.
1. Informações de Conexão
Nome do Serviço:
itemserviceTecnologia: Webservice SOAP
Objetivo: Sincronização automatizada do catálogo de Produtos e Serviços.
Observação: Caso o
codigoenviado já exista na base do Procedo, o sistema realizará a atualização automática dos dados do item.
2. Parâmetros de Requisição
Parâmetro | Obrigatório | Formato | Descrição |
token | Sim | String | Identificador único da empresa. |
codigo | Sim | String | Código alfa-numérico único do item (Chave primária). |
nome | Sim | String | Nome do produto/serviço (Máx. 100 caracteres). |
linha | Sim | String | Categoria do item. Se não existir, será criada automaticamente. |
narrativa | Não | String | Descrição complementar que aparece na exportação da cotação. |
qtde múltipla | Não | Decimal | Define a regra de múltiplos para inclusão na cotação. |
venda_fracionada | Não | Int | 0 – Não / 1 – Sim (Permite decimais na quantidade). |
tab_preco | Não | String | Código da tabela de preço padrão para este item. |
3. Códigos de Retorno
0: Token inválido.
1: Ok (Sucesso na inclusão ou atualização).
2: Tabela de preço informada não existe.
35: Empresa sem acesso a esta funcionalidade.
99: Erro desconhecido (Contate o suporte Procedo).
4. Exemplo de Requisição (Inserção/Atualização)
<x:Envelope xmlns:x="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:SOAPServerWSDL">
<x:Header/>
<x:Body>
<urn:gravaItem>
<urn:token>SEU_TOKEN_AQUI</urn:token>
<urn:codigo>1.1.122</urn:codigo>
<urn:nome>Serviço de Instalação Técnica</urn:nome>
<urn:linha>Serviços</urn:linha>
<urn:narrativa>Instalação padrão com garantia de 90 dias</urn:narrativa>
<urn:qtde_multipla>1</urn:qtde_multipla>
<urn:venda_fracionada>0</urn:venda_fracionada>
<urn:tab_preco>Tabela_Principal</urn:tab_preco>
</urn:gravaItem>
</x:Body>
</x:Envelope>
5. Exemplo de Retorno com Sucesso
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Body>
<ns1:gravaItemResponse xmlns:ns1="urn:SOAPServerWSDL">
<return xsi:type="xsd:string">1</return>
</ns1:gravaItemResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>