Autorização
/v1/autorizacoes/{id}/guia.pdfA guia de SP/SADT em PDF, para imprimir
O formulário oficial da ANS (GUIA DE SERVIÇO PROFISSIONAL / SERVIÇO AUXILIAR DE DIAGNÓSTICO E TERAPIA - SP/SADT, 68 campos, A4 paisagem) com os campos da autorização preenchidos a partir do que está gravado. Responde os bytes do PDF, FORA do envelope { data }; erro continua no formato padrão.
Os campos 29 a 57 e 59 a 65 saem EM BRANCO de propósito: são da execução e do faturamento, e no instante em que a operadora autoriza eles não existem. O papel é para o atendimento preencher.
NÃO é o PDF da operadora: é desenhado aqui, dos seus dados, e por isso funciona em toda operadora — inclusive nas que só atendem por webservice e nas que não imprimem guia nenhuma. Não fala com a operadora, não consome cota e não cria execução.
- Escopo:
- autorizacao:ler
- Resposta:
- 200
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 GET https://api.miydas.com.br/v1/autorizacoes/cmf3k2x9a0001aut/guia.pdf \
-H "Authorization: Bearer $MIYDAS_CHAVE"Resposta 200
Esta rota devolve o arquivo em bytes, com o Content-Type que a operadora produziu — não JSON. Só o erro vem no formato padrão.
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. |
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.