# Consultar Histórico de Transações

A API de Consulta (`/consulta`) permite pesquisar transações passadas com base em intervalos de datas, resultados ou identificadores específicos. Esta é sua ferramenta principal para conciliação e para "recuperar" o status das operações se o seu servidor não receber uma notificação assíncrona.

## O Endpoint de Consulta

* **URL de Teste:** `https://tpvpc-i.redsys.es:27443/TPV_PC/services/rest/tpvpcwss/v1/consulta`  
* **URL de Produção:** `https://tpvpc.redsys.es/TPV_PC/services/rest/tpvpcwss/v1/consulta`  
* **Método:** `POST`

## Critérios de Pesquisa

Para realizar uma pesquisa, você deve enviar uma requisição JSON assinada. Os campos específicos que você inclui determinam o escopo da pesquisa.

### Campos Obrigatórios

* `fechaInicio`: Data de início (Formato: `YYYY-MM-DD-HH.mm.ss` ou `YYYY-MM-DD HH:mm:ss`).  
* `fechaFin`: Data de término. **Nota:** O intervalo máximo entre o início e o término é de **30 dias**.

### Filtros Opcionais

Você pode refinar sua pesquisa usando estes campos:

* `pedido`: O Order ID específico atribuído pelo sistema.  
* `factura`: Sua referência de fatura personalizada.  
* `operacion`: Filtrar por tipo (`PAGO`, `PREAUTORIZACION`, `CONFIRMACION`, `DEVOLUCION`).  
* `resultado`: Filtrar por resultado (`AUTORIZADA`, `DENEGADA`).  
* `rts`: O Transaction ID específico (RTS). Se fornecido, ele substitui outros filtros e retorna apenas essa operação específica.

## Passo 1: Enviar uma Requisição de Consulta

Aqui está um exemplo de requisição pesquisando por pagamentos autorizados dentro de uma janela de tempo específica.

```json
{
  "info": {
    "comercio": "777888991",
    "timestamp": "20250428 111217",
    "datosOperacion": {
      "fechaInicio": "2025-03-03-16.00.01",
      "fechaFin": "2025-03-04-16.35.09",
      "operacion": "PAGO",
      "resultado": "AUTORIZADA",
      "factura": "FAC-LATENTE",
      "pagina": 0
    }
  },
  "signature": "YOUR_CALCULATED_SIGNATURE"
}
```

> **Paginação**: Se sua pesquisa retornar muitos resultados, use o campo `pagina` (começando em `0`) para navegar pelos conjuntos de resultados.

## Passo 2: Tratar a Resposta

A resposta contém metadados de paginação e uma lista de `operaciones`.

```json
{
  "info": {
    "comercio": "777888991",
    "resultadoConsulta": {
      "numOperaciones": 1,
      "numPagina": 0,
      "totalPaginas": 1,
      "operaciones": [
        {
          "tipoOper": "Autorizacion",
          "tarjeta": "************7899",
          "importe": "2.02",
          "moneda": "978",
          "pedido": "4894",
          "fechaOperacion": "2025-05-05 16:10:56.0",
          "factura": "FAC-LATENTE",
          "estado": "F",
          "resultado": "AUTORIZADA",
          "codigoRespuesta": "0",
          "numAutorizacion": "577498"
        }
      ]
    },
    "resultado": {
      "codigo": "0"
    }
  },
  "signature": "SERVER_SIGNATURE"
}
```

### Interpretando o Status da Transação

Dentro da lista `operaciones`, o campo `estado` informa o estado atual do ciclo de vida da transação:

| Valor | Significado | Descrição |
| :---- | :---- | :---- |
| `F` | Finalizada | A operação foi concluída com sucesso (Aprovada ou Negada). |
| `P` | Em Processo | O terminal provavelmente ainda está aguardando a interação do usuário. |
| `T` | Falha Técnica | Ocorreu um erro durante o processamento. |
| `G` | Negada | O banco rejeitou a transação. |
| `A` | Cancelada | O usuário ou o sistema cancelou a operação. |

## Próximos Passos

* [**Depurar Problemas de Assinatura e Conectividade**](/pt/get-smart/get-smart-api-cloud/integration-guides/debug-signature-and-connectivity-issues)**:** Se a sua consulta retornar "Firma Incorrecta", certifique-se de estar assinando a string JSON exata enviada.  
* [**Endpoint de Totais e Conciliação**](/pt/get-smart/get-smart-api-cloud/reference/totals-and-reconciliation-endpoint)**:** Aprenda como obter totais diários em vez de listas de transações individuais.