Manual NFSE API

1.0 - Login API:

   1.1 - Autenticar usuário para obter token  [MÉTODO POST]

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

      - Post deve ser feito no formato texto:
      grant_type=password
      &username= username@cnpj
      &password= Senha
      &client_id= NFSeApp (default)
      &client_secret=

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


   Exemplo de retorno de autenticação:
   {
      "access_token":"TVl8_P4HSgzRZQmLNdOge71_H2wQfZbwtlC4X8eLpnphMaOHUyDTQxpV0NoKv4kbdcBrNhQsNSWJR0r04sjAYmrmjMM0dtBErOb_HoDs44vDk-Kl8wBObFut6TY3D6
   NUlgyXfR2eQEkkBQKKEwdEVf4dad94wQ4Ky55dlgjGOT2TStnKaa3eXc3Q4TPoQve6e7Ifg_9HeA155iCusDJD1bv6LyCGUC7LZIuZXdIdEq4bKsZwxyOt8iC2QuZHL9mC4TXT8ZUmM7dpEy
   4i-W5ELczvH-4vDmm-cwd-Uqd0BARdY21pJ0eIqY-FJPWXCtntyk1JFOA_QMSk5Zbz55LlcTQ5AmtnS90xJe9ZqnIyC7vR9OM4xAXSbFWjnPmOhRPU-4hYZaPIJtWdZQbkRJfYxkU1bDn1W6
   ut0ipxytLd-f1pKKa5Y3K-VSlXtR7MC7LVHEztuxU0rBmuty-sdxD5AWcXa6PI-P0Nh_GK8Le4NsvUT_cVSn9f8r1JWj9ABv9Bx1H5HgpJ-PdvhZLhIzImDUpR0iLINvGQ6bwAuYWBX0UHxf
   T1qphYjy6f5L-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"
   }

   1.2 - OBS: O token de autenticação inicia-se com os parâmetros 'token_typ' e 'access_token'.

   Ex: "Bearer TVl8_P4HSgzRZQmLNdOge71_H2wQfZbwt..."


    1.3 - Para realizar testes de requisição na API disponibilizamos um ambiente de teste:

      1.3.1 - Login:   https://nfservico.com.br/prefeitura-teste/token
               username: teste@72416929000107
               password: 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/
               CNPJ para testes de consulta: 63682212000116
               Ex: https://nfservico.com.br/prefeitura-teste/api/contribuinte/tomador/63682212000116
               (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
            }
==========================================================================================================================================================

2.0 - Emissão de Nota Fiscal:

   2.1- Post deve ser feito no formato json. [MÉTODO POST]

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

   2.2 - Parâmetros necessário: 'Chave' : 'Valor'

   - Token de autenticação:  (ex:  Authorization: "Bearer TVl8_P4HSgzRZQmLNdOge71_H2wQfZbwt...")

   2.4 - json nota fiscal:
   {
      "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"
   }

   2.5 - OBS:
         - 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)
==========================================================================================================================================================

3.0 - Cadastro do tomador:

   3.1  - Post deve ser feito no formato json.  [MÉTODO POST]

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

   * Parâmetros necessário:

   - Token de autenticação:  (ex:  Authorization: "Bearer TVl8_P4HSgzRZQmLNdOge71_H2wQfZbwt...")

   3.2 -  json tomador:
   {
      "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"
   }

   3.3 - OBS:

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

==========================================================================================================================================================

4.0 - Consultar tomador por CNPJ ou razão social [MÉTODO GET]

   4.1 - Para consultar o código referente ao tomador para emissão da nota fiscal, busque através do cnpj ou razão social:

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

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

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