SopagueDocs
v3

Habilita ou desabilita o aplicativo VENDER para realização de vendas, por meio de aplicações externas no POS Android.

Integração via Intent Android (startActivityForResult). Suporte a modo automático (sem interface gráfica) e modo manual (com interface gráfica).

Pré-requisitos

  • POS compatível com aplicativo Vender instalado
  • Sistema operacional Android 4.4 (KitKat) ou superior
  • Permissão de uso de startActivityForResult
  • Permissão de integrar com o aplicativo do lojista (processo/negócio — confirme com seu contato)

Contrato da Integração

Action

ParâmetroValor
Actioncom.sopague.TOGGLE_SALES

Extras Opcionais

Resposta da Activity

Exemplos de Integração

Modo Manual (com interface gráfica)

Exibe a tela de confirmação para o lojista escolher:

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

Modo Automático — Ativar Vendas

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

Modo Automático — Desativar Vendas

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

Processando a Resposta

@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)