# Tabela de Preço

## Webservice: Método gravaTabPreco

Este método permite a criação e atualização de cabeçalhos de Tabelas de Preço de forma automatizada via integração SOAP.

## 1. Informações de Conexão

* **URL WSDL (Produção):** `https://app.procedo.com.br/api/tabprecoservice?wsdl`
* **URL WSDL (Testes/QA):** `https://qa.procedo.com.br/api/tabprecoservice?wsdl`
* **Tecnologia:** SOAP
* **Observação:** Solicite seu token de segurança via `suporte@procedo.com.br`.

## 2. Parâmetros e Regras

| **Parâmetro** | **Obrigatório** | **Formato** | **Descrição** |
|-----------|-------------|---------|-----------|
| **token** | Sim         | String  | Identificador único da empresa. |
| **codigo** | Sim         | String  | Código identificador da tabela. |
| **nome**  | Sim         | String  | Nome descritivo da tabela. |
| **validade_inicio** | Sim         | Date    | Início da vigência (AAAA-MM-DD). |
| **validade_fim** | Sim         | Date    | Término da vigência (AAAA-MM-DD). |
| **situacao** | Sim         | Int     | 0 – Inativa / 1 – Ativa. |

**Códigos de Retorno:** `0` (Token inválido), `1` (Sucesso), `9` (Erro ao salvar - verifique os parâmetros).

## 3. Exemplo de Requisição (SOAP)

```javascript
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:SOAPServerWSDL">
   <soapenv:Header/>
   <soapenv:Body>
      <urn:gravaTabPreco soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
         <token xsi:type="xsd:string">SEU_TOKEN_AQUI</token>
         <codigo xsi:type="xsd:string">123</codigo>
         <nome xsi:type="xsd:string">Tabela XPTO</nome>
         <validade_inicio xsi:type="xsd:string">2026-02-27</validade_inicio>
         <validade_fim xsi:type="xsd:string">2026-12-31</validade_fim>
         <situacao xsi:type="xsd:string">1</situacao>
      </urn:gravaTabPreco>
   </soapenv:Body>
</soapenv:Envelope>
```


---

## 📑 Webservice: Método gravaPrecoItem

Este método é responsável por alimentar a tabela de preço com os itens (produtos/serviços), definindo seus valores e condições comerciais.

## 1. Parâmetros de Entrada

| **Parâmetro** | **Obrigatório** | **Formato** | **Descrição** |
|-----------|-------------|---------|-----------|
| **token** | Sim         | String  | Identificador único da empresa. |
| **tabpreco** | Sim         | String  | Código da tabela de preço de destino. |
| **item**  | Sim         | String  | Código do produto/serviço no sistema. |
| **preco_minimo** | Sim         | Decimal | Preço mínimo permitido (Formato: 9.99). |
| **preco** | Sim         | Decimal | Preço de tabela praticado. |
| **cond_pagto** | Sim         | Inteiro | Código da condição de pagamento. |
| **indisponivel** | Não         | Inteiro | 0 – Não / 1 – Sim. |

**Códigos de Retorno:** `1` (Sucesso), `9` (Item não encontrado), `11` (Tabela de Preço não encontrada).

## 2. Exemplo de Requisição (Inserção de Item)

```javascript
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:SOAPServerWSDL">
   <soapenv:Header/>
   <soapenv:Body>
      <urn:gravaPrecoItem soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
         <token xsi:type="xsd:string">SEU_TOKEN_AQUI</token>
         <tabpreco xsi:type="xsd:string">TabPreco01</tabpreco>
         <item xsi:type="xsd:string">122</item>
         <preco_minimo xsi:type="xsd:string">120.23</preco_minimo>
         <preco xsi:type="xsd:string">153.24</preco>
         <quantidade_minima xsi:type="xsd:string">2</quantidade_minima>
         <indisponivel xsi:type="xsd:string">0</indisponivel>
         <cond_pagto xsi:type="xsd:string">1</cond_pagto>
      </urn:gravaPrecoItem>
   </soapenv:Body>
</soapenv:Envelope>
```

## 3. Exemplo de Retorno com Sucesso

```javascript
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Body>
      <ns1:gravaPrecoItemResponse xmlns:ns1="urn:SOAPServerWSDL">
         <return xsi:type="xsd:string">1</return>
      </ns1:gravaPrecoItemResponse>
   </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)