Documentação Técnica - Padrão NATAL

Manual de integração com o webservice

Download do Manual.
Lista de Erros de Natal.

Portais Disponíveis

• Produção.
• Homologação

Métodos Disponíveis

• Envio.
  • Assíncrono.
• Consulta de lote.
• Consulta de NFSe por RPS.
• Consulta de NFSe.
• Cancelamento de NFSe.

Observações

• Possui envio Assíncrono em lote;
• Não possui Múltiplos Serviços; 
• O padrão utiliza certificado para assinatura.
• A prefeitura disponibiliza um validador de RPS da prefeitura, onde é possível validar a estrutura dos XMLS de envio no link https://directa.natal.rn.gov.br/open.do?sys=DIR&idformulario=7691

• Consulta de NFSe: Para consultar por numero de NFSe é necessário informar no Parâmetro extra DataInicial=2025-01-01;DataFinal=2025-01-05, Referente ao período de 5 dias sobre a data de emissão. Exemplo NFSE emitida em 2025-01-03 deve-se informar:
  ParametroExtras=DataInicial=2025-01-01;DataFinal=2025-01-05 

Geração do XML - Campos Importantes

• O código do serviço segue o que está descrito na LC-116.

Novos campos disponibilizados para adequação da Reforma Tributária

Observação: Campos obrigatórios conforme o arquivo de esquema do Padrão estão destacados em negrito.

Ressaltamos que, para manter a funcionalidade em ambos os ambientes de emissão (produção e homologação), essas regras de validação ainda não foram aplicadas em nossas aplicações.

Para maiores informações sobre a forma de preenchimento destes campos novos, acesse nossa documentação do Padrão Unificado de TX2.

Tx2 de Exemplo

Campos customizados para a impressão

Impressão do RPS

• NomeFantasiaPrestador=String[80]
• TelefonePrestador=String[20]
• EmailPrestador=String[80]
• DataPrestacaoServico=String
• NfseSubstituida=String[20]
• RazaoSocialPrestador=String[80]
• EnderecoPrestador=String[80]
• CodigoMunicipioPrestador=String[10]
• UfPrestador=String[2]
• NumeroEnderecoPrestador=String[7]
• ComplementoEnderecoPrestador=String[20]
• BairroPrestador=String[40]
• CepPrestador=String[8]
• Item=String[10]
• QuantidadeItem=String[10]
• ValorUnitarioItem=String[20]
• ValorTotalItem=String[20]
• OutrasInformacoes=String[255]

Impressão da NFSe

• DataPrestacaoServico=String
• Item=String[10]
• QuantidadeItem=String[10]
• ValorUnitarioItem=String[20]
• ValorTotalItem=String[20]

Exemplos de arquivos de integração