Pular para conteúdo

Gerar Guias por Apuração

A funcionalidade de "Gerar Guias por Apuração" é um recurso essencial para empresas que possuem inscrição estadual na Unidade de Federação (UF) de destino, otimizando o processo de recolhimento de impostos. Essa opção permite agrupar todas as notas fiscais emitidas em um determinado período de apuração em uma única guia de recolhimento, simplificando a gestão fiscal e reduzindo a burocracia.

A geração dessas guias pode ser realizada de três maneiras principais: via tela, SOAP ou REST.

Para gerar as guias via tela, acesse o ícone da extensão InvoiCy GNRE, que exibirá a tela principal da extensão, e localize a opção "Gerar Guia por Apuração".

alt text

Ao selecionar esta opção, uma nova tela denominada "Gerar GNRE por Apuração" será exibida, na qual os dados necessários deverão ser preenchidos. Ressaltando que o campo "Valor" exige a inserção manual do valor da guia a ser gerada.

alt text

Além da geração manual das guias, também é possível gerar a guia por apuração através do Web Service do InvoiCy. Para isso, consuma o Web Service, preencha a estrutura do XML de envio e realize o envio da estrutura SOAP. Além da geração manual das guias, também é possível gerar a guia por apuração através do Web Service do InvoiCy. Para isso, consuma o Web Service, preencha a estrutura do XML de envio e realize o envio da estrutura SOAP.

A emissão de guias também pode ser realizada por meio de integração via API REST. Essa integração permite que sistemas externos se comuniquem com o InvoiCy GNRE para solicitar a geração das guias de forma automatizada. O processo envolve o envio de dados necessários para a emissão da guia, como informações do contribuinte, do documento fiscal, do imposto e do estado de destino, em formato JSON.

Segue abaixo um exemplo da estrutura do XML/JSON de envio:

<GerarGNRE>
    <CNPJEmpresa>99999999999999</CNPJEmpresa>
    <TipoGuia>2</TipoGuia>
    <IE_UFFavorecida>111111</IE_UFFavorecida>
    <UFFavorecida>MS</UFFavorecida>
    <ItensGNRE></ItensGNRE>
        <Item>
            <TipoImposto>DIFAL</TipoImposto>
            <Receita>100110</Receita>
            <Vencimento>2025-09-21</Vencimento>
            <Pagamento>2025-09-21</Pagamento>
            <PeriodoReferencia>2025-09-23</PeriodoReferencia>
            <Valor>100.00</Valor>
      </Item>   
  </ItensGNRE>
</GerarGNRE>

{
  "CNPJEmpresa": "99999999999999",
  "TipoGuia": 2,
  "DadosDocumento": {
     "Numero": 0,
     "Serie": "",
     "Modelo": ""
  },
  "IE_UFFavorecida": "111111",
  "UFFavorecida": "MS",
  "ItensGNRE": [{
          "TipoImposto": "DIFAL",
          "Receita": 100110,
          "Vencimento": "2025-12-15",
          "Pagamento": "2025-12-15",
          "PeriodoReferencia": "2025-12-15",
          "Valor": "100.00"
     }
  ]
}

Para gerar guias por apuração via integração, é essencial que o campo <TipoGuia> seja preenchido com o valor "2", conforme o layout de integração. Este layout detalha todos os campos obrigatórios e opcionais, seus formatos e valores permitidos, garantindo que os dados transmitidos estejam em conformidade com as nossas especificações técnicas, para acessá-lo clique aqui.