Consultar o retorno de um Evento da Reforma Tributária v2

Esta rota é utilizada para consultar o resultado do processamento dos eventos da Reforma Tributária do Consumo enviados ao PlugStorage.

A consulta pode retornar o último evento, o último evento autorizado ou todos os eventos vinculados a uma NF-e, conforme os filtros informados na querystring.

GET

Utilize o método GET para consultar eventos da Reforma Tributária do Consumo.

https://app.plugstorage.com.br/api/v2/eventos/index?token=Token&invoice_key=InvoiceKey

Querystring

Os parâmetros token e invoice_key são obrigatórios. Os demais campos podem ser utilizados para refinar a consulta.

Headers

Filtros de consulta

Os filtros abaixo ajudam a definir qual retorno será apresentado pela API.

• filter_type=all: retorna todos os eventos RTC vinculados ao documento.
• filter_type=last: retorna o último evento RTC de cada tipo.
• filter_type=last_authorized: retorna o último evento RTC autorizado de cada tipo.

Para consultar um evento cancelado, informe o código do evento original em filter_event e utilize status=CANCELADO.

Observações sobre o filtro status:

• AUTORIZADO: retorna apenas eventos normais autorizados.
• REJEITADO: retorna eventos normais e eventos de cancelamento que foram rejeitados.
• CANCELADO: retorna apenas eventos de cancelamento autorizados.

Retorno da API

Exemplo de retorno de validação:

{
 "error": true,
 "message": "Parâmetro "invoice_key" não informado ou inválido."
}

{
 "error": true,
 "message": "Parâmetro 'filter_type' inválido. Valores aceitos: 'last_authorized', 'all' ou 'last'."
}

Exemplo de retorno de evento:

{
    "error": false,
    "status": "success",
    "message": "Evento RTC encontrado.",
    "data": {
        "id": "1",
        "invoice_id": "1",
        "invoice_mod": "EVENTO",
        "invoice_key": "41190218582206000132558040000003281000000011",
        "softwarehouse_id": "1",
        "user_id": "1",
        "type": "E211140",
        "datetime": "2026-08-24 15:08:58",
        "status": "SUCCESS",
        "environment": "2",
        "created_at": "2026-08-21 15:41:04",
        "status_description": "Evento registrado e vinculado a NF-e",
        "date_emission": null,
        "cstat": "135"
    }
}

Exemplo de retorno com filter_type=all

{
    "error": false,
    "status": "success",
    "message": "Evento RTC encontrado.",
    "data": {
        "events": [
            {
                "id": "1",
                "invoice_key": "41190218582206000132558040000003281000000011",
                "softwarehouse_id": "1",
                "user_id": "1",
                "type": "E211110",
                "protocol": "0",
                "sequence": "1",
                "status_description": "Rejeicao: Duplicidade de Evento",
                "event_date": "2026-07-28 10:46:46",
                "created_at": "2026-07-28 13:47:36",
                "invoice_mod": "NFE",
                "status": "ERROR"
            },
            {
                "id": "2",
                "invoice_key": "41190218582206000132558040000003281000000011",
                "softwarehouse_id": "1",
                "user_id": "1",
                "type": "E211110",
                "protocol": "0",
                "sequence": "2",
                "status_description": "Rejeicao: Duplicidade de Evento",
                "event_date": "2026-07-28 10:50:39",
                "created_at": "2026-07-28 13:51:09",
                "invoice_mod": "NFE",
                "status": "ERROR"
            },
            {
                "id": "3",
                "invoice_key": "41190218582206000132558040000003281000000011",
                "softwarehouse_id": "1",
                "user_id": "1",
                "type": "E211110",
                "protocol": "000000000000000",
                "sequence": "10",
                "status_description": "Evento registrado e vinculado a NF-e",
                "event_date": "2026-07-28 10:54:10",
                "created_at": "2026-07-28 13:56:02",
                "invoice_mod": "NFE",
                "status": "SUCCESS"
            }
        ],
        "nextPage": true
    }
}

Exemplo de retorno com erro

{
    "error": true,
    "message": "Evento RTC não encontrado."
}

Documentações de apoio:

• Rota V2 para enviar Eventos da Reforma Tributária do Consumo
• Rota V2 para enviar cancelamento de eventos da Reforma Tributária do Consumo
• Nota Técnica 2025.002