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

Manual de integração com o webservice

Download do manual

Portais Disponíveis

• Produção

Métodos Disponíveis

• Envio.
  • Assíncrono.
• Consulta de lote.
• Consultar NFSe.

Observações

• Para as operações de Envio (ProxyNFSe.Enviar) e Consulta de Lote (ProxyNFSe.ConsultarLote) será necessário informar no parâmetro aParams o Cpf do Usuário e a senha do sistema web de NFSe do município. Ex: ProxyNFSe.Enviar(_Lote, 'CpfUsuario=XXXXXXXXXXX;Senha=XXXX'); Opcionalmente pode-se utilizar a Hash da senha, calculada com SHA1 e Base64. Ex: ProxyNFSe.Enviar(_Lote, 'CpfUsuario=XXXXXXXXXXX;HashSenha=XXXXXXXXXXXXXXXXXXXXX=').
• Não existem servidores de Homologação para esse município. Para testes a prefeitura disponibiliza 
  os seguintes dados: Usuário: XXXXXXXXXXX e  Senha: XXXX (Essa senha após aplicar hash fica XXXXXXXXXXXXXXXXXXXXXX=).  Para testar a comunicação, utilize as seguintes configurações: Componente NFSe: Ambiente=1, CNPJ=XXXXXXXXXXX, InscricaoMunicipal=XXXXXX, Tx2: InscricaoMunicipalEmissor=XXXXXX; CodAtividade=702, TecnoNfse: InscricaoMunicipalPrestador=XXXXXX; CodigoTributacaoMunicipio=6,  Parâmetros Extras para envio: (CpfUsuario=XXXXXXXXXXX;Senha=XXXX)
• Na Consulta de um protocolo com mais de um RPS, o web-service, retorna a NFSe equivalente a apenas o ultimo RPS emitido, portanto não é aconselhada a emissão de notas em lotes.
• Consulta de NFSe por RPS não é uma operação suportada para cidades do padrão SIL.
• Com o arquivo de integração padrão único é possível a inserção de vários serviços na mesma nota, possibilitando ao cliente uma forma eficaz de diminuir o esforço na comunicação com o WebService, sendo assim não é mais preciso para cada serviço uma nova requisição.

  No arquivo de integração deve-se inserir os seguintes campos ficando da seguinte forma:

   

  INCLUIRSERVICO
    QuantidadeServicos=1
    DiscriminacaoServico=Servico de teste
    ValorUnitarioServico=1.00
SALVARSERVICO

   

  Onde:

  INCLUIRSERVICO – Identificador de inclusão que será a diretriz do novo serviço que será inserido.

  QuantidadeServicos – Neste campo será informado a quantidade de serviços que serão prestados.

  DiscriminacaoServico – Neste campo é atribuído uma breve descrição do serviço.

  ValorUnitarioServico – Este campo refere-se ao valor unitário do serviço.

  SALVARSERVICO – Identificador de inclusão que caracteriza o fim do serviço que foi prestado.

• Caso ocorra divergências entre a situação da nota na prefeitura (Autorizada) e em nosso produto (Rejeitada), o procedimento a ser realizado é informar um protocolo_da_nota acrescentando o parâmetro nprotocolo, que deverá conter as seguintes informações: ChaveValidacao_DataHora da Emissao_Serie do RPS_CodIBGE do Município. Exemplo: AAAA-BBBB_14/02/2019 07:00:00_1_3506508
  • Para comunicações via API:
    • o parâmetro nprotocolo=protocolo_da_nota deverá ser adicionado no Body da requisição;
  • Para comunicações via integração por pasta:
    • o parâmetro nprotocolo=protocolo_da_nota deverá ser adicionado no TX2

Geração do XML - Campos Importantes

• O código do serviço segue o que está descrito na LC-116 sem ponto.
• Utiliza Código CNAE.
• Utiliza Código Tributação do Município.

Campos customizados para a impressão

Impressão do RPS

• RazaoSocialPrestador=String[80]
• CodigoMunicipioPrestador=String[10]
• EnderecoPrestador=String[80]
• UfPrestador=String[2]
• NumeroEnderecoPrestador=String[7]
• ComplementoEnderecoPrestador=String[20]
• BairroPrestador=String[40]
• CepPrestador=String[11]
• TelefonePrestador=String[20]
• EmailPrestador=String[80]
• CnpjCpfPrestador=String[20]
• InscricaoEstadualPrestador=String[20]
• ValorIss=String[20]
• ValorTotalNota=String[20]
• ValorTotalLiquido=String[20]
• ISSQNSemRetencao=String[20]
• ValorTotalDeducoes=String[20]
• EndCobranca=String[80]
• ChaveValidacaoRPS=String[20]
• ValorExtenso=String[255]

Impressão da NFSe

• EmailPrestador=String[80]
• InscricaoEstadualPrestador=String[20]
• TelefonePrestador=String[20]
• EndCobranca=String[255]
• ValorExtenso=String[255]
• ComplementoEnderecoPrestador=String[20]
• OptanteSimples=String[1]

Soluções Tecnospeed

• Componente NFSe:      Release 7.7.39.X.
• Manager eDoc:      Release 2.0.73.X.