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

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

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