Autorização
/v1/autorizacoes/{id}/envioTransmite uma guia que já existe e ainda não saiu
Para a guia gerada pelo processamento de uma requisição, que nasce sem ter ido à operadora. POST /v1/autorizacoes cria e envia no mesmo ato — o que ele devolve já foi, e reenviar é recusado. A guia tem número próprio desde que nasceu, e é ela que muda de estado: não sai pedido novo.
- Escopo:
- autorizacao:executar
- Resposta:
- 200 ou 202
- Idempotência:
- aceita
Idempotency-Key - Espera:
- aceita
Prefer: wait=N
Pedido
Caminho
| {id}* | 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. |
Exemplo de chamada
curl -X POST https://api.miydas.com.br/v1/autorizacoes/cmf3k2x9a0001aut/envio \
-H "Authorization: Bearer $MIYDAS_CHAVE" \
-H "Prefer: wait=20" \
-H "Idempotency-Key: $(uuidgen)"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_enviarO 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 |
|---|---|---|---|
| RECURSO_NAO_ENCONTRADO | 404 | O id não existe — ou é de outra empresa, o que a API não distingue de propósito. Também a rota inexistente na v1. | Confira o id. |
| GUIA_JA_ENVIADA | 409 | A guia já saiu para a operadora. O TISS proíbe repetir o numeroGuiaPrestador, inclusive depois de negativa — reenviar a mesma guia é recusado pela própria operadora (glosa 1601). | Para pedir de novo, refaça: uma guia nova, com número novo, já preenchida com o que havia. A antiga fica no histórico com o motivo. |
| ENVIO_EM_ANDAMENTO | 409 | Já existe um envio desta guia em voo. A trava é a troca de situação, feita em condição: dois envios simultâneos mandariam dois pedidos reais da mesma guia à operadora. | Espere o desfecho do envio corrente — ele responde pelo mesmo recurso. Guia presa porque o worker caiu é destravada sozinha no envio seguinte. |
| 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. |
| 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.