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. Acesse aqui para realizar o download do componente.

Uma vez que o 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.

Recomenda-se também 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 lista abaixo indica os métodos e os parâmetros mínimos para realizar emissão de documentos fiscais, envio de eventos e consultas:

  • InvoiCyFramework_AmbienteEmissao;

  • InvoiCyFramework_ConfiguraInvoicy;
  • InvoiCyFramework_EmiteDocumento;
  • InvoiCyFramework_Configura.

Para realizar a impressão automática do DANFE, acrescente:
"InvoiCyFramework_Configura" - Configure o parâmetro EMITIR_MFE

Para possibilitar que o Framework realize emissões em contingência, acrescente:
"InvoiCyFramework_ConfiguraSAT" (somente quando for a UF São Paulo) ou InvoiCyFramework_Configura

Para possibilitar que o Framework realize emissões através do Módulo Fiscal Eletrônico - MFE, quando obrigatório:

  • InvoiCyFramework_ConfiguraMFE;

  • InvoiCyFramework_Configura.

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. Acesse aqui para realizar o download do componente.

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.LogIFW;
  • com.migrate.gerentedocumento.InterfaceImpressora.

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.

Recomenda-se também 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_ConfiguraSAT" (somente quando for a UF São Paulo) ou InvoiCyFramework_Configura - Configure o parâmetro TIPO_CONTINGENCIA