Plataforma de Comunicação Elgin versão 3.13.9
Documentação das bibliotecas de integração com hardware Elgin
Gerador PDF

Fornece funções para geração de Danfe NFCe e SAT. Mais...

Funções

int GeraPDFSAT (char *dados_xml, int param)
 Gera PDF Danfe SAT. Mais...
 
int GeraPDFSATCancelamento (char *dados_xml, char *assQRCode, int param)
 Gera PDF Danfe de cancelamento SAT. Mais...
 
int GeraPDFNFCe (char *dados, int indexcsc, char *csc, int param)
 Gera Pdf Danfe NFCe. Mais...
 
int ConfiguraDiretorioSaida (const char *caminho)
 ConfiguraDiretorioSaida - Função usada para configurar o diretório onde serão gerados os pdf.
A estrutura de diretório criado deve seguir conforme a seguir:

‍./DANFE/(SAT ou NFCe)/(VENDA ou CANCELAMENTO)/yyyy/MM/dd/yyyyMMddHHmmss.pdf

onde:

‍yyyy = ANO
MM = MÊS
dd = DIA
hh = HORA
mm = MINUTO
ss = SEGUNDO

Mais...
 
const char * ObtemUltimoArquivo ()
 ObtemUltimoArquivo - Essa função deve ser utilizada para capturar o caminho do ultimo arquivo gerado pelas funções:
GeraPDFSAT
GeraPDFSATCancelamento
GeraPDFNFCe
. Mais...
 
int ImprimePDF (const char *caminho)
 ImprimePDF. Mais...
 

Descrição detalhada

Fornece funções para geração de Danfe NFCe e SAT.

E1 PDF Elgin

O E1 Pdf Elgin é uma solução que fornece para Automação Comercial a possibilidade de gerar Danfes no formato PDF. Essa solução possibilita a geração PDF da danfe para os XML de retornos do SAT (Sistema autorizador transmissor) para as operações de Venda e Cancelamento e também para os XML de retorno de emissão de nota fiscal do contribuinte NFCE. Além de que o usuário pode variar entre layouts diferentes de acordo com a necessidade.

Por onde começar?

Baixe o pacote da solução E1 Pdf Elgin em github.com/elgindevelopercommunity. Através deste pacote, você poderá gerar a danfe em formato pdf se comunicando com a biblioteca (.dll).

Nomenclatura dos arquivos gerados

Os arquivos processados com sucesso são gravados em workdir,
ou em uma pasta definida pela função ConfiguraDiretorioSaida,
ou no caminho definido para variavel de ambiente saida_e1_pdf,
seguindo os detalhes abaixo: ./DANFE/(SAT ou NFCe)/(VENDA ou CANCELAMENTO)/yyyy/MM/dd/yyyyMMddHHmmss.pdf

Convenções usadas nas chamadas das funções da biblioteca:
Windows

‍__stdcall

Linux

‍__cdecl

Funções

◆ GeraPDFSAT()

int GeraPDFSAT ( char *  dados_xml,
int  param 
)

Gera PDF Danfe SAT.

Essa função recebe o XML de retorno da venda do SAT, valida o conteúdo, constrói o Danfe e realiza a geração do pdf de acordo com a especificação da SEFAZ SP.

Parâmetros
dados_xml- Conteúdo do XML de retorno da venda do SAT.
param- Parâmetro do tipo numérico para ativar bits que modificam o cupom a ser impresso.

Os bits disponíveis e seus respectivos efeitos no cupom (quando ativados) são descritos a seguir:
Bit Valor inteiro Efeito no cupom
0 1 Impressão do logo no cabeçalho
1 2 Extrato reduzido
2 4 Cupom em ambiente de teste
6 64 Registro de item com desconto ou acréscimo
e variações no grupo totais
7 128 Imprime usando novo layout
8 256 Ativa separadores no novo layout

O valor passado ao parâmetro deve ser a soma dos valores inteiros correspondentes aos bits desejados.
O valor 0 não ativa nenhum bit e imprime o cupom padrão.
Retorna
O retorno é numérico.
A função bem sucedida deve retornar 0 e o arquivo PDF será salvo conforme definição do caminho de saída.

Informações que não estejam presentes no XML serão desconsideradas.

◆ GeraPDFSATCancelamento()

int GeraPDFSATCancelamento ( char *  dados_xml,
char *  assQRCode,
int  param 
)

Gera PDF Danfe de cancelamento SAT.

Essa função recebe o XML de retorno da operação de cancelamento e os dados de assinatura do QRCode de venda, valida as informações, constrói o Danfe e realiza geração do cupom no formato PDF de acordo com a especificação da SEFAZ SP.

Parâmetros
dados_xml- Conteúdo do XML de cancelamento retornado pelo SAT.
assQRCode- Assinatura do QRCode retornado na operação de Venda. Essa informação é necessária porque o XML de retorno da operação de cancelamento não contém essa informação.
param- Parâmetro do tipo numérico para ativar bits que modificam o cupom a ser impresso.

Os bits disponíveis e seus respectivos efeitos no cupom (quando ativados) são descritos a seguir:
Bit Valor inteiro Efeito no cupom
0 1 Impressão do logo no cabeçalho
6 64 Imprime usando novo layout
7 128 Ativa separadores no novo layout

O valor passado ao parâmetro deve ser a soma dos valores inteiros correspondentes aos bits desejados.
O valor 0 não ativa nenhum bit e imprime o cupom padrão.
Retorna
O retorno é numérico.
A função bem sucedida deve retornar 0 e o arquivo PDF será salvo conforme definição do caminho de saída.
Informações que não estejam presentes no XML serão desconsideradas.

◆ GeraPDFNFCe()

int GeraPDFNFCe ( char *  dados,
int  indexcsc,
char *  csc,
int  param 
)

Gera Pdf Danfe NFCe.

Essa função recebe o conteúdo do XML de venda do NFCe, valida o conteúdo, constrói o Danfe e realiza a geração do mesmo no formato Pdf.

Parâmetros
dados- Conteúdo do XML retornado pela venda.
indexcsc- Identificador do CSC (Código de Segurança do Contribuinte no Banco de Dados da SEFAZ).

‍Deve ser informado sem os “0” (zeros) não significativos. A identificação do CSC corresponde à ordem do
CSC no banco de dados da SEFAZ, não confundir com o próprio CSC.

csc- Código de Segurança do Contribuinte.

‍Corresponde a um código de segurança alfanumérico (16 a 36 bytes) de conhecimento apenas da Secretaria
da Fazenda da Unidade Federada do emitente e do próprio contribuinte. Anteriormente, o código de segurança
CSC era chamado de “Token”.

param- Parâmetro do tipo numérico para ativar bits que modificam o cupom a ser impresso.

Os bits disponíveis e seus respectivos efeitos no cupom (quando ativados) são descritos a seguir:
Bit Valor inteiro Efeito no cupom
0 1 Impressão de extrato resumido
1 2 Utilização do EAN 13 no código dos produtos
2 4 Impressão completa da descrição dos produtos
3 8 Impressão do logotipo da empresa carregado em memória
4 16 Impressão do cupom de homologação
5 32 Redução do espaço de impressão do cupom
6 64 Utilização de separadores de sessão para o cupom
7 128 Impressão do IE no cabeçalho do cupom
8 256 Impressão do número sequencial para cada item
9 512 Impressão em uma via para Danfe em contingência
10 1024 Impressão de acréscimos/descontos por item

O valor passado ao parâmetro deve ser a soma dos valores inteiros correspondentes aos bits desejados.
O valor 0 não ativa nenhum bit e imprime o cupom padrão.
Retorna
O retorno é numérico.
A função bem sucedida deve retornar 0 e o arquivo PDF será salvo conforme definição do caminho de saída.

Informações que não estejam presentes no XML serão desconsideradas.

◆ ConfiguraDiretorioSaida()

int ConfiguraDiretorioSaida ( const char *  caminho)

ConfiguraDiretorioSaida - Função usada para configurar o diretório onde serão gerados os pdf.
A estrutura de diretório criado deve seguir conforme a seguir:

‍./DANFE/(SAT ou NFCe)/(VENDA ou CANCELAMENTO)/yyyy/MM/dd/yyyyMMddHHmmss.pdf

onde:

‍yyyy = ANO
MM = MÊS
dd = DIA
hh = HORA
mm = MINUTO
ss = SEGUNDO

Parâmetros
caminhoParametro para informar caminho raiz onde serão gerados os decumentos.
Observação
O mesmo comportamento pode ser atingido configurando uma variável de ambiente chamada saida_e1_pdf
com o caminho onde deve ser gerado os arquivos.
A prioridade será da configuração será o valor da variavel de ambiente quando a mesma estiver definida.
Retorna
O retorno é numérico.
A função bem sucedida deve retornar 0

◆ ObtemUltimoArquivo()

const char * ObtemUltimoArquivo ( )

ObtemUltimoArquivo - Essa função deve ser utilizada para capturar o caminho do ultimo arquivo gerado pelas funções:
GeraPDFSAT
GeraPDFSATCancelamento
GeraPDFNFCe
.

Retorna
O retorno deve ser o caminho absoluto para o último arquivo gerado.

◆ ImprimePDF()

int ImprimePDF ( const char *  caminho)

ImprimePDF.

Função utilzada para realizar a impressão da Danfe PDF gerado pela biblioteca E1_Pdf na impressora padrão configurada no sistema operacional.

Parâmetros
caminho- Parâmetro que recebe o caminho absoluto da Danfe PDF a ser impressa.
Retorna
O retorno é numérico.
A função bem sucedida deve retornar 0 Para mais informações sobre retorno consulte PDF_Error.