Advanced Search
Search Results
1622 total results found
7 - Json de requisição
{ "Cabecalho": { "SessionID": "1", "SisOrig": "1", "DtCalc": "xxxx-xx-xx", "UfOrig": "", "UfDest": "", "CNAERem": "", "CNAEDest": "", "MunGerador": "", "MunTomador": "", "MunExcucao": "", "Generico": "", "ChaveBanco": "", "PerfilRem": "", "Perfi...
Objetivo
Ao longo do documento, são descritas as orientações necessárias para integração com as APIs REST da plataforma Systax, incluindo autenticação, endpoints, estrutura das requisições e respostas, prazos legais aplicáveis e boas práticas para utilização dos serviç...
Pré-Requisitos da integração
Para utilização das APIs de Eventos de Apuração, é necessário que o cliente esteja previamente cadastrado e habilitado na plataforma Systax DF-e, possua certificado digital A1 válido e configurado para o CNPJ destinatário, tenha permissão de acesso aos recurso...
Conceito Tributário Essencial
IBS e CBS — Reforma Tributária (EC 132/2023) A Emenda Constitucional 132/2023 instituiu dois novos tributos sobre o consumo: Tributo Substitui Competência IBS — Imposto sobre Bens e Serviços ICMS (estadual) + ISS (munici...
Autenticação
A autenticação das APIs de envio de eventos de apuração para o DF-e é feita via JWT bearer token. Para mais detalhes de como obtê-la, acesse a última versão de documentação pelo link: https://documentacao.systax.com.br/books/manual-da-api-de-geracao-de-token ...
Acessos
Swagger O Swagger é uma estrutura de software de código aberto que permite aos desenvolvedores projetar, criar, documentar e consumir serviços da Web RESTful. Esse recurso facilita o trabalho dos desenvolvedores, fazendo com que eles tenham um entendimento do...
Sobre a API de Eventos de Apuração
Ambiente Base URL PRODUÇÃO https://apidfe.systax.com.br A API de Eventos de Apuração suporta os Eventos da Reforma Tributária IBS/CBS (apuração e destinação de créditos, via API REST). Que é transmitido ao WebService NFeR...
Campos da Chamada
Campo Tipo Obrigatório Formato/Valores Descrição chave string Sim 44 dígitos Chave de acesso da NF-e vinculada ao evento. eventos array Sim Lista de códigos Lista de eventos ...
Campos do Retorno
O campo xmlRetorno contém o XML de retorno gerado pelo ambiente fiscal após o processamento do evento. Nele constam informações como ambiente, órgão autorizador, código de status, motivo do processamento, chave da NF-e, tipo de evento, data/hora de registro e ...
Eventos disponíveis
Existe uma API para cada tipo de evento da reforma tributária, com o intuito de enviar a informação para o ambiente nacional, e posteriormente receber o XML de retorno no Systax DF-e. A plataforma Systax suporta 09 tipos de eventos de apuração IBS/CBS que são...
Detalhamento por evento
Nesta seção, são apresentados os detalhes de chamada e retorno de cada evento, incluindo os campos que devem ser enviados na requisição, suas respectivas descrições e exemplos de uso. 211110 - Solicitação de Apropriação de crédito presumido Descrição: Regi...
Cancelamento do Evento de Apuração
110001 - Cancelamento de Evento Descrição: Evento utilizado para cancelar um evento de apuração anteriormente registrado e vinculado à NF-e, quando houver necessidade de desfazer ou retificar a informação transmitida. O cancelamento deve referenciar o evento ...
Boas práticas de integração
Recomenda-se que o sistema integrador armazene o identificador do evento, o protocolo de autorização, o código de status, o motivo do processamento e o XML de retorno. Essas informações são importantes para rastreabilidade, auditoria, conciliação fiscal e even...
Observações sobre prazos e regras legais
Os eventos de apuração devem observar os prazos, regras de validação, leiautes e tabelas oficiais definidos na Nota Técnica vigente da Reforma Tributária do Consumo. A Systax acompanha as atualizações legais para realizar os ajustes necessários na plataforma; ...
Tratamento de erros
Orientação prática sobre o que fazer em cada cenário de erro: Exemplo: Situação Ação recomendada Token expirado Gerar novo token e reenviar a requisição. Campo obrigatório ausente Corrigir o payload antes de reenviar....
Consulta dos Eventos de Apuração registrados
Para consultar eventos de apuração que já foram registrados e acatados pelo ambiente fiscal, o sistema integrador deve utilizar o Web Service SOAP de Download de Eventos. Esse serviço deve ser acionado quando houver necessidade de recuperar o XML do evento, va...
Request - Serviços
Para atender ao novo modelo da Reforma, foram criadas ao todo 4 novos campos: NBS CONTRACT_FROM = IBSContributor CONTRACT_FROM = CBSContributor CONTRACT_TO = IBSContributor CONTRACT_TO = CBSContributor Segue abaixo um modelo de request, com os novos...
Response - Serviços
Para atender a nova reforma tributária, foram criados 3 novos blocos, IBSUF, IBSMUN e CBS. Segue abaixo o response com os novos blocos. Serviços {"total": "187.700000000000","subTotal": "200.000000000000","totalTax": "10.000000000000","taxLines"...
Fluxo de Atendimento - Nota de Débito por Pagamento Antecipado
Fluxo de Atendimento – Nota de Débito por Pagamento Antecipado (Venda para Entrega Futura) Objetivo Definir o fluxo de cálculo e retorno de tributos para operações de Nota de Débito referente a Pagamento Antecipado, considerando os requisitos da Reforma Tr...
Consulta de Regras
A tela Consulta de Regras tem como objetivo permitir a consulta da quantidade de regras existentes no Cockpit por cenários e grupo de produtos. Por meio dessa tela, o usuário poderá visualizar: Quantas regras devem existir para o cenário. Quantas regras j...