# MOTOR FISCAL # MANUAL DE USO Orientações de uso da interface Motor Fiscal # CADASTRO DE EMPRESAS ### LISTA DE EMPRESAS Relação de todas as empresas da Conta. (Grupo de empresas cadastrada no Motor Fiscal). Através dessa interface é possível visualizar a **data de vencimento do certificado** de todas as empresas **STATUS** [![image-1738171906943.png](https://docs.motorfiscal.com.br/uploads/images/gallery/2025-01/scaled-1680-/image-1738171906943.png)](https://docs.motorfiscal.com.br/uploads/images/gallery/2025-01/image-1738171906943.png) *Empresa esta bloqueada para qualquer ação e todos os seus serviços estão desativados, como Captura de Nota Fiscal, Escrituração e etc. Porém, cadastro permanece no Motor Fiscal disponível para consulta.* [![image-1736780661746.png](https://docs.motorfiscal.com.br/uploads/images/gallery/2025-01/scaled-1680-/image-1736780661746.png)](https://docs.motorfiscal.com.br/uploads/images/gallery/2025-01/image-1736780661746.png) ### INCLUIR NOVA EMPRESAS Para inserir um nova empresa, click em[![image-1736781458551.png](https://docs.motorfiscal.com.br/uploads/images/gallery/2025-01/scaled-1680-/image-1736781458551.png)](https://docs.motorfiscal.com.br/uploads/images/gallery/2025-01/image-1736781458551.png) e siga as instruções da interface[ ](https://docs.motorfiscal.com.br/uploads/images/gallery/2025-01/image-1736781410572.png)

O vinculo do **certificado digital** (etapa 2) não é obrigatório, porém pode ser necessário dependendo dos serviços no qual deseja utilizar.

[![image-1736781331689.png](https://docs.motorfiscal.com.br/uploads/images/gallery/2025-01/scaled-1680-/image-1736781331689.png)](https://docs.motorfiscal.com.br/uploads/images/gallery/2025-01/image-1736781331689.png) ### EDITAR EMPRESAS Através desta interface, é possível - **Alterar dadas cadastrais da empresa** - **Certificado digital vincula** - **Notificações** - *Usuários que serão notificados via e-mail através de eventos específicos.)* - **Tokens** - *N*ecessário para integração com outras aplicações via API quando utilizado) - **Usuários** - *Lista de usuários vinculados a empresa, possibilitando a inclusão ou remoção de usuários.* [![image-1736780936607.png](https://docs.motorfiscal.com.br/uploads/images/gallery/2025-01/scaled-1680-/image-1736780936607.png)](https://docs.motorfiscal.com.br/uploads/images/gallery/2025-01/image-1736780936607.png) # PERFIL DE USUÁRIO #### COLABORADOR **DESCRIÇÃO:** Usuário com acesso a todas as interfaces para análise dos documentos fiscais, tais como 1. Notas Fiscais de Produto 2. Conhecimento Eletrônico de Transporte 3. Notas Fiscais de Serviço 4. Fechamento do Mês [![image-1736780043153.png](https://docs.motorfiscal.com.br/uploads/images/gallery/2025-01/scaled-1680-/image-1736780043153.png)](https://docs.motorfiscal.com.br/uploads/images/gallery/2025-01/image-1736780043153.png) #### ADMINISTRADOR **DESCRIÇÃO:** Possui todos os acessos existentes no perfil colaborador e acesso ao menu de configurações, onde agrupa as rotinas 1. Empresas 2. Usuários 3. Processamento [![image-1736780209225.png](https://docs.motorfiscal.com.br/uploads/images/gallery/2025-01/scaled-1680-/image-1736780209225.png)](https://docs.motorfiscal.com.br/uploads/images/gallery/2025-01/image-1736780209225.png) # CASTRO DE USUÁRIOS ### LISTA DE USUÁRIOS Lista de todos os usuários vinculados a Conta (grupo de empresas) . [![image-1736781693593.png](https://docs.motorfiscal.com.br/uploads/images/gallery/2025-01/scaled-1680-/image-1736781693593.png)](https://docs.motorfiscal.com.br/uploads/images/gallery/2025-01/image-1736781693593.png) ### INCLUIR NOVO USUÁRIO Para inserir um nova empresa, click em[![image-1736781458551.png](https://docs.motorfiscal.com.br/uploads/images/gallery/2025-01/scaled-1680-/image-1736781458551.png)](https://docs.motorfiscal.com.br/uploads/images/gallery/2025-01/image-1736781458551.png) e siga as instruções da interface[ .](https://docs.motorfiscal.com.br/uploads/images/gallery/2025-01/image-1736781410572.png) O cadastro de novo usuário é simplificado, sendo necessário somente o preenchimento obrigatório dos campos com "\*" [![image-1736781981926.png](https://docs.motorfiscal.com.br/uploads/images/gallery/2025-01/scaled-1680-/image-1736781981926.png)](https://docs.motorfiscal.com.br/uploads/images/gallery/2025-01/image-1736781981926.png)

Para empresas que utilizando o recurso de Single Sign-On ( **SSO** ). O cadastro do usuário é realizado automaticamente conforme mediante o primeiro acesso.

# PROCESSAMENTO ### LISTA DE SOLICITAÇÕES Nesta interface são listados todos os processamento que estão em andamento. Qualquer ação do usuário que necessite de processamento em segundo plano será adicionado nesta interface para possibilitando um acompanhamento da execução. [![image-1736782409768.png](https://docs.motorfiscal.com.br/uploads/images/gallery/2025-01/scaled-1680-/image-1736782409768.png)](https://docs.motorfiscal.com.br/uploads/images/gallery/2025-01/image-1736782409768.png) # EXPORTAÇÃO PARA EXCEL ### VISÃO GERAL Os recursos descritos nesta página aplica-se para NF-e, CT-e e NFS-e #### EXPORTAÇÃO PEQUENOS VOLUME Para exportação de pequenos volumes (inferior a 3.000 registros), serão listadas todas as opções abaixo. A exportação ocorre instantaneamente, [![image-1733863733598.png](https://docs.motorfiscal.com.br/uploads/images/gallery/2024-12/scaled-1680-/image-1733863733598.png)](https://docs.motorfiscal.com.br/uploads/images/gallery/2024-12/image-1733863733598.png) #### EXPORTAÇÃO GRANDES VOLUMES Para exportação de grandes volumes (acima de 3.000 registros), será apresentada apenas a opção de envio por e-mail, Pois como o processamento pode levar alguns minutos e o tamanho do arquivo pode ser significativo, o processamento será realizado em segundo plano. Ao Termino, o usuário será notificado via e-mail com o link para download do arquivo gerado.

Exportação para Excel superiores a 50.000 linhas, serão divididos em arquivos com no máximo 50.000 linhas cada um automaticamente, porém disponibilizadas dentro do mesmo arquivo .zip IMPORTANTE: Limite de exportação 500.000 registros

[![image-1733864349078.png](https://docs.motorfiscal.com.br/uploads/images/gallery/2024-12/scaled-1680-/image-1733864349078.png)](https://docs.motorfiscal.com.br/uploads/images/gallery/2024-12/image-1733864349078.png) # EXPORTAR PARA ERP ### VISÃO GERAL Habilita a exportação da Nota Fiscal para o ERP somente após validação manual do usuário . ### RECURSOS Disponibiliza a nota fiscal para captura do ERP somente após ação manual do usuário.

Este comportamento somente se aplica a clientes que ativaram este recurso como premissa para integração com o ERP. Para ativação deste recurso, entre em contato com nossa equipe de suporte.

Botão disponível diretamente na interface de Nota Fiscal Eletrônica conforme evidencia abaixo. [![image-1751997732601.png](https://docs.motorfiscal.com.br/uploads/images/gallery/2025-07/scaled-1680-/4EH1sAjAMVT9MB3x-image-1751997732601.png)](https://docs.motorfiscal.com.br/uploads/images/gallery/2025-07/4EH1sAjAMVT9MB3x-image-1751997732601.png) # 💬 SUPORTE MOTOR FISCAL ### **🚀 Como entrar em contato com nosso time?** Você tem **duas formas super fáceis** de falar com a gente direto pelo sistema – e o melhor: **nosso atendimento é 100% humanizado!** 🤝💙 ### **💬 1. Chat de atendimento** - Clique no **ícone de conversa no canto inferior esquerdo da tela** (🗨️ *Iniciar conversa*). - Fale com uma pessoa da nossa equipe em tempo real! - Se todos estiverem ocupados, sua mensagem será registrada e responderemos por e-mail assim que possível. 😉 [![image-1748960848326.png](https://docs.motorfiscal.com.br/uploads/images/gallery/2025-06/scaled-1680-/Cwo4uTd33unUPiX1-image-1748960848326.png) ](https://docs.motorfiscal.com.br/uploads/images/gallery/2025-06/Cwo4uTd33unUPiX1-image-1748960848326.png)[![image-1748960866638.png](https://docs.motorfiscal.com.br/uploads/images/gallery/2025-06/scaled-1680-/SE7UmFqmbAn8tBqg-image-1748960866638.png)](https://docs.motorfiscal.com.br/uploads/images/gallery/2025-06/SE7UmFqmbAn8tBqg-image-1748960866638.png) ### **📨 2. Abertura de chamado** - No menu lateral, clique em **“Abrir chamado”**. - Preencha as informações e envie! - Nosso time vai analisar e te responder por e-mail. 📬 [![image-1748960919779.png](https://docs.motorfiscal.com.br/uploads/images/gallery/2025-06/scaled-1680-/F57RfDxY9l2g0Xck-image-1748960919779.png) ](https://docs.motorfiscal.com.br/uploads/images/gallery/2025-06/F57RfDxY9l2g0Xck-image-1748960919779.png)[![image-1748960963483.png](https://docs.motorfiscal.com.br/uploads/images/gallery/2025-06/scaled-1680-/zdEVFw0QpzaqaHHC-image-1748960963483.png)](https://docs.motorfiscal.com.br/uploads/images/gallery/2025-06/zdEVFw0QpzaqaHHC-image-1748960963483.png) [ ](https://docs.motorfiscal.com.br/uploads/images/gallery/2025-06/F57RfDxY9l2g0Xck-image-1748960919779.png) ### **🔁 Como funciona o atendimento?** - **Nível 1**: Análise inicial + esclarecimento de dúvidas - **Nível 2**: Correções técnicas, quando necessário ### **⚡ Para agilizar o atendimento, envie:** - Descrição do erro - Chave da nota ou número da NFS-e - Interface afetada (NF-e, CT-e etc.) - CNPJ da empresa (se aplicável) ### **💛 Conte com a gente!** Nosso time está aqui para te apoiar sempre que precisar. **Humanizado, rápido e com atenção de verdade. Fale com a gente — vai ser um prazer te ajudar! ✨😊 # NFS-e | Nota Fiscal de Serviço Eletrônica # NFS-e | Captura dados da nota - PRESTADOS ### VISÃO GERAL Detalhamento da rotinas de captura de Nota Fiscal de Serviços Eletrônica (NFSE). Serviços Prestados. ### DESCRIÇÃO A Rotina de captura de NFSE para serviços prestados, possui periodicidade de execução personalizada para cada cliente. A Captura das NFS-e ocorre através de acesso na área logada da prefeitura ou autenticação através de Web Services

Verificação de alteração de Status de NFSE já capturadas, como por exemplo "Cancelamentos" ou "Substituição", são realizados diariamente fora do horário comercial, com analise retroativa dos últimos 30 dias ou período inferior caso exista restrição na prefeitura.

#### MUNICIPIOS CONTEMPLADOS
**MUNICIPIO**
ANANINDEUA
Barueri
BELEM
Belo Horizonte
Betim
Borda da Mata
Brasília
Bueno Brandão
Cabo de Santo Agostinho
CALDAS NOVAS
Cambuí
Campinas
CANAA
CAPANEMA
Cariacica/ES
Carlos Barbosa
CASTANHAL
Congonhal
Contagem
Cotia
CUBATAO
Curitiba
Duque de Caxias
Fortaleza
GOIANÉSIA
GOIANIA
Guarapari/ES
Guarujá
Guarulhos
Ipuiúna
Itajai
ITANHANHEM
Jaboatão dos Guararapes
Jacutinga
Joinville
Jundiaí
Mogi das Cruzes
Natal
Nilópolis
Niterói
Nova Iguaçu
Nova Lima
Osasco
PARAGOMINAS
Paraisópolis
PARAUAPEBAS
Parnamirim
PIRACANJUBA
Porto Alegre
Pouso Alegre
PRAIA GRANDE
Recife
Rio de Janeiro
Sabará
Salvador
Santa Rita do Sapucaí
Santo André
Santos
São Bernardo do Campo
São Caetano do Sul
São Gonçalo
São Gonçalo do Sapucaí
São José dos Campos
São José dos Pinhais
São Luís
São Paulo
SÃO VICENTE
Serra
Serra/ES
Sete Lagoas
Taboão da Serra
Vespasiano
Viana/ES
Vila Velha/ES
Vitória/ES
# NFS-e | CAPTURA PDF - TOMADOS E PRESTADOS ## Visão Geral Esta documentação tem como objetivo explicar **como funciona**, **como está organizada** e **qual é o status atual** do processo de **captura de PDFs** no **Motor Fiscal**. Aqui você encontrará uma visão geral do fluxo, responsabilidades de cada etapa e como o sistema se comporta durante a execução das capturas. ## 🔄Visão Geral do Fluxo de Captura O fluxo de captura de PDF no Motor Fiscal segue a seguinte sequência: 1. **Leitura dos dados da Nota Fiscal:** Os dados da nota fiscal são obtidos a partir do banco de dados **PostgreSQL**, contendo informações essenciais como município, número da nota, prestador, entre outros. 2. **Execução do robô de captura:** Com base nos dados da nota, é executado um **robô específico**, que pode variar de acordo com: - Prefeitura (ex: Barueri, São Paulo, Belo Horizonte, etc.) - Ambiente Nacional de NFS-e 3. **Captura do PDF:** O robô acessa o portal correspondente, realiza as requisições necessárias e efetua a **captura do PDF da nota fiscal**. 4. **Persistência do PDF:** 5. Após a captura bem-sucedida, o PDF é: 6. - Validado - Salvo no banco de dados **PostgreSQL** - Vinculado à nota fiscal correspondente ## 🧩Organização do Processo - Cada prefeitura possui um **robô dedicado**, respeitando regras específicas de **autenticação**, **controle de sessão** e **fluxo de navegação** do portal. - O processo de captura é **totalmente automatizado** e **orquestrado por DAGs no Airflow**, que controlam a ordem de execução, paralelismo e tratamento de falhas. - Os **scripts dos robôs** são organizados em **pastas específicas por prefeitura**.Cada pasta contém: - O código do robô - Um arquivo **handler**, responsável por atuar como **gatilho (trigger)** na AWS - O **handler** é executado por uma **AWS Lambda**, que inicializa o robô correspondente e gerencia a execução da captura. - As capturas são executadas de forma **assíncrona**, permitindo o **processamento em lote** de múltiplas notas fiscais simultaneamente. ## 📌Observações Importantes - Nem todas as prefeituras possuem o mesmo padrão de acesso ao PDF. - Algumas exigem controle de sessão (ex: [ASP.NET](http://ASP.NET)), validações adicionais ou múltiplas requisições. - Falhas podem ocorrer por mudanças no portal da prefeitura, indisponibilidade do serviço ou bloqueios temporários. ## 🪵Logs e Monitoramento ### Onde acompanhar - **Airflow** - Status da DAG - Tempo de execução - Quantidade de notas processadas - Capacidade de status mais especifico - **AWS CloudWatch** - Logs detalhados da Lambda - Erros por nota fiscal - Debug de requisições - **Horus - Monitor de Integrações** - Status geral das prefeituras com mais erros - Quantidade de notas sem PDF - Quantidade de notas com erro por prefeitura ## ☕Java x 🐍 Python O processo de captura de PDFs do Motor Fiscal foi **inicialmente estruturado em Java**, sendo que, durante essa fase, a maioria dos robôs de prefeituras foi desenvolvida nessa linguagem. Com a evolução do projeto e a necessidade de maior **flexibilidade**, **rapidez de manutenção** e **facilidade de automação**, foi realizada a **migração gradual dos robôs para Python**. ### Situação Atual - A maioria dos robôs ativos hoje está implementada em **Python** - Ainda existem **robôs legados em Java** em operação - Os robôs em Java são mantidos apenas por **compatibilidade e contingência** ### Diretriz Técnica - Sempre que um **robô em Python** for desenvolvido e validado para uma prefeitura: - O robô correspondente em **Java deve ser desativado** - A captura passa a ser feita exclusivamente via Python ### Motivos da Migração - Maior facilidade de manutenção e leitura de código - Melhor integração com: - AWS Lambda - Airflow - Bibliotecas de automação (requests, Playwright, Selenium) - Redução de complexidade operacional - Agilidade na criação e correção de robôs 📌 **Observação:** O objetivo final é a **padronização total da captura de PDFs em Python**, eliminando dependências legadas em Java. ## 🏛️**Status das Prefeituras** Nesta seção da documentação, cada prefeitura que possui robô de captura de PDF, seja em **Java,** **Python** ou **ambos** terá uma **página dedicada**, contendo informações técnicas, status atual e histórico de problemas enfrentados. O objetivo é centralizar o conhecimento, facilitar manutenções futuras e dar visibilidade rápida sobre a saúde de cada integração. # NFS-e | Captura PDF - PRESTADOS E TOMADOS ### VISÃO GERAL Robotização para busca do PDF da Nota Fiscal de Serviço Eletrônica diretamente no site da prefeitura através de acesso NÃO logado Esta rotina captura PDF's de Notas Fiscais de Serviços Prestados e Tomados ### MUNICIPIOS CONTEMPLADOS
**UF****COD. MUNICIPIO****MUNICIPIO**
1500800ANANINDEUA
4201208ANTÔNIO CARLOS
2800308ARACAJU
3300209ARARUAMA
1501402BELEM
3106200BELO\_HORIZONTE
3106705BETIM
4202305BIGUAÇU
5300108BRASILIA
5204508CALDAS\_NOVAS
5002704CAMPO GRANDE
1502152CANAA DOS CARAJA
4304606CANOAS
1502400CASTANHAL
3116605CLÁUDIO
3118304CONSELHEIRO LAFAIETE
3118601CONTAGEM
4204608CRICIÚMA
4106902CURITIBA
5003702DOURADOS
3301702DUQUE\_DE\_CAXIAS
4107652FAZENDA RIO GRANDE
2910800FEIRA DE SANTANA
3126109FORMIGA
2304400FORTALEZA
5208707GOIANIA
3518800GUARULHOS
4207304IMBITUBA
3131307IPATINGA
4208203ITAJAI
3524402JACAREI
4208906JARAGUÁ DO SUL
2507507JOAO\_PESSOA
3136702JUIZ DE FORA
4209300LAGES
3137601LAGOA SANTA
2919207LAURO DE FREITAS
4113700LONDRINA
1302603MANAUS
3530607MOGI DAS CRUZES
2408102NATAL
4211306NAVEGANTES
3303302NITEROI
3303500NOVA\_IGUACU
3144805NOVA LIMA
3534401OSASCO
1505536PARAUAPEBAS
3538006PINDAMONHANGABA
4119905PONTA GROSSA
4314902PORTO\_ALEGRE
3541406PRESIDENTE\_PRUDENTE
2611606RECIFE
3304201RESENDE
3543402RIBEIRAO\_PRETO
3543907RIO CLARO
3304557RIO DE JANEIRO
2927408SALVADOR
3548500SANTOS
3548708SAO BERNARDO DO CAMPO
4216305SÃO JOÃO BATISTA
4217006SÃO LUDGERO
4217204SÃO MIGUEL DO OESTE
3549805SAO\_JOSE\_DO\_RIO\_PRETO
3549904SAO JOSE DOS CAMPOS
4125506SAO\_JOSE\_DOS\_PINHAIS
3550308SAO PAULO
3205002SERRA
3552502SUZANO
3554102TAUBATE
3170206UBERLANDIA
3171204VESPASIANO
3205200VILA VELHA
3205309VITORIA
# NFS-e | Captura dados da nota - TOMADOS ### VISÃO GERAL Detalhamento da rotinas de captura de Nota Fiscal de Serviços Eletrônica (NFSE). Serviços Tomados. ### DESCRIÇÃO A Rotina de captura de NFSE para serviços Tomados, possui periodicidade de execução personalizada para cada cliente. #### MUNICIPIOS CONTEMPLADOS *Além dos municípios presentes no Ambiente Nacional*
**Município****Provedor****WebService****Login/Senha****Certificado****Necessita Cadastro****OBS**
Feira de santanaWebISSSimNãoSim-
Boa esperancaBethaSimNãoNão-
SapucaiaBethaSimNãoNão-
ResendeBethaSimNãoNão-
TorresBethaSimNãoNão-
MaracajuBethaSimNãoNão-
AnchietaBethaSimNãoNão-
Capao da canoaBethaSimNãoNão-
Faxinal dos guedesBethaSimNãoNão-
ParanacityBethaSimNãoNão-
UbirataGovBRSimNão--
Porto felizGovBRSimNão--
CaarapoBethaSimNãoNão-
ExtremaWebISSSimNãoSim-
LuzBethaSimNãoNão-
MucuriBethaSimNãoNão-
MirassolGovBRSimNão--
TangaraBethaSimNãoNão-
PalmitosBethaSimNãoNão-
Paula freitasBethaSimNãoNão-
DouradosBethaSimNãoNão-
JuazeiroWebISSSimNãoSim-
JambeiroBethaSimNãoNão-
ItaquiraiBethaSimNãoNão-
AracajuWebISSSimNãoSim-
Balneario rincaoBethaSimNãoNão-
BarueriPróprio----
FloraiBethaSimNãoNão-
Sao joao batistaBethaSimNãoNão-
JaibaWebISSSimNãoSim-
CapinzalBethaSimNãoNão-
TunapolisBethaSimNãoNão-
Lagoa da prataBethaSimNãoNão-
FigueiraBethaSimNãoNão-
FormigaWebISSSimNãoSim-
Sao carlos do ivaiBethaSimNãoNão-
GurupiWebISSSimNãoSim-
VilhenaWebISSSimNãoSim-
Feira de santanaWebISSSimNãoSim-
Ponte serradaBethaSimNãoNão-
Herval doesteBethaSimNãoNão-
Porto uniaoBethaSimNãoNão-
Rio brilhanteBethaSimNãoNão-
IpumirimBethaSimNãoNão-
TeresopolisWebISSSimNãoSim-
JaguariBethaSimNãoNão-
Sao roqueGovBRSimNão--
CriciúmaBethaSimNãoNão-
BandeirantesBethaSimNãoNão-
ArmazemBethaSimNãoNão-
Lauro mullerWebISSSimNãoSim-
CanaranaBethaSimNãoNão-
CongonhinhasBethaSimNãoNão-
LagunaBethaSimNãoNão-
Campo magroBethaSimNãoNão-
SacramentoBethaSimNãoNão-
CriciumaBethaSimNãoNão-
BarbacenaWebISSSimNãoSim-
Rio de janeiroTIPLANNãoNãoSim-
Sao lourencoWebISSSimNãoSim-
Monte casteloBethaSimNãoNão-
Fazenda rio grandeBethaSimNãoNão-
Erval velhoBethaSimNãoNão-
ArcosWebISSSimNãoSim-
SchroederBethaSimNãoNão-
Sao pedroGovBRSimNão--
CongonhasBethaSimNãoNão-
Uniao da vitoriaBethaSimNãoNão-
ItatiaiaBethaSimNãoNão-
OrleansBethaSimNãoNão-
MandiritubaBethaSimNãoNão-
OrtigueiraBethaSimNãoNão-
Santa ceciliaBethaSimNãoNão-
ClaudioBethaSimNãoNão-
MaracajaBethaSimNãoNão-
ItatiaiucuBethaSimNãoNão-
ItabiraGovBRSimNão--
Paulo lopesBethaSimNãoNão-
MangueirinhaBethaSimNãoNão-
DivinópolisBethaSimNãoNão-
XanxereBethaSimNãoNão-
SapezalBethaSimNãoNão-
Campos novosBethaSimNãoNão-
DivinopolisBethaSimNãoNão-
Campina grandeWebISSSimNãoSim-
ResendeBethaSimNãoNão-
HumaitaBethaSimNãoNão-
LobatoBethaSimNãoNão-
BatataisBethaSimNãoNão-
General carneiroBethaSimNãoNão-
Sao mateus do sulBethaSimNãoNão-
Montes clarosGovBRSimNão--
Sao domingosBethaSimNãoNão-
PalmasWebISSSimNãoSim-
SombrioBethaSimNãoNão-
Porto nacionalWebISSSimNãoSim-
Sao ludgeroBethaSimNãoNão-
Dionisio cerqueiraBethaSimNãoNão-
Sao joao nepomucenoBethaSimNãoNão-
PinheiralBethaSimNãoNão-
XaximBethaSimNãoNão-
Nova xavantinaBethaSimNãoNão-
Paraiso do tocantinsWebISSSimNãoSim-
LagesBethaSimNãoNão-
JoacabaBethaSimNãoNão-
SideropolisBethaSimNãoNão-
Nova andradinaBethaSimNãoNão-
SangaoBethaSimNãoNão-
Ouro brancoBethaSimNãoNão-
ButiaGovBRSimNão--
Wenceslau brazBethaSimNãoNão-
Santa fe do sulBethaSimNãoNão-
ItabunaWebISSSimNãoSim-
SarzedoBethaSimNãoNão-
ImbitubaBethaSimNãoNão-
Cerro azulBethaSimNãoNão-
SaquaremaGovBRSimNão--
Cachoeiras de macacuBethaSimNãoNão-
GuaporeGovBRSimNão--
Teodoro sampaioGovBRSimNão--
ItaguaraBethaSimNãoNão-
JaguaraoGovBRSimNão--
Paraiba do sulGovBRSimNão--
MandaguacuBethaSimNãoNão-
IpiraBethaSimNãoNão-
MarianaBethaSimNãoNão-
AraguainaWebISSSimNãoSim-
AlagoinhasWebISSSimNãoSim-
CandeiasWebISSSimNãoSim-
São pauloPróprioSimNãoSim-
Cornelio procopioBethaSimNãoNão-
JaguariaivaBethaSimNãoNão-
Lucas do rio verdeBethaSimNãoNão-
AlfenasBethaSimNãoNão-
Cocal do sulBethaSimNãoNão-
Sao miguel do oesteBethaSimNãoNão-
Sao jorge do ivaiBethaSimNãoNão-
Barra do piraiWebISSSimNãoSim-
MaravilhaBethaSimNãoNão-
Sao joaquimBethaSimNãoNão-
Coronel freitasBethaSimNãoNão-
Nova auroraBethaSimNãoNão-
BrumadoWebISSSimNãoSim-
Nova petropolisGovBRSimNão--
Otacilio costaBethaSimNãoNão-
ComodoroBethaSimNãoNão-
Antonio carlosBethaSimNãoNão-
Santa rosa de viterboBethaSimNãoNão-
Agudos do sulBethaSimNãoNão-
Belo orienteBethaSimNãoNão-
OurizonaBethaSimNãoNão-
MondaiBethaSimNãoNão-
UrussangaBethaSimNãoNão-
Almirante tamandareBethaSimNãoNão-
CanelinhaBethaSimNãoNão-
Conselheiro lafaieteBethaSimNãoNão-
NepomucenoBethaSimNãoNão-
Santo amaro da imperatrizBethaSimNãoNão-
UrubiciBethaSimNãoNão-
Sao jose dos camposDSFNETNãoSimNãoSim
TimoteoBethaSimNãoNão-
OrlandiaBethaSimNãoNão-
SaltinhoBethaSimNãoNão-
ForquilhinhaBethaSimNãoNão-
QueimadosWebISSSimNãoSim-
GoioereBethaSimNãoNão-
NavegantesBethaSimNãoNão-
RecifeTIPLANNãoNãoSim-
Conselheiro lafaieteBethaSimNãoNão-
IomereBethaSimNãoNão-
PinhalaoBethaSimNãoNão-
CaeteGovBRSimNão--
Aguas mornasBethaSimNãoNão-
AraguatinsWebISSSimNãoSim-
DianopolisWebISSSimNãoSim-
BarracaoBethaSimNãoNão-
Vera cruz do oesteBethaSimNãoNão-
CampinasIMA-SimSimSIMLogin e Senha ou Certificado
Itaguacu da bahiaBethaSimNãoNão-
AssaiBethaSimNãoNão-
Caldas novasWebISSSimNãoSim-
GuaranesiaBethaSimNãoNão-
Sao lourenco do oesteBethaSimNãoNão-
MantenaBethaSimNãoNão-
Santo antonio de jesusWebISSSimNãoSim-
Barra dos coqueirosWebISSSimNãoSim-
Alto paranaBethaSimNãoNão-
BageWebISSSimNãoSim-
VitorinoBethaSimNãoNão-
GuanambiWebISSSimNãoSim-
Jaragua do sulBethaSimNãoNão-
Braco do norteBethaSimNãoNão-
AriquemesFiorilliSimSimNãoSim
CabixiFiorilliSimSimNãoSim
CerejeirasFiorilliSimSimNãoSim
CorumbiaraFiorilliSimSimNãoSim
EspigãoFiorilliSimSimNãoSim
JaruFiorilliSimSimNãoSim
JiFiorilliSimSimNãoSim
MachadinhoFiorilliSimSimNãoSim
OuroFiorilliSimSimNãoSim
PresidenteFiorilliSimSimNãoSim
AltoFiorilliSimSimNãoSim
BuritisFiorilliSimSimNãoSim
NovoFiorilliSimSimNãoSim
ChupinguaiaFiorilliSimSimNãoSim
BonfimFiorilliSimSimNãoSim
CanaãFiorilliSimSimNãoSim
ItaitubaFiorilliSimSimNãoSim
NovaFiorilliSimSimNãoSim
PauFiorilliSimSimNãoSim
RioFiorilliSimSimNãoSim
SãoFiorilliSimSimNãoSim
TailândiaFiorilliSimSimNãoSim
TucumãFiorilliSimSimNãoSim
PortoFiorilliSimSimNãoSim
AragominasFiorilliSimSimNãoSim
AugustinópolisFiorilliSimSimNãoSim
AltoFiorilliSimSimNãoSim
BacabeiraFiorilliSimSimNãoSim
EstreitoFiorilliSimSimNãoSim
ItingaFiorilliSimSimNãoSim
LagoFiorilliSimSimNãoSim
MiradorFiorilliSimSimNãoSim
MorrosFiorilliSimSimNãoSim
PedreirasFiorilliSimSimNãoSim
SãoFiorilliSimSimNãoSim
SítioFiorilliSimSimNãoSim
CapitãoFiorilliSimSimNãoSim
ParnaíbaFiorilliSimSimNãoSim
PedroFiorilliSimSimNãoSim
PicosFiorilliSimSimNãoSim
ValençaFiorilliSimSimNãoSim
CachoeirinhaFiorilliSimSimNãoSim
DormentesFiorilliSimSimNãoSim
LagoaFiorilliSimSimNãoSim
TrindadeFiorilliSimSimNãoSim
VerdejanteFiorilliSimSimNãoSim
InhapiFiorilliSimSimNãoSim
RioFiorilliSimSimNãoSim
VeraFiorilliSimSimNãoSim
CamanducaiaFiorilliSimSimNãoSim
CórregoFiorilliSimSimNãoSim
EstivaFiorilliSimSimNãoSim
HeliodoraFiorilliSimSimNãoSim
JacutingaFiorilliSimSimNãoSim
MonteFiorilliSimSimNãoSim
OuroFiorilliSimSimNãoSim
SapucaíFiorilliSimSimNãoSim
CardosoFiorilliSimSimNãoSim
ÁguasFiorilliSimSimNãoSim
AltairFiorilliSimSimNãoSim
AltinópolisFiorilliSimSimNãoSim
ÁlvaresFiorilliSimSimNãoSim
AlvinlândiaFiorilliSimSimNãoSim
AméricoFiorilliSimSimNãoSim
AraçoiabaFiorilliSimSimNãoSim
AssisFiorilliSimSimNãoSim
BadyFiorilliSimSimNãoSim
BálsamoFiorilliSimSimNãoSim
BarãoFiorilliSimSimNãoSim
BaririFiorilliSimSimNãoSim
BarraFiorilliSimSimNãoSim
BraúnaFiorilliSimSimNãoSim
BrodowskiFiorilliSimSimNãoSim
CabráliaFiorilliSimSimNãoSim
CafelândiaFiorilliSimSimNãoSim
CajobiFiorilliSimSimNãoSim
CândidoFiorilliSimSimNãoSim
CapelaFiorilliSimSimNãoSim
CatanduvaFiorilliSimSimNãoSim
CedralFiorilliSimSimNãoSim
ClementinaFiorilliSimSimNãoSim
ColômbiaFiorilliSimSimNãoSim
CosmoramaFiorilliSimSimNãoSim
DracenaFiorilliSimSimNãoSim
DuartinaFiorilliSimSimNãoSim
FernandópolisFiorilliSimSimNãoSim
FernandoFiorilliSimSimNãoSim
FernãoFiorilliSimSimNãoSim
GabrielFiorilliSimSimNãoSim
GarçaFiorilliSimSimNãoSim
GuaiçaraFiorilliSimSimNãoSim
GuaimbêFiorilliSimSimNãoSim
GuapiaçuFiorilliSimSimNãoSim
GuaráFiorilliSimSimNãoSim
GuaraçaíFiorilliSimSimNãoSim
GuararapesFiorilliSimSimNãoSim
HolambraFiorilliSimSimNãoSim
IbatéFiorilliSimSimNãoSim
IbitingaFiorilliSimSimNãoSim
IepêFiorilliSimSimNãoSim
IgarapavaFiorilliSimSimNãoSim
IndiaporãFiorilliSimSimNãoSim
InúbiaFiorilliSimSimNãoSim
IpuãFiorilliSimSimNãoSim
ItaberáFiorilliSimSimNãoSim
ItajobiFiorilliSimSimNãoSim
JoséFiorilliSimSimNãoSim
JunqueirópolisFiorilliSimSimNãoSim
LaranjalFiorilliSimSimNãoSim
LindóiaFiorilliSimSimNãoSim
LupércioFiorilliSimSimNãoSim
LutéciaFiorilliSimSimNãoSim
MartinópolisFiorilliSimSimNãoSim
MiguelópolisFiorilliSimSimNãoSim
MirandópolisFiorilliSimSimNãoSim
MongaguáFiorilliSimSimNãoSim
MonteFiorilliSimSimNãoSim
MonteFiorilliSimSimNãoSim
MonteFiorilliSimSimNãoSim
MorungabaFiorilliSimSimNãoSim
MotucaFiorilliSimSimNãoSim
NovaFiorilliSimSimNãoSim
NovaFiorilliSimSimNãoSim
NovoFiorilliSimSimNãoSim
OrienteFiorilliSimSimNãoSim
PalmaresFiorilliSimSimNãoSim
PanoramaFiorilliSimSimNãoSim
PatrocínioFiorilliSimSimNãoSim
PauloFiorilliSimSimNãoSim
PedreiraFiorilliSimSimNãoSim
PiacatuFiorilliSimSimNãoSim
PilarFiorilliSimSimNãoSim
PirajuíFiorilliSimSimNãoSim
PirangiFiorilliSimSimNãoSim
PirapozinhoFiorilliSimSimNãoSim
PontalFiorilliSimSimNãoSim
PotirendabaFiorilliSimSimNãoSim
PradópolisFiorilliSimSimNãoSim
PromissãoFiorilliSimSimNãoSim
QuatáFiorilliSimSimNãoSim
QueirozFiorilliSimSimNãoSim
RibeirãoFiorilliSimSimNãoSim
RioFiorilliSimSimNãoSim
RiolândiaFiorilliSimSimNãoSim
RosanaFiorilliSimSimNãoSim
SabinoFiorilliSimSimNãoSim
SalesFiorilliSimSimNãoSim
SalesFiorilliSimSimNãoSim
SantaFiorilliSimSimNãoSim
SantanaFiorilliSimSimNãoSim
SantaFiorilliSimSimNãoSim
SantoFiorilliSimSimNãoSim
SantoFiorilliSimSimNãoSim
SãoFiorilliSimSimNãoSim
SãoFiorilliSimSimNãoSim
SãoFiorilliSimSimNãoSim
SerraFiorilliSimSimNãoSim
SerraFiorilliSimSimNãoSim
SeveríniaFiorilliSimSimNãoSim
SudFiorilliSimSimNãoSim
TabapuãFiorilliSimSimNãoSim
TaquaritubaFiorilliSimSimNãoSim
UbaranaFiorilliSimSimNãoSim
UrâniaFiorilliSimSimNãoSim
VeraFiorilliSimSimNãoSim
ViradouroFiorilliSimSimNãoSim
AntônioFiorilliSimSimNãoSim
MarauFiorilliSimSimNãoSim
QuatroFiorilliSimSimNãoSim
SerafinaFiorilliSimSimNãoSim
TrêsFiorilliSimSimNãoSim
AmambaiFiorilliSimSimNãoSim
AnastácioFiorilliSimSimNãoSim
AparecidaFiorilliSimSimNãoSim
AquidauanaFiorilliSimSimNãoSim
BonitoFiorilliSimSimNãoSim
ChapadãoFiorilliSimSimNãoSim
CorumbáFiorilliSimSimNãoSim
DoisFiorilliSimSimNãoSim
IguatemiFiorilliSimSimNãoSim
IvinhemaFiorilliSimSimNãoSim
JutiFiorilliSimSimNãoSim
MirandaFiorilliSimSimNãoSim
NovaFiorilliSimSimNãoSim
ParanaíbaFiorilliSimSimNãoSim
RibasFiorilliSimSimNãoSim
TrêsFiorilliSimSimNãoSim
AraguainhaFiorilliSimSimNãoSim
BomFiorilliSimSimNãoSim
BrasnorteFiorilliSimSimNãoSim
CocalinhoFiorilliSimSimNãoSim
JaciaraFiorilliSimSimNãoSim
LambariFiorilliSimSimNãoSim
MirassolFiorilliSimSimNãoSim
NovaFiorilliSimSimNãoSim
PontalFiorilliSimSimNãoSim
SãoFiorilliSimSimNãoSim
MontividiuFiorilliSimSimNãoSim
RioFiorilliSimSimNãoSim
# INFORMAÇÕES TÉCNICAS Especificação API's de integração com Motor Fiscal # MOTOR FISCAL -> ZAPIER | Integração via Webhook ### NFSE - Webhook ##### GATILHO Recebimento de uma Nota Fiscal de Serviço Eletrônica (NFSE) pelo Motor Fiscal, através de integração direta com a Prefeitura ou Processamento via OCR. ##### BODY - REQUEST ```JSON { "tipo": "recebida", "statusNFe": "Normal", "codMun": "3203130", "customValues": [], "COFINS": 7073.33, "CSLL": 2357.78, "INSS": 25935.54, "IR": 2357.78, "ISS": 11788.88, "ISSRetido": "true", "PIS": 1532.55, "UFPrestador": "ES", "aliqServico": "5", "cepPrestador": "29680-000", "cidadePrestador": "João Neiva", "cnpjCpfPrestador": "36557131000165", "cnpjCpfTomador": "34562939000131", "codServico": "7.10", "codVerificacao": "3140C8B381981FASDG12445A74741A07E9D1", "deducoes": 0, "descServico": "Limpeza, manutenção e conservação de vias e logradouros públicos, imóveis, chaminés, piscinas, parques, jardins e congeneres ", "discriminacao": "Prestacao de servicos de limpeza no posto de Vitoria/ES de acordo com o contrato 19.08.2012. Referente aos servicos prestados em Novembro de 2023. No Pedido 132461", "dtEmissaoNfe": "2023-12-19T12:00:00.000Z", "dtEmissaoRPS": "2023-12-19T12:00:00.000Z", "emailPrestador": "teste@compila.com.br", "enderecoPrestador": "AV.PAULISTA, 2006 ", "inscPrestador": "451.441", "inscTomador": "", "inscriEsPrestador": "", "lei": { "codigo": "7.10", "descricao": "Limpeza, manutenção e conservação de vias e logradouros públicos, imóveis, chaminés, piscinas, parques, jardins e congeneres " }, "nome_municipio": "João Neiva", "numLote": "", "numRPS": "3413", "numeroNfe": "28426", "simples_nacional": { "descricao": "Optante - Microempreendedor Individual (MEI)" }, "outrasRetencoes": 0, "prefeitura": "João Neiva", "razaoPrestador": "COMPILA PROCESSAMENTO DE DADOS LTDA ", "razaoTomador": "Posto do Sudeste do Brasil S.A.", "serie": "", "serieRPS": "NF", "telefonePrestador": "", "tribNfe": "U0", "vlrCredito": 0, "vlrServico": 235777.6 } ``` ##### BODY - ESPECIFICAÇÃO
**ELEMENTO****TP****DESCRICAO**
tipoSOpções: rebida / emitada
statusNFeSOpções: Normal / Cancelada / Substituida
codMunSCodigo Municipio padrao IBGE
customValuesSCampos customizados criados pelo usuário dentro da plataforma Motor Fiscal
COFINSNValor COFINS
CSLLNValor CSLL
INSSNValor INSS
IRNValor IR
ISSNValor ISS
ISSRetidoS"true" / "false"
PISNValor PIS
UFPrestadorSSigla UF
aliqServicoNAlíquota de Serviço (ISS)
cepPrestadorSCep Prestador
cidadePrestadorSCidade Prestador
cnpjCpfPrestadorSCNPJ ou CPF do Prestador
cnpjCpfTomadorSCNPJ ou CPF do Tomador
codServicoSCódigo do Serviço
codVerificacaoSCódigo de Verificação, Código de Autenticidade
deducoesSValor das deduções
descServicoSDescrição dos serviços
discriminacaoSDiscriminação dos Serviços
dtEmissaoNfeSData Emissão Nota Fiscal
dtEmissaoRPSSData Emissão Recibo Provisório de Serviço (RPS)
emailPrestadorSEmail Prestador
enderecoPrestadorSEndereço Prestador
inscPrestadorSInscrição Municipal Prestador
inscTomadorSInscrição Municipal Tomador
inscriEsPrestadorSInscrição Estadual Prestador
lei -> codigoSCódigo do Serviço mediante a lei 116
lei -> descricaoSDescrição do Serviço mediante a lei 116
nome\_municipioSNome Município Prestador
numLoteSNumero do Lote
numRPSSNumero da Recibo Provisório de Serviço (RPS)
numeroNfeSNumero da Nota Fiscal
simples_nacional ->
descricao
S
Descrição se prestador é Optante pelo Simples ? Exemplo: "Optante - Microempreendedor Individual (MEI)"
outrasRetencoesNValor outras deduções
prefeituraSPrefeitura
razaoPrestadorSRazão Social Prestador
razaoTomadorSRazão Social Tomador
serieSSerie da Nota Fiscal
serieRPSSSerie da Recibo Provisório de Serviço (RPS)
telefonePrestadorSTelefone Prestador
tribNfeS
**Tipos****Descrição**
TTributado em São Paulo.
FTributado Fora de São Paulo.
ATributado em São Paulo, porém Isento.
BTributado Fora de São Paulo, porém Isento.
DTributado em São Paulo com isenção parcia.
MTributado em São Paulo, porém com indicação de imunidade subjetiva.
NTributado Fora de São Paulo, porém com indicação de imunidade subjetiva.
RTributado em São Paulo, porém com indicação de imunidade objetiva.
STributado fora de São Paulo, porém com indicação de imunidade objetiva.
XTributado em São Paulo, porém Exigibilidade Suspensa.
VTributado Fora de São Paulo, porém Exigibilidade Suspensa.
PExportação de Serviços.
U0Upload, sem informação de tributação.
vlrCreditoNValor do Crédito
vlrServicoNValor total do serviço
# MOTOR FISCAL -> ZAPIER | Integration by Webhook ### NFSE - Webhook ##### TRIGGER Reception of Eletronic Service Invoice (NFSE) by Motor Fiscal, through direct integration with Municipality or OCR processing. ##### BODY - REQUEST ```JSON { "tipo": "received", "statusNFe": "Normal", "codMun": "3203130", "customValues": [], "COFINS": 7073.33, "CSLL": 2357.78, "INSS": 25935.54, "IR": 2357.78, "ISS": 11788.88, "ISSRetido": "true", "PIS": 1532.55, "UFPrestador": "ES", "aliqServico": "5", "cepPrestador": "29680-000", "cidadePrestador": "João Neiva", "cnpjCpfPrestador": "36557131000165", "cnpjCpfTomador": "34562939000131", "codServico": "7.10", "codVerificacao": "3140C8B381981FASDG12445A74741A07E9D1", "deducoes": 0, "descServico": "Cleaning, maintenance and conservation of public roads and places, properties, chimneys, swimming pools, parks, gardens and similar", "discriminacao": "Provision of cleaning services at the Vitória/ES station in accordance with contract 19.08.2012. Referring to services provided in November 2023. In Order 132461", "dtEmissaoNfe": "2023-12-19T12:00:00.000Z", "dtEmissaoRPS": "2023-12-19T12:00:00.000Z", "emailPrestador": "teste@compila.com.br", "enderecoPrestador": "AV.PAULISTA, 2006 ", "inscPrestador": "451.441", "inscTomador": "", "inscriEsPrestador": "", "lei": { "codigo": "7.10", "descricao": "Cleaning, maintenance and conservation of public roads and places, properties, chimneys, swimming pools, parks, gardens and similar" }, "nome_municipio": "João Neiva", "numLote": "", "numRPS": "3413", "numeroNfe": "28426", "simples_nacional": { "descricao": "Opting - Individual Microentrepreneur (MEI)" }, "outrasRetencoes": 0, "prefeitura": "João Neiva", "razaoPrestador": "COMPILA PROCESSAMENTO DE DADOS LTDA ", "razaoTomador": "Posto do Sudeste do Brasil S.A.", "serie": "", "serieRPS": "NF", "telefonePrestador": "", "tribNfe": "U0", "vlrCredito": 0, "vlrServico": 235777.6 } ``` ##### BODY - ESPECIFICAÇÃO
**ELEMENT****ID****TYPE****DESCRIPTION**
tipotypestringOptions: received/outgoing
statusNFeStatus NFSE stringOptions: Normal / Canceled / Replaced
codMunCity CodestringCity code - IBGE standard
customValuesCustom ValuesstringCustom fields created by user inside the Motor Fiscal plataform
COFINSLabelNumberCOFINS value
CSLLLabelNumberCSLL value
INSSLabelNumberINSS value
IRLabelNumberIR value
ISSLabelNumberISS value
ISSRetidoLabelstring"true" / "false"
PISLabelNumberPIS value
UFPrestadorService Provider StatestringUF value
aliqServicoPercent Tax Service NumberService aliquot (ISS)
cepPrestadorService Provider Zip code stringZip code of Service Provider
cidadePrestadorService Provider City stringService Provider City
cnpjCpfPrestadorCNPJ of Service Provider stringCNPJ or CPF of Service Provider
cnpjCpfTomadorCNPJ of Service TakerstringCNPJ or CPF of Service Taker
codServicoService CodestringService code
codVerificacaoVerification code of invoicestringVerification code, Autenticity code
deducoesdedutionsNumberDedutions values
descServicoService descriptionstringService description
discriminacaoDetailed Service descriptionstringDetailed Service description
dtEmissaoNfeEmission date of NFSEDatetimeInvoice date of issue
dtEmissaoRPSEmission date of RPS DatetimeProvisional Service Receipt (RPS) date of issue
emailPrestadoremail of Service ProviderstringService Provider Email
enderecoPrestadorAdress of Service ProviderstringService Provider adress
inscPrestadorService Provider Municipal inscription stringService Provider Municipal inscription
inscTomadorService Taker Municipal inscription stringService Taker Municipal inscription
inscriEsPrestadorService Provider State inscription stringService Provider State inscription
lei -> codigolaw -> codestringService code through law 116
lei -> descricaolaw -> descriptionstringService description through law 116
nome\_municipioname\_citystringService provider City name
numLoteBatch numberstringBatch number
numRPSNumber of RPSstringProvisional Service Receipt (RPS) Number
numeroNfeNfe numberstringInvoice number
simples_nacional ->
descricao
simples_nacional -> description
string
Is service provider opting for Simples?
Example: "Opting - Individual Microentrepreneur (MEI)"
outrasRetencoesOther retentionsNumberOther retentions values
prefeituramunicipalitystringmunicipality
razaoPrestadorService Provider Company namestringService Provider Company name
razaoTomadorService Taker Company namestringService Taker Company name
serieseriesstringInvoice series
serieRPSRPS seriesstringProvisional Service Receipt (RPS) Series
telefonePrestadorService Provider phonestringService Provider phone
tribNfeNfe taxstring
**Tipos****Descrição**
TTaxed in São Paulo.
FTaxed out of São Paulo.
ATaxed in São Paulo, but with total exemption.
BTaxed out of São Paulo, but with total exemption.
DTaxed in São Paulo with partial exemption.
MTaxed in São Paulo, but with subjective immunity indication.
NTaxed out of São Paulo, but with subjective immunity indication.
RTaxed in São Paulo, but with objective immunity indication.
STaxed out of São Paulo, but with objective immunity indication.
XTaxed in São Paulo, but suspended collection.
VTaxed out of São Paulo, but suspended collection.
PExport of services
U0Upload, without tax information.
vlrCreditoCredited tax value NumberCredited tax value
vlrServicoTotal service valueNumberTotal service value
# Single Sign On - SSO - Motor Fiscal O Motor Fiscal Docs suporta autenticação por Microsoft Entra ID (antigo Azure Active Directory) como alternativa ao login por usuário e senha. A autenticação é feita via protocolo SAML com suporte a Single Sign-On (SSO), permitindo que usuários utilizem suas credenciais corporativas Microsoft para acesso à aplicação. [![entra.png](https://docs.motorfiscal.com.br/uploads/images/gallery/2025-05/scaled-1680-/MfXGFzZThlg2aOAD-entra.png)](https://docs.motorfiscal.com.br/uploads/images/gallery/2025-05/MfXGFzZThlg2aOAD-entra.png) As telas abaixo mostram as mensagens exibidas caso o usuario não tenha privilégios de administrador, e caso tenha os privilégios. [![SSO.png](https://docs.motorfiscal.com.br/uploads/images/gallery/2025-05/scaled-1680-/GtYqdxj84MoK3nWI-sso.png)](https://docs.motorfiscal.com.br/uploads/images/gallery/2025-05/GtYqdxj84MoK3nWI-sso.png) # Notas de Atualização ## NOTAS DE RELEASE Este documento apresenta as principais atualizações, melhorias e novas funcionalidades implementadas no sistema. ### **Junho de 2025** ### 30/06/2025 #### Integração com a Prefeitura de Belém Adicionada nova integração para busca de notas fiscais em PDF da prefeitura de Belém. #### Limite para Exportação em Excel Limitada a exportação de planilhas Excel para até 500 mil registros, visando melhoria de desempenho. ### 20/06/2025 #### Busca de PDFs em Novos Municípios Sistema agora realiza busca automática de arquivos PDF em novos municípios. ### 14/06/2025 #### Exportação de XML Padrão ABRASF 2.0 Disponibilizada exportação de XML padrão ABRASF 2.0 para todas as notas de NFSe. ### 12/06/2025 #### Painel de Monitoramento de Serviços Novo painel para monitoramento em tempo real dos serviços ativos no sistema. ### 05/06/2025 #### Exportação de Relatórios para Múltiplas Empresas Adicionada funcionalidade que permite a exportação de relatórios consolidados de múltiplas empresas. --- ### **Maio de 2025** ### 22/05/2025 #### Abertura de Chamados pela Plataforma Implementada funcionalidade para abertura de chamados de suporte diretamente pela plataforma. ### 05/05/2025 #### Menu de Acompanhamento de Upload de PDFs Novo menu inserido para acompanhamento dos uploads de arquivos PDF realizados pelos usuários. --- ## **Abril de 2025** ### 28/04/2025 #### Botão para Escrituração de Notas Disponibilizado botão direto para escrituração de notas fiscais, facilitando o processo de registro. ### 28/04/2025 #### Tabela de Usuários com Data do Último Login Incluída nova coluna na tabela de usuários exibindo a data do último login. ### 10/04/2025 #### Ativação de Serviços de Captura de Notas Usuários agora podem ativar diretamente os serviços de captura de notas fiscais através da interface do sistema. --- ## **Março de 2025** ### 30/03/2025 #### Menu de Acompanhamento de Exportações Adicionado novo menu para visualização e acompanhamento do status das exportações realizadas no sistema. ### 01/03/2025 #### Implementação do Single Sign-On (SSO) Sistema agora permite autenticação via Single Sign-On, proporcionando maior segurança e praticidade no acesso. ## **Janeiro de 2026** ### **29/01/2026** ## Criação de Coluna: Chave do CT-e Substituído Disponibilizada nova coluna na aba de consulta para exibição da **chave do CT-e substituído**. A melhoria amplia a rastreabilidade das informações e facilita a conferência dos documentos fiscais vinculados. --- ## Filtro por Data de Escrituração + Nova Coluna Incluído o **filtro por data de escrituração** na aba de consulta, permitindo análises mais precisas e refinadas. A informação também passa a estar disponível em **coluna específica para visualização**, proporcionando mais organização e agilidade na conferência dos dados. [![image-1771261576033.png](https://docs.motorfiscal.com.br/uploads/images/gallery/2026-02/scaled-1680-/r48uPfmEzEnLWyw2-image-1771261576033.png)](https://docs.motorfiscal.com.br/uploads/images/gallery/2026-02/r48uPfmEzEnLWyw2-image-1771261576033.png) ### 26/01/2025 #### LOG DE ALTERAÇÃO entidade USUÁRIO, EMPRESAS E SERVIÇOS. *Agora é possível rastrearmos qualquer alteração realizada nestes serviços.* *Detalhamento básico da consulta (obs.: IMPORTANTE: Log de alteração neste momento somente é possível a consulta pela equipe tecnica diretamente no banco de dados. )* #### IMPRESSÃO NFS-e *Correções e melhorias na impressão NFS-e Nacional deixando mais próxima do ambiente nacional* ## **Fevereiro de 2026** ### **13/02/2026** ## Nova Funcionalidade: Indicação da Última Integração com o ERP Disponibilizada nova funcionalidade no Motor Fiscal que **indica a data e horário da última integração realizada com o ERP**. A melhoria proporciona maior visibilidade sobre o status das integrações, facilitando o acompanhamento das atualizações e aumentando a segurança no monitoramento das informações sincronizadas. [![image-1771261677092.png](https://docs.motorfiscal.com.br/uploads/images/gallery/2026-02/scaled-1680-/hBbWN3GXzH7QfqY1-image-1771261677092.png)](https://docs.motorfiscal.com.br/uploads/images/gallery/2026-02/hBbWN3GXzH7QfqY1-image-1771261677092.png) # NFS-e SUBSTITUÍDA - Como realizar a consulta A NFS-e (Nota Fiscal de Serviço Eletrônica) pode ser substituída quando houver necessidade de corrigir informações incorretas ou incompletas na nota original. Como valores , dados do tomador ou descrição do serviço. O processo gera uma nova nota (substitutiva) e anula automaticamente a anterior, garantindo a regularidade fiscal sem precisar de cancelamento. **SUBSTITUÍDA** = é a NF original ( que foi emitida primeiro ) **SUBSTITUTA** = é a NF corrigida e que passará a valer. ( Fica com o Status ''NORMAL'' no Motor Fiscal ) Iremos utilizar o Portal Nacional e o Motor Fiscal para base de nossas consultas. Caso se depare com uma nota em que o status seja Substituída no Motor Fiscal ( veja a imagem ) , significa que essa é a NF original e que foi substituida por outra. Vamos ver como consultar esse primeiro cenário. **PRIMEIRO** : Procure no Motor Fiscal na aba de **Consulta NFS-e Recebidas** a NF original - a consulta pode ser feita utilizando os filtros disponíveis na ferramenta , como : Número da NFS-e , nome do prestador e etc.... No caso da imagem anexada , a busca foi pelo número. \*note que no campo STATUS deve estar como ''Substituida'' [![image-1775137519048.png](https://docs.motorfiscal.com.br/uploads/images/gallery/2026-04/scaled-1680-/GhVwq9hE6Lu5ofsl-image-1775137519048.png)](https://docs.motorfiscal.com.br/uploads/images/gallery/2026-04/GhVwq9hE6Lu5ofsl-image-1775137519048.png) **SEGUNDO** : Copie a chave da mesma e vá na Consulta Pública de NFS-e ( [https://www.nfse.gov.br/consultapublica](https://www.nfse.gov.br/consultapublica) ) , clique em Consultar e faça o download do documento , onde deverá constar com a marca d'água de Substituída. **APENAS** a NF **SUBSTITUÍDA** terá a marca d´agua. [![image-1775137898977.png](https://docs.motorfiscal.com.br/uploads/images/gallery/2026-04/scaled-1680-/YCDJUgMyDVxeqCBh-image-1775137898977.png)](https://docs.motorfiscal.com.br/uploads/images/gallery/2026-04/YCDJUgMyDVxeqCBh-image-1775137898977.png) [![image-1775140473008.png](https://docs.motorfiscal.com.br/uploads/images/gallery/2026-04/scaled-1680-/V99SJ4LXAi4CHebt-image-1775140473008.png)](https://docs.motorfiscal.com.br/uploads/images/gallery/2026-04/V99SJ4LXAi4CHebt-image-1775140473008.png) Ao final da página , no campo de Evento haverá a chave da nota SUBSTITUTA ( ou seja , a NF que passará a ter validade ) Basta copiar a chave e realizar a consulta pública novamente. Desta vez , não haverá nenhuma marca d´agua. Observe também que no rodapé dessa nota haverá as informações da NF original ( como a sua chave ) [![image-1775139281316.png](https://docs.motorfiscal.com.br/uploads/images/gallery/2026-04/scaled-1680-/Kp6SQNJjf8pwhuzz-image-1775139281316.png) ](https://docs.motorfiscal.com.br/uploads/images/gallery/2026-04/Kp6SQNJjf8pwhuzz-image-1775139281316.png)[![image-1775176761599.png](https://docs.motorfiscal.com.br/uploads/images/gallery/2026-04/scaled-1680-/TI7TT8lr7jQWpin1-image-1775176761599.png)](https://docs.motorfiscal.com.br/uploads/images/gallery/2026-04/TI7TT8lr7jQWpin1-image-1775176761599.png) Agora vamos ver o segundo cenário : **COMO CONSULTAR A NF SUBSTITUTA NO MOTOR FISCAL** Copie a chave da NF Subst e ainda dentro do Portal Nacional realize a consulta. Desta vez , ao fazer o download deste documento verá que ela NÃO possui a marca d´agua ( Justamente por ser a NF que agora passará a valer ) [![image-1775177338691.png](https://docs.motorfiscal.com.br/uploads/images/gallery/2026-04/scaled-1680-/0vpNtau6oqv5iv24-image-1775177338691.png)](https://docs.motorfiscal.com.br/uploads/images/gallery/2026-04/0vpNtau6oqv5iv24-image-1775177338691.png) Por fim , vá até o Motor Fiscal e realize a consulta da nota. O Status deve estar como ''NORMAL'' Isso significa que ambas as notas estão com seus status devidos dentro do Motor Fiscal e disponiveis para visualização. [![image-1775139868489.png](https://docs.motorfiscal.com.br/uploads/images/gallery/2026-04/scaled-1680-/Q83L5Jd2VUGOGEe7-image-1775139868489.png)](https://docs.motorfiscal.com.br/uploads/images/gallery/2026-04/Q83L5Jd2VUGOGEe7-image-1775139868489.png) **CONCLUSÃO :** Se você encontrou: - Uma nota com status **“Substituída” e** outra com status **“Normal” ✔️ Isso significa que o processo ocorreu corretamente ✔️ Ambas as notas estão disponíveis no sistema.**