Início > Dúvidas frequentes

Desenvolvedores

Central de Suporte para Desenvolvedores

Quais linguagens de programação são compatíveis com a IT4R?

Linguagens como C#, Delphi, VB.NET, PHP (via extensões), Java (via extensões) e C++ são amplamente utilizadas para integrar com DLLs de impressoras.

É necessário instalar drivers específicos para que a IT4R.dll funcione corretamente?

Se está utilizando impressora compativel à IT4R, dependendo da marca é preciso instalar o driver da porta USB(COM virtual). Verifique as instruções sobre o modelo e marca utilizado.

É possível usara IT4R em sistemas Web?

Não a IT4R foi feita para rodar localmente no PDV, e por enquanto não possui recurso para uso Online.

Como lidar com erros retornados pela IT4R?

Recomenda-se sempre capturar e interpretar os códigos de erro retornados pelas funções da DLL, e exibir mensagens amigáveis ao usuário.

É possível imprimir imagens ou logotipos usando a IT4R?

Sim, a versão Windows/Linux imprime BMPs monocromaticos de até 200 pixels de altura (iImprimirBMP). Já na versão Android, dependendo do equipamento pode imprimir imagens maiores e de outros tipos não necessitando (imprimirImagem)

DLLs funcionam em ambientes de 32 e 64 bits?

Algumas DLLs são específicas para 32 ou 64 bits. É importante utilizar a versão compatível com a arquitetura do seu sistema e não conforme o Sistema Operacional.

O que é a NFC-e?

A Nota Fiscal ao Consumidor eletrônica (NFC-e), identificada tecnicamente como Nota Fiscal modelo 65, é um documento digital que substituiu o Cupom Fiscal emitido por impressoras fiscais (ECF).

Qual é a principal diferença técnica entre a NFC-e e o SAT ( Sistema Autenticador e Transmissor de Cupons Fiscais Eletrônicos de São Paulo)?

A principal diferença é que a NFC-e não exige um equipamento de hardware específico (como o SAT). A aplicação comercial gera o XML, envia-o para a SEFAZ e permite a impressão do DANFE em qualquer impressora comum.

Como a IT Fast auxilia no processo de assinatura e entrega dos arquivos XML?

A biblioteca cuida da montagem do arquivo XML e, através da parceria com a Migrate (serviço Invoicy), realiza a assinatura digital e a entrega técnica dos arquivos à SEFAZ.

Quais são os três elementos essenciais para começar a testar a emissão de NFC-e com a IT Fast?

É necessário um cadastro na Migrate (para obter Chaves de Parceiro e Acesso), um Certificado Digital do Tipo A1 e um Token SEFAZ (CSC).

O que é o CSC (Token SEFAZ) e onde ele deve ser obtido?

É o Código de Segurança do Contribuinte. Ele deve ser obtido no portal da SEFAZ do estado (UF) ao qual pertence o CNPJ do emitente.

Os dados de teste (Token e cadastro) podem ser usados em ambiente de Produção?

Não. Os dados e o CSC obtidos para o ambiente de Homologação/Testes só têm validade para esse ambiente específico. Para Produção, é necessário um novo CSC, compatível ao ambiente de Produção.

Para que serve o arquivo DarumaFramework.xml?

Ele define o produto utilizado (NFCE, SAT ou DUAL), a impressora conectada e as configurações gerais de funcionamento e auditoria da biblioteca IT4R.

Qual tag no GNE_Framework.xml deve ser preenchida com a chave do parceiro obtida na Migrate?

A tag CONFIGURACAO\EmpPK.

Quais marcas de impressoras térmicas são suportadas pela IT4R?

Daruma (DR700-e/ DR800), Epson (TM-T20X, TM-T20, TM-T81_versão S.B. 1.00, TMT88 e TMT88 VII), Bematech (MP4200 TH) e Elgin (i9 - versão S.B. CV2.00.09, i8 e i7), Transire (Q4).

Qual é o tipo de dado retornado pelos comandos da biblioteca IT4R para indicar sucesso ou erro?

Todo comando retorna um valor inteiro (Integer).

Como deve ser configurada a tag CONFIGURACAO\TipoAmbiente para realizar testes?

Deve ser configurada com o valor 2 (Homologação). O valor 1 é utilizado apenas para o ambiente de Produção.

Por que é importante tratar o retorno dos métodos iniciados por "t..." e alguns por "r..."?

Porque esses comandos geram comunicação direta com o WebService e podem retornar diversos status (como problemas de conexão ou rejeições) que precisam ser tratados logicamente pelo sistema.

O que significa o retorno de erro -130 no método de abertura de venda (aCFAbrir_NFCe_Daruma)?

Indica que já existe uma venda aberta no sistema que ainda não foi encerrada ou cancelada.

Qual comando pode ser utilizado para visualizar a mensagem detalhada de erro do WebService após uma falha?

O comando rAvisoErro_NFCe.

O que a configuração NFCE\AvisoContingencia = 2 muda nos retornos da biblioteca IT4R?

Ela permite obter retornos mais precisos no encerramento da nota, detalhando se a emissão ocorreu em contingência ou se houve salto de numeração.

Qual é a diferença no campo tpEmis do XML entre uma venda Online e uma Offline (Contingência)?

Na venda Online, o tpEmis é 1. Na venda Offline (Contingência), o valor é preenchido com 9.

O que caracteriza a "Contingência Online" na solução IT Fast/Migrate?

Ocorre quando o servidor da SEFAZ está instável ou fora do ar, mas a comunicação entre a biblioteca IT4R e o serviço da Migrate continua funcionando.

O que é o "Timeout" de comunicação configurado na biblioteca?

É o tempo limite (definido na chave NFCE\TimeOutWS, padrão 10 segundos) que a biblioteca aguarda por uma resposta do serviço antes de considerar a comunicação falha e sugerir a contingência.

Ao simular "SEFAZ Fora" no painel da Migrate, qual retorno de encerramento indica Contingência Online com salto de numeração?

O retorno de valor [4] - desde que habilitada a chave AvisoContingencia com valor 2.

Qual retorno indica que a emissão foi feita em Contingência Offline (gravada localmente) após um Timeout?

Quando o Aviso Contingência está habilitado: O retorno [5] (com salto de numeração) ou o retorno [2] (sem salto, para as vendas seguintes no mesmo estado).

. O que acontece com a primeira venda realizada após o restabelecimento do serviço (voltar ao modo Online)?

A primeira venda ainda será gerada como contingência (tpEmis = 9) e impressa em duas vias para garantir a segurança, mas o retorno de encerramento voltará a ser 1 (Sucesso).

Onde os dados de uma nota emitida em "Contingência Offline" ficam armazenados ?

Eles ficam gravados localmente no disco (HD) do pdv.

Qual é o código de retorno da SEFAZ que confirma que a nota foi autorizada com sucesso?

É o código [100] - Autorizado o uso da NF-e (visualizado via o comando rAvisoErro_NFCe).

Como realizar o cancelamento de uma nota já autorizada pela DLL?

Utilizando o método tCancelaNFCe (serve para NFC-eou NF-e), informando número da nora, série, chave de acesso e o protocolo, além de uma justificativa para o cancelamento.

Como configurar o ambiente (Homologação ou Produção) na DLL?

Através do método de configuração (regAlterarValor_NFCe), definindo o parâmetro TipoAmbiente. Onde 1 = Produção e 2 = Homologação.

A IT4R suporta transações de PIX via TEF?

Sim, as versões atualizadas permitem o tratamento de QR Code dinâmico no PinPad ou tela 9de acordo com a TEF House).

Como o desenvolvedor recebe os dados para imprimir o comprovante TEF do cliente e do estabelecimento?

A DLL retorna as linhas do comprovante em strings prontas para a bobina térmica.

Qual a vantagem de usar o TEF via IT4R em vez de uma integração direta proprietária?

A abstração da complexidade: a IT4R padroniza os comandos, não importando se o cliente usa SITEF, Conexão Tech, Safra Pay ou outros.

x