Esta rota é utilizada para enviar os eventos relacionados à Reforma Tributária do Consumo. Todos os eventos são enviados para o mesmo endpoint do PlugStorage.
Para facilitar a leitura e evitar repetição, a documentação está organizada em duas partes:
- Estrutura comum do body: campos enviados em todos os eventos.
-
Campos específicos por evento: campos adicionais que variam conforme o código do evento informado em
type.
POST
Utilize o método POST para enviar eventos da Reforma Tributária do Consumo ao PlugStorage.
https://app.plugstorage.com.br/api/v2/eventos
Headers
| Nome | Valor |
| authorization | Basic encode64(token da software house : senha da software house)== |
| Content-Type | application/x-www-form-urlencoded ou application/json |
Estrutura comum do Body
Todos os eventos compartilham a mesma estrutura inicial de body. Esses campos identificam o evento, a NF-e vinculada, o ambiente de envio e a sequência.
Depois de preencher os campos comuns, complemente o body com os campos específicos do evento desejado, descritos na seção Eventos disponíveis.
| Nome | Descrição | Obrigatório | Detalhes |
|---|---|---|---|
| type | Código do evento que será enviado. | Sim |
Valores Aceitos: |
| invoice_key | Chave da NF-e à qual o evento será vinculado. | Sim | Informe a chave de acesso da NF-e. |
environment |
Ambiente em que o evento será enviado | Sim |
Valores Aceitos:
|
sequence |
Número sequencial do evento. | Sim | Informe a sequência correspondente ao envio. |
| cnpj_cpf | CNPJ/CPF do emissor do evento. | Sim | Informe o CNPJ/CPF do emissor do evento. |
Exemplo da estrutura comum
{
"type": "E211150",
"invoice_key": "41260200000000000000550000000000000000000000",
"environment": "2",
"sequence": 1
// incluir aqui os campos específicos do evento
}
Eventos disponíveis
As seções abaixo apresentam apenas os campos específicos de cada evento. Esses campos devem ser enviados junto com a estrutura comum do body.
Evento E211110 - Solicitação de Apropriação de crédito presumido
Função: Evento a ser gerado pelo destinatário da NF-e em relação às notas fiscais de aquisição de emissão de terceiros e que lhe gerem o direito à apropriação de crédito presumido, ou pelo emitente quando a informação não tiver sido incluída na NF-e ou necessitar correção.
Autor: Emitente ou Destinatário da NFe
Modelo: NF-e modelo 55
| infos | Array de 1 a 990 itens | Obrigatório |
| item_number | Corresponde ao atributo “nItem” do elemento “det” do documento referenciado | Sim |
| base_value_item | Valor do base de cálculo do item | Sim |
presumed_code |
Código de Classificação do Crédito presumido, conforme tabela cCredPres | Sim |
ibs_percentage |
Percentual do Crédito Presumido IBS | Sim |
| ibs_value | Valor do Crédito Presumido IBS | Sim |
| cbs_percentage | Percentual do Crédito Presumido CBS | Sim |
| cbs_value | Valor do Crédito Presumido CBS | Sim |
Exemplo dos campos específicos
Campos específicos do evento:
"infos": [
{
"item_number": "1",
"base_value_item": "2",
"presumed_code": "01",
"ibs_percentage": "1.00",
"ibs_value": "100.00",
"cbs_percentage": "10.00",
"cbs_value": "10.00"
}
]
Evento E211124 - Perecimento, perda, roubo ou furto durante o transporte contratado pelo adquirente
Função: Permitir ao adquirente informar quando uma aquisição for objeto de roubo, perda, furto ou perecimento.
Observação: O evento atual está relacionado aos bens que foram objeto de perecimento, perda, roubo ou furto em trânsito, em fornecimentos com frete FOB.
Modelo: NF-e modelo 55
Autor do Evento: Destinatário da NF-e em notas de saída
| infos | Array de 1 a 990 itens | Obrigatório |
| item_number | Corresponde ao atributo “nItem” do elemento “det” do documento referenciado | Sim |
ibs_value |
Valor do IBS na Nota de Aquisição correspondente à quantidade que foi objeto de roubo, perda, furto ou perecimento | Sim |
cbs_value |
Valor da CBS na Nota de Aquisição correspondente à quantidade que foi objeto de roubo, perda, furto ou perecimento | Sim |
quantities |
Informar a quantidade que foi objeto de roubo, perda, furto ou perecimento | Sim |
unit |
Informar a unidade relativa ao campo: quantidadePerecimento | Sim |
Exemplo dos campos específicos
Campos específicos do evento:
"infos": [
{
"item_number": "1",
"ibs_value": "2.00",
"cbs_value": "3.00",
"quantities": "4",
"unit": "5"
}
]
Evento E211128 - Aceite de débito na apuração por emissão de nota de crédito
Função: Permitir ao destinatário informar que concorda com os valores constantes em nota de crédito emitida pelo fornecedor ou pelo adquirente que serão lançados a débito na apuração assistida de IBS e CBS
Modelo: NF-e modelo 55
Autor do Evento: Destinatário da NF-e
indAcceptance |
Indicador de concordância com o valor da nota de crédito que lançaram IBS e CBS na apuração assistida. Valores: 0 = não aceite 1 = aceite. |
|
Exemplo dos campos específicos
Campos específicos do evento: "indAcceptance": 0
Evento E211130 - Imobilização de Item
Função: Evento a ser gerado pelo adquirente de bem, quando este for integrado ao seu ativo imobilizado, a fim de viabilizar a adequada identificação, pelos sistemas da administração tributária, de prazo-limite para apreciação de eventuais pedidos de ressarcimento do respectivo crédito, nos termos do art. 40, I da LC 214/2025.
Modelo: NF-e modelo 55
Autor do Evento: Destinatário da NF-e (Adquirente)
| infos | Array de 1 a 990 itens | Obrigatório |
| item_number | Corresponde ao atributo “nItem” do elemento “det” do documento referenciado | Sim |
ibs_value |
Valor do IBS na Nota de Aquisição correspondente à quantidade que foi objeto de roubo, perda, furto ou perecimento | Sim |
cbs_value |
Valor da CBS na Nota de Aquisição correspondente à quantidade que foi objeto de roubo, perda, furto ou perecimento | Sim |
quantities |
Informar a quantidade que foi objeto de roubo, perda, furto ou perecimento | Sim |
unit |
Informar a unidade relativa ao campo: quantidadePerecimento | Sim |
Exemplo dos campos específicos
Campos específicos do evento:
"infos": [
{
"item_number": "1",
"ibs_value": "2.00",
"cbs_value": "3.00",
"quantities": "4",
"unit": "5"
}
]
Evento E211140 - Solicitação de Apropriação de Crédito de Combustível
Função: Evento a ser gerado pelo adquirente de combustível listado no art. 172 da LC 214/2025 e que pertença à cadeia produtiva desses combustíveis, para solicitar a apropriação de crédito referente à parcela que for consumida em sua atividade comercial, observada exceção do art. 180 da LC 214/2025.
Modelo: NF-e modelo 55
Autor do Evento: Destinatário da NF-e (Adquirente de combustível que faça parte da cadeia produtiva de combustíveis)
| infos | Array de 1 a 990 itens | Obrigatório |
| item_number | Corresponde ao atributo “nItem” do elemento “det” do documento referenciado | Sim |
ibs_value |
Valor do IBS na Nota de Aquisição correspondente à quantidade que foi objeto de roubo, perda, furto ou perecimento | Sim |
cbs_value |
Valor da CBS na Nota de Aquisição correspondente à quantidade que foi objeto de roubo, perda, furto ou perecimento | Sim |
quantities |
Informar a quantidade que foi objeto de roubo, perda, furto ou perecimento | Sim |
unit |
Informar a unidade relativa ao campo: quantidadePerecimento | Sim |
Exemplo dos campos específicos
Campos específicos do evento:
"infos": [
{
"item_number": "1",
"ibs_value": "2.00",
"cbs_value": "3.00",
"quantities": "4",
"unit": "5"
}
]
Evento E211150 - Solicitação de Apropriação de Crédito para bens e serviços que dependem de atividade do adquirente
Função: Evento a ser gerado pelo adquirente para apropriação de crédito de bens e serviços que dependam da sua atividade
Modelo: NF-e modelo 55
Autor do Evento: Destinatário da NFe (adquirente).
| infos | Array de 1 a 990 itens | Obrigatório |
item_number |
Corresponde ao atributo “nItem” do elemento “det” do documento referenciado | Sim |
| ibs_value | Valor da solicitação de crédito a ser apropriado de IBS | Sim |
| cbs_value | Valor da solicitação de crédito a ser apropriado de CBS | Sim |
Exemplo dos campos específicos
Campos específicos do evento:
"infos": [
{
"item_number": "1",
"ibs_value": "2.00",
"cbs_value": "3.00"
}
]
Evento E212110 - Manifestação sobre Pedido de Transferência de Crédito de IBS em Operações de Sucessão
Função: Evento a ser gerado pela sucessora em relação às notas fiscais de transferência de crédito de outra sucessora da mesma empresa sucedida
para informar aceite da transferência de crédito de IBS.
Autor: Empresa sucessora
Modelo: NF-e modelo 55
indAcceptance |
Indicador de concordância com o valor da nota de crédito que lançaram IBS e CBS na apuração assistida. Valores: 0 = não aceite 1 = aceite. |
|
Exemplo dos campos específicos
Campos específicos do evento: "indAcceptance": 0
Retorno
Exemplo de retorno NF-e:
{
"error": false,
"status": "success",
"message": "Seu pedido foi realizado com sucesso, estamos processando o evento.",
"data": {
"invoice_key": "41260200000000000000550000000000000000000000"
}
}
Documentações de apoio:
- Consultar o retorno de um Evento da Reforma Tributária v2
- Rota V2 para enviar cancelamento de eventos da Reforma Tributária do Consumo
- Nota Técnica 2025.002
Comentários
0 comentário
Por favor, entre para comentar.