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: itemservice

  • Tecnologia: Webservice SOAP

  • Objetivo: Sincronização automatizada do catálogo de Produtos e Serviços.

  • Observação: Caso o codigo enviado 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>