Ogmma Revenue

Demonstrativos

GET/v1/retornos-sem-vinculo

O 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

CampoTipoO que é
tipotexto
um de: ANALISE, PAGAMENTO
De que tipo de documento veio o retorno órfão: ANALISE ou PAGAMENTO.
registroANStexto
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.
competenciatexto
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.
motivotexto
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.
valorMinimonúmeroTraz só registros com valor igual ou acima deste, em reais.
limiteinteiro
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.
deslocamentointeiro
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

datalista de RetornoSemVinculoO recurso. Os campos estão na tabela abaixo.
paginacaoPaginacaoOnde 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

CampoTipoO que é
tipotexto
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.
motivotexto
um de: GUIA_DESCONHECIDA, OPERADORA_DIVERGENTE, SEM_NUMERO_DE_GUIA
OPERADORA_DIVERGENTE pede corrigir cadastro; GUIA_DESCONHECIDA pede procurar a guia. Ações opostas.
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.
demonstrativoIdtextoAbre em GET /v1/demonstrativos/{id} — o caminho de volta à prova.
protocolotextoO protocolo que a operadora devolveu ao receber. É o número que prova a entrega e por onde se consulta o andamento depois.
competenciatextoYYYY-MM (UTC) da data de NEGÓCIO: data do protocolo na análise, data do crédito no pagamento. Nunca da emissão.
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.
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.
carteiratextoNúmero da carteirinha do beneficiário na operadora, como está no cartão. Sem máscara nem separador.
valoresobjetoAusência é null, nunca "0.00": zero é valor que a operadora declarou.
informadotextoDecimal em string. null = a fonte não informou; "0.00" = informou zero. Os dois são diferentes.
processadotextoDecimal em string. null = a fonte não informou; "0.00" = informou zero. Os dois são diferentes.
liberadotextoDecimal em string. null = a fonte não informou; "0.00" = informou zero. Os dois são diferentes.
glosatextoDecimal 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_listar

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

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.