Histórico da Página

...

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.codigoCategoria	PCPRODUT.CODCATEGORIA
produto.codigoSubCategoria	PCPRODUT.CODSUBCATEGORIA
produto.nomeFornecedor	PCFORNEC.FORNECEDOR
produto.codigoReferenciaFornecedor	PCPRODUT.CODFAB
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": 11001,
                "descricao": "CAMISA CORINTHIANS N. 1 BRANCA",
                "embalagem": "UNIDADE",
                "codigoDeBarra": "7891025111832",
                "palete": {
                    "lastroPalete": {
                        "valor": 1
                    },
                    "camadaPalete": {
                        "valor": 1
                    },
                    "normaPalete": {
                        "valor": 1
                    }
                },
                "pesoBruto": {
                    "valor": 0.037
                },
                "usaWms": false,
                "codigoSecao": 100001,
                "unidade": {
                    "sigla": "UN",
                    "descricao": "Unitário"
                },
                "revenda": true,
                "codigoMarca": 0,
                "pesoLiquido": {
                    "valor": 0.037
                },
                "induzLote": false,
                "dimensao": {
                    "altura": {
                        "valor": 0
                    },
                    "largura": {
                        "valor": 0
                    },
                    "comprimento": {
                        "valor": 0
                    }
                },
                "tipoComissao": "P",
                "pesoVariavel": false,
                "codigoCategoria": 0,
                "codigoSubCategoria": 0,
                "codigoReferenciaFornecedor": "21243",
                "nomeFornecedor": "NIKE SA",
                "codigoFornecedor": 140,
                "prazoMaxValidade": 0,
                "controlaSerie": true,
                "estoquePorLote": false,
                "codigoLinhaProduto": 0,
                "tipoProduto": "NORMAL",
                "tipoEstoque": "PADRAO",
                "codigoDepartamento": 100,
                "controladoIbama": false,
                "imuneTributacao": false,
                "usaFreteEspecial": false,
                "prazoMedioVenda": 0,
                "quantidadeCaixa": {
                    "valor": 1
                },
                "codigoProdutoPrincipal": 0,
                "codigoDeBarraAuxiliar": "12345689",
                "quantidadeUnitaria": {
                    "valor": 1
                },
                "tipoMercadoria": "CESTA_BASICA",
                "enderecoApanha": {
                    "rua": 2,
                    "modulo": 2,
                    "numero": 2,
                    "apartamento": 2
                },
                "percentualDiferencaKg": 0,
                "quantidadeMinimaAtacado": {
                    "valor": 0
                },
                "descricoes": [
                    null,
                    null,
                    null,
                    null,
                    null,
                    null,
                    null
                ],
                "tipoFracaoProduto": "NAO_ACEITA_FRACIONAMENTO",
                "multiplo": {
                    "valor": 1
                },
                "classificacaoProduto": "NORMAL",
                "pesoBrutoMaster": {
                    "valor": 7
                },
                "pesoLiquidoMaster": {
                    "valor": 0
                },
                "custoFornecedor": 0,
                "custoFornecedorSemSt": 0,
                "custoProximaCompra": 0,
                "custoProximaCompraSemSt": 0,
                "compraConsignado": false,
                "percentualPis": 1.6,
                "percentualCofins": 7.25,
                "situacao": "Ativo",
                "origemProd": "0",
                "cnpjFornecedor": "01358874001311",
                "embalagens": [
                    {
                        "unidade": {
                            "sigla": "UN",
                            "descricao": "Unitário"
                        },
                        "embalagem": "1X150X3G",
                        "produto": 11001,
                        "filial": {
                            "codigo": "1",
                            "razaoSocial": "FILIAL PARA VALIDACOES",
                            "uf": "GO",
                            "broker": false
                        },
                        "codigoDeBarra": "7891025111832",
                        "permiteVendaBalcao": false,
                        "permiteVendaTelemarketing": false,
                        "fatorConversao": {
                            "valor": 1
                        },
                        "pesoBruto": {},
                        "inativo": false
                    }
                ],
                "produtoKits": [],
                "codProdPrinc": 11001,
                "gatilhoAtacado": 0,
                "conciliaImportacao": false,
                "frios": false,
                "codfilial": "1",
                "dtcadastro": "2002-08-01T00:00:00",
                "dtultalter": "2024-06-18T10:51:27"
            },
            "piscofins": [
                {
                    "codTribPisCofins": 2,
                    "cst": "01",
                    "aliquotaPis": 0,
                    "aliquotaCofins": 0,
                    "dtUltAlt": "2022-05-05T16:51:04",
                    "dtCadastro": "2022-05-05T16:51:04",
                    "codProd": 11001
                }
            ],
            "icms": [
                {
                    "id": 17,
                    "baseCalculo": {
                        "valor": 0
                    },
                    "aliquota": {
                        "valor": 18.000
                    },
                    "reducaoBaseCalculo": {
                        "valor": 0
                    },
                    "dataUltimaAlteracao": "2022-08-26T10:51:06",
                    "substituicaoTributaria": {
                        "valor": {
                            "valor": 0
                        },
                        "baseCalculo": {
                            "valor": 0
                        },
                        "id": 17,
                        "substituicaoTributaria": {
                            "valor": 0
                        },
                        "baseSubstituicaoTributaria": {
                            "valor": 0
                        },
                        "reducaoBaseCalculo": {
                            "valor": 0
                        },
                        "tipoSubstituicaoTributaria": {
                            "descricao": "SEM ST"
                        },
                        "iva": {
                            "valor": 0
                        },
                        "icmsExterno": {
                            "valor": 18.000
                        },
                        "icmsInterno": {
                            "valor": 17.000
                        },
                        "pauta": {
                            "valor": 0
                        },
                        "stGnre": false,
                        "baseFecp": {
                            "valor": 0
                        },
                        "aliquotaFecp": {
                            "valor": 0
                        },
                        "valorFecp": {
                            "valor": 0
                        },
                        "dataUltimaAlteracao": "2022-08-26T10:51:06",
                        "tipo": "ST",
                        "aliquota": {
                            "valor": 0
                        }
                    },
                    "fcp": {
                        "id": 17,
                        "valorBaseFcp": {
                            "valor": 0
                        },
                        "percentualFcp": {
                            "valor": 1.000
                        },
                        "codigoBeneficioFiscal": {
                            "valor": 0
                        },
                        "motivoDesoneracaoIcms": {
                            "valor": 0
                        },
                        "descontaDesoneracaoNf": false,
                        "tipoTrib": "",
                        "tipo": "FCP",
                        "baseCalculo": {
                            "valor": 0
                        },
                        "aliquota": {
                            "valor": 0
                        },
                        "reducaoBaseCalculo": {
                            "valor": 100.000
                        },
                        "valor": {
                            "valor": 0
                        }
                    },
                    "modalidadeVarejo": "18 %",
                    "indiceTributoImpressoraVarejo": "T",
                    "simboloVarejo": "T",
                    "cst": "20",
                    "codProd": 11001,
                    "codFilial": "1",
                    "tipo": "ICMS",
                    "valor": {
                        "valor": 0
                    }
                }
            ],
            "ncm": [
                {
                    "id": "85011030-85011030.",
                    "codigoNcm": "85011030",
                    "codigoExcecao": 0,
                    "aliquotaNacional": 0,
                    "aliquotaEstadual": 0,
                    "aliquotaImportada": 0,
                    "aliquotaMunicipal": 0,
                    "dataUltimaAtualizacao": "2024-06-18T10:51:27",
                    "dataCadastro": "2002-08-01T00:00:00",
                    "codProd": 11001
                }
            ]
        }
    ],
    "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,

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 nas rotinas 514 e 574.

Os dados integrados são:

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

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.CODPROD

produto.descricao

PCEMBALAGEM.DESCRICAOECF , PCPRODUT.DESCRICAO

produto.embalagem

PCEMBALAGEM.EMBALAGEM , PCPRODUT.EMBALAGEM

produto.codigoDeBarra

PCEMBALAGEM.CODAUXILIAR , PCPRODUT.CODAUXILIAR

produto.classe

PCPRODUT.CLASSE

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

PCPRODUT.ACEITAVENDAFRACAO

produto.multiplo

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

Totvs custom tabs box items

default	no
referencia	passo2

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

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": [
        {
            "produtousaFreteEspecial": {false,
                "codigoprazoMedioVenda": 10,
                "descricaoquantidadeCaixa": "TESTE",
{
                    "embalagemvalor": "EMB. TESTE",1
                "codigoDeBarra": "1"},
                "classecodigoProdutoPrincipal": "A"0,
                "paletequantidadeUnitaria": {
                    "lastroPaletevalor": {1
                },
                "valortipoMercadoria": 0"KIT",
                    },"enderecoApanha": {
                    "camadaPaleterua": {
    1,
                    "valormodulo": 01,
                    "numero": }1,
                    "normaPaleteapartamento": {1
                },
         "valor       "quantidadeMinimaAtacado": 0{
                    "valor": }0
                },
                "pesoBrutodescricoes": {[
                    "valor": 1
  null,
              },
      null,
          "usaWms": false,
                "codigoSecao": 1,
null,
                  "unidade": {  null,
                    "sigla": "CX"null,
                    "descricao": "Caixa"
null,
                    },null
                "revenda": true],
                "codigoMarcatipoFracaoProduto": 0"NAO_ACEITA_FRACIONAMENTO",
                "pesoLiquidomultiplo": {
                    "valor": 1
                },
                "induzLoteclassificacaoProduto": false,
                "dimensao": {
    "NORMAL",
                "alturapesoBrutoMaster": {
                        "valor": 0
                    },
                    "largurapesoLiquidoMaster": {
                        "valor": 0
                },
     },
           "custoFornecedor": 0,
        "comprimento": {
       "custoFornecedorSemSt": 0,
                "valorcustoProximaCompra": 0,
                "custoProximaCompraSemSt": 0,
   }
                }"compraConsignado": false,
                "filialRetirasituacao": {
    "Ativo",
                "codigoorigemProd": "1Nacional",
                    "razaoSocialcnpjFornecedor": "FILIAL RETIRA09640611000250",
                    "ufcodigoCest": "GO1710101",
                "embalagens": [
   "broker": false
                },{
                   "tipoComissao": "P",
    "unidade": {
           "pesoVariavel": false,
                "codigoFornecedorsigla": 1"UN",
                "prazoMaxValidade": 0,
                "controlaSeriedescricao": false,
  "Unitário"
              "estoquePorLote": false,
         },
       "codigoLinhaProduto": 0,
                "tipoProdutoembalagem": "NORMALUN",
                "tipoEstoque": "PADRAO",
       "produto": 902560,
        "codigoDepartamento": 1,
                "controladoIbamafilial": false,
     {
           "imuneTributacao": false,
                "usaFreteEspecialcodigo": true"1",
                "prazoMedioVenda": 0,
                "quantidadeCaixarazaoSocial": {
"EMP M L COM DE ALIM E BEB LTDA",
            "valor": 1
                }"uf": "GO",
                "codigoProdutoPrincipal": 0,
                "quantidadeUnitariabroker": {false
                    "valor": 1
       },
         },
                "tipoMercadoriacodigoDeBarra": "PRODUTO_ACABADO7891132010999",
                        "enderecoApanhapermiteVendaBalcao": {
false,
                        "ruapermiteVendaTelemarketing": 1false,
                        "modulofatorConversao": 1,
{
                            "numerovalor": 1,
                       "apartamento": 1 },
                },
        "pesoBruto": {},
       "percentualDiferencaKg": 0,
                "quantidadeMinimaAtacadoinativo": {false
                    "valor": 0}
                }],
                "descricoesprodutoKits": [
                    {
   "DESCRICAO UM",
                    "idRetaguardaProduto"DESCRICAO: DOI"902560,
                        "idRetaguardaProdutoKit": 13,
    "DESCRICAO TRES",
                   "descricao": "DESCRICAONovo kit QUATROteste",
                    "DESCRICAO CINCO",
    "quantidadeVendaKit": 5,
                        "tipoValorKit"DESCRICAO: SEIS"1,
                        "situacao"DESCRICAO: SETE"1,
                ],
        "valorDesconto": 0,
       "tipoFracaoProduto": "NAO_ACEITA_FRACIONAMENTO",
                "multiplonovoValorUnitario": {
1.97,
                        "valorcodigoFilial": "1
        ",
        },
                "classificacaoProdutocodigoProduto": "NORMAL",
     902560
           "pesoBrutoMaster": {
        },
            "valor": 0
       {
         },
                "pesoLiquidoMasteridRetaguardaProduto": {902560,
                        "valoridRetaguardaProdutoKit": 088,
                 },
       "descricao": "Novo kit teste",
      "custoFornecedor": 0,
                  "custoFornecedorSemStquantidadeVendaKit": 010,
                        "custoProximaCompratipoValorKit": 01,
                "custoProximaCompraSemSt": 0,
         "situacao": 1,
       "compraConsignado": false,
                "percentualPisvalorDesconto": 0,
                        "percentualCofinsnovoValorUnitario": 01.21,
                        "situacaocodigoFilial": "Ativo1",
                        "origemProdcodigoProduto": "Importado",
902560
                   "cnpjFornecedor": "(CNPJ)", }
                "descontoMaximo": 99],
                "conciliaImportacao": false,
                "codfilialdtcadastro": "12023-12-05T00:00:00",
                "friosdtultalter": false"2023-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.0000000
                        },
                        "motivoDesoneracaoIcms": {
                            "valor": 1.0000000
                        },
                        "descontaDesoneracaoNf": truefalse,
                        "tipoTrib": "",
                        "baseCalculotipo": {
    "FCP",
                        "valorbaseCalculo": 0{
                        },
    "valor": 0
                   "aliquota": {
    },
                        "valoraliquota": 0{
                             },
 "valor": 0
                       "tipo": "FCP" },
                        "valorreducaoBaseCalculo": {
                            "valor": 0100.00
                        },
                        "reducaoBaseCalculovalor": {
                            "valor": 100.0000000
                        }
                    },
                    "modalidadeVarejo": "T120 %",
                    "indiceTributoImpressoraVarejo": "FF1700",
                    "simboloVarejo": "T117",
                    "cst": "010""00",
                    "codProd": 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 7

Nova versão Atual

Chave

Integração

Integração