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

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

Totvs custom tabs box items

default	yes
referencia	passo1

Os dados integrados são:

PCPRODUT, PCPRODFILIAL
API	Referência Winthor	Obs
produto.icodigo	PCPRODUT.CODPROD
produto.descricao	PCPRODUT.DESCRICAO
produto.embalagem	PCPRODUT.EMBALAGEM
produto.codigoDeBarra	PCPRODUT.CODAUXILIAR
produto.classe	PCPRODUT.CLASSE
produto.palete.lastroPalete	PCPRODUT.LASTROPAL
produto.palete.camadaPalete	PCPRODUT.CAMAPAPAL
produto.pesoBruto	PCPRODUT.PESOBRUTO
produto.usaWms	PCPRODUT.USAWMS
produto.codigoSecao	PCPRODUT.CODSEC
produto.unidade	PCPRODUT.UNIDADE
produto.revenda	PCPRODUT.REVENDA
produto.codigoMarca	PCPRODUT.CODMARCA
produto.pesoLiquido	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	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

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

paginapage	: 1								   		- número da página
tamanhopageSize	: 10								    - quantidade por página 
dataUltimaAlteracao  : AAAA-MM-DDTHH:MM:SS      - data de ultima alteração
filial:											- código da filial
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": [
        {
            "produto": {
                "codigo": 1,
                "descricao": "TESTE",
                "embalagem": "EMB. TESTE",
                "codigoDeBarra": "1",
                "classe": "A",
                "palete": {
                    "lastroPalete": {
                        "valor": 0
                    },
                    "camadaPalete": {
                        "valor": 0
                    },
                    "normaPalete": {
                        "valor": 0
                    }
                },
                "pesoBruto": {
                    "valor": 1
                },
                "usaWms": false,
                "codigoSecao": 1,
                "unidade": {
                    "sigla": "CX",
                    "descricao": "Caixa"
                },
                "revenda": true,
                "codigoMarca": 0,
                "pesoLiquido": {
                    "valor": 1
                },
                "induzLote": false,
                "dimensao": {
                    "altura": {
                        "valor": 0
                    },
                    "largura": {
                        "valor": 0
                    },
                    "comprimento": {
                        "valor": 0
                    }
                },
                "filialRetira": {
                    "codigo": "1",
                    "razaoSocial": "FILIAL RETIRA",
                    "uf": "GO",
                    "broker": false
                },
                "tipoComissao": "P",
                "pesoVariavel": false,
                "codigoFornecedor": 1,
                "prazoMaxValidade": 0,
                "controlaSerie": false,
                "estoquePorLote": false,
                "codigoLinhaProduto": 0,
                "tipoProduto": "NORMAL",
                "tipoEstoque": "PADRAO",
                "codigoDepartamento": 1,
                "controladoIbama": false,
                "imuneTributacao": false,
                "usaFreteEspecial": true,
                "prazoMedioVenda": 0,
                "quantidadeCaixa": {
                    "valor": 1
                },
                "codigoProdutoPrincipal": 0,
                "quantidadeUnitaria": {
                    "valor": 1
                },
                "tipoMercadoria": "PRODUTO_ACABADO",
                "enderecoApanha": {
                    "rua": 1,
                    "modulo": 1,
                    "numero": 1,
                    "apartamento": 1
                },
                "percentualDiferencaKg": 0,
                "quantidadeMinimaAtacado": {
                    "valor": 0
                },
                "descricoes": [
                    "DESCRICAO UM",
                    "DESCRICAO DOI",
                    "DESCRICAO TRES",
                    "DESCRICAO QUATRO",
                    "DESCRICAO CINCO",
                    "DESCRICAO SEIS",
                    "DESCRICAO SETE"
                ],
                "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": "Importado",
                "cnpjFornecedor": "(CNPJ)",
                "descontoMaximo": 99,
                "conciliaImportacao": false,
                "codfilial": "1",
                "frios": false,
                "dtcadastro": "2012-01-01T00:00:00",
                "dtultalter": "2022-06-22T00:00:00"
            },
            "piscofins": [
                {
                    "codTribPisCofins": 1,
                    "cst": "010",
                    "aliquotaPis": 1,
                    "aliquotaCofins": 1,
                    "dtUltAlt": "2022-06-02T00:00:00",
                    "dtCadastro": "2022-06-01T00:00:00"
                }
            ],
            "icms": [
                {
                    "id": 1,
                    "baseCalculo": {
                        "valor": 0
                    },
                    "aliquota": {
                        "valor": 1.000000
                    },
                    "reducaoBaseCalculo": {
                        "valor": 1.000000
                    },
                    "dataUltimaAlteracao": "2022-01-06T16:46:39",
                    "substituicaoTributaria": {
                        "valor": {
                            "valor": 0
                        },
                        "baseCalculo": {
                            "valor": 0
                        },
                        "id": 2,
                        "substituicaoTributaria": {
                            "valor": 0
                        },
                        "baseSubstituicaoTributaria": {
                            "valor": 0
                        },
                        "reducaoBaseCalculo": {
                            "valor": 0
                        },
                        "tipoSubstituicaoTributaria": {
                            "descricao": "SEM ST"
                        },
                        "iva": {
                            "valor": 0
                        },
                        "icmsExterno": {
                            "valor": 1.000000
                        },
                        "icmsInterno": {
                            "valor": 1.000000
                        },
                        "pauta": {
                            "valor": 0
                        },
                        "stGnre": false,
                        "baseFecp": {
                            "valor": 0
                        },
                        "aliquotaFecp": {
                            "valor": 0
                        },
                        "valorFecp": {
                            "valor": 0
                        },
                        "dataUltimaAlteracao": "2022-01-06T16:46:39",
                        "aliquota": {
                            "valor": 0
                        },
                        "tipo": "ST"
                    },
                    "fcp": {
                        "id": 1,
                        "valorBaseFcp": {
                            "valor": 0
                        },
                        "percentualFcp": {
                            "valor": 0
                        },
                        "codigoBeneficioFiscal": {
                            "valor": 1.000000
                        },
                        "motivoDesoneracaoIcms": {
                            "valor": 1.000000
                        },
                        "descontaDesoneracaoNf": true,
                        "tipoTrib": "",
                        "baseCalculo": {
                            "valor": 0
                        },
                        "aliquota": {
                            "valor": 0
                        },
                        "tipo": "FCP",
                        "valor": {
                            "valor": 0
                        },
                        "reducaoBaseCalculo": {
                            "valor": 100.000000
                        }
                    },
                    "modalidadeVarejo": "T12",
                    "indiceTributoImpressoraVarejo": "FF",
                    "simboloVarejo": "T1",
                    "cst": "010",
                    "tipo": "ICMS",
                    "valor": {
                        "valor": 0
                    }
                }
            ],
            "ncm": [
                {
                    "id": "1",
                    "codigoNcm": "1",
                    "codigoExcecao": 1,
                    "aliquotaNacional": 1,
                    "aliquotaEstadual": 1,
                    "codigoCest": "1",
                    "dataUltimaAtualizacao": "2022-01-06T16:46:39",
                    "dataCadastro": "2000-01-01T00:00:00"
                }
            ]
        }
    ],
    "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 3

Nova versão 4

Chave

Objetivo

Pré-Requisitos e Restrições

Integração