Pular para conteúdo

Cadastro de Prestadores para Consulta de NFS-e de Entrada

Esta funcionalidade é disponibilizada somente para os prestadores de serviços que utilizam o InvoiCy, e que contratam serviços de empresas dos municípios Belo Horizonte (MG), atendido pelo Padrão JFISS Digital e de Maringá (PR), atendida pelo Padrão ISSe.

Permitindo cadastrar seus fornecedores para que o InvoiCy realize a importação de NFS-e de entrada automaticamente, ou seja, quando for contratado um serviço e uma NFS-e for emitida por uma dessas empresas, o InvoiCy irá importar automaticamente esse documento, disponibilizando o mesmo para consulta, download e impressão.

Para utilizar esta funcionalidade é necessário ter a extensão Importação de Documentos ativa nas empresas em que os prestadores serão vinculados.

Cadastro via Tela

O cadastro de prestadores de serviço pode ser realizado acessando o "Painel de Controle" do InvoiCy, no grupo de informações da NFS-e, e clicando em "Cadastro de Prestadores", conforme evidenciado a seguir:

alt text

Ao clicar no ícone "Cadastro de Prestadores", será exibida a tela com a lista de empresas cadastradas e a opção "Adicionar", para ter acesso ao formulário de cadastro de um novo prestador. Caso precise localizar um prestador cadastrado, poderá utilizar os filtros por: CNPJ, Nome, Município, UF e Status.

Os dados dos prestadores cadastrados podem ser alterados (exceto o CNPJ), por meio do ícone "Editar". Caso não queira que o InvoiCy importe documentos emitidos por algum prestador cadastrado, é possível alterar o status para "Inativo", na tela de edição do cadastro, ou realizar a exclusão do registro, por meio do ícone "Excluir".

alt text

Após clicar no botão "Adicionar", será exibida a tela de cadastro de um novo prestador. Preencha as informações dos campos corretamente e clique em "Salvar". A partir deste momento, toda vez que esse prestador emitir uma NFS-e onde você seja o tomador, o InvoiCy irá consultar o documento na prefeitura e realizar a importação do mesmo.

alt text

Cadastro via Integração

Para realizar o cadastro de prestadores via integração SOAP/REST, é necessário enviar algumas informações específicas no XML/JSON do cadastro da empresa ou na atualização deste cadastro. Segue abaixo, um exemplo da estrutura do XML/JSON de envio que deve ser inserida dentro de ParametrosExt:

<Prestadores>
    <Prestador>
        <CNPJ>99999999999999</CNPJ>
        <Nome>Prestador 1</Nome>
        <IBGE>4317202</IBGE>
        <IM>123456789</IM>
        <Status>I</Status>
    </Prestador>
    <Prestador>
        <CNPJ>11111111111111</CNPJ>
        <Nome>Prestador 2</Nome>
        <IBGE>4321808</IBGE>
        <IM>987654321</IM>
        <Status>A</Status>
    </Prestador>
</Prestadores>

"Prestadores":  [
    {
        "CNPJ": "99999999999999",
        "Nome": "Prestador 1",
        "IBGE": "4317202",
        "IM": "123456789",
        "Status": "I",
    },
    {
        "CNPJ": "11111111111111",
        "Nome": "Prestador 2",
        "IBGE": "4321808",
        "IM": "987654321",
        "Status": "A",
    }
]

Dessa forma, podem ser enviados inúmeros prestadores no mesmo cadastro, ao repetir o grupo Prestador. Para mais informações, consulte o XML de envio do cadastro de empresa, clicando aqui ou acesse aqui um exemplo de envio de cadastro de empresa via REST.

Em situações na qual há a necessidade de cadastrar vários prestadores para uma ou inúmeras empresas, o InvoiCy oferece a possibilidade de enviar uma estrutura XML própria, que deve ser enviada ao Web Service arecepcao.aspx. Confira este exemplo aqui.

Este cadastro em massa de prestadores está disponível somente para integração via SOAP.

Consulta via Integração

Para consultar os dados de prestadores específicos ou obter uma lista com todos os registros, é preciso enviar a seguinte estrutura XML para o web service arecepcao.aspx:

<soapenv:Envelope xmlns:soapenv="[http://schemas.xmlsoap.org/soap/envelope/](http://schemas.xmlsoap.org/soap/envelope/)" xmlns:inv="InvoiCy">
   <soapenv:Header/>
   <soapenv:Body>
      <inv:recepcao.Execute>
         <inv:Invoicyrecepcao>
            <inv:Cabecalho>
               <inv:EmpPK>ABCabcCBAcbaA+CabcCBAc==</inv:EmpPK>
               <inv:EmpCK>1245efe2e9b1a9d21e9b522ddf9be6ee</inv:EmpCK>
               <inv:EmpCO></inv:EmpCO>
            </inv:Cabecalho>
            <inv:Informacoes>
               <inv:Texto></inv:Texto>
            </inv:Informacoes>
            <inv:Dados>
               <inv:DadosItem>
                  <inv:Documento><!-- (1) --></inv:Documento>
                  <inv:Parametros></inv:Parametros>
               </inv:DadosItem>
            </inv:Dados>
         </inv:Invoicyrecepcao>
      </inv:recepcao.Execute>
   </soapenv:Body>
</soapenv:Envelope>
  1. Neste campo, informe o XML de envio. Para visualizar um exemplo de envio, clique aqui.

A consulta ao cadastro de prestadores de serviço poderá ser realizada utilizando os filtros por Data de alteração (inicial/final), CNPJ, Status ou Pagina.

O retorno da consulta será dividido em páginas contendo no máximo 500 prestadores, o campo Pagina indica qual página de 500 registros será consultada, informando a página 1 (ou deixando a tag vazia) serão retornados os prestadores do 1 ao 500, informando a página 2 serão retornados os prestadores do 501 ao 1000, e assim por diante. Caso não haja nenhum prestador para a página informada será retornado o código de 390.

Para cada consulta realizada o InvoiCy irá retornar um XML com diferentes informações. A tag ProximaPagina, será retornada com a sequência de páginas a serem consultadas para obter todos os registros encontrados na consulta.