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.
Novo Campo da Reforma tributária
Com a chegada da reforma tributária, foram feitos ajustes para adicionar novos campos referentes às novas obrigações fiscais. Este é:
| Nome do campo TX2 | Observação |
| CodigoNbs | (Obrigatório) Código da Nomenclatura Brasileira de Serviços. 9 dígitos |
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
| Nome do campo TX2 | Observação |
| CodigoObra | Código CNO (Cadastro Nacional de Obras) da obra |
| EnderecoObra | Endereço da Obra |
| NumeroObra | Número do endereço da Obra |
| BairroObra | Bairro da Obra |
| ComplementoObra | Complemento da Obra |
| CepObra | Cep da Obra |
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".
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.