# Extrato de Serviço

## Webservice: Método listaExtratoServico

Este método retorna os extratos de serviço que consolidam ordens de serviço e parcelas de projetos de um mesmo cliente, facilitando a prestação de contas e a integração financeira.

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

* **URL WSDL:** `https://app.procedo.com.br/api/extratoservicoservice?wsdl`
* **Tecnologia:** SOAP
* **Objetivo:** Listar registros para integração com faturamento ou ERP.

## 2. Parâmetros e Filtros

| **Parâmetro** | **Obrigatório** | **Formato** | **Descrição** |
|-----------|-------------|---------|-----------|
| **token** | Sim         | String  | Identificador único da empresa. |
| **situacao** | Sim         | Int     | 1 = Pendentes de integração; 2 = Pagos e pendentes. |

**Códigos de Retorno:** `0` (Token inválido), `1` (Ok), `2` (Situação inválida - use apenas 1 ou 2), `9` (Nenhum registro encontrado).

## 3. Estrutura do XML de Retorno

O retorno deste método possui múltiplos níveis. Cada nó `<item>` do tipo `ExtratoServico` contém:

* **Cabeçalho:** Dados gerais do extrato e valores totais.
* **Parcelas:** Lista de vencimentos e valores vinculados a projetos.
* **Ordens:** Detalhamento das Ordens de Serviço (OS) consolidadas, com horas e despesas.

**Exemplo de Resposta (Sucesso):**

```javascript
<ns1:listaExtratoServicoResponse xmlns:ns1="urn:SOAPServerWSDL">
    <return>1</return>
    <mensagem>OK</mensagem>
    <resultados>
        <item>
            <codigo>5</codigo>
            <valor_total>7000.00</valor_total>
            <parcelas>
                <item>
                    <nome_projeto>A55AB7A1</nome_projeto>
                    <valor>3500.00</valor>
                </item>
            </parcelas>
            <ordens>
                <item>
                    <cod_os>7</cod_os>
                    <horas>1.00</horas>
                </item>
            </ordens>
        </item>
    </resultados>
</ns1:listaExtratoServicoResponse>
```


---

## 📑 Webservice: Método gravaRetExtrato

Este método deve ser utilizado para confirmar a integração do extrato no sistema de destino (ERP). Ele marca o registro como integrado, removendo-o da fila de pendências.

## 1. Parâmetros de Entrada

| **Parâmetro** | **Obrigatório** | **Formato** | **Descrição** |
|-----------|-------------|---------|-----------|
| **token** | Sim         | String  | Identificador único da empresa. |
| **codigo** | Sim         | Int     | Código do Extrato no Procedo. |
| **nota_fiscal** | Não         | String  | Código da nota fiscal gerada no ERP. |
| **mensagem** | Não         | String  | Preencha apenas se houver erro na gravação externa. |

> **Log de Erro:** Se o campo `mensagem` for utilizado, o extrato ficará retido no **Log de Integração** e não será listado novamente até que a pendência seja resolvida.

## 2. Códigos de Retorno

* **1:** Ok, registro atualizado com sucesso.
* **9:** Extrato de Serviço não encontrado.
* **99:** Erro interno ao atualizar o registro.

## 3. Exemplo de Requisição (Confirmação de Integração)

```javascript
<x:Envelope xmlns:x="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:SOAPServerWSDL">
    <x:Body>
        <urn:gravaRetExtrato>
            <urn:token>SEU_TOKEN_AQUI</urn:token>
            <urn:codigo_extrato>200</urn:codigo_extrato>
            <urn:nota_fiscal>NF12345</urn:nota_fiscal>
        </urn:gravaRetExtrato>
    </x:Body>
</x: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)