Páginas filhas
  • API - Cadastro de Produtos - Versão 2

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Informações
titleCampos de Envio de Produto

Nome

Tipo

ObrigatórioDescrição
tokenStringSimToken gerado atrás da API de obtenção - API Token.
codigoProdutoNumberSim

Código único do produto. Deve possuir até 14 caracteres.

Campo utilizado como "chave-primária" do cadastro e não pode ser duplicado. 

Caso enviado com valor 0 e o campo "gerarCodigoProduto" enviado com valor true será gerado um código para o produto incrementando o valor +1 ao código de produto de maior valor registrado na base.

gerarCodigoProdutoBooleanSimDefine se deve ser gerado um novo código de produto para o registro enviado. Caso o valor esteja true, será gerado um código para o produto incrementando o valor +1 ao código de produto de maior valor registrado na base.

nomeProduto

String

SimCampo que define o nome do produto que será exibido no PDV. Deve possuir até 100 caracteres.
quantidadeEstoqueDecimalNãoCampo para indicar a quantidade disponível em estoque do produto.
quantidadeMinimaDecimalNãoIndica a quantidade mínima de estoque do produto.
naoExibirNoCardapioBooleanNãoCampo que define se o campo deve ou não ser exibido no cardápio. Caso esteja preenchido com true o produto não será exibido no cardápio.
precoVendaDecimalSimPreço padrão de venda do produto. Deve ser maior que zero.
precoCompraDecimalNãoPreço pago na compra do produto.
divididoPorDecimalNãoCaso a unidade de entrada seja diferente da de saída, define por qual fator a unidade de entrada deve ser dividida no momento da venda. Ex: Unidade de entrada: CX; Unidade de saída: UN; DivididoPor: 12; Cada CX será equivalerá a 12 UN.
pesavelBooleanNãoIndica se o produto é ou não um produto pesável, ou seja, se é vendido por g/kg.
pesoLiquidoDecimalNãoPeso liquido do produto.
descricaoProdutoStringNãoDescrição do produto para exibição no PDV. Deve possuir até 100 caracteres.
margemLucroDecimalNãoValor percentual da margem de lucro do produto.
permitirVendaFracionadaBooleanNãoDefine se o produto pode ser vendido em unidades fracionadas, ou apenas em múltiplos da unidade utilizada.
localImpressaoStringNãoCampo para especificar se deve ser impresso o cupom em impressora não fiscal em outro local de impressão cadastrado no TOTVS Chef. Caso não seja preenchido, por padrão receberá o valor "NENHUM".

idNCM

NumberCondicionalId de registro de NCM cadastrado no TOTVS Chef para definir qual o código NCM será utilizado para o produto. O ID NCM é obrigatório caso a tag <NCM> não seja informada
NCMNumberCondicionalCódigo do NCM utilizado para classificação fiscal do produto. O NCM é obrigatório caso a tag <IDNCM> não seja informada
idCESTNumberNãoId de registro de CEST cadastrado no TOTVS Chef para definir qual o código CEST será utilizado para o produto.
CESTNumber       NãoCódigo do CEST utilizado para classificação da substituição tributária do produto. 
idUnidadeNumberSimId de registro de CEST cadastrado no TOTVS Chef para definir qual o código CEST será utilizado para o produto.
idUnidadeCompraNumberSimId de registro de Unidade de Medida cadastrado no TOTVS Chef para definir a unidade de medida utilizada no momento da compra do produto.
idGrupoNumberCondicionalId de registro de Grupo cadastrado no TOTVS Chef para definir o grupo ao qual o produto faz parte. O idGrupo é obrigatório caso a tag <Grupo> não seja informada
GrupoStringCondicionalNome do Grupo ao qual o produto será vinculado. O Grupo é obrigatório caso a tag <idGrupo> não seja informada
idSubGrupoNumberCondicionalId de registro de SubGrupo cadastrado no TOTVS Chef para definir o grupo ao qual o produto faz parte. O idSubGrupo é obrigatório caso a tag <SubGrupo> não seja informada
SubGrupoStringCondicionalNome do SubGrupo ao qual o produto será vinculado. O SubGrupo é obrigatório caso a tag <idSubGrupo> não seja informada
serialLojaStringNãoCampo que determina para qual loja/gerenciador de franquia a informação será direcionada. Caso não seja preenchido, a informação será armazenada na loja "central".
TributoStringSim

Indicador da forma de tributação do ICMS nas vendas do produto

T - Indica que as vendas desse produto serão tributadas pelo ICMS

I - Indica que as vendas desse produto serão isentas de ICMS

F - Indica que as vendas desse produto foram tributadas por substituição tributária de ICMS

N - Indica que as vendas desse produto serão não tributadas pelo ICMS

IATStringSim

Indicador de Arrendamento ou truncamento nas vendas realizadas no PDV. 

T - Indica que as operações com esse item terão os valores truncados no PDV

A - Indica que as operações com esse item terão os valores arredondados no PDV

IPPTStringSim

Indicador de Produção Própria ou de terceiros do produto. 

T - Indica que o produto foi produzido por terceiros, ou seja, foi comprado ou recebido para venda.

P - Indica que o produto foi produzido no estabelecimento onde será realizada a venda.

CFOPStringSimCFOP que será utilizado nas vendas desse produto realizadas pelo PDV
tpItemStringSim

Tipo do produto que será cadastrado

00 – MERCADORIA PARA REVENDA

01 – MATÉRIA-PRIMA

02 – EMBALAGEM

03 – PRODUTO EM PROCESSO

04 – PRODUTO ACABADO

05 – SUBPRODUTO

06 – PRODUTO INTERMEDIÁRIO

07 – MATERIAL DE USO E CONSUMO

08 – ATIVO IMOBILIZADO

09 – SERVIÇOS

10 – OUTROS INSUMOS

99 – OUTROS

cstICMSStringSimCondicional

Código da Situação Tributária de ICMS, Deverá ser informado de acordo com a tabela disponibilizada pelo fisco, quando a loja for contribuinte do regime normal.

00 – Tributada integralmente
10 – Tributada e com cobrança do ICMS por substituição tributária
20 – Com redução de base de cálculo
30 – Isenta ou não tributada e com cobrança do ICMS por substituição tributária
40 – Isenta
41 – Não tributada
50 – Suspensão
51 – Diferimento
60 – ICMS cobrado anteriormente por substituição tributária
70 – Com redução de base de cálculo e cobrança do ICMS por substituição tributária
90 – Outras

O cstICMS é obrigatório caso a tag <CSOSN> não seja informada

CSOSNStringCondicional

Código da CSOSN do ICMS, Deverá ser informado de acordo com a tabela disponibilizada pelo fisco, quando a loja for contribuinte do regime Simples Nacional.

101    Tributada pelo Simples Nacional com permissão de crédito
102    Tributada pelo Simples Nacional sem permissão de crédito
103    Isenção do ICMS no Simples Nacional para faixa de receita bruta
201    Tributada pelo Simples Nacional com permissão de crédito e com cobrança do ICMS por substituição tributária
202    Tributada pelo Simples Nacional sem permissão de crédito e com cobrança do ICMS por substituição tributária
203    Isenção do ICMS no Simples Nacional para faixa de receita bruta e com cobrança do ICMS por substituição tributária
300    Imune
400    Não tributada pelo Simples Nacional
500    ICMS cobrado anteriormente por substituição tributária (substituído) ou por antecipação
900    Outros

O  CSOSN é obrigatório caso a tag <cstICMS> não seja informada

aliqICMSNumberSimAliquota que será utilizada para cálculo de ICMS nas operações de Venda
redICMSNumberNãoPercentual de redução que será utilizado para cálculo da base do ICMS nas operações de Venda
aliqFCPNumberSimAliquota que será utilizada para cálculo do FCP (FECP) nas operações de Venda
MVANumberNãoMargem de Valor agregado que será utilizada para cálculo da base de ICMS ST nas operações de Venda
redICMSSTNumberNãoPercentual de redução que será utilizado para cálculo da base do ICMS ST nas operações de Venda
aliqICMSSTNumberSimAliquota que será utilizada para cálculo de ICMS ST nas operações de Venda
aliqFCPSTNumberSimAliquota que será utilizada para cálculo do FCP (FECP) ST nas operações de Venda
modBCICMSSTNumberSim

Modelo da Base de Cálculo do ICMS ST nas operações de Venda

0 - Preço Tabelado ou Máximo Sugerido

1 - Lista Negativa (Valor)

2 - Lista Positiva (Valor)

3 - Lista Neutra (Valor)

4 - Margem Valor Agregado (%)

5 - Pauta (Valor)

cBenefStringNãoCódigo de Benefício Fiscal, utilizado para indicar qual incentivo fiscal utilizado na operação. Deverá ser cadastrado de acordo com a tabela disponibilizada pelo fisco estadual.
















cBenefStringNãoCódigo de Benefício Fiscal, utilizado para indicar qual incentivo fiscal utilizado na operação. Deverá ser informado de acordo com a tabela disponibilizada pelo fisco estadual.












...