Ogmma Revenue
Voltar para a matriz

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

PrazoQuantoConta a partir deFonte
Envio do lotenão medido——
Pagamentonão medido——
Recurso de glosanão medido——
O valor operável fica em HealthPlan (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)

ItemValor
StackAngular (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
Captchanão há
Cookiesbanner 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/):

ArquivoOrigem
manual-faturamento-eletronico-amil-v3.pdf34 páginas, nov/2019
manual-elegibilidade-amil.pdf8 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:

CampoValor
idCredenciado10465987
idUsuario314603
cnpj / cnpjCredenciado82629361000166 (o mesmo do SC Saúde)
nomeCredenciadoLABORATORIO SANTA ISABEL
nome (usuário)Lucio Flavio Simoes
cpf79909973987
perfilATENDIMENTO
credenciado desde2005-11-18 (Amil e Santa Helena)
uf / idSegmentos / idEspecialidadesSC / 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:

EndpointPara quê
POST /credenciadomedico/acesso/loginautenticação
/credenciadomedico/comunicados?start=&limit=&…avisos (carrega a identidade)
/credenciadomedico/comunicados/nao-lidos, /bloqueio-nao-lidosbloqueiam a navegação até leitura
/credenciadomedico/credenciados/{id}/logologo do credenciado
/credenciadomedico/credenciados/portfolio/verificar-cadastro-prestadorestado do cadastro
/sisamil-credenciado/api/credenciados/{id}/tipos-atendimentotipos de atendimento habilitados
/credenciadomedico/suporte-autorizacao/notificacoes-pendentesfila de suporte
/portal/servicos/documentos/lista/chave/guias-manuais?tag=amil&tag=scmanuais 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:

situacaosituacaoDescricaoquantidade
AUTORIZADOValidado1612
EM_ANALISEEm análise0
NEGADONão Validado40
PENDENTE_DOCUMENTACAOPendente de Documentação0
CANCELADOCancelado73

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.

  • •sort padrão: -numeroPedido. limit padrã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 motivo nã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ódigonomedescrição ao prestador
1Por Solicitação do BeneficiárioPor Solicitação do Beneficiário.
2Por solicitação do PrestadorPor solicitação do Prestador.
3Cadastro em DuplicidadePedido cancelado por cadastro em duplicidade.
5Procedimento não realizadoPedido cancelado devido a não realização do procedimento
6Validade da senha vencidaPedido cancelado devido a validade da senha expirada
11Beneficiário SuspensoPedido Cancelado por Beneficiário com atendimento suspenso
13Troca de protocoloPedido 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 AmilO que faltava
1invalid.request.body — "O corpo da requisição é inválido."beneficiario inteiro, não {numeroAssociado}
2pedido.autorizacao.invalido — "O campo \"Conselho\" é de preenchimento obrigatório!"siglaConselho ("CRM") ao lado de siglaConselhoTiss ("6")
3pedido.autorizacao.invalido — "Para o procedimento inserido, é necessário incluir anexo"o pedido médico em PDF
4invalid.request.body (de novo)o anexo montado como o portal monta, não como hash solto
5201 — 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

CampoValor no pedido realFonte
siglaConselhoCRMGET sisamil-credenciado/api/conselhos-regionais?nome=CRM → codigo
siglaConselhoTiss6dm_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):

TipoO que exige
TOKENo código que o beneficiário recebe no app
PEDIDO_SEM_TOKENsó vale quando o pedido não tem token
MOTIVO_NAO_RECEBIMENTO_TOKENidMotivoNaoRecebimentoToken — uma declaração
DADOS_BENEFICIARIOCPF + 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**:

TISSAmilMotivo
019Beneficiário internado
0210Beneficiário em situação de urgência/emergência
0311Intermitência/instabilidade de sistemas
0412Beneficiário se negou a transmitir o token
0513Beneficiário em coleta domiciliar
0614Material para exames enviado por terceiros
0715Beneficiá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çãoEstadoProva em produção
CHECK_ELIGIBILITYcorrigidacarteira 098134529 → elegível, AMIL S380, ATIVO
CHECK_AUTH_STATUScorrigidapedido 534740404 → senha EX2026023525693
REQUEST_AUTHimplementadapedido 534894188 criado, senha EX2026023598725
EXECUTE_PREAUTHimplementadaatendimento do 534894188 confirmado (motivo 01, internado)
CANCEL_GUIDEcorrigidaver 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-sistema403
protocolos?dataDe=&dataAte=&start=&limit=403
protocolos/situacoes/quantidade403
guias403
pagamentos/demonstrativos/mensagens403
tipos-consulta, profissionais, regime-atendimento, cobertura-especial403
guias/anexos/descricoes403
protocolos/notas-fiscais, protocolos/recibo-entrega404 (são POST, não GET)
lotes-guias/previas-glosas404 (idem)

O que ESTÁ aberto

sisamil-guias-medicas/api/* responde 200 — são as tabelas de referência,

compartilhadas com a autorização:

RotaResposta
credenciados/guias-medicas/proximo-numero-guia{"numeroGuia":"339602841"}
tipos-faturamento1 Parcial, 2 Final, 3 Complementar, 4 Total
tipos-atendimento, tipos-despesa, regimes-internacao, ans-grau-participacao200

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çãoAntesAgora, 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:

sobramo que destravaquanto falta
SUBMIT_BATCH, CHECK_STATUS, FETCH_PAYMENT, FETCH_ANALYSIScredencial FINANCEIRO/ADMINISTRATIVO/MASTERrotas já mapeadas; a sessão da Amil já funciona
FETCH_RETURNS, FETCH_PAYMENT_SCHEDULE, FETCH_UTILIZATIONnadanã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):

valordescrição na tela
GUIA_CONSULTAGuia SADT
GUIA_SADT(o que tiposGuia devolve para exame)
GUIA_HONORARIOGuia Honorários
GUIA_INTERNACAOGuia Solicitação Internação
GUIA_PRORROGACAOProrrogação
GUIA_OUTRAS_DESPESASAnexo Outras Despesas
GUIA_ANEXO_OPME / _QUIMIOTERAPIA / _RADIOTERAPIAanexos

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.

Esta página é gerada de docs/operacoes-conectores/notas/amil.md no repositório. Para corrigir ou acrescentar, edite o markdown — não a página.