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