Financeiro · Referência

Conciliação Bancária

Transações bancárias importadas e o vínculo com pagamentos/despesas/acordos.

Permissão: conciliacao_bancariaAções: ler · exportar2 campo(s) LGPDglobal (sem carteira)

GET/v1/conciliacao_bancariaListar GET/v1/conciliacao_bancaria/{id}Detalhar GET/v1/conciliacao_bancaria/exportarExportar em lote

O objeto conciliação bancária

Campo	Tipo	Descrição
`id`	inteiro	Identificador	ordenar
`bank_code`	texto	bank code	filtro
`bank_name`	texto	bank name
`posted_at`	data-hora	posted at	ordenar
`amount`	decimal (string)	Valor	ordenar
`direction`	texto (enum)	direction `in` `out`	filtro
`description`	texto	Descrição
`counterpart_name`	texto	counterpart name	LGPD
`counterpart_doc`	texto	counterpart doc	LGPD
`counterpart_bank`	texto	counterpart bank
`reconcile_status`	texto (enum)	reconcile status `pending` `matched` `manual` `ignored`	filtro
`match_type`	texto (enum)	match type `payment` `expense` `agreement` `manual`	filtro
`match_id`	inteiro	match id
`match_confidence`	número	match confidence
`match_reason`	texto	match reason
`source`	texto (enum)	source `webhook` `ofx` `csv` `manual` `ofx_manual`
`created_at`	data-hora	Criado em
`reconciled_at`	data-hora	reconciled at

Exemplo do objeto200 OK

{
    "id": 1024,
    "bank_code": "texto",
    "bank_name": "texto",
    "posted_at": "2026-10-08T14:30:00-03:00",
    "amount": "150.00",
    "direction": "in",
    "description": "Aluguel semanal",
    "counterpart_name": "texto",
    "counterpart_doc": "texto",
    "counterpart_bank": "texto",
    "reconcile_status": "pending",
    "match_type": "payment",
    "match_id": 512,
    "match_confidence": 1.5,
    "match_reason": "texto",
    "source": "webhook",
    "created_at": "2026-10-08T14:30:00-03:00",
    "reconciled_at": "2026-10-08T14:30:00-03:00"
}

GET Listar

Retorna os registros paginados, do mais recente para o mais antigo (padrão). Requer Ler.

Parâmetros de consulta

Parâmetro	Tipo	Descrição
`pagina`	inteiro	Página (padrão 1)
`por_pagina`	inteiro	1 a 200 (padrão 50)
`ordenar`	texto	Aceita: `id`, `posted_at`, `amount` — prefixo `-` para decrescente
`campos`	texto	Lista de campos do objeto, separados por vírgula
`reconcile_status`	texto (enum)	reconcile status — valor exato ou lista separada por vírgula `pending` `matched` `manual` `ignored`
`direction`	texto (enum)	direction — valor exato ou lista separada por vírgula `in` `out`
`match_type`	texto (enum)	match type — valor exato ou lista separada por vírgula `payment` `expense` `agreement` `manual`
`bank_code`	texto	bank code — valor exato ou lista separada por vírgula
`criado_desde` / `criado_ate`	data	Período de criação
`atualizado_desde`	data-hora	Criados ou alterados desde (considera a data de criação)

Requisição

Testar ▸

curl -X GET "https://apimapogos.sixinformatica.com/v1/conciliacao_bancaria?por_pagina=20" \
  -H "Authorization: Bearer $MAPOGOS_API_KEY"

<?php
$ch = curl_init('https://apimapogos.sixinformatica.com/v1/conciliacao_bancaria?por_pagina=20');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST  => 'GET',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER     => [
    'Authorization: Bearer ' . getenv('MAPOGOS_API_KEY'),
  ],
]);
$resposta = json_decode(curl_exec($ch), true);
$http = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);

if ($resposta['sucesso']) {
  print_r($resposta['dados']);
} else {
  echo $resposta['erro']['mensagem'];
}

const resposta = await fetch('https://apimapogos.sixinformatica.com/v1/conciliacao_bancaria?por_pagina=20', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.MAPOGOS_API_KEY}`,
  },
});
const json = await resposta.json();

if (json.sucesso) console.log(json.dados);
else console.error(json.erro.mensagem);

import os, uuid, requests

resposta = requests.request(
    "GET",
    "https://apimapogos.sixinformatica.com/v1/conciliacao_bancaria?por_pagina=20",
    headers={"Authorization": f"Bearer {os.environ['MAPOGOS_API_KEY']}"},
    timeout=30,
)
json = resposta.json()
print(json["dados"] if json["sucesso"] else json["erro"]["mensagem"])

Resposta200 OK

{
    "sucesso": true,
    "dados": [
        {
            "id": 1024,
            "bank_code": "texto",
            "bank_name": "texto",
            "posted_at": "2026-10-08T14:30:00-03:00",
            "amount": "150.00",
            "direction": "in",
            "description": "Aluguel semanal",
            "counterpart_name": "texto"
        }
    ],
    "meta": {
        "total": 1,
        "pagina": 1,
        "por_pagina": 20,
        "paginas": 1
    },
    "request_id": "req_0f1e2d3c4b5a69788796"
}

GET Detalhar

Retorna um registro pelo id. Requer Ler.

Erro	Quando
`404 nao_encontrado`	Não existe ou está fora das carteiras da chave
`403 permissao_negada`	Sem Ler no módulo (ou numa relação pedida)

Requisição

Testar ▸

curl -X GET "https://apimapogos.sixinformatica.com/v1/conciliacao_bancaria/1024" \
  -H "Authorization: Bearer $MAPOGOS_API_KEY"

<?php
$ch = curl_init('https://apimapogos.sixinformatica.com/v1/conciliacao_bancaria/1024');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST  => 'GET',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER     => [
    'Authorization: Bearer ' . getenv('MAPOGOS_API_KEY'),
  ],
]);
$resposta = json_decode(curl_exec($ch), true);
$http = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);

if ($resposta['sucesso']) {
  print_r($resposta['dados']);
} else {
  echo $resposta['erro']['mensagem'];
}

const resposta = await fetch('https://apimapogos.sixinformatica.com/v1/conciliacao_bancaria/1024', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.MAPOGOS_API_KEY}`,
  },
});
const json = await resposta.json();

if (json.sucesso) console.log(json.dados);
else console.error(json.erro.mensagem);

import os, uuid, requests

resposta = requests.request(
    "GET",
    "https://apimapogos.sixinformatica.com/v1/conciliacao_bancaria/1024",
    headers={"Authorization": f"Bearer {os.environ['MAPOGOS_API_KEY']}"},
    timeout=30,
)
json = resposta.json()
print(json["dados"] if json["sucesso"] else json["erro"]["mensagem"])

Resposta200 OK

{
    "sucesso": true,
    "dados": {
        "id": 1024,
        "bank_code": "texto",
        "bank_name": "texto",
        "posted_at": "2026-10-08T14:30:00-03:00",
        "amount": "150.00",
        "direction": "in",
        "description": "Aluguel semanal",
        "counterpart_name": "texto"
    },
    "request_id": "req_1d2c3b4a5f6e7d8c9b0a"
}

GET Exportar em lote

Até 1000 registros por chamada, paginando por cursor. Requer Ler e Exportar. Aceita os mesmos filtros da listagem e formato=csv. Detalhes no guia Exportação em lote.

Requisição

Testar ▸

curl -X GET "https://apimapogos.sixinformatica.com/v1/conciliacao_bancaria/exportar?limite=1000" \
  -H "Authorization: Bearer $MAPOGOS_API_KEY"

<?php
$ch = curl_init('https://apimapogos.sixinformatica.com/v1/conciliacao_bancaria/exportar?limite=1000');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST  => 'GET',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER     => [
    'Authorization: Bearer ' . getenv('MAPOGOS_API_KEY'),
  ],
]);
$resposta = json_decode(curl_exec($ch), true);
$http = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);

if ($resposta['sucesso']) {
  print_r($resposta['dados']);
} else {
  echo $resposta['erro']['mensagem'];
}

const resposta = await fetch('https://apimapogos.sixinformatica.com/v1/conciliacao_bancaria/exportar?limite=1000', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.MAPOGOS_API_KEY}`,
  },
});
const json = await resposta.json();

if (json.sucesso) console.log(json.dados);
else console.error(json.erro.mensagem);

import os, uuid, requests

resposta = requests.request(
    "GET",
    "https://apimapogos.sixinformatica.com/v1/conciliacao_bancaria/exportar?limite=1000",
    headers={"Authorization": f"Bearer {os.environ['MAPOGOS_API_KEY']}"},
    timeout=30,
)
json = resposta.json()
print(json["dados"] if json["sucesso"] else json["erro"]["mensagem"])