Última modificação em: 17/06/2024
Geração RPS - API Tecnospeed
GERAÇÃO RPS - API TECNOSPEED
O objetivo da geração dos arquivos de RPS/NFSE com a Integração API Tecnospeed fazendo a homologação para diversos Municípios.
Pré requisitos para uso da API
-
Obrigatoriamente ter Certificado digital do modelo A1;
Informações necessárias
-
Prefeitura está homologada?
-
Utiliza usuário da prefeitura para emissão do RPS? Se sim, qual é o código do usuário?
-
Exige senha para comunicação? Se sim, qual é a senha?
-
Exige Token para comunicação? Se sim, qual é o Token?
-
Utiliza código de tributação Município? Se sim, é específico por contribuinte ou atividade?
-
Código de atividade pertencem ao cadastro do cliente na Prefeitura?
Após respondidas estas questões, siga o passo-a passo da documentação apresentada na sequência para entender o processo de configuração.
O que deve ser feito no Questor
Primeiro passo: Módulo Gerenciador de Empresas
Deverá ser configurado o cadastro do município ao qual o Escritório localizado em Cadastros > Federais, Estaduais, Municipais >Municípios.
O campo Integrar Emissão NFS-e deve ser informado: API TS
Segundo passo: Módulo Financeiro
Após preencher os campos necessários no módulo Gerenciador de Empresas, deverá acessar no módulo Financeiro as Configurações de Sistema NFSe localizado em Cadastros \ NFSe e preencher as seguintes informações:
Observações:
No campo Senha Web Service, somente será habilitado se no módulo Gerenciador de Empresas for preenchido SIM para Integrar API NFS-e, somente deve ser informado quando a prefeitura obriga a senha para emissão do RPS, demais casos deve ficar em branco.
A descrição do Usuário e Token é obrigatória, mas só deve conter preenchimento após o sinal de Igual (=) para os municípios que utilizam, os demais não devem ser preenchidos.
No Detalhe Integração API deve ser feito o preenchimento dos campos Certificado Digital e Senha do Certificado.
Certificado Digital deve ser tipo A1.
Vale ressaltar que no campo Certificado deve ser importado o arquivo no formato PFX.
No menu Configurações > Configuração Escritório foram feitas as seguintes tratativas:
1. Foi incluído validação para o campo Enviar Base de Cálculo com as opções abaixo:
-
Com valor dos Serviços: Esta opção virá por padrão e segue o mesmo funcionamento atual enviando o valor de Base de Cálculo dos Serviços.
-
Somente quando houver imposto: Nesta opção, se na rotina Movimentos > Faturamento > Nota Fiscal houver informação de Imposto em quaisquer dos campos de Base (IRRF, CSLL, PIS, COFINS, ISS, INSS, ISS Retido) será enviado o valor desta Base de Cálculo.
Caso não haja valores, enviará zerado.
2. Para a Tecnospeed o campo Regime Especial Tributação, conterá as opções abaixo:
3. No campo Regime Tributação, ficou da seguinte forma:
Na rotina Cadastros > Clientes > Contratos Clientes temos o campo CFPS como Obrigatório para o Município de Florianópolis. Desta forma, caso exista informação preenchida no campo CFPS, será enviado o Código Tributação do Município atrelado àquele Cliente.
Caso seja Nulo, permanecerá buscando o Código de Tributação do Município como já faz atualmente.
Após as configurações acima serem efetuadas já poderá realizar a geração e transmissão do RPS no módulo financeiro em Arquivos \ Gerar RPS NFSe.
Posterior a geração poderá realizar a consulta do lote gerado no módulo financeiro em Arquivos \ Consultar Lote de RPS.
Caso desejar poderá efetuar o cancelamento em Movimentos \ Faturamento \ Cancelar/Excluir Nota Fiscal.
Vale ressaltar que o cancelamento varia de acordo com o município e só vai permitir fazer via Web Service se for permitido pelo município que o escritório pertence.
Emissão da Nota Fiscal
Para os municípios que utilizam o Código Tributação Município deve ser informado o código em Cadastros \ Escritório \ Escritórios.
Para os municípios que não utilizam, será gerado o RPS com a mesma informação que o código da Atividade vinculado ao serviço.
O processo de geração do RPS se mantém como os demais sistemas de RPS.
Geração dos Impostos Retidos:
Para geração dos impostos IRRF, PIS, COFINS, CSLL e INSS deve ser observado as seguintes configurações.
Cadastro de clientes: disponível em Cadastros \ Clientes Contrato de Clientes para reter os impostos deve ser informado sim, conforme imagem abaixo:
Cadastro do Serviço: Deve ser informado se deseja reter os impostos conforme podemos identificar abaixo:
Cadastro do Escritório: Deve possuir a informação das alíquotas e códigos de Impostos, como podemos identificar abaixo:
Para geração do ISS retido além de informar as configurações de alíquota no escritório deve ser configurado a Exceção de ISS, localizada em Configurações \ Exceções ISS.
Deve ser informado estado e município que acontecerá essa retenção, além de identificar o código do serviço e a Base ISS para somar, conforme podemos identificar abaixo:
Após realizado o cadastro da exceção deverá ser vinculado ao Contrato do Cliente.
Caso tenha outras exceções poderá ser informado nas Configurações.
Lembrando que as exceções devem ser vinculadas ao contrato do Cliente.
Montagem do JSON
|
Tags enviadas no JSON: |
|
|
|
Campo API |
Módulo/Campo |
Observações |
|
cpfCnpj |
Gerenciador de Empresas: |
CNPJ/CPF/CNO |
|
inscricaoMunicipal |
Gerenciador de Empresas: |
Inscrição Municipal |
|
inscricaoEstadual |
Gerenciador de Empresas: |
Inscrição Estadual |
|
razaoSocial |
Gerenciador de Empresas: |
Razão Social |
|
nomeFantasia |
Gerenciador de Empresas: |
Nome Fantasia |
|
simplesNacional |
Financeiro: Configurações > Configuração Escritório |
Regime Tributação |
|
regimeTributario |
Financeiro: Configurações > Configuração Escritório |
Regime Tributação |
|
regimeTributarioEspecial |
|
Regime Especial Tributação:
|
|
endereco/bairro |
Gerenciador de Empresas: |
Bairro |
|
endereco/cep |
Gerenciador de Empresas: |
Cep |
|
endereco/codigoCidade |
Gerenciador de Empresas: |
Código RAIS Município |
|
endereco/estado |
Gerenciador de Empresas: |
Estado |
|
endereco/logradouro |
Gerenciador de Empresas: |
Endereço |
|
endereco/numero |
Gerenciador de Empresas: |
Número |
|
endereco/tipoLogradouro |
Gerenciador de Empresas: |
Tipo Logradouro |
|
endereco/codigoPais |
Fixo |
1058 |
|
endereco/complemento |
Gerenciador de Empresas: |
Complemento |
|
endereco/descricaoCidade |
Gerenciador de Empresas: |
Município |
|
endereco/descricaoPais |
Fixo |
Brasil |
|
endereco/tipoBairro |
Fixo |
Bairro |
|
telefone/numero |
Gerenciador de Empresas: |
Fone |
|
telefone/ddd |
Gerenciador de Empresas: |
DDD do Fone |
|
|
Gerenciador de Empresas: |
|
|
nfse/ativo |
Fixo |
|
|
nfse/config/producao |
Financeiro: Configuração de Sistema NFSe> |
Tipo Ambiente: |
|
nfse/config/rps/lote |
Financeiro: Arquivos> Gerar RPS NFSe |
Lote |
|
nfse/config/rps/numeracao/numero |
Financeiro: Arquivos> Gerar RPS NFSe |
Número NF-RPS Inicial/Final |
|
nfse/config/rps/numeracao/serie |
Financeiro: Arquivos> Gerar RPS NFSe |
Série NF |
|
nfse/config/prefeitura/login |
Financeiro: Configuração de Sistema NFSe> Usuário |
Usuário Prefeitura |
|
nfse/config/prefeitura/senha |
Financeiro: Configuração de Sistema NFSe> |
Senha Prefeitura |
|
nfse/config/calculoAutomaticoIbpt/ativo |
Financeiro: Configurações > Configuração Escritório |
Usa Lei Transparência: |
|
Json Envio RPS |
||
|
Campo |
Módulo/Campo |
Observações |
|
idIntegracao |
Financeiro: Movimentos>Faturamento>Nota Fiscal |
Número |
|
prestador/cpfCnpj |
Gerenciador de Empresas: Cadastro> Empresas |
CNPJ/CPF/CNO |
|
tomador/cpfCnpj |
Financeiro: Cadastros > Pessoas |
Insc. Federal |
|
tomador/razaoSocial |
Financeiro: Cadastros > Pessoas |
Nome/Razão Social |
|
tomador/endereco/bairro |
Financeiro: Cadastros > Pessoas |
Endereço |
|
tomador/endereco/cep |
Financeiro: Cadastros > Pessoas |
Endereço Tomador |
|
tomador/endereco/codigoCidade |
Financeiro: Cadastros > Pessoas |
Município do Tomador |
|
tomador/endereco/estado |
Financeiro: Cadastros > Pessoas |
Estado |
|
tomador/endereco/logradouro |
Financeiro: Cadastros > Pessoas |
Endereço |
|
tomador/endereco/numero |
Financeiro: Cadastros > Pessoas |
Número |
|
tomador/endereco/tipoLogradouro |
Financeiro: Cadastros > Pessoas |
Endereço |
|
tomador/endereco/codigoPais |
Financeiro: Cadastros > Pessoas |
País/Brasil |
|
tomador/endereco/complemento |
Financeiro: Cadastros > Pessoas |
Complemento |
|
tomador/endereco/descricaoCidade |
Financeiro: Cadastros > Pessoas |
Município do Cliente |
|
tomador/endereco/descricaoPais |
Financeiro: Cadastros > Pessoas |
Caso esteja nulo 'Brasil' |
|
tomador/endereco/tipoBairro |
Financeiro: Cadastros > Pessoas |
Bairro |
|
tomador/email |
Financeiro: Cadastros > Pessoas |
|
|
tomador/inscricaoEstadual |
Financeiro: Cadastros > Pessoas |
Inscricão Estadual |
|
tomador/inscricaoMunicipal |
Financeiro: Cadastros > Pessoas |
Inscrição Municipal |
|
tomador/inscricaoSuframa |
Financeiro: Cadastros > Pessoas |
Nulo |
|
tomador/nomeFantasia |
Financeiro: Cadastros > Pessoas |
Nome Fantasia Cliente |
|
tomador/orgaoPublico |
Financeiro: Cadastros > Pessoas |
Nulo |
|
tomador/telefone/numero |
Financeiro: Cadastros > Pessoas |
Telefone Cliente |
|
tomador/telefone/ddd |
Financeiro: Cadastros > Pessoas |
DDD Telefone Cliente |
|
tomador/indicadorInscricaoEstadual |
Financeiro: Cadastros > Pessoas |
2 |
|
servico/codigo |
Financeiro: Movimentos>Faturamento>Nota Fiscal |
Código do Item |
|
servico/discriminacao |
Financeiro: Configurações > Configuração Escritório |
Descrição Padrão dos Serviços se estiver nulo buscará da Nota Fiscal |
|
servico/codigoTributacao |
Financeiro: Cadastros > Clientes >Contrato de Clientes |
Buscará Código CFPS, caso estiver nulo enviará o Código Tributação Município. |
|
servico/cnae |
Financeiro: Movimentos > Faturamento > Complemento Nota Fiscal - RPS |
CNAE do Complemento da NF |
|
servico/codigoCidadeIncidencia |
Financeiro: Cadastros > Pessoas |
Código Município relacionado ao Escritório |
|
servico/descricaoCidadeIncidencia |
Financeiro: Cadastros > Pessoas |
Município relacionado ao Escritório |
|
servico/iss/tipoTributacao |
Financeiro: Movimentos > Faturamento > Complemento Nota Fiscal - RPS |
Situação Tributária: |
|
servico/iss/exigibilidade |
Financeiro: Configurações > Configuração Escritório |
Busca da Natureza Operação Município se nulo buscará da Natureza da Operação |
|
servico/iss/retido |
Financeiro: Movimentos>Faturamento>Nota Fiscal |
Valor ISS Retido |
|
servico/iss/aliquota |
Financeiro: Movimentos>Faturamento>Nota Fiscal |
Alíquota ISS da Nota Fiscal se não ( ((EXCECAOISS.ALIQISS se EXCECAOISS.CFGVALORMINIMOISSRETIDO <> 1) se > 0) se não (CFGESCRITORIO.ALIQUOTAISSPADRAO) |
|
servico/iss/valor |
Financeiro: Movimentos>Faturamento>Nota Fiscal |
Valor ISS + Valor ISS Retido |
|
servico/iss/valorRetido |
Financeiro: Movimentos>Faturamento>Nota Fiscal |
Valor ISS Retido |
|
servico/valor/servico |
Financeiro: Movimentos>Faturamento>Nota Fiscal |
Valor Serviço |
|
servico/valor/baseCalculo |
Financeiro: Configurações > Configuração Escritório |
Buscará a informação do campo Enviar Base de Cálculo: |
|
servico/valor/descontoIncondicionado |
Financeiro: Cadastros>Serviços |
Soma dos valores dos Serviços |
|
servico/valor/liquido |
Financeiro: Configurações > Configuração Escritório |
Se o campo “Deduzir Ressarcimentos= Sim, “Tipo Serviço”= 2-Ressarcimento ou -2 Troco Crédito Mês anterior, o valor será: Valor Bruto – Valor Total Serviços. |
|
servico/valor/unitario |
Financeiro: Movimentos>Faturamento>Nota Fiscal |
Valor Unitário do Item |
|
servico/retencao/pis/baseCalculo |
Financeiro: Movimentos>Faturamento>Nota Fiscal |
Base de Cálculo Pis |
|
servico/retencao/pis/aliquota |
Financeiro: Movimentos>Faturamento>Nota Fiscal |
Alíquota Pis |
|
servico/retencao/pis/valor |
Financeiro: Movimentos>Faturamento>Nota Fiscal |
Valor Pis |
|
servico/retencao/pis/cst |
Financeiro: Movimentos > Faturamento > Complemento Nota Fiscal - RPS |
Se Optante pelo Simples Nacional o valor será 00 se não 01 |
|
servico/retencao/cofins/baseCalculo |
Financeiro: Movimentos>Faturamento>Nota Fiscal |
Base de Cálculo Cofins |
|
servico/retencao/cofins/aliquota |
Financeiro: Movimentos>Faturamento>Nota Fiscal |
Alíquota Cofins |
|
servico/retencao/cofins/valor |
Financeiro: Movimentos>Faturamento>Nota Fiscal |
Valor Cofins |
|
servico/retencao/cofins/cst |
|
Se Optante pelo Simples Nacional o valor será 00 se não 01 |
|
servico/retencao/csll/aliquota |
Financeiro: Movimentos>Faturamento>Nota Fiscal |
Alíquota CSLL |
|
servico/retencao/csll/valor |
Financeiro: Movimentos>Faturamento>Nota Fiscal |
Valor CSLL |
|
servico/retencao/inss/aliquota |
Financeiro: Movimentos>Faturamento>Nota Fiscal |
Alíquota INSS |
|
servico/retencao/inss/valor |
Financeiro: Movimentos>Faturamento>Nota Fiscal |
Valor INSS |
|
servico/retencao/irrf/aliquota |
Financeiro: Movimentos>Faturamento>Nota Fiscal |
Alíquota IRRF |
|
servico/retencao/irrf/valor |
Financeiro: Movimentos>Faturamento>Nota Fiscal |
Valor IRRF |
|
cidadePrestacao/codigo |
Financeiro: Cadastros > Pessoas |
Código Município relacionado ao Escritório |
|
cidadePrestacao/descricao |
Financeiro: Cadastros > Pessoas |
Município relacionado ao Escritório |
|
cidadePrestacao/bairro |
Financeiro: Cadastros > Pessoas |
Bairro |
|
cidadePrestacao/cep |
Financeiro: Cadastros > Pessoas |
Cep |
|
cidadePrestacao/complemento |
Financeiro: Cadastros > Pessoas |
Complemento Endereço |
|
cidadePrestacao/estado |
Financeiro: Cadastros > Pessoas |
Sigla Estado |
|
cidadePrestacao/logradouro |
Financeiro: Cadastros > Pessoas |
Endereço |
|
cidadePrestacao/numero |
Financeiro: Cadastros > Pessoas |
Número |
|
cidadePrestacao/tipoBairro |
Financeiro: Cadastros > Pessoas |
Bairro |
|
cidadePrestacao/tipoLogradouro |
Financeiro: Cadastros > Pessoas |
Logradouro |
|
informacoesComplementares |
Financeiro: Cadastros > Pessoas |
nulo |
|
naturezaTributacao |
Financeiro: Configurações > Configuração Escritório |
Busc do campo Natureza Tributação |
|
rps/competencia |
Financeiro: Movimentos>Faturamento>Nota Fiscal |
Data Emissão NF |
|
rps/dataEmissao |
Financeiro: Movimentos>Faturamento>Nota Fiscal |
Data Emissão NF |
|
rps/serie |
Financeiro: Movimentos>Faturamento>Nota Fiscal |
Série NF |
|
rps/numero |
Financeiro: Movimentos>Faturamento>Nota Fiscal |
Número NF |
|
parcelas/dataVencimento |
Financeiro: Movimentos>Faturamento>Nota Fiscal |
Data Emissão NF |
|
parcelas/tipoPagamento |
Financeiro: Movimentos>Faturamento>Nota Fiscal |
1 - A Vista |
|
parcelas/valor |
Financeiro: Configurações > Configuração Escritório |
Se o campo “Deduzir Ressarcimentos= Sim, “Tipo Serviço”= 2-Ressarcimento ou -2 Troco Crédito Mês anterior, o valor será: Valor Bruto – Valor Total Serviços.
|
Realizados estes procedimentos, o RPS poderá ser gerado.