Histórico da Página

Objetivo

Este documento tem como objetivo explicar o funcionamento da api de consulta de produtos e suas respectivas tributações, como PIS/COFINS, ICMS, ST, FCP, NCM.

Pré-Requisitos e Restrições

Necessário instalar os serviços winthor-tributaçãoe winthor-produto na rotina 801 do WTA, conforme indicação Parametrizações WTA.

Integração

Ao utilizar a parametrização por UF, a API realizará o filtro considerando as datas de última alteração das tabelas PCCEST, PCNCM e PCTABTRIB. Caso utilize por região, considera-se PCCEST, PCNCM, PCTRIBUT e PCTABPR.
Em caso de usar tributação por região, a região usada para retornar os impostos será definido com o seguinte critério:
Caso o parâmetro 2617-NUMREGIAOPADRAOVAREJO estiver preenchido, será usado para definir a região;
Caso contrário será usado o parâmetro 1633-FIL_NUMREGIAOPADRAO se o mesmo estiver preenchido;
Caso nenhum dos parâmetros acima estiverem preenchidos será usado o parâmetro 1279-CON_NUMREGIAOPADRAO
No produto tipo CESTA, se trabalhar com venda por embalagem (FIL_UTILIZAVENDAPOREMBALAGEM = 'S'), será validada a existência do código de barras do produto no cadastro de embalagem, como embalagens ativas na PCEMBALAGEM no campo PCEMBALAGEM.CODAUXILIAR.
No produto com KIT, se trabalhar com venda por embalagem (FIL_UTILIZAVENDAPOREMBALAGEM = 'S'), será validada a existência do código de barras dos itens do kit (PCPRECOCESTAI.CODAUXILIARMP) como embalagens ativas na PCEMBALAGEM no campo PCEMBALAGEM.CODAUXILIAR.
Para que o produto KIT retorne na API, é necessária correta configuração das informações de impostos relacionados a ICMS, NCM e PIS/CONFIS.
Para que a integração de um kit seja realizada, OBRIGATORIAMENTE os itens do kit deverão ser integrados antes do envio do kit.

É importante verificar se as regiões informados nos parâmetros acimas correspondem a filial do parâmetro

Integração

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 PCPRODFILIAL.ORIGMERCTRIB (A partir das versões abaixo) winthor-produto: Master: 0.34.0.2 Release: 0.35.2.3 Develop: 0.36.0.2 winthor-tributação: Master: 0.34.0.7 Release: 0.35.2.8 Develop: 0.36.0.2	Se IMPORTADO é igual a "D", produto "Importado", se diferente de "D", produto "Nacional"; Será gerado no campo, os respectivos valores cadastrados na rotina 238
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 item normal:

Bloco de código

language	js
theme	Eclipse
title	Response

{
    "first": false,
    "items": [
        {
            "produto": {
                "codigo": 13,
                "descricao": "PROD TESTE OMNI - VAREJO  13",
                "embalagem": "UN",
                "codigoDeBarra": "303",
                "classe": "C",
                "palete": {
                    "lastroPalete": {
                        "valor": 0
                    },
                    "camadaPalete": {
                        "valor": 0
                    },
                    "normaPalete": {
                        "valor": 0
                    }
                },
                "pesoBruto": {
                    "valor": 10
                },
                "usaWms": false,
                "codigoSecao": 100006,
                "unidade": {
                    "sigla": "UN",
                    "descricao": "Unitário"
                },
                "revenda": true,
                "codigoMarca": 0,
                "pesoLiquido": {
                    "valor": 8
                },
                "induzLote": false,
                "dimensao": {
                    "altura": {
                        "valor": 0
                    },
                    "largura": {
                        "valor": 0
                    },
                    "comprimento": {
                        "valor": 0
                    }
                },
                "tipoComissao": "P",
                "pesoVariavel": true,
                "codigoFornecedor": 140,
                "prazoMaxValidade": 0,
                "controlaSerie": false,
                "estoquePorLote": false,
                "codigoLinhaProduto": 0,
                "tipoProduto": "NORMAL",
                "tipoEstoque": "PADRAO",
                "codigoDepartamento": 100,
                "controladoIbama": false,
                "imuneTributacao": false,
                "usaFreteEspecial": true,
                "prazoMedioVenda": 0,
                "quantidadeCaixa": {
                    "valor": 1
                },
                "codigoProdutoPrincipal": 0,
                "codigoDeBarraAuxiliar": "1303",
                "quantidadeUnitaria": {
                    "valor": 1
                },
                "tipoMercadoria": "LIBERADO",
                "enderecoApanha": {
                    "rua": 1,
                    "modulo": 1,
                    "numero": 1,
                    "apartamento": 1
                },
                "quantidadeMinimaAtacado": {
                    "valor": 0
                },
                "descricoes": [
                    "DESCRICAO1 - 13",
                    "DESCRICAO2 - 13",
                    "DESCRICAO3 - 13",
                    "DESCRICAO4 - 13",
                    "DESCRICAO5 - 13",
                    "DESCRICAO6 - 13",
                    "DESCRICAO7 - 13"
                ],
                "tipoFracaoProduto": "NAO_ACEITA_FRACIONAMENTO",
                "multiplo": {
                    "valor": 1
                },
                "classificacaoProduto": "NORMAL",
                "pesoBrutoMaster": {
                    "valor": 0
                },
                "pesoLiquidoMaster": {
                    "valor": 0
                },
                "custoFornecedor": 0,
                "custoFornecedorSemSt": 0,
                "custoProximaCompra": 0,
                "custoProximaCompraSemSt": 0,
                "compraConsignado": false,
                "percentualPis": 0,
                "percentualCofins": 0,
                "situacao": "Ativo",
                "origemProd": "Nacional",
                "cnpjFornecedor": "09640611000250",
                "codigoCest": "1710101",
                "embalagens": [
                    {
                        "unidade": {
                            "sigla": "UN",
                            "descricao": "Unitário"
                        },
                        "descricao": "CAIXA DE FRANGO EMBAL 303",
                        "embalagem": "EMB 303",
                        "produto": 13,
                        "filial": {
                            "codigo": "1",
                            "razaoSocial": "EMP M L COM DE ALIM E BEB LTDA",
                            "uf": "GO",
                            "broker": false
                        },
                        "codigoDeBarra": "303",
                        "permiteVendaBalcao": false,
                        "permiteVendaTelemarketing": false,
                        "quantidadeMinimaAtacado": 2,
                        "fatorConversao": {
                            "valor": 1
                        },
                        "pesoBruto": {},
                        "inativo": false
                    },
                    {
                        "unidade": {
                            "sigla": "UN",
                            "descricao": "Unitário"
                        },
                        "descricao": "CAIXA DE FRANGO EMBAL 304",
                        "embalagem": "EMB 304",
                        "produto": 13,
                        "filial": {
                            "codigo": "1",
                            "razaoSocial": "EMP M L COM DE ALIM E BEB LTDA",
                            "uf": "GO",
                            "broker": false
                        },
                        "codigoDeBarra": "304",
                        "permiteVendaBalcao": false,
                        "permiteVendaTelemarketing": false,
                        "quantidadeMinimaAtacado": 2,
                        "fatorConversao": {
                            "valor": 1
                        },
                        "pesoBruto": {},
                        "inativo": false
                    }
                ],
                "conciliaImportacao": false,
                "dtcadastro": "2017-01-03T00:00:00",
                "dtultalter": "2023-12-06T14:54:10",
                "codfilial": "1",
                "frios": false
            },
            "piscofins": [
                {
                    "codTribPisCofins": 1,
                    "cst": "01",
                    "aliquotaPis": 0.0165,
                    "aliquotaCofins": 0.076,
                    "dtUltAlt": "2022-10-03T09:25:26",
                    "dtCadastro": "2022-06-06T08:20:06",
                    "codProd": 13
                }
            ],
            "icms": [
                {
                    "id": 1,
                    "baseCalculo": {
                        "valor": 0
                    },
                    "aliquota": {
                        "valor": 0
                    },
                    "reducaoBaseCalculo": {
                        "valor": 0
                    },
                    "dataUltimaAlteracao": "2023-12-06T14:54:10",
                    "substituicaoTributaria": {
                        "valor": {
                            "valor": 0
                        },
                        "baseCalculo": {
                            "valor": 0
                        },
                        "id": 1,
                        "substituicaoTributaria": {
                            "valor": 0
                        },
                        "baseSubstituicaoTributaria": {
                            "valor": 0
                        },
                        "reducaoBaseCalculo": {
                            "valor": 0
                        },
                        "tipoSubstituicaoTributaria": {
                            "descricao": "SEM ST"
                        },
                        "iva": {
                            "valor": 0
                        },
                        "icmsExterno": {
                            "valor": 0
                        },
                        "icmsInterno": {
                            "valor": 0
                        },
                        "pauta": {
                            "valor": 0
                        },
                        "stGnre": false,
                        "baseFecp": {
                            "valor": 0
                        },
                        "aliquotaFecp": {
                            "valor": 0
                        },
                        "valorFecp": {
                            "valor": 0
                        },
                        "dataUltimaAlteracao": "2023-12-06T14:54:10",
                        "tipo": "ST",
                        "aliquota": {
                            "valor": 0
                        }
                    },
                    "fcp": {
                        "id": 1,
                        "valorBaseFcp": {
                            "valor": 0
                        },
                        "percentualFcp": {
                            "valor": 0
                        },
                        "codigoBeneficioFiscal": {
                            "valor": 0
                        },
                        "motivoDesoneracaoIcms": {
                            "valor": 0
                        },
                        "descontaDesoneracaoNf": false,
                        "tipoTrib": "",
                        "tipo": "FCP",
                        "baseCalculo": {
                            "valor": 0
                        },
                        "aliquota": {
                            "valor": 0
                        },
                        "reducaoBaseCalculo": {
                            "valor": 100.00
                        },
                        "valor": {
                            "valor": 0
                        }
                    },
                    "modalidadeVarejo": "0 %",
                    "indiceTributoImpressoraVarejo": "1700",
                    "simboloVarejo": "17",
                    "cst": "00",
                    "codProd": 13,
                    "tipo": "ICMS",
                    "valor": {
                        "valor": 0
                    }
                }
            ],
            "ncm": [
                {
                    "id": "03043100-03043100.",
                    "codigoNcm": "03043100",
                    "codigoExcecao": 0,
                    "codigoCest": "1710101",
                    "dataUltimaAtualizacao": "2023-11-22T18:36:53",
                    "dataCadastro": "2017-01-03T00:00:00",
                    "codProd": 13
                }
            ]
        }
    ],
    "hasNext": false
}

Exemplo JSON da resposta CESTA:

Bloco de código

language	js
theme	Eclipse
title	Response

{
    "first": false,
    "items": [
        {
            "produto": {
                "codigo": 902559,
                "descricao": "Cesta teste 13 e 88",
                "embalagem": "CB",
                "codigoDeBarra": "7891132010387",
                "palete": {
                    "lastroPalete": {
                        "valor": 0
                    },
                    "camadaPalete": {
                        "valor": 0
                    },
                    "normaPalete": {
                        "valor": 0
                    }
                },
                "pesoBruto": {
                    "valor": 20
                },
                "usaWms": false,
                "codigoSecao": 100006,
                "unidade": {
                    "sigla": "UN",
                    "descricao": "Unitário"
                },
                "revenda": true,
                "codigoMarca": 0,
                "pesoLiquido": {
                    "valor": 16
                },
                "induzLote": false,
                "dimensao": {
                    "altura": {
                        "valor": 0
                    },
                    "largura": {
                        "valor": 0
                    },
                    "comprimento": {
                        "valor": 0
                    }
                },
                "tipoComissao": "P",
                "pesoVariavel": true,
                "codigoFornecedor": 140,
                "prazoMaxValidade": 0,
                "controlaSerie": false,
                "estoquePorLote": false,
                "codigoLinhaProduto": 0,
                "tipoProduto": "NORMAL",
                "tipoEstoque": "PADRAO",
                "codigoDepartamento": 100,
                "controladoIbama": false,
                "imuneTributacao": false,
                "usaFreteEspecial": false,
                "prazoMedioVenda": 0,
                "quantidadeCaixa": {
                    "valor": 1
                },
                "codigoProdutoPrincipal": 0,
                "codigoDeBarraAuxiliar": "17891132010387",
                "quantidadeUnitaria": {
                    "valor": 2
                },
                "tipoMercadoria": "CESTA_BASICA",
                "enderecoApanha": {
                    "rua": 1,
                    "modulo": 1,
                    "numero": 1,
                    "apartamento": 1
                },
                "quantidadeMinimaAtacado": {
                    "valor": 0
                },
                "descricoes": [
                    null,
                    null,
                    null,
                    null,
                    null,
                    null,
                    null
                ],
                "tipoFracaoProduto": "NAO_ACEITA_FRACIONAMENTO",
                "multiplo": {
                    "valor": 1
                },
                "classificacaoProduto": "NORMAL",
                "pesoBrutoMaster": {
                    "valor": 0
                },
                "pesoLiquidoMaster": {
                    "valor": 0
                },
                "custoFornecedor": 0,
                "custoFornecedorSemSt": 0,
                "custoProximaCompra": 0,
                "custoProximaCompraSemSt": 0,
                "compraConsignado": false,
                "percentualPis": 0,
                "percentualCofins": 0,
                "situacao": "Ativo",
                "origemProd": "Nacional",
                "cnpjFornecedor": "09640611000250",
                "codigoCest": "1710101",
                "embalagens": [
                    {
                        "unidade": {
                            "sigla": "UN",
                            "descricao": "Unitário"
                        },
                        "descricao": "Cesta teste 13 e 88 - 7891132010387",
                        "embalagem": "CB",
                        "produto": 902559,
                        "filial": {
                            "codigo": "1",
                            "razaoSocial": "EMP M L COM DE ALIM E BEB LTDA",
                            "uf": "GO",
                            "broker": false
                        },
                        "codigoDeBarra": "7891132010387",
                        "permiteVendaBalcao": false,
                        "permiteVendaTelemarketing": false,
                        "quantidadeMinimaAtacado": 0,
                        "fatorConversao": {
                            "valor": 1
                        },
                        "pesoBruto": {},
                        "inativo": false
                    }
                ],
                "produtoKits": [],
                "conciliaImportacao": false,
                "dtcadastro": "2023-11-23T00:00:00",
                "dtultalter": "2023-12-06T15:23:42",
                "codfilial": "1",
                "frios": false
            },
            "piscofins": [
                {
                    "codTribPisCofins": 1,
                    "cst": "01",
                    "aliquotaPis": 0.0165,
                    "aliquotaCofins": 0.076,
                    "dtUltAlt": "2022-10-03T09:25:26",
                    "dtCadastro": "2022-06-06T08:20:06",
                    "codProd": 902559
                }
            ],
            "icms": [
                {
                    "id": 1,
                    "baseCalculo": {
                        "valor": 0
                    },
                    "aliquota": {
                        "valor": 0
                    },
                    "reducaoBaseCalculo": {
                        "valor": 0
                    },
                    "dataUltimaAlteracao": "2023-12-06T15:23:42",
                    "substituicaoTributaria": {
                        "valor": {
                            "valor": 0
                        },
                        "baseCalculo": {
                            "valor": 0
                        },
                        "id": 1,
                        "substituicaoTributaria": {
                            "valor": 0
                        },
                        "baseSubstituicaoTributaria": {
                            "valor": 0
                        },
                        "reducaoBaseCalculo": {
                            "valor": 0
                        },
                        "tipoSubstituicaoTributaria": {
                            "descricao": "SEM ST"
                        },
                        "iva": {
                            "valor": 0
                        },
                        "icmsExterno": {
                            "valor": 0
                        },
                        "icmsInterno": {
                            "valor": 0
                        },
                        "pauta": {
                            "valor": 0
                        },
                        "stGnre": false,
                        "baseFecp": {
                            "valor": 0
                        },
                        "aliquotaFecp": {
                            "valor": 0
                        },
                        "valorFecp": {
                            "valor": 0
                        },
                        "dataUltimaAlteracao": "2023-12-06T15:23:42",
                        "tipo": "ST",
                        "aliquota": {
                            "valor": 0
                        }
                    },
                    "fcp": {
                        "id": 1,
                        "valorBaseFcp": {
                            "valor": 0
                        },
                        "percentualFcp": {
                            "valor": 0
                        },
                        "codigoBeneficioFiscal": {
                            "valor": 0
                        },
                        "motivoDesoneracaoIcms": {
                            "valor": 0
                        },
                        "descontaDesoneracaoNf": false,
                        "tipoTrib": "",
                        "tipo": "FCP",
                        "baseCalculo": {
                            "valor": 0
                        },
                        "aliquota": {
                            "valor": 0
                        },
                        "reducaoBaseCalculo": {
                            "valor": 100.00
                        },
                        "valor": {
                            "valor": 0
                        }
                    },
                    "modalidadeVarejo": "0 %",
                    "indiceTributoImpressoraVarejo": "1700",
                    "simboloVarejo": "17",
                    "cst": "00",
                    "codProd": 902559,
                    "tipo": "ICMS",
                    "valor": {
                        "valor": 0
                    }
                }
            ],
            "ncm": [
                {
                    "id": "03043100-03043100.",
                    "codigoNcm": "03043100",
                    "codigoExcecao": 0,
                    "codigoCest": "1710101",
                    "dataUltimaAtualizacao": "2023-12-05T17:33:08",
                    "dataCadastro": "2023-11-23T00:00:00",
                    "codProd": 902559
                }
            ]
        }
    ],
    "hasNext": false
}

Exemplo JSON da resposta KIT:

Bloco de código

language	js
theme	Eclipse
title	Response

{
    "first": false,
    "items": [
        {
            "produto": {
                "codigo": 902560,
                "descricao": "Novo kit teste",
                "embalagem": "UN",
                "codigoDeBarra": "7891132010999",
                "palete": {
                    "lastroPalete": {
                        "valor": 0
                    },
                    "camadaPalete": {
                        "valor": 0
                    },
                    "normaPalete": {
                        "valor": 0
                    }
                },
                "pesoBruto": {},
                "usaWms": false,
                "codigoSecao": 100005,
                "unidade": {
                    "sigla": "UN",
                    "descricao": "Unitário"
                },
                "revenda": true,
                "codigoMarca": 0,
                "pesoLiquido": {},
                "induzLote": false,
                "dimensao": {
                    "altura": {
                        "valor": 0
                    },
                    "largura": {
                        "valor": 0
                    },
                    "comprimento": {
                        "valor": 0
                    }
                },
                "tipoComissao": "P",
                "pesoVariavel": true,
                "codigoFornecedor": 140,
                "prazoMaxValidade": 0,
                "controlaSerie": false,
                "estoquePorLote": false,
                "codigoLinhaProduto": 0,
                "tipoProduto": "NORMAL",
                "tipoEstoque": "NEMHUM",
                "codigoDepartamento": 100,
                "controladoIbama": false,
                "imuneTributacao": false,
                "usaFreteEspecial": false,
                "prazoMedioVenda": 0,
                "quantidadeCaixa": {
                    "valor": 1
                },
                "codigoProdutoPrincipal": 0,
                "quantidadeUnitaria": {
                    "valor": 1
                },
                "tipoMercadoria": "KIT",
                "enderecoApanha": {
                    "rua": 1,
                    "modulo": 1,
                    "numero": 1,
                    "apartamento": 1
                },
                "quantidadeMinimaAtacado": {
                    "valor": 0
                },
                "descricoes": [
                    null,
                    null,
                    null,
                    null,
                    null,
                    null,
                    null
                ],
                "tipoFracaoProduto": "NAO_ACEITA_FRACIONAMENTO",
                "multiplo": {
                    "valor": 1
                },
                "classificacaoProduto": "NORMAL",
                "pesoBrutoMaster": {
                    "valor": 0
                },
                "pesoLiquidoMaster": {
                    "valor": 0
                },
                "custoFornecedor": 0,
                "custoFornecedorSemSt": 0,
                "custoProximaCompra": 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
                    },
                    {
                        "idRetaguardaProduto": 902560,
                        "idRetaguardaProdutoKit": 88,
                        "descricao": "Novo kit teste",
                        "quantidadeVendaKit": 10,
                        "tipoValorKit": 1,
                        "situacao": 1,
                        "valorDesconto": 0,
                        "novoValorUnitario": 1.21,
                        "codigoFilial": "1",
                        "codigoProduto": 902560
                    }
                ],
                "conciliaImportacao": false,
                "dtcadastro": "2023-12-05T00:00:00",
                "dtultalter": "2023-12-06T11:12:29",
                "codfilial": "1",
                "frios": false
            },
            "piscofins": [
                {
                    "codTribPisCofins": 1,
                    "cst": "01",
                    "aliquotaPis": 0.0165,
                    "aliquotaCofins": 0.076,
                    "dtUltAlt": "2022-10-03T09:25:26",
                    "dtCadastro": "2022-06-06T08:20:06",
                    "codProd": 902560
                }
            ],
            "icms": [
                {
                    "id": 1,
                    "baseCalculo": {
                        "valor": 0
                    },
                    "aliquota": {
                        "valor": 0
                    },
                    "reducaoBaseCalculo": {
                        "valor": 0
                    },
                    "dataUltimaAlteracao": "2023-12-06T10:33:34",
                    "substituicaoTributaria": {
                        "valor": {
                            "valor": 0
                        },
                        "baseCalculo": {
                            "valor": 0
                        },
                        "id": 1,
                        "substituicaoTributaria": {
                            "valor": 0
                        },
                        "baseSubstituicaoTributaria": {
                            "valor": 0
                        },
                        "reducaoBaseCalculo": {
                            "valor": 0
                        },
                        "tipoSubstituicaoTributaria": {
                            "descricao": "SEM ST"
                        },
                        "iva": {
                            "valor": 0
                        },
                        "icmsExterno": {
                            "valor": 0
                        },
                        "icmsInterno": {
                            "valor": 0
                        },
                        "pauta": {
                            "valor": 0
                        },
                        "stGnre": false,
                        "baseFecp": {
                            "valor": 0
                        },
                        "aliquotaFecp": {
                            "valor": 0
                        },
                        "valorFecp": {
                            "valor": 0
                        },
                        "dataUltimaAlteracao": "2023-12-06T10:33:34",
                        "tipo": "ST",
                        "aliquota": {
                            "valor": 0
                        }
                    },
                    "fcp": {
                        "id": 1,
                        "valorBaseFcp": {
                            "valor": 0
                        },
                        "percentualFcp": {
                            "valor": 0
                        },
                        "codigoBeneficioFiscal": {
                            "valor": 0
                        },
                        "motivoDesoneracaoIcms": {
                            "valor": 0
                        },
                        "descontaDesoneracaoNf": false,
                        "tipoTrib": "",
                        "tipo": "FCP",
                        "baseCalculo": {
                            "valor": 0
                        },
                        "aliquota": {
                            "valor": 0
                        },
                        "reducaoBaseCalculo": {
                            "valor": 100.00
                        },
                        "valor": {
                            "valor": 0
                        }
                    },
                    "modalidadeVarejo": "0 %",
                    "indiceTributoImpressoraVarejo": "1700",
                    "simboloVarejo": "17",
                    "cst": "00",
                    "codProd": 902560,
                    "tipo": "ICMS",
                    "valor": {
                        "valor": 0
                    }
                }
            ],
            "ncm": [
                {
                    "id": "03043100-03043100.",
                    "codigoNcm": "03043100",

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 produtor e suas respectivas tributações como PIS/COFINS, ICMS, ST, FCP, NCM cadastradas na rotina 514

Os dados integrados são:

Exemplo do envio da requisição:

Totvs custom tabs box items

default	yes
referencia	passo1

PCPRODUT, PCPRODFILIAL

API

Referência Winthor

Obs

produto.icodigo

PCPRODUT.

produto.descricao

PCTRIBUT.PCPRODUT.

produto.embalagem

PCTRIBUT.PERCBASERED

produto.codigoDeBarra

PCTABTRIB.DTULTALTER

produto.classe

PCTRIBUT.CODST

produto.palete

PCTRIBUT.PERCBASEREDST

produto.pesoBruto

PCTRIBUT.ALIQICMS1

produto.usaWms

PCTRIBUT.ALIQICMS2

produto.codigoSecao

PCTABTRIB.DTULTALTER

produto.unidade

Caso a alíquota ICMS (PCTRIBUT.CODICM) for maior que zero: T + CODICM. Caso contrário: N00

produto.revenda

PCTRIBUT.CODECF

produto.codigoMarca

Caso a alíquota ICMS (PCTRIBUT.CODICM) for maior que zero: T1 Caso contrário: N0

produto.pesoLiquido

produto.induzLote

produto.dimensao

produto.filialRetira

produto.tipoComissao

produto.pesoVariavel

produto.codigoFornecedor

produto.prazoMaxValidade

produto.controlaSerie

produto.estoquePorLote

produto.codigoLinhaProduto

produto.tipoProduto

produto.tipoEstoque

produto.codigoDepartamento

produto.controladoIbama

produto.imuneTributacao

produto.usaFreteEspecial

produto.prazoMedioVenda

produto.quantidadeCaixa

produto.codigoProdutoPrincipal

produto.quantidadeUnitaria

produto.tipoMercadoria

produto.enderecoApanha

produto.percentualDiferencaKg

produto.quantidadeMinimaAtacado

produto.descricoes

produto.tipoFracaoProduto

produto.multiplo

produto.classificacaoProduto

produto.pesoBrutoMaster

produto.pesoLiquidoMaster

produto.custoFornecedor

produto.custoFornecedorSemSt

produto.custoProximaCompra

produto.custoProximaCompraSemSt

produto.compraConsignado

produto.percentualPis

produto.percentualCofins

produto.situacao

produto.origemProd

produto.cnpjFornecedor

produto.descontoMaximo

produto.conciliaImportacao

produto.frios

produto.dtultalter

produto.dtcadastro

produto.codfilial

Totvs custom tabs box items

default	no
referencia	passo2

Bloco de código

language	js
title	URI

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

Bloco de código

language	js
title	Params

pagina	: 1								   		- número da página
tamanho	: 10								    - quantidade por página 
dataUltimaAlteracao  : AAAA-MM-DDTHH:MM:SS      - data de ultima alteração
codigoProduto:       						    - ICMS/ST por produto

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": [
        {
            "idcodigoExcecao": 250,
                    "aliquotacodigoCest": 10.00"1710101",
                    "reducaoBaseCalculodataUltimaAtualizacao": 0"2023-12-06T11:12:29",
            "dataUltimaAlteracao        "dataCadastro": "20172023-12-06T1105T00:1800:5100",
            "substituicaoTributaria": {
                "idcodProd": 25,902560
                "reducaoBaseCalculo": 0,
}
            ]
     "icmsExterno": 0,
  }
    ],
          "icmsInterno": 0,
 "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>

"dataUltimaAlteracao": "2017-12-06T11:18:51"

<meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
    <title>Error 404

}, "modalidadeVarejo": "T10",

Not Found</title>
</head>
 
<body>
    <h2>HTTP

"simboloVarejo": "T1"

ERROR 404</h2>
    <p>Problem accessing /api/branch/v1/. Reason:

}

],

  <pre>

"hasNext": true }

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 o serviço winthor-tributacao está instalado. Caso não esteja, acesse a rotina 801 do WTA e realize a instalação

Bloco de código

language	java

<html>
 
<head>  Not Found</pre>
    </p>
    <meta<hr><a http-equiv="Content-Type" content="text/html;charset=utf-8" />href="http://eclipse.org/jetty">Powered by Jetty:// 9.3.21.v20170918</a>
    <title>Error<hr 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>

/>
 
</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 apresentou Status Code 403 Forbidden ao enviar a requisiçãonã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 Caso apresente 403 Forbidden, verifique se realizou a autenticação antes do envio da requisição.

Bloco de código

language	java

{
    "mensagemfirst": "Ofalse,
 Usuário não está autorizado a utilizar esse recurso""items": [],
    "erroshasNext": []false
}

Páginas filhas

Versões comparadas

Versão antiga 1

Nova versão 30

Chave

Objetivo

Pré-Requisitos e Restrições

Integração

Integração