Amil — notas e observações
Conector: nenhum ainda
Registro ANS: 326305 · CNPJ 29.309.127/0001-79
Portal: credenciado.amil.com.br
Primeira medição: 2026-10-20
Prazos contratuais
| Prazo | Quanto | Conta a partir de | Fonte |
|---|---|---|---|
| Envio do lote | não medido | — | — |
| Pagamento | não medido | — | — |
| Recurso de glosa | não medido | — | — |
O valor operável fica emHealthPlan(submissionDeadlineDays,
paymentDeadlineDays,appealDeadlineDays), que é de onde o Monitoramento
calcula vencimento. Enquanto estiver "não medido" aqui, o cadastro está no
default de 30 dias — convenção, não declaração.
Estado: nada implementado, e agora com o caminho aberto
No mapeamento de operadoras (09-mapeamento-operadoras.seed.ts) a Amil está
como prioridade macro e NAO_INICIADO em portal, webservice e documentos,
com o bloqueio registrado como *"Nada levantado"*. Isso deixou de ser verdade:
o portal foi localizado e a tela de entrada, medida.
Não há conexão cadastrada para Amil em nenhum prestador — nenhuma credencial.
O portal
https://credenciado.amil.com.br → redireciona para /login
Título: "Portal do credenciado médico".
A tela de login (medida em 20/10/2026)
| Item | Valor |
|---|---|
| Stack | Angular (não é JSF) |
| Usuário | #login-usuario (name=username) — aceita usuário, CPF ou e-mail |
| Senha | #login-senha (name=password) |
| Entrar | <button type=submit> sem id — ancorar no texto |
| Captcha | não há |
| Cookies | banner OneTrust (#onetrust-accept-btn-handler) — intercepta clique |
Primeiro acesso usa o código do Credenciado; depois o próprio CPF ou e-mail.
Isto é a melhor notícia do conjunto. Comparado aos vizinhos: o Savi
(Hapvida/Clinipam) tem captcha de imagem na porta, e o SC Saúde é JSF lento
com 504 frequente. Angular sem captcha é o cenário mais tratável por RPA — e
SPA Angular quase sempre quer dizer API REST por baixo, como já se provou
no Clinipam, onde o trabalho todo virou chamada à API em vez de raspagem.
Cuidado já previsível
O banner de cookies OneTrust cobre a tela e intercepta cliques. É exatamente a
classe de problema que custou três rodadas de investigação no SC Saúde, onde um
modal ficava com o foco do teclado e o sintoma aparecia como "o autocomplete não
sugeriu nada". Fechar o banner antes de qualquer digitação.
O que o portal oferece (lido dos manuais oficiais)
O menu lateral do Portal do Credenciado, visível nos screenshots do manual de
faturamento, tem:
Permissão de acesso
Consulta de elegibilidade ← elegibilidade
Autorização prévia ← autorização
Faturamento
Material de apoio
Normas ANS
Informe de rendimentos
Meus dados
Conciliação
A Amil oferece elegibilidade e autorização prévia pelo portal. Isso vem do
material oficial dela, não de suposição — mas *oferecer* não é *mapeado*:
nenhuma das duas telas foi aberta, porque não temos credencial.
O faturamento começa na autorização
O manual abre com a frase que define a integração:
"Agora, o seu faturamento já começa na autorização do pedido. Todos os
atendimentos que você confirmar (seja com Token ou justificativa)
terão seus dados inseridos automaticamente na nova ferramenta Faturamento."
Ou seja: a guia autorizada nasce digitada no faturamento. É o mesmo desenho
do SC Saúde, onde a guia autorizada vira produção pela captura — e o mesmo par
*token/justificativa* que lá aparece como biometria com justificativa
alternativa.
Consequência prática: no fluxo da Amil, REQUEST_AUTH não é só autorização —
é também o que alimenta o faturamento. Automatizar a autorização é o que
destrava o resto.
Vocabulário de situação da guia (tela de Faturamento)
Em digitação · Digitação concluída · Enviada · Cancelada
Busca por: carteirinha, senha ou protocolo. Tipos de guia: SP/SADT, honorário
individual, resumo de internação. Período máximo de 30 dias por consulta —
limite do portal, importante para quem for varrer histórico.
Dados do pedido, na inclusão de guia
Campos vistos no manual: Senha, Validade da senha, Data de solicitação,
Data de autorização, e um "exibir campos adicionais → autorização prévia"
para confirmar a senha quando o sistema não acusa sozinho.
Exemplo real de senha no manual: C02019008809262 — alfanumérica, começa
com letra. Não presuma senha numérica como no SC Saúde.
Manuais oficiais — e como achar outros
Guardados em [docs/manual-amil/](../../manual-amil/):
| Arquivo | Origem |
|---|---|
manual-faturamento-eletronico-amil-v3.pdf | 34 páginas, nov/2019 |
manual-elegibilidade-amil.pdf | 8 páginas, 2021 |
Os dois vêm do mesmo lugar, e o padrão da URL é útil:
https://credenciado.amil.com.br/gerdoc/<timestamp-ms><nome>.pdf
- •
1573156786263manual_faturamento_eletronico_amil_v3.pdf - •
1617968970849elegibilidade.pdf
O gerdoc/ serve os documentos de "Material de apoio" sem autenticação —
baixar exige apenas um User-Agent de navegador (com o padrão do curl o
domínio devolve 403). O timestamp não é adivinhável; a lista dos documentos está
na área logada, em *Material de apoio* → Token, Formulários, Guias, Manuais.
Vale pegar o manual de Token dali: o token é o que confirma o atendimento
e, pelo texto do manual de faturamento, é o que dispara o preenchimento
automático da guia. É o equivalente da biometria do SC Saúde.
O que precisa ser checado
- ☐Credencial. É o bloqueio real — não há conta de Amil em nenhum
prestador nosso. Sem isso nada avança.
- ☐A tela "Autorização prévia": campos, se é SPA sobre REST, e se devolve
senha + validade como a do SC Saúde.
- ☐A tela "Consulta de elegibilidade": o manual mostra busca por carteirinha
ou CPF, e expansão para dependentes do titular.
- ☐Se há API REST por trás do Angular (como no Clinipam). Se houver,
muda a arquitetura do conector inteiro: leitura por REST, escrita pela UI.
- ☐Webservice TISS próprio: não procurado. O manual cita "Envio webservice"
como opção de envio de faturamento — então existe algum.
- ☐Se a Amil é atendida pela Orizon, como Bradesco/Mediservice. Não checado.
Hipóteses ainda não medidas
- •*"Angular quer dizer API REST por baixo"* — é o padrão do Clinipam e do
Conta Azul, mas não foi verificado aqui. Só a aba de rede com sessão
aberta responde.
- •*"O período de 30 dias é limite rígido"* — o manual diz "fique atento ao
período máximo de 30 dias"; não se sabe se o backend recusa ou só a tela.
Primeiro acesso real — 21/10/2026 (Laboratório Santa Isabel)
A nota dizia "nenhuma credencial". Deixou de ser verdade: o acesso do **Santa
Isabel** entra, e tudo abaixo foi medido no portal logado, não lido de manual.
O login funciona, e é REST
POST /credenciadomedico/acesso/login → 200
Usuário 10465987w26. O banner OneTrust precisa ser fechado antes
(#onetrust-accept-btn-handler), como a nota já previa — e isso se confirmou.
Quem o portal diz que somos
O portal carrega a identidade nos query params de várias chamadas, o que
entrega o cadastro inteiro sem precisar abrir tela nenhuma:
| Campo | Valor |
|---|---|
idCredenciado | 10465987 |
idUsuario | 314603 |
cnpj / cnpjCredenciado | 82629361000166 (o mesmo do SC Saúde) |
nomeCredenciado | LABORATORIO SANTA ISABEL |
nome (usuário) | Lucio Flavio Simoes |
cpf | 79909973987 |
perfil | ATENDIMENTO |
| credenciado desde | 2005-11-18 (Amil e Santa Helena) |
uf / idSegmentos / idEspecialidades | SC / 2 / 28 |
O menu é por PERMISSÃO, não catálogo — de novo
O que este acesso vê:
Consulta de elegibilidade · Autorização prévia · Suporte de Autorização
Material de apoio · Normas ANS · Meus dados · Cadastro · Alterar senha
O que não aparece: Contas médicas (faturamento), Recurso de glosa,
Financeiro/demonstrativos.
E não é que o portal não tenha — o Angular **baixou os componentes de todos
eles** no carregamento (contas-medicas/incluir-guia, consulta-protocolo,
notas-fiscais, recurso-glosa/*, financeiro/demonstrativo-imposto,
portfolio/negociacao/* com tabelas de preço). O que falta é permissão:
GET /credenciadomedico/contas-automaticas/pagamentos/demonstrativos/mensagens → 403
É a mesma lição da Brusque, agora com o 403 para provar: **o menu reflete o
perfil do usuário, não o catálogo da operadora.** Concluir "a Amil não oferece
faturamento pelo portal" a partir desta sessão seria falso.
Consequência prática: com o perfil ATENDIMENTO dá para CHECK_ELIGIBILITY,
REQUEST_AUTH, CHECK_AUTH_STATUS e CANCEL_GUIDE. Faturamento, glosa e
demonstrativo exigem outro perfil de usuário — e só isso: o credenciado já
está habilitado para os três (medido, ver
[amil-endpoints.md](amil-endpoints.md#perfis-e-permissões--como-o-portal-realmente-decide)).
Como indPermissaoAcesso é true, o próprio prestador resolve na tela
"Permissão de acesso", que pede um usuário MASTER.
Mapa completo dos endpoints: [amil-endpoints.md](amil-endpoints.md) —
196 endpoints com método HTTP, as nove bases, os media types e a matriz de
perfil que o portal aplica.
A API REST por baixo existe, como a nota previa
Base /credenciadomedico/, mais /sisamil-credenciado/api/. Medidos com 200:
| Endpoint | Para quê |
|---|---|
POST /credenciadomedico/acesso/login | autenticação |
/credenciadomedico/comunicados?start=&limit=&… | avisos (carrega a identidade) |
/credenciadomedico/comunicados/nao-lidos, /bloqueio-nao-lidos | bloqueiam a navegação até leitura |
/credenciadomedico/credenciados/{id}/logo | logo do credenciado |
/credenciadomedico/credenciados/portfolio/verificar-cadastro-prestador | estado do cadastro |
/sisamil-credenciado/api/credenciados/{id}/tipos-atendimento | tipos de atendimento habilitados |
/credenciadomedico/suporte-autorizacao/notificacoes-pendentes | fila de suporte |
/portal/servicos/documentos/lista/chave/guias-manuais?tag=amil&tag=sc | manuais por UF |
Há antibot Akamai na frente
Durante toda a sessão o portal dispara POST repetidos para um caminho
ofuscado (/mr0T5_/Z8SqA/…) devolvendo 201 — assinatura de sensor do
Akamai Bot Manager. Não bloqueou a navegação por navegador real, mas é o
primeiro item a considerar antes de chamar a API direto por HTTP: é a diferença
entre o conector funcionar no laboratório e apanhar em produção. Ver o módulo
portal-connect/antibot.
Comunicado bloqueia a entrada
Depois do login o portal abriu /institucional/comunicados/2946551 sozinho e
existe endpoint de *bloqueio*-não-lidos. Um RPA precisa tratar o comunicado
antes de navegar, ou vai bater nessa parede achando que o menu sumiu.
O conector rodando: três paredes, nenhuma era o seletor
Conector amil-portal implementado e VALIDATE_CREDS SUCCESS em produção
em 21/10/2026. O caminho até lá tem valor próprio, porque as três falhas se
apresentaram como "timeout de seletor" e nenhuma era.
1. O Angular ainda não tinha montado
page.fill: Timeout waiting for locator('#login-usuario'). O seletor estava
certo: domcontentloaded devolve a casca, e o SPA renderiza os campos depois.
Mesma classe do detalhe da guia no SC Saúde — ler antes de a tela existir.
2. O Akamai bloqueia o IP do EC2
Com a espera certa, o diagnóstico mostrou o que havia de verdade:
titulo: Acesso Negado
Você não tem permissão para acessar este conteúdo!
Código do erro: 0.c842db17... Seu IP: 56.126.13.153
IP de saída do EC2, faixa AWS. Resolve a pendência que esta nota registrava
("se o antibot barra chamada fora do navegador"): barra — e barra antes mesmo
de qualquer chamada de API, logo no HTML da página de login.
A cura já existia no projeto e só precisava ser ligada na conexão:
"connectorConfig": {"stealth": true, "residentialProxy": true, "country": "br"}
RPAConnectorBase lê isso e sobe o Patchright com proxy residencial (IPROYAL,
credenciais já em produção). Com stealth, a tela de login carrega normalmente.
Conector novo da Amil nasce com esses três campos na conexão. Sem eles a
execução morre no "Acesso Negado" e o erro parece seletor errado.
3. A dica "Primeiro acesso?" intercepta o clique no Entrar
Passado o Akamai, o login ainda falhava — e este é o mais traiçoeiro. O
Playwright achava o botão, via visível, habilitado e estável, e mesmo assim
não conseguia clicar. 58 tentativas no log, todas barradas pelo mesmo elemento:
<div>Primeiro acesso? Insira o código do Credenciado. …</div> from <dl>…</dl>
subtree intercepts pointer events
A dica aparece com o foco no formulário — exatamente o estado do conector
na hora de enviar. Por isso não apareceu no mapeamento manual, feito
preenchendo os campos por JavaScript: sem foco, sem dica.
Solução: submeter com Enter no campo de senha. O clique ficou de reserva,
com force.
A lição que vale para os outros portais: "elemento visível e habilitado" não
quer dizer clicável. Quando o Playwright insiste e falha, o log diz quem
está na frente — e é nele que está a resposta, não no seletor.
O que o diagnóstico no erro comprou
As três falhas chegariam como "timeout" sem a mensagem que imprime URL, título
e início da página. Foi ela que separou "SPA lento" de "antibot" em uma
execução, em vez de uma sessão inteira investigando o seletor certo.
Rodada de 22/10/2026 — a área de autorização
4. O 403 não era perfil nem antibot: era cabeçalho faltando
Três execuções seguidas voltaram 403 e o conector afirmou que o perfil
ATENDIMENTO não alcança consulta de pedido. Era mentira sobre a operadora — o
tipo de afirmação que o guia proíbe. O corpo da resposta, quando finalmente
apareceu no log, dizia outra coisa:
{"messageKey":"sessiontoken.invalido","defaultMessage":"Session Token inválido."}
O cookie não basta. O portal tem um interceptor que carimba toda chamada:
Authorization: Bearer <acessoInfo.tokenInfo.accessToken>
X-Session: <acessoInfo.sessionToken>
X-User: <acessoInfo.usuarioInfo.codigoAmil>
sessionToken é irmão de tokenInfo, não filho. Procurar em
tokenInfo.sessionToken devolve undefined e reproduz o mesmo 403 por outro
motivo — meia hora a mais de investigação, já paga.
O interceptor pula o Authorization em sisamil-face-id,
sisamil-liveness e sisamil-ocr. Nenhum é usado pelo conector.
Transcrito do getAuthorizedOptions do bundle. E o bundle só foi possível
baixar pelo proxy residencial de produção: o Akamai recusa o IP local e o
do EC2 até para o arquivo estático. Receita, no EC2:
>
```bash
EP=${IPROYAL_ENDPOINT#*://} # a variável vem com esquema; o curl não quer
curl -sL --proxy "http://$U:$P@$EP" -A "<UA de Chrome>" \
https://credenciado.amil.com.br/amil/app-3f4eb86e9f.js
```
5. O código e a descrição da situação NÃO concordam
Este é o achado que mais vale. GET pedidos-autorizacao/situacoes/quantidade
nesta credencial, em 22/10/2026:
situacao | situacaoDescricao | quantidade |
|---|---|---|
AUTORIZADO | Validado | 1612 |
EM_ANALISE | Em análise | 0 |
NEGADO | Não Validado | 40 |
PENDENTE_DOCUMENTACAO | Pendente de Documentação | 0 |
CANCELADO | Cancelado | 73 |
O conector lia a descrição primeiro. "Não Validado" não casa com nenhum
padrão de negativa e caía no default "em análise": **pedido negado aparecia
como aguardando resposta**, e o faturista esperaria por algo já respondido.
Pior ainda seria "consertar" aceitando a palavra "Validado" — aí "Não
Validado" viraria autorizado.
Decida pelo código, use a descrição só como rótulo. A enum completa
(SituacaoPedido, do bundle) tem seis valores: os cinco acima mais
EXIGENCIA.
6. Parcial não é uma situação — é um booleano ao lado dela
Não existe AUTORIZADO_PARCIALMENTE na enum. O portal decide assim:
isValidadoParcialmente() { return this.isAutorizado() && this.autorizadoParcialmente }
Procurar "PARCIAL" na situação nunca acha, então guia parcial passaria por
guia inteira e a glosa apareceria meses depois. O campo é
autorizadoParcialmente e vem na lista e no detalhe.
7. A lista de pedidos: start e limit, e start começa em 1
GET credenciadomedico/pedidos-autorizacao sem paginação devolve 400, e a
mensagem é a própria documentação:
{"messageKey":"pedido.nao.encontrato","defaultMessage":"Informe start e limit para paginar a pesquisa."}
(o messageKey tem o typo "encontrato" — é da Amil, não nosso.)
Parâmetros aceitos, transcritos do parsePropertiesToQueryString do bundle e
confirmados em produção:
codigoCredenciado, identificacao, numeroAssociado, atendidoPorToken=false,
ehVinculado, dataSolicitacaoDe/Ate, dataPrevisaoDe/Ate, dataInternacaoDe/Ate,
dataAutorizacaoDe/Ate, situacao (repetível), start, limit, sort
- •
starté 1-based (setPaginacao: start = (pagina-1)*limit + 1), não
índice de página. pagina/tamanhoPagina dão 400.
- •
sortpadrão:-numeroPedido.limitpadrão: 10. - •datas em
YYYY-MM-DD. - •A resposta vem em
{ links, totalCount, pedidosAutorizacao: [...] }— a
chave não é pedidos nem content.
8. O código do credenciado vem do usuário, não da lista de credenciados
acessoInfo.usuarioInfo.codigoCredenciadoAmil = 10465987. Ler
credenciados[0].codigo devolve vazio nesta sessão. O sessionToken é um JWT
e carrega os mesmos dados no payload (codigoAmil, perfil,
codigoCredenciadoAmil, documentoCredenciado, razaoSocial) — útil para
conferir sem navegar.
9. Onde ficam as peças das operações que faltam
Medido no bundle, ainda não exercitado:
- •REQUEST_AUTH —
POST credenciadomedico/pedidos-autorizacao, corpo
PedidoAutorizacaoInclusao:
`{ beneficiario, executante, solicitante, procedimentosMedicos[],
codigoTipoAtendimento, caraterAtendimento: "ELETIVA"|"URGENCIA",
indicadorPossuiOpme, atendimentoRecemNascido, codigoUsuario }`.
O procedimento não é só o código TUSS: o portal manda o objeto inteiro
(nivelAutorizacao, codigoGrupoEstatistico, codigoEspecialidadeAmb,
codigoPadrao, codigoDePara, tecnicas, tecnicaProcedimento), e o
resolve em
GET sisamil-credenciado/api/pesquisa/itens-procedimentos-medicos?codigoOuNome={cod}&somenteProcedimentoMedico={b}&pesquisaGuiaMedica={b}&origem=autorizacao[&codigoPrestadorExecutante={cod}].
Tipos que o credenciado pode pedir:
GET sisamil-credenciado/api/credenciados/{id}/tipos-atendimento.
- •EXECUTE_PREAUTH — é a confirmação de atendimento:
PUT credenciadomedico/pedidos-autorizacao/{n}/confirmacao-atendimento, com
`{ codigoCredenciado, dataHoraAtendimento: "YYYY-MM-DDTHH:mm:ss",
tipoConfirmacao, beneficiario, pedidoAutorizacaoItens[], checkinHabilitado }`.
tipoConfirmacao ∈ `TOKEN | DADOS_BENEFICIARIO | PEDIDO_SEM_TOKEN |
MOTIVO_NAO_RECEBIMENTO_TOKEN`. Os itens são
`{ numeroSequenciaPedido, numeroSequenciaItem, dataInicioAtendimento,
dataFimAtendimento }` e as sequências saem de
GET sisamil-credenciado/api/pedidos-autorizacao/{n}/sequencias.
Tem desfazer: PUT .../reversao-atendimento.
- •CANCEL_GUIDE — o
motivonão é texto livre: é código de uma lista
por tipo de tratamento e caráter, em
GET sisamil-credenciado/api/motivo-cancelamento-por-pedido?codigoTratamento={t}&indCarater={c},
e essa rota pede um Accept fora do padrão:
application/vnd.amil.credenciado.medico.ans-ecog.v1+json.
Descartado por medição
- •
GET credenciadomedico/motivos-cancelamento→ 404. - •
GET credenciadomedico/pedidos-autorizacao/motivos-cancelamento→ 500
("Serviço indisponível no momento") — parece existir e não existe; não insista.
- •
GET sisamil-credenciado/api/motivos-cancelamento→ 404. - •
GET sisamil-credenciado/api/pedidos-autorizacao/situacoes→ 404. As
situações vêm de credenciadomedico/.../situacoes/quantidade.
10. O motivo do cancelamento é um NÚMERO
Transcrito do componente de cancelamento:
selecionarMotivoCancelamento(a) { this.cancelamentoPedido.motivo = +a } // ← unário +
// e, na reversão de atendimento:
new CancelamentoPedido({ codigoCredenciado, motivo: MOTIVO_PROCEDIMENTO_NAO_REALIZADO, reversao: true })
// MOTIVO_PROCEDIMENTO_NAO_REALIZADO = 5
O corpo é { codigoCredenciado, motivo: <número>, reversao?: boolean }. O
conector mandava { motivo: <texto>, descricaoMotivo: <texto> } e **nenhum
codigoCredenciado** — texto onde a Amil espera número não vira motivo nenhum.
Os códigos válidos dependem do pedido:
GET sisamil-credenciado/api/motivo-cancelamento-por-pedido
?codigoTratamento={codigoTipoAtendimento}&indCarater={E|U}
Accept: application/vnd.amil.credenciado.medico.ans-ecog.v1+json
indCarater é a PRIMEIRA LETRA do caráter (caraterAtendimento.charAt(0)
no portal): E de ELETIVA, U de URGENCIA. Mandar ELETIVA inteiro dá 404 —
foi exatamente o que aconteceu na primeira tentativa, e o 404 parecia "a rota
não existe".
Por isso o conector recusa reason que não seja código, em vez de
escolher um: o motivo fica gravado na operadora e é lido por gente depois.
A mensagem de recusa aponta a rota da lista e cita o 5, que é o único que o
próprio portal fixa.
Os sete motivos de cancelamento, medidos
GET sisamil-credenciado/api/motivo-cancelamento-por-pedido?codigoTratamento=37&indCarater=E
→ 200, e a lista é a mesma para codigoTratamento 37 e 45 e para indCarater E e U:
| código | nome | descrição ao prestador |
|---|---|---|
| 1 | Por Solicitação do Beneficiário | Por Solicitação do Beneficiário. |
| 2 | Por solicitação do Prestador | Por solicitação do Prestador. |
| 3 | Cadastro em Duplicidade | Pedido cancelado por cadastro em duplicidade. |
| 5 | Procedimento não realizado | Pedido cancelado devido a não realização do procedimento |
| 6 | Validade da senha vencida | Pedido cancelado devido a validade da senha expirada |
| 11 | Beneficiário Suspenso | Pedido Cancelado por Beneficiário com atendimento suspenso |
| 13 | Troca de protocolo | Pedido cancelado devido alteração do protocolo médico. |
Não há 4, 7–10 nem 12 — a numeração é esparsa, então **não se deduz código por
posição na lista**.
Quantos pedidos esperam confirmação
?situacao=AUTORIZADO&atendidoPorToken=false → 29 pedidos, o mais antigo de
21/11/2025. São os candidatos reais de EXECUTE_PREAUTH; vários já estão com a
senha fora da validade, o que os torna candidatos de CANCEL_GUIDE com o
motivo 6.
11. A solicitação de autorização: cinco recusas, cada uma um campo
A Amil recusou REQUEST_AUTH quatro vezes antes de aceitar, e cada recusa
ensinou uma coisa. Vale a sequência inteira, porque ela mostra que
invalid.request.body não diz nada e pedido.autorizacao.invalido diz tudo.
| # | Resposta da Amil | O que faltava |
|---|---|---|
| 1 | invalid.request.body — "O corpo da requisição é inválido." | beneficiario inteiro, não {numeroAssociado} |
| 2 | pedido.autorizacao.invalido — "O campo \"Conselho\" é de preenchimento obrigatório!" | siglaConselho ("CRM") ao lado de siglaConselhoTiss ("6") |
| 3 | pedido.autorizacao.invalido — "Para o procedimento inserido, é necessário incluir anexo" | o pedido médico em PDF |
| 4 | invalid.request.body (de novo) | o anexo montado como o portal monta, não como hash solto |
| 5 | 201 — pedido 534894188 | — |
O beneficiário vai INTEIRO
criarPedido do portal faz, literalmente,
pedido.beneficiario = this.elegibilidade.beneficiario. Vai o objeto cru da
elegibilidade: nome, dataNascimento, sexo, codigoFilial, plano
(com codigoRede, codigoPlano, acomodacao…) e contrato. Mandar só o
número devolve invalid.request.body sem dizer qual campo falta — e é
por isso que a primeira recusa custou caro.
O executante: codigoFilial sai da SESSÃO, não do endereço
O endereço medido (GET credenciados/{id}/enderecos/) tem id,
logradouro, …, cnes — e não tem codigoFilial. Ler dali omitia a
filial em silêncio. O pedido real traz codigoFilial: 1, que é o filial
do credenciadoInfo. O codigoEndereco sim vem do endereço ([0].id, que
no Santa Isabel é 4, não 1).
O conselho: a Amil quer a sigla E o código
| Campo | Valor no pedido real | Fonte |
|---|---|---|
siglaConselho | CRM | GET sisamil-credenciado/api/conselhos-regionais?nome=CRM → codigo |
siglaConselhoTiss | 6 | dm_conselhoProfissional do XSD, sem o zero à esquerda |
A lista da Amil é indexada pela sigla e não traz o código do domínio.
Duas siglas divergem do XSD: Serviço Social é CRAS (o TISS usa CRESS, e
a própria Amil escreve "(CRESS)" no nome) e outros conselhos é O (o
TISS usa OUT). ?nome= com string vazia dá 400; precisa de pelo menos uma
letra.
O solicitante não é o credenciado
O pedido real traz tipoSolicitante: "SOLICITANTE" com o CRM do médico que
pediu. O template de consulta do próprio portal usa
PRESTADOR_CREDENCIADO com o CBO do credenciado — porque ali quem pede é a
clínica. Trocar um pelo outro diria à operadora que o laboratório pediu o
próprio exame.
Exame não passa sem anexo, e o anexo sobe ANTES do pedido
Os 15 procedimentos da requisição real são todos
NECESSITA_AUTORIZACAO_ADMINISTRATIVA — não é borda, é o normal de
laboratório. E a ordem é contraintuitiva: o componente do portal chama
anexoService.enviar(pedidoNovaSequencia ? "" : numeroPedido, ...), com
numeroPedido vazio. O upload devolve um hash, e é o hash que entra no
corpo da solicitação. Criar o pedido e anexar depois não existe: o pedido não
chega a ser criado.
POST /sisamil-credenciado/api/pedidos-autorizacao/anexos (multipart)
file, codigoUsuario, numeroPedido (vazio), tipoAnexoId,
numeroSequencia, origem=PEDIDO, incluirNaGuia=false
→ 201 { hash, nome, subDiretorio, path }
Content-Type não se declara: quem escreve o boundary é o fetch.
Fixar multipart/form-data sem boundary faz o servidor ler o corpo vazio.
E o item do anexo no corpo do pedido é montado assim, literalmente:
Object.assign({}, { tipoAnexo }, respostaDoUpload, { codigoUsuario })
Então vão também subDiretorio e path — que o servidor gerou — e o
tipoAnexo inteiro, não { id: 4 }. Mandar só o hash devolve
invalid.request.body.
Os tipos aceitos saem de
GET autorizacao-tipos-anexos-descricao-hierarquia?codigoOrigem=1&origemTipoOperacao=Inclusao&codigoTipoAtendimento=37&codigosProcedimentos={csv}&codPrestador={cred}.
codigoOrigem é 1 fixo (literal no buscarTipoAnexoOrigem(1, ...)) e
origemTipoOperacao vem do enum OrigemOperacaoAnexo, em que a criação de
pedido é "Inclusao" — "AUTORIZACAO" não existe lá. A lista varia por
procedimento: 4 "Pedido do profissional de saúde", 8 "Relatório do
profissional de saúde", 13 "Termo de consentimento", 24 "Comprovante de
comparecimento_assinatura", 26 "Comprovante de elegibilidade".
12. A confirmação de atendimento exige o token do beneficiário
Esta é a descoberta que muda o desenho da operação.
isObrigatorioToken() do portal é, literalmente,
return this.pedido.possuiToken. Não é obrigaConfirmacaoToken — o pedido
534894188 veio com possuiToken: true e obrigaConfirmacaoToken: false,
aptoParaConfirmacaoAtendimento: true, e a Amil ainda assim recusou
tipoConfirmacao: PEDIDO_SEM_TOKEN com erro.processar.atendimento /
"TOKEN não informado".
Os quatro tipos (TiposConfirmacao do portal):
| Tipo | O que exige |
|---|---|
TOKEN | o código que o beneficiário recebe no app |
PEDIDO_SEM_TOKEN | só vale quando o pedido não tem token |
MOTIVO_NAO_RECEBIMENTO_TOKEN | idMotivoNaoRecebimentoToken — uma declaração |
DADOS_BENEFICIARIO | CPF + data de nascimento + nome da mãe |
O caminho sem o código é declarar por que ele não veio. Os motivos saem
de GET sisamil-credenciado/api/motivos-nao-recebimento-token?versaoTiss=4.03.00
e são os sete do dm_ausenciaValidacaoBeneficiario do TISS — **com outra
numeração**:
| TISS | Amil | Motivo |
|---|---|---|
| 01 | 9 | Beneficiário internado |
| 02 | 10 | Beneficiário em situação de urgência/emergência |
| 03 | 11 | Intermitência/instabilidade de sistemas |
| 04 | 12 | Beneficiário se negou a transmitir o token |
| 05 | 13 | Beneficiário em coleta domiciliar |
| 06 | 14 | Material para exames enviado por terceiros |
| 07 | 15 | Beneficiário não possui celular |
O de-para é explícito no código, não um deslocamento de +8: se a Amil
inserir um motivo no meio da lista, o deslocamento passa a declarar o motivo
errado — e o motivo é lido por gente depois.
O campo no corpo é idMotivoNaoRecebimentoToken, lido do template
confirmar-atendimento-sem-token.component.html
([(ngModel)]="confirmacaoAtendimento.idMotivoNaoRecebimentoToken"). Os
templates HTML não se baixam por curl pelo proxy — o Akamai devolve
"Acesso Negado"; só saem pelo fetch de dentro da sessão.
O que isso significa para a operação
EXECUTE_PREAUTH na Amil não é automatizável sozinha. Ou chega o token
do beneficiário — que está com quem atendeu, não com o conector — ou alguém
declara o motivo da ausência. O conector exige
beneficiaryValidationAbsenceReason e recusa sem ele, listando os sete: sem
token e sem motivo, confirmar seria declarar à Amil que a identidade do
beneficiário foi conferida quando ela não foi.
A resposta do PUT não traz situacao
Confirmação aceita voltava com statusLabel: "Em análise" ao lado de
desfecho: AUTORIZADA, na mesma resposta. mapearSituacao('') devolve "em
análise", que é o certo para situação desconhecida — mas ali a situação não
era desconhecida: o pedido tinha acabado de ser lido como AUTORIZADO.
O estado da área de autorização
Medido em 22/10/2026, com dado real do Laboratório Santa Isabel.
| Operação | Estado | Prova em produção |
|---|---|---|
CHECK_ELIGIBILITY | corrigida | carteira 098134529 → elegível, AMIL S380, ATIVO |
CHECK_AUTH_STATUS | corrigida | pedido 534740404 → senha EX2026023525693 |
REQUEST_AUTH | implementada | pedido 534894188 criado, senha EX2026023598725 |
EXECUTE_PREAUTH | implementada | atendimento do 534894188 confirmado (motivo 01, internado) |
CANCEL_GUIDE | corrigida | ver abaixo |
O ciclo foi fechado num pedido criado para isso: carteirinha 078767068, um
procedimento (40302580 Uréia), anexo = o pedido médico real que já estava no
portal no pedido 533582023. Por ser duplicata de uma autorização existente,
o pedido foi cancelado ao fim do ciclo.
O cancelamento, exercitado
PUT /credenciadomedico/pedidos-autorizacao/534894188/cancelamento
{ "codigoCredenciado": "10465987", "motivo": 3 }
→ 200 { "mensagemRetorno": "Cancelamento 534894188 realizado. <br> Comunicação realizada " }
Motivo 3 — Cadastro em Duplicidade, que é o que o pedido era. Um pedido
já confirmado aceita o cancelamento: podeCancelar e
podeReverterAtendimento vieram true, e o pedido terminou CANCELADO
mantendo pedidoConfirmado: true e a dataConfirmacao. Ou seja: cancelar
não apaga o registro da confirmação, só muda a situação.
O que a sonda deixou para trás
Dois anexos subiram sem pedido durante a medição do contrato (numeroPedido
vazio, que é o caminho legítimo) e não foram usados por nenhum pedido. Ficam
órfãos no armazenamento da Amil. Hash conhecido:
5C3F68C1-009F-4A7A-81A5-3584B84A0EF0. A rota de remoção é
DELETE sisamil-credenciado/api/pedidos-autorizacao/anexos/{hash}.
Ainda a medir: se o upload órfão expira sozinho, e se há como listar
anexos sem pedido para limpar os que a medição deixar.
13. O faturamento: o módulo inteiro está fechado para o nosso perfil
Medido em 22/10/2026, com o usuário 10465987w26 (perfil ATENDIMENTO).
Não é tela a tela — é o módulo
Vinte e duas rotas sondadas, só GET. Todas as catorze de
credenciadomedico/contas-automaticas/* responderam:
403 {"messageKey":"sessiontoken.acesso.nao.autorizado",
"defaultMessage":"Acesso não autorizado ao recurso."}
Inclusive /versao-sistema, que não devolve dado nenhum. Isso fecha a
dúvida: o bloqueio é do módulo, não de cada funcionalidade, e nenhuma
linha de código nossa contorna. Faturamento da Amil exige um usuário com
perfil FINANCEIRO, ADMINISTRATIVO ou MASTER (subperfil FATURAMENTO).
Rota (credenciadomedico/contas-automaticas/…) | Perfil ATENDIMENTO |
|---|---|
versao-sistema | 403 |
protocolos?dataDe=&dataAte=&start=&limit= | 403 |
protocolos/situacoes/quantidade | 403 |
guias | 403 |
pagamentos/demonstrativos/mensagens | 403 |
tipos-consulta, profissionais, regime-atendimento, cobertura-especial | 403 |
guias/anexos/descricoes | 403 |
protocolos/notas-fiscais, protocolos/recibo-entrega | 404 (são POST, não GET) |
lotes-guias/previas-glosas | 404 (idem) |
O que ESTÁ aberto
sisamil-guias-medicas/api/* responde 200 — são as tabelas de referência,
compartilhadas com a autorização:
| Rota | Resposta |
|---|---|
credenciados/guias-medicas/proximo-numero-guia | {"numeroGuia":"339602841"} |
tipos-faturamento | 1 Parcial, 2 Final, 3 Complementar, 4 Total |
tipos-atendimento, tipos-despesa, regimes-internacao, ans-grau-participacao | 200 |
Ou seja: o portal reserva um número de guia para nós, mas não deixa
gravar a guia (POST contas-automaticas/guias/{sadt\|honorarios\|internacao}
está no 403).
O lote da Amil NÃO é um XML
Esta é a descoberta que muda o desenho da operação:
this.loteGuiaUrl = "credenciadomedico/contas-automaticas/guias/lotes-guias/enviar";
enviarLote(guias) { return this.http.post(this.loteGuiaUrl, { guiasPedidos: guias }) }
O corpo é { guiasPedidos: [...] } — uma lista de guias que já estão
cadastradas no portal. O bundle inteiro não tem nenhuma ocorrência de
.xml nem de "importar"; as 14 menções a XML são do próprio Angular
(XMLHttpRequest, serializador, xliff). **O portal do credenciado da Amil
não recebe lote TISS em arquivo.**
O fluxo real é:
1. compor a guia no portal (POST contas-automaticas/guias/{tipo}), ou
gerá-la a partir do pedido de autorização;
2. selecionar guias e POST guias/lotes-guias/enviar { guiasPedidos } → gera
o protocolo;
3. POST contas-automaticas/protocolos/faturamento finaliza o faturamento
(há também /reapresentacao).
Consequência para o produto: nosso gerador de XML TISS não tem destino no
portal da Amil. SUBMIT_BATCH aqui não é "subir o arquivo do lote" — é
"montar o lote a partir de guias digitadas na operadora". Quem for implementar
precisa saber disso antes de desenhar a operação.
As quatro que diziam "não mapeado"
As 58 rotas do app Angular foram varridas (path:"…" no bundle). Resultado:
| Operação | Antes | Agora, medido |
|---|---|---|
FETCH_RETURNS | "não mapeado" | não existe: não há tela de retorno TISS; o que há é contas-medicas/detalhe-protocolo |
FETCH_ANALYSIS | "não mapeado" | existe como prévia de glosa do lote (lotes-guias/previas-glosas, variante /csv), dentro do módulo em 403 |
FETCH_PAYMENT_SCHEDULE | "não mapeado" | não existe: nenhuma rota de previsão de crédito. O que há em financeiro é financeiro/demonstrativo-imposto (informe de rendimentos), que é outra coisa |
FETCH_UTILIZATION | "não mapeado" | não existe: nenhuma rota de extrato de utilização |
As rotas do módulo de contas são contas-medicas,
contas-medicas/detalhe-protocolo, contas-medicas/finalizar-faturamento,
contas-medicas/guia e contas-medicas/guia/detalhe.
Ainda a medir (depende de credencial com subperfil FATURAMENTO): o corpo
de salvarGuia, o formato de guiasPedidos, o que protocolos devolve, e se
a prévia de glosa serve como FETCH_ANALYSIS de verdade.
O faturamento da Amil são QUATRO pendências, não sete
Em 23/10/2026 as três inexistentes saíram da fila: estão declaradas em
naoOferecidas no conector, e a matriz as pinta com estado próprio ("a
operadora não oferece"), fora da conta de lacuna. Não é maquiagem — é a
diferença entre duas coisas que a célula cinza misturava:
| sobram | o que destrava | quanto falta |
|---|---|---|
SUBMIT_BATCH, CHECK_STATUS, FETCH_PAYMENT, FETCH_ANALYSIS | credencial FINANCEIRO/ADMINISTRATIVO/MASTER | rotas já mapeadas; a sessão da Amil já funciona |
FETCH_RETURNS, FETCH_PAYMENT_SCHEDULE, FETCH_UTILIZATION | nada | não existem no portal |
Não mova as quatro do 403 para naoOferecidas. A tentação de limpar o
cinza afirmando que a Amil não faz apagaria quatro operações que uma
credencial destrava — e o CI reprova, porque naoOferecidas exige a data da
medição no motivo e proíbe a mesma operação nas duas listas.
E lembre do desenho: mesmo com a credencial, SUBMIT_BATCH aqui não é subir
XML (ver "O lote da Amil NÃO é um XML", acima).
31/10/2026 — A AMIL IMPRIME A GUIA, e a receita inteira está aqui
PRINT_GUIDE implementado e medido. Pedido 536082469 (AUTORIZADO,
carteira …4460, Laboratório Santa Isabel): PDF de 34.887 bytes, uma página,
Producer: iText 5.3.0, com os campos da SP/SADT preenchidos — campo 1 ANS
326305, campo 5 senha EX2026024208259, campo 6 validade 28/12/2026, campo
2 536082469seq001.
São duas chamadas, e a primeira não é opcional
1) GET credenciadomedico/pedidos-autorizacao/{pedido}/guia-tiss?codigoCredenciado={cred}
Accept: application/vnd.amil.credenciado.medico.pedidos-autorizacao.v1+json
→ { "itens":[{"numeroSequenciaPedido":1}],
"tiposGuia":[{"numeroSequenciaPedido":1,"guias":["GUIA_SADT"]}],
"executante":{"codigo":"10465987","codigoFilial":1,…} }
2) GET credenciadomedico/impressao-autorizacao/pedido/{pedido}/credenciados/{cred}
/sequencia/{seq}/tipo-guia/{nome}/codigo-operadora/{filial}
Accept: application/vnd.amil.credenciado.medico.impressao-autorizacao.v1+json
→ corpo application/pdf
Há uma segunda forma da rota de impressão, com ?beneficiario={carteira} no
lugar de /credenciados/{cred}. As duas foram chamadas lado a lado e devolveram
o MESMO PDF (34.887 bytes). O conector usa a por credenciado, porque ela não
precisa da carteira do paciente.
tipo-guia é NOME, não número — e foi o que custou mais caro
A constante do portal (GUIA no bundle):
| valor | descrição na tela |
|---|---|
GUIA_CONSULTA | Guia SADT |
GUIA_SADT | (o que tiposGuia devolve para exame) |
GUIA_HONORARIO | Guia Honorários |
GUIA_INTERNACAO | Guia Solicitação Internação |
GUIA_PRORROGACAO | Prorrogação |
GUIA_OUTRAS_DESPESAS | Anexo Outras Despesas |
GUIA_ANEXO_OPME / _QUIMIOTERAPIA / _RADIOTERAPIA | anexos |
Mandar SADT, 1, 5 ou qualquer código devolve 400 invalid.data — que
parece recusa de negócio e é só o nome errado. O nome certo vem do passo 1; não
se adivinha.
Três enganos meus, documentados para não se repetirem
1. 403 sessiontoken.invalido não é permissão. Duas passadas desta medição
chamaram com fetch cru e levaram 403 em 15 combinações — e eu quase
escrevi que o perfil ATENDIMENTO estava barrado. O portal carimba TODA
chamada com Authorization: Bearer, X-Session e X-User (está no
cabeçalho de amil/api.ts, que eu mesmo escrevi). Sem eles, 403 sempre.
2. Accept é um por rota. guia-tiss quer o media type de *pedidos*;
a impressão quer o de *impressão*. Trocados, 406 com corpo vazio — e 406
não é "a rota não existe".
3. PDF se lê em binário. Lido como texto, a assinatura %PDF se perde e a
medição conclui "não veio PDF" sobre um PDF que veio.
Pedido cancelado não imprime — e isso é resposta, não falha
O pedido 534894188 (o que esta casa cancelou em 22/10) tem
sequencias[0] = {situacao: CANCELADO, senhaAutorizacao: null}: nenhuma
sequência validada, e a rota responde 400. O modal do portal diz o mesmo em
português — *"Não existem sequências validadas para impressão"*. O conector
recusa com GUIA_SEM_IMPRESSAO em vez de chutar sequência 1.
Escolher o pedido errado atrasou a medição em cinco passadas: medir
impressão num pedido cancelado mede o cancelamento.
De onde saiu o caminho
Do bundle do próprio portal, não de chute:
app/pedidos/impressao-guia/impressao-guia.component.html (modal "Impressão de
autorização", com a tabela de sequências), o serviço ImpressaoPedidoService
(impressaoUrl = "credenciadomedico/impressao-autorizacao/", gerarGuiaTISS e
gerarGuiaTISSPorCredenciado, responseType: Blob) e
pedidosAutorizacaoService.buscarGuiaTissPorCredenciado. O detalhe do pedido
confirma pelo outro lado: ele traz codigoTipoAtendimentoImpressaoSadt.
E a listagem que achou um pedido vivo:
GET credenciadomedico/pedidos-autorizacao?situacao=AUTORIZADO&start=1&limit=5&sort=-numeroPedido
— pedidos-autorizacao/situacoes/quantidade diz que este credenciado tem
1.620 pedidos AUTORIZADOS, então nunca falta guia para medir.