O Componente NFC-e Linux da Tecnospeed é uma aplicação projetada para simplificar a emissão da Nota Fiscal de Consumidor Eletrônica (NFC-e). Este componente oferece uma biblioteca de comunicação altamente eficiente, que torna a integração da NFC-e uma tarefa descomplicada para os clientes.
Para começar a usar este componente em seu aplicativo, basta instanciá-lo em seu projeto e implementar os métodos necessários de acordo com suas necessidades específicas. Este artigo fornece todas as informações necessárias para baixar o componente e orienta você na implementação de métodos para emitir e imprimir notas fiscais eletrônicas de forma incrivelmente simples.
Siga os passos fornecidos aqui para facilitar o processo de emissão de NFC-e em sua aplicação Linux.
1. Instalação - Componente NFC-e Linux
2. Instanciar - Componente NFC-e Linux
3. Propriedades - Componente NFC-e Linux
4. Métodos - Componente NFC-e Linux
Configurações
Fluxo de Emissão
Utilitários
Impressão
1. Instalação - Componente NFC-e Linux
a) Conta TecnoAccount
O primeiro passo, é realizar a criação da sua Conta TecnoSpeed. Ela permite gerenciar as configurações e ferramentas para acessar os nossos produtos e serviços em um único lugar, de forma simples e fácil.
Após se cadastrar, você poderá visualizar o seu Token. Juntamente com o seu CNPJ ou CPF, este Token será utilizado para se autenticar na maioria de nossos serviços.
O Token juntamente com o CNPJ ou CPF será utilizado no método configurarSoftwareHouse, onde você deve passar ambos como parâmetro, eles também servem para autenticar a requisição caso utilize nossa API para o envio das informações.
Acesse a sua Conta TecnoSpeed >
b) Download da versão
Para realizar o download da versão do Componente NFCe Linux, basta acessar a Central do Cliente utilizando o cadastro realizado no passo anterior.
2. Instanciar - Componente NFC-e Linux
Finalizado a instalação do componente em seu ambiente, agora é necessário realizar a instanciação da classe utilizando nossa biblioteca de integração.
SDK NFC-e Javascript
Comece realizando o download do pacote no portal do cliente e realize a instalação desse pacote por arquivo
npm install file:componente-nfce-sdk-1.0.0.tgz
Após isso importe nosso pacote no seu projeto, assim você terá acesso à classe.
const {TspdNFCe} = require('componente-nfce-sdk')
//ou
import {TspdNFCe} from 'componente-nfce-sdk'
Com o import realizado, você pode criar uma instância da classe como mostrado abaixo:
// Cria uma instância do objeto TspdNFCe.
TspdNFCe nfce = new TspdNFCe();
SDK NFC-e Python
Importe nosso pacote para seu projeto, assim terá acesso à classe.
from tecnospeed.sdk.tspd_nfce import TspdNFCe
Com o pacote importado em seu projeto, você pode criar uma instância da classe como mostrado abaixo:
nfce = TspdNFCe()
SDK NFC-e Ruby
Acesse o portal do cliente, encontre o pacote e realize o download.
gem install tspd-nfce-0.0.0.gem
Após isso faça o require do nosso pacote no seu projeto, assim você terá acesso à classe.
require 'tspd-nfce'
Com o require realizado, você pode criar uma instância da classe como mostrado abaixo:
// Cria uma instância do objeto TspdNFCe.
nfce = TspdNFCe.new
SDK NFC-e PHP
Acesse o portal do cliente, encontre o pacote e realize o download.
Após isso faça o require do nosso pacote no seu projeto, assim você terá acesso à classe.
use Tecnospeed\SdkPhpComponenteNfce\TspdNFCe;
require 'vendor/autoload.php';
Com o require realizado, você pode criar uma instância da classe como mostrado abaixo:
// Cria uma instância do objeto TspdNFCe.
$nfce = new TspdNFCe();
3. Propriedades - Componente NFC-e Linux
Para preparar o componente, podemos ajustá-lo usando as configurações listadas na tabela abaixo.
|
Nome na classe (Javascript) |
Nome na classe (Python, Ruby) |
Nome na classe (PHP) |
Descrição | Valor |
| UF | uf | setUf | UF do Emitente da NFC-e | UF.PR ou 'PR' |
| VersaoManual | versao_manual | setVersaoManual | Versão de Manual da Nota Técnica | VersaoManual.vm60 ou 'vm60' |
| Ambiente | ambiente | setAmbiente | Servidor com o qual deverá interagir (Homologação ou Produção) | Ambiente.HOMOLOGACAO, Ambiente.PRODUCAO ou 'PRODUCAO', 'HOMOLOGACAO' |
| CNPJ | cnpj | setCnpj | CNPJ do Emitente da NFC-e | 88895624000165 |
| IdTokenCSC | id_token_CSC | setIdTokenCSC |
Código sequencial de identificação (IdToken) de 6 dígitos associado ao Token, para facilitar a identificação do respectivo token e validação do QR Code pelo Fisco quando da realização da consulta pelo consumidor. |
000001 |
| TokenCSC | token_CSC | setTokenCSC | Token correspondente a um código de segurança alfanumérico de conhecimento apenas da Secretaria da Fazenda do Estado do emitente e do próprio contribuinte. Garante a autoria do DANFCE NFC-e e do respectivo QR Code, pois somente o Fisco e o contribuinte emissor conhecem o valor válido do token para aquela empresa no Estado. | |
| CaminhoCertificado | caminho_certificado | setCaminhoCertificado | Configuração do caminho completo do arquivo do certificado digital | Caminho completo do arquivo .pfx |
| SenhaCertificado | senha_certificado | setSenhaCertificado | Senha do certificado digital | |
| NomeImpressora | nome_impressora | setNomeImpressora |
Nome da fila da impressora configurada no CUPS |
ELGIN_I9 |
| DiretorioImpressao | diretorio_impressao | setDiretorioImpressao |
Diretório completo onde será salvo os arquivos PDF de impressão |
/home/usr/meuapp/impressao |
| DiretorioXmlDestinatario | diretorio_xml_destinatario | setDiretorioXmlDestinatario |
Diretório completo onde estão contidos os XMLs de destinatário autorizados/cancelados usados para impressão de NFC-e, e também XMLs destinatários de inutilização. |
/home/usr/meuapp/xmldestinatario |
| DiretorioLog | diretorio_log | setDiretorioLog |
Diretório completo onde serão gravados os XMLs de comunicação com a SEFAZ (envios e retornos), e também os logs de licença do produto |
/home/usr/meuapp/log |
4. Métodos - Componente NFC-e Linux
A biblioteca de integração possui os seguintes métodos que faz a mensageria de comunicação com a SEFAZ, segue abaixo os métodos:
Configurações
Fluxo de Emissão
Utilitários
Impressão
Arquivo de Integração
Nossa forma de integração é através de um arquivo de texto conhecido como TX2, que é um padrão de comunicação criado pela TecnoSpeed. Esta será a forma de integração para gerar o xml da NFC-e e realizar o envio.
Para mais informações sobre como gerar esse arquivo de integração acesse aqui.
Comentários
0 comentário
Por favor, entre para comentar.