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
- Códigos de evento de CT-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.
Códigos de evento de CT-e
Tipos de evento (tpEvento) de CT-e entregues pela distribuição. Todos chegam no webhook transportation_invoice_inbound com action = event_raised_successfully: o CT-e não tem a separação de manifestação que a NF-e tem.
| Código | Evento |
|---|---|
110110 | Carta de Correção CT-e |
110111 | Cancelamento de CT-e |
110113 | EPEC |
110160 | Registro Multimodal |
110170 | Informações da GTV |
110180 | Comprovante de Entrega do CT-e |
110181 | Cancelamento do Comprovante de Entrega do CT-e |
110190 | Insucesso na Entrega do CT-e |
110191 | Cancelamento do Insucesso de Entrega do CT-e |
310610 | MDF-e Autorizado (registrado pelo fisco) |
310611 | MDF-e Cancelado (registrado pelo fisco) |
610110 | Prestação de Serviço em Desacordo |
610111 | Cancelamento Prestação do Serviço em Desacordo |
As descrições de 110113 a 110191 e de 610111 são o descEvento dos schemas de evento do CT-e (leiaute 4.00). O EPEC do CT-e é 110113; 110140 é o EPEC da NF-e.
310610 e 310611 não são emitidos pelas partes do CT-e: o fisco registra o evento no CT-e quando um MDF-e que o referencia é autorizado ou cancelado.
O webhook de CT-e não tem campo com o código do evento. O código são os 6 dígitos logo após o prefixo ID do identificador do evento (accessKey no webhook, event_key na rota de XML). Veja Baixar XML de um evento de CT-e.