Consultar o histórico de uma DC-e
GET/v1/subscriptions/:subscriptionId/taxpayers/:taxpayerId/contentdeclarations/:id/events
Devolve o histórico do documento, em ordem de versão.
Cada entrada diz o que aconteceu, quando, e traz os campos de negócio daquele acontecimento.
É a resposta para "por que este documento está neste estado?" — inclusive quando o estado
é Rejected ou Refused.
eventType | O que traz em data |
|---|---|
ContentDeclarationCreated | emitterType, emissionType, serie, number |
NumberDefined | number, serie, accessKey |
SentToSefaz | nada além de tipo, versão e data |
Authorized | protocol, authorizedAt |
Rejected | cStat, reason |
ContingencyAccepted | accessKey |
DaceGenerated | hasFull, hasSummary, hasXml |
CancelRequested | reason, cancellationProtocol, cStat |
Cancelled | protocol, cancelledAt, cStat |
CancelRejected | cStat, reason |
Notified | eventType (o evento notificado) |
Refused | step, reasons — em que passo a emissão parou por veredito nosso, e por quê |
FlowFailed | step, reasons |
FlowExhausted | step, reasons, attempts, cStat — o passo esgotou as tentativas |
AuthorizationNotFound | step, reasons, attempts, notFoundAnswers, cStat — a SEFAZ não encontrou a autorização; notFoundAnswers diz quantas das tentativas ela respondeu que não a tem |
ReprocessExecuted | step — o passo a partir do qual o documento voltou a andar |
📌 Os motivos de uma falha ficam aqui mesmo depois que o documento volta a andar: o
refusedStep e o refusedReasons de GET {id} são limpos nessa hora, o histórico não.
⚠️ O histórico é uma projeção curada: XML assinado e dados pessoais completos não aparecem aqui de propósito. Tipos de evento novos podem surgir, e um tipo que você não conhece vem apenas com tipo, versão e data.
Request
Responses
- 200
- 401
- 403
- 404
Histórico do documento.
Token ausente, expirado ou inválido. O token tem validade curta: ao receber 401, peça um
token novo e repita a chamada.
O token autentica, mas a assinatura da URL não é a do token (nem uma a que o usuário tem
acesso). O type é …/subscription-scope-undetermined.
Documento inexistente ou fora da assinatura e do contribuinte da URL — ou contribuinte
inexistente ou de outra assinatura, com type …/company-not-in-subscription.