Consulta de Produtos

A consulta de produtos suporta até 500 itens por requisição. Para listas maiores, envie múltiplas requisições em lotes de até 500 produtos.

Produtos não encontrados por EAN, código interno ou descrição ficam na fila de revisão manual e, após correção pelo analista, podem ser recuperados via Consulta de Revisados.

Aviso: Lembre-se de paginar sua lista em batches de 500 para evitar falhas por excesso de itens.

Rota de Homologação

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

Rota de Produção

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

Corpo da Requisição (JSON)

{    "emitente": {        "regime_especial": "",        "substituto_tributario_icms": "N"    },    "perfil": {        "uf": [            "SP"        ],        "cfop": "6403",        "codigo_cenario_fiscal": [           8        ],        "regime_tributario": "LR",        "origem_mercadoria": "0",        "substituto_tributario_icms": "N"    },    "produtos": [        {            "cprod": 10,            "cean": "0763331023765",            "xprod": "DIANTEIRO DE BOI SEM CUPIM (1 PCS)",            "ncm": "1601.00.00",            "picms": 20,            "ppis": 1.65,            "pcofins": 7.6,            "icms_cst": "60",            "csosn": 500,            "cst_pis": 2.8,            "cest": "10.062.00"        },        {            "cprod": 10,            "cean": "7894321811277",            "xprod": "DIANTEIRO DE BOI SEM CUPIM (1 PCS)",            "ncm": "1601.00.00",            "picms": 20,            "ppis": 1.65,            "pcofins": 7.6,            "icms_cst": "60",            "csosn": 500,            "cst_pis": 2.8,            "cest": "10.062.00"        },        {            "cprod": 10,            "cean": "8004323700069",            "xprod": "DIANTEIRO DE BOI SEM CUPIM (1 PCS)",            "ncm": "1601.00.00",            "picms": 20,            "ppis": 1.65,            "pcofins": 7.6,            "icms_cst": "60",            "csosn": 500,            "cst_pis": 2.8,            "cest": "10.062.00"        },        {            "cprod": 10,            "cean": "7898912222046",            "xprod": "DIANTEIRO DE BOI SEM CUPIM (1 PCS)",            "ncm": "1601.00.00",            "picms": 20,            "ppis": 1.65,            "pcofins": 7.6,            "icms_cst": "60",            "csosn": 500,            "cst_pis": 2.8,            "cest": "10.062.00"        },        {            "cprod": 10,            "cean": "7898342050257",            "xprod": "DIANTEIRO DE BOI SEM CUPIM (1 PCS)",            "ncm": "1601.00.00",            "picms": 20,            "ppis": 1.65,            "pcofins": 7.6,            "icms_cst": "60",            "csosn": 500,            "cst_pis": 2.8,            "cest": "10.062.00"        }    ]}

Tabela de codigo_cenario_fiscal

Código	Cenário Fiscal
0	Industrial
1	Distribuidor
2	Atacadista
3	Varejista
4	Produtor Rural Pessoa Jurídica
5	Atacado PTA ST
6	Produtor Rural Pessoa Física
7	Pessoa Jurídica não Contribuinte do ICMS
8	Pessoa Física não Contribuinte do ICMS
9	Armazém Geral

Opções de regime_tributario

Código	Descrição
SN	Simples Nacional
LR	Lucro Real
LP	Lucro Presumido

Origem da Mercadoria ou Serviço

Código	Descrição
0	Nacional, exceto as indicadas nos códigos 3 a 5
1	Estrangeira – Importação direta, exceto a indicada no código 6
2	Estrangeira – Adquirida no mercado interno, exceto a indicada no código 7
3	Nacional, mercadoria ou bem com Conteúdo de Importação superior a 40%
4	Nacional, produzida conforme processos básicos (Decreto-Lei 288/1967 e Leis 8.248/1991, 8.387/1991, 10.176/2001 e 11.484/2007)
5	Nacional, mercadoria ou bem com Conteúdo de Importação inferior ou igual a 40%
6	Estrangeira – Importação direta, sem similar nacional (Resolução Camex) e gás natural
7	Estrangeira – Adquirida no mercado interno, sem similar nacional (Resolução Camex) e gás natural
8	Nacional, mercadoria ou bem com Conteúdo de Importação superior a 70%

Descrição dos Campos

Entidade perfil (Remetente/Destinatário)

• uf: lista de UFs de destino para a operação.
• cfop: CFOP da operação desejada.
• codigo_cenario_fiscal: array de códigos conforme a tabela acima.
• regime_tributario: SN, LR ou LP.
• origem_mercadoria: valor conforme a tabela de Origem da Mercadoria ou Serviço.
• substituto_tributario_icms: “S” ou “N”, indica se há substituição tributária no ICMS.

Entidade produtos

• cprod: código interno do produto no sistema.
• cean: código de barras (EAN) do produto.
• xprod: descrição detalhada do produto.
• ncm: Nomenclatura Comum do Mercosul.
• picms: percentual de ICMS.
• ppis: percentual de PIS.
• pcofins: percentual de COFINS.
• icms_cst: Código de Situação Tributária do ICMS.
• csosn: Código de Situação do Simples Nacional.
• cst_pis: Código de Situação Tributária do PIS.
• cest: Código Especificador da Substituição Tributária.