Para facilitar a integração de sistemas em PHP com o Focus NFe criamos um pequeno exemplo que mostra como a integração é simples. Basta montar o arquivo em nosso formato simplificado (clique aqui para conhecer) e mandar para nosso web service que nós fazemos o resto.

Faça o download do exemplo clicando aqui.

Para conhecer outras formas de integrar seu sistema com o Focus NFe visite os links abaixo:

API para integrar seu sistema com o módulo web do Focus NFe

Utilizando o comunicador por arquivo.

Desta forma decidimos escrever um artigo dando a visão Fiscal de como deve ser uma troca em um estabelecimento comercial e os erros mais comuns entre sistemas comerciais.

Natureza técnica de uma impressora fiscal

As impressoras fiscais são equipamentos cercados de proteções contra sonegação fiscal, estes equipamentos seguem normas rígidas e passam por homologações bastante criteriosas antes de poderem ser vendidas como Emissor de Cupom Fiscal.

Uma das diversas regras implementadas em uma impressora fiscal diz que ela não pode, sob nenhuma hipótese, cancelar um cupom fiscal que não seja o último emitido.

Controle do estoque e descontos absurdos

É obrigação do lojista e, consequentemente de seu sistema, controlar o estoque, de forma que entradas de produtos por devolução devem ser informados ao sistema.

Outra regra trata da proibição de descontos absurdos em mercadorias. Não se pode dar desconto de 100% por exemplo sem um bom motivo, uma eventual fiscalização iria questionar descontos muito grandes e muito frequentes. Desta forma não se pode colocar os produtos devolvidos como forma de desconto.

Nota Fiscal de Entrada

Ora, se não é possível cancelar um cupom fiscal antigo e também não se pode inserir descontos de muito grandes, então a loja terá que pagar o imposto duas vezes quando houver troca? Não! A loja deverá emitir uma nota fiscal de entrada. Veja o que diz a lei:

“O artigo 148, inciso I do RICMS/PR traz que o contribuinte, exceto o produtor rural inscrito no CAD/PRO, deve emitir nota fiscal de entrada no momento em que entrarem em seu estabelecimento, real ou simbolicamente, bens ou mercadorias novos ou usados, remetidos a qualquer título por produtores agropecuários ou pessoas físicas ou jurídicas não obrigados à emissão de documentos fiscais.”

Ou seja, independente do motivo, da forma ou do volume, deve-se emitir nota fiscal de entrada quando receber mercadoria de quem não emite nota fiscal.

Como é o Focus Lojas

No Focus Lojas uma venda pode possuir itens devolvidos pelo seu cliente, porém, para contemplar todas as regras fiscais acima,  o sistema emite o cupom fiscal da saída normalmente, sem descontos e sem indicar os itens devolvidos. O sistema apenas informa que uma das formas de pagamento foi com créditos (aqueles conseguidos com a devolução de mercadorias).

A nota a ser emitida deve ser de modelo 1 ou 1-A e o CFOP a ser utilizado será o 1.202 (para mercadorias sem substituição tributária ) ou 1.411 (para mercadorias com substituição tributária). A emissão da nota de entrada é de obrigação do lojista e pode ser feita de várias formas:

• Bloco de nota: Utilizando um bloco de papel para emissão manual da nota de entrada
• Emissão de NFe avulsa: Através do site da receita estadual.
• Emissão de NFe por meio de sistemas comerciais, pagos ou não: Existem diversos sistemas que se encarregam da emissão de NFe, inclusive um gratuito fornecido pela SEFAZ de São Paulo.
• Emissão de NFe por integração com o sistema Focus NFe: A Acras Sistemas possui o Focus NFe, um sistema comercial para emissão de NFe pela internet. O Focus Lojas possui uma integração com este sistema e a emissão das NFe de entrada poderá ser feita de forma automática. Aguarde planos especiais para clientes Focus Lojas!

Há alguns meses nossa equipe está preparando algumas novidades para os usuários do Focus NFe e elas serão disponibilizadas aos nossos usuários no decorrer deste ano. As principais novidades são:

Modelo de NFe

Para as operações mais comuns da sua empresa será possível criar modelos de NFe. Os modelos trarão consigo algumas configurações que irão agilizar o processo de emissão de uma nota. Por exemplo, podemos ter um modelo chamado “Venda sem frete e sem faturas”. Ao selecionar este modelo o sistema já irá preencher os campos a seguir de forma automática:

Natureza da Operação: Venda
Tipo de Documento: Saída
CFOP: 5101 quando o cliente for do mesmo estado da empresa, 5102 caso contrário
Frete e Duplicatas: Não serão mostradas ao cliente e terão suas informações preenchidas automaticamente

Emissão de Boletos

Será possível configurar o sistema para emitir boletos bancários a partir das duplicatas criadas em uma NFe. Desta forma os usuários que emitem boleto pelo sistema do banco poderão fazê-lo diretamente de nosso sistema, diminuindo o trabalho e aumentando a integração das informações.

Sistema Financeiro

Estamos desenvolvendo um sistema financeiro completo, com controle de contas a pagar e receber, integração com as duplicatas da emissão de NFe, criação de DRE para apuração de resultados e muito mais.

Este sistema está sendo desenvolvido em parceria com um consultor financeiro do SEBRAE e com recursos do MCT/CNPq.

O sistema será de contratação à parte, porém usuários Focus NFe terão condições especiais para aquisição do módulo.

Módulo básico de estoque

Para contemplar algumas exigências legais vamos introduzir um módulo básico de controle de estoque no sistema.

Com estas novidades demonstramos nosso compromisso em trabalhar para aumentar a produtividade e a competitividade de sua empresa.

Focus Lojas

A primeira grande mudança está no nome do sistema, que passa a se chamar Focus Lojas. Nosso objetivo na escolha deste novo nome é o de mostrar que não estamos fazendo um sistema com o objetivo de “abraçar o mundo”, mas sim o de dar um foco total à lojas, especialmente lojas de confecções, calçados e acessórios.

Tela de venda totalmente reformada

A tela de venda foi completamente refeita para se tornar mais ágil e de utilização mais facilitada. Vários campos foram eliminaos, sem perda de funcionalidade. A parte de recebimentos foi refinada para acabar com uma confusão comum que ocorre entre nossos usuários com relação aos planos e formas de pagamento. Esta reformulação viabilizou que alguns relatórios fossem melhorados, como o de movimentação diária.

Recebimentos por cartão

Com a reformulação na forma de registrar os recebimentos tornou-se possível aumentar o controle sobre os recebimentos por cartão. A partir de agora, de forma simples e pouco suscetível a erros, é possível registrar qual a maquina utilizada para passar o cartão, qual bandeira, qual forma (Débito ou crédito) e qual o parcelamento. Desta forma o sistema poderá calcular com precisão as datas e valores que as operadoras deverão depositar para a loja, facilitando a verificação por parte do lojista.

Sistema Híbrido Web/Desktop

Estamos desenvolvendo um sistema híbrido com módulos na internet e o módulo de vendas instalado no windows. A grande vantagem disso é que o lojista terá informações de sua loja onde quer que ele esteja, porém sem os riscos de queda de internet que, quando ocorrerem, não irão inviabilizar o uso do PDV (Sistema de Ponto de Venda). As mercadorias serão cadastradas, transferidas e movimentadas diretamente do módulo web. As vendas serão feitas no PDV, que automaticamente irá enviar os dados para o módulo web. Relatórios e balanços poderão ser impressos de qualquer lugar, atrávés do módulo web.

Homologação TEF e PAF-ECF

Para os clientes que utilizam o sistema fiscal, no final do ano passado conquistamos a homologação de nosso sistema para o TEF (Transferência Eletrônica de Fundos), sistema pelo qual todo o processo de recebimento por cartão torna-se automatizado pelo software, dispensando as maquininhas POS e necessitando apenas de um PinPad (leitor de cartão). Agora no início de 2012 estamos em processo de homologação PAF-ECF. O PAF-ECF é um conjunto de regras bastante rígidas e que certificam um sistema emissor de cupom fiscal, tornando-o mais confiável.   Estas são apenas algumas melhorias que vamos liberar neste ano. Desta forma fica claro o nosso compromisso em constantemente melhorar o nosso produto para que a sua loja torne-se cada vez mais competitiva e lucrativa.

Passo 1: Com a tampa principal aberta, pressione a trava verde indicada na figura para abrir a cabeça de impressão.

Passo 2: Antes de inserir o ribbon verifique de qual lado está a tinta. Uma forma simples de fazer isso é pegar uma etiqueta e colar no ribbon, se a tinta sair então o lado que você colou é o lado da tinta. O lado da tinta deverá ficar virado para baixo.

Passo 3: Com o lado da tinta virado para baixo posicione o ribbon nas roldanas da parte de baixo da cabeça de impressão, conforme a imagem abaixo. A roldana da direita pode ser pressionada com o próprio ribbon para dar espaço. Depois de encaixado o lado direito encaixe o lado esquerdo conforme a imagem abaixo.

Passo 4: Puxe um pouco do ribbon e prenda em um rolo vazio como na imagem abaixo. Novamente uma etiqueta pode ser usada, neste caso para prender o ribbon ao rolo vazio. 

Passo 5: Dê duas ou três voltas do ribbon no rolo vazio para deixar bem alinhado. Feche a cabeça de impressão e prenda na parte de cima o ribbon vazio, conforme imagem abaixo. Novamente a roldana da direita pode ser empurrada com o próprio rolo para encaixar.

Passo 6: Retire o suporte do rolo de etiquetas e insira nele o rolo de etiquetas. As etiquetas precisam ficar viradas para cima como mostra a imagem abaixo.

Passo 7: Com a cabeça de impressão novamente aberta, ajuste as travas de papel de forma que o papel passe por dentro delas sem ficar solto, mas também sem impedir o deslize do papel. Esta etapa é muito importante pois é dentro da trava da esquerda que está o sensor do papel, se não estiver bem colocado a impressora não vai detectar onde estão as etiquetas e a impressão vai sair desalinhada.

Pronto! Agora é só fechar a cabeça de impressão, depois fechar a tampa principal e imprimir as suas etiquetas.

O núcleo é o responsável por toda a lógica puramente inerente à Nota Fiscal Eletrônica, ou seja, a geração dos arquivos XML e DANFe, a comunicação com a receita para autorização, cancelamento e outras operações, a escolha entre servidor normal ou SCAN (contingência) e por aí vai.

Já o Módulo Web é o responsável pela interação com o usuário do sistema, são telas desenhadas para funcionar dentro do navegador e destinadas aos cadastros básicos (pessoas, produtos, etc) e para o preenchimento da Nota Fiscal em si. É responsabilidade do módulo web também toda a lógica de cálculo automatizado de impostos, funcionalidade muito apreciada pelos nossos usuários pois evita a necessidade de preenchimento de dezenas de campos referentes aos vários tributos existentes no Brasil.

Além do uso comum do sistema, ou seja, o preenchimento da NFe nas telas web e envio das notas, existem hoje duas formas de integrar outros sistemas com o Focus NFe. A integração direta e a integração 2 (que nome dar?). Na integração direta é responsabilidade do sistema que está se integrando de preencher todos os dados da nota fiscal, enviar diretamente ao núcleo do Focus NFe e consultar o resultado um tempo depois. Esta integração é explicada aqui (link para um post que explique isso).

O Módulo Web também pode ser integrado com sistemas externos, desta forma o sistema que está se integrando não precisa fazer todos os cálculos de impostos, cadastrando via API os destinatários da nota, os produtos e a nota em si.

Conceitos básicos da API

A API se baseia em domínios e tokens de acesso. Ao contratar o Focus NFe na modalidade “Integração Módulo Web” o programador receberá um identificador de domínio e um token de acesso de nosso suporte técnico. Toda a comunicação deverá ser feita através da utilização destas informações. Veja o exemplo abaixo, ele faz uma busca por uma pessoa com cnpj 07.504.505/0001-32 no domínio 100.

https://app.acras.com.br/web_nfe/api/pessoas?domain=100&access_token=J8Lqxw81upY8m0oTyE30ubwh9Umin6wQ&cnpj=03693480614355

Veja que os dois primeiros parâmetros da URL são o domain e o access_token.

API de pessoas

Índice

sintaxe: [GET] /pessoas
parâmetros: cnpj ou cpf
retorno:
 -quando encontrar uma pessoa retorna um xml representando a pessoa e status 200
 -quando não encontrar uma pessoa retorna vazio e status 404

Não disponibilizamos uma listagem completa de todas as pessoas cadastradas para evitar solicitações que sobrecarreguem o serviço. Todo índice deverá conter filtragem por CNPJ ou CPF.

Criação

sintaxe: [POST] /pessoas
uso:
  -Todos os parâmetros devem ser enviados como sub-parâmetros de pessoa,
   ou seja pessoa['nome'], pessoa['cpf'], etc.

parâmetros:

 -nome: o nome da pessoa com até 60 caracteres
 -cpf ou cnpj: somente um dos dois sendo cpf com 11 ou cnpj com 14 caracteres
 -inscricao_estadual ou isento_inscricao_estadual: inscricao_estadual com até
  14 caracteres ou o isento_inscricao_estadual preenchido com o valor 1 para
  indicar que é isento.
 -telefone: 10 caracteres exatamente 
 -email: Endereço de e-mail da pessoa. Se for informado, o Focus NFe irá disparar
  um e-mail para esta pessoa sempre que uma NFe seja autorizada para ela.
 -habilita_emissao_nfe: 0 - Não, 1 - Sim. Se estiver desabilitado não será possível
  emitir NFe para esta pessoa e algumas validações serão desligadas
 -logradouro(obrigatório se habilita_nfe=1): nome do logradouro
 -numero(obrigatório se habilita_nfe=1): número do endereço
 -complemento: complemento do endereço
 -bairro(obrigatório se habilita_nfe=1): bairro da pessoa
 -municipio(obrigatório se habilita_nfe=1): verifique abaixo as duas formas de
  preencher o município, se for preenchido codigo_municipio os outros dois
  parâmetros serão ignorados
   -codigo_municipio: Código IBGE do município
   -nome_municipio e uf_municipio: Dois parâmetros, um contendo o nome e outro contendo a UF

 -cep(obrigatório se habilita_nfe=1): cep do endereçamento da pessoa
 -codigo_pais: Código de país conforme a tabela do
 SISBACEN (http://www.mdic.gov.br/arquivos/dwnl_1211380426.pdf).
  Se vazio será assumido código 1058 (Brasil)

retorno:
 -quando a pessoa for criada retorna um xml representando a pessoa e status 201 (created)
 -quando não criar a pessoa por alguma falha de validação são retornados os erros de
  validação e o status 200 (OK) 

Atualização

sintaxe: [PUT] /pessoas/{id}
parâmetros: são os mesmos parâmetros da criação, apenas repare como na URL utilizada
            deve ser passado o id do registro, pois é uma atualização

API de Produtos

Índice

sintaxe: [GET] /produtos
parâmetros: codigo
retorno:
 -quando encontrar um produto retorna um xml representando o produto e status 200
 -quando não encontrar um produto retorna vazio e status 404

Criação

sintaxe: [POST] /produtos
uso:
  -Todos os parâmetros devem ser enviados como sub-parâmetros de produto,
   ou seja produto['codigo'], produto['descricao'], etc.

parâmetros:

 -codio: código do produto contendo até 60 caracteres, para integração é obrigatório
 -descricao: descrição do produto contendo até 120 caracteres
 -codigo_ncm ou capitulo_ncm: um dos dois onde codigo deve conter exatamente 8 caracteres e capitulo exatamente 2. 
   Este parâmetro deve ser informado conforme a configuração
 -unidade_comercial: Unidade em que o produto é comercializado. Se for vazio será assumido 'un'
 -valor_unitario_comercial: Valor unitário do produto

Atualização

sintaxe: [PUT] /produtos/{id}

Aqui são aceitos os mesmos parâmetros da criação, observar que o método é o PUT e que deve ser passado o id do registro que está sendo atualizado.

API de Notas Fiscais

sintaxe: [POST] /notas_fiscais

parâmetros:

  -natureza_operacao: Descritivo com até 60 caracteres da natureza da operação desta nota fiscal
  -tipo_documento: ENTRADA | SAIDA
  -data_emissao: Data de emissão deste documento fiscal no formato aaaa-mm-dd se vazio é assumido como hoje
  -data_entrada_saida: Data de entrada ou saída das mercadorias no formato aaaa-mm-dd
  -hora_entrada_saida: Hora de entrada ou saída das mercadorias no formato hh:mm:ss
  -cnpj_emitente: CNPJ do emitente. Obrigatório somente para domínios que possuem mais de um emitente, se 
                  houver apenas um o Focus NFe irá escolher automaticamente.
  -destinatario_id: id do destinatario desta nota. Este id é adquirido quando se faz a criação ou busca de 
                    uma pessoa pela API.
  -enviar: se estiver com o valor 1 efetua o envio para a receita, senão somente grava a nota para envio manual. Este parâmetro deve ser enviado na raiz dos params, ou seja, não fica abaixo do nota_fiscal.