Enviar base de produtos
Disponibilize no sistema uma opção para que o cliente envie a base completa de produtos sempre que necessário. A API suporta até 500 produtos 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 via IA ficam na fila de revisão manual e, após a correção do analista, podem ser recuperados via Consulta de Revisados.
Aviso: Lembre-se de paginar sua lista em lotes de até 500 itens para evitar falhas por excesso de produtos.
Rota de homologação#
POST https://gwhml.lotusfiscal.com.br/api/v1/fiscal/revisar-baseContent-Type: application/jsonRota de produção#
POST https://gw.lotusfiscal.com.br/api/v1/fiscal/revisar-baseContent-Type: application/jsonCorpo da Requisição (JSON)#
[ { "cprod": "30514", "cean": "7898380380224", "xprod": "VASSOURA PELO 30 CM C CABO EM ALUMÍNIO", "ncm": "96039000", "cst_pis": 49, "ppis": 0, "pcofins": 0, "icms_cst": "0", "csosn": 101, "picms": 18, "cest": "", "vprod": 13.99 }, { "cprod": "36371", "cean": "7891000107843", "xprod": "CHOCOLATE SUFLAIR 20X50G", "ncm": "18063210", "cst_pis": 49, "ppis": 0, "pcofins": 0, "icms_cst": "60", "csosn": 500, "picms": 0, "cest": "17.003.00", "vprod": 5.89 }, { "cprod": "4441", "cean": "7897693500060", "xprod": "BRINQ MINI APITO TRISSON 3 FUROS 20X1", "ncm": "95030091", "cst_pis": 0, "ppis": 0, "pcofins": 0, "icms_cst": "", "picms": 0, "cest": "", "vprod": 85 }]Descrição dos Campos Envio#
| Campo | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| cprod | ✔️ | string | Código interno do produto no sistema |
| cean | ✔️ | string | Código de barras (EAN), para produto sem EAN informar cprod |
| xprod | ✔️ | string | Descrição detalhada do produto |
| ncm | ✔️ | string | Nomenclatura Comum do Mercosul |
| picms | opcional | float | Percentual de ICMS |
| ppis | opcional | float | Percentual de PIS |
| pcofins | opcional | float | Percentual de COFINS |
| icms_cst | opcional | string | Código de Situação Tributária do ICMS |
| csosn | opcional | int | Código de Situação Tributária do Simples Nacional |
| cst_pis | opcional | string | Código de Situação Tributária do PIS |
| cest | opcional | string | Código Especificador da Substituição Tributária |
| vprod | opcional | float | Valor de Venda do Produto |
Observações importantes:
- Os campos marcados como opcionais não são obrigatórios para o funcionamento da API. No entanto, recomendamos fortemente que, caso existam esses dados no seu sistema, eles sejam enviados. Essas informações são utilizadas em relatórios e comparações fiscais, contribuindo para análises mais completas e precisas.
Possíveis erros retornados#
Erro ao exceder o limite de produtos#
HTTP/1.1 400 Bad RequestContent-Type: application/json{ "detail": "Limite de 500 produtos por requisição excedido."}Campo obrigatório não informado#
HTTP/1.1 422 Unprocessable EntityContent-Type: application/json{ "detail": [ { "type": "missing", "loc": [ "body", 0, "cprod" ], "msg": "Field required", "input": { "cean": "36894", "xprod": "CACHEPO PEQ AMARELO 10X1", "ncm": "49119900", "cst_pis": 0, "ppis": 0, "pcofins": 0, "icms_cst": "", "picms": 0, "cest": "" } } ]}