6.2. Consultar processamento de liquidações¶

🔗 Endpoint¶

Método	URL
	`/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.

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.

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

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¶

{
  "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¶

{
  "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.
Para a posição consolidada das URs de um contrato: 5.4. Listar URs do contrato.
Headers obrigatórios e convenções gerais: 1.2. Convenções da API.