# 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