Referência de Tipos e Enums
Valores enumerados aceitos pela API NFe/CTe Inbound.
Sumário
- EnvironmentSEFAZ
- OperationType
- MetadataResourceType
- EntityStatus
- CTeInterestedPartyRole
- Códigos de evento de manifestação de NF-e
EnvironmentSEFAZ
| Valor | Descrição |
|---|---|
"Test" | Ambiente de homologação SEFAZ — documentos sem validade fiscal |
"Production" | Ambiente de produção SEFAZ — documentos com validade fiscal real |
OperationType
| Valor | Descrição |
|---|---|
"Incoming" | Você é o destinatário (recebeu o documento) |
"Outgoing" | Você é o emitente (emitiu o documento) |
MetadataResourceType
| Valor | Descrição |
|---|---|
"productInvoice" | NF-e completa |
"productInvoiceEvent" | Evento de NF-e |
"productInvoiceSummary" | Resumo de NF-e (sem XML completo) |
"productInvoiceEventSummary" | Resumo de evento de NF-e |
"transportationInvoice" | CT-e |
"transportationInvoiceEvent" | Evento de CT-e |
EntityStatus
| Valor | Descrição |
|---|---|
"Active" | Configuração ativa — sistema monitorando |
"Inactive" | Configuração inativa — sem monitoramento |
CTeInterestedPartyRole
Papéis aceitos em InterestedPartyRoles, o filtro de webhook de CT-e (no corpo de ativação e em PUT .../transportationinvoices/webhook/filter).
| Valor | Ator no XML | Descrição |
|---|---|---|
"Taker" | ide/toma3, ide/toma03 ou ide/toma4 | Tomador do serviço de transporte |
"Sender" | infCte/rem | Remetente da carga |
"Dispatcher" | infCte/exped | Expedidor |
"Receiver" | infCte/receb | Recebedor |
"Recipient" | infCte/dest | Destinatário |
Não existe valor "All": ausência de filtro é o array vazio. O emitente (a transportadora, infCte/emit) não é filtrável — esse ator não é capturado nos metadados. Comportamento completo (incluindo fail-open e o caso Sender → webhook de saída) em Ativar via API.
Códigos de evento de manifestação de NF-e
Códigos aceitos em POST .../productinvoices/by-access-key/{accessKey}/manifestation-events. O grupo detail do corpo tem estrutura própria por código — veja Manifestar NF-e.
Manifestação do destinatário (legado):
| Código | Evento | detail |
|---|---|---|
210200 | Confirmação da Operação | Opcional (sem campos) |
210210 | Ciência da Operação | Opcional (sem campos) |
210220 | Desconhecimento da Operação | Opcional (sem campos) |
210240 | Operação não Realizada | justification obrigatória (15 a 255 caracteres) |
Destinatário — NT 2025.002-RTC:
| Código | Evento | detail |
|---|---|---|
211110 | Solicitação de apropriação de crédito presumido | — |
211120 | Destinação de item para consumo pessoal | Recusado com 400 — ver abaixo |
211124 | Perecimento, perda, roubo ou furto em transporte contratado pelo destinatário (FOB) | itens com vIBS/vCBS + controle de estoque |
211128 | Aceite de débito na apuração por emissão de nota de crédito | indAceitacao ∈ "0" / "1" |
211130 | Imobilização de item | — |
211140 | Solicitação de apropriação de crédito de combustível | — |
211150 | Solicitação de apropriação de crédito para bens/serviços vinculados à atividade | — |
Sucessora:
| Código | Evento |
|---|---|
212110 | Manifestação sobre transferência de crédito IBS em sucessão |
212120 | Manifestação sobre transferência de crédito CBS em sucessão |
Cancelamento de evento:
| Código | Evento | detail |
|---|---|---|
110001 | Cancelamento de Evento da DFe | tpEventoAut + nProtEvento |
211120 foi revogadoA revogação do §6º do art. 57 da LC 214/2025 pela LC 227/2026 tirou esse evento do ar: a SEFAZ não reconhece mais tpEvento=211120 e rejeita o lote com cStat 225 — Falha no Esquema XML. Submissões novas são recusadas com 400 antes de sair, para não gastar uma ida à SEFAZ. O código continua reconhecido na leitura de eventos já registrados.
412120 e 412130 (manifestação do Fisco sobre transferência de crédito IBS/CBS em sucessão) chegam pela distribuição, mas não podem ser submetidos: tentar enviá-los retorna 400.