Pular para conteúdo

Formas de Integração

Integração Windows/Linux

O InvoiCy Framework Windows/Linux é desenvolvido em linguagem C/C++ e portanto, não depende de frameworks de terceiros para ser utilizado em seu aplicativo, possibilitando a integração em qualquer linguagem de programação e plataforma que possua recursos para carregamento de bibliotecas em tempo de execução.

Uma vez que o InvoiCy Framework tenha sido instanciado, seus parâmetros de operação devem ser configurados. Só então estará pronto para realizar emissões, envios de eventos e consultas.

É importante que o InvoiCy Framework seja mantido carregado durante todo o tempo de execução do Aplicativo Comercial, pois o envio de documentos emitidos em contingência off-line é processado em background.

A lista abaixo indica os métodos e parâmetros mínimos para realizar emissão de documentos fiscais, envio de eventos e consultas.

  • InvoiCyFramework_AmbienteEmissao
  • InvoiCyFramework_ConfiguraInvoicy
  • InvoiCyFramework_EmiteDocumento

Para realizar a impressão automática do DANFE, acrescente:
InvoiCyFramework_Configura → configure o parâmetro IMPRESSORA_CANAL

Para possibilitar que o Framework realize emissões em contingência, acrescente:
InvoiCyFramework_Configura → configure o parâmetro TIPO_CONTINGENCIA

Integração Android

O InvoiCy Framework Android é desenvolvido em Java e disponibilizado através de um arquivo AAR. Ele é compatível com SDK 24 e superiores.

Para integrar o Framework Android em seu aplicativo, é necessário importar o AAR no projeto e implementar a chamada dos métodos. O FW possui algumas interfaces para utilização de recursos controlados pelo aplicativo principal - gravação de logs, impressão, etc.

A implementação destas interfaces é opcional, porém recomenda-se fortemente a implementação da interface para gravação de logs:

Interface LogIFW
Configure esta interface chamando ConfiguraLogCallback, conforme exemplificado:

//Exemplo//
invoiCyFramework.ConfiguraLogCallback(meuMetodo);


//Implementação//
public class LogGer implements LogIFW {
     public void Loga(String local, String mensagem) {
     }
}

Interface InterfaceImpressora
Configure esta interface chamando ConfiguraInterfaceImpressora, conforme segue:

//Exemplo//
invoiCyFramework.ConfiguraInterfaceImpressora(meuMetodo);


//Implementação//
public class Impressora implements InterfaceImpressora {
     public boolean ImprimeImagem(Bitmap bitmap) {
     }
}

Interface InterfaceElginMinipdv
Configure a interface chamando ConfiguraInterfaceElginMinipdv, conforme segue:

//Exemplo//
invoiCyFramework.ConfiguraInterfaceElginMinipdv(meuMetodo);


//Implementação//
→ consulte os app´s de exemplo

Caso seja de interesse implementar o uso da biblioteca Elgin para integração com produtos da marca, será necessário implementar a Interface InterfaceElginMinipdv, inicializando recursos necessários para a biblioteca Elgin antes de configurar este recurso no Invoicy Framework, tal como exemplificado a seguir:

public class PrinterServiceElginMiniPDV implements
InterfaceElginMinipdv {

      // Implementação de interface

}
printerServiceElginMiniPDV = new
PrinterServiceElginMiniPDV();
printerServiceElginMiniPDV.setActivity(activityPrincipal);
printerServiceElginMiniPDV.printerStart();

Logo após a implementação da interface PrinterServiceElginMiniPDV, será necessário configurar o Framework para utilizá-la, como demonstrado a seguir:

invoiCyFramework.ConfiguraInterfaceElginMinipdv(meuMetodo);

Também será necessário configurar o parâmetro IMPRESSORA_CANAL com o valor "ELGINM10" para que o Framework Android faça uso dos recursos da biblioteca Elgin. Os métodos e interfaces do InvoiCy Framework Android estão implementados nas seguintes classes:

  • com.migrate.gerentedocumento.InvoiCyFramework
  • com.migrate.gerentedocumento.
  • com.migrate.gerentedocumento.InterfaceImpressora

Recomenda-se que seja verificada a existência de documentos pendentes de sincronização com o InvoiCy ao final da operação (por ex. fechamento de turno, fechamento de caixa, fechamento de dia, etc.) e, caso houverem, realizar os procedimentos para garantir a sincronização.

A seguinte lista indica os métodos e parâmetros mínimos para realizar emissão de documentos fiscais, envio de eventos e consultas:

  • InvoiCyFramework_AmbienteEmissao
  • InvoiCyFramework_ConfiguraInvoicy
  • InvoiCyFramework_EmiteDocumento

Para realizar a impressão automática do DANFE, acrescente:
InvoiCyFramework_Configura → configure o parâmetro IMPRESSORA_CANAL

Para possibilitar que o Framework realize emissões em contingência, acrescente:
InvoiCyFramework_Configura → configure o parâmetro TIPO_CONTINGENCIA