Área 1 - Informações do Município
Selecione a UF e o Município onde a empresa está localizada.
Não encontrou o Município ?
Caso não tenha encontrado a cidade na UF desejada, marque a opção “Não encontrou o município” e escolha a cidade na qual deseja integração. Sua solicitação será encaminhada ao canal de suporte que dará início ao processo de homologação para disponibilizar o município.
Inscrição Municipal – Cadastre aqui a Inscrição Municipal do CNPJ que presta o serviço. (Prestador)
Integrações disponíveis do VincoDFe para a prefeitura - Aqui estão registradas as modalidades de integração implementadas na integração do VincoDFe com a prefeitura. É apenas informativo, e a seleção é automática pelo Comfort de acordo com a necessidade.
-
Assíncrono: Neste conceito de integração a prefeitura não emite a nota diretamente. Ela recebe o RPS (Recibo Provisório de Serviço) e gera a NFSe (Nota Fiscal de Serviço) posteriormente. Esse é o método de integração preferido pois evita gargalos por indisponibilidade da prefeitura e por acumulo de requisições. É o padrão em lotes.
-
Síncrono: Neste modo, a prefeitura possui o recurso de receber um RPS e gerar uma NFS-e imediatamente, retornado na mesma solicitação. Será usado caso a opção de comunicação do ERP seja síncrono.
-
Integração Assistida: Desta forma a integração é feita portal da Prefeitura. Os RPS’s serão adicionados em um arquivo que deverá ser carregado no portal da Cidade.
Inscrição Municipal – Cadastre aqui a Inscrição Municipal do CNPJ que presta o serviço. (Prestador)
Área 2 - Como o ERP se comunica com o VincoDFe
Existem duas formas de o ERP (Sistema Parceiro) se comunicar com a Vinco:
- Assíncrono:
Nesta forma, o processo de emissão se baseia no conceito de RPS (Recibo Provisório de Serviço).
O ERP deve encaminhar o serviço ao Comfort (API EndPoint RegistraServico) e depois realizar uma consulta mediante Protocolo fornecido pelo Comfort. A Consulta pode ser realizar na API pelo EndPoint ConsultarNFSe.
** Para clientes que desejam trabalhar com cenário de Lote ou integração via Extractor/DLL, este modo é o único disponível. Marque esta opção caso esteja trabalhando com estas formas de integração.
Para emissão em Lote via API verifique o EndPoints RegistraLote (Envio) e ConsultaLote (Consulta).
- Síncrono:
No modo síncrono, o ERP encaminha o serviço e o Comfort processará a requisição de modo imediato, devolvendo a NFS-e imediatamente (** conforme viabilidade prefeitura).
** Em prefeituras que não disponibilizam integração síncrona, o VincoDFe Comfort irá realizar a comunicação assíncrona com a prefeitura e simular o sincronismo com o ERP, que será controlado pelo parâmetro "RPS TimeOut Padrao". Caso o processo assíncrono não seja concluído dentro do time out especificado o Comfort devolverá um RPS com Protocolo para obtenção da nota em uma posterior consulta (EndPoint ConsultarNFSe) ou acionamento do Webhook, se configurado.
A configuração de um tempo padrão para a resposta pode ser feita na opção “RPS TimeOut Padrão”.
Este cenário é exclusivo para quem possui integração via API sem Envio em Lote.
A documentação da API está disponível em: http://comfort.vinco.com.br/swagger
Área 3 - Comportamento do VincoDFe
Integração Assistida: Esta forma destina-se a prefeituras que trabalham com a importação manual de lote em arquivo. O Comfort registra os serviços prestados (EndPoint RegistraServico ou RegistraLote) retornando os RPS’s. De acordo com a necessidade e a exigência da prefeitura, o parceiro deverá solicitar o processamento do lote para o CNPJ. Este processo é agendado e pode ser realizado no Portal do Contribuinte (Guia NFSe => RPS’s) ou no EndPoint RequisitarGeracaoLote. Um arquivo possuindo o lote de RPS’ será gerado e disponibilizado para download no Portal do Contribuinte (Guia NFSe => Integração Assistida) ou via EndPoint ConsultaLoteTXT.
- Emissão RPS: Caso deseje que o Comfort gere um RPS (Recibo Provisório de Serviços) a cada serviço enviado, marque esta opção como Sim.
- Envia E-mail: Se deseja habilitar o Envio de E-mail com a NFSe para seu cliente. Marque esta opção como Sim e a NFSe será enviada para o e-mail do Tomador da nota.
- Controle de Numeração de RPS: O Comfort possui o recurso de enumerar e controlar a numeração de RPS automaticamente. Caso queira que o Comfort controle a numeração do RPS, marque a opção Sim. Desta forma, o Comfort irá numerar os RPS's automaticamente, conforme intervalo adicionado para a série cadastrada. Caso o sistema ERP Parceiro já enumere os RPS's, marque a opção Não.
Área 4 - Configuração de Numeração
Caso escolha a opção do Comfort controlar a numeração, defina a sequência (intervalo) que a solução deve utilizar, conforme a série e PDV (Ponto de Venda/Emissão).
Informe um intervalo de Numeração Inicial e Final por PDV, juntamente com a Série, o Ambiente, e o Modelo de Documento Fiscal (NFS-e, NFC-e ou NF-e).
Em casa de NFC-e, é necessário informar o código de CSC para aquele PDV e Ambiente.
Área 5 - Automação de Captura de NFS-e recebidas
O Comfort possui o recurso de baixar as NFS-e's Recebidas (serviços tomados) automaticamente para o CNPJ cadastrado.
Escolha a UF e a Cidade, informe uma Data Inicial para que o Comfort busque as NFS-e em que o CNPJ é tomador a partir desta data.
Adicione também informações adicionais que podem ser necessários para que a consulta pode ser realizada. Usuário e Senha da Prefeitura e Token de Autorização caso a prefeitura possua.
Não encontrou o Município?
Caso não tenha encontrado a cidade na UF desejada, marque a opção “Não encontrou o município” e escolha a cidade na qual deseja integração. Sua solicitação será encaminhada ao canal de suporte que dará prosseguimento
Área 6 - Notificação de WebHook NFS-e
O Comfort possui em uma de suas funcionalidades, o WebHook, caso não conheça o funcionamento, sugerimos ler este artigo.
Nesta área é possível configurar o destino para o WebHook.