Divergência entre UUID nas APIs do MKAUTH

Olá pessoal, tudo certo ?

Estou realizando testes na API do MKAUTH e identifiquei um comportamento que não consegui entender.

Ao consultar um título pelo endpoint:

GET /api/titulo/listar/nossonum=04317469

recebemos o seguinte retorno contendo os campos:

{  "uuid": "01JY6TFVNP7461X4BG99NZ4290",  "uuid_lanc": "01JY6TFVNP7461X4BG99NZ4290"}

Os dois campos possuem exatamente o mesmo valor.

Porém, ao utilizar esse UUID para consultar o título através do endpoint:

GET /api/titulo/show/01JY6TFVNP7461X4BG99NZ4290

o título não é localizado.

Na prática, independentemente do UUID informado, o endpoint retorna sempre o mesmo registro (título ID 1), como se o parâmetro informado estivesse sendo ignorado ou não fosse o identificador esperado pela rota.

Nossa dúvida é:

O campo uuid retornado pelo endpoint /api/titulo/listar é realmente o identificador que deve ser utilizado no endpoint /api/titulo/show/{uuid}?
O campo uuid_lanc possui alguma finalidade específica diferente do campo uuid?
Existe algum outro identificador que deva ser utilizado para consultar um título individual?
O endpoint /api/titulo/show/{uuid} está preparado para receber UUIDs no formato retornado pelo endpoint /api/titulo/listar?

Poderiam nos orientar sobre qual é a forma correta de consultar os detalhes de um título retornado pela listagem?

Obrigado.

uuid_lanc da tabela sis_lanc é individual para cada boleto. nossonum n é um numeor esclusivo amigo. por exemplo se você gera um boleto nativo integração do efi por exemplo todos as laminas sai como nossonum gerencianet, tem uuid_lanc que pode vim 019ee512-6f20-7ca0-93d8-2d120f907231

Respostas

🌎 Elton Pereira ✅ Suporte / Addons /API Junho 21, 2026 12:05

Marcos André Rodrigues Lima Prad Junho 21, 2026 10:32

Só para complementar, preciso identificar corretamente o UUID do título para utilizar o endpoint: PUT /api/titulo/receber que solicita o UUID como parâmetro para realizar a baixa financeira.

Meu objetivo é desenvolver uma integração entre a API do Sicoob e a API do MKAUTH, permitindo que as liquidações identificadas no banco sejam automaticamente baixadas no MKAUTH, eliminando a necessidade de importação manual de arquivos CNAB.

Hoje já conseguimos localizar os títulos pelo Nosso Número através do endpoint de listagem, porém estamos travados na etapa de identificação do UUID correto para utilização nos endpoints de consulta individual e recebimento do título.

This reply was deleted.