Manuais:UniDANFE/Integrando o UniDANFE ao ERP/MetodosDLL
Métodos da UNIDANFE_DFE.DLL
Essa é a forma mais elegante que os sistemas ERP usarão para gerar o Documento Auxiliar.
A UNIDANFE_DFE.DLL deve ser linkada ao sistema ERP, que fará a integração utilizando o conjunto de métodos disponíveis na biblioteca.
| Método | Parâmetros | Descrição | Exemplos | Retorno |
|---|---|---|---|---|
| DFEINIT | (STRING Ação)
Ação a ser executada. |
Inicializa a ação. Válidos:
|
dfeInit("dfe")
dfeInit("configurar") |
|
| DFESETPARAMETRO | (STRING Parâmetro, STRING Valor)
Parâmetro: nome ou abreviação do parâmetro a ser passado ao UniDANFE. Idênticos aos usados na integração via chamadas (RUN) ao UniDANFE.exe. NOTA: todos os parâmetros devem ser escritos em sua forma completa e não na forma abreviada. Valor: valor do parâmetro |
Passa os parâmetros de geração, impressão e distribuição do DFE.
Deve-se escrever uma chamada à esse método para cada parâmetro a ser enviado. |
dfeSetParametro("arquivo", "c:\Unimake\Uninfe\0101010101010101010101-procNFe.xml")
dfeSetParametro("imprimir", "0") dfeSetParametro("copias", "2") dfeSetParametro("email", "[email protected]") |
|
| DFEEXECUTA | Executa a ação, gerando o DFE.
Esse método deve ser chamado após a passagem de todos os parâmetros. |
dfeSetParametro('arquivo', 'meuarquivo.xml')
dfeExecuta() |
||
| DFEGETERRO | Retorna o erro ocorrido na geração, ou em branco se tudo correu bem.
Nota: se não for possível ler o retorno desse método, utilizar a forma de leitura de erros em arquivo. Para isso, enviar os parâmetros: dfeSetParametro("saidaerros", "A") -> desvia a saída de erros para arquivo dfeSetParametro("arquivoerro", arquivo) -> define o arquivo de erros que deverá ser criado caso algum erro aconteça. |
dfeExecuta()
IF dfeGetErro() = ""
MESSAGE("O documento auxiliar foi gerado com sucesso!")
ELSE
MESSAGE(dfeGetErro())
END
|
STRING
| |
| DFEKILL | Finaliza a ação, liberando a memória utilizada. | dfeKill() |
|
Exemplos:
- Gerar documento auxiliar:
dfeInit("dfe")
dfeSetParametro("pastaconfiguracao", "c:\uninfe\unidanfe") ##------- pasta onde a pasta "dados" do UniDANFE se encontra
dfeSetParametro("arquivo", "c:\Unimake\Uninfe\0101010101010101010101-procNFe.xml")
dfeSetParametro("logotipo", "c:\Unimake\Uninfe\minha-logo.png")
dfeSetParametro("imprimir", "1")
dfeSetParametro("impressora", "Samsung SL-M4080FX")
dfeSetParametro("visualizar", "0")
dfeSetParametro("copias", "2")
dfeSetParametro("saida_erros", "N") ##------- Nenhum erro será gerado na tela ou em arquivo. Vamos pegá-lo usando o método dfeGetErro()
dfeSetParametro("email", "[email protected]")
dfeExecuta()
IF dfeGetErro() = ""
MESSAGE("O documento auxiliar foi gerado com sucesso!")
ELSE
MESSAGE(dfeGetErro())
END
dfeKill()
- Exibir a interface de configuração do UniDANFE:
dfeInit("configurar")
dfeExecuta()
dfeKill()
Alguns métodos usando o tipo BSTRING no lugar de STRING. Utilizado em algumas linguagens que não conseguem enviar o tipo STRING.
| Método | Parâmetros | Descrição | Exemplos | Retorno |
|---|---|---|---|---|
| DFEINITB | (BSTRING Ação) | Idêntico ao método DFEINIT(). | dfeInitB("dfe") | |
| DFESETPARAMETROB | (BSTRING Parâmetro, BSTRING Valor) | Idêntico ao método DFESETPARAMETRO(). | dfeSetParametroB("arquivo", "c:\Unimake\Uninfe\010101010101-procNFe.xml") |
32/64 bits
A linguagem de programação utilizada na criação do UniDANFE ainda não dispõe de compilação para 64 bits. Por enquanto apenas a versão 32 bits da DLL está disponível.
