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

Integração


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: 

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.camadaPaletePCPRODUT.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.pesoLiquidoPCPRODUT.PESOLIQ
produto.induzLote
PCPRODUT.INDUZLOTE
produto.dimensao.altura
PCPRODUT.ALTURAARM
produto.dimensao.larguraPCPRODUT.LARGURAARM
produto.dimensao.comprimentoPCPRODUT.COMPRIMENTOARM
produto.filialRetiraPCPRODUT.CODFILIALRETIRA
produto.tipoComissaoPCPRODUT.TIPOCOMISSAO
produto.pesoVariavelPCPRODUT.PESOVARIAVEL
produto.codigoFornecedorPCPRODUT.CODFORNEC
produto.prazoMaxValidadePCPRODUT.PRAZOVAL
produto.controlaSeriePCPRODUT.CONTROLANUMSERIE
produto.estoquePorLotePCPRODUT.ESTOQUEPORLOTE
produto.codigoLinhaProdutoPCPRODUT.CODLINHAPROD
produto.tipoProdutoPCPRODUT.TIPOPROD
produto.tipoEstoquePCPRODUT.TIPOESTOQUE
produto.codigoDepartamentoPCPRODUT.CODEPTO
produto.controladoIbamaPCPRODUT.CONTROLADOIBAMA
produto.imuneTributacaoPCPRODUT.IMUNETRIB
produto.usaFreteEspecialPCPRODUT.FRETEESPECIAL
produto.prazoMedioVendaPCPRODUT.PRAZOMEDIOVENDA
produto.quantidadeCaixaPCPRODUT.QTUNITCX
produto.quantidadeUnitariaPCPRODUT.QTUNIT
produto.tipoMercadoriaPCPRODUT.TIPOMERC
produto.enderecoApanha.ruaPCPRODUT.RUA
produto.enderecoApanha.moduloPCPRODUT.MODULO
produto.enderecoApanha.numeroPCPRODUT.NUMERO
produto.enderecoApanha.aptoPCPRODUT.APTO
produto.percentualDiferencaKgPCPRODUT.PERCDIFERENCAKGFRIO
produto.quantidadeMinimaAtacadoPCPRODUT.QTMINIMAATACADO
produto.descricoes

PCPRODUT.DESCRICAO1, PCPRODUT.DESCRICAO2

PCPRODUT.DESCRICAO3, PCPRODUT.DESCRICAO4,

PCPRODUT.DESCRICAO5, PCPRODUT.DESCRICAO6,

PCPRODUT.DESCRICAO7


produto.tipoFracaoProdutoPCPRODUT.ACEITAVENDAFRACAO
produto.multiploPCPRODUT.MULTIPLO
produto.classificacaoProdutoPCPRODUT.OBS
produto.pesoBrutoMasterPCPRODUT.PESOBRUTOMASTER
produto.pesoLiquidoMasterPCPRODUT.PESOLIQMASTER
produto.custoFornecedorPCPRODUT.CUSTOFORNEC
produto.custoFornecedorSemStPCPRODUT.CUSTOFORNECSEMST
produto.custoProximaCompraPCPRODUT.CUSTOPROXIMACOMPRA
produto.custoProximaCompraSemStPCPRODUT.CUSTOPROXIMACOMPRASEMST
produto.percentualPisPCPRODUT.PERPIS
produto.percentualCofinsPCPRODUT.PERCOFINS
produto.situacaoPCPRODUT.DTEXCLUSAOSe DTEXCLUSAO é nula, produto "Inativo", se não nula, produto "Ativo";
produto.origemProdPCPRODUT.IMPORTADOSe IMPORTADO é igual a "D", produto "Importado", se diferente de "D", produto "Nacional";
produto.cnpjFornecedorPCFORNEC.CGC
produto.descontoMaximoPCMETAPARAMFILIALParâmetro 1463 - % Máximo de desconto Médio nos Orçamentos e Pedidos Venda da rotina 132;
produto.conciliaImportacaoPCPRODUT.CONCILIAIMPORTACAO
produto.dtultalterPCPRODUT.DTULTALTER
produto.dtcadastroPCPRODUT.DTCADASTRO
produto.codfilialPCPRODFILIAL.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




Exemplo do envio da requisição:

method: 'GET',
url: '/winthor/tributacao/v0/saida/produtotributacao/consultar'
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



Exemplo JSON da resposta:  

{
    "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
}

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

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

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

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

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 

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