Manual de integração com o webservice
Portais Disponíveis
- Produção
- Homologação
Métodos Disponíveis
- Envio.
- Síncrono.
- Consulta de NFSe Por Rps
- Cancelar NFSe
Observações
- Não possui envio em Lote.
- É necessário preencher os parâmetros "Login" e "Senha" nas configurações de Autenticação da Prefeitura.
- No ambiente de Homologação está disponível somente a comunicação de Envio, pois ela somente valida o xml e retorna se está com erro ou não. Com isso as notas enviadas em Homologação não tem registro na prefeitura, consecutivamente não é possível realizar uma consulta ou cancelamento da mesma.
- Erro de "Conexão finalizada ou interrompida de modo anormal.". Alterar no NfseLocais esta propriedade: ModoEnvioCent=2
- Para realizar a impressão da descrição do serviço, deve ser informado o campo CodigoItemListaServico como campo customizado da impressão, e o código da lista que está descrito na LC-116, por exemplo:
DadosImpressao=CodigoItemListaServico=14.01 - Para as cidades de Caçu GO e Piracanjuba - GO , o CodigoItemListaServico deve ser preenchido com o ID do cadastro do serviço no sistema interno da prefeitura. Caso envie normalmente, retorna-se o erro: "Serviço informado não autorizado. Serviços autorizados (85, 85, 86, 86, 96, 96)." Deve-se então preencher o CodigoItemListaServico com um dos numeros de serviço retornados.
Cancelamento de NFSe
- No método de cancelamento é possível informar os seguintes códigos de cancelamentos "apenas o número":
1 - Rasura
2 - Erro preenchimento
3 - Fim do prazo de validade
4 - Fora de sequência numérica e cronológica
5 - Desacordo comercial
6 - Outros - Caso não seja informado o parâmetros CodigoCancelamento o componente ira adotar o código 2.
- Caso informado o CodigoCancelamento=6 é possível informar o parâmetro MotivoCancelamento=Motivo.... Com o motivo do cancelamento, caso não seja informado esse parâmetro o componente ira adotar o motivo "Nota cancelada a pedido do prestador".
- A substituição de NFS-e não funcionava pelo WebService no momento da homologação, recomendamos que faça a substituição da NFS-e pelo portal da prefeitura.
Geração do XML - Campos Importantes
- O código do serviço é utilizado o próprio de cada cidade do padrão. Entre em contato com a prefeitura para ter conhecimento do serviço autorizado para o prestador emitente.
Utilize o campo CodigoItemListaServico do padrão único Tx2 para informa-lo. - É obrigatório informar o código CNAE.
- Código CNAE segue a tabela nacional com 7 digítos.
Novos campos disponibilizados para adequação da Reforma Tributária
| CodigoNbs | CodigoOperacao | ClassificacaoTributariaIbsCbs |
| InscricaoEstadualPrestador | TipoCST | ValorBCPisCofins |
| AliquotaPisProprio | AliquotaCofinsProprio | ValorPisProprio |
| ValorCofinsProprio | TipoRetPisCofins | ValorPisCofinsCsll |
| ValorInss | InscricaoFiscalImovel | CepImovel |
| LogradouroImovel | NumeroImovel | BairroImovel |
Observação: Campo obrigatório conforme o arquivo de esquema do padrão está destacado em negrito.
TipoCST, quando informado com valor diferente de "00", ativa o bloco de apuração própria de PIS/COFINS (usa ValorBCPisCofins/AliquotaPisProprio/AliquotaCofinsProprio/ValorPisProprio/ValorCofinsProprio; na ausência de ValorBCPisCofins, o webservice utiliza como base de cálculo, nesta ordem, BaseCalculoPIS, BaseCalculoCOFINS ou BaseCalculo). TipoRetPisCofins, quando informado, ativa o bloco de retenção de PIS/COFINS/CSLL (usa também ValorPisCofinsCsll para o valor de CSLL retido). Ambos os blocos são opcionais — se não informados, o comportamento de emissão não muda.
Para maiores informações sobre a forma de preenchimento destes campos, acesse:
Forma/Condição de Pagamento
O padrão CENTI passou a processar o bloco FormaPagamento do TX2 (já existente no padrão unificado), enviando as parcelas à prefeitura. A quantidade de parcelas é calculada automaticamente pela quantidade de registros de FormaPagamento informados — não é necessário informá-la à parte.
| TipoPagamentoPadrao | Parcela | ValorParcela |
| ObservacaoFormaPagamento |
ObservacaoFormaPagamento é o único campo novo deste bloco. TipoPagamentoPadrao (ou TipoPagamento, como alternativa) e Parcela/ValorParcela já existiam no padrão unificado; o CENTI passou a consumi-los. Parcela e ValorParcela são obrigatórios em cada registro de FormaPagamento informado.
Campos de Obra
Após alteração recente no layout do padrão, os seguintes campos começaram a ser validados para dados de preenchimento de obra. Os nomes das TAGs no TX2 não mudaram.
| CodigoObra | EnderecoObra | NumeroObra |
| BairroObra | ComplementoObra | CepObra |
Para os serviços '07.02', '07.04', '07.05', '07.06', '07.07', '07.08', '07.17' e '07.19' este grupo de informações é obrigatório com exceção da TAG "CodigoObra". Os campos CodigoCidadeObra, DescricaoCidadeObra e UfObra deixaram de ser utilizados por este padrão.
Erros comuns
- O erro "ERRO;Cód. erro :0 (): ();" Pode acontecer quando o envio não está assinado corretamente.
Campos customizados para a impressão
Impressão do RPS
- RazaoSocialPrestador=String[80]
- NomeFantasiaPrestador=String[80]
- EnderecoPrestador=String[80]
- NumeroPrestador=String[20]
- ComplementoPrestador=String[80]
- BairroPrestador=String[20]
- CodigoCidadePrestador=String[7]
- UfPrestador=String[2]
- CepPrestador=String[12]
- TelefonePrestador=String[20]
- EmailPrestador=String[80]
- RetencoesFederais=String[12]
- ValorDescontos=String[20]
- FormaPagamento=String[30]
- QuantidadeParcelas=String[3]
- Observacao=String[80]
- CodigoItemListaServico=String[7]
- ValorLiquido=String[20]
Impressão da NFSe
- RazaoSocialPrestador=String[80]
- NomeFantasiaPrestador=String[80]
- EnderecoPrestador=String[80]
- NumeroPrestador=String[20]
- ComplementoPrestador=String[80]
- BairroPrestador=String[20]
- CodigoCidadePrestador=String[7]
- UfPrestador=String[2]
- CepPrestador=String[12]
- TelefonePrestador=String[20]
- EmailPrestador=String[80]
- RetencoesFederais=String[12]
- ValorDescontos=String[20]
- FormaPagamento=String[30]
- QuantidadeParcelas=String[3]
- Observacao=String[80]
- CodigoItemListaServico=String[7]
- ValorLiquido=String[20]
Comentários
1 comentário
Preciso de orientação para obter a autorização necessária para realizar emissões via WebService. Poderia me ajudar com isso?
Por favor, entre para comentar.