Eventos Fiscais (Cancelamento e CC-e)
Após a autorização de um documento fiscal na SEFAZ, qualquer retificação ou anulação deve ser registrada por meio de um Evento Fiscal assinado digitalmente.
POST Cancelar Documento Fiscal
Homologa o cancelamento do documento perante a SEFAZ ou portal nacional.
POST /api/v1/invoices/:id/cancel
Parâmetros da Requisição
:id(Path): Identificador interno da nota ou Chave de Acesso (44 dígitos).
bash
curl --request POST \
--url http://localhost:3333/api/v1/invoices/clt1983hx0001va93jflam789/cancel \
--header 'Content-Type: application/json' \
--header 'x-api-key: fylee_live_...' \
--data '{
"justificativa": "Cancelamento solicitado pelo cliente antes do despacho das mercadorias"
}'json
{
"status": "CANCELADA",
"cStat": 101,
"xMotivo": "Cancelamento de NF-e homologado",
"protocolo": "135260000099881",
"dataCancelamento": "2026-10-07T10:45:00.000Z"
}REGRAS DA SEFAZ
A justificativa deve conter no mínimo 15 caracteres e o cancelamento deve ocorrer dentro do prazo legal permitido pela SEFAZ do seu estado (geralmente 24h para NF-e).
POST Registrar Carta de Correção (CC-e)
Registra uma retificação textual de dados não tributários em uma nota fiscal já autorizada.
POST /api/v1/invoices/:id/cce
bash
curl --request POST \
--url http://localhost:3333/api/v1/invoices/clt1983hx0001va93jflam789/cce \
--header 'Content-Type: application/json' \
--header 'x-api-key: fylee_live_...' \
--data '{
"correcao": "O endereco de entrega correto e Rua das Acacias, 450, Bairro Jardim das Flores, CEP 01234000."
}'json
{
"cStat": 135,
"xMotivo": "Evento registrado e vinculado a NF-e",
"sequenciaEvento": 1,
"protocolo": "135260000088771"
}