Árvore de páginas

Versões comparadas

Chave

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

...

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

Novo valor unitário
Expandir
titleDefinição dos campos de requisição

Campo

Tipo

Descrição

Obrigatório

Observações

descricaostringDescrição do produto
X

Sim

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

Sim


  • Tamanho máximo: 20
descontoMaximo
string
numéricoDesconto máximo aplicado ao produto
arredondaTrunca
Não
tipoArredondaTruncaint
Não
codigoProdutostringCódigo do produto
X

Sim


  • Tamanho máximo:
600
  • 20
codigoAlternativostringCódigo alternativo do produto
X

Sim


  • Tamanho máximo: 40
origemProdutointOrigem do produto
X
Sim0 – 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%.
situacaointSituação do
produto (
produto 

Sim

0 - Inativo, 1 - Ativo

)X

imagemstringURL com a imagem do produtoNãoTamanho máximo: 200 caracteres
tipoProdutointTipo do produto
X
Não
DescriçãoValor
Não definido0
Consumo1
Revenda2
Kit3
Matéria4
Produto acabado5
Serviço6
fracionadobooleanIndica se o produto é vendido fracionadoNão
cnpjFornecedorstringCNPJ do fornecedor do produtoNãoTamanho máximo: 20 caracteres
escalaRelevantebooleanEscala relevanteNão
cstIcmsstring
CST ICMS do produto
DEFASADONãoTamanho máximo: 4 caracteres
percentualReducaoIcms
string
numéricoPercentual de redução ICMSNão
aliquotaIcms
string
numéricoAliquota ICMSNãoPode 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.
vlicmsretstring
DEFASADONãoTamanho máximo: 7 caracteres
vlicmsret
ceststringCestNão
encomendabooleanIndica se o produto é uma encomendaNão
pesoLiquido
float
numéricoPeso liquido do produtoNão
pesoBruto
float
numéricoPeso bruto do produtoNão
associacaoProdutosClassificacaoLista de objetosLista de classificação do produtoNão
associacaoProdutosClassificacao.idRetaguardastringIdentificador da classificação na retaguardaSimTamanho máximo: 100 caracteres
associacaoProdutosClassificacao.idRetaguardaProdutostringIdentificador do produto na retaguardaSim
associacaoProdutosClassificacao.idRetaguardaClassificacaoProdutostringIdentificador da classificação na retaguardaSim
associacaoProdutosClassificacao.
ordemOpcional
ordemintOrdem
opcional
Sim
associacaoProdutosClassificacao.situacaointSituação da classificaçãoSim
produtoEmbalagenslista de objetos

Lista de embalagens do produto

Não
produtoEmbalagens.codigoBarrasstringCódigo de barras da embalagemSimTamanho máximo: 20 caracteres
produtoEmbalagens.descricaostringDescrição da embalagemNã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.idProdutoRetaguardastringIdentificador do produto na retaguardaSimTamanho máximo: 100 caracteres
produtoEmbalagens.idRetaguardastringIdentificador da embalagem na retaguardaSimTamanho máximo: 100 caracteres
produtoEmbalagens.pesoBruto
float
intPeso bruto da embalagemNão
produtoEmbalagens.pesoLiquido
float
intPeso liquido da embalagemNão
produtoEmbalagens.quantidadeintQuantidade de produtos na embalagemNão
produtoEmbalagens.situacaointSituação da embalagemSim0 - Inativo 1 - Ativo
produtoEmbalagens.unidadeMedidastringUnidade de medida da embalagemSim
produtoKitsLista de objetosLista de kitsNão
produtoKits.idRetaguardastringRegisto ú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.idRetaguardaProdutostringIdentificador do produto
na retaguarda
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.idRetaguardaProdutoKitstringIdentificador do item do kit na
retaguarda
tabela de produtoNão
  • Referencia os itens da tabela de produto que compõe o kit.
produtoKits.descricaostringDescrição do
kit
produto que compõe o KITSimTamanho máximo: 100 caracteres
produtoKits.quantidadeVendaKitint

Quantidade

de venda do kit 

daquele determinado item dentro do KIT.

Sim
produtoKits.tipoValorKitintTipo valor kitSim
TipoValorDescrição
Não tem desconto0O valor da tabela vigente será considerado para o item
Valor fixo1O valor do campo novoValorUnitario será o valor do item no KIT
Percentual desconto2O 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.situacaointSituação do kitSim0 - Inativo 1 - Ativo
produtoKits.valorDesconto
string
numéricoValor percentual que será aplicado de desconto no item da composição do KITNão
produtoKits.novoValorUnitario
string
numéricoValor real que será aplicado de desconto no item da composição do KIT, desconsiderando o valor da tabela de preço atualNão
produtosSimilaresLista de objetosLista de produtos similaresNão
produtosSimilares.idRetaguardaProdutostringIdentificador do produto na retaguardaSimTamanho máximo: 100 caracteres
produtosSimilares.idRetaguardaSimilarstringIdentificador do produto similar na retaguardaSimTamanho máximo: 100 caracteres
produtosSimilares.situacaointSituação do produto similarSim0 - Inativo 1 - Ativo
produtosSugestoesLista de objetosLista de sugestôesNão
produtosSugestoes.idRetaguardaProdutostringIdentificador do produto na retaguardaSim
produtosSugestoes.idRetaguardaSugestaostringIdentificador da sugestão na retaguardaSim
produtosSugestoes.situacaointSituação da sugestãoSim
codigosProdutoLista de objetosLista de códigos do produtoNão
codigosProduto.codigostringCódigo do produtoNão
codigosProduto.descricaostringDescrição do códigoNão
codigosProduto.idRetaguardastringIdentificador do código na retaguardaNão
codigosProduto.dataAtualizacaostringData atualização do códigoNão
codigosProduto.dataCadastrostringData cadastro do códigoNão
codigosProduto.situacaointSituação do produtoNão
impostosLista de objetosLista de impostos do produtoSim
impostos.idRetaguardastringIdentificador do imposto na retaguardaSim
impostos.idProprietariostringIdentificador do proprietárioSim
ncmsLista de objetosLista de NCMsSim
ncms.idRetaguardastringIdentificador do NCM na retaguardaSim
ncms.idProprietariostringIdentificador do proprietárioSim
pisCofinsLista de objetosLista de PisCofinsSim
pisCofins.idRetaguardastringIdentificador do PisCofin na retaguardaSim
pisCofins.idProprietariostringIdentificador do proprietárioSim
fcpsLista de objetosLista de FCPsNão
fcps.valorBaseFcpstring
Valor base do FCP
DEFASADONão
fcps.percentualFcp
string
numéricoPercentual do FCPNão
fcps.codigoBeneficioFiscalstringCódigo de benefício fiscalNãoTamanho máximo: 20 caracteres
fcps.motivoDesoneracaoIcmsintMotivo desoneraçãoNão
fcps.descontaDesoneracaoNfbooleanDEFASADO
Desconto desoneraçao
Não
fcps.idProprietariostringIdentificador do proprietárioNão
quantidadeMovimentacao
float
numéricoQuanitdade de movimentaçãoNão
idInquilinostringIdentificador do inquilino
X
Sim
idRetaguardastringIdentificador do produto na retaguarda
X

Sim


  • Tamanho máximo: 100
idProprietariostringIdentificador do proprietárioSim
loteOrigemstringIdentificador do lote que os dados serão enviadosSim
Expandir
titleDefinição dos campos de retorno
Expandir
title200 - Ok

Campo

Tipo

Descrição

SuccessboolIndica se a criação do compartilhamento foi feita com sucesso
MessagestringCaso ocorra erros durante a criação do compartilhamento eles serão enviados nesse campo
DataobjetoObjeto compartilhamento criado
ErrorsListaListas com os erros encontrados no processo
TotalTimeinttempo da requisição
NumberOfRecordsintnúmero de dados inseridos
Expandir
titleBody de retorno

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

Expandir
title400 - Bad Request

Campo

Tipo

Descrição

codestringCódigo de erro
messagestringMensagem do erro
detailedMessagestringDetalhamento do erro
helpUrlstringurl de ajuda
TotalTimestringTempo total de busca
detailslista de objetoLista de objeto de erros
details.guidstringIdentificador do erro
details.codestringCódigo do erro
details.messagestringMensagem do erro 
details.detailedMessagestringDetalhamento do erro