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 interativaLista 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
| Nome | Onde | Tipo | Descrição |
|---|---|---|---|
| id obrigatório | caminho | string | Id do CT-e, devolvido no campo |
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
- 200: Eventos do CT-e (lista vazia se não houver nenhum).
- 401: Token ausente, errado ou revogado (credencialinvalida). Confira o cabeçalho Authorization. (formato de erro)
- 404: ctenaoencontrado — não existe, ou é de outra empresa. (formato de erro)
Campos da resposta 200
| Campo | Tipo | Descrição | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| dados obrigatório | array de object | |||||||||
| dados[] obrigatório | string |
| ||||||||
| dados[] obrigatório | integer | Número do evento desse tipo no CT-e (a 1ª carta de correção é 1, a 2ª é 2...). | ||||||||
| dados[] obrigatório | string |
| ||||||||
| dados[] | string ou null | Só no cancelamento. | ||||||||
| dados[] | array de object | Só na carta de correção. | ||||||||
| dados[] obrigatório | string | Grupo do XML onde está o campo (ex. | ||||||||
| dados[] obrigatório | string | Nome da tag a corrigir dentro do grupo (ex. | ||||||||
| dados[] obrigatório | string | O valor correto. | ||||||||
| dados[] | string | Só quando o grupo se repete no XML — qual ocorrência corrigir (começa em | ||||||||
| dados[] | string ou null | Protocolo do evento na SEFAZ, quando registrado. | ||||||||
| dados[] | object | Última resposta da SEFAZ, como ela mandou. Útil para entender uma rejeição. | ||||||||
| dados[] | integer ou null | Código de resposta da SEFAZ (ex. | ||||||||
| dados[] | string ou null | Texto da SEFAZ que explica o código. | ||||||||
| dados[] | string ou null | Número do protocolo da SEFAZ, quando houver. | ||||||||
| dados[] obrigatório | string (date-time) | Data e hora no horário de Brasília (ex. | ||||||||
| dados[] | string (date-time) ou null |