A API auditCarolPos tem como objetivo fornecer o histórico completo das ações realizadas pelos auditores. Ela registra detalhadamente quais ações foram executadas, por qual auditor, em quais lotes, qual o prestador relacionado, e em qual data e hora.
A API retorna: código do prestador executante na operadora, número do protocolo, número do lote. número da guia do prestador, nome do auditor, email do auditor, data da audição, hora da audição, ação que está sendo tomada pelo auditor e descrição dessa ação (por ex: aprovou o item 123, negou o item 123, iniciou a análise, finalizou a análise).
A API está no ambiente de produção, portanto, a requisição deve apontar para o mesmo.
A URL da requisição será:
https://hat.totvs.com.br/api/healthcare/hatfaturamento/v1/auditCarolPos? + parâmetros de busca (especificados na seção abaixo)
Seguem as configurações que devem ser feitas na plataforma da API antes da requisição.
| Key | Value |
|---|---|
| Authorization | Valor presente no parâmetro MV_PHATNMT no PLS |
| tenantName | Valor presente no parâmetro MV_PHATQTD no PLS |
| idTenant | Valor presente no parâmetro MV_PHATTOK no PLS |
O token de Authorization deve ser o Master Token, para não expirar.
[ MASTER TOKEN - GERANDO E CONFIGURANDO ]Seguem os verbos disponíveis na API:
Verbo | Path |
|---|---|
| GET | / |
auditCarolPos é o nome da API, e deve ser colocado logo após a URL e seu complemento indicativo que a API é do HAT:
https://hat.totvs.com.br/api/healthcare/hatfaturamento/v1/auditCarolPos
Lista de query params OBRIGATÓRIOS:
Parâmetro na API | Campo | Descrição |
|---|---|---|
| dateFrom | Data De | De qual até qual o período que você deseja buscar os detalhes da auditoria. |
| dateTo | Data Até | De qual Até qual o período que você deseja buscar os detalhes da auditoria. |
https://hat.totvs.com.br/api/healthcare/hatfaturamento/v1/auditCarolPos?dateFrom=2025-05-01&dateTo=2025-09-01
Aqui vão ser retornados os registros que estão entre as datas e
As datas devem ser passadas no formato: AAAA-MM-DD.s
Caso não forem passadas as duas data, a API retornará um BadRequest 400 acompanhado de uma mensagem de que é necessário informar ambos os parâmetros.
Lista de query params OPCIONAIS:
| Parâmetro na API | Campo | Descrição |
|---|---|---|
| healthProviderId | Código Prestador (RDA) | Código do Prestador Executante da Operadora |
| auditorEmail | Email do Auditor | Email do Auditor |
| batch | Número Lote | <AQUI> |
| page | ||
| pageSize |
Exemplo de uso:
https://hat.totvs.com.br/api/healthcare/hatfaturamento/v1/auditCarolPos?dateFrom=2025-05-01&dateTo=2025-09-01&healthProviderId=000005&[email protected]&batch=298374&page=1&pageSize=50
Sucesso 200
{ |
A API retorna todos os campos da tabela LogCarolPos
Erro 400 Bad Request
1 | { |