Integração DLL

A Oobj produziu uma solução para integração com outros sistemas via DLL, o fluxo é simples, a DLL recebe as informações do pedido e repassa ao periférico para emissão através da integração HTTP, após isso o periférico desempenha completamente o fluxo de emissão, impressão e retorno das informações para a DLL. O fluxo a seguir mostra detalhadamente o processo.

Para ativar a integração via DLL no DF-e Client acesse nosso artigo:

• Como configurar a Integração via DLL no DFe Client?

Acesse nosso artigo Integração HTTP Local  para mais detalhes da integração via rest.

A dll fornecida é compilada para uso em sistemas de arquitetura x86 (32 bits) e os contratos para operação são listados abaixo.

A integração via DLL fornece as operações fiscais básicas, são elas:

• Emissão
• Cancelamento
• Reimpressão
• Impressão de texto livre
• Acompanhamento de Processamento do Lote

Todas as chamadas de DLL tem um retorno de método e regrava um ponteiro na variável _Response com o valor 0 ou 1.

• 0 indica sucesso na operação;
• 1 indica falha.

Emissão

Método para emissão de notas fiscais em NF-e ou CF-e dependendo da configuração do DF-e Client.

• Assinatura do método:

int Emissao(char* _DadosVendas, char* _Response, char* _respostaSefaz);

• Parâmetros:

char* _DadosVenda : //Ponteiro com o conteúdo da venda no layout definido.
char* _Response : //Ponteiro onde será gravado o código de resultado da operação (0 ou 1)
char* _respostaSefaz : //Ponteiro onde será gravado o retorno da emissão no layout definido

• Exemplo de conteúdo retornado em caso de sucesso:

A|1627|S|104|Lote processado|43|
B|43160607385111000102650010094984911816177991|1|9498491|2016-06-02T17:15:11|100|Autorizado o uso da NF-e|||143160000652019|o8aKCAfuaJcfRd9hgFY3oo8NwfA=|

• Exemplo de conteúdo retornado em caso de falha:

A|1627|O|5215|Rejeição: arquivo com conteúdo inválido: Não existem configurações para o CNPJ '07385111000103'. Configure-o antes de enviar arquivos.||

Cancelamento

Método para cancelamento de NFC-e ou CF-e dependendo da configuração do DF-e Client emitido.

• Assinatura do método:

int CancelarNota(char* chaveAcesso, char* protocolo, char* justificativa, char* cpfCnpjDestinatario, char* _Response, char* _respostaSefaz)

• Parâmetros:

char* chaveAcesso : //Array de caracteres contendo a chave de acesso da nota a ser cancelada
char* protocolo : //Array de caracteres contendo o protocolo de autorização 
char* justificativa : //Array de caracteres contendo a justificativa para cancelamento da nota de acordo com as regras da sefaz
char* cpfCnpjDestinatario : //Array de caracteres contendo o CPF ou CNPJ do destinatário presente na emissão, este atributo só é relevante para cancelamneto de CF-e.
char* _Response : //Ponteiro onde será gravado o código de resultado da operação (0 ou 1)
char* _respostaSefaz : //Ponteiro onde será gravado o retorno do cancelamento no layout definido

• Exemplo de conteúdo retornado em caso de sucesso:

RETEVENTO|1.00|4153|
A|2|RSnfce201601161016|43|135|Evento registrado e vinculado a NF-e|43160607385111000102650010094984911816177991|110111|Cancelamento|1|
B|||2016-06-03T14:37:03-03:00|143160000653628|

• Exemplo de conteúdo retornado em caso de falha:

RETEVENTO|1.00|4146|
A|2|||5215|Rejeição: arquivo com conteúdo inválido|||||

Reimprimir

Este método solicita a reimpressão de uma nota fiscal já emitida no tipo de ambiente (Produção ou Homologação) em que o DF-e Client estiver configurado.

• Assinatura do método:

int ReImprimir(char* chaveAcesso, char* _Response);

• Parâmetros:

char* chaveAcesso : //Array de caracteres contendo a chave de acesso da nota a ser cancelada
char* _Response : //Ponteiro onde será gravado o código de resultado da operação (0 ou 1), importante destacar que o resultado desta operação se refere ao fato de conseguir solicitar a reimpressão, a mesma é assíncrona e portanto acontecerá fora desta chamada

Impressão (Texto Auxiliar)

Método para encaminhar uma impressão de qualquer texto para a impressora padrão do DF-Client, útil em algumas integrações para imprimir coisas como o comprovante de pagamento.

• Assinatura do método:

int Imprimir(char* conteudo, char* _Response);

• Parâmetros:

char* conteudo : //Array de caracteres com o que será enviado para a impressora, o conteúdo deve estar formatado com os tamanhos devidos.
char* _Response : //Ponteiro onde será gravado o código de resultado da operação (0 ou 1)