Arquivo da tag: nfse

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

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