Ogmma Revenue

Referências

GET/v1/operadoras/{registroANS}/codigos

De-para do código próprio da operadora para a TUSS

Há operadora que devolve o retorno com o código dela, não com o TUSS. Sem a tradução, o item não casa com nada do seu lado. origem: DERIVADO significa que a tradução foi OBSERVADA nos retornos — o mesmo código apareceu N vezes ao lado do mesmo TUSS —, não declarada pela operadora. ocorrencias é esse N: com 1 é palpite, com 40 é fato, e o número sai para você decidir em qual confiar.

Escopo:
operadora:ler
Resposta:
200

Pedido

Caminho

{registroANS}*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.

Exemplo de chamada

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

Resposta 200

datalista de CodigoDaOperadoraO recurso. Os campos estão na tabela abaixo.
paginacaoPaginacaoOnde esta página está no total. Vem fora de data.

De-para do código próprio da operadora para a TUSS. Quando o retorno vem com o código dela, não há o que fazer sem esta tradução.

Campos de CodigoDaOperadora

CampoTipoO que é
codigoOperadoratextoO código do prestador NA operadora. Cada operadora tem o seu, e é ele que a operadora exige no documento — não o CNPJ.
codigoTusstextoCódigo do procedimento na TUSS, a terminologia da ANS.
descricaotextoA descrição que acompanha o código nos retornos da operadora.
origemtextoDERIVADO = observado nos retornos, não declarado pela operadora.
ocorrenciasinteiroQuantas vezes o par apareceu. Com 1, é palpite; com 40, é fato. O número sai para você decidir.

Exemplo de retorno

{
  "data": [
    {
      "codigoOperadora": "LAB0391",
      "codigoTuss": "40301591",
      "descricao": "COLESTEROL LDL",
      "origem": "DERIVADO",
      "ocorrencias": 42
    }
  ],
  "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/operadoras_codigos

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.