...

Aviso
Para que a baixa do Produto criado ocorra no PDV Omni é necessário realizar a abertura de um lote do tipo 12 = Produto

titleexpandtitleDefinição de requisiçãoNovo valor unitário

Deck of Cards

id	versções

Card

label	V3.1 (V2)

Requisição

Section

Column

width	50%

Expandir

Exemplo de body da requisição

[
{
"

descricao

aliquotaIcms":

"string"

0,
"

unidadeMedida

arredondaTrunca":

"string"

0,
"

descontoMaximo

associacaoProdutosClassificacao":

"string",

[

"arredondaTrunca": 0,

{
"

codigoProduto

idRetaguarda": "string",
"

codigoAlternativo

idRetaguardaClassificacaoProduto": "string",
"

origemProduto

idRetaguardaProduto":

0,
"situacao": 0

"string",

"imagem": "string",

"

tipoProduto

ordem": 0,

"fracionado": true,

"

cnpjFornecedor

situacao":

"string",

0

"escalaRelevante": true,

}

"cstIcms": "string"

],
"

percentualReducaoIcms

cest": "string",
"

aliquotaIcms

cnpjFornecedor": "string",
"

vlicmsret

codigoAlternativo": "string",
"

cest

codigoProduto": "string",
"

encomenda

codigosProduto":

true,

[

"pesoLiquido": 0,

{

"pesoBruto": 0,

"

associacaoProdutosClassificacao

codigo":

[
{

"string",
"

idRetaguarda

dataAtualizacao": "

string

2024-03-28T13:13:11.127Z",
"

idRetaguardaProduto

dataCadastro": "

string

2024-03-28T13:13:11.127Z",
"

idRetaguardaClassificacaoProduto

descricao": "string",
"

ordem

idRetaguarda":

0

"string",
"situacao": 0
}
],
"

produtoEmbalagens

cstIcms":

[

"string",

{

"descontoMaximo": "string",

"

codigoBarras

descricao": "string",
"encomenda": true,
"

descricao

escalaRelevante":

"string"

true,
"fcps": [

"idProdutoRetaguarda": "string",

{
"

idRetaguarda

codigoBeneficioFiscal": "string",
"

pesoBruto

descontaDesoneracaoNf":

0

true,
"

pesoLiquido

idProprietario":

0

"string",
"

quantidade

motivoDesoneracaoIcms": 0,
"

situacao

percentualFcp":

0

"string",
"

unidadeMedida

valorBaseFcp": "string"
}
],
"

produtoKits

fracionado":

[
{

true,

"

idRetaguardaProduto

idInquilino": "string",

"

idRetaguardaProdutoKit

idProprietario": "string",

"

descricao

idRetaguarda": "string",

"

quantidadeVendaKit

imagem":

0

"string",

"

tipoValorKit

impostos":

0,

[

"situacao": 0,

{
"

valorDesconto

idProprietario": "string",
"

novoValorUnitario

idRetaguarda": "string"
}
],
"

produtosSimilares

loteOrigem":

[

"string",

"ncms": [
{
"

idRetaguardaProduto

idProprietario": "string",
"

idRetaguardaSimilar

idRetaguarda": "string"

,

}
],
"

situacao

origemProduto": 0,

}

"percentualReducaoIcms": "string",
"pesoBruto": 0,

]

"pesoLiquido": 0,
"

produtosSugestoes

pisCofins": [
{
"

idRetaguardaProduto

idProprietario": "string",
"

idRetaguardaSugestao

idRetaguarda": "string"

,

}

"situacao": 0

],

}
],
"codigosProduto"

"produtoEmbalagens": [
{
"

codigo

codigoBarras": "string",
"descricao": "string",
"

idRetaguarda

idProdutoRetaguarda": "string",
"

dataAtualizacao

idRetaguarda": "

2024-03-28T13:13:11.127Z

string",
"

dataCadastro

pesoBruto":

"2024-03-28T13:13:11.127Z"

0,
"

situacao

pesoLiquido": 0,

}

"quantidade": 0,

],

"

impostos

situacao":

[

0,

{
"idRetaguarda": "string",
"idProprietario

"unidadeMedida": "string"
}
],
"

ncms

produtoKits": [
{
"

idRetaguarda

descricao": "string",
"

idProprietario

idRetaguardaProduto": "string",

}

"idRetaguardaProdutoKit": "string",

],

"

pisCofins

novoValorUnitario":

[

"string",

{

"quantidadeVendaKit": 0,
"

idRetaguarda

situacao":

"string"

0,
"

idProprietario

tipoValorKit": 0,
"valorDesconto": "string"
}
],
"

fcps

produtosSimilares": [
{
"

valorBaseFcp

idRetaguardaProduto": "string",
"

percentualFcp

idRetaguardaSimilar": "string",
"

codigoBeneficioFiscal

situacao":

"string",

0
}
],
"

motivoDesoneracaoIcms

produtosSugestoes":

0,

[
{
"

descontaDesoneracaoNf

idRetaguardaProduto":

true

"string",
"

idProprietario

idRetaguardaSugestao": "string",

}

"situacao": 0
}
],
"quantidadeMovimentacao": 0,
"

idInquilino

situacao":

"string"

0,
"

idRetaguarda

tipoProduto":

"string"

0,
"

idProprietario

unidadeMedida": "string",
"

loteOrigem

vlicmsret": "string"
}
]

Column

width

50%

Definições dos campos

do body

Campo

Tipo

Descrição

Obrigatório

Observações

descricao

string

Descrição do produto

Sim

Tamanho máximo: 200
Estes caracteres especiais: "\r","\n","\"",@"\" são removidos ao inserir no PDV, pois podem ocasionar erro na SEFAZ.

unidadeMedida

string

Unidade de medida do produto

X

Sim

Tamanho máximo: 20

descontoMaximo

string

numérico

Desconto máximo aplicado ao produto

Não

arredondaTrunca


tipoArredondaTrunca	int		Não
codigoProduto	string	Código do produto

X

Sim	Tamanho máximo:

600

20
codigoAlternativo	string	Código alternativo do produto

X

Sim

Tamanho máximo: 40

origemProduto

int

Origem do produto

X

situacao

int

Situação do produto (0 - Inativo, 1 - Ativo)

X

imagem

string

URL com a imagem do produto

tipoProduto

int

Tipo do produto

X

fracionado

boolean

Indica se o produto é vendido fracionado

cnpjFornecedor

string

CNPJ do fornecedor do produto

escalaRelevante

boolean

Escala relevante

cstIcms

string

CST ICMS do produto

percentualReducaoIcms

string

Percentual de redução ICMS

aliquotaIcms

string

Aliquota ICMS

vlicmsret

string

vlicmsret

cest

string

Cest

encomenda

boolean

Indica se o produto é uma encomenda

pesoLiquido

float

Peso liquido do produto

pesoBruto

float

Peso bruto do produto

associacaoProdutosClassificacao

Lista de objetos

Lista de classificação do produto

associacaoProdutosClassificacao.idRetaguarda

string

Identificador da classificação na retaguarda

associacaoProdutosClassificacao.idRetaguardaProduto

string

Identificador do produto na retaguarda

associacaoProdutosClassificacao.idRetaguardaClassificacaoProduto

string

Identificador da classificação na retaguarda

associacaoProdutosClassificacao.ordemOpcional

int

Ordem opcional

associacaoProdutosClassificacao.situacao

int

Situação da classificação

produtoEmbalagens

lista de objetos

Lista de embalagens do produto

produtoEmbalagens.codigoBarras

string

Código de barras da embalagem

produtoEmbalagens.descricao

string

Descrição da embalagem

Estes caracteres especiais: "\r","\n","\"",@"\" são removidos ao inserir no PDV, pois podem ocasionar erro na SEFAZ.

produtoEmbalagens.idProdutoRetaguarda

string

Identificador do produto na retaguarda

produtoEmbalagens.idRetaguarda

string

Identificador da embalagem na retaguarda

produtoEmbalagens.pesoBruto

float

Peso bruto da embalagem

produtoEmbalagens.pesoLiquido

float

Peso liquido da embalagem

produtoEmbalagens.quantidade

int

Quantidade de produtos na embalagem

produtoEmbalagens.situacao

int

Situação da embalagem

produtoEmbalagens.unidadeMedida

string

Unidade de medida da embalagem

produtoKits

Lista de objetos

Lista de kits

produtoKits.idRetaguardaProduto

string

Identificador do produto na retaguarda

produtoKits.idRetaguardaProdutoKit

string

Identificador do kit na retaguarda

produtoKits.descricao

string

Descrição do kit

produtoKits.quantidadeVendaKit

int

Quantidade de venda do kit

produtoKits.tipoValorKit

int

Tipo valor kit

produtoKits.situacao

int

Situação do kit

produtoKits.valorDesconto

string

Valor de desconto

produtoKits.novoValorUnitario

string

Sim

0 – Nacional: exceto as indicadas nos códigos 3, 4, 5 e 8;
1 – Estrangeira: importação direta, exceto a indicada no código 6;
2 – Estrangeira: adquirida no mercado interno, exceto a indicada no código 7;
3 – Nacional: mercadoria ou bem com conteúdo de importação superior a 40% e inferior ou igual a 70%;
4 – Nacional: cuja produção tenha sido feita em conformidade com os processos produtivos básicos de que tratam o Decreto-Lei nº 288/1967, e as Leis nº 8.248/1991, 8.387/1991, 10.176/2001 e 11.484/2007;
5 – Nacional: mercadoria ou bem com Conteúdo de Importação inferior ou igual a 40%;
6 – Estrangeira: importação direta, sem similar nacional, constante em lista de Resolução Camex e gás natural;
7 – Estrangeira: adquirida no mercado interno, sem similar nacional, constante em lista de Resolução Camex e gás natural;
8 – Nacional: mercadoria ou bem com Conteúdo de Importação superior a 70%.

situacao

int

Situação do produto

Sim

0 - Inativo, 1 - Ativo

imagem

string

URL com a imagem do produto

Não

Tamanho máximo: 200 caracteres

tipoProduto

int

Tipo do produto

Não

Descrição	Valor
Não definido	0
Consumo	1
Revenda	2
Kit	3
Matéria	4
Produto acabado	5
Serviço	6

fracionado

boolean

Indica se o produto é vendido fracionado

Não

cnpjFornecedor

string

CNPJ do fornecedor do produto

Não

Tamanho máximo: 20 caracteres

escalaRelevante

boolean

Escala relevante

Não

cstIcms

string

DEFASADO

Não

Tamanho máximo: 4 caracteres

percentualReducaoIcms

numérico

Percentual de redução ICMS

Não

aliquotaIcms

numérico

Aliquota ICMS

Não

Pode ser enviado como string para atender ao legado, contudo, caso se enviado algo que não possa ser convertido para inteiro será devolvido um retorno de erro.

vlicmsret

string

DEFASADO

Não

Tamanho máximo: 7 caracteres

cest

string

Cest

Não

encomenda

boolean

Indica se o produto é uma encomenda

Não

pesoLiquido

numérico

Peso liquido do produto

Não

pesoBruto

numérico

Peso bruto do produto

Não

associacaoProdutosClassificacao

Lista de objetos

Lista de classificação do produto

Não

associacaoProdutosClassificacao.idRetaguarda

string

Identificador da classificação na retaguarda

Sim

Tamanho máximo: 100 caracteres

associacaoProdutosClassificacao.idRetaguardaProduto

string

Identificador do produto na retaguarda

Sim

associacaoProdutosClassificacao.idRetaguardaClassificacaoProduto

string

Identificador da classificação na retaguarda

Sim

associacaoProdutosClassificacao.ordem

int

Ordem

Sim

associacaoProdutosClassificacao.situacao

int

Situação da classificação

Sim

produtoEmbalagens

lista de objetos

Lista de embalagens do produto

Não

produtoEmbalagens.codigoBarras

string

Código de barras da embalagem

Sim

Tamanho máximo: 20 caracteres

produtoEmbalagens.descricao

string

Descrição da embalagem

Não

Tamanho máxiom: 200 caracteres
Estes caracteres especiais: "\r","\n","\"",@"\" são removidos ao inserir no PDV, pois podem ocasionar erro na SEFAZ.

produtoEmbalagens.idProdutoRetaguarda

string

Identificador do produto na retaguarda

Sim

Tamanho máximo: 100 caracteres

produtoEmbalagens.idRetaguarda

string

Identificador da embalagem na retaguarda

Sim

Tamanho máximo: 100 caracteres

produtoEmbalagens.pesoBruto

int

Peso bruto da embalagem

Não

produtoEmbalagens.pesoLiquido

int

Peso liquido da embalagem

Não

produtoEmbalagens.quantidade

int

Quantidade de produtos na embalagem

Não

produtoEmbalagens.situacao

int

Situação da embalagem

Sim

0 - Inativo 1 - Ativo

produtoEmbalagens.unidadeMedida

string

Unidade de medida da embalagem

Sim

produtoKits

Lista de objetos

Lista de kits

Não

produtoKits.idRetaguarda

string

Registo único, responsável por identificar o item na tabela de produto_kit.

Sim

Tamanho máximo: 100 caracteres
Registro único, não deve ser enviado mais de uma vez, em caso de criação de itens dentro do kit.
Caso seja enviado mais de uma vez, o mesmo código, o registro será alterado.

produtoKits.idRetaguardaProduto

string

Identificador do produto KIT criado na tabela de produto.

Não

Todo kit é um produto, devido a isso sempre haverá um registro descrito como kit na tabela de produto.

produtoKits.idRetaguardaProdutoKit

string

Identificador do item do kit na tabela de produto

Não

Referencia os itens da tabela de produto que compõe o kit.

produtoKits.descricao

string

Descrição do produto que compõe o KIT

Sim

Tamanho máximo: 100 caracteres

produtoKits.quantidadeVendaKit

int

Quantidade daquele determinado item dentro do KIT.

Sim

produtoKits.tipoValorKit

int

Tipo valor kit

Sim

Tipo	Valor	Descrição
Não tem desconto	0	O valor da tabela vigente será considerado para o item
Valor fixo	1	O valor do campo novoValorUnitario será o valor do item no KIT
Percentual desconto	2	O valor do campo valorDesconto será aplicado no item percentualmente. Por exemplo: Se o valor da valorDesconto for 10.00, será aplicado 10% de desconto no item

produtoKits.situacao

int

Situação do kit

Sim

0 - Inativo 1 - Ativo

produtoKits.valorDesconto

numérico

Valor percentual que será aplicado de desconto no item da composição do KIT

Não

produtoKits.novoValorUnitario

numérico

Valor real que será aplicado de desconto no item da composição do KIT, desconsiderando o valor da tabela de preço atual

Não

produtosSimilares

Lista de objetos

Lista de produtos similares

Não

produtosSimilares.idRetaguardaProduto

string

Identificador do produto na retaguarda

Sim

Tamanho máximo: 100 caracteres

produtosSimilares.idRetaguardaSimilar

string

Identificador do produto similar na retaguarda

Sim

Tamanho máximo: 100 caracteres

produtosSimilares.situacao

int

Situação do produto similar

Sim

0 - Inativo 1 - Ativo

produtosSugestoes

Lista de objetos

Lista de sugestôes

Não

produtosSugestoes.idRetaguardaProduto

string

Identificador do produto na retaguarda

Sim

produtosSugestoes.idRetaguardaSugestao

string

Identificador da sugestão na retaguarda

Sim

produtosSugestoes.situacao

int

Situação da sugestão

Sim

codigosProduto

Lista de objetos

Lista de códigos do produto

Não

codigosProduto.codigo

string

Código do produto

Não

codigosProduto.descricao

string

Descrição do código

Não

codigosProduto.idRetaguarda

string

Identificador do código na retaguarda

Não

codigosProduto.dataAtualizacao

string

Data atualização do código

Não

codigosProduto.dataCadastro

string

Data cadastro do código

Não

codigosProduto.situacao

int

Situação do produto

Não

impostos

Lista de objetos

Lista de impostos do produto

Sim

impostos.idRetaguarda

string

Identificador do imposto na retaguarda

Sim

impostos.idProprietario

string

Identificador do proprietário

Sim

ncms

Lista de objetos

Lista de NCMs

Sim

ncms.idRetaguarda

string

Identificador do NCM na retaguarda

Sim

ncms.idProprietario

string

Identificador do proprietário

Sim

pisCofins

Lista de objetos

Lista de PisCofins

Sim

pisCofins.idRetaguarda

string

Identificador do PisCofin na retaguarda

Sim

pisCofins.idProprietario

string

Identificador do proprietário

Sim

fcps

Lista de objetos

Lista de FCPs

Não

fcps.valorBaseFcp

string

DEFASADO

Não

fcps.percentualFcp

numérico

Percentual do FCP

Não

fcps.codigoBeneficioFiscal

string

Código de benefício fiscal

Não

Tamanho máximo: 20 caracteres

fcps.motivoDesoneracaoIcms

int

Motivo desoneração

Não

fcps.descontaDesoneracaoNf

boolean

DEFASADO

Não

fcps.idProprietario

string

Identificador do proprietário

Não

quantidadeMovimentacao

numérico

Quanitdade de movimentação

Não

idInquilino

string

Identificador do inquilino

Sim

idRetaguarda

string

Identificador do produto na retaguarda

Sim

Tamanho máximo: 100

idProprietario

string

Identificador do proprietário

Sim

loteOrigem

string

Identificador do lote que os dados serão enviados

Sim

Retorno

Deck of Cards

id	retornos

Card

label	200 - Ok

Column

width	50%

Exemplo de body de retorno

{
"success": true,
"message": "Requisição inserida com sucesso!",
"data": null,
"errors": null,
"totalTime": 0,
"numberOfRecords": 0
}

Column

width	50%

Definições dos campos do retorno

Campo	Tipo	Descrição
Success	bool	Indica se a criação do compartilhamento foi feita com sucesso
Message	string	Caso ocorra erros durante a criação do compartilhamento eles serão enviados nesse campo
Data	objeto	Objeto compartilhamento criado
Errors	Lista	Listas com os erros encontrados no processo
TotalTime	int	tempo da requisição
NumberOfRecords	int	número de dados inseridos

Card

label	400 - Bad Request

Column

width	50%

Exemplo de body de retorno

{
"code": "string",
"message": "string",
"detailedMessage": "string",
"helpUrl": "string",
"details": [
{
"guid": "string",
"code": "string",
"message": "string",
"detailedMessage": "string"
}
]
}

Column

width	50%

Definições dos campos do retorno

Campo	Tipo	Descrição
code	string	Código de erro
message	string	Mensagem do erro
detailedMessage	string	Detalhamento do erro
helpUrl	string	url de ajuda
TotalTime	string	Tempo total de busca
details	lista de objeto	Lista de objeto de erros
details.guid	string	Identificador do erro
details.code	string	Código do erro
details.message	string	Mensagem do erro
details.detailedMessage	string	Detalhamento do erro

Card

label	V3.2

Informações
Este endpoint ainda está em processo de manutenção, as informações estão disponibilizadas apenas para consulta, não sendo possível realizar a requisição.

Requisição

Section

Column

width	50%

Exemplo de body da requisição

[
{
"descricao": "string",
"unidadeMedida": "string",
"descontoMaximo": "string",
"arredondaTrunca": 0,
"codigoProduto": "string",
"codigoAlternativo": "string",
"origemProduto": 0,
"situacao": 0,
"imagem": "string",
"tipoProduto": 0,
"fracionado": true,
"cnpjFornecedor": "string",
"escalaRelevante": true,
"cstIcms": "string",
"percentualReducaoIcms": "string",
"aliquotaIcms": 0,
"vlicmsret": "string",
"cest": "string",
"encomenda": true,
"pesoLiquido": 0,
"pesoBruto": 0,
"associacaoProdutosClassificacao": [
{
"idRetaguarda": "string",
"idRetaguardaProduto": "string",
"idRetaguardaClassificacaoProduto": "string",
"ordem": 0,
"situacao": 0
}
],
"produtoEmbalagens": [
{
"codigoBarras": "string",
"descricao": "string",
"idProdutoRetaguarda": "string",
"idRetaguarda": "string",
"pesoBruto": 0,
"pesoLiquido": 0,
"quantidade": 0,
"situacao": 0,
"unidadeMedida": "string"
}
],
"produtoKits": [
{
"idRetaguardaProduto": "string",
"idRetaguardaProdutoKit": "string",
"descricao": "string",
"quantidadeVendaKit": 0,
"tipoValorKit": 0,
"situacao": 0,
"valorDesconto": "string",
"novoValorUnitario": "string"
}
],
"produtosSimilares": [
{
"idRetaguardaProduto": "string",
"idRetaguardaSimilar": "string",
"situacao": 0
}
],
"produtosSugestoes": [
{
"idRetaguardaProduto": "string",
"idRetaguardaSugestao": "string",
"situacao": 0
}
],
"codigosProduto": [
{
"codigo": "string",
"descricao": "string",
"idRetaguarda": "string",
"dataAtualizacao": "2024-03-28T13:13:11.127Z",
"dataCadastro": "2024-03-28T13:13:11.127Z",
"situacao": 0
}
],
"impostos": [
{
"idRetaguarda": "string",
"idProprietario": "string"
}
],
"ncms": [
{
"idRetaguarda": "string",
"idProprietario": "string"
}
],
"pisCofins": [
{
"idRetaguarda": "string",
"idProprietario": "string"
}
],
"fcps": [
{
"valorBaseFcp": "string",
"percentualFcp": "string",
"codigoBeneficioFiscal": "string",
"motivoDesoneracaoIcms": 0,
"descontaDesoneracaoNf": true,
"idProprietario": "string"
}
],
"quantidadeMovimentacao": 0,
"idInquilino": "string",
"idRetaguarda": "string",
"idProprietario": "string",
"loteOrigem": "string"
}
]

Column

width	50%

Definições dos campos do body

Campo

Tipo

Descrição

Obrigatório

Observações

descricao

string

Descrição do produto

Sim

Tamanho máximo: 200
Estes caracteres especiais: "\r","\n","\"",@"\" são removidos ao inserir no PDV, pois podem ocasionar erro na SEFAZ.

unidadeMedida

string

Unidade de medida do produto

Sim

Tamanho máximo: 20

descontoMaximo

numérico

Desconto máximo aplicado ao produto

Não

tipoArredondaTrunca

int

DEFASADO

Não

codigoProduto

string

Código do produto

Sim

Tamanho máximo: 20

codigoAlternativo

string

Código alternativo do produto

Sim

Tamanho máximo: 40

origemProduto

int

Origem do produto

Sim

0 – Nacional: exceto as indicadas nos códigos 3, 4, 5 e 8;
1 – Estrangeira: importação direta, exceto a indicada no código 6;
2 – Estrangeira: adquirida no mercado interno, exceto a indicada no código 7;
3 – Nacional: mercadoria ou bem com conteúdo de importação superior a 40% e inferior ou igual a 70%;
4 – Nacional: cuja produção tenha sido feita em conformidade com os processos produtivos básicos de que tratam o Decreto-Lei nº 288/1967, e as Leis nº 8.248/1991, 8.387/1991, 10.176/2001 e 11.484/2007;
5 – Nacional: mercadoria ou bem com Conteúdo de Importação inferior ou igual a 40%;
6 – Estrangeira: importação direta, sem similar nacional, constante em lista de Resolução Camex e gás natural;
7 – Estrangeira: adquirida no mercado interno, sem similar nacional, constante em lista de Resolução Camex e gás natural;
8 – Nacional: mercadoria ou bem com Conteúdo de Importação superior a 70%.

situacao

int

Situação do produto

Sim

0 - Inativo, 1 - Ativo

imagem

string

URL com a imagem do produto

Não

Tamanho máximo: 200 caracteres

tipoProduto

int

Tipo do produto

Não

Descrição	Valor
Não definido	0
Consumo	1
Revenda	2
Kit	3
Matéria	4
Produto acabado	5
Serviço	6

fracionado

boolean

Indica se o produto é vendido fracionado

Não

cnpjFornecedor

string

CNPJ do fornecedor do produto

Não

Tamanho máximo: 20 caracteres

escalaRelevante

boolean

Escala relevante

Não

cstIcms

string

DEFASADO

Não

Tamanho máximo: 4 caracteres

percentualReducaoIcms

numérico

Percentual de redução ICMS

Não

aliquotaIcms

numérico

Aliquota ICMS

Não

Pode ser enviado como string para atender ao legado, contudo, caso se enviado algo que não possa ser convertido para inteiro será devolvido um retorno de erro.

vlicmsret

numérico

DEFASADO

Não

cest

string

Cest

Não

Tamanho máximo: 7 caracteres

encomenda

boolean

Indica se o produto é uma encomenda

Não

pesoLiquido

numérico

Peso liquido do produto

Não

pesoBruto

numérico

Peso bruto do produto

Não

associacaoProdutosClassificacao

Lista de objetos

Lista de classificação do produto

Não

associacaoProdutosClassificacao.idRetaguarda

string

Identificador da classificação na retaguarda

Sim

Tamanho máximo: 100 caracteres

associacaoProdutosClassificacao.idRetaguardaProduto

string

Identificador do produto na retaguarda

Sim

Tamanho máximo: 100 caracteres

associacaoProdutosClassificacao.idRetaguardaClassificacaoProduto

string

Identificador da classificação na retaguarda

Sim

Tamanho máximo: 100 caracteres

associacaoProdutosClassificacao.ordem

int

Ordem

Sim

associacaoProdutosClassificacao.situacao

int

Situação da classificação

Sim

0 - Inativo, 1 - Ativo

produtoEmbalagens

lista de objetos

Lista de embalagens do produto

Não

produtoEmbalagens.Codigo

string

Identificação do produto raiz, que ao ser consultado irá apresentar quais itens são sugeridos ao compra-lo

Sim

Tamanho máximo: 200 caracteres

produtoEmbalagens.codigoBarras

string

Código de barras da embalagem

Sim

Tamanho máximo: 20 caracteres

produtoEmbalagens.codigoExterno

String

Identificação dos itens sugeridos para o item consultado

Não

Tamanho máximo: 200 caracteres

produtoEmbalagens.descricao

string

Descrição da embalagem

Sim

Tamanho máximo: 200 caracteres
Estes caracteres especiais: "\r","\n","\"",@"\" são removidos ao inserir no PDV, pois podem ocasionar erro na SEFAZ.

produtoEmbalagens.idProdutoRetaguarda

string

Identificador do produto na retaguarda

Não

Tamanho máximo: 100 caracteres

produtoEmbalagens.idRetaguarda

string

Identificador da embalagem na retaguarda

Sim

Tamanho máximo: 100 caracteres

produtoEmbalagens.pesoBruto

int

Peso bruto da embalagem

Não

produtoEmbalagens.pesoLiquido

int

Peso liquido da embalagem

Não

produtoEmbalagens.quantidade

int

Quantidade de produtos na embalagem

Não

produtoEmbalagens.situacao

int

Situação da embalagem

Sim

0 - Inativo 1 - Ativo

produtoEmbalagens.unidadeMedida

string

Unidade de medida da embalagem

Sim

produtoKits

Lista de objetos

Lista de kits

Não

produtoKits.idRetaguarda

string

Registo único, responsável por identificar o item na tabela de produto_kit.

Sim

Tamanho máximo: 100 caracteres
Registro único, não deve ser enviado mais de uma vez, em caso de criação de itens dentro do kit.
Caso seja enviado mais de uma vez, o mesmo código, o registro será alterado.

produtoKits.idRetaguardaProduto

string

Identificador do produto KIT criado na tabela de produto.

Não

Tamanho máximo: 100 caracteres
Todo kit é um produto, devido a isso sempre haverá um registro descrito como kit na tabela de produto.

produtoKits.idRetaguardaProdutoKit

string

Identificador do item do kit na tabela de produto

Não

Tamanho máximo: 100 caracteres
Referencia os itens da tabela de produto que compõe o kit.

produtoKits.descricao

string

Descrição do produto que compõe o KIT

Sim

Tamanho máximo: 100 caracteres

produtoKits.quantidadeVendaKit

int

Quantidade daquele determinado item dentro do KIT.

Sim

produtoKits.tipoValorKit

int

Tipo valor kit

Sim

Tipo	Valor	Descrição
Não tem desconto	0	O valor da tabela vigente será considerado para o item
Valor fixo	1	O valor do campo novoValorUnitario será o valor do item no KIT
Percentual desconto	2	O valor do campo valorDesconto será aplicado no item percentualmente. Por exemplo: Se o valor da valorDesconto for 10.00, será aplicado 10% de desconto no item

produtoKits.situacao

int

Situação do kit

Sim

0 - Inativo 1 - Ativo

produtoKits.valorDesconto

numérico

Valor percentual que será aplicado de desconto no item da composição do KIT

Não

produtoKits.novoValorUnitario

numérico

Valor real que será aplicado de desconto no item da composição do KIT, desconsiderando o valor da tabela de preço atual

Não

produtosSimilares

Lista de objetos

Lista de produtos similares

Não

produtosSimilares.idRetaguardaProduto

string

Identificador do produto na retaguarda

Sim

Tamanho máximo: 100 caracteres

produtosSimilares.idRetaguardaSimilar

string

Identificador do produto similar na retaguarda

Sim

Tamanho máximo: 100 caracteres

produtosSimilares.situacao

int

Situação do produto similar

Sim

0 - Inativo 1 - Ativo

produtosSugestoes

Lista de objetos

Lista de sugestôes

Não

produtosSugestoes.idRetaguardaProduto

string

Identificador do produto na retaguarda

Sim

produtosSugestoes.idRetaguardaSugestao

string

Identificador da sugestão na retaguarda

Sim

produtosSugestoes.situacao

int

Situação da sugestão

Sim

codigosProduto

Lista de objetos

Lista de códigos do produto

Não

codigosProduto.codigo

string

Código do produto

	Código do produto	Sim	Tamanho máximo: 200 caracteres
codigosProduto.codigoExterno	string	Identificação dos itens sugeridos para o item consultas	Não	Tamanho máximo: 200 caracteres
codigosProduto.descricao	string	Descrição do código	Não	Tamanho máximo: 200 caracteres
codigosProduto.idRetaguarda	string	Identificador do código na retaguarda	Não	Tamanho máximo: 100 caracteres
codigosProduto.

dataAtualizacao

situacao

string

int

Data atualização

Situação do código

codigosProduto.dataCadastro

Sim	0 - Inativo, 1 - Ativo
impostos	Lista de objetos	Lista de impostos do produto	Sim
impostos.idRetaguarda	string

Data cadastro do códigocodigosProduto.situacaointSituação do produto

Identificador do imposto na retaguarda	Sim
impostos.idProprietario	string	Identificador do proprietário	Sim
ncms

impostos

Lista de objetos

Lista de

impostos do produtoimpostos

NCMs	Sim
ncms.idRetaguarda	string	Identificador do

imposto

NCM na retaguarda

impostos

Sim
ncms.idProprietario	string	Identificador do proprietário	Sim

ncms


pisCofins	Lista de objetos	Lista de

NCMs

PisCofins

Sim

ncms


pisCofins.idRetaguarda	string	Identificador do

NCM

PisCofin na retaguarda

ncms

Sim
pisCofins.idProprietario	string	Identificador do proprietário

pisCofins

Sim
fcps	Lista de objetos	Lista de

PisCofinspisCofins.idRetaguardastringIdentificador do PisCofin na retaguardapisCofins.idProprietariostringIdentificador do proprietáriofcpsLista de objetosLista de FCPsfcps.valorBaseFcpstringValor base do FCPfcps.percentualFcpstringPercentual do FCPfcps.codigoBeneficioFiscalstringCódigo de benefício fiscalfcps.motivoDesoneracaoIcmsintMotivo desoneraçãofcps.descontaDesoneracaoNfbooleanDesconto desoneraçaofcps.

FCPs	Não
fcps.valorBaseFcp	string	DEFASADO	Não
fcps.percentualFcp	numérico	Percentual do FCP	Não
fcps.codigoBeneficioFiscal	string	Código de benefício fiscal	Não	Tamanho máximo: 20 caracteres
fcps.motivoDesoneracaoIcms	int	Motivo desoneração	Não
fcps.descontaDesoneracaoNf	boolean	DEFASADO	Não
fcps.idProprietario	string	Identificador do proprietário	Não
quantidadeMovimentacao	numérico	Quanitdade de movimentação	Não
idInquilino	string	Identificador do inquilino	Sim
idRetaguarda	string	Identificador do produto na retaguarda	Sim	Tamanho máximo: 100

Expandir

title	200 - Ok

idProprietario

string

Identificador do proprietário

quantidadeMovimentacaofloatQuanitdade de movimentaçãoidInquilinostringIdentificador do inquilinoXidRetaguardastringIdentificador do produto na retaguarda

X

Tamanho máximo: 100

idProprietariostringIdentificador do proprietárioloteOrigemstringIdentificador do lote que os dados serão enviados Expandir

title	Definição dos campos de retorno

Sim
loteOrigem	string	Identificador do lote que os dados serão enviados	Sim

Retornos

Deck of Cards

id	retornos

Card

label	200 - Ok

Column

width	50%

Exemplo de body de retorno

{
"success": true,
"message": "Requisição inserida com sucesso!",
"data": null,
"errors": null,
"totalTime": 0,
"numberOfRecords": 0
}

Column

width	50%

Definições dos campos do retorno

Campo	Tipo	Descrição
Success	bool	Indica se a criação do compartilhamento foi feita com sucesso
Message	string	Caso ocorra erros durante a criação do compartilhamento eles serão enviados nesse campo
Data	objeto	Objeto compartilhamento criado
Errors	Lista	Listas com os erros encontrados no processo

TotalTime

int

tempo da requisição

NumberOfRecords

int

número de dados inseridos

Expandir

title	Body de retorno

{
"success": true,
"message": "",
"data": null,
"errors": null,
"totalTime": 0,
"numberOfRecords": 0
}

Expandir


TotalTime	int	tempo da requisição
NumberOfRecords	int	número de dados inseridos

Card

label	400 - Bad Request

Column

width	50%

Exemplo de body de retorno

{
"code": "string",
"message": "string",
"detailedMessage": "string",
"helpUrl": "string",
"details": [
{
"guid": "string",
"code": "string",
"message": "string",
"detailedMessage": "string"
}
]
}

Column

width	50%

Definições dos campos do retorno

title400 - Bad Request

Campo
Tipo
Descrição
code string Código de erro
message string Mensagem do erro
detailedMessage string Detalhamento do erro
helpUrl string url de ajuda
TotalTime string Tempo total de busca
details lista de objeto Lista de objeto de erros
details.guid string Identificador do erro
details.code string Código do erro
details.message string Mensagem do erro
details.detailedMessage string Detalhamento do erro

Árvore de páginas

Versões comparadas

Versão antiga 11

Nova versão Atual

Chave

Requisição

Exemplo de body da requisição

Definições dos campos

do body

Retorno

Exemplo de body de retorno

Definições dos campos do retorno

Exemplo de body de retorno

Definições dos campos do retorno

Requisição

Exemplo de body da requisição

Definições dos campos do body

Retornos

Exemplo de body de retorno

Definições dos campos do retorno

Exemplo de body de retorno

Definições dos campos do retorno

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 11

Nova versão Atual

Chave

Requisição

Exemplo de body da requisição

Definições dos campos

do body

Retorno

Exemplo de body de retorno

Definições dos campos do retorno

Exemplo de body de retorno

Definições dos campos do retorno

Requisição

Exemplo de body da requisição

Definições dos campos do body

Retornos

Exemplo de body de retorno

Definições dos campos do retorno

Exemplo de body de retorno

Definições dos campos do retorno