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?wsdlTecnologia: 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
mensagemfor 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>