Histórico da Página

...

Informações

title	Campos de Envio de Produto

Nome	Tipo	Obrigatório	Descrição
token	String	Sim	Token gerado atrás da API de obtenção - API Token.
codigoProduto	Number	Sim	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.
gerarCodigoProduto	Boolean	Sim	Define 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	Sim	Campo que define o nome do produto que será exibido no PDV. Deve possuir até 100 caracteres.
quantidadeEstoque	Decimal	Não	Campo para indicar a quantidade disponível em estoque do produto.
quantidadeMinima	Decimal	Não	Indica a quantidade mínima de estoque do produto.
naoExibirNoCardapio	Boolean	Não	Campo 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.
precoVenda	Decimal	Sim	Preço padrão de venda do produto. Deve ser maior que zero.
precoCompra	Decimal	Não	Preço pago na compra do produto.
divididoPor	Decimal	Não	Caso 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.
pesavel	Boolean	Não	Indica se o produto é ou não um produto pesável, ou seja, se é vendido por g/kg.
pesoLiquido	Decimal	Não	Peso liquido do produto.
descricaoProduto	String	Não	Descrição do produto para exibição no PDV. Deve possuir até 100 caracteres.
margemLucro	Decimal	Não	Valor percentual da margem de lucro do produto.
permitirVendaFracionada	Boolean	Não	Define se o produto pode ser vendido em unidades fracionadas, ou apenas em múltiplos da unidade utilizada.
localImpressao	String	Não	Campo 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	Number	Condicional	Id 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
NCM	Number	Condicional	Código do NCM utilizado para classificação fiscal do produto. O NCM é obrigatório caso a tag <IDNCM> não seja informada
idCEST	Number	Não	Id de registro de CEST cadastrado no TOTVS Chef para definir qual o código CEST será utilizado para o produto.
CEST	Number	Não	Código do CEST utilizado para classificação da substituição tributária do produto.
idUnidade	Number	Sim	Id de registro de CEST cadastrado no TOTVS Chef para definir qual o código CEST será utilizado para o produto.
idUnidadeCompra	Number	Sim	Id de registro de Unidade de Medida cadastrado no TOTVS Chef para definir a unidade de medida utilizada no momento da compra do produto.
idGrupo	Number	Condicional	Id 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
Grupo	String	Condicional	Nome do Grupo ao qual o produto será vinculado. O Grupo é obrigatório caso a tag <idGrupo> não seja informada
idSubGrupo	Number	Condicional	Id 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
SubGrupo	String	Condicional	Nome do SubGrupo ao qual o produto será vinculado. O SubGrupo é obrigatório caso a tag <idSubGrupo> não seja informada
serialLoja	String	Não	Campo 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".
Tributo	String	Sim	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
IAT	String	Sim	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
IPPT	String	Sim	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.
CFOP	String	Sim	CFOP que será utilizado nas vendas desse produto realizadas pelo PDV

Informações

icon	false
title	Exemplo de Chamada

URL do Serviço: POST:http://{url_do_servidor}/api/produto/salvarProduto

Bloco de código

title	Request

{
  "serialLoja": "1234567",
  "token": "String",
  "codigoProduto": 123,
  "gerarCodigoProduto": false,
  "nomeProduto": "String",
  "quantidadeEstoque": 0.0,
  "quantidadeMinima": 0.0,
  "naoExibirNoCardapio": false,
  "precoVenda": 0.0,
  "precoCompra": 0.0,
  "divididoPor": 1.0,
  "pesavel": false,
  "pesoLiquido": 0.0,
  "descricaoProduto": "String",
  "margemLucro": 0.0,
  "permitirVendaFracionada": false,
  "localImpressao": "String",
  "idNCM": 1,
  "NCM": 12345678,    
  "idCEST": 1,   
  "CEST": 1234567, 
  "idUnidade": 1,
  "idUnidadeCompra": 1,
  "idGrupo": 1,   
  "Grupo": "Bebidas", 
  "idSubGrupo": 1,  
  "idSubGrupo": "Sucos",  
}

Bloco de código

title	Response Sucesso

{
   "codigo": 12345,
   "sucesso": true,
   "mensagens": [ ]
}

Bloco de código

title	Response Erro

{
   "codigo": null,
   "sucesso": false,
   "mensagens": [
       "Mensagem de erro de exemplo."
   ]
}

...

Atalhos

Páginas filhas

Versões comparadas

Versão antiga 1

Nova versão 2

Chave