Skip to main content

Grupo Tributário

Este fluxo permite que o sistema consulte os grupos tributários que foram atualizados pelos analistas da Lótus Fiscal. Com o retorno dos dados tributários, o sistema pode atualizar todos os produtos da base que possuem o grupo_id vinculado ao grupo atualizado. Isso mantém os produtos sempre atualizados e reduz o tráfego de dados nas atualizações tributárias.

A consulta por DATA retorna as atualizações dos grupos tributários ocorridas no período especificado.

Importante: Esta consulta deve ser processada diariamente pelo sistema de retaguarda (no início ou fim do dia) para verificar todas as possíveis alterações tributárias.

Caso o cliente tenha enfrentado algum problema e não tenha conseguido realizar esta consulta, é possível informar uma data anterior de até 30 dias. Neste caso, a API listará todas as atualizações ocorridas a partir da data informada.

Os tributos são retornados através do array grupos_ret. A consulta deve ser realizada via GET, enviando o parâmetro DATA.

Consulta de Grupos Tributários Atualizados#

Rota de Homologação#

GET https://gwhml.lotusfiscal.com.br/api/v1/fiscal/grupos-atualizados?data={data atualização}Content-Type: application/json

Rota de Produção#

GET https://gw.lotusfiscal.com.br/api/v1/fiscal/grupos-atualizados?data={data atualização}Content-Type: application/json

Descrição#

Retorna um lote de grupos tributários que foram atualizados a partir da data informada.

Parâmetros:

ParâmetroTipoObrigatórioDescrição
datastringSimData em que as atualizações foram aplicadas, respeitando o período máximo de 30 dias.

Atenção: Serão retornados todos os grupos atualizados na data igual ou posterior à informada.

Resposta#

{   "data": "03-05-2024",   "total": 10,   "grupos_ret": [      {         "grupo_id": 23375,         "codigo_cenario_fiscal_id": 8,         "ncm": "4819.20.00",         "cest": "",         "pis_cofins": {             "cst_ent_lp": "70",             "cst_sai_lp": "1 ",             "cst_ent": "50",             "cst_sai": "1 ",             "cst_ent_sn": "99",             "cst_sai_sn": "49",             "aliq_pis_ent": 1.65,             "aliq_pis_sai": 1.65,             "aliq_pis_ent_lp": 0.0,             "aliq_pis_sai_lp": 0.65,             "aliq_cofins_ent": 7.6,             "aliq_cofins_sai": 7.6,             "aliq_cofins_ent_lp": 0.0,             "aliq_cofins_sai_lp": 3.0,             "nri": "",             "amp_legal": "",             "red_pis_ent": 0.0,             "red_pis_sai": 0.0,             "red_cofins_ent": 0.0,             "red_cofins_sai": 0.0         },         "ipi": {             "cst_ent": "3 ",             "cst_sai": "53",             "aliq_ipi_ent": 0.0,             "aliq_ipi_sai": 0.0,             "codenq": "",             "ex": ""         },         "cfop": "5102",         "cst": "0 ",         "csosn": "102",         "desonerado": "S",         "aliq_icms_interna": 18.0,         "aliq_icms_interestadual": null,         "reducao_bc_icms": 0.0,         "reducao_bc_icms_st": 0.0,         "aliq_icms_st": 0.0,         "iva": null,         "iva_ajust": null,         "iva_ajust_4": null,         "iva_ajust_7": null,         "iva_ajust_12": null,         "fcp": 0.0,         "cod_benef": "            ",         "p_difer": null,         "p_isencao": null,         "picms_deson": 0.0,         "mot_des_icms": "",         "isento": "N",         "inf_pdv": {             "picms_pdv": 18.0,             "simb_pdv": "",             "cst_icms": "0 ",             "csosn": "102",             "cst_ent": "50",             "cst_sai": "1 ",             "aliq_pis_ent": 1.65,             "aliq_pis_sai": 1.65,             "aliq_cofins_ent": 7.6,             "aliq_cofins_sai": 7.6         }     }     ...   ]}

Fluxo de Sincronização#

  1. Realizar esta consulta automaticamente uma vez por dia, todos os dias.
  2. Em caso de atualizações encontradas, exibir um relatório ao cliente com todos os itens de sua base que foram afetados por essas atualizações do grupo tributário.
  3. Implementar um botão que permita ao cliente executar manualmente a verificação de atualização.
    • Isso garante que, mesmo em caso de falha na função automática, o cliente mantenha seus dados atualizados.

Exemplo Prático#

Considere o seguinte cenário: Sistema consulta a API em 03/05/2024 e recebe 5 grupos tributários atualizados. Abaixo está um exemplo de como processar essas atualizações:

  1. Recebimento dos Dados

    {  "data": "03-05-2024",  "total": 5,  "grupos_ret": [    ...  ]}

  2. Processamento das Atualizações

    • Para cada grupo retornado, você deve:
      1. Identificar todos os produtos vinculados ao grupo_id
      2. Atualizar as informações tributárias desses produtos

  3. Relatório de Atualização

    • Total de grupos atualizados: 5
    • Total de produtos afetados: 35
    • Data da atualização: 03/05/2024
    • Status: Concluído

  4. Ações Recomendadas

    • Verificar se todos os produtos foram atualizados corretamente
    • Gerar relatório de alterações para o cliente
    • Agendar próxima verificação para 04/05/2024