Weesy Docs

Cancelamento e carta de correção do CT-e

Listar eventos do CT-e

GET https://apifiscal.weesy.com.br/v1/cte/{id}/eventos

Abrir na referência interativa

Lista os cancelamentos e cartas de correção pedidos para o CT-e, do mais antigo para o mais novo, com a resposta da SEFAZ de cada um.

Parâmetros

NomeOndeTipoDescrição
id
obrigatório
caminhostring

Id do CT-e, devolvido no campo id quando você emitiu.

Exemplo de chamada

cURL

curl --request GET \
  --url "https://apifiscal.weesy.com.br/v1/cte/6ade6278e8340a492a46b564/eventos" \
  --header "Authorization: Bearer $WEESY_TOKEN"

Node.js

const resposta = await fetch("https://apifiscal.weesy.com.br/v1/cte/6ade6278e8340a492a46b564/eventos", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.WEESY_TOKEN}`,
  },
});
console.log(resposta.status, await resposta.text());

Python

import os

import requests

resposta = requests.get(
    "https://apifiscal.weesy.com.br/v1/cte/6ade6278e8340a492a46b564/eventos",
    headers={"Authorization": f"Bearer {os.environ['WEESY_TOKEN']}"},
    timeout=30,
)
print(resposta.status_code, resposta.text)

PHP

<?php

$contexto = stream_context_create(["http" => [
    "method" => "GET",
    "header" => implode("\r\n", ["Authorization: Bearer " . getenv("WEESY_TOKEN")]),
    "ignore_errors" => true, // lê o corpo também nas respostas de erro
]]);
$resposta = file_get_contents("https://apifiscal.weesy.com.br/v1/cte/6ade6278e8340a492a46b564/eventos", false, $contexto);
echo $http_response_header[0], PHP_EOL, $resposta, PHP_EOL;

C#

using System.Net.Http.Headers;

using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("WEESY_TOKEN"));

using var resposta = await http.GetAsync("https://apifiscal.weesy.com.br/v1/cte/6ade6278e8340a492a46b564/eventos");
Console.WriteLine($"{(int)resposta.StatusCode} {await resposta.Content.ReadAsStringAsync()}");

Respostas

Campos da resposta 200

CampoTipoDescrição
dados
obrigatório
array de object
dados[].tipo
obrigatório
string
ValorSignificado
cancelamentoPedido de cancelamento
carta_correcaoCarta de correção
dados[].sequencia
obrigatório
integer

Número do evento desse tipo no CT-e (a 1ª carta de correção é 1, a 2ª é 2...).

dados[].situacao
obrigatório
string
ValorSignificado
processandoEnviado à SEFAZ; aguardando a resposta
registradoA SEFAZ aceitou o evento
rejeitadoA SEFAZ recusou — veja sefaz.mensagem
dados[].justificativastring ou null

Só no cancelamento.

dados[].correcoesarray de object

Só na carta de correção.

dados[].correcoes[].grupoAlterado
obrigatório
string

Grupo do XML onde está o campo (ex. compl, ide, rem).

dados[].correcoes[].campoAlterado
obrigatório
string

Nome da tag a corrigir dentro do grupo (ex. xObs).

dados[].correcoes[].valorAlterado
obrigatório
string

O valor correto.

dados[].correcoes[].numeroItemAlteradostring

Só quando o grupo se repete no XML — qual ocorrência corrigir (começa em 1).

dados[].protocolostring ou null

Protocolo do evento na SEFAZ, quando registrado.

dados[].sefazobject

Última resposta da SEFAZ, como ela mandou. Útil para entender uma rejeição.

dados[].sefaz.cStatinteger ou null

Código de resposta da SEFAZ (ex. 100 = autorizado; 2xx/5xx/6xx = rejeição).

dados[].sefaz.mensagemstring ou null

Texto da SEFAZ que explica o código.

dados[].sefaz.protocolostring ou null

Número do protocolo da SEFAZ, quando houver.

dados[].solicitadoEm
obrigatório
string (date-time)

Data e hora no horário de Brasília (ex. 2026-10-26T09:27:34-03:00).

dados[].registradoEmstring (date-time) ou null
← Voltar ao início