Referências
/v1/operadoras/{registroANS}/codigosDe-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
| data | lista de CodigoDaOperadora | O recurso. Os campos estão na tabela abaixo. |
| paginacao | Paginacao | Onde 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
| Campo | Tipo | O que é |
|---|---|---|
| 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. |
| codigoTuss | texto | Código do procedimento na TUSS, a terminologia da ANS. |
| descricao | texto | A descrição que acompanha o código nos retornos da operadora. |
| origem | texto | DERIVADO = observado nos retornos, não declarado pela operadora. |
| ocorrencias | inteiro | Quantas 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_codigosA 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.