---
title: 6.2. Consultar processamento de liquidações
url: https://docs.vehub.com.br/API/VeFlow%20-%20Cart%C3%A3o%20de%20cr%C3%A9dito/6.%20Liquida%C3%A7%C3%B5es/v1.1/6.2.%20Consultar%20processamento%20de%20liquida%C3%A7%C3%B5es/
---
# 6.2. Consultar processamento de liquidações

## 🔗 Endpoint

| Método                                                | URL                                                                 |
| ----------------------------------------------------- | ------------------------------------------------------------------- |
| ![GET](https://img.shields.io/badge/GET-brightgreen)  | `/public/api/v1.1/cartao/liquidacoes/{identificadorProcessamento}` |

---

## 🧾 Descrição

Consulta o resultado do processamento de um lote de créditos enviado em [6.1. Envio dos créditos em conta](6.1.%20Envio%20dos%20créditos%20em%20conta.md).

Serve para saber **o que a plataforma VeFlow conseguiu casar** do lote: quantos créditos foram recebidos, quantos foram conciliados com URs de contratos e quais permanecem sem correspondência. Além dos totais, a resposta devolve a situação **item a item**, na mesma granularidade em que os créditos foram enviados.

Como a conciliação é **recorrente**, a consulta reflete a posição no momento da chamada: um crédito ainda não conciliado pode ser casado em uma rodada posterior. A notificação definitiva de conciliação continua sendo o webhook — ver [3.3. Atualizações da UR](../../3.%20Notificações%20-%20WebHook/3.3.%20Atualizações%20da%20UR.md).

---

## 📤 Requisição

### 🧾 Parâmetros de rota

| Parâmetro                  | Tipo   | Obrigatório | Descrição                                                                 |
| -------------------------- | ------ | ----------- | ------------------------------------------------------------------------- |
| identificadorProcessamento | string | Sim         | GUID do lote, devolvido na resposta de **6.1. Envio dos créditos em conta**. |

Esta requisição não possui corpo.

---

## 🧪 Exemplo de cURL

```bash
curl -X GET https://api.veflow.com/public/api/v1.1/cartao/liquidacoes/86A12031-E774-4D90-A065-8E078DAB8AB2 \
  -H "Authorization: Bearer {seu_token}" \
  -H "GrupoEconomico: {seu_grupo_economico}"
```

---

## 📥 Responses

### ✅ 200 OK

```json
{
  "identificador": "86A12031-E774-4D90-A065-8E078DAB8AB2",
  "recebidas": 2,
  "conciliadas": 1,
  "naoConciliadas": 1,
  "itens": [
    {
      "data": "2025-09-10",
      "cnpj": "12345678000199",
      "credenciadora": "11111111000191",
      "arranjo": "VCC",
      "valor": 1500.00,
      "situacaoConciliacao": 1,
      "identificadorMovimentacao": "1B428B23-C0A8-46D5-AF2C-1AFFAFAAC653"
    },
    {
      "data": "2025-09-10",
      "cnpj": "12345678000199",
      "credenciadora": "11111111000191",
      "arranjo": "MCC",
      "valor": 842.35,
      "situacaoConciliacao": 2,
      "identificadorMovimentacao": "9D3F0C68-77A1-4B52-B0E9-5C4A2E8D1F77"
    }
  ]
}
```

| Campo                             | Tipo   | Descrição                                                                                          |
| --------------------------------- | ------ | -------------------------------------------------------------------------------------------------- |
| identificador                     | string | GUID do lote consultado (o mesmo informado na rota).                                               |
| recebidas                         | number | Quantidade de créditos recebidos no lote.                                                          |
| conciliadas                       | number | Quantidade de créditos já casados com URs de contratos.                                            |
| naoConciliadas                    | number | Quantidade de créditos ainda sem correspondência. Sempre `recebidas - conciliadas`.                |
| itens                             | array  | Situação individual de cada crédito enviado no lote.                                               |
| → data                            | string | Data em que o valor foi creditado, no formato `YYYY-MM-DD`.                                         |
| → cnpj                            | string | CNPJ do estabelecimento comercial (somente números).                                               |
| → credenciadora                   | string | CNPJ da credenciadora que efetuou o crédito.                                                        |
| → arranjo                         | string | Sigla do arranjo de pagamento (ex.: `"MCC"`, `"VCC"`).                                             |
| → valor                           | number | Valor creditado, exatamente como enviado em 6.1.                                                    |
| → situacaoConciliacao             | number | Situação do crédito na conciliação (ver tabela abaixo).                                            |
| → identificadorMovimentacao       | string | Identificador da movimentação no sistema de origem, quando informado no envio.                     |

### 🔢 Situações de conciliação

| Valor | Situação        | Significado                                                                                 |
| ----- | --------------- | ------------------------------------------------------------------------------------------- |
| `1`   | Conciliada      | O crédito foi casado com uma UR constituída em contrato.                                    |
| `2`   | Não conciliada  | O crédito não encontrou UR correspondente e segue sendo reavaliado nas próximas rodadas.    |

---

### ❌ 404 Not Found

```json
{
  "tipo": "https://tools.ietf.org/html/rfc9110#section-15.5.5",
  "titulo": "Atenção",
  "status": 404,
  "erros": [
    "Processamento de liquidações não encontrado."
  ]
}
```

Retornado quando o `identificadorProcessamento` informado não existe ou não pertence ao grupo econômico da requisição.

---

## 🕒 Observações

* Um crédito com `situacaoConciliacao` igual a `2` **não indica erro de envio**: pode significar que a UR correspondente ainda não estava constituída, que o valor divergiu do esperado ou que o crédito se refere a um EC sem contrato ativo.
* Divergências de valor entre o crédito recebido e a UR registrada (liquidação parcial, chargeback) aparecem na notificação de conciliação, não nesta consulta — ver [3.3. Atualizações da UR](../../3.%20Notificações%20-%20WebHook/3.3.%20Atualizações%20da%20UR.md).
* Para a posição consolidada das URs de um contrato: [5.4. Listar URs do contrato](../../5.%20Contrato%20de%20recebíveis/v1.1/5.4.%20Listar%20URs%20do%20contrato.md).
* Headers obrigatórios e convenções gerais: [1.2. Convenções da API](../../1.%20Início/1.2.%20Convenções%20da%20API.md).