Vale a pena relembrar
Vale a pena relembrar
API
API: Uso do ponteiro e paginação - API Consumo de Regras
Por Rafael Sena
O vídeo mostra como funciona a utilização do ponteiro e da paginação na API de consumo de regras.
Para saber mais, assista o vídeo abaixo:
Uso do ponteiro e paginação - API Consumo de Regras
API Status de cenário
Por Pedro Silva
A API Status de cenário permite você realizar consultas dos cenários que foram cadastrados, a fim de informar um status dele, quanto à vinculação à base centralizada. A API Status de cenário, traz esta informação detalhada, informando o motivo pelo qual o cenário não foi vinculado, desta forma o cliente ou parceiro pode identificar e corrigir, via integração, alguns dos possíveis erros de cadastro, sem que seja necessário o acionamento e análise de um consultor Systax.
Como realizar a consulta?
- O usuário deverá realizar a autenticação da API via Bearer Token, utilizando o usuário e senha fornecidos pela Systax.
- Após a autenticação, a consulta é realizada pelo ID do cenário, que é gerado pela Systax após o cadastro do cenário, o ID do cenário deve ser informado no final da URL, conforme print abaixo.
- A API vai retornar uma mensagem de sucesso, caso o cenário esteja vinculado à Base Centralizada, conforme print abaixo.
- Caso o cenário não esteja vinculado, a API traz a mensagem de erro, e acrescenta a tag “motivo”, que traz mais informações do cenário que não foi vinculado, em nossa documentação temos uma lista com todos os códigos e detalhamento dos possíveis erros.
Os erros não detalhados previamente na API, retorna com o motivo "outros", caso isso aconteça, a análise de um consultor será necessária.
URL da documentação:
https://documentacao.systax.com.br/PublicView2/Index/3fde1934d71bc70b719d9a81e/56528
A importância deste documento é demonstrar, de forma prática, como realizar uma consulta de um cenário cadastrado, a fim de verificar se este cenário foi vinculado à Base Centralizada. Para clientes de Base Centralizada, isso é muito importante, pois sem esse vínculo não haverá geração de regras.
Diagnóstico e Tax Validator – Determinação de Perfil
Por Carlos Cornejo
No Diagnóstico temos a função da Determinação de Perfil, que é extremamente importante na funcionalidade da ferramenta, uma vez que ela define o cenário que será usado para gerar a regra.
A tabela com os perfis cadastrados encontra-se no seguinte caminho:
https://diagnosticofiscal.systax.com.br/app/login
A Determinação de Perfil possui 27 campos que possuem as seguintes funcionalidades:
- ID: Indica o ID de registro do perfil cadastrado. Segue uma ordem crescente de acordo com a criação (1, 2, 3, 4...). É gerado automaticamente ao criar a linha.
- ID Config: Indica o número do cenário do cliente
- Identificador: Não preencher, campo sem impacto no retorno.
- UF Origem: Indica a UF do remetente na operação. Informação encontra-se na nota
- UF Destino: Indica a UF do destinatário na operação. Informação encontra-se na nota
- Natureza Operação: Indica o código que identifica a descrição da operação comercial (o que será feito com a mercadoria ou serviço prestado). Que é definida a partir da informação do CFOP que será colocado na determinação do perfil. Ex: CFOP 5101 (Para esse CFOP a definição é Natureza de Operação = 120. Então de acordo com o CFOP do exemplo o correto nesse caso é cadastrar o perfil com a Natureza de Operação 120. Além disso ela também deve ser compatível com os perfis do cenário. Ainda no nosso exemplo, com a natureza de operação 120 o perfil de origem obrigatoriamente deve ser indústria, produtor, etc).
- Finalidade: Indica a finalidade da operação (Importante: Esse campo será preenchido somente em operações de entrada). É a finalidade que define qual o objetivo da aquisição da mercadoria e essa informação define o crédito da operação. Ex: Finalidade 220: Compra para ativo, Finalidade 43: Compra para uso e consumo, Finalidade 569: Compra para comercialização
- Perfil remetente: Informa o código do perfil do remetente na operação. Para definir o perfil do remetente é necessário verificar a natureza de operação utilizada na determinação, conforme explicado mais acima e o CFOP indicado na determinação
- Perfil Destinatário: Informa o código do perfil do destinatário na operação. Para definir o perfil do destinatário é necessário verificar a natureza de operação utilizada na determinação, conforme explicado mais acima e o CFOP indicado na determinação, necessário estar compatível com os campos indFinal e indIEDest.
- Ent Sai: Indica se é uma operação de entrada ou saída (0 = Entrada / 1 = Saída). Essa informação encontra-se na nota
- CFOP: Informa o código do CFOP na operação. Essa informação é peça fundamental na determinação de perfil, pois na validação para definir os perfis para criar um cenário a definição se dá pelo CFOP do documento. E a partir do CFOP será definidos perfis de origem e destino e natureza de operação, por exemplo. Essa informação encontra-se na nota
- CNPJ Destino: Informa o CNPJ do destinatário na operação. Essa informação encontra-se na nota
- CNPJ Origem: Informa o CNPJ do remetente na operação. Essa informação encontra-se na nota
- CRT Emit: Indica o código de regime tributário do emitente na operação (1 = Simples Nacional / 3 = Regime Normal). Essa informação encontra-se na nota
- indFinal: Indica se a operação é ou não com consumidor final (0 = Quando a operação não for realizada com consumidor final / 1 = Quando a operação for realizada com consumidor final). Essa informação encontra-se na nota
- Modelo: Indica o modelo da Nota Fiscal (Ex: 55 – Nota Fiscal Eletrônica). Essa informação encontra-se no documento.
- CPF Dest: Indica o CPF do Destinatário na operação e é utilizado somente para operações com consumidor final não contribuinte. Para casos em que se aplica a informação está disponível.
- ICMS modBCST: Campo sem impacto no retorno, não deve ser preenchido
- Código Município Destino: Indica o código do município do destinatário na operação. Informação disponível na nota
- ID Cliente: Trata-se do código gerado ao criar o cadastro do cliente. É o ID de identificação dele. Deve ser informado caso a determinação do perfil seja aplicada somente para ele. Em casos em que poderá ser aplicada a qualquer cliente não precisa de preenchimento.
- Código Município Origem: Indica o código do município do remetente na operação. Informação disponível na nota
- indIEDest: Indica se a operação tem como destinatário um Consumidor Final não contribuinte (1 = Contribuinte ICMS pagamento à vista / 2 = Contribuinte isento de inscrição / 9 = Não contribuinte). Informação disponível na nota
- Código produto: Indica o código do produto, para casos em que a determinação do perfil seja aplicada somente para um produto específico. Usado para CT-e.
- Tipo CTe: Indica o código do Conhecimento de Transporte Eletrônico, para os casos em que seja aplicável. Essa informação trabalha em conjunto com o Modal e o Tipo Serviço para busca da regra. A informação é encontrada no CTe
- Modal: Indica a modalidade do transporte realizado. Essa informação trabalha em conjunto com o Tipo CTe e o Tipo serviço para busca da regra. Informação encontrada no CTe
- Tipo serviço: Indica a modalidade do serviço realizado. Essa informação trabalha em conjunto com o Tipo CTe e o Modal para busca da regra. Informação encontrada no CTe
- Origem produto: Indica a Origem do produto (nacional ou importado), seguindo os códigos da tabela de Origens de Produtos. Informação disponível na nota. Sendo:
0 – Nacional, exceto as indicadas nos códigos 3, 4, 5 e 8
1 - Estrangeira => Importação direta, exceto a indicada no código 6
2 - Estrangeira => Adquirida no mercado interno, exceto a indicada no código 7
3 - Nacional, mercadoria ou bem com Conteúdo de Importação superior a 40% e inferior ou igual a 70%
4 - Nacional, cuja produção tenha sido feita em conformidade com os PPB de que tratam as legislações citadas nos Ajustes
5 - Nacional, mercadoria ou bem com Conteúdo de Importação inferior ou igual a 40%
6 - Estrangeira => Importação direta, sem similar nacional, constante em lista da CAMEX e gás natural
7 - Estrangeira => Adquirida no mercado interno, sem similar nacional, constante em lista da CAMEX e gás natural
8 - Nacional, mercadoria ou bem com Conteúdo de Importação superior a 70%
Dentro da funcionalidade dos Perfis, existe a possibilidade de realizar filtros, para buscas mais específicas com linhas que já foram criadas:
Para inserir uma nova linha de perfil, é necessário acessar o botão “Adicionar Novo”:
Para casos de cadastro de mais de uma linha, é possível importar um arquivo no formato .xlsx, seguindo o layout modelo disponibilizado dentro da própria ferramenta. Com isso basta preencher as informações necessárias, salvar o arquivo e realizar a importação:
Para visualização das linhas cadastradas existe a possibilidade de baixar um relatório em excel:
Conclusão
A funcionalidade da Determinação de Perfil é peça fundamental no funcionamento do Diagnóstico e Tax Validator, pois é através dela que o sistema vai definir o cenário que será usado na criação da regra.
Com essas informações será possível gerar um relatório com as análises da Systax de forma assertiva