Skip to main content

Produtos Revisados

Este fluxo permite que o ERP consulte os produtos revisados por analistas tributários da Lótus Fiscal, e confirme seu recebimento antes que a API envie novos produtos. Isso garante que nenhum item seja perdido, duplicado ou entregue fora de ordem.

Visão Geral#

  • A API organiza os produtos em lotes de entrega.
  • O ERP solicita um lote via GET.
  • A API só gera um novo lote quando o anterior for confirmado.
  • O ERP confirma o recebimento do lote via POST.

1. Consultar produtos revisados#

Rota de homologação#

GET https://gwhml.lotusfiscal.com.br/api/v1/fiscal/produtos-revisados?limit={quantidade}Content-Type: application/json

Rota de produção#

GET https://gw.lotusfiscal.com.br/api/v1/fiscal/produtos-revisados?limit={quantidade}Content-Type: application/json

Descrição:#

Retorna um lote de produtos revisados ainda não sincronizados pelo sistema do cliente.

Parâmetros:

ParâmetroTipoObrigatórioDescrição
limitintSimQuantidade máxima de produtos a retornar no lote, valores permitidos 100, 300, 600, 800, 1000

⚠️ Se já houver um lote pendente, esse mesmo lote será retornado novamente.

Resposta:#

{  "lote_id": "lote-20240503-001",  "quantidade": 500,  "total_pendentes": 1000,  "prod_ret": [     {        "grupo_id": 23375,        "codigo_cenario_fiscal_id": 8,        "prod_ean": "7898575511785",        "prod_nome": "Cachepot NC Pequeno Sem Micro Amarelo 10UN",        "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        }    }    ...  ]}

2. Confirmar recebimento dos produtos revisados#

Rota de homologação#

POST https://gwhml.lotusfiscal.com.br/api/v1/fiscal/confirmar-sincronizacaoContent-Type: application/json

Rota de produção#

POST https://gw.lotusfiscal.com.br/api/v1/fiscal/confirmar-sincronizacaoContent-Type: application/json

Descrição:#

Confirma que o sistema processou os produtos do lote. Após essa confirmação, a API libera o próximo lote disponível.

Requisição:#

{  "lote_id": "lote-20240503-001"}

⚠️ Apenas o lote_id é necessário. A API internamente associa esse ID aos produtos enviados.

Resposta:#

{  "status": "confirmado",  "lote_id": "lote-20240503-001",  "quantidade_confirmada": 500}

Fluxo de Sincronização#

  1. Sistema solicita um lote:

    GET https://gw.lotusfiscal.com.br/api/v1/fiscal/produtos-revisados?limit=500
    • API retorna 500 produtos com lote_id = lote-20240503-001.

  2. Sistema processa os produtos recebidos da API.

  3. Chama o confirma recebimento:

    POST https://gw.lotusfiscal.com.br/api/v1/fiscal/confirmar-sincronizacao{  "lote_id": "lote-20240503-001"}

  4. Sistema solicita novo lote: e o processo se repete.

Regras de Negócio#

  • Produtos são entregues uma única vez por lote.
  • A API não libera um novo lote até que o anterior seja confirmado.
  • Caso novos produtos sejam inseridos na base enquanto um lote está pendente, eles aguardam até a confirmação do lote atual.

Estados Internos dos Produtos#

StatusSignificado
pendentePronto para ser atribuído a um lote.
em_loteJá enviado para o sistema, aguardando confirmação.
sincronizadoConfirmado como recebido pelo sistema.

Alerta: sempre confirme o lote (POST /confirmar-sincronizacao) antes de solicitar outro.