Histórico da Página

...

Totvs custom tabs box

tabs	Dados integrados com Winthor, Envio Parâmetros, Resposta da Requisição, Principais dúvidas e conflitos
ids	passo1,passo2,passo3,passo4

A integração consiste em retornar todos os produtos e suas respectivas tributações como PIS/COFINS, ICMS, ST, FCP, NCM cadastradas nas rotinas 514 e 574.

Totvs custom tabs box items

default	yes
referencia	passo1

Os dados integrados são:

PCPRODUT, PCPRODFILIAL
API	Referência Winthor	Obs
produto.codigo	PCPRODUT.CODPROD
produto.descricao	PCEMBALAGEM.DESCRICAOECF , PCPRODUT.DESCRICAO
produto.embalagem	PCEMBALAGEM.EMBALAGEM , PCPRODUT.EMBALAGEM
produto.codigoDeBarra	PCEMBALAGEM.CODAUXILIAR , PCPRODUT.CODAUXILIAR
produto.classe	PCPRODUT.CLASSE
produto.codigoCest	PCCEST.CODCEST
produto.palete.lastroPalete	PCPRODUT.LASTROPAL
produto.palete.camadaPalete	PCPRODUT.CAMAPAPAL
produto.pesoBruto	PCEMBALAGEM.PESOBRUTO , PCPRODUT.PESOBRUTO
produto.usaWms	PCPRODUT.USAWMS
produto.codigoSecao	PCPRODUT.CODSEC
produto.unidade	PCEMBALAGEM..UNIDADE , PCPRODUT.UNIDADE
produto.revenda	PCPRODUT.REVENDA
produto.codigoMarca	PCPRODUT.CODMARCA
produto.pesoLiquido	PCEMBALAGEM..PESOLIQ , PCPRODUT.PESOLIQ
produto.induzLote	PCPRODUT.INDUZLOTE
produto.dimensao.altura	PCPRODUT.ALTURAARM
produto.dimensao.largura	PCPRODUT.LARGURAARM
produto.dimensao.comprimento	PCPRODUT.COMPRIMENTOARM
produto.filialRetira	PCPRODUT.CODFILIALRETIRA
produto.tipoComissao	PCPRODUT.TIPOCOMISSAO
produto.pesoVariavel	PCPRODUT.PESOVARIAVEL
produto.codigoFornecedor	PCPRODUT.CODFORNEC
produto.prazoMaxValidade	PCPRODUT.PRAZOVAL
produto.controlaSerie	PCPRODUT.CONTROLANUMSERIE
produto.estoquePorLote	PCPRODUT.ESTOQUEPORLOTE
produto.codigoLinhaProduto	PCPRODUT.CODLINHAPROD
produto.tipoProduto	PCPRODUT.TIPOPROD
produto.tipoEstoque	PCPRODUT.TIPOESTOQUE
produto.codigoDepartamento	PCPRODUT.CODEPTO
produto.controladoIbama	PCPRODUT.CONTROLADOIBAMA
produto.imuneTributacao	PCPRODUT.IMUNETRIB
produto.usaFreteEspecial	PCPRODUT.FRETEESPECIAL
produto.prazoMedioVenda	PCPRODUT.PRAZOMEDIOVENDA
produto.quantidadeCaixa	PCPRODUT.QTUNITCX
produto.quantidadeUnitaria	PCEMBALAGEM..QTUNIT , PCPRODUT.QTUNIT
produto.tipoMercadoria	PCPRODUT.TIPOMERC
produto.enderecoApanha.rua	PCPRODUT.RUA
produto.enderecoApanha.modulo	PCPRODUT.MODULO
produto.enderecoApanha.numero	PCPRODUT.NUMERO
produto.enderecoApanha.apto	PCPRODUT.APTO
produto.percentualDiferencaKg	PCPRODUT.PERCDIFERENCAKGFRIO
produto.quantidadeMinimaAtacado	PCPRODUT.QTMINIMAATACADO
produto.descricoes	PCPRODUT.DESCRICAO1, PCPRODUT.DESCRICAO2 PCPRODUT.DESCRICAO3, PCPRODUT.DESCRICAO4, PCPRODUT.DESCRICAO5, PCPRODUT.DESCRICAO6, PCPRODUT.DESCRICAO7
produto.tipoFracaoProduto	NVL(PCPRODFILIAL.ACEITAVENDAFRACAO,PCPRODUT.ACEITAVENDAFRACAO)	O campo "tipoFracaoProduto" informa se o produto será possível vender com fracionamento na quantidade do item no pedido caso o parâmetro de produto "Aceita venda fracionada" esteja igual a "sim"; a API valida primeiramente se para esse produto esta configurado o parâmetro por filial na rotina 238 na campo "Aceita venda fracionada" caso não esteja configurado nessa rotina a API vai verificar a configuração do produto geral na rotina 203 olhando para o mesmo campo "Aceita venda fracionada". – "Aceita venda fracionada" = 'S' "produto.tipoFracaoProduto": "ACEITA_FRACIONAMENTO", – "Aceita venda fracionada" = 'N' ou "Apenas Múltiplo de 1/2 (M) = 'M'" ou "Nenhum = 'ND'" "produto.tipoFracaoProduto": "NAO_ACEITA_FRACIONAMENTO", Campo no Winthor rotina 238 : PCPRODFILIAL.ACEITAVENDAFRACAO Campo no Winthor rotina 203 : PCPRODUT.ACEITAVENDAFRACAO
produto.multiplo	NVL(PCPRODFILIAL.MULTIPLO,PCPRODUT.MULTIPLO)	O campo "multiplo" informa se o produto será possível vender aplicando um fator na quantidade caso o parâmetro de produto "Múltiplo" esteja maior que zero, aplicando esse valor como fator na quantidade; a API valida primeiramente se para esse produto esta configurado o parâmetro por filial na rotina 238 na campo "Múltiplo" caso não esteja configurado nessa rotina a API vai verificar a configuração do produto geral na rotina 203 olhando para o mesmo campo "Múltiplo". – "Múltiplo" > 0 "produto.multiplo": { "valor": multiplo }, – "Múltiplo" = NULL "produto.multiplo": { "valor": 0 }, Campo no Winthor rotina 238 : PCPRODFILIAL.MULTIPLO Campo no Winthor rotina 203 : PCPRODUT.MULTIPLO
produto.classificacaoProduto	PCPRODUT.OBS
produto.pesoBrutoMaster	PCPRODUT.PESOBRUTOMASTER
produto.pesoLiquidoMaster	PCPRODUT.PESOLIQMASTER
produto.custoFornecedor	PCPRODUT.CUSTOFORNEC
produto.custoFornecedorSemSt	PCPRODUT.CUSTOFORNECSEMST
produto.custoProximaCompra	PCPRODUT.CUSTOPROXIMACOMPRA
produto.custoProximaCompraSemSt	PCPRODUT.CUSTOPROXIMACOMPRASEMST
produto.percentualPis	PCPRODUT.PERPIS
produto.percentualCofins	PCPRODUT.PERCOFINS
produto.situacao	PCPRODUT.DTEXCLUSAO	Se DTEXCLUSAO é nula, produto "Inativo", se não nula, produto "Ativo";
produto.origemProd	PCPRODUT.IMPORTADO	Se IMPORTADO é igual a "D", produto "Importado", se diferente de "D", produto "Nacional";
produto.cnpjFornecedor	PCFORNEC.CGC
produto.descontoMaximo	PCMETAPARAMFILIAL	Parâmetro 1463 - % Máximo de desconto Médio nos Orçamentos e Pedidos Venda da rotina 132;
produto.conciliaImportacao	PCPRODUT.CONCILIAIMPORTACAO
produto.dtultalter	PCPRODUT.DTULTALTER
produto.dtcadastro	PCPRODUT.DTCADASTRO
produto.codfilial	PCPRODFILIAL.CODFILIAL
produto.embalagens	PCEMBALAGEM	Retorna as embalagens do produto caso o parâmetro FIL_UTILIZAVENDAPOREMBALAGEM for igual a sim
produto.embalagens.unidade	PCEMBALAGEM.UNIDADE
produto.embalagens.descricao	PCEMBALAGEM.DESCRICAOECF
produto.embalagens.embalagem	PCEMBALAGEM.EMBALAGEM
produto.embalagens.produto	PCEMBALAGEM.CODPROD
produto.embalagens.filial	PCEMBALAGEM.CODFILIAL
produto.embalagens.codigoDeBarra	PCEMBALAGEM.CODAUXILIAR
produto.embalagens.permiteVendaTelemarketing	PCEMBALAGEM.ENVIATELEMARKETING
produto.embalagens.fatorConversao	PCEMBALAGEM.QTUNIT
produto.embalagens.inativo	PCEMBALAGEM.DTINATIVO	Caso DTINATIVO for igual a NULL então FALSE caso contrario TRUE
produto.produtoKits		Retorna os itens do KIT
produto.produtoKits.idRetaguardaProdutoKit	PCFORMPROD.CODPRODMP
produto.produtoKits.idRetaguardaProdutoKit	PCPRECOCESTAI.CODPRODMP
produto.produtoKits.descricao	PCPRODUT.DESCRICAO
produto.produtoKits.quantidadeVendaKit	PCFORMPROD.QTPRODMP
produto.produtoKits.tipoValorKit	CASE WHEN NVL(SUM(PCPRECOCESTAI.PRECOFIXO),0) > 0 THEN 1 ELSE 0 END
produto.produtoKits.situacao	CASE WHEN PCPRECOCESTAC.DTEXCLUSAO IS NULL THEN 1 ELSE 0 END
produto.produtoKits.valorDesconto	Default 0
produto.produtoKits.novoValorUnitario	CASE WHEN NVL(SUM(PCPRECOCESTAI.PRECOFIXO),0) > 0 THEN NVL(SUM(PCPRECOCESTAI.PRECOFIXO),0) ELSE 0 END

Outros campos:

piscofins → APIs Integrações - Tributação PIS COFINS - EM HOMOLOGAÇÃO

icms → APIs Integrações - ICMS/Substituição tributária - EM HOMOLOGAÇÃO

ncm → APIs Integrações - Tributação NCM - EM HOMOLOGAÇÃO

Totvs custom tabs box items

default	no
referencia	passo2

Exemplo do envio da requisição:

Bloco de código

language	js
title	URI

method: 'GET',
url: '/winthor/tributacao/v0/saida/produtotributacao/consultar'

Bloco de código

language	js
title	Params

page	: 1								   		- número da página
pageSize	: 10								- quantidade por página 
dataUltimaAlteracao  : AAAA-MM-DDTHH:MM:SS      - data de ultima alteração
filial:	1										- código da filial
codigoProduto: 1       						    - código do produto
revenda:										- 'true' ou 'false'
tipoMercadoria                                  - Lista de tipos de mercadoria. Ex: &tipoMercadoria=CB&tipoMercadoria=PA

Totvs custom tabs box items

default	no
referencia	passo3

Exemplo JSON da resposta:

Bloco de código

language	js
theme	Eclipse
title	Response

{
    "first": false,
    "items": [
        {
            "produto": {
                "codigo": 1902560,
                "descricao": "TESTENovo kit teste",
                "embalagem": "EMB. TESTEUN",
                "codigoDeBarra": "1",
                "classe": "A"7891132010999",
                "palete": {
                    "lastroPalete": {
                        "valor": 0
                    },
                    "camadaPalete": {
                        "valor": 0
                    },
                    "normaPalete": {
                        "valor": 0
                    }
                },
                "pesoBruto": {
                    "valor": 1
                },
                "usaWms": false,
                "codigoSecao": 1100005,
                "unidade": {
                    "sigla": "CXUN",
                    "descricao": "CaixaUnitário"
                },
                "revenda": true,
                "codigoMarca": 0,
                "pesoLiquido": {},
                    "valorinduzLote": 1
                },
                "induzLote": false,
                "dimensao": {
                    "altura": {
                        "valor": 0
                    },
                    "largura": {
                        "valor": 0
                    },
                    "comprimento": {
                        "valor": 0
                    }
                },
                "filialRetiratipoComissao": {"P",
                    "codigopesoVariavel": "1"true,
                    "razaoSocialcodigoFornecedor": "FILIAL RETIRA"140,
                    "ufprazoMaxValidade": "GO"0,
                    "brokercontrolaSerie": false,
                "estoquePorLote": }false,
                "tipoComissaocodigoLinhaProduto": "P"0,
                "pesoVariaveltipoProduto": false"NORMAL",
                "codigoFornecedortipoEstoque": 1"NEMHUM",
                "prazoMaxValidadecodigoDepartamento": 0100,
                "controlaSeriecontroladoIbama": false,
                "estoquePorLoteimuneTributacao": false,
                "codigoLinhaProdutousaFreteEspecial": 0false,
                "tipoProdutoprazoMedioVenda": "NORMAL"0,
                "tipoEstoquequantidadeCaixa": "PADRAO",
{
                    "codigoDepartamentovalor": 1,
                "controladoIbama": false},
                "imuneTributacaocodigoProdutoPrincipal": false0,
                "usaFreteEspecialquantidadeUnitaria": true,{
                    "prazoMedioVendavalor": 0,1
                "quantidadeCaixa": {
   },
                 "valortipoMercadoria": 1"KIT",
                 },"enderecoApanha": {
                    "codigoProdutoPrincipalrua": 01,
                    "quantidadeUnitariamodulo": {1,
                    "valornumero": 1,
                    }, "apartamento": 1
                "tipoMercadoria": "PRODUTO_ACABADO"},
                "enderecoApanhaquantidadeMinimaAtacado": {
                    "ruavalor": 1,0
                },
     "modulo           "descricoes": 1,[
                    "numero": 1null,
                    null,
   "apartamento": 1
                }null,
                   "percentualDiferencaKg": 0null,
                "quantidadeMinimaAtacado": {    null,
                    "valor": 0
 null,
               },
     null
           "descricoes": [
    ],
                "tipoFracaoProduto"DESCRICAO UM: "NAO_ACEITA_FRACIONAMENTO",
                    "DESCRICAO DOI","multiplo": {
                    "DESCRICAO TRES",valor": 1
                    "DESCRICAO QUATRO"},
                   "classificacaoProduto": "DESCRICAO CINCONORMAL",
                    "DESCRICAO SEIS","pesoBrutoMaster": {
                    "DESCRICAO SETE"valor": 0
                ]},
                "tipoFracaoProdutopesoLiquidoMaster": {
                 "NAO_ACEITA_FRACIONAMENTO"   "valor": 0
                },
                "multiplocustoFornecedor": {0,
                "custoFornecedorSemSt": 0,
      "valor          "custoProximaCompra": 1
     0,
                "custoProximaCompraSemSt": 0,
                "compraConsignado": false,
                "situacao": "Ativo",
                "origemProd": "Nacional",
                "cnpjFornecedor": "09640611000250",
                "codigoCest": "1710101",
                "embalagens": [
                    {
                        "unidade": {
                            "sigla": "UN",
                            "descricao": "Unitário"
                        },
                        "embalagem": "UN",
                        "produto": 902560,
                        "filial": {
                            "codigo": "1",
                            "razaoSocial": "EMP M L COM DE ALIM E BEB LTDA",
                            "uf": "GO",
                            "broker": false
                        },
                        "codigoDeBarra": "7891132010999",
                        "permiteVendaBalcao": false,
                        "permiteVendaTelemarketing": false,
                        "fatorConversao": {
                            "valor": 1
                        },
                        "pesoBruto": {},
                        "inativo": false
                    }
                ],
                "produtoKits": [
                    {
                        "idRetaguardaProduto": 902560,
                        "idRetaguardaProdutoKit": 13,
                        "descricao": "Novo kit teste",
                        "quantidadeVendaKit": 5,
                        "tipoValorKit": 1,
                        "situacao": 1,
                        "valorDesconto": 0,
                        "novoValorUnitario": 1.97,
                        "codigoFilial": "1",
                        "codigoProduto": 902560
           },
         },
       "classificacaoProduto": "NORMAL",
            {
    "pesoBrutoMaster": {
                    "valoridRetaguardaProduto": 0902560,
                },
        "idRetaguardaProdutoKit": 88,
       "pesoLiquidoMaster": {
                "descricao": "Novo kit  "valor": 0teste",
                },
        "quantidadeVendaKit": 10,
       "custoFornecedor": 0,
                "custoFornecedorSemSttipoValorKit": 01,
                "custoProximaCompra": 0,
        "situacao": 1,
       "custoProximaCompraSemSt": 0,
                "compraConsignadovalorDesconto": false0,
                "percentualPis": 0,
         "novoValorUnitario": 1.21,
       "percentualCofins": 0,
                "situacaocodigoFilial": "Ativo1",
                "origemProd        "codigoProduto": "Importado",
902560
                  "cnpjFornecedor": "(CNPJ)",  }
                "descontoMaximo": 99],
                "conciliaImportacao": false,
                "codfilialdtcadastro": "12023-12-05T00:00:00",
                "dtultalter": "frios": false2023-12-06T11:12:29",
                "dtcadastrocodfilial": "2012-01-01T00:00:001",
                "dtultalterfrios": "2022-06-22T00:00:00"false
            },
            "piscofins": [
                {
                    "codTribPisCofins": 1,
                    "cst": "01001",
                    "aliquotaPis": 10.0165,
                    "aliquotaCofins": 10.076,
                    "dtUltAlt": "2022-0610-02T0003T09:0025:0026",
                    "dtCadastro": "2022-06-01T0006T08:00:00"20:06",
                    "codProd": 902560
                }
            ],
            "icms": [
                {
                    "id": 1,
                    "baseCalculo": {
                        "valor": 0
                    },
                    "aliquota": {
                        "valor": 1.0000000
                    },
                    "reducaoBaseCalculo": {
                        "valor": 1.0000000
                    },
                    "dataUltimaAlteracao": "20222023-0112-06T1606T10:4633:3934",
                    "substituicaoTributaria": {
                        "valor": {
                            "valor": 0
                        },
                        "baseCalculo": {
                            "valor": 0
                        },
                        "id": 21,
                        "substituicaoTributaria": {
                            "valor": 0
                        },
                        "baseSubstituicaoTributaria": {
                            "valor": 0
                        },
                        "reducaoBaseCalculo": {
                            "valor": 0
                        },
                        "tipoSubstituicaoTributaria": {
                            "descricao": "SEM ST"
                        },
                        "iva": {
                            "valor": 0
                        },
                        "icmsExterno": {
                            "valor": 1.0000000
                        },
                        "icmsInterno": {
                            "valor": 1.0000000
                        },
                        "pauta": {
                            "valor": 0
                        },
                        "stGnre": false,
                        "baseFecp": {
                            "valor": 0
                        },
                        "aliquotaFecp": {
                            "valor": 0
                        },
                        "valorFecp": {
                            "valor": 0
                        },
                        "dataUltimaAlteracao": "20222023-0112-06T1606T10:4633:3934",
                        "aliquotatipo": {"ST",
                        "aliquota": {
   "valor": 0
                          },"valor": 0
                        "tipo": "ST"}
                    },
                    "fcp": {
                        "id": 1,
                        "valorBaseFcp": {
                            "valor": 0
                        },
                        "percentualFcp": {
                            "valor": 0
                        },
                        "codigoBeneficioFiscal": {
                            "valor": 1.000000
0
                        },
                          "motivoDesoneracaoIcms": {
    },
                        "motivoDesoneracaoIcmsvalor": {0
                        },
    "valor": 1.000000
                        }"descontaDesoneracaoNf": false,
                        "descontaDesoneracaoNftipoTrib": true"",
                        "tipoTribtipo": "FCP",
                        "baseCalculo": {
                            "valor": 0
                        },
                        "aliquota": {
                            "valor": 0
                        },
                        "tiporeducaoBaseCalculo": "FCP",
{
                            "valor": {100.00
                        },
    "valor": 0
                   "valor": {
    },
                        "reducaoBaseCalculovalor": {0
                            "valor": 100.000000}
                    },
    }
                    }"modalidadeVarejo": "0 %",
                    "modalidadeVarejoindiceTributoImpressoraVarejo": "T121700",
                    "indiceTributoImpressoraVarejosimboloVarejo": "FF17",
                    "simboloVarejocst": "T100",
                    "cstcodProd": "010"902560,
                    "tipo": "ICMS",
                    "valor": {
                        "valor": 0
                    }
                }
            ],
            "ncm": [
                {
                    "id": "103043100-03043100.",
                    "codigoNcm": "103043100",
                    "codigoExcecao": 10,
                    "aliquotaNacionalcodigoCest": 1,
                    "aliquotaEstadual": 1"1710101",
                    "codigoCestdataUltimaAtualizacao": "12023-12-06T11:12:29",
                    "dataUltimaAtualizacaodataCadastro": "20222023-0112-06T1605T00:4600:3900",
                    "dataCadastrocodProd": "2000-01-01T00:00:00"902560
                }
            ]
        }
    ],
    "hasNext": false
}

Totvs custom tabs box items

default	no
referencia	passo4

Expandir

title	Apresentou Status Code 404 Not Found ao enviar a requisição

Caso obtenha o conteúdo abaixo ao enviar a requisição, verifique na rotina 812 do WTA se os serviços winthor-tributacao e winthor-produto estão instalados. Caso não esteja, acesse a rotina 801 do WTA e realize a instalação

Bloco de código

language	java

<html>
 
<head>
    <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
    <title>Error 404 Not Found</title>
</head>
 
<body>
    <h2>HTTP ERROR 404</h2>
    <p>Problem accessing /api/branch/v1/. Reason:
        <pre>    Not Found</pre>
    </p>
    <hr><a href="http://eclipse.org/jetty">Powered by Jetty:// 9.3.21.v20170918</a>
    <hr />
 
</body>
 
</html>

Expandir

title	Instalei o serviço e apresentou Status Code 403 Forbidden ao enviar a requisição

Caso apresente 403 Forbidden, verifique se realizou a autenticação antes do envio da requisição.

Bloco de código

language	java

{
    "code": "UNK-ERR",
    "message": "Erro de Requisição",
    "detailedMessage": "The current Subject is not authenticated.  Access denied.",
    "details": []
}

Expandir

title	Instalei o serviço e não está retornando informações

Caso a lista retornada esteja vazia, verifique se os filtros que você informou estão coerentes com os registros de produto cadastrados, e se há vinculo entre produto e filial na

Bloco de código

language	java

{
    "first": false,
    "items": [],
    "hasNext": false
}

...

Páginas filhas

Versões comparadas

Versão antiga 23

Nova versão 24

Chave