Ogmma Revenue

Autorização

PATCH/v1/autorizacoes/{id}

Corrige a guia que ainda não foi autorizada

Ajusta o que será pedido: solicitante, beneficiário, procedimentos, caráter, indicação clínica e os campos de atendimento. Existe porque o motivo de uma falha manda "corrija e peça de novo" — e até 20/11/2026 não havia por onde. **Não mexe no número da guia**: o TISS não deixa repetir numeroGuiaPrestador, e corrigir o conteúdo para reenviar com o mesmo número é o caminho quando a tentativa anterior não chegou a existir na operadora. Campo omitido não muda; null limpa. A lista de procedimentos, quando vem, SUBSTITUI a anterior. Guia com desfecho (autorizada, em parte ou cancelada) é recusada: ali o documento é da operadora. Guia que já saiu continua corrigível, e a resposta traz soAqui: true para a tela avisar que a mudança vale só do nosso lado.

Escopo:
autorizacao:executar
Resposta:
200
Idempotência:
aceita Idempotency-Key

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 PATCH https://api.miydas.com.br/v1/autorizacoes/cmf3k2x9a0001aut \
  -H "Authorization: Bearer $MIYDAS_CHAVE" \
  -H "Idempotency-Key: $(uuidgen)"

Resposta 200

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": 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_corrigir

O sandbox responde sempre em GET, mesmo para uma operação PATCH: 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
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.
GUIA_COM_DESFECHO409A guia já tem desfecho da operadora — autorizada, autorizada em parte ou cancelada — e por isso não se corrige mais: o documento passou a ser dela, e mudar só o nosso lado faria os dois discordarem sobre a mesma guia.Cancele na operadora e peça uma guia nova com o que precisa mudar. Guia ainda não autorizada continua corrigível por PATCH /autorizacoes/{id}.
SOLICITANTE_INVALIDO422A correção deixaria o profissional solicitante num estado que a operadora recusa: conselho fora de dm_conselhoProfissional, UF inexistente, CBO fora de seis dígitos ou número em branco. details.erros traz cada problema em uma frase.Corrija o que a mensagem aponta. Recusar aqui é de propósito: passando, o erro só apareceria no envio, como TISS_CONSELHO_INVALIDO, depois de a guia ir à fila e voltar.
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.

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.