Páginas filhas
  • APIs Integrações - Produto/Tributação - EM HOMOLOGAÇÃO

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

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
tabsDados integrados com Winthor, Envio Parâmetros, Resposta da Requisição, Principais dúvidas e conflitos
idspasso1,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
defaultyes
referenciapasso1

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.codigoCestPCCEST.CODCEST

produto.palete.lastroPalete

PCPRODUT.LASTROPAL


produto.palete.camadaPaletePCPRODUT.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.pesoLiquidoPCEMBALAGEM..PESOLIQ , PCPRODUT.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.quantidadeUnitariaPCEMBALAGEM..QTUNIT , PCPRODUT.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.tipoFracaoProdutoNVL(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.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.origemProd
  1. PCPRODUT.IMPORTADO
  2. 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
  1. Se IMPORTADO é igual a "D", produto "Importado", se diferente de "D", produto "Nacional";
  2.  Será gerado no campo, os respectivos valores cadastrados na rotina 238


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
produto.embalagensPCEMBALAGEMRetorna as embalagens do produto caso o parâmetro  FIL_UTILIZAVENDAPOREMBALAGEM for igual a sim
produto.embalagens.unidadePCEMBALAGEM.UNIDADE
produto.embalagens.descricaoPCEMBALAGEM.DESCRICAOECF
produto.embalagens.embalagemPCEMBALAGEM.EMBALAGEM
produto.embalagens.produtoPCEMBALAGEM.CODPROD
produto.embalagens.filialPCEMBALAGEM.CODFILIAL
produto.embalagens.codigoDeBarraPCEMBALAGEM.CODAUXILIAR
produto.embalagens.permiteVendaTelemarketingPCEMBALAGEM.ENVIATELEMARKETING
produto.embalagens.fatorConversaoPCEMBALAGEM.QTUNIT
produto.embalagens.inativoPCEMBALAGEM.DTINATIVOCaso DTINATIVO for igual a NULL então FALSE caso contrario TRUE 
produto.produtoKits
Retorna os itens do KIT
produto.produtoKits.idRetaguardaProdutoKitPCFORMPROD.CODPRODMP
produto.produtoKits.idRetaguardaProdutoKitPCPRECOCESTAI.CODPRODMP
produto.produtoKits.descricaoPCPRODUT.DESCRICAO
produto.produtoKits.quantidadeVendaKitPCFORMPROD.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.valorDescontoDefault 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
defaultno
referenciapasso2

Exemplo do envio da requisição:

Bloco de código
languagejs
titleURI
method: 'GET',
url: '/winthor/tributacao/v0/saida/produtotributacao/consultar'
Bloco de código
languagejs
titleParams
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
defaultno
referenciapasso3

Exemplo JSON da resposta item normal:  

Bloco de código
languagejs
themeEclipse
titleResponse
{
    "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
languagejs
themeEclipse
titleResponse
{
    "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
languagejs
themeEclipse
titleResponse
{
    "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
tabsDados integrados com Winthor, Envio Parâmetros, Resposta da Requisição, Principais dúvidas e conflitos
idspasso1,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
defaultyes
referenciapasso1

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.pesoLiquidoproduto.induzLote
produto.dimensao
produto.filialRetiraproduto.tipoComissaoproduto.pesoVariavelproduto.codigoFornecedorproduto.prazoMaxValidadeproduto.controlaSerieproduto.estoquePorLoteproduto.codigoLinhaProdutoproduto.tipoProdutoproduto.tipoEstoqueproduto.codigoDepartamentoproduto.controladoIbamaproduto.imuneTributacaoproduto.usaFreteEspecialproduto.prazoMedioVendaproduto.quantidadeCaixaproduto.codigoProdutoPrincipalproduto.quantidadeUnitariaproduto.tipoMercadoriaproduto.enderecoApanhaproduto.percentualDiferencaKgproduto.quantidadeMinimaAtacadoproduto.descricoesproduto.tipoFracaoProdutoproduto.multiploproduto.classificacaoProdutoproduto.pesoBrutoMasterproduto.pesoLiquidoMasterproduto.custoFornecedorproduto.custoFornecedorSemStproduto.custoProximaCompraproduto.custoProximaCompraSemStproduto.compraConsignadoproduto.percentualPisproduto.percentualCofinsproduto.situacaoproduto.origemProdproduto.cnpjFornecedorproduto.descontoMaximoproduto.conciliaImportacaoproduto.friosproduto.dtultalterproduto.dtcadastroproduto.codfilial
Totvs custom tabs box items
defaultno
referenciapasso2
Bloco de código
languagejs
titleURI
method: 'GET',
url: '/winthor/tributacao/v0/saida/icms/consultar'
Bloco de código
languagejs
titleParams
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
defaultno
referenciapasso3

Exemplo JSON da resposta:  

Bloco de código
languagejs
themeEclipse
titleResponse
{
    "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
defaultno
referenciapasso4
Expandir
titleApresentou 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
languagejava
<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
defaultno
referenciapasso4
Expandir
titleApresentou 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
languagejava
<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
titleInstalei 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
languagejava
{
    "code": "UNK-ERR",
    "message": "Erro de Requisição",
    "detailedMessage": "The current Subject is not authenticated.  Access denied.",
    "details": []
}
Expandir
titleInstalei 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
languagejava
{
    "mensagemfirst": "Ofalse,
 Usuário não está autorizado a utilizar esse recurso""items": [],
    "erroshasNext": []false
}