NFS-e Tecnosistemas

Envio de Lote de Notas Tomadas

O Web Service responsável pelo recebimento do XML com o lote de Notas Tomadas (uma ou várias) realizará o processo de validação dos registros constantes e consequente processamento dos registros com a conversão on-line do mesmo em Nota Tomadas. Esse web service por padrão estará alocado na porta 9092.

Este serviço estará disponível em tempo integral para consumo através da integração garantindo assim que a informação sobre o serviço seja registrada em tempo real.

Recomendamos que não sejam omitidas tags, se não há valor como, por exemplo, na identificação da Razão Social do Prestador, que seja informado um espaço no item. O mesmo vale para informações numéricas como, por exemplo, na Inscrição Municipal do tomador de serviço.

As informações a serem enviadas a este Web Service através de mensagem no padrão XML são esperadas no seguinte formato:

<EnvioLoteNotasTomadas xmlns="http://www.abrasf.org.br/nfse.xsd"> <Lote Id="L12013915933760001020000000000000004" versao="20.01"> <!--identificador do Lote de Rps, por padrão é esperado a composição--> <!--1 - identificação de envio de lote sincrono--> <!--0000 - ano do lote enviado no formato AAAA--> <!--00000000000009 - numero do CPF/CNPJ do tomador formatado com 14 posições--> <!--0000000000000009 - número sequencial do lote formatado com 16 posições--> <NumeroLote>4</NumeroLote> <!--número identificado do lote enviado (sequencia individual por tomador de serviços)--> <CpfCnpjTomador> <Cnpj>99999999999962</Cnpj> <!--número do CPF/CNPJ do tomador de serviços responsável pelo lote--> </CpfCnpjTomador> <InscricaoMunicipalTomador>989035</InscricaoMunicipalTomador> <CpfCnpjRemetente> <Cnpj>91593376000102</Cnpj> <!--número do CPF/CNPJ do prestador de serviços responsável pelo lote--> </CpfCnpjRemetente> <!--número da inscrição municipal do tomador dos serviços--> <!--quantidade de RPS constantes da remessa--> <ListaServicoTomado> <ServicoTomado> <IdentificacaoDocumento> <Numero>21</Numero> <!--número sequencial do RPS (sequencia individual por prestador de serviços)--> <Serie>UNICA</Serie> <!--identificação da série do RPS, a NFS-e Tecnos convencionou série 'UNICA'--> <DataEmissao>2020-08-06T15:12:50</DataEmissao> <!--data de emissão do RPS--> <EspecieDocumento>5</EspecieDocumento> <!-- Espécie do documento --> <!-- 1 - Bloqueto --> <!-- 2 - Cupom Fiscal --> <!-- 3 - Conhecimento de frete --> <!-- 4 - Cupom --> <!-- 5 - Nota Fiscal --> <!-- 6 - Nota Fiscal-Fatura --> <!-- 7 - Recibo/RPA --> <!-- 8 - Serviços de Fora do País --> <!-- 99 - Outros --> <IssRetido>2</IssRetido> <!--identificação se o ISS foi retido pelo tomador ou intermediário quando for o caso--> <!--1-SIM--> <!--2-NAO--> <MunicipioIncidencia>4302105</MunicipioIncidencia> <!--codigo do IBGE do município onde recai a incidência do tributo--> </IdentificacaoDocumento> <Servicos> <Servico> <!--rol de serviços que compõem o RPS--> <Valores> <!--valores monetários, com "." separando decimais sem separação do milhar--> <ValorServicos>10000</ValorServicos> <!--valor bruto dos serviços--> <ValorDeducoes>0</ValorDeducoes> <!--valor das deduções--> <ValorIss>300</ValorIss> <!--valor do ISS sobre o serviço--> <Aliquota>3</Aliquota> <!--valor da Alíquota para cálculo do ISS sobre o serviço(3 ou 3.5 significam 3% ou 3,5%)--> </Valores> <ItemListaServico>1.01</ItemListaServico> <!--código de identificação do serviço conforme lei complementar 116--> <Discriminacao>SERVIÇO TESTE</Discriminacao> <!--discriminação do serviço (disponibilidade de 2000 caracteres)--> </Servico> </Servicos> <Prestador> <CpfCnpj> <Cpf>91593376000102</Cpf> <!--número do CPF/CNPJ que identifica o prestador do serviço da nota fiscal--> </CpfCnpj> <RazaoSocial>TECNOSISTEMAS INFORMÁTICA LTDA.</RazaoSocial> <!--razão social do prestador do serviço da nota fiscal--> <InscricaoMunicipal>31001042</InscricaoMunicipal> <!--inscrição municipal do prestador do serviço da nota fiscal (quando possuir)--> <InscricaoEstadual>31001042</InscricaoEstadual> <!--inscrição estadual do prestador do serviço da nota fiscal (quando possuir)--> <Endereco> <Endereco>RUA DAS CAMÉLIAS</Endereco> <!--endereço do prestador--> <Numero>1024</Numero> <!--numero do logradouro do prestador--> <Complemento>FUNDOS</Complemento> <!--complemento do endereço do prestador--> <Bairro>CENTRO</Bairro> <!--bairro do prestador--> <CodigoMunicipio>4302105</CodigoMunicipio> <!--codigo do municipio do prestador--> <Uf>RS</Uf> <!--unidade da federação do prestador--> <CodigoPais>1058</CodigoPais> <!--codigo do pais do prestador--> <Cep>95700000</Cep> <!--numero do CEP do prestador--> </Endereco> <Contato> <Telefone>5499999999</Telefone> <!--telefone do prestador--> </Contato> </Prestador> <ConstrucaoCivil> <!--se for uma prestação de serviços relacionada à construção civil informe os seus dados--> <CodigoObra>123456</CodigoObra> <!--código da obra no registro do INSS--> <Art>123456</Art> <!--número da ART no CREA--> </ConstrucaoCivil> <ObservacoesNota>Observações da nota</ObservacoesNota> <!--Informações adicionais ou observações da nota--> </ServicoTomado> </ListaServicoTomado> </Lote> </EnvioLoteNotasTomadas>

Para cada envio de remessa o Web Service retornará uma mensagem no formato XML, esta mensagem poderá variar um sua estrutura dependendo das ocorrências no envio de remessa. No envio da remessa, o Web Service realizará uma validação do conteúdo e havendo qualquer inconsistência todo o lote será invalidado. Não haverá processamento parcial de lote, toda a remessa fica registrada quanto ao envio, porém sem efeito de registro nenhum.

Em caso de envio com sucesso, o retorno demonstrará além de identificações regulares do seu envio, o rol de Notas Fiscais processadas na oportunidade. O formato do XML retornado está representado abaixo, porém o detalhamento das tags da Lista de Notas Fiscais será realizado no item 3.1.4 - Consultas Gerais.

<?xml version="1.0" encoding="utf-8"?> <EnvioLoteNotasTomadasResposta xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://www.nfse-tecnos.com.br/nfse.xsd"> <NumeroLote>1</NumeroLote> <!--número do lote enviado--> <DataRecebimento>2012-01-09T11:02:56.9385841-02:00</DataRecebimento> <!--data de recebimento do lote--> <ListaMensagemAlertaRetorno> <!--lista de mensagens detalhando possíveis ocorrências--> <MensagemRetorno> <Codigo>A0000</Codigo> <!--código da mensagem--> <Mensagem>Operação efetuada com sucesso</Mensagem> <!--descrição da mensagem--> <Correcao /> <!--sugestão para correção de eventual ocorrência--> </MensagemRetorno> </ListaMensagemAlertaRetorno> </EnvioLoteNotasTomadasResposta>

Em casos de envios com relato de ocorrências que invalidem a sua utilização, o XML retornado terá apenas a estrutura demonstrada abaixo.

<?xml version="1.0" encoding="utf-8"?> <EnvioLoteNotasTomadasResposta xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://www.nfse-tecnos.com.br/nfse.xsd"> <NumeroLote>1</NumeroLote> <!--número do lote enviado--> <DataRecebimento>2012-01-09T11:02:56.9385841-02:00</DataRecebimento> <!--data de recebimento do lote--> <ListaMensagemRetorno> <!--lista de mensagens detalhando possíveis ocorrências--> <MensagemRetorno> <Codigo>E0002</Codigo> <!--código da mensagem--> <Mensagem>Mês de competência superior ao de emissão do RPS ou da Nota</Mensagem> <!--descrição da mensagem--> <Correcao>Informe um mês de competência inferior ou igual ao de emissão do RPS ou da Nota.</Correcao> <!--sugestão para correção de eventual ocorrência--> </MensagemRetorno> </ListaMensagemRetorno> </EnvioLoteNotasTomadasResposta>

O Lote a ser assinado e deve conter apenas uma assinatura, seguindo o exemplo a seguir:

(... restante do arquivo ...) </ServicoTomado> </ListaServicoTomado> <Signature xmlns = "http://www.w3.org/2000/09/xmldsig#"> <SignedInfo> <CanonicalizationMethodAlgorithm = "http://www.w3.org/TR/2001/REC-xml-c14n-20010315"> <SignatureMethodAlgorithm = "http://www.w3.org/2000/09/xmldsig#rsa-sha1"> <ReferenceURI = "#1999999999999620000000000000001"> <Transforms> <TransformAlgorithm = "http://www.w3.org/2000/09/xmldsig#enveloped-signature"> <TransformAlgorithm = "http://www.w3.org/TR/2001/REC-xml-c14n-20010315"> </Transforms> <DigestMethodAlgorithm = "http://www.w3.org/2000/09/xmldsig#sha1"> <DigestValue>ZuOTmfEuqfe+3BQhmSklYu1FMag=</DigestValue> </ Reference> </ SignedInfo> <SignatureValue>p8QYRuOCgzDiWfBRvP1FOgM5FEhirH48Y/HdA1/FZIk0cRzagKxIWJ71xqnk5nUuKnGXSlYZhK6i5qrnq7Kivwtu XUP41aSkDBZAlu3eU0X0CRFKZA8D64PDdTBzxR/PL3LgSeWIO0cAfJvqopzsgAgnrjZsely PKAHFn0chG9s= </SignatureValue> <KeyInfo> <X509Data> <X509Certificate> MIIClDCCAf2gAwIBAgIBZDANBgkqhkiG9w0BAQUFADBgMQswCQYDVQQGEwJCUjEPMA0GA1UECgwGVGV jbm9zMRYwFAYDVQQLDA1UZWNub3Npc3RlbWFzMSgwJgYDVQQDDB9UZWNub3Npc3RlbWFzIEluZm9ybcOhdGlj YSBMVERBMB4XDTEzMDkyNDAwMDAwMFoXDTE1MDMyNTAwMDAwMFowgYcxCzAJBgNVBAYTAkJSMRQwEgYDV QQKDAtORlNlIFRlY25vczEoMCYGA1UECwwfVGVjbm9zaXN0ZW1hcyBJbmZvcm3DoXRpY2EgTFREQTE4MDYGA1U EAwwvRU1CVVRJRE9TIENSSVNUSUFORVRUSSBMVERBIC0gTUU6MTQwMDY4MDEwMDAxNzkwgZ8wDQYJKoZIh vcNAQEBBQADgY0AMIGJAoGBAO9xRl42AwQva7ZeYU2c0APyYkp/Yq6KQiqAbbpypJsjoqVgI4MjVmEBKBAgwNuj9 lxTxdOvXyaWmicP3vGcZibEzujt8rRp9Dvx+rzF83oqaLS8HkcfeV36+WNKZ2nC66Z0doM+zdPTVqM yEUeEeXHQ9MhirRIz7N/AFsdQVr6DAgMBAAGjNjA0MA4GA1UdDwEB/wQEAwICxDAiBgNVHSMBAf8EGDAWgBT01 y+Vvorv9Fb5ltZMWiOZ6QFDZTANBgkqhkiG9w0BAQUFAAOBgQDi6QqAzjJ31hes2br/JQlMFsnfhjZfUDxoNqAuqjRjco 9YxdoejffLewqn6bLcNiVavWQVusqrqJ6WFJ2nUpctBKGYdJGD8LQ9M/Z08fpXmgNtENGAFMwW1e2IQM/ 1NP3DPODLRzp8d5s25q5hSCvqMiiOVh+KLubqIKTWOnUd+w== </X509Certificate> </ X509Data> </ KeyInfo> </ Signature> </Lote> </EnvioLoteNotasTomadas> (...Final...)