Todos os posts de egon

API para envio de NFSe para o município de São Paulo

NFe, ,

Aviso: Esta forma de envio está obsoleta. Utilize o formato unificado para envio de NFSe. O formato abaixo continua funcional apenas para fins de suporte a aplicações legadas.

O Focus NFe disponibiliza um webservice com dois serviços:  a emissão e a consulta de status da NFSe. Sua empresa é autenticada com um “token” secreto que você deverá repassar para o webservice a cada requisição.  Além disso, deverá ser informada uma referência única para cada nota fiscal emitida. Esta referência pode ser, por exemplo, o identificador da fatura no seu banco de dados. É necessária esta referência para que seja possívevl consultar posteriormente o status da NFSe.

Emissão

Para a emissão, você deverá passar dentro de uma requisição POST, o conteúdo de um arquivo no formato YAML com as informações da nota. O formato YAML tem biblioteca pronta em PHP e em diversas outras linguagens de programação de forma que é possível transformar um Hash em YAML com apenas um comando.

A requisição de emissão de NFSe é assíncrona, ou seja, quando a solicitação de emissão é recebida, o retorno é imediato pois a requisição vai para uma fila de processamento para poder lidar com grandes volumes de dados.

Endereço: http://producao.acrasnfe.acras.com.br/nfse2/sao_paulo/autorizar

Parâmetros:

  • token: O token secreto de sua empresa
  • ref: Número da referência
  • Arquivo YAML é enviado no corpo do POST

Exemplo:

POST /nfse2/sao_paulo/autorizar?token=<seu_token>&ref=123
cnpj_prestador: 13339994000123
data_emissao: 2012-08-12
tributacao_rps: T
valor_servicos: 1
valor_deducoes: 0
codigo_servico: 06939
aliquota_servicos: 0.02
iss_retido: false
cpf_cnpj_tomador:
  cpf: 11123242134
razao_social_tomador: PATRICIA TUPYNAMBA
endereco_tomador:
  tipo_logradouro: R
  logradouro: Guararapes
  numero_endereco: 495 A
  complemento_endereco: ap 102
  bairro: BROOKLIN PAULISTA
  cidade: 3550308
  uf: SP
  cep: 4561000
email_tomador: ptupynamba@gmail.com
discriminacao: Serviços de composição gráfica

Retorno: HTTP status 202 (Accepted) ou HTTP status 400 (Bad request) se já existe uma nota autorizada com a mesma referência.

Campos do arquivo YAML:

  • cnpj_prestador: É o cnpj de sua empresa
  • data_emissao: Data de emissão da NFSe
  • tributacao_rps: Informe o tipo de tributação: T – Operação normal (tributação conforme documento emitido);  I – Operação isenta ou não tributável, executadas no Município de São Paulo; F – Operação isenta ou não tributável pelo Município de São Paulo, executada em outro Município; J – ISS Suspenso por Decisão Judicial (neste caso, informar no campo Discriminação dos Serviços, o número do processo judicial na 1a. instância).
  • valor_servicos: Valor do serviços
  • valor_deducoes: Valor das deduções
  • codigo_servico: Código do serviço de acordo com a tabela disponibilizada pela prefeitura.
  • aliquota_servicos: Alíquota dos serviços
  • iss_retido: Informe “true” para ISS retido e “false” caso contrário
  • cpf_cnpj_tomador: Informe abaixo deste campo o subcampo “cnpj” ou “cpf” do tomador, se aplicável
  • razao_social_tomador: Informe o nome ou razão social do tomador.
  • endereco_tomador: Informe os campos  “tipo_logradouro”, “logradouro”, “numero_endereco”, “complemento_endereco”, “bairro”, “cidade”, “uf”, “cep” para especificar o endereço do tomador de serviços.
  • email_tomador: Email do tomador de serviços
  • discriminacao: Discriminação dos serviços. Pode conter várias linhas

Consulta

Após a emissão, a consulta da situação do processamento poderá ser feita em um segundo momento para obter as informações da NFSe gerada ou dos erros de processamento. O retorno é também em formato YAML.

Endereço: http://producao.acrasnfe.acras.com.br/nfse2/sao_paulo/consultar

Parâmetros:

  • token: O token secreto de sua empresa
  • ref: Número da referência

Exemplo de chamada e retorno:

GET /nfse2/sao_paulo/consultar?token=<seu_token>&ref=123


uri: https://nfe.prefeitura.sp.gov.br/contribuinte/notaprint.aspx?inscricao=112312&nf=14&verificacao=P2UJ4QGT


codigo_verificacao: P2UJ4QGT
data_emissao: 2012-08-12 03:00:00 Z
numero: "14"
status: autorizado


 


Retorno: HTTP status 200 (Ok) ou HTTP status 404 (Not Found) se não encontrada NFSe associada a referência


Campos de retorno:


    

  • uri: Endereço disponibilizado pela prefeitura para visualização da NFSe
    • 

  • codigo_verificacao: Código de verificação da NFSe
    • 

  • data_emissao: Data de emissão
    • 

  • numero: Número da NFSe
    • 

  • status: “autorizado” se a NFSe foi emitida com sucesso ou “erro_autorizacao” caso contrário
    • 

  • erros: Array de mensagens de erro caso a nota fiscal não tenha sido emitida com sucesso.
    • 



t

			

	
	


							


	

		
				

			Como emitir uma Carta de Correção Eletrônica (CCe)
		

		
		

			NFe, , 					

	


		

		
Como muitos já sabem, a partir deste mês de julho já não poderá ser utilizada carta de correção em papel para sanar erros em campos específicos de NF-e, agora deverá ser utilizada  a CCe (Carta de Correção Eletrônica).


A regra do que pode ser corrigido continua a mesma. As seguintes informações não podem ser corrigidas:


    

  1. As variáveis que determinam o valor do imposto tais como: base de cálculo, alíquota, diferença de preço, quantidade, valor da operação ou da prestação;
    2. 

  2. A correção de dados cadastrais que implique mudança do remetente ou do destinatário;
    3. 

  3. A data de emissão ou de saída.
    4. 



Para emitir uma CCe no Focus NFe, você deve seguir os seguintes passos:


1. Procure sua nota fiscal através do menu Nota Fiscal -> Pesquisar

2. Selecione a nota e clique em “Emitir carta de correção”




3. Na tela a seguir, você deve informar a data do evento que ocorreu a alteração e sua descrição.




A data não pode ser menor que a data de emissão da NFe, e não pode ser maior que a data de processamento (quando a nota foi autorizada). Não existe “modelo” de como deverá ser informada a alteração, procure apenas ser sucinto e objetivo na descrição, pois ela possui um limite de 1000 caracteres.


4. Clique em “Salvar” e sua CCe será enviada para o SEFAZ. Você receberá uma notificação quando o processo for concluído, podendo salvar o XML gerado.




Você pode também corrigir a Carta de Correção, basta emitir uma nova versão da CCe seguindo exatamente os passos acima. O sistema irá criar uma outra versão que irá substituir a CCe emitida anteriormente, o SEFAZ irá ignorar a CCe anterior. Ou seja, você deve consolidar todas as alterações em uma só carta. O número de versões possíveis é limitado a 20.


Uma lista de todas as CCe’s emitidas (mesmo de versões antigas e substituídas) está disponível através do menu Notas Fiscais -> Cartas de Correção.


 

			

	
	


							


	

		
				

			Imprimindo etiquetas na impressora Argox OS-214
		

		
		

			SGL					

	


		

		
Este tutorial ensina como imprimir as suas etiquetas através da impressora Argox OS-214. Os passos para outros modelos da série “OS” são praticamente os mesmos.


Primeiramente, instale os drivers da impressora caso ainda não o tenha feito. Utilize o CD que acompanha o equipamento e selecione o seu modelo dentro das opções disponíveis. Certifique-se também de que você esta com o Adobe Reader instalado. Ele pode ser instalado a partir deste link.


Antes de imprimir você deve configurar o tamanho de suas etiquetas. No Windows, entre em Iniciar -> Impressoras e Aparelho de Fax. Ali deverá aparecer sua impressora Argox. Clique nela com o botão direito do mouse e entre em “Preferências de Impressão”. Será exibida a janela abaixo:




Você deve agora informar o tamanho do papel, que esta exibido na seção “Papel de etiquetas”. Clique no botão “Editar” e informe os valores de largura e altura de suas etiquetas na janela a seguir.




Por exemplo, se você utiliza um papel de etiquetas de tamanho 35mm (largura) x 60mm (altura)  em 3 colunas, você deve informar os valores 105mm (35mm x 3) x 60mm.  Ou seja, neste caso é só multiplicar o número de colunas pela largura da etiqueta.


Clique no botão OK em todas as janelas e suas configurações ficarão salvas sempre que você precisar imprimir uma etiqueta.


Ao gerar as etiquetas a partir do Focus Lojas será exibida uma tela com as etiquetas a serem impressas. Você pode abrir as opções de impressão clicando no ícone da impressora ou com o comando CTRL+P no teclado.




Certifique-se de que a impressora Argox esteja selecionada e na seção “Tratamento de páginas” esteja com as seguintes opções:


    

  • Escala da página: Ajustar à área de impressão
    • 

  • Girar automaticamente e centralizar
    • 

  • Escolher origem do papel por tamanho da página do PDF
    • 



Pronto! É só clicar em OK e suas etiquetas serão impressas.

			

	
	


							


	

		
				

			Inserindo fita e papel na impressora Argox OS-214plus
		

		
		

			SGL					

	


		

		
Este tutorial ensina como inserir o papel e a fita na impressora de etiquetas Argox OS-214plus. Outros modelos da série “OS” também podem se beneficiar deste tutorial.


Se quiser apenas uma visão rápida da instalação, assista o vídeo abaixo produzido pela própria Argox (em inglês), ou continue lendo para uma versão mais detalhada do processo.




Passo 1: Abra a tampa principal e empurre as duas travas brancas para abrir a cabeça de impressão.




Passo 2: Prepare a fita enrolando uma das pontas em um rolo vazio. Basta 2 ou  3 voltas. Você pode utilizar uma etiqueta para prender a fita no rolo se desejar.




Passo 3: Insira o rolo de fita na roldana indicada de forma que a fita saia pela parte inferior do rolo. Pressione a roldana esquerda com o próprio rolo para dar espaço. Repare que o encaixe se dá devido ao pequeno recorte que o rolo possui em suas extremidades.




Passo 4: Feche a cabeça de impressão e insira o outro rolo na roldana superior. Da mesma forma, pressione o lado esquerdo primeiro para possibilitar o encaixe. Em seguida, gire um pouco a roldana usando a sua extremidade esquerda para deixar a fita sem folga.




Passo 5: Agora vamos inserir o papel. Remova o suporte do papel localizado atrás da cabeça de impressão, insira o rolo de etiquetas e recoloque o suporte de forma que as etiquetas fiquem para cima.




Passo 6:  Abra novamente a cabeça de impressão e passe as etiquetas por baixo passando entre os suportes brancos. Deixe a etiqueta alguns centimetros para fora da impressora. Feche a cabeça de impressão e certifique-se de que ela esteja travada fazendo uma leve pressão em cima. Pode ser necessário rolar um pouco a roldana superior para eliminar a folga da fita.




Pronto! Agora você pode fechar a tampa da impressora e imprimir as suas etiquetas.