Changelog API Grafeno: 2026-06-23

Added: [API - Titularidades] Novos filtros para a listagem de títulos disponíveis para captura

Adicionamos novos filtros de consulta ao endpoint de títulos disponíveis para captura, permitindo a busca por identificadores bancários amplamente utilizados em fluxos de conciliação: Nosso Número (ourNumber) e Seu Número (yourNumber).

Atualmente, o endpoint de consulta de títulos disponíveis para captura via Grafeno Titularidades permite que clientes listem cobranças elegíveis para captura de titularidade e automação operacional. Entretanto, os filtros disponíveis não contemplavam campos centrais no universo bancário e de conciliação, como o Nosso Número e o Seu Número, exigindo que integrações trouxessem grandes volumes de registros e aplicassem a filtragem do lado do cliente. Com esta atualização, esses identificadores passam a ser filtráveis diretamente na requisição.

Os seguintes filtros passam a ser aceitos pelo endpoint:

• ourNumberEq — Filtra por Nosso Número exatamente igual ao valor informado.
• ourNumberGt — Filtra por Nosso Número maior que o valor informado.
• ourNumberLt — Filtra por Nosso Número menor que o valor informado.
• yourNumberEq — Filtra por Seu Número exatamente igual ao valor informado.

Os filtros seguem o padrão atual da API Grafeno, informados via query params no formato q[campo+filtro]=valor. Eles podem ser utilizados de forma isolada, combinados entre si ou somados aos demais filtros já existentes no endpoint.

Exemplos de uso

GET /v2/concessions/assignors/{assignor_id}/charges?q[ourNumberEq]=123456789

GET /v2/concessions/assignors/{assignor_id}/charges?q[ourNumberGt]=1000

GET /v2/concessions/assignors/{assignor_id}/charges?q[ourNumberLt]=5000

GET /v2/concessions/assignors/{assignor_id}/charges?q[yourNumberEq]=PED-445

GET /v2/concessions/assignors/{assignor_id}/charges?q[ourNumberGt]=1000&q[ourNumberLt]=5000

GET /v2/concessions/assignors/{assignor_id}/charges?q[ourNumberEq]=123456&q[yourNumberEq]=PED-445

Impacto esperado para integrações

• Nenhuma alteração foi feita nos filtros ou no retorno já existentes do endpoint.
• A adição é aditiva e retrocompatível, ou seja, integrações que não utilizam os novos filtros seguem funcionando sem qualquer ajuste.
• Os operadores Gt e Lt permitem consultas por faixa de Nosso Número quando combinados, viabilizando recortes precisos sem trazer registros desnecessários.
• Os novos filtros podem ser combinados livremente entre si e com os filtros já suportados pelo endpoint, mantendo o padrão q[campo+filtro]=valor da API.

A inclusão dos filtros por Nosso Número e Seu Número aproxima o endpoint de captura da realidade dos fluxos de conciliação bancária, permitindo localizar títulos por identificadores que as áreas operacionais e financeiras já utilizam no dia a dia. Isso reduz o volume de dados trafegado, elimina filtragens do lado do cliente e torna a automação de captura mais direta e eficiente.

Acesse a especificação técnica do endpoint de Títulos Disponíveis para Captura Grafeno para obter informações sobre como utilizar este recurso.