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 tribututos, observando os seguintes critérios:

  • Enviar tributação 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 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                     |         PCTIBUTACAO

API

Referência Winthor

codigoTributacao

pctributacao.codigo_tributacao

descricaoTributacao

pctributacao.descricao_tributacao

tipoImposto

pctributacao.tipo_imposto

localConsumo

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

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




Totvs custom tabs box items
defaultno
referenciapasso3

Exemplo JSON da resposta:  

Bloco de código
languagejs
titleBody Response
{
    "first": false,
    "items": [
taxId            : 1,2             {
    - Lista de códigos de tributação (opcional)   "_expandables":  [
taxType          : CBS,IBS,IS     "department"
      - 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
{
    "idfirst": 0false,
    "items": [
       "description": "string", {
            "departmentcodigoTributacao": {1,
                "iddescricaoTributacao": "CBS 9EXEMPLO",
                "nametipoImposto": "stringCBS",
                "fatherCategoryIdlocalConsumo": 0"BR",
                "titletipoOperacao": "A",
                "descriptiondevolucao": ""false,
                "keywordstipoEmpresa": "J",
                "lastChangecontribuinte": "1900-01-01T00:00"false,
                "updateStockGeneralorgaoPublico": truefalse,
                "typeMerchandisecst": "string00",
                "dtcreateclassificacaoTributaria": "1900-01-01T00:0002",
                "activevalorAliquota": false17,
            }"origemMercadoria": "0",
            "titletipoMercadoria": "L",
            "keywordsdataInicioVigencia": "2025-06-01T00:00:00",
            "adWordsRemarketingCodedataFimVigencia": "2025-12-31T00:00:00",
            "lastChangeativo": "2020-11-16T12:29:50"false,
            "dtcreatedataUltimaAlteracao": "19002025-0106-01T0006T10:0004:0009"
        }
   
 ],
    "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