Ogmma Revenue

Glosas

GET/v1/glosas/{id}

Uma glosa, com significado e evidência

Escopo:
glosa:ler
Resposta:
200

Pedido

Caminho

{id}*Identificador do recurso no Miydas. Opaco e estável — NÃO é o número que a operadora ou o seu sistema usam para a mesma coisa. Guarde-o como veio e não derive significado do formato.

Exemplo de chamada

curl -X GET https://api.miydas.com.br/v1/glosas/cmf3k2x9a0001aut \
  -H "Authorization: Bearer $MIYDAS_CHAVE"

Resposta 200

dataGlosaO recurso. Os campos estão na tabela abaixo.

Uma glosa, no nível em que a operadora a declarou, com o significado oficial do motivo.

Campos de Glosa

CampoTipoO que é
idtextoIdentificador do recurso no Miydas. Opaco e estável — NÃO é o número que a operadora ou o seu sistema usam para a mesma coisa. Guarde-o como veio e não derive significado do formato.
niveltexto
um de: PROTOCOLO, GUIA, ITEM
Em que nível a glosa pende: ITEM, GUIA ou PROTOCOLO. Medido na base: 56.709 em item, 262 em guia, nenhuma em protocolo — o recurso TISS é item a item, e é no item que a glosa quase sempre mora.
motivoobjetoO motivo como a operadora o deu. significado vem da Tabela 38 da ANS quando o código existe lá.
codigotextoO código do motivo, como a operadora o emitiu.
significadotextoTermo oficial da Tabela 38. Nulo quando o código não existe na tabela.
tipotexto
um de: TABELA_ANS, CODIGO_OPERADORA, CATEGORIA, TEXTO_LIVRE, NENHUM
Derivado do que está presente, não do campo tipoMotivo do banco — que está nulo em 93 % das linhas.
tipoDeclaradotextoO que o parser gravou em tipoMotivo. Para auditar o parser, não para decidir.
codigoOperadoratextoO código do prestador NA operadora. Cada operadora tem o seu, e é ele que a operadora exige no documento — não o CNPJ.
categoriatextoO agrupamento que a operadora deu ao motivo, quando ela agrupa. Mais grosso que o código e, em operadora que não usa a Tabela 38, às vezes a única pista.
notaAuditortextoArgumento do auditor da operadora. Insumo direto de recurso.
descricaotextoO texto livre que a operadora escreveu sobre esta glosa, além do motivo codificado.
valortextoDecimal em string. null = a fonte não informou; "0.00" = informou zero. Os dois são diferentes.
operadoraobjetoA operadora do documento, identificada pelo registro ANS.
registroANStextoRegistro da operadora na ANS, seis dígitos (ex. 334561). É a chave de operadora em toda a API — não usamos nome nem código interno para identificar operadora.
nometextoRazão social da operadora como a ANS a publica. Informativo — a chave é o registro.
competenciatextoYYYY-MM (UTC) da data de NEGÓCIO: crédito na retenção, protocolo na glosa. Nunca da emissão.
protocolotextoO protocolo que a operadora devolveu ao receber. É o número que prova a entrega e por onde se consulta o andamento depois.
guiaobjetoA guia a que este registro pertence.
numeroGuiaPrestadortextoO número que VOCÊ deu à guia. O TISS não deixa repetir dentro do prestador, e é por ele que você reencontra a guia aqui.
numeroGuiaOperadoratextoO número que a OPERADORA deu à guia. Só existe depois que ela respondeu, e é o número que vale numa discussão com ela.
carteiratextoNúmero da carteirinha do beneficiário na operadora, como está no cartão. Sem máscara nem separador.
beneficiariotextoO nome do beneficiário, como a operadora o devolveu. Pode divergir do seu cadastro, e em boa parte dos documentos nem vem — a carteirinha é que identifica.
itemobjetoO item glosado. Nulo em glosa de nível GUIA ou PROTOCOLO — e é por ele que se monta o recurso, que no TISS é item a item.
codigoTabelatextoQual tabela o código usa (22 = TUSS procedimentos, 18/19/20 = materiais, taxas e medicamentos, 00 = tabela própria da operadora).
codigoProcedimentotextoCódigo do procedimento na tabela declarada em codigoTabela.
descricaotextoA descrição do procedimento glosado, como o documento a trouxe.
evidenciaobjetoO documento de onde a glosa saiu, com até onde ele veio.
demonstrativoIdtextoO demonstrativo a que este registro pertence, pelo identificador do Miydas.
emitidoEmtextoQuando NÓS recebemos o documento — o portal o renderiza no download.
protocoloEmtextoA data de negócio do protocolo, de onde sai a competência.
fonteOrdeminteiroQual arquivo do demonstrativo composto trouxe esta glosa.
completudetextoFULL | ACCEPTED_ONLY | GLOSA_ONLY — o que o conjunto de arquivos permite afirmar.
profundidadetextoAté onde o documento desce: PROTOCOLO, GUIA ou ITEM. Documento que para na guia não permite recurso item a item.
registradaEmtextoQuando o Miydas registrou o fato, em ISO 8601 com fuso. Não é quando ele aconteceu na operadora.

Exemplo de retorno

{
  "data": {
    "id": "cmf3k2x9a0001glo",
    "nivel": "ITEM",
    "motivo": {
      "codigo": "1705",
      "significado": "VALOR APRESENTADO A MAIOR",
      "tipo": "TABELA_ANS",
      "tipoDeclarado": null,
      "codigoOperadora": null,
      "categoria": null,
      "notaAuditor": null
    },
    "descricao": "Item não liberado na análise",
    "valor": "8.94",
    "operadora": {
      "registroANS": "334561",
      "nome": "Unimed Blumenau"
    },
    "competencia": "2026-09",
    "protocolo": "PROTO-18700001",
    "guia": {
      "numeroGuiaPrestador": "000123",
      "numeroGuiaOperadora": "18700001",
      "carteira": "00000000000000000",
      "beneficiario": "PACIENTE EXEMPLO"
    },
    "item": {
      "codigoTabela": "22",
      "codigoProcedimento": "40301591",
      "descricao": "Colesterol (LDL)"
    },
    "evidencia": {
      "demonstrativoId": "cmf3k2x9a0002dem",
      "emitidoEm": "2026-09-30",
      "protocoloEm": "2026-09-12",
      "fonteOrdem": 0,
      "completude": "FULL",
      "profundidade": "A"
    },
    "registradaEm": "2026-10-01T09:14:22.000Z"
  }
}

Experimente sem chave

O sandbox devolve este mesmo corpo, sem autenticação e sem tocar na base de ninguém.

curl https://api.miydas.com.br/v1/sandbox/glosas_obter

A chave de teste myd_test_… é outra coisa: ela opera na homologação da operadora e serve para escrever. Para ver o formato antes de ter credencial, convênio e varredura, é este sandbox.

Erros

CódigoHTTPQuandoO que fazer
RECURSO_NAO_ENCONTRADO404O id não existe — ou é de outra empresa, o que a API não distingue de propósito. Também a rota inexistente na v1.Confira o id.

Toda falha tem o mesmo formato: { "error": "CODIGO", "message": "…", "details": { … } }. error é estável e serve para lógica; message é para gente e pode mudar. Erros comuns a toda rota com chave (lista completa) não se repetem aqui.