Skip to main content

Enviar produtos novos ou atualizados

Sempre que um produto for cadastrado ou atualizado, o sistema deve enviá-lo para análise de tributação pela Lótus Fiscal. Este endpoint aceita apenas um produto por requisição. Se o produto for encontrado, a resposta será retornada em tempo real. Caso contrário, ele será encaminhado para a fila de análise manual por um analista.

Rota de homologação#

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

Rota de produção#

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

Corpo da Requisição (JSON)#

{    "cprod": "10",    "cean": "7898911527777",    "xprod": "ACENDEDOR DE FOGAO ULTILIDADES BRASIL",    "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",    "vprod": 5.79}

Descrição dos Campos Envio#

CampoObrigatórioTipoDescrição
cprod✔️stringCódigo interno do produto no sistema
cean✔️stringCódigo de barras (EAN), para produto sem EAN informar cprod
xprod✔️stringDescrição detalhada do produto
ncm✔️stringNomenclatura Comum do Mercosul
picmsopcionalfloatPercentual de ICMS
ppisopcionalfloatPercentual de PIS
pcofinsopcionalfloatPercentual de COFINS
icms_cstopcionalstringCódigo de Situação Tributária do ICMS
csosnopcionalintCódigo de Situação Tributária do Simples Nacional
cst_pisopcionalstringCódigo de Situação Tributária do PIS
cestopcionalstringCódigo Especificador da Substituição Tributária
vprodopcionalfloatValor 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#

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": ""            }        }    ]}