Páginas filhas
  • APIs Integrações - Tributação - Exceções NCM e Produto - CBS / IBS / IS

Versões comparadas

Chave

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

...

Totvs custom tabs box
tabsDados integrados com Winthor, Envio Parâmetros, Resposta da Requisição, Passo 04
idspasso1,passo2,passo3

A integração consiste em enviar os dados de cadastro das exceções por NCM e Produto dos tributos.

Para garantir a integridade referencial com o cadastro pai - cadastro do tributo, são mantidas as mesmas restrições: 

  • Enviar apenas exceções de tributações onde o Tipo de Operação seja apenas de Saída(S) ou Ambos(A)
  • Enviar apenas exceções de tributações onde sejam de Consumidor Final 
  • Enviar apenas exceções de tributações onde Contribuinte sejam igual a Não
  • Não enviar exceções de tributações de Devolução
  • Não enviar exceções de tributações onde não haja Classificação Tributária ou CST Imposto


Totvs custom tabs box items
defaultyes
referenciapasso1

Os dados integrados são: 

EXCEÇÕES NCM        |  PCTRIBUTACAO_FILTRO_NCM

API

Referência Winthor

codigoTributacao

pctributacao_filtro_ncm.codigo_tributacao

ncm

pctributacao_filtro_ncm.ncm

ativo

ncm.dtinativacao is null

dataUltimaAlteracao

greatest(nvl(pctributacao_filtro_ncm.dtcriacao,
                    to_date('01/01/1900 00:00:00', 'dd/mm/yyyy hh24:mi:ss')),
                nvl(pctributacao_filtro_ncm.dtultalter,
                    to_date('01/01/1900 00:00:00', 'dd/mm/yyyy hh24:mi:ss')),
                nvl(pctributacao_filtro_ncm.dtinativacao,
                    to_date('01/01/1900 00:00:00', 'dd/mm/yyyy hh24:mi:ss')),
                to_date('01/01/1900 00:00:00', 'dd/mm/yyyy hh24:mi:ss'))

tiposDetalheImposto

["IBSUF", "IBSM", "CBS" ou "IS"] (lista de valores baseados nos impostos cadastrados na pctributacao)

EXCEÇÕES PRODUTO |  PCTRIBUTACAO_FILTRO_PRODUTO

API

Referência Winthor

codigoTributacao

pctributacao_filtro_produto.codigo_tributacao

codigoProduto

pctributacao_filtro_produto.codprod

embalagem

pcprodut.codauxiliar (onde pcprodut.codprod = pctributacao_filtro_produto.codprod)

ativo

ncm.dtinativacao is null

dataUltimaAlteracao

greatest(nvl(pctributacao_filtro_ncm.dtcriacao,
                    to_date('01/01/1900 00:00:00', 'dd/mm/yyyy hh24:mi:ss')),
                nvl(pctributacao_filtro_ncm.dtultalter,
                    to_date('01/01/1900 00:00:00', 'dd/mm/yyyy hh24:mi:ss')),
                nvl(pctributacao_filtro_ncm.dtinativacao,
                    to_date('01/01/1900 00:00:00', 'dd/mm/yyyy hh24:mi:ss')),
                to_date('01/01/1900 00:00:00', 'dd/mm/yyyy hh24:mi:ss'))

tiposDetalheImposto

["IBSUF", "IBSM", "CBS" ou "IS"] (lista de valores baseados nos impostos cadastrados na pctributacao)

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/tributacao/excecao/consultar/pdvsync'
Bloco de código
languagejs
titleParams
page		     : 1                   - número da página (opcional, default 1)
pageSize	     : 10                  - quantidade por página (opcional, default 10)
createdDate      : 1900-01-01T00:00:00 - data da criação (opcional)
lastChange       : 1900-01-01T00:00:00 - data da última alteração (opcional)
active           : true                - Ativos = true ; Inativos = false (opcional)
startDatetaxId         : 1900-01-01T00:00:00 - Data de inicio da vigência (opcional)
endDate    : 1                : 1900-01-01T00:00:00 - Data de- fimCódigo da vigênciatributação (opcional)
branchId      
productId    : 1,2                 - Lista de códiigos de filiais (OBRIGATÓRIO)
placeConsumption : BR,GO    : 1               - Lista de locais de consumo - BR,Código UFdo ou código de cidade IBGE Produto (opcional)
branchId         : 1,2                 - Lista de códigos de filiais (OBRIGATÓRIO)
cst  
ncmId              : 30,40123456               - ListaCódigo dedo CSTNCM (opcional)
cclasstrib       : 01,02               - Lista de classificações tributárias (opcional)
taxId
exceptionType    : N  ou  P   : 1,2           - Tipo de Exceção -  N-NCM Lista de códigos de tributaçãoou P-Produto (opcionalOBRIGATÓRIO)
branchId      
taxType    : 1,2 ou 99   : CBS,IBS,IS          - Lista de tiposcódigos de tributosfiliais (OBRIGATÓRIO, somente aceitos os três tipos CBS, IBS e IS)
Totvs custom tabs box items
defaultno
referenciapasso3

Exemplo JSON da resposta:  

Bloco de código
languagejs
titleBody Response
{
    "first": false,
    "items": [
        {
            "codigoTributacao": 1,
            "descricaoTributacao": "CBS EXEMPLO",
            "tipoImposto": "CBS",
            "localConsumo": "BR",
            "tipoOperacao": "A",
            "devolucao": false,
            "tipoEmpresa": "J",
            "contribuinte": false,
            "orgaoPublico": false,
            "cst": "00",
            "classificacaoTributaria": "02",
            "valorAliquota": 17,
            "origemMercadoria": "0",
            "tipoMercadoria": "L",
            "dataInicioVigencia": "2025-06-01T00:00:00",
            "dataFimVigencia": "2025-12-31T00:00:00",
            "ativo": false,
            "dataUltimaAlteracao": "2025-06-06T10:04:09"
        }
    ],
    "hasNext": false
} 

...