Demonstrativos
/v1/demonstrativos/{id}/itensO que a operadora declarou item a item, com o motivo da recusa junto
O nível mais fundo do retorno, e o maior volume do sistema: 310.760 linhas. A glosa pende de ITEM em 56.709 das 56.971 medidas — recorrer da guia inteira quando um procedimento foi recusado é pedir de volta o que já foi pago, e o recurso TISS é item a item.
motivos[] vem na própria linha, incluindo a nota do auditor quando a operadora a mandou. Buscar em /v1/glosas depois, item a item, seria N+1 do lado de quem integra.
Só documento de ANÁLISE tem itens: o de pagamento desce até a guia em 2.929 de 2.929 documentos, e pedir itens dele responde 404 dizendo isso.
- Escopo:
- retorno: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. |
Parâmetros de query
| Campo | Tipo | O que é |
|---|---|---|
| codigo | texto 1–20 caracteres | O código do procedimento ou da despesa na linha, na tabela que o documento declara. |
| tipo | texto um de: PROCEDIMENTO, DESPESA | PROCEDIMENTO ou DESPESA (material, medicamento, taxa). A despesa costuma ser onde a glosa se esconde. |
| comGlosa | texto um de: true, false | Só as linhas com glosa (true) ou só as sem (false). Omitido, traz as duas. |
| limite | inteiro 1–200 · padrão 100 | Quantos registros trazer nesta página. O teto varia por rota (50 a 200) e está nas regras do campo. |
| deslocamento | inteiro padrão 0 | Quantos registros pular, para a página seguinte. Use com paginacao.total da resposta; paginacao.temMais diz se vale pedir mais. |
| numeroGuiaPrestador | texto 1–20 caracteres | O número que VOCÊ deu à guia. O TISS não deixa repetir dentro do prestador, e é por ele que você reencontra a guia aqui. |
* obrigatório. Campo desconhecido é recusado, não ignorado: a API responde VALIDATION_ERROR em vez de descartar em silêncio.
Exemplo de chamada
curl -X GET https://api.miydas.com.br/v1/demonstrativos/cmf3k2x9a0001aut/itens \
-H "Authorization: Bearer $MIYDAS_CHAVE"Resposta 200
| data | lista de ItemDoDemonstrativo | O recurso. Os campos estão na tabela abaixo. |
| paginacao | Paginacao | Onde esta página está no total. Vem fora de data. |
O item como a operadora o declarou — o nível mais fundo do retorno, e onde a glosa mora em 56.709 das 56.971 glosas medidas. O motivo vai junto, e não num segundo pedido.
Campos de ItemDoDemonstrativo
| Campo | Tipo | O que é |
|---|---|---|
| id | texto | 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. |
| guia | objeto | A guia a que este registro pertence. |
| numeroGuiaPrestador | texto | O número que VOCÊ deu à guia. O TISS não deixa repetir dentro do prestador, e é por ele que você reencontra a guia aqui. |
| numeroGuiaOperadora | texto | O número que a OPERADORA deu à guia. Só existe depois que ela respondeu, e é o número que vale numa discussão com ela. |
| beneficiario | texto | O 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. |
| carteira | texto | Número da carteirinha do beneficiário na operadora, como está no cartão. Sem máscara nem separador. |
| protocolo | texto | O protocolo que a operadora devolveu ao receber. É o número que prova a entrega e por onde se consulta o andamento depois. |
| sequencial | inteiro | A ordem do registro dentro do documento, como a operadora a numerou. |
| tipo | texto | PROCEDIMENTO | DESPESA (material, medicamento, taxa). |
| procedimento | objeto | O procedimento a que a linha se refere. |
| tabela | texto | Qual tabela o código usa (22 = TUSS procedimentos, 00 = tabela própria da operadora). Padrão 22. |
| codigo | texto | Código do procedimento na tabela declarada. |
| descricao | texto | O que a operadora escreveu. |
| termoOficial | texto | O termo da TUSS. Divergir do anterior é informação, não erro. |
| despesa | objeto | Só em item do tipo DESPESA: procedimento não tem código de despesa nem registro ANVISA. |
| codigo | texto | Código do material, medicamento ou taxa na tabela declarada. |
| registroANVISA | texto | Registro do produto na ANVISA, quando a linha é material ou medicamento. |
| grauParticipacao | texto | O papel do profissional no procedimento, no código TISS (ex. 00 = cirurgião). |
| unidadeMedida | texto | Unidade em que a quantidade é contada, no código de TRÊS dígitos da tabela 60 do TUSS (001 a 061). Obrigatória em despesa — o padrão TISS recusa despesa sem ela, e texto livre como "ampola" não serve. |
| realizadoEm | texto | Quando o procedimento foi realizado. |
| quantidade | texto | Quantas unidades, como o documento declarou. Vem em texto porque a operadora às vezes manda fracionado (1,5) e arredondar aqui mudaria o valor da conta. |
| valorUnitario | texto | Decimal em string. null = a fonte não informou; "0.00" = informou zero. Os dois são diferentes. |
| valores | objeto | A glosa é a SOMA das glosas do item — não há coluna de glosa no item, a recusa mora na tabela de glosas. |
| informado | texto | Decimal em string. null = a fonte não informou; "0.00" = informou zero. Os dois são diferentes. |
| total | texto | Decimal em string. null = a fonte não informou; "0.00" = informou zero. Os dois são diferentes. |
| processado | texto | Decimal em string. null = a fonte não informou; "0.00" = informou zero. Os dois são diferentes. |
| liberado | texto | Decimal em string. null = a fonte não informou; "0.00" = informou zero. Os dois são diferentes. |
| glosa | texto | Decimal em string. null = a fonte não informou; "0.00" = informou zero. Os dois são diferentes. |
| fonteOrdem | inteiro | Qual dos arquivos do demonstrativo composto trouxe esta linha. Cruze com fontes[].ordem do detalhe. |
| motivos | lista de objetos | Por que esta linha foi cortada, na palavra da operadora e no termo oficial. Vem junto, e não num segundo pedido — é o insumo do recurso. |
| codigo | texto | O código do motivo, como a operadora o emitiu. Na glosa, é o código da Tabela 38 da ANS quando ela usa o oficial. |
| significado | texto | O termo oficial da Tabela 38 da ANS, quando o código existe nela. |
| tipo | texto um de: TABELA_ANS, CODIGO_OPERADORA, CATEGORIA, TEXTO_LIVRE, NENHUM | Que espécie de motivo é este, derivado do que veio preenchido. NENHUM = cortaram sem dizer por quê. |
| codigoOperadora | texto | O código do prestador NA operadora. Cada operadora tem o seu, e é ele que a operadora exige no documento — não o CNPJ. |
| categoria | texto | O agrupamento que a operadora deu ao motivo, quando ela agrupa. |
| notaAuditor | texto | O argumento do auditor. Insumo direto do recurso. |
| descricao | texto | O motivo em texto, na língua da operadora — não traduzido. |
| valor | texto | Decimal em string. null = a fonte não informou; "0.00" = informou zero. Os dois são diferentes. |
Exemplo de retorno
{
"data": [
{
"id": "cmf3k2x9a0001ite",
"guia": {
"numeroGuiaPrestador": "000123",
"numeroGuiaOperadora": "18700001",
"beneficiario": "PACIENTE EXEMPLO",
"carteira": "00000000000000000",
"protocolo": "PROTO-18700001"
},
"sequencial": 3,
"tipo": "PROCEDIMENTO",
"procedimento": {
"tabela": "22",
"codigo": "40301591",
"descricao": "COLESTEROL LDL",
"termoOficial": "Colesterol LDL, dosagem"
},
"despesa": null,
"grauParticipacao": null,
"unidadeMedida": null,
"realizadoEm": "2026-07-02",
"quantidade": "1",
"valorUnitario": "8.94",
"valores": {
"informado": "8.94",
"total": "8.94",
"processado": "8.94",
"liberado": "0.00",
"glosa": "8.94"
},
"fonteOrdem": 0,
"motivos": [
{
"codigo": "1705",
"significado": "VALOR APRESENTADO A MAIOR",
"tipo": "TABELA_ANS",
"codigoOperadora": null,
"categoria": null,
"notaAuditor": null,
"descricao": "Item não liberado na análise",
"valor": "8.94"
}
]
}
],
"paginacao": {
"total": 1,
"limite": 20,
"deslocamento": 0,
"temMais": false
}
}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/demonstrativos_itensA 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ódigo | HTTP | Quando | O que fazer |
|---|---|---|---|
| RECURSO_NAO_ENCONTRADO | 404 | O 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.