Páginas filhas
  • APIs Integrações - Tributação - 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 dos tribututostributos, observando os seguintes critérios:

  • Enviar tributação apenas tributações onde o Tipo de Operação seja apenas de Saída(S) ou Ambos(A)
  • Enviar apenas as tributações onde sejam de Consumidor Final 
  • Enviar apenas as tributações onde Contribuinte sejam igual a Não
  • Não enviar tributação tributações de Devolução
  • Não enviar 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: 

TIBUTOS  TRIBUTOS                                                |         PCTIBUTACAO

API

Referência Winthor

codigoTributacao

pctributacao.codigo_tributacao

descricaoTributacao

pctributacao.descricao_tributacao

tipoImposto

pctributacao.tipo_imposto

localConsumo

pctributacao.local_consumo_geral ou pctributacao.local_consumo_municipio (conforme pctributacao.tipo_local_consumo)

tipoOperacao

pctributacao.tipo_operacao

devolucao

pctributacao.devolucao

tipoEmpresa

pctributacao.tipo_empresa

contribuinte

pctributacao.contribuinte

orgaoPublico

pctributacao.orgao_publico

cst

pctributacao.cst

classificacaoTributaria

pctributacao.cclasstrib

valorAliquota

pctributacao.valor_aliquota

origemMercadoria

pctributacao.origem_mercadoria

tipoMercadoria

pctributacao.tipo_merc

dataInicioVigencia

pctributacao.dtinicio_vigencia

dataFimVigencia

pctributacao.dtfim_vigencia

ativo

Se campo pctributacao.dtinativacao estiver preenchido

igual a false,

senão true

dataUltimaAlteracao

Maior data entre:

pctributacao.dtcriacao

pctributacao.dtultalter

pctributacao.dtinativacao

pctributacao.dtexclusao

tipoLocalConsumo

pctributacao.tipo_local_consumo

localConsumoGeral

pctributacao.local_consumo_geral

localConsumoMunicipio

pctributacao.local_consumo_municipio

impostos.[*].tipoDetalheImposto

"CBS", "IBSUF", "IBSM",  ou "IS"

impostos.[*].percentualAliquota

pctributacao.perc_cbs ou pctributacao.perc_ibs_uf ou pctributacao.perc_ibs_mun ou pctributacao.perc_is

impostos.[*].percentualReducaoAliquota

pctributacao.perc_red_cbs ou pctributacao.perc_red_ibs_uf ou pctributacao.perc_red_ibs_mun

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/consultar/pdvsync'
Bloco de código
languagejs
titleParams
order  		: lastChange			- ordenação
lastChange  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
page		: 1						- número da página
pageSize	: 10					- quantidade por página (opcional)
active           : true                - Ativos = true ; Inativos = false (opcional)
startDate        : 1900-01-01T00:00:00 - Data de inicio da vigência (opcional)
endDate          : 1900-01-01T00:00:00 - Data de fim da vigência (opcional)
branchId         : 1,2                 - Lista de códiigos de filiais (OBRIGATÓRIO)
placeConsumption : BR,GO               - Lista de locais de consumo - BR, UF ou código de cidade IBGE (opcional)
branchId         : 1,2                 - Lista de códigos de filiais (OBRIGATÓRIO)
cst              : 30,40               - Lista de CST (opcional)
cclasstrib       : 01,02               - Lista de classificações tributárias (opcional)
taxId            : 1,2                 - Lista de códigos de tributação (opcional)     
taxType          : CBSIBS,IS           - Lista de tipos de tributos (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": [
        {
            "_expandablescodigoTributacao": [2,
            "descricaoTributacao": "CBS BR TO-AM "department"
DV-N CS-N CN-N ***",
             ]"tipoImposto": "CBSIBS",
            "idlocalConsumo": 0"GO",
            "descriptiontipoOperacao": "stringA",
            "departmentdevolucao": {false,
                "idtipoEmpresa": 9"EPP",
                "nametipoPessoa": "stringJ",
            "contribuinte": false,
            "fatherCategoryIdorgaoPublico": 0false,
            "cst": "00",
   "title         "classificacaoTributaria": "01",
            "origemMercadoria": "1",
            "descriptiontipoMercadoria": "L",
            "dataInicioVigencia": "2025-06-01T00:00:00",
            "keywordsdataFimVigencia": "2025-12-31T00:00:00",
            "ativo": true,
   "lastChange         "dataUltimaAlteracao": "19002025-0107-01T0024T13:43:0005",
            "tipoLocalConsumo": "G",
            "updateStockGenerallocalConsumoGeral": true"GO",
            "impostos": [
   "typeMerchandise             {
                    "tipoDetalheImposto": "stringIBSUF",
                    "dtcreatepercentualAliquota": "1900-01-01T00:00"20,
                    "activepercentualReducaoAliquota": false21
                },
             "title   {
                    "tipoDetalheImposto": "IBSM",
                    "keywordspercentualAliquota": 22,
                    "percentualReducaoAliquota": 23
                },
                {
             "adWordsRemarketingCode       "tipoDetalheImposto": "CBS",
                    "lastChangepercentualAliquota": "2020-11-16T12:29:50"10,
            "dtcreate        "percentualReducaoAliquota": "1900-01-01T00:00:00"
11
                }
            ]
        }
    ],
    "hasNext": truefalse
}

Para que seja realizada uma nova integração atualizando um registro já integrado, o sistema verifica a data de última atualização do registro. Portanto, ao realizar alguma alteração no registro, ele será encaminhado novamente para a view para manter a integridade dos dados do ERP com o E-commerceSistema que recebe os dados da Integração