Demonstrativos
/v1/retornos-sem-vinculoO julgamento da operadora que não casou com guia nenhuma
Medido: 1.809 linhas de análise e 2.857 de pagamento, R$ 65.244,35 em disputa. Não é o mesmo que guia sem envio — essa o motor criou a partir do retorno e ela aparece normalmente em /v1/guias. Aqui está a linha que não virou guia nenhuma.
É o achado mais caro de descobrir tarde: um pagamento que não casa pode ser dinheiro recebido e não reconhecido; uma glosa que não casa é prazo de recurso correndo sobre uma guia que ninguém está olhando.
- Escopo:
- retorno:ler
- Resposta:
- 200
Pedido
Parâmetros de query
| Campo | Tipo | O que é |
|---|---|---|
| tipo | texto um de: ANALISE, PAGAMENTO | De que tipo de documento veio o retorno órfão: ANALISE ou PAGAMENTO. |
| registroANS | texto 1–20 caracteres | Registro 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. |
| competencia | texto ou sem-data · formato AAAA-MM | Mês AAAA-MM da data de NEGÓCIO do documento, em UTC — crédito na retenção, protocolo na glosa. NUNCA a data de emissão: o portal renderiza o documento no download, então a emissão é o dia em que nós baixamos. |
| motivo | texto um de: GUIA_DESCONHECIDA, OPERADORA_DIVERGENTE, SEM_NUMERO_DE_GUIA | Por que o retorno não achou guia. GUIA_DESCONHECIDA: o número não existe aqui. OPERADORA_DIVERGENTE: existe, mas em outra operadora. SEM_NUMERO_DE_GUIA: o documento veio sem número para casar. |
| valorMinimo | número | Traz só registros com valor igual ou acima deste, em reais. |
| limite | inteiro 1–100 · padrão 50 | 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. |
* 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/retornos-sem-vinculo \
-H "Authorization: Bearer $MIYDAS_CHAVE"Resposta 200
| data | lista de RetornoSemVinculo | O recurso. Os campos estão na tabela abaixo. |
| paginacao | Paginacao | Onde esta página está no total. Vem fora de data. |
Julgamento da operadora que não casou com guia nenhuma. Medido: 4.666 linhas, R$ 65.244,35 em disputa. Não é o mesmo que guia sem envio — essa existe e aparece em /v1/guias.
Campos de RetornoSemVinculo
| Campo | Tipo | O que é |
|---|---|---|
| tipo | texto um de: ANALISE, PAGAMENTO | ANALISE: o julgamento da conta — o que a operadora reconheceu e o que glosou. PAGAMENTO: o caixa — o que ela creditou. Duas respostas distintas, quase sempre em meses distintos. |
| motivo | texto um de: GUIA_DESCONHECIDA, OPERADORA_DIVERGENTE, SEM_NUMERO_DE_GUIA | OPERADORA_DIVERGENTE pede corrigir cadastro; GUIA_DESCONHECIDA pede procurar a guia. Ações opostas. |
| operadora | objeto | A operadora do documento, identificada pelo registro ANS. |
| registroANS | texto | Registro 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. |
| nome | texto | Razão social da operadora como a ANS a publica. Informativo — a chave é o registro. |
| demonstrativoId | texto | Abre em GET /v1/demonstrativos/{id} — o caminho de volta à prova. |
| 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. |
| competencia | texto | YYYY-MM (UTC) da data de NEGÓCIO: data do protocolo na análise, data do crédito no pagamento. Nunca da emissão. |
| 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. |
| valores | objeto | Ausência é null, nunca "0.00": zero é valor que a operadora declarou. |
| informado | 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. |
Exemplo de retorno
{
"data": [
{
"tipo": "PAGAMENTO",
"motivo": "GUIA_DESCONHECIDA",
"operadora": {
"registroANS": "334561",
"nome": "Unimed Blumenau"
},
"demonstrativoId": "cmf3k2x9a0001dem",
"protocolo": "4530775",
"competencia": "2026-07",
"numeroGuiaPrestador": "000987",
"numeroGuiaOperadora": null,
"beneficiario": null,
"carteira": null,
"valores": {
"informado": null,
"processado": "12.40",
"liberado": "12.40",
"glosa": null
}
}
],
"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/retornos_sem_vinculo_listarA 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
Esta rota não tem erro próprio: só os comuns a qualquer chamada com chave — chave ausente ou inválida, escopo insuficiente, parâmetro recusado e erro interno.
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.