Ogmma Revenue

Autorização

POST/v1/autorizacoes/{id}/execucao

Registra na operadora que o exame foi feito

O passo depois do sim, onde a operadora o exige: ela registra o atendimento e emite a guia de serviço, que volta em execucao.guiaGerada — é esse número que o faturamento cobra. Só vale para guia AUTORIZADA ou PARCIALMENTE_AUTORIZADA. **Sem corpo**, executa o que a operadora liberou (a quantidade AUTORIZADA, nunca a pedida — pedir 2, ela liberar 1 e executar 2 faz o portal recusar). **Com corpo**, vale o que você declarar em procedimentos: quantidade diferente, 0 para "não executei", ou um exame que não estava autorizado (item sem id). Exame autorizado não pode ser OMITIDO da lista — mande-o com quantidade: 0, porque é o lastro do que a operadora liberou que defende o faturamento da glosa. Operadora que não tem esta transação responde OPERACAO_NAO_COBERTA.

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/execucao \
  -H "Authorization: Bearer $MIYDAS_CHAVE" \
  -H "Prefer: wait=20" \
  -H "Idempotency-Key: $(uuidgen)"

Resposta 200 / 202

dataAutorizacaoO recurso. Os campos estão na tabela abaixo.

Campos de Autorizacao

CampoTipoO que é
idtextoIdentificador 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.
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.
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.
processamentoProcessamentoO andamento do pedido COM A OPERADORA. Enquanto ele não concluir, a situação abaixo é nula — o recurso existe, a resposta ainda não.
situacaoobjetoNula até a operadora responder. codigoOperadora é o que ela mandou.
codigotexto
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.
descricaotextoO mesmo estado de situacao.codigo, em português, para mostrar a gente. O contrato é o código; esta frase pode mudar.
codigoOperadoratextoO código do prestador NA operadora. Cada operadora tem o seu, e é ele que a operadora exige no documento — não o CNPJ.
senhatextoA senha de autorização que a operadora concedeu. É ela que autoriza a execução.
validadeSenhatextoÚltimo dia em que a senha de autorização pode ser usada. Passou disso, a guia volta para a fila.
dataAutorizacaotextoData em que a operadora autorizou, AAAA-MM-DD.
dataSolicitacaotextoO dia em que a autorização foi pedida. É por ele que de e ate recortam a listagem.
beneficiarioobjetoO 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.
nometextoNome do beneficiário como a operadora o devolveu — pode divergir do seu cadastro.
solicitanteobjetoQuem pediu o procedimento.
nometextoNome do profissional solicitante.
conselhotextoSigla do conselho profissional (CRM, CRO, COREN…).
numerotextoNúmero de inscrição do solicitante no conselho.
uftextoSigla da unidade federativa, duas letras (ex. SC).
cbotextoOcupação do profissional na CBO, seis dígitos.
pedidoobjetoO 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.
caratertexto
um de: ELETIVO, URGENCIA
Eletivo ou urgência/emergência.
indicacaoClinicatextoA justificativa clínica do pedido, como foi enviada.
observacaotextoObservação livre para o auditor da operadora.
numeroGuiaPrincipaltextoA guia principal, quando esta é continuação de outra.
coberturaEspecialtextoCobertura especial (dm_tipoCoberturaEspecial): gestante, aidético ou recém-nascido.
recemNascidobooleanoAtendimento a recém-nascido na mesma guia da mãe.
atendimentoobjetoTipo e regime de atendimento e indicação de acidente, nos domínios TISS. null quando a operadora não os pede.
tipoAtendimentotextoTipo de atendimento (dm_tipoAtendimento). Exame de laboratório costuma ser 23.
regimeAtendimentotextoRegime de atendimento (dm_regimeAtendimento): ambulatorial, hospitalar, domiciliar.
indicacaoAcidentetextoIndicação de acidente (dm_indicacaoAcidente). 9 é "não é acidente".
saudeOcupacionaltextoTipo de saúde ocupacional (dm_tipoSaudeOcupacional), quando o exame é admissional, periódico ou demissional.
portalobjetoCampos que só certos portais pedem — CID-10, tempo de doença, data do acidente. null quando nenhum foi informado.
cidtextoCID-10 da hipótese diagnóstica, quando o portal o exige.
tempoDoencatextoHá quanto tempo o quadro dura, no formato que o portal pede.
dataAcidentetextoO dia do acidente, quando houve (AAAA-MM-DD).
evidenciasobjetoO 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.
telabooleanoHá 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.
guiabooleanoHá o PDF que a própria operadora imprime, baixado no ato da autorização. Só onde o portal oferece impressão nativa.
procedimentoslista de objetosOs procedimentos do documento.
idtextoIdentifica este procedimento. É o que se manda em refazItem ao pedir de novo o que foi negado.
tabelatextoQual tabela o código usa (22 = TUSS procedimentos, 00 = tabela própria da operadora). Padrão 22.
codigotextoCódigo do procedimento na tabela declarada.
descricaotextoDescrição do procedimento, como ela vai no documento.
quantidadeSolicitadanúmeroQuantas unidades você pediu.
quantidadeAutorizadanúmeroQuantas a operadora liberou. Menor que a solicitada é autorização parcial — execute só o autorizado, ou a diferença vira glosa.
quantidadeExecutadanúmeroQuantas 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.
motivoslista de textoO que a operadora alegou sobre ESTE procedimento.
refazItemtextoO 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.
motivoslista de textoO que a operadora alegou sobre a guia inteira.
requisicaoobjetoA 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.
idtextoA requisição, para abrir o papel que originou esta guia.
numerotextoO número legível da requisição, do prestador para o prestador (REQ-2026-0412).
partenúmeroQual das guias desta requisição é esta. null quando a requisição gerou uma só.
partesnúmeroEm quantas guias a requisição foi dividida pelo limite de exames da operadora.
proximaAcaoobjetoO 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.
codigotextoENVIAR, CONSULTAR, IMPRIMIR_GUIA, REFAZER_COM_CAPTURA… — para a interface decidir o botão.
textotextoA frase pronta, escrita para quem está no balcão.
precisaDeMimbooleanoEsta guia espera alguém AGORA. Guia em análise dentro do prazo responde false — enchê-la na fila é como se esconde a que precisa.
execucaoobjetoA 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.
executadabooleanoA operadora registrou o atendimento.
parcialbooleanoParte do pedido entrou na guia; o resto continua pendente.
guiaGeradatextoA guia de serviço que a operadora emitiu ao executar — número NOVO, diferente de numeroGuiaOperadora, e é ele que o faturamento cobra.
situacaoOperadoratextoO rótulo que a operadora deu à execução (ex.: "Executada").
mensagemtextoO que a operadora respondeu à execução, na frase dela — inclusive a recusa, quando houve.
emtextoQuando a execução foi registrada.
historicolista de objetosO que já se fez com esta guia, em ordem — a solicitação e cada consulta ou cancelamento depois dela.
ocorridoEmtextoQuando o fato aconteceu, em ISO 8601 com fuso.
tipotexto
um de: SOLICITACAO, CONSULTA, CANCELAMENTO
Que ação foi esta.
origemtexto
um de: SOLICITACAO, CONSULTA
SOLICITACAO: a guia nasceu aqui. CONSULTA: foi pedida fora do Miydas e importada depois.
etapatexto
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.
testebooleanotrue: criado por chave de teste (myd_test_…), executado na homologação da operadora e visível só para chaves de teste.
proximaConsultaEmtextoQuando 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.
consultasAutomaticasnúmeroQuantas vezes o Miydas já reconsultou esta guia por conta própria.
criadaEmtextoQuando o registro nasceu no Miydas, em ISO 8601 com fuso.
atualizadaEmtextoQuando 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": {
      "executada": true,
      "parcial": false,
      "guiaGerada": "95200001",
      "situacaoOperadora": "Executada",
      "mensagem": "Guia de serviço 95200001 gerada.",
      "em": "2026-09-28T11:40:02.000Z"
    },
    "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_executar

O 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ódigoHTTPQuandoO que fazer
EXAME_AUTORIZADO_REMOVIDO422A execução declarada deixou de fora um exame que a operadora autorizou. details.itens diz quais.Mande o item com quantidade: 0 em vez de omiti-lo. Zero diz "não executei" sem apagar o lastro do que foi autorizado — e é por esse lastro que o faturamento se defende de glosa depois.
ITEM_DE_OUTRA_GUIA422A execução declarou um id de item que não pertence a esta guia.Use os id que vêm em procedimentos desta guia, ou omita o id para acrescentar um exame novo.
RECURSO_NAO_ENCONTRADO404O 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.
OPERADORA_NAO_ENCONTRADA404A empresa não tem essa operadora (registro ANS) cadastrada.Veja as operadoras em GET /v1/operadoras.
OPERACAO_NAO_COBERTA422A operadora não oferece esta operação. details.operacoesDisponiveis lista o que ela oferece.Não repita: a resposta não muda.
CREDENCIAL_AUSENTE422A empresa não cadastrou a credencial desta operadora.Cadastre a credencial no Miydas e repita.
AMBIENTE_TESTE_INDISPONIVEL422A 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_EXCEDIDO429Muitas operações em andamento para esta operadora nesta empresa.Espere e repita — com a mesma Idempotency-Key, se for escrita.
EXECUCAO_SEM_AUTORIZACAO422A guia ainda não foi liberada pela operadora (EM_ANALISE, NEGADA, CANCELADA ou sem desfecho). Nada foi enviado.Consulte a situação e execute depois que ela estiver AUTORIZADA ou PARCIALMENTE_AUTORIZADA.
EXECUCAO_SEM_GUIA_DA_OPERADORA422A autorização não tem numeroGuiaOperadora, que é o número pelo qual a operadora identifica o que executar.Consulte a autorização primeiro: a operadora devolve o número dela junto do desfecho.
EXECUCAO_SEM_PROCEDIMENTO422A autorização não tem procedimento com código para executar.Não há o que executar por aqui.
IDEMPOTENCIA_CONFLITO422A mesma Idempotency-Key veio com um pedido diferente.Use uma chave nova para um pedido novo.
IDEMPOTENCIA_EM_ANDAMENTO409Um 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. Se podeRepetir for 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. message diz 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 e podeRepetir é 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 mesmo numeroGuiaPrestador.

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.