# Rotina de Consulta - Status e Recebimento de Cobranças Gateway e API

## Introdução

A **Rotina Consulta de Status Cobranças Gateway e API** é uma funcionalidade essencial do sistema que permite aos usuários verificar e atualizar o status das cobranças manualmente por meio dos gateways de pagamento e APIs bancárias. Esta rotina é utilizada geralmente quando ocorre alguma anormalidade no fluxo de envio da notificação de pagamento da integração bancária para o Sistema. Ao executá-la, é realizada uma nova consulta ao Gateway ou API de pagamento, trazendo as liquidações que possam estar pendentes em um período específico.

> [!NOTA] **Acesso ao Formulário**
> **Caminho:** Inicio > Menu Configurações > Rotinas Financeiro > Rotinas gateway > Botão Consultar recebimentos > Executar

## Benefícios

- Automatização do processo de verificação de recebimentos.
- Redução de erros manuais na atualização de informações financeiras.
- Melhoria na conciliação bancária.
- Aumento da eficiência operacional do setor financeiro.

## Passo a Passo - Rotina Consulta Recebimento Cobranças Gateway e API
1. Acesse o **Menu Configurações**.
2. Clique em **Rotinas Financeiro**.
3. Selecione o submenu **Rotinas Gateway**.
4. Vá até a aba **Consultar Recebimento**.
5. Preencha os filtros:
   - **Carteira de cobrança:** Selecione a carteira para a qual você realizará a consulta dos **Logs Gateway** de pagamentos.
   - **Data inicial:** Insira a data inicial do período de consulta.
   - **Data Final:** Insira a data final do período de consulta.
   - **Senha:** Insira a senha obrigatória para que a rotina de consulta seja executada; solicite ao nosso suporte.
6. Clique no botão **Consultar Recebimentos**.
7. Selecione a opção **Executar**.
8. A rotina será executada e trará um retorno sobre o status da consulta ao finalizar.
9. Fim.

> [!DANGER] Atenção!
> No contexto geral, a **data inicial** e **final** se referem ao período em que as cobranças foram liquidadas pelo Gateway ou API de pagamento. <hr> 
> A senha da rotina não é pública, você pode solicitar através do contato direto com nosso **Suporte Técnico**.

## Fluxo de Processo

```mermaid
graph TD
    A[Início] --> B[Acesse o Menu Configurações]
    B --> C[Clique em Rotinas Financeiro]
    C --> D[Selecione o submenu Rotinas Gateway]
    D --> E[Vá até a aba Consultar Recebimento]
    E --> F[Preencha os filtros]
    F --> G[Selecione a Carteira de cobrança]
    G --> H[Insira a Data inicial]
    H --> I[Insira a Data Final]
    I --> J[Insira a Senha]
    J --> K[Clique no botão Consultar Recebimentos]
    K --> L[Selecione a opção Executar]
    L --> M[Aguarde a execução da rotina]
    M --> N[Verifique o status da consulta]
    N --> O[Fim]

```

## Particularidades de Cada Integração
Cada integração bancária, seja Gateway ou API de Pagamento, possui parâmetros e funcionamentos distintos.

### Gateway de Pagamento

> [!EXAMPLE] Integrações
> 
> **[[gateway asaas|Gateway Asaas]]**
> - Não possui restrições quanto ao período de consulta. O filtro de datas é baseado na data de pagamento da cobrança.
> 
> **[[gateway lytex|Gateway Lytex]]**
> - Não possui restrições quanto ao período de consulta. O filtro de datas é baseado na data de pagamento da cobrança.
> 
> **[[gateway efi|Gateway Efí]]**
> - Não possui restrições quanto ao período de consulta, desde que não exceda o limite de requisições diárias. Recomenda-se não consultar períodos maiores que 15 dias de uma só vez. O limite de requisições a cada **24 horas** é de **7 mil** (inclui geração de boleto e rotina de consulta). Recomendado consultar no **máximo 4 mil títulos a cada 24 horas**.
>
> **[[gateway cel_cash|Gateway Cel_cash]]**
> - Não possibilita a consulta via sistema, sendo necessário contatar o Suporte do Banco para reenvio de Logs Gateway de pagamento ao sistema.
>
> **[[gateway wide pay|Gateway Wide Pay]]**
> - Não possui restrições quanto ao período de consulta. Recomendado fazer o reenvio dos Logs Gateway de pagamento através da sua conta bancária, ou solicitando ao Suporte Wide Pay.
>
> **[[gateway iugu|Gateway Iugu]]**
> - Não possibilita a consulta via sistema, sendo necessário fazer o reenvio através de sua conta ou pelo site Dev da Iugu, conforme as instruções presentes no tópico **Reenvio de Gatilhos Iugu** da documentação [[gateway iugu|Gateway Iugu]]. 

> [!WARNING] Atenção!
> Dependendo do Gateway, após fazer o reenvio dos Logs Gateway para o sistema, eles serão processados imediatamente ou ficarão pendentes para serem processados em até 3 horas. Caso necessite urgência, os Logs Gateway provenientes do reenvio podem ser processados manualmente no caminho: <hr>
> **Menu Configurações > Logs > Logs Gateway > {Logs de Status = Pendente}**.

### API Bancária

> [!EXAMPLE] Integrações
>
> **[[api banco do brasil|API Banco do Brasil]]**
> - Não possui restrições quanto ao período de consulta. O filtro de datas é baseado na data de pagamento da cobrança. Recomendado não consultar períodos maiores que 15 dias por vez.
> 
> **[[api banco santander|API Banco Santander]]**
> - Não possui restrições quanto ao período de consulta. O filtro de datas é baseado na data de pagamento da cobrança.
> 
> **[[public/conceitos/gerais/api banco sicoob|API Banco Sicoob]]**
> - Período limite de consulta de 3 dias (ex: 01/01/25 até 03/01/25). O filtro de datas é baseado na data de pagamento da cobrança.
> 
> **[[api banco sicredi|API Banco Sicredi]]**
> - Período limite de consulta de 2 dias (ex: 01/01/25 até 02/01/25). O filtro de datas é baseado na data de pagamento da cobrança.
> 
> **[[api banco credisis|API Banco CrediSIS]]**
> - Não possui restrições quanto ao período de consulta. O filtro de datas é baseado na data de pagamento da cobrança.

## Considerações Finais
A **Rotina Consulta Recebimento Cobranças Gateway e API** é uma ferramenta poderosa para otimizar o processo de gestão financeira da empresa. Ao configurar corretamente esta rotina, você garante que todas as transações de recebimento sejam registradas de forma precisa e oportuna no sistema, reduzindo a carga de trabalho manual e minimizando erros.

## Etiquetas
#CarteiraDeCobranca #Financeiro #ContasAReceber #GatewayDePagamento #APIDePagamento #LogGateway

## Leia Também
- [[carteira de cobranca|Carteira de Cobrança]]
- [[integracoes bancarias - carteira de cobranca|Integrações Bancárias - Carteira de Cobrança]]
- [[integracoes bancarias - api|Integrações Bancárias - API]]
- [[integracoes bancarias - gateway|Integrações Bancárias - Gateway]]
- [[contas a receber|Contas a Receber]]
- [[rotinas gateway|Rotinas Gateway]]
- [[rotina consulta status de cobrancas gateway e api|Rotina Consulta Status de Cobranças Gateway e API]]
- [[rotina alteracao de cadastro galax pay|Rotina Alteração de Cadastro Galax Pay]]
- [[relatorios financeiros|Relatórios Financeiros]]
- [[consulta manual de pagamentos|Consulta Manual de Pagamentos]]