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 Nexos 360. 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.nexos360.com.br/api/v1/fiscal/consulta-produtoContent-Type: application/json

Rota de produção

POST https://gw.nexos360.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

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

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