Painel de controle


Nota Fiscal Eletrônica de Serviço

Tenha todas as funções necessárias para trabalhar com NFS-e de várias cidades em seu sistema com nossa API Maker.

Emita notas fiscais eletrônica de serviço (NFS-e) para diferentes municípios, de forma fácil e simplificada.

Com a nossa solução é possível gerar os arquivos necessários à conversão de RPS em NFS-e. As funções são únicas para lidar com os diferentes padrões de comunicação com as prefeituras.

Internamente, elas executam a criação dos XML e assinatura dos dados, assim como as chamadas de Web services e os detalhes de implementação de cada município.

Utilize a melhor solução em NFS-e do mercado em seus Sistemas.

Instalação no Maker

  1. Após baixar a versão desejada, acesse o sistema onde deseja instalar a API Maker;
  2. Feche o editor de fluxo e o cadastro de funções se estiverem abertos;
  3. Importe todos os arquivos (.frz).

Instalação no Webrun

  1. Copie a pasta "Maker.Commons" para a pasta "Webrun 2\systems";
  2. Reinicie o tomcat;
  3. Tente acessar o sistema, pode ocorrer um erro ou após a tela de login;
  4. Reinicie novamente o tomcat (Sem republicar);
  5. Acesse novamente o sistema.

Exemplos

Os exemplos de uso das funções se encontram na pasta EXEMPLOS.

NFS-e: Criar conexão usando certificado A1.

Inicia a conexão com o servidor da prefeitura utilizando um certificado A1 (arquivo).

Parâmetros

  1. Razão Social: (Letras);
  2. CNPJ: (Letras);
  3. Inscrição Municipal: (Letras);
  4. Cód. Municipio: (Inteiro);
  5. Ambiente de produção: (Lógico);
  6. keyStoreFileName: Caminho absoluto do arquivo de configuração;
  7. keyStorePassword: Senha de acesso ao certificado;
  8. trustStoreFileName;
  9. trustStorePassword.

Retorno

  1. Conexão (Variante).

NFS-e: Obter XML do Lote de RPS

Traça uma linha a partir de uma lista (array) de pontos passados como parâmetros.

NFS-e: Criar conexão usando certificado do Windows

Inicia a conexão com o servidor da prefeitura utilizando um certificado A1 ou A3 (cartão, token) instalado no Windows através da MsCapi.

Parâmetros

  1. Razão Social: (Letras);
  2. CNPJ: (Letras);
  3. Inscrição Municipal: (Letras);
  4. Cód. Municipio: (Inteiro);
  5. Ambiente de produção: (Lógico);
  6. trustStoreFileName;
  7. trustStorePassword.

Retorno

  1. Conexão (Variante).

NFS-e: RPS definir endereço do Tomador

Permite informar os dados do tomador de serviço.

Parâmetros

  1. RPS (Variante);
  2. Tipo de Logradouro: Rua, Avenida, Travessa, ... (Letras);
  3. Logradouro (Letras);
  4. Numero (Letras);
  5. Complemento: (Letras);
  6. Bairro: (Letras);
  7. CEP: (Letras);
  8. Código do Município: Código na na tabela do IBGE (Inteiro);
  9. UF: Sigla do estado (Letras);
  10. País: Código do Pais (ver tabela usada pela prefeitura) (Letras);
  11. E-mail: (Letras);
  12. Telefone: (Letras).

Retorno

  1. NENHUM.

NFS-e: Criar conexão sem certificado digital

Inicia a conexão com o servidor da prefeitura utilizando Login e senha.

Parâmetros

  1. Razão Social: (Letras)
  2. CNPJ: (Letras);
  3. Inscrição Municipal: (Letras);
  4. Cód. Municipio: (Inteiro);
  5. Ambiente de produção: (Lógico);
  6. Tipo de autenticação: (Letras) Constante "WSSE";
  7. Login/Usuário: (Letras) Nome do usuário;
  8. Senha: (Letras) Senha de acesso ao certificado
  9. trustStoreFileName;
  10. trustStorePassword.

Retorno

  1. Conexão (Variante).

NFS-e: Cancelar NFS-e

Cancela uma NFS-e previamente emitida.

Parâmetros

  1. Conector: (Variante);
  2. Numero da NFS-e (Inteiro);
  3. Protocolo/Código da NFS-e: (Letras).

Retorno

  1. Conexão (Variante).

NFS-e: RPS definir dados básicos

Define as informações básicas do RPS, data de emissão, tipo de tributação, situação, ...

Parâmetros

  1. RPS: (Variante);
  2. Data de emissão (Data);
  3. Natureza da Operação (Inteiro);
  4. Regime especial de tributação (Inteiro) - Código de identificação do regime especial de tributação;
  5. Os seguintes valores são aceitos no padrão ABRASF:
    1. Microempresa municipal;
    2. Estimativa;
    3. Sociedade de profissionais;
    4. Cooperativa;
    5. Microempresário Individual (MEI);
    6. Microempresário e Empresa de Pequeno Porte (ME EPP).
  6. Optante pelo Simples Nacional: Lógico (Verdadeiro/Falso);
  7. Incentivador Cultural: Lógico (Verdadeiro/Falso);
  8. Status: 1 - Normal ou 2 - Cancelado.

Retorno

  1. NENHUM.

NFS-e: RPS definir valores totais

Define os totais do serviço e impostos que fazem parte do RPS.

Parâmetros

  1. RPS: (Variante);
  2. ValorServicos: (Fracionado);
  3. ValorDeducoes: (Fracionado);
  4. Valor do PIS: (Fracionado);
  5. Valor do COFINS: (Fracionado);
  6. Valor do INSS: (Fracionado);
  7. Valor do IR (Numérico);
  8. Valor da CSLL (Fracionado);
  9. ISS retido: Indica se o ISS foi retido (Lógico);
  10. Valor do ISS: (Fracionado);
  11. Valor ISS Retido: (Fracionado);
  12. Outras retenções: (Fracionado);
  13. Base cálculo (Fracionado);
  14. Aliquota (Fracionado), aliquota em percentual aplicado ao serviço. Ex: Para 5 % informe 5,0; para 0,6 % informe 0,6; Para 2,4 % informe 2,4;
  15. ValorLiquidoNfse (Fracionado);
  16. Desconto incondicionado (Fracionado);
  17. Desconto condicionado (Fracionado).

Retorno

  1. NENHUM.

NFS-e: RPS definir dados do Tomador

Permite informar os dados do tomador de serviço.

Parâmetros

  1. RPS (Variante);
  2. CPF/CNPJ: (Letras);
  3. Razão Social: (Letras);
  4. Tipo de Logradouro: Rua, Avenida, Travessa, ... (Letras);
  5. Logradouro (Letras);
  6. Numero (Letras);
  7. Complemento: (Letras);
  8. Bairro: (Letras);
  9. Código do Município: Códna na tabela do IBGE (Inteiro);
  10. UF: Sigla do estado (Letras);
  11. CEP: (Letras);
  12. E-mail: (Letras);
  13. Telefone: (Letras).

Retorno

  1. NENHUM.

NFS-e: Novo RPS

Traça uma linha a partir de uma lista (array) de pontos passados como parâmetros.

Parâmetros

  1. LoteRPS: Identificador do lote (retornado pela função);
  2. Número;
  3. Série;
  4. Tipo:
    1. RPS;
    2. Nota mista;
    3. Cupom;

Retorno

  1. RPS (Variante) que identifica o item dentro do lote.

NFS-e: Enviar Lote de RPS

Transmite um RPS para o servidor da prefeitura.

Parâmetros

  1. Lote RPS.

Retorno

  1. XML com a resposta do servidor (Letras).

NFS-e: Criar Lote

Cria um lote de RPS a ser enviado à prefeitura.

Parâmetros

  1. Número do Lote: Número sequencial do Lote (Inteiro).

Retorno

  1. Lote (Variante) utilizada na função de criar RPS e enviar lote.

NFS-e: Processar resposta do servidor

Traça uma linha a partir de uma lista (array) de pontos passados como parâmetros.

Parâmetros

  1. Conector: (Variante);
  2. Numero da NFS-e (Inteiro);
  3. Protocolo/Código da NFS-e: (Letras).

Retorno

  1. Conexão (Variante).

NFS-e: Processar resposta do servidor

Lê o XML de resposta da prefeitura e retorna em um formato padrão para permitir o processamento simples através do fluxo.

Parâmetros

  1. Número do Lote: Número sequencial do Lote (Inteiro).

Retorno

  1. Lote (Variante) utilizada na função de criar RPS e enviar lote.

NFS-e: Consultar situação do Lote de RPS

Obtém a situação do lote no servidor da prefeitura.

Parâmetros

  1. Conector: (Variante);
  2. Protocolo: Protocolo de entrega do lote, ou número do lote (São Paulo-SP) (Letras).

Retorno

  1. XML com a resposta do servidor. (Letras).

NFS-e: Consultar situação do Lote de RPS

Protocolo: Protocolo de entrega do lote, ou número do lote (São Paulo-SP) (Letras).

Parâmetros

  1. Conector: (Variante);
  2. Numero da NFS-e (Inteiro);
  3. Protocolo/Código da NFS-e: (Letras).

Retorno

  1. XML com a resposta do servidor. (Letras).

NFS-e: RPS Dados do Serviço

Define as informações do serviço, código, discriminação, etc.

Parâmetros

  1. RPS (Variante);
  2. Item da lista de serviço: (Letras) Código do serviço na tabela da prefeitura.
  3. Código CNAE do serviço (Letras) - Opcional;
  4. Código de tributação do município (Letras);
  5. Discriminação - (Letras) Descrição dos serviços prestados.
  6. Código do município (na tabela do IBGE) onde o serviço foi prestado. (Inteiro)

Retorno

  1. NENHUM.

NFS-e: Consultar RPS

Obtém informações sobre um RPS.

Parâmetros

  1. Conector: (Variante);
  2. Número: (Inteiro);
  3. Série: (Letras);
  4. Tipo: (Inteiro).

Retorno

  1. (Letras).

GNFS-e: RPS adicionar Item

Adicionar os detalhes dos itens do RPS.

Parâmetros

  1. RPS: (Variante);
  2. Discriminação do serviço: (Letras);
  3. Quantidade: (Fracionado);
  4. Valor unitário: (Fracionado);
  5. Valor total: (Fracionado).

Retorno

  1. NENHUM.

NFS-e: RPS definir RPS substituído

Informa o número do RPS que está sendo substituído.

Parâmetros

  1. RPS: (Variante);
  2. Número: Número do RPS referenciado (Inteiro).
  3. Serie: Séri do RPS (Letras);
  4. Tipo: (Inteiro);


Retorno

  1. NENHUM.

NFS-e: Obter informações do Certificado

Extra informações do certificado digital.

Parâmetros

  1. Conector: (Variante).

Retorno

  1. (Variant) Mapa com as informações retornadas:
  2. RAZAO_SOCIAL - Razao Social / Nome do dono od certificado;
  3. CPF_CNPJ - Documento do dono do certificado;
  4. DATA_EXPIRACAO - Data de expiração do certificado;
  5. DATA_INICIAL - Data inicial de valide do certificado;
  6. ESTADO - Estado do dono do certificado;
  7. CIDADE - Cidade do dono do certificado;
  8. PAIS - Pais do dono do certificado;
  9. ORGANIZACAO - Deve ser "ICP-Brazil";
  10. NOME - Nome completo contido no certificado, normalmente o o nome seguido de ":" e o CPF/CNPJ;
  11. ASSINATURA_DIGITAL - Indica se o certificado pode ser usado para assinar documentos (, necessário para assinatura das NFs);
  12. AUTENTICACAO_CLIENTE - Indica se o certificado pode ser usado para estabelecer uma conexão SSL (, necessário para envio dos arquivos).

NFS-e: RPS definir aliquotas dos Impostos

Define as aliquotas utilizadas para cálculo dos impostos.

Parâmetros

  1. RPS: (Variante);
  2. Aliquota PIS: (Fracionado);
  3. Aliquota COFINS: (Fracionado);
  4. Aliquota INSS: (Fracionado);
  5. Aliquota IR: (Fracionado);
  6. Aliquota CSLL (Numérico).

Retorno

  1. NENHUM.

NFS-e: Consultar Lote de RPS

Obtém a informações do lote após processado pelo servidor da prefeitura.

Parâmetros

  1. Conector: (Variante);
  2. Protocolo: Protocolo de entrega do lote, ou número do lote (São Paulo-SP) (Letras).

Retorno

  1. XML com a resposta do servidor. (Letras).

NFS-e: Cancelar NFS-e (com motivo)

Cancela uma NFS-e previamente emitida.

Parâmetros

  1. Conector: (Variante);
  2. Numero da NFS-e (Letras);
  3. Protocolo/Código da NFS-e: (Letras);
  4. Motivo do cancelamento: (Letras).

Retorno

  1. XML com a resposta do servidor. (Letras).

NFS-e: RPS definir identificação do Tomador/h1>

Permite informar os dados de identificação do tomador de serviço.

Parâmetros

  1. RPS (Variante)
  2. Tipo do tomador (Inteiro) -Código que identifica o tipo do tomador, podendo ser:
    1. 0 = Automático / 1 = Pessoa física / 2 = Pessoa Jurídica;
    2. 10 - Estrangeiro não especifico / 11 = Estrangeiro pessoa física / 12 = Estrangeiro pessoa jurídica;
    3. 99 = Não informado ou cliente avulso.
  3. CPF/CNPJ/Doc: (Letras) Documento de identificação do tomador;
  4. Razão Social: (Letras);
  5. Nome fantasia: (Letras);
  6. Insc. Municipal (Letras) - Inscrição municipal;
  7. Insc. Estadual (Letras) - Inscrição estadual.

Retorno

  1. NENHUM.

NFS-e São Paulo - SP

Abaixo a tabela de conversão entre o Tipo de Tributação do RPS (1 a 6 no padrão ABRASF) e os códigos de São Paulo-SP (letra com 1 posição). O código correspondente deve ser informado no parâmetro Natureza da operação (3o. parametro) da função "NFS-e: RPSdefinir dados básicos".

  • 1 - Tributação no municipio de São Paulo (T)
  • 2 - Tributação fora do municipio de São Paulo (F);
  • 3, 4 e 6 - Isento (I);
  • 5 - ISS suspenso por decisão judicial (J).

NFS-e - Versão 1.3.9

Esta é a nova versão da API de Nota Fiscal Eletrônica de Serviço.

Resumo

  • Número de versão: 1.3.9
  • Data de liberação: 09/12/2013

Principais melhorias

  • Adição da cidade de Santa Cruz do Sul/RS.

NFS-e - Versão 1.3.8

Esta é a nova versão da API de Nota Fiscal Eletrônica de Serviço.

Resumo

  • Número de versão: 1.3.8
  • Data de liberação: 30/10/2013

Principais melhorias

  • Correção da cidade de Boa Vista\RR.