Habilitar ou desabilitar aplicativo VENDER

Este documento explica como habilitar ou desabilitar o aplicativo VENDER para realização de vendas, por meio de aplicações externas.

Visão Geral

• Integração via Intent Android (startActivityForResult).
• Suporte a modo automático (sem interface gráfica) e modo manual (com interface gráfica).
• Retorno do estado das vendas via método onActivityResult.

Pré-requisitos

• POS compatível com aplicativo Vender instalado.
• Sistema operacional Android 4.4 (KitKat) ou superior.
• Permissão de uso de startActivityForResult.
• Ter permissão de integrar com o aplicativo do lojista. Este ponto é de processo/negócio e não técnico — confirme com seu contato.

Contrato da Integração

Action

Parâmetro	Valor
Action	com.sopague.TOGGLE_SALES

Extras Opcionais

Parâmetro	Tipo	Descrição
enabled	boolean	Controla o estado das vendas de forma automática. Se omitido, exibe a interface gráfica para o usuário escolher manualmente.

Valores para enabled:

• true: ativa as vendas automaticamente (sem interação do usuário)
• false: desativa as vendas automaticamente (sem interação do usuário)
• Se omitido: exibe a interface gráfica para o usuário escolher manualmente

Comportamento Esperado

• Modo automático (com extra enabled): o app processa a solicitação imediatamente, salva o estado e retorna o resultado sem exibir UI
• Modo manual (sem extra enabled): o sistema abre a tela de alternância de vendas onde o usuário escolhe ativar ou desativar

Resposta da Activity

A Activity retorna um resultado via setResult() com os seguintes extras:

Parâmetro	Tipo	Descrição
SALES_ENABLED	boolean	Estado final das vendas (true = ativo, false = inativo)
SUCCESS	boolean	Indica se a operação foi bem-sucedida
CANCELLED	boolean	Presente apenas se o usuário cancelou a operação (modo manual)

Exemplos de Integração

Modo Manual (com interface gráfica)

Será exibida a tela de confirmação para o lojista escolher se deseja habilitar ou desabilitar o aplicativo VENDER:

Intent intent = new Intent("com.sopague.TOGGLE_SALES");
startActivityForResult(intent, 1002);

Modo Automático (sem interface gráfica)

Para ativar ou desativar as vendas automaticamente, sem exibir a tela ao usuário:

Ativar vendas:

Intent intent = new Intent("com.sopague.TOGGLE_SALES");
intent.putExtra("enabled", true);
startActivityForResult(intent, 1002);

Desativar vendas:

Intent intent = new Intent("com.sopague.TOGGLE_SALES");
intent.putExtra("enabled", false);
startActivityForResult(intent, 1002);

Processando a resposta

O resultado da operação será retornado via onActivityResult:

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    
    if (requestCode == 1002 && resultCode == RESULT_OK && data != null) {
        boolean success = data.getBooleanExtra("SUCCESS", false);
        boolean salesEnabled = data.getBooleanExtra("SALES_ENABLED", false);
        
        if (success) {
            String status = salesEnabled ? "ativadas" : "desativadas";
            Log.d(TAG, "Vendas " + status + " com sucesso!");
        }
    } else if (requestCode == 1002 && resultCode == RESULT_CANCELED) {
        Log.d(TAG, "Operação cancelada pelo usuário");
    }
}

Considerações Finais

• O aplicativo Vender deve estar instalado no dispositivo POS.
• No modo automático, a operação é processada imediatamente sem interação do usuário.
• No modo manual, o usuário pode cancelar a operação, retornando CANCELLED como true.
• Extras de retorno possíveis:
  • SALES_ENABLED → Estado final das vendas (true = ativo, false = inativo).
  • SUCCESS → Indica se a operação foi bem-sucedida.
  • CANCELLED → Presente apenas se o usuário cancelou a operação (modo manual).

---

Para dúvidas ou problemas, acesse a seção de suporte no Sopague.