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

Este artigo reúne as especificações do padrão NFS-e DSF30 para integração via web service, incluindo portais (Produção/Homologação), métodos disponíveis (emissão, consulta, cancelamento), tipo de impressão do documento, regras e observações do padrão. Também detalha parâmetros de autenticação, erros comuns e campos customizados de impressão.

Tópicos deste artigo (Sumário)

• Manual do web service
• Portais disponíveis
• Métodos disponíveis
• Tipo de impressão
• Observações gerais do padrão
• Campos customizados para impressão do RPS

Manual de integração com o web service

• Manual

Portais disponíveis

• Produção - Exige certificado digital
• Homologação

Métodos disponíveis

Envio

• Envio sequencial: ( ) Necessita envio sequencial / (x) Não necessita envio sequencial
  • Nota: “envio sequencial” = numeração do RPS precisa estar na sequência esperada.
• Modo: (x) Síncrono / ( ) Assíncrono / ( ) Ambos
• Lote de RPS: (x) Aceita lote / ( ) Não aceita lote

Consulta

• ( ) Consulta de lote
• (x) Consulta por RPS - Nacional
• (x) Consulta por NFS-e
• ( ) Consulta por protocolo

Cancelamento

• (x) Cancelamento de NFS-e via web service
• ( ) Cancelamento apenas administrativo (fora do web service)

Tipo de impressão

Selecione uma opção e explique os impactos nos produtos.

• ( ) Impressão via link da prefeitura
  • Nossos produtos fazem download do PDF gerado pela prefeitura.
• (x) Impressão via layout Tecnospeed
  • Nossos produtos geram o PDF, aproximando ao máximo o layout da prefeitura.

Observações gerais do padrão

• As prefeituras estão em processo de aderência ao novo layout, portanto é necessário conferir se a cidade utilizada já foi migrada.

Observações sobre a geração do XML

• O código do serviço segue o padrão nacional descrito na LC-116.

• O layout do XML segue o modelo Nacional.

• Importante: A série utilizada deve ser 10001, caso contrário será rejeitada pelo webservice.

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

O layout segue o padrão da Nfse Nacional, com os ajustes da RTC007, contendo campos de IBS e CBS.

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

Exemplos de TX2 e XML:

• XML Envio
• XML Retorno envio
• XML Retorno consulta
• TX2

Campos customizados para impressão

Impressão do RPS

NomeFantasiaPrestadorCustom=String[80]
RazaoSocialPrestadorCustom=String[80]
EnderecoPrestadorCustom=String[80]
CodigoMunicipioPrestador=String[10]
NumeroPrestadorCustom=String[7]
ComplementoPrestadorCustom=String[20]
BairroPrestadorCustom=String[40]
CepPrestadorCustom=String[8]
TelefonePrestadorCustom=String[20]
EmailPrestadorCustom=String[80]
InscricaoMunicipalPrestadorCustom=String[20]
CodigoCidadeIncidencia=String[7]
ValorBaseCalculo=String[15]
ValorTotalRetencoes=String[15]
ValorIss=String[15]
AliquotaIss=String[15]