Referência de Tipos e Enums
Valores enumerados aceitos pela API NFe/CTe Inbound.
Sumário
- EnvironmentSEFAZ
- OperationType
- MetadataResourceType
- EntityStatus
- Direction
- CTeInterestedPartyRole
- Códigos de evento de manifestação de NF-e
- Status do 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 — liberado pela SEFAZ só após a manifestação) |
"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 |
Direction
Campo direction do NFeMetadataResource (metadados e webhook de NF-e).
| Valor | Descrição |
|---|---|
"Received" | Nota recebida de terceiro |
"Issued" | Nota emitida pela própria empresa que retornou na distribuição |
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) — sem ela, 400 na submissão |
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 | Sempre recusado com 400 — removido na NT 2025.002-RTC v1.40, 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 removidoO evento saiu da NT 2025.002-RTC na versão 1.40. A 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.
Status do evento de manifestação de NF-e
Campo status do evento devolvido por POST .../manifestation-events (e pelo legado POST /manifest). O processamento é assíncrono e não há webhook de conclusão: acompanhe por polling em GET .../productinvoices/manifestation-events/{id}.
| Valor | Significado | errorCode |
|---|---|---|
"Pending" | Na fila, ainda não concluído | — |
"Accepted" | Registrado na SEFAZ: cStat 135/136, ou 573 (duplicidade, tratada como sucesso idempotente) | — |
"Rejected" | Recusado pela SEFAZ (qualquer outro cStat, inclusive 596, evento fora do prazo) ou na montagem do XML | BadRequest (SEFAZ) ou VALIDATION (montagem) |
"Failed" | Falha antes do envio | CERT_NOT_FOUND, CERT_LOAD_FAILED, CERT_EXPIRED, COMPANY_NOT_FOUND, AUTOR_UF_UNRESOLVED, STRATEGY_NOT_FOUND ou MAX_ATTEMPTS_EXCEEDED |
Rejected e Failed permitem nova submissão; Pending e Accepted bloqueiam a repetição da mesma (accessKey, eventCode, nSequencia) com 409. errorMessage é texto livre — não faça parsing dele.