Conciliação Financeira (e-CONF)

POST/v1/nfe/{id}/econf

Registra o evento de Conciliação Financeira / e-CONF (Nota Técnica 2024.002) de uma NF-e, detalhando os pagamentos efetivamente recebidos pelo emitente para o documento. O evento é roteado via SVRS (cOrgao=92).

Só se aplica a documentos com mod 55 (NF-e) que já estejam AUTORIZADA.

Esse é um evento síncrono — a resposta HTTP já traz o resultado da SEFAZ, sem necessidade de polling.

Parâmetros do corpo

detalhes_pagamentoarrayobrigatório

Lista dos pagamentos recebidos referentes ao documento fiscal.

indicador_pagamentostring | number

Indicador da forma de integração do pagamento (à vista, financiado, etc.).

forma_pagamentostring | numberobrigatório

Código da forma de pagamento (tabela SEFAZ, ex.: 17 para pagamento eletrônico não informado).

descricao_pagamentostring

Descrição livre da forma de pagamento.

valor_pagamentostring | numberobrigatório

Valor do pagamento.

data_pagamentostringobrigatório

Data do pagamento (formato AAAA-MM-DD).

cnpj_transacionalstring

CNPJ da instituição transacional (adquirente/subadquirente).

uf_transacionalstring

UF da instituição transacional.

cnpj_instituicao_financeirastring

CNPJ da instituição financeira responsável pelo pagamento.

bandeira_operadorastring

Bandeira da operadora do cartão, quando aplicável.

numero_autorizacaostring

Número de autorização da transação.

cnpj_beneficiariostring

CNPJ do beneficiário do pagamento.

uf_beneficiariostring

UF do beneficiário do pagamento.

Resposta

200 OK / 201 Created

statusstring

Valores aceitos: autorizado | erro_autorizacao

Resultado do registro junto à SEFAZ.

status_sefazstring

Código de status retornado pela SEFAZ (cStat).

mensagem_sefazstring

Mensagem retornada pela SEFAZ (xMotivo).

caminho_xml_conciliacao_financeirastring

URL pública do XML do evento, quando autorizado.

numero_conciliacao_financeiranumber

Número sequencial do evento de e-CONF registrado para este documento.

numero_protocolostring

Número de protocolo do e-CONF, usado para consultá-lo ou cancelá-lo depois.

cURL

curl -X POST https://app.nfe.tenzanlabs.com/v1/nfe/35f0a1b2-.../econf \
  -H "X-Access-Key: nfe_access_SUA_CHAVE_DE_ACESSO_AQUI" \
  -H "Authorization: Bearer nfe_test_SUA_CHAVE_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "detalhes_pagamento": [
      {
        "forma_pagamento": "17",
        "valor_pagamento": "150.00",
        "data_pagamento": "2026-08-19"
      }
    ]
  }'

Node.js

const resposta = await client.registerEconf(invoiceId, {
  detalhes_pagamento: [
    {
      forma_pagamento: '17',
      valor_pagamento: '150.00',
      data_pagamento: '2026-08-19',
    },
  ],
});
console.log(resposta.status); // 'autorizado'

Python

resposta = client.register_econf(invoice_id, {
    "detalhes_pagamento": [
        {
            "forma_pagamento": "17",
            "valor_pagamento": "150.00",
            "data_pagamento": "2026-08-19",
        },
    ],
})
print(resposta["status"])  # 'autorizado'

Java

EconfPaymentDetail pagamento = new EconfPaymentDetail();
pagamento.forma_pagamento = "17";
pagamento.valor_pagamento = "150.00";
pagamento.data_pagamento = "2026-08-19";

RegisterEconfData data = new RegisterEconfData();
data.detalhes_pagamento = List.of(pagamento);

SyncEventResponse resposta = client.registerEconf(invoiceId, data);
System.out.println(resposta.status); // "autorizado"

Exemplo de resposta

{
  "status": "autorizado",
  "status_sefaz": "135",
  "mensagem_sefaz": "Evento registrado e vinculado ao documento fiscal eletrônico",
  "caminho_xml_conciliacao_financeira": "https://storage.../evento-econf.xml",
  "numero_conciliacao_financeira": 1,
  "numero_protocolo": "192260000012345"
}

Consultar e-CONF

GET/v1/nfe/{id}/econf/{numeroProtocolo}

Consulta um e-CONF já registrado a partir do seu número de protocolo.

Consulta local

Esta chamada não bate novamente na SEFAZ — ela apenas busca, na sua base local, o evento de e-CONF já registrado com o numeroProtocolo informado.

cURL

curl https://app.nfe.tenzanlabs.com/v1/nfe/35f0a1b2-.../econf/192260000012345 \
  -H "X-Access-Key: nfe_access_SUA_CHAVE_DE_ACESSO_AQUI" \
  -H "Authorization: Bearer nfe_test_SUA_CHAVE_AQUI"

Node.js

const resposta = await client.getEconf(invoiceId, '192260000012345');
console.log(resposta.status); // 'autorizado'

Python

resposta = client.get_econf(invoice_id, "192260000012345")
print(resposta["status"])  # 'autorizado'

Java

SyncEventResponse resposta = client.getEconf(invoiceId, "192260000012345");
System.out.println(resposta.status); // "autorizado"

Exemplo de resposta

{
  "status": "autorizado",
  "status_sefaz": "135",
  "mensagem_sefaz": "Evento registrado e vinculado ao documento fiscal eletrônico",
  "numero_protocolo": "192260000012345"
}

Resposta

200 OK

statusstring

Status do e-CONF registrado.

status_sefazstring

Código de status retornado pela SEFAZ (cStat) no momento do registro.

mensagem_sefazstring

Mensagem retornada pela SEFAZ (xMotivo) no momento do registro.

numero_protocolostring

Número de protocolo do e-CONF consultado.

Cancelar e-CONF

DELETE/v1/nfe/{id}/econf/{numeroProtocolo}

Cancela o e-CONF (evento 110751) identificado pelo numeroProtocolo.

Sem corpo

Esta chamada não recebe corpo — o numeroProtocolo na URL já identifica de forma única qual e-CONF será cancelado.

cURL

curl -X DELETE https://app.nfe.tenzanlabs.com/v1/nfe/35f0a1b2-.../econf/192260000012345 \
  -H "X-Access-Key: nfe_access_SUA_CHAVE_DE_ACESSO_AQUI" \
  -H "Authorization: Bearer nfe_test_SUA_CHAVE_AQUI"

Node.js

const resposta = await client.cancelEconf(invoiceId, '192260000012345');
console.log(resposta.status); // 'autorizado'

Python

resposta = client.cancel_econf(invoice_id, "192260000012345")
print(resposta["status"])  # 'autorizado'

Java

SyncEventResponse resposta = client.cancelEconf(invoiceId, "192260000012345");
System.out.println(resposta.status); // "autorizado"

Exemplo de resposta

{
  "status": "autorizado",
  "status_sefaz": "135",
  "mensagem_sefaz": "Evento registrado e vinculado ao documento fiscal eletrônico",
  "caminho_xml_cancelamento_conciliacao_financeira": "https://storage.../evento-cancelamento-econf.xml",
  "numero_cancelamento_conciliacao_financeira": 1
}

Resposta

200 OK

statusstring

Valores aceitos: autorizado | erro_autorizacao

Resultado do cancelamento junto à SEFAZ.

status_sefazstring

Código de status retornado pela SEFAZ (cStat).

mensagem_sefazstring

Mensagem retornada pela SEFAZ (xMotivo).

caminho_xml_cancelamento_conciliacao_financeirastring

URL pública do XML do evento de cancelamento, quando autorizado.

numero_cancelamento_conciliacao_financeiranumber

Número sequencial do evento de cancelamento registrado para este documento.