Neste endpoint, poderá ser realizada a emissão de uma NFS-e no layout aceito pela prefeitura de Teresina – PI, utilizando os formatos XML e JSON.
URL
Homologação: POST https://nfseapi.ns.eti.br/v1/teresina/emissao
Header
No cabeçalho da requisição poderão ser informados os campos abaixo, conforme ocorrência.
| Campo | Ocorrência | Descrição |
|---|---|---|
| X-AUTH-TOKEN | 1-1 | Token de acesso da Software House |
| tpAmb | 1-1 | Tipo do ambiente: 1 - Produção; 2 - Homologação |
| Content-Type | 1-1 | Indicação do formato dos dados enviados: JSON: application/json; XML: application/xml ou text/xml |
Exemplo de requisição
Requisição de emissão de NFS-e em JSON
curl -X POST
\-H "Content-Type: application/xml"
\-H "X-AUTH-TOKEN: "SEU_TOKEN"
\-H "tpAmb: 2"
\-d '<Rps>...</Rps>' https://nfseapihml.ns.eti.br/v1/teresina/emissao
Exemplo de NFSe em json:
{
"Rps": {
"NumeroRPS": "15",
"DataEmissaoRPS": "2021-04-07T14:06:00",
"SeriePrestacao": "99",
"DataEmissaoNFSeSubstituida": "1900-01-01",
"InscricaoMunicipalPrestador": "333336",
"RazaoSocialPrestador": "EMPRESA MODELO",
"CPFCNPJPrestador": "07485055000269",
"DDDPrestador": "011",
"TelefonePrestador": "80804040",
"InscricaoMunicipalTomador": "0000000",
"RazaoSocialTomador": "EMPRESA DE TESTES",
"CPFCNPJTomador": "00000000191",
"DDDTomador": "011",
"TelefoneTomador": "20203030",
"TipoLogradouroTomador": "Rua",
"LogradouroTomador": "SETE DE SETEMBRO",
"NumeroEnderecoTomador": "335",
"TipoBairroTomador": "Bairro",
"BairroTomador": "Centro",
"CidadeTomador": "1219",
"CidadeTomadorDescricao": "TERESINA",
"CEPTomador": "64001210",
"EmailTomador": "res@bol.com.br",
"CodigoAtividade": "493020100",
"AliquotaAtividade": "2.00",
"TipoRecolhimento": "A",
"Operacao": "A",
"Tributacao": "T",
"ValorPIS": "0.00",
"ValorCOFINS": "0.00",
"ValorINSS": "0.00",
"ValorIR": "0.00",
"ValorCSLL": "0.00",
"AliquotaPIS": "0.0000",
"AliquotaCOFINS": "0.0000",
"AliquotaINSS": "0.0000",
"AliquotaIR": "0.0000",
"AliquotaCSLL": "0.0000",
"Itens": {
"Item": {
"DiscriminacaoServico": "Descricao do Servico ...",
"Quantidade": "1",
"ValorUnitario": "1",
"ValorTotal": "1.00",
"Tributavel": "S"
}
},
"DescricaoRPS": "MES/ANO DE REFERENCIA DA PRESTACAO DE SERVICO:12-2009 .VENCIMENTO =08/01/2010 VALOR LIQUIDO A PAGAR R$3669,38SERVICO DE PORTARIA -RPS enviado em teste"
}
}
Exemplo de NFSe em XML:
<RPS>
<!--Identificação do RPS-->
<NumeroRPS>16</NumeroRPS>
<DataEmissaoRPS>2021-04-08T15:20:00</DataEmissaoRPS>
<SeriePrestacao>99</SeriePrestacao>
<SerieRPSSubstituido/>
<NumeroRPSSubstituido>0</NumeroRPSSubstituido>
<NumeroNFSeSubstituida>0</NumeroNFSeSubstituida>
<DataEmissaoNFSeSubstituida>1900-01-01</DataEmissaoNFSeSubstituida>
<CPFCNPJIntermediario/>
<!--Dados do Prestador do serviço-->
<InscricaoMunicipalPrestador>333336</InscricaoMunicipalPrestador>
<RazaoSocialPrestador>EMPRESA MODELO</RazaoSocialPrestador>
<CPFCNPJPrestador>07485055000269</CPFCNPJPrestador>
<DDDPrestador>011</DDDPrestador>
<TelefonePrestador>80804040</TelefonePrestador>
<!--Dados do Tomador do serviço-->
<InscricaoMunicipalTomador>0000000</InscricaoMunicipalTomador>
<RazaoSocialTomador>EMPRESA DE TESTES</RazaoSocialTomador>
<CPFCNPJTomador>00000000191</CPFCNPJTomador>
<DDDTomador>011</DDDTomador>
<TelefoneTomador>20203030</TelefoneTomador>
<TipoLogradouroTomador>Rua</TipoLogradouroTomador>
<LogradouroTomador>SETE DE SETEMBRO</LogradouroTomador>
<NumeroEnderecoTomador>335</NumeroEnderecoTomador>
<ComplementoEnderecoTomador/>
<TipoBairroTomador>Bairro</TipoBairroTomador>
<BairroTomador>Centro</BairroTomador>
<CidadeTomador>1219</CidadeTomador>
<CidadeTomadorDescricao>TERESINA</CidadeTomadorDescricao>
<CEPTomador>64001210</CEPTomador>
<EmailTomador>res@bol.com.br</EmailTomador>
<!--Dados sobre a atividade-->
<CodigoAtividade>493020100</CodigoAtividade>
<AliquotaAtividade>2.00</AliquotaAtividade>
<!--Tributação-->
<TipoRecolhimento>A</TipoRecolhimento>
<Operacao>A</Operacao>
<Tributacao>T</Tributacao>
<ValorPIS>0.00</ValorPIS>
<ValorCOFINS>0.00</ValorCOFINS>
<ValorINSS>0.00</ValorINSS>
<ValorIR>0.00</ValorIR>
<ValorCSLL>0.00</ValorCSLL>
<AliquotaPIS>0.0000</AliquotaPIS>
<AliquotaCOFINS>0.0000</AliquotaCOFINS>
<AliquotaINSS>0.0000</AliquotaINSS>
<AliquotaIR>0.0000</AliquotaIR>
<AliquotaCSLL>0.0000</AliquotaCSLL>
<Deducoes/>
<!--Itens e valores do serviço-->
<Itens>
<Item>
<DiscriminacaoServico>Descricao do Servico ...</DiscriminacaoServico>
<Quantidade>1</Quantidade>
<ValorUnitario>1</ValorUnitario>
<ValorTotal>1.00</ValorTotal>
<Tributavel>S</Tributavel>
</Item>
</Itens>
<DescricaoRPS>MES/ANO DE REFERENCIA DA PRESTACAO DE SERVICO:12-2009 .VENCIMENTO =08/01/2010 VALOR LIQUIDO A PAGAR R$3669,38SERVICO DE PORTARIA -RPS enviado em teste</DescricaoRPS>
</RPS>
Dados retornados
| Campo | Descrição | Pai | Observação |
|---|---|---|---|
| status | Código de status do processamento | ||
| motivo | Descrição literal do status de processamento | ||
| nsNRec | Protocolo de recebimento da NFS-e | Somente em status = 200 ou -6 | |
| erro | Objeto contendo o erro ocorrido | ||
| cStat | Código de status do erro | erro | |
| xMotivo | Descrição literal do erro | erro |
Exemplos de retorno
Retorno com sucesso
{
"status": 200,
"motivo": "NFSe enviada para o municipio",
"nsNRec": "1234"
}
Códigos de retorno
| Código | Descrição |
|---|---|
| 200 | NFSe enviada para o município |
| -1 | Tipo de ambiente deve ser informado no header, com valor 1 ( produção ) ou 2 ( homologação) |
| -2 | Tipo de ambiente invalido com valor: {VALOR} |
| -4 | Erro ao carregar os dados enviados: {ERROS} |
| -6 | Documento já recebido, porem ainda sem status de processamento. Por favor consulte o status de processamento do NSNRec informado |
| -7 | Content-Type invalido: {VALOR}. O content-type deve ser 'application/json' ou 'application/xml' ou 'text/xml' |
| -400 | Campos obrigatórios não informados: {CAMPOS} |
| -999 | Erro interno ao processar a requisição. Verificar o objeto "erro" |