Tópicos deste artigo
- Manual do web service
- Portais disponíveis
- Métodos disponíveis
- Tipo de impressão
- Observações gerais
- Observações específicas por cidade
- Emissão pelo componente
- Observações sobre a geração do XML
- Erros comuns
- Campos customizados para a impressão do RPS
-
Campos customizados para a impressão da NFSe
Manual de integração com o webservice
Portais disponíveis
- Produção
- Homologação
Métodos disponíveis
- Envio
- Síncrono
- Assíncrono
- Aceita envio de lote de RPS
- Não necessita envio sequencial¹
- Consulta de NFSe por RPS
- Consulta de Lote
- Cancelar NFSe
- Consultar Notas Tomadas
¹Não necessita que as notas sejam enviadas uma por vez
Tipo de impressão
- A impressão é feita via link da prefeitura¹
¹ Nossos produtos realizam o download do PDF da NFSe que foi gerado pela própria prefeitura.
Reforma tributária
- Para realizar testes com os novos campos da Reforma Tributária, é necessário incluir o campo
VersaoEsquema=RTCno cabeçalho do arquivo TX2. Somente com essa configuração o sistema passará a utilizar o novo esquema de emissão da reforma Reforma Tributária. - A rota de emissão em modo assíncrono não retorna a nota fiscal, apenas realiza a validação da estrutura do XML enviado.
-
Não é possível gerar PDF no ambiente de testes.
NT007
O município está adequado às diretrizes da Nota Técnica 007 (NT007) da NFS-e Nacional. Abaixo estão as alterações obrigatórias e os impactos por produto.
Componente e SaaS (Integração via TX2)
A aplicação de tributos foi restrita a cenários específicos. Utilize as novas propriedades conforme as regras de negócio abaixo:
-
Tipo de Retenção: Deve ser informado quando houver retenção ou apuração própria de PIS/COFINS/CSLL.
TipoRetPisCofins
-
PIS e COFINS: Permitido o envio apenas para casos de Apuração Própria.
ValorPisProprioValorCofinsProprio
-
CSLL (CSRF): Permitido o envio apenas para casos de Retenção.
ValorPisCofinsCsll
⚠️ Atenção: As propriedades do TX2 - ValorPis, ValorCofins e ValorCsll - não são mapeadas portanto não tem efeito na emissão. Utilize somente as novas tags para o destaque de PIS/COFINS/CSLL.
PlugNotas
O PlugNotas já está integralmente compatível com a NT007.
Para detalhes de integração e estrutura de JSON, consulte a Documentação Técnica NT007 - PlugNotas.
Observações gerais
- Padrão não suporta múltiplos serviços.
- O envio em homologação não retorna nota ou protocolo, serve apenas para validar o esquema e a comunicação.
- Alguns caracteres especiais no arquivo de envio podem resultar no seguinte erro: Nota Rejeitada Pelo Servidor: 1057-Rejeição: Assinatura difere do calculado.
Observações específicas por cidade
| Cidade | Observação |
| São Paulo/SP |
|
Emissão pelo Componente NFSe
- Ao enviar um valor da lista LC116 nacional, o Componente NFSe e PlugNotas irão converter para o código da cidade, link para tabela de conversão: Tabela de Conversão.
- Para o componente é possível acessar através do caminho: " [...]\Arquivos\Esquemas\TecnoNFSe\ListaServLC116_CodServSaoPaulo.txt"
-
Pode-se ocasionar a seguinte rejeição "Erro técnico: Ocorreu um erro durante a comunicação com o servidor: Não foi possível carregar o XML: The server cannot service the request because the media type is unsupported". Uma possível resolução é a mudança nas configurações da internet para TLS 1.0 e todos os SSL's.
Observações sobre a geração do XML
- O Código CNAE não é utilizado, e nem o código de tributação do município.
- É possível utilizar a tag
ValorTotalRecebidono TX2 de envio, que se refere ao valor total recebido em R$ (inclusive valores repassados a terceiros).
Erros comuns
-
Erro 324 - "Operação não autorizada por meio eletrônico em razão de ultrapassado o prazo permitido."
Uma possível solução é validar se o número do RPS enviado já se encontra autorizado na prefeitura consultando pelo próprio número no portal. -
1254-Prestador, tomador, código de serviço e/ou tipo de benefício fiscal não cadastrados por meio do Sistema de Gestão de Benefícios Fiscais (GBF) para a data de prestação informada. Para mais informações, href=http://nfpaulistana.prefeitura.sp.gov.br/arquivos/informativo_gbf.pdf
Esse erro é retornado quando o prestador informa a tag de tipoTributacao com o valor 1, o que gera a Tributação A que é utilizada por prestadores cadastrados no GBF. Para corrigir a rejeição o prestador precisa enviar a tag tipoTributacao igual a 6 o que irá gerar a Tributação T.
Campos da reforma tributária
- Anexamos um tx2 de exemplo para São Paulo com os novos campos da reforma tributária. Para entender significados e formas de preenchimento, acesse a documentação do tx2.
- Anexamos um JSON de exemplo para São Paulo com os novos campos da reforma tributária, para emissão no PlugNotas.
Campos customizados para a impressão do RPS
- ValorIss=String[10]
- OutrasRetencoes=String[10]
- BaseCalculo=/RPS/ValorServicos
- CnpjPrestador=String[14]
- NomeFantasiaPrestador=String[80]
- RazaoSocialPrestador=String[80]
- EnderecoPrestador=String[80]
- UfPrestador=String[2]
- NumeroEnderecoPrestador=String[10]
- ComplementoEnderecoPrestador=String[40]
- BairroPrestador=String[40]
- CepPrestador=String[8]
- OutrasInformacoes=String[255]
- RazaoSocialIntermediario=String[80]
- CodigoMunicipioPrestador=String[10]
Campos customizados para a impressão da NFSe
- OutrasInformacoes=String[255]
- NfseSubstituida=String[10]
- DataCancelamento=String[10]
- RazaoSocialIntermediario=String[80]
Comentários
6 comentários
O json de exemplo não retornar uma NF com os campos da reforma tributária! Quando uma NF é emitida manualmente direto no site da prefeitura, o pdf da NF contém uma segunda página só relacionada aos novos tributos
Apenas acrescentando uma observação:
O arquivo JSON de exemplo PMSP está enviando o campo:
"indicador": 0,
e isso retorna o seguinte erro:
"mensagem": "299-O destinatário não deve ser identificado para o código indicador informado."
Basta mudar para
"indicador": 1,
e o arquivo gera a NF inclusive com os novos tributos IBS e CBS
Tecnospeed precisaria alterar o JSON de Exemplo
att
Obrigado Luís Ricardo, além do “indicador”:0, aqui só funcionou passado a tag "versaoEsquema": “RTC” mesmo em produção
Para emissão de NFSe, a base de calculo do IBS e CBS está calculando errado e a tag ibscbs.valores.baseCalculo não está assumindo os valores que informamos….Como esta base de calculo está calculando no automático de forma errada, a ideia nossa era já levar o valor calculado porque cada empresa tem uma carga tributária diferente, mas a tag ignora o valor que informamos.
Alguem tem um exemplo de tx2 pra São Paulo? Esse que está anexo é superconfuso.
Nosso cliente da cidade de São Paulo, reclamou que a alíquota IBS Estadual, deveria ter saído impressa no IBS Municipal e a base de cálculo IBS e CBS está errada. O problema é: onde informa valores e alíquotas IBS e CBS? No layout de São Paulo não tem para o TX2. No exemplo TX2 também não tem nada. Tá complicado.
Por favor, entre para comentar.