Varejo Supermercados - Integrações - API - Access Violation na integração com API (integrações externas)

Tempo aproximado para leitura: 00:04:00 min

Ocorrência
PDV apresenta erro de Access Violation durante execução de eventos da venda (ex: subtotal) ao utilizar integração via API (ex: Cresce Vendas).

Ambiente
TOTVS Varejo - Supermercados PDV - Linha Consinco - Todas as versões

Causa 
PDV apresenta Access Violation durante a execução de eventos da venda (ex: subtotal) ao utilizar integração via API (ex: Cresce Vendas, Vórtice).

Exemplo de um response incorreto:

HTTP 401

{
"response": {
"code": 401,
"error": "Para continuar, efetue login ou registre-se"
}
}

O erro de Access Violation ocorre quando o response retornado pela integração está fora do padrão esperado pelo PDV, impossibilitando a interpretação correta da resposta pela aplicação.


Diagnóstico
A comunicação da API do PDV ocorre via arquivos JSON (request/response).

Para análise:

1. Acessar o diretório de logs da aplicação: C:\C5Client\AcruxPDV\log\aplicacao
    
2. Validar os arquivos:

• custom_request (o que o PDV solicita)
• custom_response (o que a integração responde)

⚠️ Atenção:

• Os logs são sobrescritos a cada evento (ex: início da venda, subtotal, etc.)
• É necessário capturar no momento do erro

3. Comparar:

• O que o PDV enviou (request)
• O que a integração retornou (response)
   

Solução / Direcionamento

• Validar junto ao fornecedor da integração (ex: Cresce Vendas, Vórtice) o motivo do retorno incorreto (ex: erro 401 – não autenticado)
• Ajustar autenticação, parâmetros ou configuração da integração para adequação ao padrão esperado pela API do PDV

Caso necessário:

• Seguir documentação oficial da API do PDV
• Acionar Fábrica para apoio em implementação/customização

Conclusão

O comportamento não está relacionado a falha no PDV, mas sim à integração externa retornando dados fora do padrão esperado, geralmente por inconsistências de autenticação ou configuração.