Documentação API NFS-e

Esta documentação tem por finalidade auxiliar a integração entre
APIs e facilitar a usabilidade.

URL: https://nfservico.com.br/prefeitura-teste//token

No corpo da requisição deve constar seguintes "TAG":

grant_type=password
&username= username@cnpj
&password= Senha
&client_id= NFSeApp (default)
&client_secret=


EXEMPLO:

grant_type=password&username=username@96805042000179&password=123456&client_id=NFSeApp&client_secret=


Exemplo de retorno de autenticação:

{

"access_token":"TVl8_P4HSgzRZQmLNdOge71_H2wQfZbwtlC4X8eLpnphMaOHUyDTQxpV0NoKv4kbdcBrNhQsNSWJR0r04sjAY
mrmjMM0dtBErOb_HoDs44vDk-Kl8wBObFut6TY3D6

NUlgyXfR2eQEkkBQKKEwdEVf4dad94wQ4Ky55dlgjGOT2TStnKaa3eXc3Q4TPoQve6e7Ifg_9HeA155iCusDJD1bv6LyCGUC7LZIu
ZXdIdEq4bKsZwxyOt8iC2QuZHL9mC4TXT8ZUmM7dpEy4i-W5ELczvH-4vDmm-cwd-Uqd0BARdY21pJ0eIqY-FJPWXCtntyk1JFOA_QM
Sk5Zbz55LlcTQ5AmtnS90xJe9ZqnIyC7vR9OM4xAXSbFWjnPmOhRPU-4hYZaPIJtWdZQbkRJfYxkU1bDn1W6ut0ipxytLd-f1pKKa5Y3
K-VSlXtR7MC7LVHEztuxU0rBmuty-sdxD5AWcXa6PI-P0Nh_GK8Le4NsvUT_cVSn9f8r1JWj9ABv9Bx1H5HgpJ-PdvhZLhIzImDUpR0i
LINvGQ6bwAuYWBX0UHxfT1qphYjy6f5L-s3SQQQA6mrUV9yRc3L-JOIbWLVw",


"token_type":"bearer","expires_in":7199,
"as:client_id":"NFSeApp",
"userName":"username@96805042000179",
".issued":"Wed, 25 Nov 2020 17:46:58 GMT",
".expires":"Wed, 25 Nov 2020 19:46:58 GMT"



}

Ex:

"Bearer TVl8_P4HSgzRZQmLNdOge71_H2wQfZbwt..."

1.3.1 - Login :
https://nfservico.com.br/prefeitura-teste/token

Nome de usuário: teste @ 72416929000107
Senha: 123456 @

(Informação para login no item 1.1 )


1.3.2 - Cadastro do tomador :
https://nfservico.com.br/prefeitura-teste/api/contribuinte/save

( Informação para cadastro do tomador no item 3.0 )


1.3.3 - Emissão de Nota Fiscal:
https://nfservico.com.br/prefeitura-teste/api/nota/emitir

( Informação para Emissão da NFSE no item 2.0 )


1.3.4 - Consultar informação do tomador para emissão da NFSE :
https : //nfservico.com.br/prefeitura-teste/api/contribuinte/tomador/

( Informação para consulta no item 4.0 )

-Exemplo de retorno do item 1.3.4 :


{
"codigo": 19 ,
"razaoSocial": "RAZAO SOCIAL DO TOMADOR" ,
"cpfCNPJ" : "63682212000116" ,
"responsavel" :"NOME DO RESPONSÁVEL" ,
"tipoDocumento" : 0 ,
"tipoPessoa" : 1 ,
"tipoContribuinte" : 2 ,
"endereco" : "Avenida Luís Viana Filho" ,
"numero" : "20" ,
"complemento" : null ,
"bairro" : "Alphaville I" ,
"cidade" : "SALVADOR" ,
"estado" : "Bahia" ,
"cep" : "41701005" ,
"email" : "TOMADOR@MAIL.COM" ,
"telefone" : "9999999999" ,
"codMunicipio" : 2927408
}

URL: https://nfservico.com.br/prefeitura-teste/api/nota/emitir

Token de autenticação exemplo:
Authorization: "Bearer TVl8_P4HSgzRZQmLNdOge71_H2wQfZbwt..."

{
"tomador": {
"codigo": 22776,
"bairro": "Tijuca",
"celular": "63430361000",
"cidade": "RIO DE JANEIRO",
"codMunicipio": 3304557,
"cpfCnpj": "63430361000198",
"endereco": "Rua Garibaldi",
"estado": "RJ",
"fantasia": "TESTE 63430361000198",
"numero": "221",
"razaoSocial": "TESTE 63430361000198",
"responsavel": "TESTE 63430361000198",
},
"valor":100,
"totalDeducoes":0,
"baseCalculo":100,
"iss":"0.00",
"credito":0,
"inss":0,
"pis":0,
"cofins":0,
"irrf":0,
"csll":0,
"outrasRetencoes":0,
"descontoCondicionado":0,
"descontoIncondicionado":0,
"liquido":100,
"codigoTributacaoMunicipio":2926301,
"competencia":"2020-11-24",
"cnae":111399,
"aliquota":0,
"codigoServico":"0",
"isIssRetido":0,
"servico":"DESCRIÇÃO DA NOTA"
}

- tomador Json { }: Para obter informações do tomador consulte o item 4.0.
- codMunicipio, codigoTributacaoMunicipio: (Consulte o código do município da tabela do IBGE)
- competencia: formato da data deve ser: ANO-MES-DIA (ex: 2020-11-24)

URL: https://nfservico.com.br/prefeitura-teste/api/contribuinte/save

Parâmetros necessário:
- Token de autenticação: (ex: Authorization: "Bearer TVl8_P4HSgzRZQmLNdOge71_H2wQfZbwt...")

{
"tipoPessoa":1,
"cnae":0,
"tipoDocumento":0,
"aliquota":0,
"isSimplesNacional":true,
"cpfCnpj":"91280438000126",
"razaoSocial":"RAZAO SOCIAL DO TOMADOR",
"fantasia":"FANTASIA DO TOMADOR",
"responsavel":"NOME DO RESPONSÁVEL",
"telefone":"9999999999",
"celular":"99919125252",
"email":"TOMADOR@MAIL.COM",
"cep":"41701005",
"endereco":"Avenida Luís Viana Filho",
"bairro":"Alphaville I",
"estado":"BA",
"cidade":"Salvador",
"numero":"20"
}

- tipoPessoa: 0: PF, 1: PJ
- cnae, tipoDocumento, aliquota: (default) 0
- isSimplesNacional: (default) true para tomador

https://nfservico.com.br/prefeitura-teste/api/contribuinte/tomador/ cpfCnpj ou razaoSocial

EX: https://nfservico.com.br/prefeitura-teste/api/contribuinte/tomador/63682212000116

Supondo que a razão social do tomador chama-se: José Silva LTDA:
https://nfservico.com.br/prefeitura-teste/api/contribuinte/tomador/jose
https://nfservico.com.br/prefeitura-teste/api/contribuinte/tomador/silva