Autorização
/v1/autorizacoesSolicita autorização de procedimentos (guia SP/SADT)
numeroGuiaPrestador é o seu número para a guia e não pode repetir na operadora. Enquanto a operadora não decide, o Miydas consulta a situação sozinho e avisa por autorizacao.atualizada. Refazendo o que foi negado, mande refazItem com o id do procedimento anterior: é o que liga a segunda tentativa à primeira.
- Escopo:
- autorizacao:executar
- Resposta:
- 200 ou 202
- Idempotência:
- aceita
Idempotency-Key - Espera:
- aceita
Prefer: wait=N
Pedido
Corpo (JSON)
| Campo | Tipo | O que é |
|---|---|---|
| registroANS* | texto formato 6 dígitos | 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. |
| 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. |
| carteira* | texto 1–30 caracteres | Número da carteirinha do beneficiário na operadora, como está no cartão. Sem máscara nem separador. |
| recemNascido | booleano | O atendimento é de recém-nascido na carteirinha da mãe. A operadora cobra o campo porque o bebê ainda não tem carteira própria. |
| etapa | texto um de: PREVIA, EXECUCAO · padrão "PREVIA" | PREVIA: pedir antes de executar, que é o caso normal. EXECUCAO: o procedimento já foi feito e você está regularizando. |
| carater | texto um de: ELETIVO, URGENCIA · padrão "ELETIVO" | URGENCIA muda o prazo regulatório de resposta da operadora. Não use para apressar pedido eletivo: a operadora audita. |
| indicacaoClinica | texto até 500 caracteres | A justificativa clínica do pedido, em texto livre. É o que a operadora lê para decidir. |
| numeroGuiaPrincipal | texto 1–20 caracteres | O número da guia que este pedido continua, quando continua alguma. |
| coberturaEspecial | texto um de: 01, 02, 03 | dm_cobEsp do TISS: 01 gestante, 02 pré-operatório, 03 pós-operatório. Omita quando não se aplica. |
| observacao | texto até 500 caracteres | Recado para o auditor da operadora. Sai na tag observacao da guia — é diferente da indicação clínica, que é o motivo do exame. |
| atendimento | objeto | Como foi o atendimento. Não sai na guia de solicitação (o XSD não tem estes campos) — é o que os portais cobram. |
| tipoAtendimento | texto formato ^(0[1-4]|08|09|10|13|23)$ | dm_tipoAtendimento do TISS. Laboratório costuma ser 23 (atendimento a exames). |
| regimeAtendimento | texto formato ^0[1-5]$ | dm_regimeAtendimento. Coleta em balcão é 01 (ambulatorial). |
| indicacaoAcidente | texto um de: 0, 1, 2, 9 | dm_indicadorAcidente: 0 trabalho, 1 trânsito, 2 outros, 9 não é acidente. |
| saudeOcupacional | texto formato ^0[1-6]$ | dm_saudeOcupacional, quando o exame é de medicina do trabalho (admissional, periódico…). |
| tipoConsulta | texto um de: 1, 2, 3, 4 | dm_tipoConsulta. Raro em laboratório; alguns portais cobram. |
| portal | objeto | Campos que só existem nos portais. Guardados no pedido e digitados pelo RPA; no webservice não saem. |
| cid | texto até 10 caracteres | CID-10 da hipótese diagnóstica, como o portal pede. Não vai ao webservice: não há campo no XSD. |
| tempoDoenca | texto até 20 caracteres | Há quanto tempo o quadro dura, no formato que o portal aceita (ex.: "30 dias"). Só Unimed Blumenau pede. |
| grauParticipacao | texto até 2 caracteres | Grau de participação do executante, quando o portal cobra (Orizon Autorize). |
| dataAcidente | texto formato AAAA-MM-DD | Data do acidente, AAAA-MM-DD. Obrigatória quando atendimento.indicacaoAcidente não é 9; o portal exige data anterior ou igual à da solicitação. |
| identificacaoBeneficiario | objeto | Como a carteirinha foi lida na recepção (QR do app, tarja magnética, ou já pronto). Bradesco e Smile negam sem isto. |
| codigoValidacao | texto 1–10 caracteres | O token que o app do beneficiário mostra, ditado no balcão e digitado pelo atendente. É o codValidacao do TISS, e NÃO a mesma coisa que identificacaoBeneficiario: aquele é o conteúdo lido do QR ou da tarja, este é o código curto. A operadora aceita qualquer um dos dois como prova de presença. |
| ausenciaCodigoValidacao | texto formato ^0[1-7]$ | Por que não houve token, quando não houve. Declarar é melhor que omitir: omitir faz a operadora supor. Ignorado quando codigoValidacao vem preenchido. |
| dataSolicitacao | texto formato AAAA-MM-DD | Data em que a autorização foi solicitada, AAAA-MM-DD. |
| profissionalSolicitante* | objeto | Quem pediu o procedimento. Validado aqui, antes de criar a guia: conselho ou UF inválidos recusados depois queimariam o número da guia, que o TISS não deixa repetir. |
| nome | texto até 70 caracteres | Nome do profissional que pediu o procedimento. |
| conselho* | texto 2–10 caracteres | Sigla do conselho profissional (CRM, CRO, COREN…). |
| numero* | texto 1–15 caracteres | Número de inscrição do solicitante no conselho profissional. |
| uf* | texto 2–2 caracteres | Sigla da unidade federativa, duas letras (ex. SC). |
| cbo | texto formato 6 dígitos | Ocupação do profissional na CBO, seis dígitos. |
| codigoContratadoNaOperadora | texto até 14 caracteres | Código do prestador solicitante na operadora, quando quem pediu não é você. |
| nomeContratado | texto até 70 caracteres | Nome do prestador solicitante. Omitido, vale o da sua conexão. |
| procedimentos* | lista de objetos 1–60 itens | Os procedimentos que você está pedindo autorização para executar. |
| tabela | texto até 2 caracteres · padrão "22" | Qual tabela o código usa (22 = TUSS procedimentos, 00 = tabela própria da operadora). Padrão 22. |
| codigo* | texto 1–10 caracteres | Código do procedimento na tabela declarada. |
| descricao* | texto 1–150 caracteres | Descrição do procedimento, como ela vai no documento. |
| quantidade | inteiro padrão 1 | Quantas unidades do procedimento está pedindo. Inteiro, a partir de 1. |
| refazItem | texto 1–64 caracteres | id do procedimento da autorização anterior que este refaz. Omita na primeira tentativa. |
* 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 POST https://api.miydas.com.br/v1/autorizacoes \
-H "Authorization: Bearer $MIYDAS_CHAVE" \
-H "Prefer: wait=20" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"registroANS": "334561",
"numeroGuiaPrestador": "000123",
"carteira": "00000000000000000",
"profissionalSolicitante": {
"nome": "Médica Exemplo",
"conselho": "CRM",
"numero": "12345",
"uf": "SC",
"cbo": "225124"
},
"procedimentos": [
{
"tabela": "22",
"codigo": "40304361",
"descricao": "Hemograma com contagem de plaquetas",
"quantidade": 1
}
]
}'Resposta 200 / 202
| data | Autorizacao | O recurso. Os campos estão na tabela abaixo. |
Campos de Autorizacao
| 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. |
| 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. |
| 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. |
| processamento | Processamento | O andamento do pedido COM A OPERADORA. Enquanto ele não concluir, a situação abaixo é nula — o recurso existe, a resposta ainda não. |
| situacao | objeto | Nula até a operadora responder. codigoOperadora é o que ela mandou. |
| codigo | texto um de: A_ENVIAR, ENVIANDO, EM_ANALISE, AUTORIZADA, PARCIALMENTE_AUTORIZADA, NEGADA, AGUARDANDO_JUSTIFICATIVA, AGUARDANDO_DOCUMENTACAO, CANCELADA, NAO_EXIGE_AUTORIZACAO, INDETERMINADA | O veredito traduzido. NAO_EXIGE_AUTORIZACAO não é negativa: é a operadora dizendo que o procedimento passa direto. |
| descricao | texto | O mesmo estado de situacao.codigo, em português, para mostrar a gente. O contrato é o código; esta frase pode mudar. |
| 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. |
| senha | texto | A senha de autorização que a operadora concedeu. É ela que autoriza a execução. |
| validadeSenha | texto | Último dia em que a senha de autorização pode ser usada. Passou disso, a guia volta para a fila. |
| dataAutorizacao | texto | Data em que a operadora autorizou, AAAA-MM-DD. |
| dataSolicitacao | texto | O dia em que a autorização foi pedida. É por ele que de e ate recortam a listagem. |
| beneficiario | objeto | 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. |
| nome | texto | Nome do beneficiário como a operadora o devolveu — pode divergir do seu cadastro. |
| solicitante | objeto | Quem pediu o procedimento. |
| nome | texto | Nome do profissional solicitante. |
| conselho | texto | Sigla do conselho profissional (CRM, CRO, COREN…). |
| numero | texto | Número de inscrição do solicitante no conselho. |
| uf | texto | Sigla da unidade federativa, duas letras (ex. SC). |
| cbo | texto | Ocupação do profissional na CBO, seis dígitos. |
| pedido | objeto | O que foi pedido, como está gravado agora — e é isto que PATCH /v1/autorizacoes/{id} corrige enquanto a guia não foi autorizada. Vem junto porque campo corrigível sem o valor atual ao lado se lê como "não preenchido", e quem corrige reescreve por cima do que havia. |
| carater | texto um de: ELETIVO, URGENCIA | Eletivo ou urgência/emergência. |
| indicacaoClinica | texto | A justificativa clínica do pedido, como foi enviada. |
| observacao | texto | Observação livre para o auditor da operadora. |
| numeroGuiaPrincipal | texto | A guia principal, quando esta é continuação de outra. |
| coberturaEspecial | texto | Cobertura especial (dm_tipoCoberturaEspecial): gestante, aidético ou recém-nascido. |
| recemNascido | booleano | Atendimento a recém-nascido na mesma guia da mãe. |
| atendimento | objeto | Tipo e regime de atendimento e indicação de acidente, nos domínios TISS. null quando a operadora não os pede. |
| tipoAtendimento | texto | Tipo de atendimento (dm_tipoAtendimento). Exame de laboratório costuma ser 23. |
| regimeAtendimento | texto | Regime de atendimento (dm_regimeAtendimento): ambulatorial, hospitalar, domiciliar. |
| indicacaoAcidente | texto | Indicação de acidente (dm_indicacaoAcidente). 9 é "não é acidente". |
| saudeOcupacional | texto | Tipo de saúde ocupacional (dm_tipoSaudeOcupacional), quando o exame é admissional, periódico ou demissional. |
| portal | objeto | Campos que só certos portais pedem — CID-10, tempo de doença, data do acidente. null quando nenhum foi informado. |
| cid | texto | CID-10 da hipótese diagnóstica, quando o portal o exige. |
| tempoDoenca | texto | Há quanto tempo o quadro dura, no formato que o portal pede. |
| dataAcidente | texto | O dia do acidente, quando houve (AAAA-MM-DD). |
| evidencias | objeto | O que existe de PROVA sobre o desfecho — e não as URLs. Os arquivos são privados; os bytes saem por GET /autorizacoes/{id}/evidencia/{tela|guia}, que confere a empresa. URL assinada aqui entraria no histórico de toda consulta de lista. |
| tela | booleano | Há print do portal no momento em que ele respondeu — autorizada, negada ou erro. Capturado no envio; guias enviadas antes de 20/11/2026 não têm. |
| guia | booleano | Há o PDF que a própria operadora imprime, baixado no ato da autorização. Só onde o portal oferece impressão nativa. |
| procedimentos | lista de objetos | Os procedimentos do documento. |
| id | texto | Identifica este procedimento. É o que se manda em refazItem ao pedir de novo o que foi negado. |
| 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 | Descrição do procedimento, como ela vai no documento. |
| quantidadeSolicitada | número | Quantas unidades você pediu. |
| quantidadeAutorizada | número | Quantas a operadora liberou. Menor que a solicitada é autorização parcial — execute só o autorizado, ou a diferença vira glosa. |
| quantidadeExecutada | número | Quantas foram REALMENTE executadas, quando já se declarou. null é "ainda não declarado" e 0 é "conferi e não executei" — a diferença importa. Item com quantidadeAutorizada nula e esta preenchida é exame acrescentado na execução. |
| motivos | lista de texto | O que a operadora alegou sobre ESTE procedimento. |
| refazItem | texto | O id do procedimento que este refaz, numa guia anterior. null é a primeira tentativa. É por esta cadeia que se sabe quantas vezes o mesmo exame foi pedido. |
| motivos | lista de texto | O que a operadora alegou sobre a guia inteira. |
| requisicao | objeto | A requisição que originou a guia. null quando ela nasceu direto. parte/partes respondem "por que três guias?" — a operadora limita exames por guia, e a requisição foi dividida. |
| id | texto | A requisição, para abrir o papel que originou esta guia. |
| numero | texto | O número legível da requisição, do prestador para o prestador (REQ-2026-0412). |
| parte | número | Qual das guias desta requisição é esta. null quando a requisição gerou uma só. |
| partes | número | Em quantas guias a requisição foi dividida pelo limite de exames da operadora. |
| proximaAcao | objeto | O que fazer agora com esta guia. Decidido pelo servidor: só ele sabe quantos dias de silêncio deixam de ser normais, o que cada código de negativa significa e se a senha está vencendo. Mostre; não recalcule. |
| codigo | texto | ENVIAR, CONSULTAR, IMPRIMIR_GUIA, REFAZER_COM_CAPTURA… — para a interface decidir o botão. |
| texto | texto | A frase pronta, escrita para quem está no balcão. |
| precisaDeMim | booleano | Esta guia espera alguém AGORA. Guia em análise dentro do prazo responde false — enchê-la na fila é como se esconde a que precisa. |
| execucao | objeto | A execução do exame, nas operadoras que exigem registrá-la depois do atendimento. null não afirma que o exame não foi feito: afirma que não foi executado pelo Miydas — pode ter sido registrado à mão no portal da operadora. |
| executada | booleano | A operadora registrou o atendimento. |
| parcial | booleano | Parte do pedido entrou na guia; o resto continua pendente. |
| guiaGerada | texto | A guia de serviço que a operadora emitiu ao executar — número NOVO, diferente de numeroGuiaOperadora, e é ele que o faturamento cobra. |
| situacaoOperadora | texto | O rótulo que a operadora deu à execução (ex.: "Executada"). |
| mensagem | texto | O que a operadora respondeu à execução, na frase dela — inclusive a recusa, quando houve. |
| em | texto | Quando a execução foi registrada. |
| historico | lista de objetos | O que já se fez com esta guia, em ordem — a solicitação e cada consulta ou cancelamento depois dela. |
| ocorridoEm | texto | Quando o fato aconteceu, em ISO 8601 com fuso. |
| tipo | texto um de: SOLICITACAO, CONSULTA, CANCELAMENTO | Que ação foi esta. |
| origem | texto um de: SOLICITACAO, CONSULTA | SOLICITACAO: a guia nasceu aqui. CONSULTA: foi pedida fora do Miydas e importada depois. |
| etapa | texto um de: PREVIA, EXECUCAO | Como a guia foi pedida: PREVIA antes de executar (o caso normal) ou EXECUCAO com o exame já feito. Decide se a operadora cobra a confirmação de presença do beneficiário — por isso quem vai transmitir uma guia A_ENVIAR precisa saber antes de enviar. |
| teste | booleano | true: criado por chave de teste (myd_test_…), executado na homologação da operadora e visível só para chaves de teste. |
| proximaConsultaEm | texto | Quando o acompanhamento automático volta a perguntar à operadora. null quando a guia não está em acompanhamento — porque já tem desfecho, ou porque ainda não saiu daqui. Serve para não consultar à mão o que o robô já ia consultar. |
| consultasAutomaticas | número | Quantas vezes o Miydas já reconsultou esta guia por conta própria. |
| criadaEm | texto | Quando o registro nasceu no Miydas, em ISO 8601 com fuso. |
| atualizadaEm | texto | Quando o registro mudou pela última vez no Miydas, em ISO 8601 com fuso. |
Exemplo de retorno
{
"data": {
"id": "cmf3k2x9a0001aut",
"operadora": {
"registroANS": "334561",
"nome": "Unimed Blumenau"
},
"numeroGuiaPrestador": "000123",
"numeroGuiaOperadora": "18700001",
"processamento": {
"status": "CONCLUIDO",
"iniciadoEm": "2026-09-27T13:02:10.000Z",
"concluidoEm": "2026-09-27T13:02:14.000Z"
},
"situacao": {
"codigo": "AUTORIZADA",
"descricao": "Autorizada",
"codigoOperadora": "1"
},
"senha": "18700001",
"validadeSenha": "2026-10-27",
"dataAutorizacao": "2026-09-27",
"dataSolicitacao": "2026-09-27",
"beneficiario": {
"carteira": "00000000000000000",
"nome": "PACIENTE EXEMPLO"
},
"solicitante": {
"nome": "Médica Exemplo",
"conselho": "CRM",
"numero": "12345",
"uf": "SC",
"cbo": "225124"
},
"evidencias": {
"tela": true,
"guia": true
},
"pedido": {
"carater": "ELETIVO",
"indicacaoClinica": "Investigação de anemia",
"observacao": null,
"numeroGuiaPrincipal": null,
"coberturaEspecial": null,
"recemNascido": false,
"atendimento": {
"tipoAtendimento": "23",
"regimeAtendimento": "01",
"indicacaoAcidente": "9",
"saudeOcupacional": ""
},
"portal": {
"cid": "D509",
"tempoDoenca": "",
"dataAcidente": ""
}
},
"procedimentos": [
{
"id": "cm3p0r0c1",
"tabela": "22",
"codigo": "40304361",
"descricao": "Hemograma com contagem de plaquetas",
"quantidadeSolicitada": 1,
"quantidadeAutorizada": 1,
"quantidadeExecutada": 1,
"motivos": [],
"refazItem": null
}
],
"motivos": [],
"requisicao": null,
"proximaAcao": {
"codigo": "IMPRIMIR_GUIA",
"texto": "Nada — imprimir e atender",
"precisaDeMim": false
},
"execucao": null,
"historico": [
{
"ocorridoEm": "2026-09-27T13:02:14.000Z",
"tipo": "SOLICITACAO"
}
],
"origem": "SOLICITACAO",
"etapa": "PREVIA",
"teste": false,
"proximaConsultaEm": null,
"consultasAutomaticas": 0,
"criadaEm": "2026-09-27T13:02:10.000Z",
"atualizadaEm": "2026-09-27T13:02:14.000Z"
}
}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/autorizacoes_criarO sandbox responde sempre em GET, mesmo para uma operação POST: ele devolve a forma da resposta, não executa nada.
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
| Código | HTTP | Quando | O que fazer |
|---|---|---|---|
| OPERADORA_NAO_ENCONTRADA | 404 | A empresa não tem essa operadora (registro ANS) cadastrada. | Veja as operadoras em GET /v1/operadoras. |
| OPERACAO_NAO_COBERTA | 422 | A operadora não oferece esta operação. details.operacoesDisponiveis lista o que ela oferece. | Não repita: a resposta não muda. |
| CREDENCIAL_AUSENTE | 422 | A empresa não cadastrou a credencial desta operadora. | Cadastre a credencial no Miydas e repita. |
| AMBIENTE_TESTE_INDISPONIVEL | 422 | A chave é de teste (myd_test_…) e o pedido não cabe na homologação: a empresa não tem homologação configurada para esta operadora; ou a operação grava dado de produção (lote, retorno, recurso de glosa, cancelamento por número, anexos, documentos, cadastro de convênio); ou tenta trocar o endereço, o conector ou a agenda da conexão de homologação. A chave de teste nunca opera em produção. | Configure a homologação da operadora no Miydas; para autorização e elegibilidade use /v1/autorizacoes e /v1/elegibilidades; o resto, com a chave de produção. |
| LIMITE_EXCEDIDO | 429 | Muitas operações em andamento para esta operadora nesta empresa. | Espere e repita — com a mesma Idempotency-Key, se for escrita. |
| GUIA_JA_SOLICITADA | 409 | O numeroGuiaPrestador já foi usado nesta operadora, no mesmo ambiente (teste ou produção) — o padrão TISS proíbe repetir. details.autorizacaoId aponta a autorização existente, quando ela é conhecida. | Use outro número; para saber do anterior, consulte a autorização apontada. |
| LIMITE_DE_PROCEDIMENTOS | 422 | A operadora aceita menos procedimentos por pedido do que os enviados (o padrão TISS não limita; algumas operadoras sim). details.maximo diz quantos. | Divida em mais de um pedido. |
| CBO_OBRIGATORIO | 422 | O canal que atende esta operadora exige o CBO-S do profissional solicitante e o pedido veio sem profissionalSolicitante.cbo. Nem toda operadora exige: GET /v1/capacidades diz quais, em pedidoExige. | Mande o CBO-S de seis dígitos do solicitante. Ele também é necessário no faturamento, então vale guardá-lo no cadastro do médico. |
| REFAZ_ITEM_INVALIDO | 422 | Algum procedimentos[].refazItem não aponta para um procedimento desta empresa, ou aponta para o outro ambiente — a chave de teste não enxerga o que é de produção, e o contrário. | Use o id que veio em procedimentos[].id da autorização anterior. Na primeira tentativa, omita o campo. |
| IDEMPOTENCIA_CONFLITO | 422 | A mesma Idempotency-Key veio com um pedido diferente. | Use uma chave nova para um pedido novo. |
| IDEMPOTENCIA_EM_ANDAMENTO | 409 | Um pedido com esta Idempotency-Key ainda está sendo criado. | Repita em instantes com a mesma chave: vem a mesma resposta. |
Depois de aceita, ainda pode falhar — e aí o erro aparece em processamento.erro, não na resposta do pedido:
OPERADORA_INDISPONIVEL— A operadora não respondeu, ou respondeu fora do padrão. SepodeRepetirfor true, repita depois. Se for false (escrita), consulte antes de repetir — o pedido pode ter chegado.CREDENCIAL_RECUSADA— A operadora recusou a credencial cadastrada. Atualize a credencial no Miydas.CONEXAO_INCOMPLETA— Falta um dado obrigatório na conexão da empresa com a operadora (ex.: nome do contratado). Nada foi enviado à operadora. Complete a conexão no Miydas e repita — a mensagem diz o que falta.PEDIDO_RECUSADO— A operadora recusou o pedido antes de analisar (ex.: código de procedimento que ela não aceita). A mensagem traz o motivo dela. Corrija o pedido conforme o motivo e peça de novo — nada foi autorizado.PEDIDO_INCOMPLETO— Falta um dado que esta operadora exige (ex.: indicação clínica na Bradesco). Nada foi enviado. Complete o pedido e repita.OPERADORA_OCUPADA— O acesso da empresa à operadora estava em uso por outra pessoa no momento. Nada foi enviado. Repita em alguns minutos.DADOS_RECUSADOS— A operadora — ou a validação do Miydas antes do envio — recusou os dados do pedido.messagediz qual dado quando isso se sabe: o conselho do profissional, o registro ANS na credencial da operadora, procedimentos acima do limite, o cadastro do prestador na operadora (a conexão sem o nome do contratado sai como CONEXAO_INCOMPLETA). Recusado antes do envio, nada chegou à operadora epodeRepetiré true; recusado pela operadora numa escrita,podeRepetiré false, como em toda escrita que chegou lá. Corrija o dado apontado — no pedido ou na credencial da operadora no Miydas — e faça um pedido novo: repetir igual dá a mesma recusa. Solicitação de autorização que não chegou à operadora (a mensagem diz) pode ser refeita com o mesmonumeroGuiaPrestador.
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.