# 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)

```javascript
<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

```javascript
<?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>
```

---

**Documents**

- [Changelog](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/changelog-Zm8YRaLsX2)
- [Comercial e Vendas](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/comercial-e-vendas-mLzQaeyoTV)
- [Configurações Gerais](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/configuracoes-gerais-J7dm490z1m)
- [Gestão de Relacionamento (CRM)](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/gestao-de-relacionamento-crm-74VyXWo680)
- [Integrações](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/integracoes-zJfkJOXdix)
- [Operações e Produtividade](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/operacoes-e-produtividade-k2U2Vd3Fk8)
- [Projetos](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/projetos-jaD6SWGAB9)
- [Relatórios](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/relatorios-uab6Sta2qa)