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.

...

  • Necessário instalar os serviços winthor-tributaçãoe winthor-produto na rotina 801 do WTA, conforme indicação Parametrizações WTA.
  • 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

...

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",
                    "codigoExcecao": 0,
                    "codigoCest": "1710101",
                    "dataUltimaAtualizacao": "2023-12-06T11:12:29",
                    "dataCadastro": "2023-12-05T00:00:00",
                    "codProd": 902560
                }
            ]
        }
    ],
    "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>
    <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
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 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
languagejava
{
    "first": false,
    "items": [],
    "hasNext": false
}

...